Vanliga parametrar och sidhuvuden
Följande information är gemensam för alla åtgärder som du kan utföra på Key Vault-resurser:
- HTTP-huvudet
Host
måste alltid finnas och måste ange valvets värdnamn. Exempel:Host: contoso.vault.azure.net
. Observera att de flesta klienttekniker fyllerHost
huvudet från URI:n. Till exempelGET https://contoso.vault.azure.net/secrets/mysecret{...}
kommer att angeHost
somcontoso.vault.azure.net
. Om du kommer åt Key Vault med rå IP-adress somGET https://10.0.0.23/secrets/mysecret{...}
, kommer det automatiska värdet förHost
huvudet att vara fel, och du måste manuellt se till attHost
huvudet innehåller valvets värdnamn. - Ersätt
{api-version}
med api-versionen i URI:n. - Ersätt
{subscription-id}
med din prenumerationsidentifierare i URI:n - Ersätt
{resource-group-name}
med resursgruppen. Mer information finns i Använda resursgrupper för att hantera Azure-resurser. - Ersätt
{vault-name}
med ditt nyckelvalvnamn i URI:n. - Ange rubriken Content-Type till application/json.
- Ange auktoriseringshuvudet till en JSON-webbtoken som du hämtar från Microsoft Entra-ID. Mer information finns i Autentisera Azure Resource Manager-begäranden .
Vanligt felsvar
Tjänsten använder HTTP-statuskoder för att indikera lyckade eller misslyckade. Dessutom innehåller fel ett svar i följande format:
{
"error": {
"code": "BadRequest",
"message": "The key vault sku is invalid."
}
}
Elementnamn | Typ | Beskrivning |
---|---|---|
kod | sträng | Den typ av fel som inträffade. |
meddelande | sträng | En beskrivning av vad som orsakade felet. |