Providers - List

Servizio:

Resource Management

Versione API:

2021-04-01

Ottiene tutti i provider di risorse per una sottoscrizione.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string	ID sottoscrizione di Microsoft Azure.
api-version	query	True	string	Versione dell'API da usare per questa operazione.
$expand	query		string	Proprietà da includere nei risultati. Ad esempio, usare &$expand=metadati nella stringa di query per recuperare i metadati del provider di risorse. Per includere alias di proprietà in risposta, usare $expand=resourceTypes/aliases.

Risposte

Nome	Tipo	Descrizione
200 OK	ProviderListResult	OK: restituisce una matrice di provider di risorse.
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get providers.

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
Alias	Tipo di alias.
AliasPath	Tipo dei percorsi per alias.
AliasPathAttributes	Attributi del token a cui fa riferimento il percorso alias.
AliasPathMetadata
AliasPathTokenType	Tipo del token a cui fa riferimento il percorso alias.
AliasPattern	Tipo del modello per un percorso alias.
AliasPatternType	Tipo di pattern alias
AliasType	Tipo dell'alias.
ApiProfile
CloudError	Risposta di errore per una richiesta di gestione delle risorse.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorResponse	Risposta errore
Provider	Informazioni sul provider di risorse.
ProviderAuthorizationConsentState	Stato di consenso dell'autorizzazione del provider.
ProviderExtendedLocation	Posizione estesa del provider.
ProviderListResult	Elenco dei provider di risorse.
ProviderResourceType	Tipo di risorsa gestito dal provider di risorse.
ZoneMapping

Alias

Object

Tipo di alias.

Nome	Tipo	Descrizione
defaultMetadata	AliasPathMetadata	Metadati del percorso alias predefiniti. Si applica al percorso predefinito e a qualsiasi percorso alias che non dispone di metadati
defaultPath	string	Percorso predefinito per un alias.
defaultPattern	AliasPattern	Modello predefinito per un alias.
name	string	Nome alias.
paths	AliasPath[]	Percorsi di un alias.
type	AliasType	Tipo dell'alias.

AliasPath

Object

Tipo dei percorsi per alias.

Nome	Tipo	Descrizione
apiVersions	string[]	Versioni dell'API.
metadata	AliasPathMetadata	Metadati del percorso alias. Se mancante, eseguire il fallback ai metadati predefiniti dell'alias.
path	string	Percorso di un alias.
pattern	AliasPattern	Modello per un percorso alias.

AliasPathAttributes

Enumerazione

Attributi del token a cui fa riferimento il percorso alias.

Valore	Descrizione
Modifiable	Il token a cui fa riferimento il percorso alias è modificabile dai criteri con effetto 'modify'.
None	Il token a cui fa riferimento il percorso alias non ha attributi.

AliasPathMetadata

Object

Nome	Tipo	Descrizione
attributes	AliasPathAttributes	Attributi del token a cui fa riferimento il percorso alias.
type	AliasPathTokenType	Tipo del token a cui fa riferimento il percorso alias.

AliasPathTokenType

Enumerazione

Tipo del token a cui fa riferimento il percorso alias.

Valore	Descrizione
Any	Il tipo di token può essere qualsiasi elemento.
Array	Il tipo di token è array.
Boolean	Il tipo di token è booleano.
Integer	Il tipo di token è integer.
NotSpecified	Il tipo di token non è specificato.
Number	Il tipo di token è number.
Object	Il tipo di token è object.
String	Il tipo di token è string.

AliasPattern

Object

Tipo del modello per un percorso alias.

Nome	Tipo	Descrizione
phrase	string	Frase del criterio alias.
type	AliasPatternType	Tipo di pattern alias
variable	string	Variabile del pattern alias.

AliasPatternType

Enumerazione

Tipo di pattern alias

Valore	Descrizione
Extract	Extract è l'unico valore consentito.
NotSpecified	NotSpecified non è consentito.

AliasType

Enumerazione

Tipo dell'alias.

Valore	Descrizione
Mask	Il valore alias è segreto.
NotSpecified	Il tipo di alias è sconosciuto (uguale a non fornire il tipo di alias).
PlainText	Il valore alias non è segreto.

ApiProfile

Object

Nome	Tipo	Descrizione
apiVersion	string	Versione dell'API.
profileVersion	string	Versione del profilo.

CloudError

Object

Risposta di errore per una richiesta di gestione delle risorse.

Nome	Tipo	Descrizione
error	ErrorResponse	Risposta errore Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorResponse

Object

Risposta errore

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorResponse[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

Provider

Object

Informazioni sul provider di risorse.

Nome	Tipo	Descrizione
id	string	ID provider.
namespace	string	Spazio dei nomi del provider di risorse.
providerAuthorizationConsentState	ProviderAuthorizationConsentState	Stato di consenso dell'autorizzazione del provider.
registrationPolicy	string	Criteri di registrazione del provider di risorse.
registrationState	string	Stato di registrazione del provider di risorse.
resourceTypes	ProviderResourceType[]	Raccolta di tipi di risorse del provider.

ProviderAuthorizationConsentState

Enumerazione

Stato di consenso dell'autorizzazione del provider.

Valore	Descrizione
Consented
NotRequired
NotSpecified
Required

ProviderExtendedLocation

Object

Posizione estesa del provider.

Nome	Tipo	Descrizione
extendedLocations	string[]	Località estese per la località di Azure.
location	string	Località di Azure.
type	string	Tipo di posizione estesa.

ProviderListResult

Object

Elenco dei provider di risorse.

Nome	Tipo	Descrizione
nextLink	string	URL da usare per ottenere il set di risultati successivo.
value	Provider[]	Matrice di provider di risorse.

ProviderResourceType

Object

Tipo di risorsa gestito dal provider di risorse.

Nome	Tipo	Descrizione
aliases	Alias[]	Alias supportati da questo tipo di risorsa.
apiProfiles	ApiProfile[]	Profili API per il provider di risorse.
apiVersions	string[]	Versione dell'API.
capabilities	string	Funzionalità aggiuntive offerte da questo tipo di risorsa.
defaultApiVersion	string	Versione dell'API predefinita.
locationMappings	ProviderExtendedLocation[]	Mapping dei percorsi supportati da questo tipo di risorsa.
locations	string[]	Raccolta di posizioni in cui è possibile creare questo tipo di risorsa.
properties	object	Proprietà.
resourceType	string	Tipo di risorsa.
zoneMappings	ZoneMapping[]

ZoneMapping

Object

Nome	Tipo	Descrizione
location	string	Posizione del mapping della zona.
zones	string[]