Condividi tramite


Parametri e intestazioni comuni

Le informazioni seguenti sono comuni a tutte le operazioni che è possibile eseguire sulle risorse di Key Vault:

  • L'intestazione HTTP Host deve essere sempre presente e deve specificare il nome host della risorsa di Key Vault. Esempio: Host: contoso.vault.azure.net. Si noti che la maggior parte delle tecnologie client popola l'intestazione Host dall'URI. Ad esempio, GET https://contoso.vault.azure.net/secrets/mysecret{...} imposta Host come contoso.vault.azure.net. Se si accede a Key Vault usando un indirizzo IP non elaborato come GET https://10.0.0.23/secrets/mysecret{...}, il valore automatico dell'intestazione Host sarà errato e sarà necessario assicurarsi manualmente che l'intestazione Host contenga il nome host della risorsa di Key Vault.
  • Sostituire {api-version} con la versione dell'API nell'URI.
  • Sostituire {subscription-id} con l'identificatore della sottoscrizione nell'URI
  • Sostituire {resource-group-name} con il gruppo di risorse. Per altre informazioni, vedere Uso di gruppi di risorse per gestire le risorse di Azure.
  • Sostituire {vault-name} con il nome dell'insieme di credenziali delle chiavi nell'URI.
  • Impostare l'intestazione Content-Type su application/json.
  • Impostare l'intestazione dell'autorizzazione su un token JSON Web ottenuto da Microsoft Entra ID. Per altre informazioni, vedere Autenticazione delle richieste di Azure Resource Manager.

Risposta di errore comune

Il servizio userà i codici di stato HTTP per indicare l'esito positivo o negativo. Gli errori contengono inoltre una risposta nel formato seguente:

   {  
     "error": {  
     "code": "BadRequest",  
     "message": "The key vault sku is invalid."  
     }  
   }  
Nome elemento Tipo Descrizione
codice string Il tipo di errore che si è verificato.
messaggio string Descrizione della causa dell'errore.

Vedi anche

Informazioni di riferimento sull'API REST di Azure Key Vault