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{...} imposterà il 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 dell'insieme di credenziali.
  • Sostituire {api-version} con la versione 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 dei 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à codici di stato HTTP per indicare l'esito positivo o negativo. Inoltre, gli errori contengono una risposta nel formato seguente:

   {  
     "error": {  
     "code": "BadRequest",  
     "message": "The key vault sku is invalid."  
     }  
   }  
Nome dell'elemento TIPO Descrizione
codice string Tipo di errore che si è verificato.
Messaggio string Descrizione di ciò che ha causato l'errore.

Vedere anche

Informazioni di riferimento sulle API REST di Azure Key Vault