リソース プロバイダーと種類Resource providers and types

リソースをデプロイするときに、リソース プロバイダーと種類に関する情報を取得しなければならないケースは少なくありません。When deploying resources, you frequently need to retrieve information about the resource providers and types. この記事では、次のことについて説明します。In this article, you learn to:

  • Azure のすべてのリソース プロバイダーを表示するView all resource providers in Azure
  • リソース プロバイダーの登録ステータスを確認するCheck registration status of a resource provider
  • リソース プロバイダーを登録するRegister a resource provider
  • リソース プロバイダーのリソースの種類を表示するView resource types for a resource provider
  • リソースの種類の有効な場所を表示するView valid locations for a resource type
  • リソースの種類の有効な API のバージョンを表示するView valid API versions for a resource type

これらの手順は、ポータル、Powershell、または Azure CLI を介して実行することができます。You can perform these steps through the portal, PowerShell, or Azure CLI.

PowerShellPowerShell

Azure ですべてのリソース プロバイダーおよびサブスクリプションの登録状態を表示するには、次のコマンドを使用します。To see all resource providers in Azure, and the registration status for your subscription, use:

Get-AzureRmResourceProvider -ListAvailable | Select-Object ProviderNamespace, RegistrationState

これは次のような結果を返します。Which returns results similar to:

ProviderNamespace                RegistrationState
-------------------------------- ------------------
Microsoft.ClassicCompute         Registered
Microsoft.ClassicNetwork         Registered
Microsoft.ClassicStorage         Registered
Microsoft.CognitiveServices      Registered
...

リソース プロバイダーの登録によって、サブスクリプションがリソース プロバイダーと連携するように構成されます。Registering a resource provider configures your subscription to work with the resource provider. 登録の範囲は常にサブスクリプションです。The scope for registration is always the subscription. 既定では、多数のリソース プロバイダーが自動的に登録されます。By default, many resource providers are automatically registered. ただし、一部のリソース プロバイダーについては、手動で登録する必要がある場合もあります。However, you may need to manually register some resource providers. リソース プロバイダーを登録するには、リソース プロバイダーの /register/action 操作を実行するためのアクセス許可が必要です。To register a resource provider, you must have permission to perform the /register/action operation for the resource provider. この操作は、共同作成者ロールと所有者ロールに含まれます。This operation is included in the Contributor and Owner roles.

Register-AzureRmResourceProvider -ProviderNamespace Microsoft.Batch

これは次のような結果を返します。Which returns results similar to:

ProviderNamespace : Microsoft.Batch
RegistrationState : Registering
ResourceTypes     : {batchAccounts, operations, locations, locations/quotas}
Locations         : {West Europe, East US, East US 2, West US...}

サブスクリプション内に特定のリソース プロバイダーからのリソースの種類がまだある場合、そのリソース プロバイダーの登録を解除することはできません。You cannot unregister a resource provider when you still have resource types from that resource provider in your subscription.

特定のリソース プロバイダーの情報を表示するには、次のコマンドを使用します。To see information for a particular resource provider, use:

Get-AzureRmResourceProvider -ProviderNamespace Microsoft.Batch

これは次のような結果を返します。Which returns results similar to:

