Providers - List

Referencia

Servicio:: Resource Management

Versión de la API:: 2021-04-01

Obtiene todos los proveedores de recursos de una suscripción.

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

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
subscriptionId	path	True	string	Identificador de suscripción de Microsoft Azure.
api-version	query	True	string	Versión de API que se usará para la operación.
$expand	query		string	Propiedades que se van a incluir en los resultados. Por ejemplo, use &$expand=metadata en la cadena de consulta para recuperar los metadatos del proveedor de recursos. Para incluir alias de propiedad en respuesta, use $expand=resourceTypes/aliases.

Respuestas

Nombre	Tipo	Description
200 OK	ProviderListResult	Aceptar: devuelve una matriz de proveedores de recursos.
Other Status Codes	CloudError	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Get providers.

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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"
        }
      ]
    }
  ]
}

Definiciones

Nombre	Description
Alias	Tipo de alias.
AliasPath	Tipo de las rutas de acceso para alias.
AliasPathAttributes	Atributos del token al que hace referencia la ruta de acceso del alias.
AliasPathMetadata
AliasPathTokenType	Tipo del token al que hace referencia la ruta de acceso del alias.
AliasPattern	Tipo del patrón para una ruta de acceso de alias.
AliasPatternType	Tipo de patrón de alias
AliasType	Tipo del alias.
ApiProfile
CloudError	Respuesta de error para una solicitud de administración de recursos.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorResponse	Respuesta de error
Provider	Información de proveedor de recursos.
ProviderAuthorizationConsentState	Estado de consentimiento de autorización del proveedor.
ProviderExtendedLocation	Ubicación extendida del proveedor.
ProviderListResult	Lista de proveedores de recursos.
ProviderResourceType	Tipo de recurso que administra el proveedor de recursos.
ZoneMapping

Alias

Tipo de alias.

Nombre	Tipo	Description
defaultMetadata	AliasPathMetadata	Metadatos de la ruta de acceso de alias predeterminada. Se aplica a la ruta de acceso predeterminada y a cualquier ruta de acceso de alias que no tenga metadatos.
defaultPath	string	Ruta de acceso predeterminada para un alias.
defaultPattern	AliasPattern	Patrón predeterminado para un alias.
name	string	Nombre del alias.
paths	AliasPath[]	Rutas de acceso de un alias.
type	AliasType	Tipo del alias.

AliasPath

Tipo de las rutas de acceso para alias.

Nombre	Tipo	Description
apiVersions	string[]	Las versiones de la API.
metadata	AliasPathMetadata	Metadatos de la ruta de acceso del alias. Si falta, vuelva a los metadatos predeterminados del alias.
path	string	Ruta de acceso de un alias.
pattern	AliasPattern	Patrón de una ruta de acceso de alias.

AliasPathAttributes

Atributos del token al que hace referencia la ruta de acceso del alias.

Nombre	Tipo	Description
Modifiable	string	El token al que hace referencia la ruta de acceso del alias es modificable mediante directivas con efecto "modify".
None	string	El token al que hace referencia la ruta de acceso del alias no tiene atributos.

AliasPathMetadata

Nombre	Tipo	Description
attributes	AliasPathAttributes	Atributos del token al que hace referencia la ruta de acceso del alias.
type	AliasPathTokenType	Tipo del token al que hace referencia la ruta de acceso del alias.

AliasPathTokenType

Tipo del token al que hace referencia la ruta de acceso del alias.

Nombre	Tipo	Description
Any	string	El tipo de token puede ser cualquier cosa.
Array	string	El tipo de token es array.
Boolean	string	El tipo de token es booleano.
Integer	string	El tipo de token es entero.
NotSpecified	string	No se especifica el tipo de token.
Number	string	El tipo de token es number.
Object	string	El tipo de token es object.
String	string	El tipo de token es cadena.

AliasPattern

Tipo del patrón para una ruta de acceso de alias.

Nombre	Tipo	Description
phrase	string	La frase de patrón de alias.
type	AliasPatternType	Tipo de patrón de alias
variable	string	Variable de patrón de alias.

AliasPatternType

Tipo de patrón de alias

Nombre	Tipo	Description
Extract	string	Extract es el único valor permitido.
NotSpecified	string	No se permite NotSpecified.

AliasType

Tipo del alias.

Nombre	Tipo	Description
Mask	string	El valor del alias es secreto.
NotSpecified	string	El tipo de alias es desconocido (igual que no proporcionar el tipo de alias).
PlainText	string	El valor del alias no es secreto.

ApiProfile

Nombre	Tipo	Description
apiVersion	string	Versión de la API.
profileVersion	string	La versión del perfil.

CloudError

Respuesta de error para una solicitud de administración de recursos.

Nombre	Tipo	Description
error	ErrorResponse	Respuesta de error Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorResponse[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

Provider

Información de proveedor de recursos.

Nombre	Tipo	Description
id	string	La identificación del proveedor.
namespace	string	Espacio de nombres del proveedor de recursos.
providerAuthorizationConsentState	ProviderAuthorizationConsentState	Estado de consentimiento de autorización del proveedor.
registrationPolicy	string	La directiva de registro del proveedor de recursos.
registrationState	string	Estado de registro del proveedor de recursos.
resourceTypes	ProviderResourceType[]	Colección de tipos de recursos de proveedor.

ProviderAuthorizationConsentState

Estado de consentimiento de autorización del proveedor.

Nombre	Tipo	Description
Consented	string
NotRequired	string
NotSpecified	string
Required	string

ProviderExtendedLocation

Ubicación extendida del proveedor.

Nombre	Tipo	Description
extendedLocations	string[]	Ubicaciones extendidas para la ubicación de Azure.
location	string	La ubicación de Azure.
type	string	Tipo de ubicación extendida.

ProviderListResult

Lista de proveedores de recursos.

Nombre	Tipo	Description
nextLink	string	Dirección URL que se va a usar para obtener el siguiente conjunto de resultados.
value	Provider[]	Matriz de proveedores de recursos.

ProviderResourceType

Tipo de recurso que administra el proveedor de recursos.

Nombre	Tipo	Description
aliases	Alias[]	Alias admitidos por este tipo de recurso.
apiProfiles	ApiProfile[]	Perfiles de API para el proveedor de recursos.
apiVersions	string[]	Versión de la API.
capabilities	string	Las funcionalidades adicionales que ofrece este tipo de recurso.
defaultApiVersion	string	La versión de API predeterminada.
locationMappings	ProviderExtendedLocation[]	Asignaciones de ubicación admitidas por este tipo de recurso.
locations	string[]	Colección de ubicaciones donde se puede crear este tipo de recurso.
properties	object	Propiedades.
resourceType	string	El tipo de recurso.
zoneMappings	ZoneMapping[]

ZoneMapping

Nombre	Tipo	Description
location	string	Ubicación de la asignación de zona.
zones	string[]

Compartir a través de