Providers - List

Ссылка

Служба:: Resource Management

Версия API:: 2021-04-01

Возвращает все поставщики ресурсов для подписки.

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

С использованием необязательных параметров:

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
subscriptionId	path	True	string	Идентификатор подписки Microsoft Azure.
api-version	query	True	string	Версия API, используемая для данной операции.
$expand	query		string	Свойства, включаемые в результаты. Например, используйте &$expand=metadata в строке запроса, чтобы получить метаданные поставщика ресурсов. Чтобы включить псевдонимы свойств в ответ, используйте $expand=resourceTypes/aliases.

Ответы

Имя	Тип	Описание
200 OK	ProviderListResult	ОК . Возвращает массив поставщиков ресурсов.
Other Status Codes	CloudError	Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Get providers.

Образец запроса

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

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/GetProviders.json
func ExampleProvidersClient_NewListPager() {
	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)
	}
	pager := clientFactory.NewProvidersClient().NewListPager(&armresources.ProvidersClientListOptions{Expand: nil})
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.ProviderListResult = armresources.ProviderListResult{
		// 	Value: []*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"),
		// 								}},
		// 							},
		// 							{
		// 								ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources"),
		// 								Namespace: to.Ptr("Microsoft.Resources"),
		// 								RegistrationPolicy: to.Ptr("RegistrationFree"),
		// 								RegistrationState: to.Ptr("Registered"),
		// 								ResourceTypes: []*armresources.ProviderResourceType{
		// 									{
		// 										Aliases: []*armresources.Alias{
		// 										},
		// 										APIVersions: []*string{
		// 											to.Ptr("2016-09-01"),
		// 											to.Ptr("2014-04-01-preview")},
		// 											Capabilities: to.Ptr("CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"),
		// 											Locations: []*string{
		// 												to.Ptr("eastus"),
		// 												to.Ptr("eastus2"),
		// 												to.Ptr("westus")},
		// 												ResourceType: to.Ptr("subscriptions"),
		// 											},
		// 											{
		// 												Aliases: []*armresources.Alias{
		// 												},
		// 												APIVersions: []*string{
		// 													to.Ptr("2016-09-01"),
		// 													to.Ptr("2014-04-01-preview")},
		// 													Capabilities: to.Ptr("CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"),
		// 													Locations: []*string{
		// 														to.Ptr("centralus"),
		// 														to.Ptr("eastasia"),
		// 														to.Ptr("southeastasia")},
		// 														ResourceType: to.Ptr("resourceGroups"),
		// 													},
		// 													{
		// 														Aliases: []*armresources.Alias{
		// 														},
		// 														APIVersions: []*string{
		// 															to.Ptr("2016-09-01"),
		// 															to.Ptr("2014-04-01-preview")},
		// 															Capabilities: to.Ptr("CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"),
		// 															Locations: []*string{
		// 																to.Ptr("eastus"),
		// 																to.Ptr("eastus2"),
		// 																to.Ptr("westus")},
		// 																ResourceType: to.Ptr("subscriptions/resourceGroups"),
		// 															},
		// 															{
		// 																Aliases: []*armresources.Alias{
		// 																},
		// 																APIVersions: []*string{
		// 																	to.Ptr("2014-04-01-preview")},
		// 																	Capabilities: to.Ptr("CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"),
		// 																	Locations: []*string{
		// 																		to.Ptr("centralus"),
		// 																		to.Ptr("eastasia")},
		// 																		ResourceType: to.Ptr("bulkDelete"),
		// 																	},
		// 																	{
		// 																		Aliases: []*armresources.Alias{
		// 																		},
		// 																		APIVersions: []*string{
		// 																			to.Ptr("2017-08-01"),
		// 																			to.Ptr("2017-06-01")},
		// 																			Capabilities: to.Ptr("SupportsTags"),
		// 																			Locations: []*string{
		// 																			},
		// 																			ResourceType: to.Ptr("deployments"),
		// 																		},
		// 																		{
		// 																			Aliases: []*armresources.Alias{
		// 																			},
		// 																			APIVersions: []*string{
		// 																			},
		// 																			Capabilities: to.Ptr("SupportsExtension"),
		// 																			Locations: []*string{
		// 																				to.Ptr("DevFabric")},
		// 																				ResourceType: to.Ptr("tags"),
		// 																		}},
		// 																	},
		// 																	{
		// 																		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.TestRP2"),
		// 																		Namespace: to.Ptr("Microsoft.TestRP2"),
		// 																		RegistrationPolicy: to.Ptr("RegistrationRequired"),
		// 																		RegistrationState: to.Ptr("NotRegistered"),
		// 																		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

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

/**
 * This sample demonstrates how to Gets all resource providers for a subscription.
 *
 * @summary Gets all resource providers for a subscription.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/GetProviders.json
 */
async function getProviders() {
  const subscriptionId =
    process.env["RESOURCES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const credential = new DefaultAzureCredential();
  const client = new ResourceManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.providers.list()) {
    resArray.push(item);
  }
  console.log(resArray);
}

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

Пример ответа

Код состояния:: 200

{
  "value": [
    {
      "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"
        }
      ]
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources",
      "namespace": "Microsoft.Resources",
      "registrationState": "Registered",
      "registrationPolicy": "RegistrationFree",
      "resourceTypes": [
        {
          "resourceType": "subscriptions",
          "locations": [
            "eastus",
            "eastus2",
            "westus"
          ],
          "apiVersions": [
            "2016-09-01",
            "2014-04-01-preview"
          ],
          "aliases": [],
          "capabilities": "CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"
        },
        {
          "resourceType": "resourceGroups",
          "locations": [
            "centralus",
            "eastasia",
            "southeastasia"
          ],
          "apiVersions": [
            "2016-09-01",
            "2014-04-01-preview"
          ],
          "aliases": [],
          "capabilities": "CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"
        },
        {
          "resourceType": "subscriptions/resourceGroups",
          "locations": [
            "eastus",
            "eastus2",
            "westus"
          ],
          "apiVersions": [
            "2016-09-01",
            "2014-04-01-preview"
          ],
          "aliases": [],
          "capabilities": "CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"
        },
        {
          "resourceType": "bulkDelete",
          "locations": [
            "centralus",
            "eastasia"
          ],
          "apiVersions": [
            "2014-04-01-preview"
          ],
          "aliases": [],
          "capabilities": "CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"
        },
        {
          "resourceType": "deployments",
          "locations": [],
          "apiVersions": [
            "2017-08-01",
            "2017-06-01"
          ],
          "aliases": [],
          "capabilities": "SupportsTags"
        },
        {
          "resourceType": "tags",
          "locations": [
            "DevFabric"
          ],
          "apiVersions": [],
          "aliases": [],
          "capabilities": "SupportsExtension"
        }
      ]
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.TestRP2",
      "namespace": "Microsoft.TestRP2",
      "registrationState": "NotRegistered",
      "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"
        }
      ]
    }
  ]
}

