Descripción de los recursos de Azure

  • 3 minutos

Todos los recursos de Azure se implementan con un tipo específico. El tipo identifica el tipo de recurso que es. Un identificador de recurso es la manera en que Azure identifica una instancia específica de un recurso. Es importante comprender cómo se estructuran los tipos de recursos y los identificadores de recursos, ya que proporcionan información importante al escribir plantillas de Bicep.

Proveedores de recursos

Azure Resource Manager está diseñado para que se puedan administrar muchos proveedores de recursos diferentes a través de las API de Resource Manager y plantillas de ARM. Un proveedor de recursos es una agrupación lógica de tipos de recursos, que normalmente se relaciona con uno o algunos servicios de Azure. Entre los ejemplos de proveedores de recursos figuran:

  • Microsoft.Compute, que se usa para las máquinas virtuales.
  • Microsoft.Network, que se usa para recursos de red como redes virtuales, grupos de seguridad de red y tablas de rutas.
  • Microsoft.Cache, que se usa para Azure Cache for Redis.
  • Microsoft.Sql, que se usa para Azure SQL.
  • Microsoft.Web, que se usa para Azure App Service y Azure Functions.
  • Microsoft.DocumentDB, que se usa para Azure Cosmos DB.

Nota:

En ocasiones, los nombres del proveedor de recursos y los nombres de tipo de recurso no coinciden con los de los servicios de Azure para los que son, o bien pueden ser, nombres de producto o recursos antiguos. Por ejemplo, el proveedor de recursos para las áreas de trabajo de Log Analytics es Microsoft.OperationalInsights.

La documentación de la sintaxis de la plantilla de ARM de cada tipo de recurso se organiza según el proveedor de recursos.

Los proveedores de recursos deben estar registrados para la suscripción antes de poder usar los tipos de recursos que exponen. El registro suele ser un proceso único. Al enviar una implementación de Bicep, Resource Manager registra automáticamente los proveedores de recursos que se usan en el archivo. También puede registrar un proveedor de recursos mediante Azure Portal, la CLI de Azure o Azure PowerShell.

Tipos de recursos

Un proveedor de recursos expone varios tipos diferentes. Cada tipo de recurso tiene su propio conjunto de propiedades y comportamientos que definen el recurso y lo que puede hacer. Por ejemplo, dentro del proveedor de recursos Microsoft.Web, hay varios tipos de recursos, entre los que se incluyen:

  • sites: define una aplicación App Service o Azure Functions. Las propiedades incluyen las variables de entorno que usa la aplicación y los protocolos admitidos (HTTP y HTTPS) para acceder a la aplicación.
  • serverFarms: define un plan App Service, la infraestructura que ejecuta las aplicaciones. Las propiedades incluyen el tamaño y la SKU de los servidores y el número de instancias del plan que desea implementar.

Al definir recursos en Bicep, debe especificar su tipo de recurso y la versión de la API del proveedor de recursos que quiere que Bicep use para el recurso. Esta información ayuda a las herramientas de Bicep y a Resource Manager a comprender qué propiedades se deben proporcionar con la definición de recursos.

Sugerencia

Es recomendable usar una versión de API reciente para cada recurso. Las nuevas características de los servicios de Azure a veces solo están disponibles en las versiones de API más recientes.

Combine el proveedor de recursos y el nombre de tipo para crear un nombre de tipo de recurso completo. El nombre de tipo completo consta del nombre del proveedor de recursos, una barra diagonal (/) y el tipo de recurso. Por ejemplo, el nombre de tipo completo de una cuenta de almacenamiento es Microsoft.Storage/storageAccounts. En esta instancia, su nombre de proveedor de recursos es Microsoft.Storage y el tipo de recurso es storageAccounts.

Los identificadores de recursos

Cada recurso de Azure tiene un identificador de recurso único. Este identificador incluye información que ayuda a eliminar la ambigüedad del recurso respecto a cualquier otro recurso del mismo tipo, o incluso de recursos diferentes que podrían compartir el mismo nombre. Un identificador de recurso para una cuenta de almacenamiento tiene el siguiente aspecto:

/subscriptions/A123b4567c-1234-1a2b-2b1a-1234abc12345/resourceGroups/ToyDevelopment/providers/Microsoft.Storage/storageAccounts/secrettoys

Echemos un vistazo a una representación visual de la misma información:

Identificador de recurso de una cuenta de almacenamiento, dividido con par clave-valor en una línea independiente.

Puede ver que un identificador de recurso intercala información sobre el tipo de recurso y el recurso específico que ha implementado. Vamos a dividir este identificador de recurso de ejemplo en sus componentes:

  • subscriptions/A123b4567c-1234-1a2b-2b1a-1234abc12345 indica que este recurso está dentro de la suscripción de Azure con identificador. A123b4567c-1234-1a2b-2b1a-1234abc12345.
  • resourceGroups/ToyDevelopment indica que el recurso está dentro del grupo de recursos denominado ToyDevelopment.
  • providers/Microsoft.Storage indica que el recurso usa un tipo del proveedor de recursos Microsoft.Storage.
  • storageAccounts es el tipo de recurso.
  • secrettoys es el nombre de la cuenta de almacenamiento.

Sugerencia

Puede acceder al identificador de cualquier recurso de Bicep mediante el nombre simbólico y la propiedad id. Por ejemplo, si define una cuenta de almacenamiento con el nombre simbólico toyDesignDocumentsStorageAccount, puede acceder a su identificador de recurso mediante la expresión toyDesignDocumentsStorageAccount.id.

Ahora que comprende los conceptos básicos de los tipos de recursos y los identificadores de recursos, echemos un vistazo a los recursos secundarios.