Providers - Get

服務:

Resource Management

API 版本:

2021-04-01

取得指定的資源提供者。

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/{resourceProviderNamespace}?api-version=2021-04-01

含選擇性參數:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/{resourceProviderNamespace}?$expand={$expand}&api-version=2021-04-01

URI 參數

名稱	位於	必要	類型	Description
resourceProviderNamespace	path	True	string	資源提供者的命名空間。
subscriptionId	path	True	string	Microsoft Azure 訂用帳戶標識碼。
api-version	query	True	string	用於此作業的 API 版本。
$expand	query		string	$expand查詢參數。 例如，若要在回應中包含屬性別名，請使用 $expand=resourceTypes/aliases。

回應

名稱	類型	Description
200 OK	Provider	確定 - 傳回資源提供者的相關信息。
Other Status Codes	CloudError	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Get provider.

範例要求

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.TestRP1?api-version=2021-04-01

Go

package armresources_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresources"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4fd842fb73656039ec94ce367bcedee25a57bd18/specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/GetProvider.json
func ExampleProvidersClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armresources.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewProvidersClient().Get(ctx, "Microsoft.TestRP1", &armresources.ProvidersClientGetOptions{Expand: nil})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Provider = armresources.Provider{
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.TestRP1"),
	// 	Namespace: to.Ptr("Microsoft.TestRP1"),
	// 	RegistrationPolicy: to.Ptr("RegistrationRequired"),
	// 	RegistrationState: to.Ptr("Registering"),
	// 	ResourceTypes: []*armresources.ProviderResourceType{
	// 		{
	// 			APIVersions: []*string{
	// 				to.Ptr("2018-01-01"),
	// 				to.Ptr("2015-05-01")},
	// 				Capabilities: to.Ptr("CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"),
	// 				LocationMappings: []*armresources.ProviderExtendedLocation{
	// 					{
	// 						Type: to.Ptr("EdgeZone"),
	// 						ExtendedLocations: []*string{
	// 							to.Ptr("LosAngeles"),
	// 							to.Ptr("LosAngeles2")},
	// 							Location: to.Ptr("West US"),
	// 					}},
	// 					Locations: []*string{
	// 						to.Ptr("West US")},
	// 						ResourceType: to.Ptr("TestResourceType"),
	// 					},
	// 					{
	// 						APIVersions: []*string{
	// 							to.Ptr("2018-01-01"),
	// 							to.Ptr("2015-05-01")},
	// 							Capabilities: to.Ptr("CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"),
	// 							Locations: []*string{
	// 								to.Ptr("West US")},
	// 								ResourceType: to.Ptr("TestResourceTypeSibling"),
	// 						}},
	// 					}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ResourceManagementClient } = require("@azure/arm-resources");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets the specified resource provider.
 *
 * @summary Gets the specified resource provider.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/GetProvider.json
 */
async function getProvider() {
  const subscriptionId =
    process.env["RESOURCES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceProviderNamespace = "Microsoft.TestRP1";
  const credential = new DefaultAzureCredential();
  const client = new ResourceManagementClient(credential, subscriptionId);
  const result = await client.providers.get(resourceProviderNamespace);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

範例回覆

狀態碼:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.TestRP1",
  "namespace": "Microsoft.TestRP1",
  "registrationState": "Registering",
  "registrationPolicy": "RegistrationRequired",
  "resourceTypes": [
    {
      "resourceType": "TestResourceType",
      "locations": [
        "West US"
      ],
      "apiVersions": [
        "2018-01-01",
        "2015-05-01"
      ],
      "locationMappings": [
        {
          "location": "West US",
          "type": "EdgeZone",
          "extendedLocations": [
            "LosAngeles",
            "LosAngeles2"
          ]
        }
      ],
      "capabilities": "CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"
    },
    {
      "resourceType": "TestResourceTypeSibling",
      "locations": [
        "West US"
      ],
      "apiVersions": [
        "2018-01-01",
        "2015-05-01"
      ],
      "capabilities": "CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"
    }
  ]
}

定義

名稱	Description
Alias	別名類型。
AliasPath	別名的路徑類型。
AliasPathAttributes	別名路徑所參考之令牌的屬性。
AliasPathMetadata
AliasPathTokenType	別名路徑所參考的令牌類型。
AliasPattern	別名路徑的模式類型。
AliasPatternType	別名模式的類型
AliasType	別名類型。
ApiProfile
CloudError	資源管理要求的錯誤回應。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorResponse	錯誤回應
Provider	資源提供者資訊。
ProviderAuthorizationConsentState	提供者授權同意狀態。
ProviderExtendedLocation	提供者擴充位置。
ProviderResourceType	資源提供者所管理的資源類型。
ZoneMapping

Alias

別名類型。

名稱	類型	Description
defaultMetadata	AliasPathMetadata	默認別名路徑元數據。 適用於預設路徑，以及任何沒有元數據的別名路徑
defaultPath	string	別名的預設路徑。
defaultPattern	AliasPattern	別名的預設模式。
name	string	別名名稱。
paths	AliasPath[]	別名的路徑。
type	AliasType	別名類型。

AliasPath

別名的路徑類型。

名稱	類型	Description
apiVersions	string[]	API 版本。
metadata	AliasPathMetadata	別名路徑的元數據。 如果遺失，請回復為別名的預設元數據。
path	string	別名的路徑。
pattern	AliasPattern	別名路徑的模式。

AliasPathAttributes

別名路徑所參考之令牌的屬性。

名稱	類型	Description
Modifiable	string	別名路徑所參考的令牌可由具有 『modify』 效果的原則修改。
None	string	別名路徑所參考的令牌沒有屬性。

AliasPathMetadata

名稱	類型	Description
attributes	AliasPathAttributes	別名路徑所參考之令牌的屬性。
type	AliasPathTokenType	別名路徑所參考的令牌類型。

AliasPathTokenType

別名路徑所參考的令牌類型。

名稱	類型	Description
Any	string	Token 類型可以是任何專案。
Array	string	Token 類型為陣列。
Boolean	string	Token 類型為布爾值。
Integer	string	Token 類型為整數。
NotSpecified	string	未指定令牌類型。
Number	string	Token 類型為 number。
Object	string	Token 類型為物件。
String	string	Token 類型為字串。

AliasPattern

別名路徑的模式類型。

名稱	類型	Description
phrase	string	別名模式片語。
type	AliasPatternType	別名模式的類型
variable	string	別名模式變數。

AliasPatternType

別名模式的類型

名稱	類型	Description
Extract	string	擷取是唯一允許的值。
NotSpecified	string	不允許 NotSpecified。

AliasType

別名類型。

名稱	類型	Description
Mask	string	別名值是秘密。
NotSpecified	string	別名類型未知 (與未提供別名類型) 相同。
PlainText	string	別名值不是秘密。

ApiProfile

名稱	類型	Description
apiVersion	string	API 版本。
profileVersion	string	配置檔版本。

CloudError

資源管理要求的錯誤回應。

名稱	類型	Description
error	ErrorResponse	錯誤回應 所有 Azure Resource Manager API 的常見錯誤回應，以傳回失敗作業的錯誤詳細數據。 (這也會遵循 OData 錯誤回應格式。)

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorResponse

錯誤回應

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorResponse[]	錯誤詳細資料。
message	string	錯誤訊息。
target	string	錯誤目標。

Provider

資源提供者資訊。

名稱	類型	Description
id	string	提供者 ID。
namespace	string	資源提供者的命名空間。
providerAuthorizationConsentState	ProviderAuthorizationConsentState	提供者授權同意狀態。
registrationPolicy	string	資源提供者的註冊原則。
registrationState	string	資源提供者的註冊狀態。
resourceTypes	ProviderResourceType[]	提供者資源類型的集合。

ProviderAuthorizationConsentState

提供者授權同意狀態。

名稱	類型	Description
Consented	string
NotRequired	string
NotSpecified	string
Required	string

ProviderExtendedLocation

提供者擴充位置。

名稱	類型	Description
extendedLocations	string[]	Azure 位置的擴充位置。
location	string	Azure 位置。
type	string	擴充位置類型。

ProviderResourceType

資源提供者所管理的資源類型。

名稱	類型	Description
aliases	Alias[]	此資源類型支援的別名。
apiProfiles	ApiProfile[]	資源提供者的 API 設定檔。
apiVersions	string[]	API 版本。
capabilities	string	此資源類型所提供的其他功能。
defaultApiVersion	string	預設 API 版本。
locationMappings	ProviderExtendedLocation[]	此資源類型支援的位置對應。
locations	string[]	可以建立此資源類型的位置集合。
properties	object	屬性。
resourceType	string	資源類型。
zoneMappings	ZoneMapping[]

ZoneMapping

名稱	類型	Description
location	string	區域對應的位置。
zones	string[]