Определения

Имя	Описание
Alias	Тип псевдонима.
AliasPath	Тип путей для псевдонима.
AliasPathAttributes	Атрибуты маркера, на который ссылается путь псевдонима.
AliasPathMetadata
AliasPathTokenType	Тип маркера, на который ссылается путь псевдонима.
AliasPattern	Тип шаблона для пути псевдонима.
AliasPatternType	Тип шаблона псевдонима
AliasType	Тип псевдонима.
ApiProfile
CloudError	Ответ об ошибке для запроса на управление ресурсами.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorResponse	Сообщение об ошибке
Provider	Информация о поставщике ресурсов.
ProviderAuthorizationConsentState	Состояние согласия авторизации поставщика.
ProviderExtendedLocation	Расширенное расположение поставщика.
ProviderListResult	Список поставщиков ресурсов.
ProviderResourceType	Тип ресурса, управляемый поставщиком ресурсов.
ZoneMapping

Alias

Тип псевдонима.

Имя	Тип	Описание
defaultMetadata	AliasPathMetadata	Метаданные пути псевдонима по умолчанию. Применяется к пути по умолчанию и к любому пути псевдонима, который не содержит метаданных.
defaultPath	string	Путь по умолчанию для псевдонима.
defaultPattern	AliasPattern	Шаблон по умолчанию для псевдонима.
name	string	Имя псевдонима.
paths	AliasPath[]	Пути для псевдонима.
type	AliasType	Тип псевдонима.

AliasPath

Тип путей для псевдонима.

Имя	Тип	Описание
apiVersions	string[]	Версии API.
metadata	AliasPathMetadata	Метаданные пути псевдонима. Если он отсутствует, вернитесь к метаданным псевдонима по умолчанию.
path	string	Путь псевдонима.
pattern	AliasPattern	Шаблон для пути псевдонима.

