ResourceProviders de Microsoft.CustomProviders

Artículo
07/20/2023

Definición de recursos de Bicep

El tipo de recurso resourceProviders se puede implementar en:

Grupos de recursos: consulte los comandos de implementación del grupo de recursos.

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.CustomProviders/resourceProviders, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.CustomProviders/resourceProviders@2018-09-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    actions: [
      {
        endpoint: 'string'
        name: 'string'
        routingType: 'Proxy'
      }
    ]
    resourceTypes: [
      {
        endpoint: 'string'
        name: 'string'
        routingType: 'string'
      }
    ]
    validations: [
      {
        specification: 'string'
        validationType: 'Swagger'
      }
    ]
  }
}

Valores de propiedades

resourceProviders

Nombre	Descripción	Value
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 3-64 Caracteres válidos: No puede usar: `%&\\?/` ni caracteres de control No puede terminar con un punto ni un espacio.
ubicación	Ubicación de los recursos	string (obligatorio)
etiquetas	Etiquetas del recurso	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties	Manifiesto del proveedor de recursos personalizado	CustomRPManifestProperties

CustomRPManifestProperties

Nombre	Descripción	Valor
actions	Lista de acciones que implementa el proveedor de recursos personalizados.	CustomRPActionRouteDefinition[]
resourceTypes	Lista de tipos de recursos que implementa el proveedor de recursos personalizado.	CustomRPResourceTypeRouteDefinition[]
validations	Lista de validaciones que se van a ejecutar en las solicitudes del proveedor de recursos personalizados.	CustomRPValidations[]

CustomRPActionRouteDefinition

Nombre	Descripción	Valor
endpoint	El URI del punto de conexión de definición de ruta al que el proveedor de recursos personalizado va a realizar solicitudes de proxy. Esto puede estar en forma de URI plano (por ejemplo, "https://testendpoint/") o puede especificar la ruta a través de una ruta de acceso (por ejemplo, "https://testendpoint/{requestPath}")	string (obligatorio)
name	Nombre de la definición de ruta. Esto se convierte en el nombre de la extensión de ARM (por ejemplo, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}').	string (obligatorio)
routingType	Los tipos de enrutamiento que se admiten para las solicitudes de acción.	'Proxy'

CustomRPResourceTypeRouteDefinition

Nombre	Descripción	Valor
endpoint	El URI del punto de conexión de definición de ruta al que el proveedor de recursos personalizado va a realizar solicitudes de proxy. Esto puede estar en forma de URI plano (por ejemplo, "https://testendpoint/") o puede especificar la ruta a través de una ruta de acceso (por ejemplo, "https://testendpoint/{requestPath}")	string (obligatorio)
name	Nombre de la definición de ruta. Esto se convierte en el nombre de la extensión de ARM (por ejemplo, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}').	string (obligatorio)
routingType	Los tipos de enrutamiento que se admiten para las solicitudes de recursos.	'Proxy' 'Proxy,Cache'

CustomRPValidations

Nombre	Descripción	Valor
specification	Vínculo a la especificación de validación. La especificación debe hospedarse en raw.githubusercontent.com.	string (obligatorio)
validationType	Tipo de validación que se va a ejecutar en una solicitud coincidente.	"Swagger"

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla	Descripción
Ampliación de recursos de Azure existentes con proveedores personalizados	En este ejemplo se detallará cómo ampliar los recursos de Azure existentes y Resource Manager plantillas para agregar cargas de trabajo personalizadas.
Creación de una aplicación de función y llamada a ella mediante un recurso personalizado	Esta plantilla crea una aplicación de función que se usa como carga de trabajo para un proveedor de recursos personalizado en una implementación de plantilla.
Creación de un recurso personalizado para plantillas con proveedores personalizados	En este ejemplo se muestra cómo agregar recursos personalizados a Resource Manager Plantillas mediante proveedores personalizados y aplicaciones lógicas.

Definición de recursos de plantilla de ARM

El tipo de recurso resourceProviders se puede implementar en:

