Allgemeine Parameter und Header
Die folgenden Informationen gelten für alle Vorgänge, die Sie ggf. im Zusammenhang mit Key Vault-Ressourcen ausführen:
- Der HTTP-Header
Host
muss immer vorhanden sein, und der Hostname des Tresors muss angegeben werden. Beispiel:Host: contoso.vault.azure.net
. Beachten Sie, dass die meisten Clienttechnologien denHost
-Header aus dem URI mit Daten auffüllen. Beispielsweise legtGET https://contoso.vault.azure.net/secrets/mysecret{...}
die AngabeHost
aufcontoso.vault.azure.net
fest. Wenn Sie auf Key Vault mit einer unformatierten IP-Adresse wieGET https://10.0.0.23/secrets/mysecret{...}
zugreifen, ist der automatische Wert desHost
-Headers falsch, und Sie müssen manuell sicherstellen, dass derHost
-Header den Hostnamen des Tresors enthält. - Ersetzen Sie
{api-version}
durch die API-Version im URI. - Ersetzen Sie
{subscription-id}
durch Ihren Abonnementbezeichner im URI. - Ersetzen Sie
{resource-group-name}
durch die Ressourcengruppe. Weitere Informationen finden Sie unter „Verwenden von Ressourcengruppen zum Verwalten von Azure-Ressourcen“. - Ersetzen Sie
{vault-name}
durch Ihren Schlüsseltresornamen im URI. - Legen Sie den Inhaltstyp auf „application/json“ fest.
- Legen Sie den Autorisierungsheader auf ein JSON-Webtoken fest, das Sie von Microsoft Entra ID erhalten. Weitere Informationen finden Sie unter Authentifizieren von Anforderungen des Azure-Ressourcen-Managers.
Allgemeine Fehlerantwort
Der Dienst gibt anhand von HTTP-Statuscodes an, ob der Vorgang erfolgreich oder fehlerhaft war. Außerdem enthalten Fehler eine Antwort im folgenden Format:
{
"error": {
"code": "BadRequest",
"message": "The key vault sku is invalid."
}
}
Elementname | type | BESCHREIBUNG |
---|---|---|
code | Zeichenfolge | Der Typ des aufgetretenen Fehlers. |
message | Zeichenfolge | Eine Beschreibung der Ursache des Fehlers. |