ResourceProviders Microsoft.CustomProviders

Articolo
07/20/2023

Definizione di risorsa Bicep

Il tipo di risorsa resourceProviders può essere distribuito in:

Gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.CustomProviders/resourceProviders, aggiungere il modello Bicep seguente.

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'
      }
    ]
  }
}

Valori delle proprietà

resourceProviders

Nome	Descrizione	valore
name	Nome della risorsa	stringa (obbligatoria) Limite di caratteri: 3-64 Caratteri validi: Non è possibile usare: `%&\\?/` o caratteri di controllo Non può terminare con un punto o uno spazio.
posizione	Posizione risorsa	stringa (obbligatoria)
tags	Tag delle risorse	Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
properties	Manifesto per il provider di risorse personalizzato	CustomRPManifestProperties

CustomRPManifestProperties

Nome	Descrizione	valore
Azioni	Elenco di azioni implementate dal provider di risorse personalizzato.	CustomRPActionRouteDefinition[]
resourceTypes	Elenco di tipi di risorse implementati dal provider di risorse personalizzato.	CustomRPResourceTypeRouteDefinition[]
Convalide	Elenco delle convalida da eseguire nelle richieste del provider di risorse personalizzato.	CustomRPValidations[]

CustomRPActionRouteDefinition

Nome	Descrizione	valore
endpoint	URI dell'endpoint di definizione della route a cui il provider di risorse personalizzato richiederà il proxy. Questo può essere sotto forma di un URI flat (ad esempio '') o può specificare di instradare tramite un percorso (ad esempio 'https://testendpoint/https://testendpoint/{requestPath}')	stringa (obbligatoria)
name	Nome della definizione della route. Questo diventa il nome dell'estensione ARM, ad esempio '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}')	stringa (obbligatoria)
routingType	Tipi di routing supportati per le richieste di azione.	'Proxy'

CustomRPResourceTypeRouteDefinition

Nome	Descrizione	valore
endpoint	URI dell'endpoint di definizione della route a cui il provider di risorse personalizzato richiederà il proxy. Questo può essere sotto forma di un URI flat (ad esempio '') o può specificare di instradare tramite un percorso (ad esempio 'https://testendpoint/https://testendpoint/{requestPath}')	stringa (obbligatoria)
name	Nome della definizione della route. Questo diventa il nome dell'estensione ARM, ad esempio '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}')	stringa (obbligatoria)
routingType	Tipi di routing supportati per le richieste di risorse.	'Proxy' 'Proxy,Cache'

CustomRPValidations

Nome	Descrizione	valore
specifica	Collegamento alla specifica di convalida. La specifica deve essere ospitata in raw.githubusercontent.com.	stringa (obbligatoria)
Validationtype	Tipo di convalida da eseguire su una richiesta corrispondente.	'Swagger'

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello	Descrizione
Estendere le risorse di Azure esistenti con provider personalizzati	Questo esempio descrive in dettaglio come estendere le risorse di Azure esistenti e i modelli di Resource Manager per aggiungere carichi di lavoro personalizzati.
Creare un'app per le funzioni e chiamarla usando una risorsa personalizzata	Questo modello crea un'app per le funzioni usata come carico di lavoro per un provider di risorse personalizzato in una distribuzione di modelli.
Creare una risorsa personalizzata per i modelli con provider personalizzati	Questo esempio illustra come aggiungere risorse personalizzate ai modelli di Resource Manager usando provider personalizzati e app per la logica.

Definizione della risorsa modello di Resource Manager

Il tipo di risorsa resourceProviders può essere distribuito in:

Gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.CustomProviders/resourceProviders, aggiungere il codice JSON seguente al modello.

{
  "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"
      }
    ]
  }
}

Valori delle proprietà

resourceProviders

Nome	Descrizione	valore
tipo	Tipo di risorsa	'Microsoft.CustomProviders/resourceProviders'
apiVersion	Versione dell'API risorsa	'2018-09-01-preview'
name	Nome della risorsa	stringa (obbligatoria) Limite di caratteri: 3-64 Caratteri validi: Non è possibile usare: `%&\\?/` o caratteri di controllo Non può terminare con un punto o uno spazio.
posizione	Posizione risorsa	stringa (obbligatoria)
tags	Tag delle risorse	Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
properties	Manifesto per il provider di risorse personalizzato	CustomRPManifestProperties

CustomRPManifestProperties

Nome	Descrizione	valore
Azioni	Elenco di azioni implementate dal provider di risorse personalizzato.	CustomRPActionRouteDefinition[]
resourceTypes	Elenco di tipi di risorse implementati dal provider di risorse personalizzato.	CustomRPResourceTypeRouteDefinition[]
Convalide	Elenco delle convalida da eseguire nelle richieste del provider di risorse personalizzato.	CustomRPValidations[]

CustomRPActionRouteDefinition

Nome	Descrizione	valore
endpoint	URI dell'endpoint di definizione della route a cui il provider di risorse personalizzato richiederà il proxy. Questo può essere sotto forma di un URI flat (ad esempio '') o può specificare di instradare tramite un percorso (ad esempio 'https://testendpoint/https://testendpoint/{requestPath}')	stringa (obbligatoria)
name	Nome della definizione della route. Questo diventa il nome dell'estensione ARM, ad esempio '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}')	stringa (obbligatoria)
routingType	Tipi di routing supportati per le richieste di azione.	'Proxy'

CustomRPResourceTypeRouteDefinition