Grupos de recursos: consulte los comandos de implementación del grupo de recursos.

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.CustomProviders/resourceProviders, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.CustomProviders/resourceProviders",
  "apiVersion": "2018-09-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "actions": [
      {
        "endpoint": "string",
        "name": "string",
        "routingType": "Proxy"
      }
    ],
    "resourceTypes": [
      {
        "endpoint": "string",
        "name": "string",
        "routingType": "string"
      }
    ],
    "validations": [
      {
        "specification": "string",
        "validationType": "Swagger"
      }
    ]
  }
}

Valores de propiedades

resourceProviders

Nombre	Descripción	Value
type	Tipo de recurso	"Microsoft.CustomProviders/resourceProviders"
apiVersion	La versión de la API de recursos	"2018-09-01-preview"
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 3-64 Caracteres válidos: No puede usar: `%&\\?/` ni caracteres de control No puede terminar con un punto ni un espacio.
ubicación	Ubicación de los recursos	string (obligatorio)
etiquetas	Etiquetas del recurso	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties	Manifiesto del proveedor de recursos personalizado	CustomRPManifestProperties

CustomRPManifestProperties

Nombre	Descripción	Valor
actions	Lista de acciones que implementa el proveedor de recursos personalizados.	CustomRPActionRouteDefinition[]
resourceTypes	Lista de tipos de recursos que implementa el proveedor de recursos personalizado.	CustomRPResourceTypeRouteDefinition[]
validations	Lista de validaciones que se van a ejecutar en las solicitudes del proveedor de recursos personalizados.	CustomRPValidations[]

CustomRPActionRouteDefinition

Nombre	Descripción	Valor
endpoint	El URI del punto de conexión de definición de ruta al que el proveedor de recursos personalizado enviará solicitudes de proxy. Esto puede estar en forma de URI plano (por ejemplo, "https://testendpoint/") o puede especificar que se enrute a través de una ruta de acceso (por ejemplo, "https://testendpoint/{requestPath}")	string (obligatorio)
name	Nombre de la definición de ruta. Esto se convierte en el nombre de la extensión de ARM (por ejemplo, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}').	string (obligatorio)
routingType	Los tipos de enrutamiento que se admiten para las solicitudes de acción.	'Proxy'

CustomRPResourceTypeRouteDefinition

Nombre	Descripción	Valor
endpoint	El URI del punto de conexión de definición de ruta al que el proveedor de recursos personalizado enviará solicitudes de proxy. Esto puede estar en forma de URI plano (por ejemplo, "https://testendpoint/") o puede especificar que se enrute a través de una ruta de acceso (por ejemplo, "https://testendpoint/{requestPath}")	string (obligatorio)
name	Nombre de la definición de ruta. Esto se convierte en el nombre de la extensión de ARM (por ejemplo, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}').	string (obligatorio)
routingType	Los tipos de enrutamiento que se admiten para las solicitudes de recursos.	'Proxy' 'Proxy,Cache'

CustomRPValidations

Nombre	Descripción	Valor
specification	Vínculo a la especificación de validación. La especificación debe hospedarse en raw.githubusercontent.com.	string (obligatorio)
validationType	Tipo de validación que se va a ejecutar en una solicitud coincidente.	"Swagger"

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla	Descripción
Extensión de los recursos de Azure existentes con proveedores personalizados	En este ejemplo se detallará cómo ampliar los recursos de Azure existentes y Resource Manager plantillas para agregar cargas de trabajo personalizadas.
Creación de una aplicación de función y llamada mediante un recurso personalizado	Esta plantilla crea una aplicación de función que se usa como carga de trabajo para un proveedor de recursos personalizado en una implementación de plantilla.
Creación de un recurso personalizado para plantillas con proveedores personalizados	En este ejemplo se muestra cómo agregar recursos personalizados a Resource Manager Plantillas mediante proveedores personalizados y aplicaciones lógicas.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso resourceProviders se puede implementar en:

Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.CustomProviders/resourceProviders, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CustomProviders/resourceProviders@2018-09-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      actions = [
        {
          endpoint = "string"
          name = "string"
          routingType = "Proxy"
        }
      ]
      resourceTypes = [
        {
          endpoint = "string"
          name = "string"
          routingType = "string"
        }
      ]
      validations = [
        {
          specification = "string"
          validationType = "Swagger"
        }
      ]
    }
  })
}

