Tipos y proveedores de recursos de Azure
Al implementar los recursos, con frecuencia necesitará recuperar información sobre los tipos y proveedores de recursos. Por ejemplo, si quiere almacenar claves y secretos, trabajará con el proveedor de recursos Microsoft.KeyVault. Este proveedor de recursos ofrece un tipo de recurso denominado almacenes para crear el almacén de claves.
El nombre de un tipo de recurso tiene el formato: {proveedor de recursos}/{tipo de recurso} . El tipo de recurso para un almacén de claves es Microsoft.KeyVault/vaults.
En este artículo aprenderá a:
- Ver todos los proveedores de recursos de Azure
- Comprobar el estado de registro de un proveedor de recursos
- Registrar un proveedor de recursos
- Ver los tipos de recursos de un proveedor
- Ver las ubicaciones válidas de un tipo de recurso
- Ver las versiones de API válidas de un tipo de recurso
Puede llevar a cabo estos pasos en Azure Portal, Azure PowerShell o la CLI de Azure.
Para obtener una lista que asigna proveedores de recursos con servicios de Azure, consulte Proveedores de recursos para servicios de Azure.
Registro del proveedor de recursos
Antes de usar un proveedor de recursos, la suscripción de Azure debe registrarse para el proveedor de recursos. El registro configura su suscripción para así poder trabajar con el proveedor de recursos.
Importante
Solo debe registrar un proveedor de recursos cuando esté listo para usarlo. El paso de registro permite mantener los privilegios mínimos dentro de la suscripción. Un usuario malintencionado no puede usar proveedores de recursos que no están registrados.
Algunos proveedores de recursos están registrados de forma predeterminada. Para obtener una lista de los proveedores de recursos registrados de forma predeterminada, consulte Proveedores de recursos para servicios de Azure.
Otros proveedores de recursos están registrados automáticamente cuando toma determinadas medidas. Cuando crea un recurso a través del portal, el proveedor de recursos normalmente se registra de manera automática. Al implementar una plantilla de Azure Resource Manager o un archivo Bicep, los proveedores de recursos definidos en la plantilla se registran automáticamente. Sin embargo, si un recurso de la plantilla crea recursos compatibles que no están en la plantilla, como los recursos de supervisión o seguridad, debe registrar manualmente esos proveedores de recursos.
En otros escenarios, es posible que tenga que registrar manualmente un proveedor de recursos.
Importante
El código de aplicación no debe bloquear la creación de recursos para un proveedor de recursos con el estado de registro. Al registrar el proveedor de recursos, la operación se realiza de forma individual para cada región admitida. Para crear recursos en una región, el registro solo debe completarse en dicha región. Si no se bloquea un proveedor de recursos con el estado de registro, la aplicación puede continuar mucho antes que si se espera a que se completen todas las regiones.
Debe tener permiso para realizar la operación /register/action para el proveedor de recursos. El permiso se incluye en los roles Colaborador y Propietario.
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.
Portal de Azure
Registro del proveedor de recursos
Para ver todos los proveedores de recursos y el estado de registro de su suscripción:
Inicie sesión en Azure Portal.
En el menú de Azure Portal, busque Suscripciones. Seleccione el servicio entre las opciones disponibles.
Seleccione la suscripción que quiere ver.
En el menú de la izquierda, en Configuración, seleccione Proveedores de recursos.
Busque el proveedor de recursos que desea registrar y seleccione Registrar. Para mantener los privilegios mínimos en su suscripción, registre solo los proveedores de recursos que esté listo para usar.
Importante
Como ya se ha señalado, no bloquee la creación de recursos para un proveedor de recursos con el estado de registro. Si no se bloquea un proveedor de recursos con el estado de registro, la aplicación puede continuar mucho antes que si se espera a que se completen todas las regiones.
Visualización del proveedor de recursos
Para ver información de un proveedor de recursos concreto:
Inicie sesión en Azure Portal.
En el menú de Azure Portal, seleccione Todos los servicios.
En el cuadro Todos los servicios, escriba Explorador de recursos y, a continuación, seleccione Explorador de recursos.
Expanda Proveedores; para ello, seleccione la flecha derecha.
Expanda un proveedor de recursos y el tipo de recurso que desea ver.
El Administrador de recursos se admite en todas las regiones, pero puede que los recursos que implementa no se admitan en todas las regiones. Además, puede haber limitaciones en su suscripción que le impidan utilizar algunas regiones que admiten el recurso. El explorador de recursos muestra las ubicaciones válidas para el tipo de recurso.
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. Conforme un proveedor de recursos habilite nuevas características, publicará una nueva versión de la API de REST. El explorador de recursos muestra las versiones de API válidas para el tipo de recurso.
Azure PowerShell
Para ver todos los proveedores de recursos de Azure y el estado de registro de su suscripción, use:
Get-AzResourceProvider -ListAvailable | Select-Object ProviderNamespace, RegistrationState
El comando devuelve:
ProviderNamespace RegistrationState
-------------------------------- ------------------
Microsoft.ClassicCompute Registered
Microsoft.ClassicNetwork Registered
Microsoft.ClassicStorage Registered
Microsoft.CognitiveServices Registered
...
Para ver todos los proveedores de recursos registrados para la suscripción, use:
Get-AzResourceProvider -ListAvailable | Where-Object RegistrationState -eq "Registered" | Select-Object ProviderNamespace, RegistrationState | Sort-Object ProviderNamespace
Para mantener los privilegios mínimos en su suscripción, registre solo los proveedores de recursos que esté listo para usar. Para registrar un proveedor de recursos, use:
Register-AzResourceProvider -ProviderNamespace Microsoft.Batch
El comando devuelve:
ProviderNamespace : Microsoft.Batch
RegistrationState : Registering
ResourceTypes : {batchAccounts, operations, locations, locations/quotas}
Locations : {West Europe, East US, East US 2, West US...}
Importante
Como ya se ha señalado, no bloquee la creación de recursos para un proveedor de recursos con el estado de registro. Si no se bloquea un proveedor de recursos con el estado de registro, la aplicación puede continuar mucho antes que si se espera a que se completen todas las regiones.
Para ver información de un proveedor de recursos concreto, use:
Get-AzResourceProvider -ProviderNamespace Microsoft.Batch
El comando devuelve:
{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:
(Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes.ResourceTypeName
El comando devuelve:
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. Conforme un proveedor de recursos habilite nuevas características, publicará una nueva versión de la API de REST.
Para obtener las versiones de API de un tipo de recurso, use:
((Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes | Where-Object ResourceTypeName -eq batchAccounts).ApiVersions
El comando devuelve:
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. Además, puede haber limitaciones en su suscripción que le impidan utilizar algunas regiones que admiten el recurso.
Para obtener las ubicaciones compatibles con un tipo de recurso, use:
((Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes | Where-Object ResourceTypeName -eq batchAccounts).Locations
El comando devuelve:
West Europe
East US
East US 2
West US
...
Azure CLI
Para ver todos los proveedores de recursos de Azure y el estado de registro de su suscripción, use:
az provider list --query "[].{Provider:namespace, Status:registrationState}" --out table
El comando devuelve:
Provider Status
-------------------------------- ----------------
Microsoft.ClassicCompute Registered
Microsoft.ClassicNetwork Registered
Microsoft.ClassicStorage Registered
Microsoft.CognitiveServices Registered
...
Para ver todos los proveedores de recursos registrados para la suscripción, use:
az provider list --query "sort_by([?registrationState=='Registered'].{Provider:namespace, Status:registrationState}, &Provider)" --out table
Para mantener los privilegios mínimos en su suscripción, registre solo los proveedores de recursos que esté listo para usar. Para registrar un proveedor de recursos, use:
az provider register --namespace Microsoft.Batch
El comando devuelve un mensaje que indica que el registro está en curso.
Para ver información de un proveedor de recursos concreto, use:
az provider show --namespace Microsoft.Batch
El comando devuelve:
{
"id": "/subscriptions/####-####/providers/Microsoft.Batch",
"namespace": "Microsoft.Batch",
"registrationsState": "Registering",
"resourceTypes:" [
...
]
}
Importante
Como ya se ha señalado, no bloquee la creación de recursos para un proveedor de recursos con el estado de registro. Si no se bloquea un proveedor de recursos con el estado de registro, la aplicación puede continuar mucho antes que si se espera a que se completen todas las regiones.
Para ver los tipos de recursos de un proveedor, use:
az provider show --namespace Microsoft.Batch --query "resourceTypes[*].resourceType" --out table
El comando devuelve:
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. Conforme un proveedor de recursos habilite nuevas características, publicará una nueva versión de la API de REST.
Para obtener las versiones de API de un tipo de recurso, use:
az provider show --namespace Microsoft.Batch --query "resourceTypes[?resourceType=='batchAccounts'].apiVersions | [0]" --out table
El comando devuelve:
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. Además, puede haber limitaciones en su suscripción que le impidan utilizar algunas regiones que admiten el recurso.
Para obtener las ubicaciones compatibles con un tipo de recurso, use:
az provider show --namespace Microsoft.Batch --query "resourceTypes[?resourceType=='batchAccounts'].locations | [0]" --out table
El comando devuelve:
Result
---------------
West Europe
East US
East US 2
West US
...
Pasos siguientes
- Para obtener más información sobre la creación de plantillas del Administrador de recursos, consulte Creación de plantillas del Administrador de recursos de Azure.
- Para ver los esquemas de plantilla de proveedor de recursos, consulte Referencia de plantilla.
- Para obtener una lista que asigna proveedores de recursos con servicios de Azure, consulte Proveedores de recursos para servicios de Azure.
- Para ver las operaciones de un proveedor de recursos, consulte API de REST de Azure.