Tipos y proveedores de recursos de AzureAzure resource providers and types

Al implementar los recursos, con frecuencia necesitará recuperar información sobre los tipos y proveedores de recursos.When deploying resources, you frequently need to retrieve information about the resource providers and types. Por ejemplo, si quiere almacenar claves y secretos, trabajará con el proveedor de recursos Microsoft.KeyVault.For example, if you want to store keys and secrets, you work with the Microsoft.KeyVault resource provider. Este proveedor de recursos ofrece un tipo de recurso denominado almacenes para crear el almacén de claves.This resource provider offers a resource type called vaults for creating the key vault.

El nombre de un tipo de recurso tiene el formato: {proveedor de recursos}/{tipo de recurso} .The name of a resource type is in the format: {resource-provider}/{resource-type}. El tipo de recurso para un almacén de claves es Microsoft.KeyVault/vaults.The resource type for a key vault is Microsoft.KeyVault/vaults.

En este artículo, aprenderá a:In this article, you learn how to:

  • Ver todos los proveedores de recursos de AzureView all resource providers in Azure
  • Comprobar el estado de registro de un proveedor de recursosCheck registration status of a resource provider
  • Registrar un proveedor de recursosRegister a resource provider
  • Ver los tipos de recursos de un proveedorView resource types for a resource provider
  • Ver las ubicaciones válidas de un tipo de recursoView valid locations for a resource type
  • Ver las versiones de API válidas de un tipo de recursoView valid API versions for a resource type

Puede llevar a cabo estos pasos en Azure Portal, Azure PowerShell o la CLI de Azure.You can do these steps through the Azure portal, Azure PowerShell, or Azure CLI.

Para obtener una lista que asigna proveedores de recursos con servicios de Azure, consulte Proveedores de recursos para servicios de Azure.For a list that maps resource providers to Azure services, see Resource providers for Azure services.

Portal de AzureAzure portal

Para ver todos los proveedores de recursos y el estado de registro de su suscripción:To see all resource providers, and the registration status for your subscription:

  1. Inicie sesión en el Azure Portal.Sign in to the Azure portal.

  2. En el menú de Azure Portal, seleccione Todos los servicios.On the Azure portal menu, select All services.

    selección de suscripciones

  3. En el cuadro Todos los servicios, escriba suscripción y, a continuación, seleccione Suscripciones.In the All services box, enter subscription, and then select Subscriptions.

  4. Seleccione la suscripción en la lista de suscripción para verla.Select the subscription from the subscription list to view.

  5. Seleccione Proveedores de recursos y consulte la lista de proveedores de recursos disponibles.Select Resource providers and view the list of available resource providers.

    vista de los proveedores de recursos

  6. Al registrar un proveedor de recursos se configura la suscripción para que funcione con este.Registering a resource provider configures your subscription to work with the resource provider. El ámbito de registro es siempre la suscripción.The scope for registration is always the subscription. De forma predeterminada, muchos proveedores de recursos se registran automáticamente.By default, many resource providers are automatically registered. Pero es posible que tenga que registrar manualmente algunos.However, you may need to manually register some resource providers. Para registrar un proveedor de recursos, debe tener permiso para realizar la operación /register/action para este.To register a resource provider, you must have permission to do the /register/action operation for the resource provider. Esta operación está incluida en los roles Colaborador y Propietario.This operation is included in the Contributor and Owner roles. Para registrar un proveedor de recursos, seleccione Registro.To register a resource provider, select Register. En la captura de pantalla anterior, el vínculo Registrar se resalta para Microsoft.Blueprint.In the previous screenshot, the Register link is highlighted for Microsoft.Blueprint.

    No se puede anular el registro de un proveedor de recursos si todavía dispone de tipos de recursos de dicho proveedor en la suscripción.You can't unregister a resource provider when you still have resource types from that resource provider in your subscription.

