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'intestazioneHost
dall'URI. Ad esempio,GET https://contoso.vault.azure.net/secrets/mysecret{...}
impostaHost
comecontoso.vault.azure.net
. Se si accede a Key Vault usando un indirizzo IP non elaborato comeGET https://10.0.0.23/secrets/mysecret{...}
, il valore automatico dell'intestazioneHost
sarà errato e sarà necessario assicurarsi manualmente che l'intestazioneHost
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