AliasPathAttributes

Атрибуты маркера, на который ссылается путь псевдонима.

Имя	Тип	Описание
Modifiable	string	Маркер, на который ссылается путь псевдонима, можно изменить с помощью политик с эффектом "изменить".
None	string	Маркер, на который ссылается путь псевдонима, не имеет атрибутов.

AliasPathMetadata

Имя	Тип	Описание
attributes	AliasPathAttributes	Атрибуты маркера, на который ссылается путь псевдонима.
type	AliasPathTokenType	Тип маркера, на который ссылается путь псевдонима.

AliasPathTokenType

Тип маркера, на который ссылается путь псевдонима.

Имя	Тип	Описание
Any	string	Тип токена может быть любым.
Array	string	Тип токена — array.
Boolean	string	Тип токена — логический.
Integer	string	Тип токена — integer.
NotSpecified	string	Тип токена не указан.
Number	string	Тип токена — number.
Object	string	Тип токена — object.
String	string	Тип токена — string.

AliasPattern

Тип шаблона для пути псевдонима.

Имя	Тип	Описание
phrase	string	Фраза шаблона псевдонима.
type	AliasPatternType	Тип шаблона псевдонима
variable	string	Переменная шаблона псевдонима.

AliasPatternType

Тип шаблона псевдонима

Имя	Тип	Описание
Extract	string	Извлечение — это единственное допустимое значение.
NotSpecified	string	NotSpecified не допускается.

AliasType

Тип псевдонима.

Имя	Тип	Описание
Mask	string	Значение псевдонима — secret.
NotSpecified	string	Тип псевдонима неизвестен (то же самое, что тип псевдонима не указан).
PlainText	string	Значение псевдонима не является секретным.

ApiProfile

Имя	Тип	Описание
apiVersion	string	Версия API.
profileVersion	string	Версия профиля.

CloudError

Ответ об ошибке для запроса на управление ресурсами.

Имя	Тип	Описание
error	ErrorResponse	Сообщение об ошибке Общие ответы об ошибках для всех API Azure Resource Manager, возвращающие сведения об ошибке для неудачных операций. (Он также соответствует формату ответа об ошибке OData.)

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorResponse

Сообщение об ошибке

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorResponse[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

Provider

Информация о поставщике ресурсов.

Имя	Тип	Описание
id	string	Идентификатор поставщика.
namespace	string	Пространство имен поставщика ресурсов.
providerAuthorizationConsentState	ProviderAuthorizationConsentState	Состояние согласия авторизации поставщика.
registrationPolicy	string	Политика регистрации поставщика ресурсов.
registrationState	string	Состояние регистрации поставщика ресурсов.
resourceTypes	ProviderResourceType[]	Коллекция типов ресурсов поставщика.

ProviderAuthorizationConsentState

Состояние согласия авторизации поставщика.

Имя	Тип	Описание
Consented	string
NotRequired	string
NotSpecified	string
Required	string

ProviderExtendedLocation

Расширенное расположение поставщика.

Имя	Тип	Описание
extendedLocations	string[]	Расширенные расположения для расположения Azure.
location	string	Расположение Azure.
type	string	Тип расширенного расположения.

ProviderListResult

Список поставщиков ресурсов.

Имя	Тип	Описание
nextLink	string	URL-адрес, используемый для получения следующего набора результатов.
value	Provider[]	Массив поставщиков ресурсов.

ProviderResourceType

Тип ресурса, управляемый поставщиком ресурсов.

Имя	Тип	Описание
aliases	Alias[]	Псевдонимы, поддерживаемые этим типом ресурсов.
apiProfiles	ApiProfile[]	Профили API для поставщика ресурсов.
apiVersions	string[]	Версия API.
capabilities	string	Дополнительные возможности, предоставляемые этим типом ресурсов.
defaultApiVersion	string	Версия API по умолчанию.
locationMappings	ProviderExtendedLocation[]	Сопоставления расположений, поддерживаемые этим типом ресурсов.
locations	string[]	Коллекция расположений, в которых можно создать ресурс этого типа.
properties	object	Свойства.
resourceType	string	Тип ресурса.
zoneMappings	ZoneMapping[]

ZoneMapping

Имя	Тип	Описание
location	string	Расположение сопоставления зон.
zones	string[]

Поделиться через