Panoramica di provider di risorse personalizzate di Azure

Provider di risorse personalizzate di Azure è una piattaforma di estendibilità in Azure. Consente di definire API personalizzate che possono essere usate per arricchire l'esperienza predefinita di Azure. Questa documentazione descrive:

• Come compilare e distribuire un provider di risorse personalizzate di Azure.
• Come usare i provider di risorse personalizzate di Azure per estendere i flussi di lavoro esistenti.
• Dove trovare guide ed esempi di codice per iniziare.

Operazioni che possono essere eseguite dai provider di risorse personalizzate

Ecco alcuni esempi di ciò che è possibile ottenere con i provider di risorse personalizzate di Azure:

• Estendere l'API REST di Azure Resource Manager per includere servizi interni ed esterni.
• Abilitare scenari personalizzati oltre ai flussi di lavoro di Azure esistenti.
• Personalizzare il controllo e l'effetto dei modelli di Azure Resource Manager.

Cosa è un provider di risorse personalizzate

I provider di risorse personalizzate di Azure vengono creati creando un contratto tra Azure e un endpoint. Questo contratto definisce un elenco di nuove risorse e azioni tramite una nuova risorsa, Microsoft.CustomProviders/resourceProviders. Il provider di risorse personalizzate esporrà quindi queste nuove API in Azure. I provider di risorse personalizzate di Azure sono costituiti da tre parti: provider di risorse personalizzate, endpointe risorse personalizzate.

Come creare provider di risorse personalizzate

I provider di risorse personalizzate sono un elenco di contratti tra Azure ed endpoint. Questi contratti descrivono come Azure deve interagire con i propri endpoint. I provider di risorse agiscono come un proxy e inoltrano richieste e risposte all'endpoint specificato. Un provider di risorse può specificare due tipi di contratti: resourceTypes e azioni. Queste impostazioni vengono abilitate tramite le definizioni degli endpoint. Una definizione di endpoint è costituita da tre campi: nome, routingTypeed endpoint.

Endpoint di esempio:

{
  "name": "{endpointDefinitionName}",
  "routingType": "Proxy",
  "endpoint": "https://{endpointURL}/"
}

Creazione di risorse personalizzate

ResourceTypes descrive le nuove risorse personalizzate aggiunte ad Azure. Questi espongono metodi CRUD RESTful di base. Vedere Ulteriori informazioni sulla creazione di risorse personalizzate

Provider di risorse personalizzate di esempio con resourceTypes:

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

API aggiunte ad Azure per l'esempio precedente:

Creazione di azioni personalizzate

Azioni descrive le nuove azioni aggiunte ad Azure. Possono essere esposte sopra il provider di risorse o annidate in un resourceType. Vedere Ulteriori informazioni sulla creazione di azioni personalizzate

Provider di risorse personalizzate di esempio con azioni:

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

API aggiunte ad Azure per l'esempio precedente:

Assistenza

Per domande sullo sviluppo di provider di risorse personalizzate di Azure, provare a porre domande su Stack Overflow. È possibile che siano già state fornite risposte a domande simili, quindi verificare prima di pubblicarle. Aggiungere il tag azure-custom-providers per ottenere una risposta rapida.

Passaggi successivi

In questo articolo sono state fornite informazioni sui provider personalizzate. Andare all'articolo successivo per creare un provider di risorse personalizzate.

• Avvio rapido: Creare un provider di risorse personalizzate e distribuire le risorse personalizzate
• Esercitazione: creare azioni e risorse personalizzate in Azure
• Procedura: aggiunta di azioni personalizzate all'API REST di Azure
• Come fare per: Aggiungere risorse personalizzate all'API REST di Azure