Valores de propiedades

resourceProviders

Nombre	Descripción	Value
type	Tipo de recurso	"Microsoft.CustomProviders/resourceProviders@2018-09-01-preview"
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 3-64 Caracteres válidos: No puede usar: `%&\\?/` ni caracteres de control No puede terminar con un punto ni un espacio.
ubicación	Ubicación de los recursos	string (obligatorio)
parent_id	Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos.	string (obligatorio)
etiquetas	Etiquetas del recurso	Diccionario de nombres y valores de etiqueta.
properties	Manifiesto del proveedor de recursos personalizado	CustomRPManifestProperties

CustomRPManifestProperties

Nombre	Descripción	Valor
actions	Lista de acciones que implementa el proveedor de recursos personalizados.	CustomRPActionRouteDefinition[]
resourceTypes	Lista de tipos de recursos que implementa el proveedor de recursos personalizado.	CustomRPResourceTypeRouteDefinition[]
validations	Lista de validaciones que se van a ejecutar en las solicitudes del proveedor de recursos personalizados.	CustomRPValidations[]

CustomRPActionRouteDefinition

Nombre	Descripción	Valor
endpoint	El URI del punto de conexión de definición de ruta al que el proveedor de recursos personalizado enviará solicitudes de proxy. Esto puede estar en forma de URI plano (por ejemplo, "https://testendpoint/") o puede especificar que se enrute a través de una ruta de acceso (por ejemplo, "https://testendpoint/{requestPath}")	string (obligatorio)
name	Nombre de la definición de ruta. Esto se convierte en el nombre de la extensión de ARM (por ejemplo, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}').	string (obligatorio)
routingType	Los tipos de enrutamiento que se admiten para las solicitudes de acción.	"Proxy"

CustomRPResourceTypeRouteDefinition

Nombre	Descripción	Valor
endpoint	El URI del punto de conexión de definición de ruta al que el proveedor de recursos personalizado enviará solicitudes de proxy. Esto puede estar en forma de URI plano (por ejemplo, "https://testendpoint/") o puede especificar que se enrute a través de una ruta de acceso (por ejemplo, "https://testendpoint/{requestPath}")	string (obligatorio)
name	Nombre de la definición de ruta. Esto se convierte en el nombre de la extensión de ARM (por ejemplo, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}').	string (obligatorio)
routingType	Los tipos de enrutamiento que se admiten para las solicitudes de recursos.	"Proxy" "Proxy, caché"

CustomRPValidations

Nombre	Descripción	Valor
specification	Vínculo a la especificación de validación. La especificación debe hospedarse en raw.githubusercontent.com.	string (obligatorio)
validationType	Tipo de validación que se va a ejecutar en una solicitud coincidente.	"Swagger"

Compartir a través de

ResourceProviders de Microsoft.CustomProviders

Definición de recursos de Bicep

Formato de los recursos

Valores de propiedades

resourceProviders

CustomRPManifestProperties

CustomRPActionRouteDefinition

CustomRPResourceTypeRouteDefinition

CustomRPValidations

Plantillas de inicio rápido

Definición de recursos de plantilla de ARM

Formato de los recursos

Valores de propiedades

resourceProviders

CustomRPManifestProperties

CustomRPActionRouteDefinition

CustomRPResourceTypeRouteDefinition

CustomRPValidations

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de los recursos

Valores de propiedades

resourceProviders

CustomRPManifestProperties

CustomRPActionRouteDefinition

CustomRPResourceTypeRouteDefinition

CustomRPValidations

Comentarios

Recursos adicionales