Panoramica dei provider di risorse personalizzati 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 personalizzato di Azure.
- Come usare provider di risorse personalizzati di Azure per estendere i flussi di lavoro esistenti.
- Dove trovare guide ed esempi di codice per iniziare.
Importante
I provider di risorse personalizzati sono attualmente in anteprima pubblica. Questa versione di anteprima viene messa a disposizione senza contratto di servizio e non è consigliata per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere Condizioni supplementari per l'utilizzo delle anteprime di Microsoft Azure.
Cosa può fare i provider di risorse personalizzati
Ecco alcuni esempi di ciò che è possibile ottenere con i provider di risorse personalizzati di Azure:
- Estendere l'API REST di Azure Resource Manager per includere servizi interni ed esterni.
- Abilitare scenari personalizzati in base ai flussi di lavoro di Azure esistenti.
- Personalizzare il controllo e l'effetto dei modelli di Azure Resource Manager.
Che cos'è un provider di risorse personalizzato
I provider di risorse personalizzati 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 personalizzato esporrà quindi queste nuove API in Azure. I provider di risorse personalizzati di Azure sono costituiti da tre parti: provider di risorse personalizzate, endpoint e risorse personalizzate.
Come creare provider di risorse personalizzati
I provider di risorse personalizzati sono un elenco di contratti tra Azure ed endpoint. Questi contratti descrivono come Azure deve interagire con gli endpoint. I provider di risorse agiscono come un proxy e inoltrano richieste e risposte a e dall'endpoint specificato. Un provider di risorse può specificare due tipi di contratti: resourceTypes e azioni. Queste sono abilitate tramite le definizioni degli endpoint. Una definizione dell'endpoint è costituita da tre campi: nome, routingType e endpoint.
Endpoint di esempio:
{
"name": "{endpointDefinitionName}",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
| Proprietà | Obbligatoria | Descrizione |
|---|---|---|
| name | Sì | Nome della definizione dell'endpoint. Azure esporrà tale nome tramite l'API in '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/ resourceProviders/{resourceProviderName}/{endpointDefinitionName}' |
| routingType | No | Determina il tipo di contratto con l'endpoint. Se non viene specificato, per impostazione predefinita sarà "Proxy". |
| endpoint | Sì | Endpoint a cui indirizzare le richieste. Gestirà la risposta, nonché eventuali effetti collaterali della richiesta. |
Creazione di risorse personalizzate
ResourceTypes descrive nuove risorse personalizzate aggiunte ad Azure. Questi metodi CRUD di base espongono i metodi CRUD RESTful. Vedere altre informazioni sulla creazione di risorse personalizzate
Esempio di provider di risorse personalizzato con resourceTypes:
{
"properties": {
"resourceTypes": [
{
"name": "myCustomResources",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
API aggiunte ad Azure per l'esempio precedente:
| HttpMethod | URI di esempio | Descrizione |
|---|---|---|
| PUT | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Chiamata api REST di Azure per creare una nuova risorsa. |
| DELETE | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Chiamata api REST di Azure per eliminare una risorsa esistente. |
| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Chiamata api REST di Azure per recuperare una risorsa esistente. |
| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources?api-version=2018-09-01-preview |
Chiamata api REST di Azure per recuperare l'elenco delle risorse esistenti. |
Creazione di azioni personalizzate
Le azioni descrivono nuove azioni aggiunte ad Azure. Questi possono essere esposti sopra il provider di risorse o annidati in un resourceType. Per altre informazioni sulla creazione di azioni personalizzate, vedere altre informazioni sulla creazione di azioni personalizzate
Esempio di provider di risorse personalizzato con azioni:
{
"properties": {
"actions": [
{
"name": "myCustomAction",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
API aggiunte ad Azure per l'esempio precedente:
| HttpMethod | URI di esempio | Descrizione |
|---|---|---|
| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomAction?api-version=2018-09-01-preview |
Chiamata api REST di Azure per attivare l'azione. |
Assistenza
Se si hanno domande per lo 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 stati illustrati i provider di risorse personalizzati. Passare all'articolo successivo per creare un provider di risorse personalizzato.