{ProviderNamespace : Microsoft.Batch
RegistrationState : Registered
ResourceTypes     : {batchAccounts}
Locations         : {West Europe, East US, East US 2, West US...}

...

リソース プロバイダーのリソースの種類を表示するには、次のコマンドを使用します。To see the resource types for a resource provider, use:

(Get-AzureRmResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes.ResourceTypeName

次のような結果が返されます。Which returns:

batchAccounts
operations
locations
locations/quotas

API バージョンは、リリース プロバイダーがリリースする REST API のバージョンに一致します。The API version corresponds to a version of REST API operations that are released by the resource provider. リソース プロバイダーは、新しい機能を有効にすると、REST API の新しいバージョンをリリースします。As a resource provider enables new features, it releases a new version of the REST API.

リソースの種類の使用可能な API バージョンを取得するには、次のコマンドを使用します。To get the available API versions for a resource type, use:

((Get-AzureRmResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes | Where-Object ResourceTypeName -eq batchAccounts).ApiVersions

次のような結果が返されます。Which returns:

2017-05-01
2017-01-01
2015-12-01
2015-09-01
2015-07-01

リソース マネージャーはすべてのリージョンでサポートされていますが、デプロイするリソースはすべてのリージョンではサポートされていない場合があります。Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. さらに、サブスクリプションでの制限により、リソースをサポートする一部のリージョンを使用できない場合があります。In addition, there may be limitations on your subscription that prevent you from using some regions that support the resource.

リソースの種類のサポートされている場所を取得するには、次のコマンドを使用します。To get the supported locations for a resource type, use.

((Get-AzureRmResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes | Where-Object ResourceTypeName -eq batchAccounts).Locations

次のような結果が返されます。Which returns:

West Europe
East US
East US 2
West US
...

Azure CLIAzure CLI

Azure ですべてのリソース プロバイダーおよびサブスクリプションの登録状態を表示するには、次のコマンドを使用します。To see all resource providers in Azure, and the registration status for your subscription, use:

az provider list --query "[].{Provider:namespace, Status:registrationState}" --out table

これは次のような結果を返します。Which returns results similar to:

Provider                         Status
-------------------------------- ----------------
Microsoft.ClassicCompute         Registered
Microsoft.ClassicNetwork         Registered
Microsoft.ClassicStorage         Registered
Microsoft.CognitiveServices      Registered
...

リソース プロバイダーの登録によって、サブスクリプションがリソース プロバイダーと連携するように構成されます。Registering a resource provider configures your subscription to work with the resource provider. 登録の範囲は常にサブスクリプションです。The scope for registration is always the subscription. 既定では、多数のリソース プロバイダーが自動的に登録されます。By default, many resource providers are automatically registered. ただし、一部のリソース プロバイダーについては、手動で登録する必要がある場合もあります。However, you may need to manually register some resource providers. リソース プロバイダーを登録するには、リソース プロバイダーの /register/action 操作を実行するためのアクセス許可が必要です。To register a resource provider, you must have permission to perform the /register/action operation for the resource provider. この操作は、共同作成者ロールと所有者ロールに含まれます。This operation is included in the Contributor and Owner roles.

az provider register --namespace Microsoft.Batch

登録が進行中であることを示すメッセージが返されます。Which returns a message that registration is on-going.

サブスクリプション内に特定のリソース プロバイダーからのリソースの種類がまだある場合、そのリソース プロバイダーの登録を解除することはできません。You cannot unregister a resource provider when you still have resource types from that resource provider in your subscription.

特定のリソース プロバイダーの情報を表示するには、次のコマンドを使用します。To see information for a particular resource provider, use:

az provider show --namespace Microsoft.Batch

これは次のような結果を返します。Which returns results similar to:

{
    "id": "/subscriptions/####-####/providers/Microsoft.Batch",
    "namespace": "Microsoft.Batch",
    "registrationsState": "Registering",
    "resourceTypes:" [
        ...
    ]
}

リソース プロバイダーのリソースの種類を表示するには、次のコマンドを使用します。To see the resource types for a resource provider, use:

az provider show --namespace Microsoft.Batch --query "resourceTypes[*].resourceType" --out table

次のような結果が返されます。Which returns:

Result
---------------
batchAccounts
operations
locations
locations/quotas

API バージョンは、リリース プロバイダーがリリースする REST API のバージョンに一致します。The API version corresponds to a version of REST API operations that are released by the resource provider. リソース プロバイダーは、新しい機能を有効にすると、REST API の新しいバージョンをリリースします。As a resource provider enables new features, it releases a new version of the REST API.

リソースの種類の使用可能な API バージョンを取得するには、次のコマンドを使用します。To get the available API versions for a resource type, use:

az provider show --namespace Microsoft.Batch --query "resourceTypes[?resourceType=='batchAccounts'].apiVersions | [0]" --out table

次のような結果が返されます。Which returns:

Result
---------------
2017-05-01
2017-01-01
2015-12-01
2015-09-01
2015-07-01

リソース マネージャーはすべてのリージョンでサポートされていますが、デプロイするリソースはすべてのリージョンではサポートされていない場合があります。Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. さらに、サブスクリプションでの制限により、リソースをサポートする一部のリージョンを使用できない場合があります。In addition, there may be limitations on your subscription that prevent you from using some regions that support the resource.

リソースの種類のサポートされている場所を取得するには、次のコマンドを使用します。To get the supported locations for a resource type, use.

az provider show --namespace Microsoft.Batch --query "resourceTypes[?resourceType=='batchAccounts'].locations | [0]" --out table

次のような結果が返されます。Which returns:

Result
---------------
West Europe
East US
East US 2
West US
...

ポータルPortal

Azure ですべてのリソース プロバイダおよびサブスクリプションの登録状態を表示するには、[サブスクリプション] を選択します。To see all resource providers in Azure, and the registration status for your subscription, select Subscriptions.

サブスクリプションの選択

表示するサブスクリプションを選択します。Choose the subscription to view.

サブスクリプションの指定

[リソース プロバイダー] を選択し、利用可能なリソース プロバイダーの一覧を表示します。Select Resource providers and view the list of available resource providers.

リソース プロバイダーの表示

リソース プロバイダーの登録によって、サブスクリプションがリソース プロバイダーと連携するように構成されます。Registering a resource provider configures your subscription to work with the resource provider. 登録の範囲は常にサブスクリプションです。The scope for registration is always the subscription. 既定では、多数のリソース プロバイダーが自動的に登録されます。By default, many resource providers are automatically registered. ただし、一部のリソース プロバイダーについては、手動で登録する必要がある場合もあります。However, you may need to manually register some resource providers. リソース プロバイダーを登録するには、リソース プロバイダーの /register/action 操作を実行するためのアクセス許可が必要です。To register a resource provider, you must have permission to perform the /register/action operation for the resource provider. この操作は、共同作成者ロールと所有者ロールに含まれます。This operation is included in the Contributor and Owner roles. リソース プロバイダーを登録するには、[登録] を選択します。To register a resource provider, select Register.

リソース プロバイダーの登録

サブスクリプション内に特定のリソース プロバイダーからのリソースの種類がまだある場合、そのリソース プロバイダーの登録を解除することはできません。You cannot unregister a resource provider when you still have resource types from that resource provider in your subscription.

特定のリソース プロバイダーの情報を表示するには、[すべてのサービス] を選択します。To see information for a particular resource provider, select All services.

[すべてのサービス] を選択する

リソース エクスプローラーを検索し、使用可能なオプションから選択します。Search for Resource Explorer and select it from the available options.

リソース エクスプローラーの選択

[プロバイダー] を選択します。Select Providers.

プロバイダーの選択

表示するリソース プロバイダーとリソースの種類を選択します。Select the resource provider and resource type that you want to view.

リソースの種類の選択

リソース マネージャーはすべてのリージョンでサポートされていますが、デプロイするリソースはすべてのリージョンではサポートされていない場合があります。Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. さらに、サブスクリプションでの制限により、リソースをサポートする一部のリージョンを使用できない場合があります。In addition, there may be limitations on your subscription that prevent you from using some regions that support the resource. リソース エクスプローラーでは、リソースの種類の有効な場所が表示されます。The resource explorer displays valid locations for the resource type.

場所の表示

API バージョンは、リリース プロバイダーがリリースする REST API のバージョンに一致します。The API version corresponds to a version of REST API operations that are released by the resource provider. リソース プロバイダーは、新しい機能を有効にすると、REST API の新しいバージョンをリリースします。As a resource provider enables new features, it releases a new version of the REST API. リソース エクスプローラーでは、リソースの種類の有効 API のバージョンが表示されます。The resource explorer displays valid API versions for the resource type.

API のバージョンの表示

次の手順Next steps