Compartir a través de

Introducción a los proveedores de recursos personalizados de Azure

Importante

Los proveedores de recursos personalizados se encuentran actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin Acuerdo de Nivel de Servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure.

En 2026, Azure Resource Manager dejará de usar el servicio Proveedor de recursos personalizados (CuRP).

Retiraremos la característica el 31 de octubre de 2026. El 24 de febrero de 2026 realizaremos una prueba de desuso como parte de este desuso. El 31 de julio de 2026, se bloquearán la creación, actualización, revisión y acciones sobre los recursos personalizados y los proveedores de recursos. Solo podrá leer y eliminar los recursos y proveedores de recursos personalizados.

Entendemos que este desuso puede ser un inconveniente para usted y su equipo. Estas son algunas alternativas potenciales de CuRP que puede usar para apoyar los flujos de trabajo existentes.

Si su escenario de CuRP:

  • Solo implica desencadenar un punto de conexión sin necesidad de administración de recursos persistente, considere la posibilidad de usar scripts de implementación.
  • Solo implica desencadenar un punto de conexión sin necesidad de la administración de recursos persistente y usar Bicep, considere la posibilidad de usar extensiones de Bicep.
  • Implica desencadenar varios puntos de conexión o servicios diferentes para la solución, considere la posibilidad de usar Azure Functions.

Si tiene alguna pregunta, pida al administrador de cuentas de Microsoft que envíe un correo electrónico curpdeprecation@microsoft.com con su nombre, nombre de la empresa, contacto de correo electrónico e identificador de suscripción.

Los proveedores de recursos personalizados de Azure son una plataforma de extensibilidad para Azure. Permite definir API personalizadas que se pueden usar para enriquecer la experiencia predeterminada de Azure. En esta documentación se describe lo siguiente:

  • Creación e implementación de un proveedor de recursos personalizado de Azure.
  • Uso de proveedores de recursos personalizados de Azure para ampliar los flujos de trabajo existentes.
  • Dónde encontrar guías y ejemplos de código para empezar.

Diagrama de proveedores de recursos personalizados de Azure, que muestran la relación entre Azure Resource Manager, proveedores de recursos personalizados y recursos.

¿Qué pueden hacer los proveedores de recursos personalizados?

Estos son algunos ejemplos de lo que puede lograr con los proveedores de recursos personalizados de Azure:

  • Amplíe la API REST de Azure Resource Manager para incluir servicios internos y externos.
  • Habilite escenarios personalizados sobre los flujos de trabajo de Azure existentes.
  • Personalice el control y el efecto de las plantillas de Azure Resource Manager.

¿Qué es un proveedor de recursos personalizado?

Los proveedores de recursos personalizados de Azure se realizan mediante la creación de un contrato entre Azure y un punto de conexión. Este contrato define una lista de nuevos recursos y acciones a través de un nuevo recurso, Microsoft.CustomProviders/resourceProviders. A continuación, el proveedor de recursos personalizado expondrá estas nuevas API en Azure. Los proveedores de recursos personalizados de Azure se componen de tres partes: proveedor de recursos personalizado, puntos de conexión y recursos personalizados.

Creación de proveedores de recursos personalizados

Los proveedores de recursos personalizados son una lista de contratos entre Azure y los puntos de conexión. Estos contratos describen cómo Azure debe interactuar con sus puntos de conexión. Los proveedores de recursos actúan como un proxy y reenván las solicitudes y respuestas a y desde su punto de conexión especificado. Un proveedor de recursos puede especificar dos tipos de contratos: resourceTypes y acciones. Se habilitan a través de definiciones de punto de conexión. Una definición de punto de conexión consta de tres campos: name, routingType y endpoint.

Punto de conexión de ejemplo:

{
  "name": "{endpointDefinitionName}",
  "routingType": "Proxy",
  "endpoint": "https://{endpointURL}/"
}
Propiedad Obligatorio Description
nombre Sí Nombre de la definición del punto de conexión. Azure expondrá este nombre a través de su API en "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/
resourceProviders/{resourceProviderName}/{endpointDefinitionName}'
routingType no Determina el tipo de contrato con el punto de conexión. Si no se especifica, el valor predeterminado es "Proxy".
endpoint Sí El extremo al que se dirigen las solicitudes. Esto gestionará la respuesta, así como los efectos colaterales de la solicitud.

Creación de recursos personalizados

ResourceTypes describe los nuevos recursos personalizados que se agregan a Azure. Estos exponen métodos CRUD de RESTful básicos. Más información sobre la creación de recursos personalizados

Proveedor de recursos personalizado de ejemplo con resourceTypes:

{
  "properties": {
    "resourceTypes": [
      {
        "name": "myCustomResources",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

API agregadas a Azure para el ejemplo anterior:

Método HTTP URI de ejemplo Description
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 Llamada a la API REST de Azure para crear un nuevo recurso.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 Llamada a la API REST de Azure para eliminar un recurso existente.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 Llamada a la API REST de Azure para recuperar un recurso existente.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources?api-version=2018-09-01-preview		 La llamada a la API REST de Azure para recuperar la lista de recursos existentes.

Creación de acciones personalizadas

Las acciones describen las nuevas acciones que se agregan a Azure. Estos pueden exponerse en la parte superior del proveedor de recursos o anidados dentro de un resourceType. Más información sobre la creación de acciones personalizadas

Proveedor de recursos personalizado con acciones de ejemplo:

{
  "properties": {
    "actions": [
      {
        "name": "myCustomAction",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

API agregadas a Azure para el ejemplo anterior:

Método HTTP URI de ejemplo Description
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomAction?api-version=2018-09-01-preview		 Llamada a la API REST de Azure para activar la acción.

Buscar ayuda

Si tiene preguntas para el desarrollo del proveedor de recursos personalizados de Azure, pruebe a preguntar en Stack Overflow. Es posible que ya se haya preguntado y respondido una pregunta similar, así que compruebe primero antes de publicarla. Agregue la etiqueta azure-custom-providers para obtener una respuesta rápida.

Pasos siguientes

En este artículo, ha obtenido información sobre los proveedores de recursos personalizados. Vaya al siguiente artículo para crear un proveedor de recursos personalizado.

  • Last updated on