资源提供程序和类型

部署资源时,经常需要检索有关资源提供程序和类型的信息。 本文介绍如何执行以下操作:

  • 查看 Azure 中的所有资源提供程序
  • 检查资源提供程序的注册状态
  • 注册资源提供程序
  • 查看资源提供程序的资源类型
  • 查看资源类型的有效位置
  • 查看资源类型的有效 API 版本

可以通过门户、PowerShell 或 Azure CLI 执行这些步骤。

PowerShell

若要查看 Azure 中的所有资源提供程序和订阅的注册状态,请使用:

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

这会返回类似于下面的结果:

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

通过注册资源提供程序来配置订阅,以供资源提供程序使用。 注册的作用域始终是订阅。 默认情况下,将自动注册许多资源提供程序。 但可能需要手动注册某些资源提供程序。 若要注册资源提供程序,必须具备为资源提供程序执行 /register/action 操作的权限。 此操作包含在“参与者”和“所有者”角色中。

Register-AzureRmResourceProvider -ProviderNamespace Microsoft.Batch

这会返回类似于下面的结果:

ProviderNamespace : Microsoft.Batch
RegistrationState : Registering
ResourceTypes     : {batchAccounts, operations, locations, locations/quotas}
Locations         : {China East, China North}

当订阅中仍有某个资源提供程序的资源类型时,不能注销该资源提供程序。

若要查看特定资源提供程序的信息,请使用:

Get-AzureRmResourceProvider -ProviderNamespace Microsoft.Batch

这会返回类似于以下的结果:

{ProviderNamespace : Microsoft.Batch
RegistrationState : Registered
ResourceTypes     : {batchAccounts}
Locations         : {{China East, China North}

...

若要查看资源提供程序的资源类型,请使用:

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

返回:

batchAccounts
operations
locations
locations/quotas

API 版本对应于资源提供程序发布的 REST API 操作版本。 资源提供程序启用新功能时,会发布 REST API 的新版本。

若要获取资源类型的可用 API 版本,请使用:

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

返回:

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

所有区域都支持 Resource Manager,但部署的资源可能无法在所有区域中受到支持。 此外,订阅可能存在一些限制,以防止用户使用某些支持该资源的区域。

若要获取资源类型支持的位置,请使用:

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

返回:

China East
China North

Azure CLI

若要查看 Azure 中的所有资源提供程序和订阅的注册状态,请使用:

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

这会返回类似于下面的结果:

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

通过注册资源提供程序来配置订阅,以供资源提供程序使用。 注册的作用域始终是订阅。 默认情况下,将自动注册许多资源提供程序。 但可能需要手动注册某些资源提供程序。 若要注册资源提供程序,必须具备为资源提供程序执行 /register/action 操作的权限。 此操作包含在“参与者”和“所有者”角色中。

az provider register --namespace Microsoft.Batch

这将返回“注册正在进行中”的信息。

当订阅中仍有某个资源提供程序的资源类型时,不能注销该资源提供程序。

若要查看特定资源提供程序的信息,请使用:

az provider show --namespace Microsoft.Batch

这会返回类似于以下的结果:

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

若要查看资源提供程序的资源类型,请使用:

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

返回:

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

API 版本对应于资源提供程序发布的 REST API 操作版本。 资源提供程序启用新功能时,会发布 REST API 的新版本。

若要获取资源类型的可用 API 版本,请使用:

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

返回:

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

所有区域都支持 Resource Manager,但部署的资源可能无法在所有区域中受到支持。 此外,订阅可能存在一些限制,以防止用户使用某些支持该资源的区域。

若要获取资源类型支持的位置,请使用:

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

返回:

Result
---------------
China East
China North

门户

若要查看 Azure 中的所有资源提供程序以及订阅的注册状态,请选择“订阅”。

选择订阅

选择要查看的订阅。

指定订阅

选择“资源提供程序”并查看可用的资源提供程序列表。

显示资源提供程序

通过注册资源提供程序,将订阅配置为使用资源提供程序。 注册的作用域始终是订阅。 默认情况下,将自动注册许多资源提供程序。 但可能需要手动注册某些资源提供程序。 若要注册资源提供程序,必须具备为资源提供程序执行 /register/action 操作的权限。 此操作包含在“参与者”和“所有者”角色中。 若要注册资源提供程序,请选择“注册”。

注册资源提供程序

当订阅中仍有某个资源提供程序的资源类型时,不能注销该资源提供程序。

若要查看特定资源提供程序的信息,请选择“所有服务”。

选择“所有服务”

搜索“资源浏览器”,然后从可用选项中选择它。

选择资源浏览器

选择“提供程序”。

选择提供程序

选择要查看的资源提供程序和资源类型。

选择资源类型

所有区域都支持 Resource Manager,但部署的资源可能无法在所有区域中受到支持。 此外,订阅可能存在一些限制,以防止用户使用某些支持该资源的区域。 资源浏览器将显示该资源类型的有效位置。

显示位置

API 版本对应于资源提供程序发布的 REST API 操作版本。 资源提供程序启用新功能时,会发布 REST API 的新版本。 资源浏览器将显示该资源类型的有效 API 版本。

显示 API 版本

后续步骤