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.
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. |
Informazioni di riferimento sull'API REST di Azure Key Vault