Providers - List

Service:

Resource Management

API-versie:

2021-04-01

Hiermee worden alle resourceproviders voor een abonnement opgehaald.

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

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
subscriptionId	path	True	string	De Microsoft Azure-abonnements-id.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.
$expand	query		string	De eigenschappen die moeten worden opgenomen in de resultaten. Gebruik bijvoorbeeld &$expand=metadata in de querytekenreeks om metagegevens van de resourceprovider op te halen. Als u eigenschapsaliassen wilt opnemen in het antwoord, gebruikt u $expand=resourceTypes/aliassen.

Antwoorden

Name	Type	Description
200 OK	ProviderListResult	OK: retourneert een matrix van resourceproviders.
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Get providers.

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
Alias	Het aliastype.
AliasPath	Het type van de paden voor alias.
AliasPathAttributes	De kenmerken van het token waarnaar het aliaspad verwijst.
AliasPathMetadata
AliasPathTokenType	Het type van het token waarnaar het aliaspad verwijst.
AliasPattern	Het type patroon voor een aliaspad.
AliasPatternType	Het type aliaspatroon
AliasType	Het type alias.
ApiProfile
CloudError	Een foutreactie voor een resourcebeheeraanvraag.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorResponse	Foutreactie
Provider	Resourceprovidergegevens.
ProviderAuthorizationConsentState	De autorisatietoestemmingsstatus van de provider.
ProviderExtendedLocation	De uitgebreide locatie van de provider.
ProviderListResult	Lijst met resourceproviders.
ProviderResourceType	Resourcetype dat wordt beheerd door de resourceprovider.
ZoneMapping

Alias

Het aliastype.

Name	Type	Description
defaultMetadata	AliasPathMetadata	De metagegevens van het standaardaliaspad. Is van toepassing op het standaardpad en op elk aliaspad dat geen metagegevens bevat
defaultPath	string	Het standaardpad voor een alias.
defaultPattern	AliasPattern	Het standaardpatroon voor een alias.
name	string	De aliasnaam.
paths	AliasPath[]	De paden voor een alias.
type	AliasType	Het type alias.

AliasPath

Het type van de paden voor alias.

Name	Type	Description
apiVersions	string[]	De API-versies.
metadata	AliasPathMetadata	De metagegevens van het aliaspad. Als u ontbreekt, kunt u terugvallen op de standaardmetagegevens van de alias.
path	string	Het pad van een alias.
pattern	AliasPattern	Het patroon voor een aliaspad.

AliasPathAttributes

De kenmerken van het token waarnaar het aliaspad verwijst.

Name	Type	Description
Modifiable	string	Het token waarnaar het aliaspad verwijst, kan worden gewijzigd door beleidsregels met een 'wijzigen'-effect.
None	string	Het token waarnaar het aliaspad verwijst, heeft geen kenmerken.

AliasPathMetadata

Name	Type	Description
attributes	AliasPathAttributes	De kenmerken van het token waarnaar het aliaspad verwijst.
type	AliasPathTokenType	Het type van het token waarnaar het aliaspad verwijst.

AliasPathTokenType

Het type van het token waarnaar het aliaspad verwijst.

Name	Type	Description
Any	string	Het tokentype kan van alles zijn.
Array	string	Het tokentype is matrix.
Boolean	string	Het tokentype is booleaanse waarde.
Integer	string	Het tokentype is geheel getal.
NotSpecified	string	Het tokentype is niet opgegeven.
Number	string	Het tokentype is getal.
Object	string	Het tokentype is object.
String	string	Het tokentype is tekenreeks.

AliasPattern

Het type patroon voor een aliaspad.

Name	Type	Description
phrase	string	De aliaspatroonzin.
type	AliasPatternType	Het type aliaspatroon
variable	string	De aliaspatroonvariabele.

AliasPatternType

Het type aliaspatroon

Name	Type	Description
Extract	string	Extraheren is de enige toegestane waarde.
NotSpecified	string	NotSpecified is niet toegestaan.

AliasType

Het type alias.

Name	Type	Description
Mask	string	Aliaswaarde is geheim.
NotSpecified	string	Aliastype is onbekend (hetzelfde als het niet opgeven van aliastype).
PlainText	string	Aliaswaarde is niet geheim.

ApiProfile

Name	Type	Description
apiVersion	string	De API-versie.
profileVersion	string	De profielversie.

CloudError

Een foutreactie voor een resourcebeheeraanvraag.

Name	Type	Description
error	ErrorResponse	Foutreactie Algemene foutreactie voor alle Azure Resource Manager-API's om foutdetails voor mislukte bewerkingen te retourneren. (Dit volgt ook de indeling van de OData-foutreactie.)

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorResponse

Foutreactie

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout aanvullende informatie.
code	string	De foutcode.
details	ErrorResponse[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

Provider

Resourceprovidergegevens.

Name	Type	Description
id	string	De provider-id.
namespace	string	De naamruimte van de resourceprovider.
providerAuthorizationConsentState	ProviderAuthorizationConsentState	De autorisatietoestemmingsstatus van de provider.
registrationPolicy	string	Het registratiebeleid van de resourceprovider.
registrationState	string	De registratiestatus van de resourceprovider.
resourceTypes	ProviderResourceType[]	De verzameling van providerresourcetypen.

ProviderAuthorizationConsentState

De autorisatietoestemmingsstatus van de provider.

Name	Type	Description
Consented	string
NotRequired	string
NotSpecified	string
Required	string

ProviderExtendedLocation

De uitgebreide locatie van de provider.

Name	Type	Description
extendedLocations	string[]	De uitgebreide locaties voor de Azure-locatie.
location	string	De Azure-locatie.
type	string	Het uitgebreide locatietype.

ProviderListResult

Lijst met resourceproviders.

Name	Type	Description
nextLink	string	De URL die moet worden gebruikt voor het ophalen van de volgende set resultaten.
value	Provider[]	Een matrix van resourceproviders.

ProviderResourceType

Resourcetype dat wordt beheerd door de resourceprovider.

Name	Type	Description
aliases	Alias[]	De aliassen die worden ondersteund door dit resourcetype.
apiProfiles	ApiProfile[]	De API-profielen voor de resourceprovider.
apiVersions	string[]	De API-versie.
capabilities	string	De extra mogelijkheden die door dit resourcetype worden geboden.
defaultApiVersion	string	De standaard-API-versie.
locationMappings	ProviderExtendedLocation[]	De locatietoewijzingen die worden ondersteund door dit resourcetype.
locations	string[]	De verzameling locaties waar dit resourcetype kan worden gemaakt.
properties	object	De eigenschappen.
resourceType	string	Het resourcetype.
zoneMappings	ZoneMapping[]

ZoneMapping

Name	Type	Description
location	string	De locatie van de zonetoewijzing.
zones	string[]