Поставщики и типы ресурсов AzureAzure resource providers and types

При развертывании ресурсов часто бывает необходимо получить сведения о типах и поставщиках ресурсов.When deploying resources, you frequently need to retrieve information about the resource providers and types. В этой статье раскрываются следующие темы:In this article, you learn how 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

Это можно сделать эти шаги с помощью портала Azure, Azure PowerShell или Azure CLI.You can do these steps through the Azure portal, Azure PowerShell, or Azure CLI.

Для списка, который сопоставляет поставщиков ресурсов для служб Azure, см. в разделе поставщиков ресурсов для служб Azure.For a list that maps resource providers to Azure services, see Resource providers for Azure services.

Портал AzureAzure portal

Чтобы просмотреть всех поставщиков ресурсов, а также состояние регистрации для подписки, сделайте следующее:To see all resource providers, and the registration status for your subscription:

  1. Войдите на портале Azure.Sign in to the Azure portal.

  2. Выбор пункта Все службы.Select All services.

    выбор подписок

  3. В поле Все службы введите подписка, а затем выберите Подписки.In the All services box, enter subscription, and then select Subscriptions.

  4. Выберите подписку из списка подписок для просмотра.Select the subscription from the subscription list to view.

  5. Выберите Поставщики ресурсов, а затем просмотрите список доступных поставщиков ресурсов.Select Resource providers and view the list of available resource providers.

    отображение поставщиков ресурсов

  6. Регистрация поставщика ресурсов настраивает подписку для работы с поставщиком ресурсов.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 do 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. На предыдущем снимке экрана ссылка Регистрация выделена в поле Microsoft.Blueprint.In the previous screenshot, the Register link is highlighted for Microsoft.Blueprint.

    Не удается отменить регистрацию поставщика ресурсов, когда вы по-прежнему есть типы ресурсов из этого поставщика ресурсов в подписке.You can't 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:

  1. Войдите на портале Azure.Sign in to the Azure portal.

  2. Выбор пункта Все службы.Select All services.

    Пункт "Все службы"

  3. В поле Все службы введите обозреватель ресурсов и выберите Обозреватель ресурсов.In the All services box, enter resource explorer, and then select Resource Explorer.

  4. Разверните список Поставщики, щелкнув стрелку вправо.Expand Providers by selecting the right arrow.

    выбор поставщиков

  5. Разверните поставщик ресурсов и тип ресурса, который вы хотите просмотреть.Expand a resource provider and resource type that you want to view.

    Выбор типа ресурсов

  6. Диспетчер ресурсов поддерживается во всех регионах, однако развертываемые вами ресурсы могут поддерживаться не во всех регионах.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.

    Отображение расположений

  7. Версия API соответствует версии операций API REST, выполняемых поставщиком ресурсов.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

Azure PowerShellAzure PowerShell

Примечание

Эта статья была изменена и теперь содержит сведения о новом модуле Az для Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Вы по-прежнему можете использовать модуль AzureRM, исправления ошибок для которого будут продолжать выпускаться как минимум до декабря 2020 г.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Дополнительные сведения о совместимости модуля Az с AzureRM см. в статье Introducing the new Azure PowerShell Az module (Знакомство с новым модулем Az для Azure PowerShell).To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Инструкции по установке модуля Az см. в статье об установке Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Чтобы просмотреть всех поставщиков ресурсов в Azure, а также состояние регистрации для подписки, используйте команду ниже:To see all resource providers in Azure, and the registration status for your subscription, use:

Get-AzResourceProvider -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 do the /register/action operation for the resource provider. Эта операция включается в роли участника и владельца.This operation is included in the Contributor and Owner roles.

Register-AzResourceProvider -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 can't 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-AzResourceProvider -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-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes.ResourceTypeName

Возвращаемые данные:Which returns:

batchAccounts
operations
locations
locations/quotas

Версия API соответствует версии операций API REST, выполняемых поставщиком ресурсов.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-AzResourceProvider -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-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes | Where-Object ResourceTypeName -eq batchAccounts).Locations

Возвращаемые данные:Which returns:

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

Инфраструктура CLI AzureAzure 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 do 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 can't 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 соответствует версии операций API REST, выполняемых поставщиком ресурсов.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
...

Дальнейшие действияNext steps