Para ver información de un proveedor de recursos concreto:To see information for a particular resource provider:

  1. Inicie sesión en el Azure Portal.Sign in to the Azure portal.

  2. En el menú de Azure Portal, seleccione Todos los servicios.On the Azure portal menu, select All services.

  3. En el cuadro Todos los servicios, escriba Explorador de recursos y, a continuación, seleccione Explorador de recursos.In the All services box, enter resource explorer, and then select Resource Explorer.

    seleccione Todos los servicios

  4. Expanda Proveedores; para ello, seleccione la flecha derecha.Expand Providers by selecting the right arrow.

    Selección de proveedores

  5. Expanda un proveedor de recursos y el tipo de recurso que desea ver.Expand a resource provider and resource type that you want to view.

    Selección del tipo de recurso

  6. El Administrador de recursos se admite en todas las regiones, pero puede que los recursos que implementa no se admitan en todas las regiones.Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. Además, puede haber limitaciones en su suscripción que le impidan utilizar algunas regiones que admiten el recurso.In addition, there may be limitations on your subscription that prevent you from using some regions that support the resource. El explorador de recursos muestra las ubicaciones válidas para el tipo de recurso.The resource explorer displays valid locations for the resource type.

    Vista de las ubicaciones

  7. La versión de API se corresponde a una versión de operaciones de API de REST que se publican por el proveedor de recursos.The API version corresponds to a version of REST API operations that are released by the resource provider. Conforme un proveedor de recursos habilite nuevas características, publicará una nueva versión de la API de REST.As a resource provider enables new features, it releases a new version of the REST API. El explorador de recursos muestra las versiones de API válidas para el tipo de recurso.The resource explorer displays valid API versions for the resource type.

    Vista de las versiones de API

Azure PowerShellAzure PowerShell

Nota

Este artículo se ha actualizado para usar el nuevo módulo Az de Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Aún puede usar el módulo de AzureRM que continuará recibiendo correcciones de errores hasta diciembre de 2020 como mínimo.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Para más información acerca del nuevo módulo Az y la compatibilidad con AzureRM, consulte Introducing the new Azure PowerShell Az module (Presentación del nuevo módulo Az de Azure PowerShell).To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Para obtener instrucciones sobre la instalación del módulo Az, consulte Instalación de Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Para ver todos los proveedores de recursos de Azure y el estado de registro de su suscripción, use:To see all resource providers in Azure, and the registration status for your subscription, use:

Get-AzResourceProvider -ListAvailable | Select-Object ProviderNamespace, RegistrationState

Que devuelve resultados similares a:Which returns results similar to:

ProviderNamespace                RegistrationState
-------------------------------- ------------------
Microsoft.ClassicCompute         Registered
Microsoft.ClassicNetwork         Registered
Microsoft.ClassicStorage         Registered
Microsoft.CognitiveServices      Registered
...

Al registrar un proveedor de recursos se configura la suscripción para que funcione con este.Registering a resource provider configures your subscription to work with the resource provider. El ámbito de registro es siempre la suscripción.The scope for registration is always the subscription. De forma predeterminada, muchos proveedores de recursos se registran automáticamente.By default, many resource providers are automatically registered. Pero es posible que tenga que registrar manualmente algunos.However, you may need to manually register some resource providers. Para registrar un proveedor de recursos, debe tener permiso para realizar la operación /register/action para este.To register a resource provider, you must have permission to do the /register/action operation for the resource provider. Esta operación está incluida en los roles Colaborador y Propietario.This operation is included in the Contributor and Owner roles.

Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

Que devuelve resultados similares a:Which returns results similar to:

ProviderNamespace : Microsoft.Batch
RegistrationState : Registering
ResourceTypes     : {batchAccounts, operations, locations, locations/quotas}
Locations         : {West Europe, East US, East US 2, West US...}

No se puede anular el registro de un proveedor de recursos si todavía dispone de tipos de recursos de dicho proveedor en la suscripción.You can't unregister a resource provider when you still have resource types from that resource provider in your subscription.

Para ver información de un proveedor de recursos concreto, use:To see information for a particular resource provider, use:

Get-AzResourceProvider -ProviderNamespace Microsoft.Batch

Que devuelve resultados similares a:Which returns results similar to:

{ProviderNamespace : Microsoft.Batch
RegistrationState : Registered
ResourceTypes     : {batchAccounts}
Locations         : {West Europe, East US, East US 2, West US...}

...

Para ver los tipos de recursos de un proveedor, use:To see the resource types for a resource provider, use:

(Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes.ResourceTypeName

Que devuelve:Which returns:

batchAccounts
operations
locations
locations/quotas

La versión de API se corresponde a una versión de operaciones de API de REST que se publican por el proveedor de recursos.The API version corresponds to a version of REST API operations that are released by the resource provider. Conforme un proveedor de recursos habilite nuevas características, publicará una nueva versión de la API de REST.As a resource provider enables new features, it releases a new version of the REST API.

Para obtener las versiones de API de un tipo de recurso, use:To get the available API versions for a resource type, use:

((Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes | Where-Object ResourceTypeName -eq batchAccounts).ApiVersions

Que devuelve:Which returns:

2017-05-01
2017-01-01
2015-12-01
2015-09-01
2015-07-01

El Administrador de recursos se admite en todas las regiones, pero puede que los recursos que implementa no se admitan en todas las regiones.Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. Además, puede haber limitaciones en su suscripción que le impidan utilizar algunas regiones que admiten el recurso.In addition, there may be limitations on your subscription that prevent you from using some regions that support the resource.

Para obtener las ubicaciones compatibles con un tipo de recurso, use:To get the supported locations for a resource type, use.

((Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes | Where-Object ResourceTypeName -eq batchAccounts).Locations

Que devuelve:Which returns:

West Europe
East US
East US 2
West US
...

CLI de AzureAzure CLI

Para ver todos los proveedores de recursos de Azure y el estado de registro de su suscripción, use:To see all resource providers in Azure, and the registration status for your subscription, use:

az provider list --query "[].{Provider:namespace, Status:registrationState}" --out table

Que devuelve resultados similares a:Which returns results similar to:

Provider                         Status
-------------------------------- ----------------
Microsoft.ClassicCompute         Registered
Microsoft.ClassicNetwork         Registered
Microsoft.ClassicStorage         Registered
Microsoft.CognitiveServices      Registered
...

Al registrar un proveedor de recursos se configura la suscripción para que funcione con este.Registering a resource provider configures your subscription to work with the resource provider. El ámbito de registro es siempre la suscripción.The scope for registration is always the subscription. De forma predeterminada, muchos proveedores de recursos se registran automáticamente.By default, many resource providers are automatically registered. Pero es posible que tenga que registrar manualmente algunos.However, you may need to manually register some resource providers. Para registrar un proveedor de recursos, debe tener permiso para realizar la operación /register/action para este.To register a resource provider, you must have permission to do the /register/action operation for the resource provider. Esta operación está incluida en los roles Colaborador y Propietario.This operation is included in the Contributor and Owner roles.

az provider register --namespace Microsoft.Batch

Que devuelve un mensaje que indica que el registro está en curso.Which returns a message that registration is on-going.

No se puede anular el registro de un proveedor de recursos si todavía dispone de tipos de recursos de dicho proveedor en la suscripción.You can't unregister a resource provider when you still have resource types from that resource provider in your subscription.

Para ver información de un proveedor de recursos concreto, use:To see information for a particular resource provider, use:

az provider show --namespace Microsoft.Batch

Que devuelve resultados similares a:Which returns results similar to:

{
    "id": "/subscriptions/####-####/providers/Microsoft.Batch",
    "namespace": "Microsoft.Batch",
    "registrationsState": "Registering",
    "resourceTypes:" [
        ...
    ]
}

Para ver los tipos de recursos de un proveedor, use:To see the resource types for a resource provider, use:

az provider show --namespace Microsoft.Batch --query "resourceTypes[*].resourceType" --out table

Que devuelve:Which returns:

Result
---------------
batchAccounts
operations
locations
locations/quotas

La versión de API se corresponde a una versión de operaciones de API de REST que se publican por el proveedor de recursos.The API version corresponds to a version of REST API operations that are released by the resource provider. Conforme un proveedor de recursos habilite nuevas características, publicará una nueva versión de la API de REST.As a resource provider enables new features, it releases a new version of the REST API.

Para obtener las versiones de API de un tipo de recurso, use:To get the available API versions for a resource type, use:

az provider show --namespace Microsoft.Batch --query "resourceTypes[?resourceType=='batchAccounts'].apiVersions | [0]" --out table

Que devuelve:Which returns:

Result
---------------
2017-05-01
2017-01-01
2015-12-01
2015-09-01
2015-07-01

El Administrador de recursos se admite en todas las regiones, pero puede que los recursos que implementa no se admitan en todas las regiones.Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. Además, puede haber limitaciones en su suscripción que le impidan utilizar algunas regiones que admiten el recurso.In addition, there may be limitations on your subscription that prevent you from using some regions that support the resource.

Para obtener las ubicaciones compatibles con un tipo de recurso, use:To get the supported locations for a resource type, use.

az provider show --namespace Microsoft.Batch --query "resourceTypes[?resourceType=='batchAccounts'].locations | [0]" --out table

Que devuelve:Which returns:

Result
---------------
West Europe
East US
East US 2
West US
...

Pasos siguientesNext steps