Nome	Descrizione	valore
endpoint	URI dell'endpoint di definizione della route a cui il provider di risorse personalizzato richiederà il proxy. Questo può essere sotto forma di un URI flat (ad esempio '') o può specificare di instradare tramite un percorso (ad esempio 'https://testendpoint/https://testendpoint/{requestPath}')	stringa (obbligatoria)
name	Nome della definizione della route. Questo diventa il nome dell'estensione ARM, ad esempio '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}')	stringa (obbligatoria)
routingType	Tipi di routing supportati per le richieste di risorse.	'Proxy' 'Proxy,Cache'

CustomRPValidations

Nome	Descrizione	valore
specifica	Collegamento alla specifica di convalida. La specifica deve essere ospitata in raw.githubusercontent.com.	stringa (obbligatoria)
Validationtype	Tipo di convalida da eseguire su una richiesta corrispondente.	'Swagger'

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello	Descrizione
Estendere le risorse di Azure esistenti con provider personalizzati	Questo esempio descrive in dettaglio come estendere le risorse di Azure esistenti e i modelli di Resource Manager per aggiungere carichi di lavoro personalizzati.
Creare un'app per le funzioni e chiamarla usando una risorsa personalizzata	Questo modello crea un'app per le funzioni usata come carico di lavoro per un provider di risorse personalizzato in una distribuzione di modelli.
Creare una risorsa personalizzata per i modelli con provider personalizzati	Questo esempio illustra come aggiungere risorse personalizzate ai modelli di Resource Manager usando provider personalizzati e app per la logica.

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa resourceProviders può essere distribuito in:

Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.CustomProviders/resourceProviders, aggiungere il codice Terraform seguente al modello.

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"
        }
      ]
    }
  })
}

Valori delle proprietà

resourceProviders

Nome	Descrizione	valore
tipo	Tipo di risorsa	"Microsoft.CustomProviders/resourceProviders@2018-09-01-preview"
name	Nome della risorsa	stringa (obbligatorio) Limite di caratteri: 3-64 Caratteri validi: Non è possibile usare: `%&\\?/` o caratteri di controllo Non può terminare con un punto o uno spazio.
posizione	Posizione risorsa	stringa (obbligatorio)
parent_id	Per eseguire la distribuzione in un gruppo di risorse, usare l'ID del gruppo di risorse.	stringa (obbligatorio)
tags	Tag delle risorse	Dizionario di nomi e valori di tag.
properties	Manifesto per il provider di risorse personalizzato	CustomRPManifestProperties

CustomRPManifestProperties

Nome	Descrizione	valore
Azioni	Elenco di azioni implementate dal provider di risorse personalizzato.	CustomRPActionRouteDefinition[]
resourceTypes	Elenco di tipi di risorse implementati dal provider di risorse personalizzato.	CustomRPResourceTypeRouteDefinition[]
Convalide	Elenco di convalide da eseguire nelle richieste del provider di risorse personalizzato.	CustomRPValidations[]

CustomRPActionRouteDefinition

Nome	Descrizione	valore
endpoint	URI dell'endpoint di definizione della route a cui il provider di risorse personalizzato eseguirà il proxy delle richieste. Può trattarsi di un URI semplice(ad esempio 'https://testendpoint/') o può specificare di instradarsi tramite un percorso (ad esempio 'https://testendpoint/{requestPath}')	stringa (obbligatorio)
name	Nome della definizione della route. Questo diventa il nome dell'estensione ARM, ad esempio '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}')	stringa (obbligatorio)
routingType	Tipi di routing supportati per le richieste di azione.	"Proxy"

CustomRPResourceTypeRouteDefinition

Nome	Descrizione	valore
endpoint	URI dell'endpoint di definizione della route a cui il provider di risorse personalizzato eseguirà il proxy delle richieste. Può trattarsi di un URI semplice(ad esempio 'https://testendpoint/') o può specificare di instradarsi tramite un percorso (ad esempio 'https://testendpoint/{requestPath}')	stringa (obbligatorio)
name	Nome della definizione della route. Questo diventa il nome dell'estensione ARM, ad esempio '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/{name}')	stringa (obbligatorio)
routingType	Tipi di routing supportati per le richieste di risorse.	"Proxy" "Proxy, Cache"

CustomRPValidations

Nome	Descrizione	valore
specifica	Collegamento alla specifica di convalida. La specifica deve essere ospitata in raw.githubusercontent.com.	stringa (obbligatorio)
Validationtype	Tipo di convalida da eseguire su una richiesta corrispondente.	"Swagger"

Condividi tramite

ResourceProviders Microsoft.CustomProviders

Definizione di risorsa Bicep

Formato di risorsa

Valori delle proprietà

resourceProviders

CustomRPManifestProperties

CustomRPActionRouteDefinition

CustomRPResourceTypeRouteDefinition

CustomRPValidations

Modelli di avvio rapido

Definizione della risorsa modello di Resource Manager

Formato di risorsa

Valori delle proprietà

resourceProviders

CustomRPManifestProperties

CustomRPActionRouteDefinition

CustomRPResourceTypeRouteDefinition

CustomRPValidations

Modelli di avvio rapido

Definizione della risorsa Terraform (provider AzAPI)

Formato di risorsa

Valori delle proprietà

resourceProviders

CustomRPManifestProperties

CustomRPActionRouteDefinition

CustomRPResourceTypeRouteDefinition

CustomRPValidations

Commenti e suggerimenti

Risorse aggiuntive