Condividi tramite

Gestire le risorse di Azure usando l'API REST

  • Articolo

Informazioni su come usare l'API REST per Azure Resource Manager per gestire le risorse di Azure. Per informazioni di riferimento complete su come strutturare le chiamate REST di Azure, vedere Introduzione a REST. Per altre informazioni sulle operazioni disponibili, vedere le informazioni di riferimento sull'API REST di Resource Manager.

Ottenere un token di accesso

Per effettuare una chiamata API REST ad Azure, è prima necessario ottenere un token di accesso. Includere questo token di accesso nelle intestazioni delle chiamate API REST di Azure usando l'intestazione "Authorization" e impostare il valore su "Bearer {token-accesso}".

Se è necessario recuperare a livello di codice nuovi token come parte dell'applicazione, è possibile ottenere un token di accesso registrando l'applicazione client con Microsoft Entra ID.

Se si è all'inizio e si voglio testare le API REST di Azure usando il proprio token individuale, è possibile recuperare rapidamente il token di accesso corrente con Azure PowerShell o l'interfaccia della riga di comando di Azure.

token=$(az account get-access-token --query accessToken --output tsv)

Ambito dell'operazione

È possibile chiamare molte operazioni di Azure Resource Manager in ambiti diversi:

Type Ambito
Gruppo di gestione providers/Microsoft.Management/managementGroups/{managementGroupId}
Subscription subscriptions/{subscriptionId}
Gruppo di risorse subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}
Conto risorse subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderName}/{resourceType}/{resourceName}

Elencare risorse

L'operazione REST seguente restituisce le risorse all'interno di un gruppo di risorse specificato.

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources?api-version=2021-04-01 HTTP/1.1
Authorization: Bearer <bearer-token>
Host: management.azure.com

Di seguito è riportato un esempio di comando cURL che è possibile usare per elencare tutte le risorse in un gruppo di risorse usando l'API di Azure Resource Manager:

curl  -H "Authorization: Bearer $token" -H 'Content-Type: application/json' -X GET 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources?api-version=2021-04-01'

Con il passaggio di autenticazione, questo esempio è simile al seguente:

token=$(az account get-access-token --query accessToken --output tsv)
curl  -H "Authorization: Bearer $token" -H 'Content-Type: application/json' -X GET 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources?api-version=2021-04-01'

Distribuire le risorse in un gruppo di risorse esistente

È possibile distribuire le risorse di Azure direttamente usando l'API REST o distribuire un modello di Resource Manager per creare risorse di Azure.

Distribuire una risorsa

L'operazione REST seguente crea un account di archiviazione. Per visualizzare questo esempio in modo più dettagliato, vedere Creare un account di archiviazione di Azure con l'API REST. La documentazione di riferimento completa e gli esempi per il provider di risorse di archiviazione sono disponibili in Informazioni di riferimento sulle API REST del provider di risorse di archiviazione.

PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}?api-version=2018-02-01 HTTP/1.1
Authorization: Bearer <bearer-token>
Content-Type: application/json
Host: management.azure.com

{
  "sku": {
    "name": "Standard_GRS"
  },
  "kind": "StorageV2",
  "location": "eastus2",
}

Distribuire un modello

Le operazioni seguenti distribuiscono un modello di avvio rapido per la creazione di un account di archiviazione. Per altre informazioni, vedere Avvio rapido: Creare modelli di Azure Resource Manager con Visual Studio Code. Per informazioni di riferimento sull'API di questa chiamata, vedere Distribuzioni - Creare o aggiornare.

PUT /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/my-deployment?api-version=2021-04-01 HTTP/1.1
Authorization: Bearer <bearer-token>
Content-Type: application/json
Host: management.azure.com

{
  "properties": {
    "templateLink": {
      "uri": "https://example.com/azuretemplates/azuredeploy.json"
    },
    "parametersLink": {
        "uri": "https://example.com/azuretemplates/azuredeploy.parameters.json"
    },
    "mode": "Incremental"
  }
}

Per le API REST, il valore di uri non può essere un file locale o un file disponibile solo nella rete locale. Azure Resource Manager deve poter accedere al modello. Specificare un valore URI scaricabile come HTTP o HTTPS. Per altre informazioni, vedere Distribuire le risorse con i modelli di Azure Resource Manager e Azure PowerShell.

Distribuire un gruppo di risorse e le risorse

È possibile creare un gruppo di risorse e distribuire le risorse nel gruppo usando un modello. Per altre informazioni, vedere Creare un gruppo di risorse e distribuire risorse.

Distribuire risorse in più sottoscrizioni o gruppi di risorse

In genere si distribuiscono tutte le risorse del modello in un unico gruppo di risorse. ma in alcuni scenari può essere preferibile distribuire insieme un set di risorse, inserendole tuttavia in gruppi di sottoscrizioni e risorse diversi. Per altre informazioni, vedere Distribuire le risorse di Azure in più sottoscrizioni o gruppi di risorse.

Eliminare risorse

L'operazione seguente illustra come eliminare un account di archiviazione.

DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}?api-version=2022-09-01 HTTP/1.1
Authorization: Bearer <bearer-token>
Host: management.azure.com

Per altre informazioni su come Azure Resource Manager ordina l'eliminazione delle risorse, vedere Eliminazione di un gruppo di risorse in Azure Resource Manager.

Gestire l'accesso alle risorse

Per gestire l'accesso alle risorse in Azure, si usa il controllo degli accessi in base al ruolo di Azure. Per altre informazioni, vedere Aggiungere o rimuovere assegnazioni di ruolo di Azure con REST.

Passaggi successivi