Providers - List

Usługa:

Resource Management

Wersja interfejsu API:

2021-04-01

Pobiera wszystkich dostawców zasobów dla subskrypcji.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
subscriptionId	path	True	string	Identyfikator subskrypcji platformy Microsoft Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.
$expand	query		string	Właściwości do uwzględnienia w wynikach. Na przykład użyj &$expand=metadata w ciągu zapytania, aby pobrać metadane dostawcy zasobów. Aby uwzględnić aliasy właściwości w odpowiedzi, użyj polecenia $expand=resourceTypes/aliases.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ProviderListResult	OK — zwraca tablicę dostawców zasobów.
Other Status Codes	CloudError	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Get providers.

Przykładowe żądanie

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers?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/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

JavaScript

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

Przykładowa odpowiedź

Kod stanu:

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"
        }
      ]
    }
  ]
}

Definicje

Nazwa	Opis
Alias	Typ aliasu.
AliasPath	Typ ścieżek dla aliasu.
AliasPathAttributes	Atrybuty tokenu, do którego odwołuje się ścieżka aliasu.
AliasPathMetadata
AliasPathTokenType	Typ tokenu, do którego odwołuje się ścieżka aliasu.
AliasPattern	Typ wzorca dla ścieżki aliasu.
AliasPatternType	Typ wzorca aliasu
AliasType	Typ aliasu.
ApiProfile
CloudError	Odpowiedź na błąd żądania zarządzania zasobami.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorResponse	Odpowiedź na błąd
Provider	Informacje o dostawcy zasobów.
ProviderAuthorizationConsentState	Stan zgody autoryzacji dostawcy.
ProviderExtendedLocation	Lokalizacja rozszerzona dostawcy.
ProviderListResult	Lista dostawców zasobów.
ProviderResourceType	Typ zasobu zarządzany przez dostawcę zasobów.
ZoneMapping

Alias

Typ aliasu.

Nazwa	Typ	Opis
defaultMetadata	AliasPathMetadata	Domyślne metadane ścieżki aliasu. Dotyczy ścieżki domyślnej i ścieżki aliasu, która nie ma metadanych
defaultPath	string	Domyślna ścieżka aliasu.
defaultPattern	AliasPattern	Domyślny wzorzec aliasu.
name	string	Nazwa aliasu.
paths	AliasPath[]	Ścieżki aliasu.
type	AliasType	Typ aliasu.

AliasPath

Typ ścieżek dla aliasu.

Nazwa	Typ	Opis
apiVersions	string[]	Wersje interfejsu API.
metadata	AliasPathMetadata	Metadane ścieżki aliasu. Jeśli brakuje, wróć do domyślnych metadanych aliasu.
path	string	Ścieżka aliasu.
pattern	AliasPattern	Wzorzec ścieżki aliasu.

AliasPathAttributes

Atrybuty tokenu, do którego odwołuje się ścieżka aliasu.

Nazwa	Typ	Opis
Modifiable	string	Token, do którego odwołuje się ścieżka aliasu, można modyfikować przez zasady z efektem "modyfikuj".
None	string	Token, do którego odwołuje się ścieżka aliasu, nie ma atrybutów.

AliasPathMetadata

Nazwa	Typ	Opis
attributes	AliasPathAttributes	Atrybuty tokenu, do którego odwołuje się ścieżka aliasu.
type	AliasPathTokenType	Typ tokenu, do którego odwołuje się ścieżka aliasu.

AliasPathTokenType

Typ tokenu, do którego odwołuje się ścieżka aliasu.

Nazwa	Typ	Opis
Any	string	Typ tokenu może być dowolny.
Array	string	Typ tokenu to tablica.
Boolean	string	Typ tokenu to wartość logiczna.
Integer	string	Typ tokenu to liczba całkowita.
NotSpecified	string	Nie określono typu tokenu.
Number	string	Typ tokenu to liczba.
Object	string	Typ tokenu to obiekt.
String	string	Typ tokenu to ciąg.

AliasPattern

Typ wzorca dla ścieżki aliasu.

Nazwa	Typ	Opis
phrase	string	Fraza wzorca aliasu.
type	AliasPatternType	Typ wzorca aliasu
variable	string	Zmienna wzorca aliasu.

AliasPatternType

Typ wzorca aliasu

Nazwa	Typ	Opis
Extract	string	Wyodrębnianie jest jedyną dozwoloną wartością.
NotSpecified	string	Pozycja NotSpecified jest niedozwolona.

AliasType

Typ aliasu.

Nazwa	Typ	Opis
Mask	string	Wartość aliasu jest wpisem tajnym.
NotSpecified	string	Typ aliasu jest nieznany (taki sam jak typ aliasu).
PlainText	string	Wartość aliasu nie jest wpisem tajnym.

ApiProfile

Nazwa	Typ	Opis
apiVersion	string	Wersja interfejsu API.
profileVersion	string	Wersja profilu.

CloudError

Odpowiedź na błąd żądania zarządzania zasobami.

Nazwa	Typ	Opis
error	ErrorResponse	Odpowiedź na błąd Typowa odpowiedź na błąd dla wszystkich interfejsów API usługi Azure Resource Manager zwraca szczegóły błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi oData).

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorResponse[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

Provider

Informacje o dostawcy zasobów.

Nazwa	Typ	Opis
id	string	Identyfikator dostawcy.
namespace	string	Przestrzeń nazw dostawcy zasobów.
providerAuthorizationConsentState	ProviderAuthorizationConsentState	Stan zgody autoryzacji dostawcy.
registrationPolicy	string	Zasady rejestracji dostawcy zasobów.
registrationState	string	Stan rejestracji dostawcy zasobów.
resourceTypes	ProviderResourceType[]	Kolekcja typów zasobów dostawcy.

ProviderAuthorizationConsentState

Stan zgody autoryzacji dostawcy.

Nazwa	Typ	Opis
Consented	string
NotRequired	string
NotSpecified	string
Required	string

ProviderExtendedLocation

Lokalizacja rozszerzona dostawcy.

Nazwa	Typ	Opis
extendedLocations	string[]	Rozszerzone lokalizacje dla lokalizacji platformy Azure.
location	string	Lokalizacja platformy Azure.
type	string	Typ lokalizacji rozszerzonej.

ProviderListResult

Lista dostawców zasobów.

Nazwa	Typ	Opis
nextLink	string	Adres URL używany do pobierania następnego zestawu wyników.
value	Provider[]	Tablica dostawców zasobów.

ProviderResourceType

Typ zasobu zarządzany przez dostawcę zasobów.

Nazwa	Typ	Opis
aliases	Alias[]	Aliasy obsługiwane przez ten typ zasobu.
apiProfiles	ApiProfile[]	Profile interfejsu API dla dostawcy zasobów.
apiVersions	string[]	Wersja interfejsu API.
capabilities	string	Dodatkowe możliwości oferowane przez ten typ zasobu.
defaultApiVersion	string	Domyślna wersja interfejsu API.
locationMappings	ProviderExtendedLocation[]	Mapowania lokalizacji obsługiwane przez ten typ zasobu.
locations	string[]	Kolekcja lokalizacji, w których można utworzyć ten typ zasobu.
properties	object	Właściwości.
resourceType	string	Typ zasobu.
zoneMappings	ZoneMapping[]

ZoneMapping

Nazwa	Typ	Opis
location	string	Lokalizacja mapowania strefy.
zones	string[]