Typowe parametry i nagłówki
Następujące informacje są wspólne dla wszystkich operacji, które można wykonać w zasobach usługi Key Vault:
- Nagłówek HTTP
Host
musi być zawsze obecny i musi określać nazwę hosta magazynu. Przykład:Host: contoso.vault.azure.net
. Należy pamiętać, że większość technologii klienckich wypełniaHost
nagłówek z identyfikatora URI. Na przykładGET https://contoso.vault.azure.net/secrets/mysecret{...}
parametr zostanie ustawionyHost
jakocontoso.vault.azure.net
. Jeśli uzyskujesz dostęp do usługi Key Vault przy użyciu nieprzetworzonego adresu IP, naGET https://10.0.0.23/secrets/mysecret{...}
przykład , automatyczna wartość nagłówkaHost
będzie nieprawidłowa i musisz ręcznie upewnić się, żeHost
nagłówek zawiera nazwę hosta magazynu. - Zastąp
{api-version}
element wersją interfejsu API w identyfikatorze URI. - Zastąp
{subscription-id}
element identyfikatorem subskrypcji w identyfikatorze URI - Zastąp element
{resource-group-name}
grupą zasobów. Więcej informacji można znaleźć w temacie Używanie grup zasobów do zarządzania zasobami platformy Azure. - Zastąp
{vault-name}
ciąg nazwą magazynu kluczy w identyfikatorze URI. - Ustaw nagłówek Content-Type na wartość application/json.
- Ustaw nagłówek Authorization na token internetowy JSON uzyskany z identyfikatora Entra firmy Microsoft. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie żądań usługi Azure Resource Manager .
Typowa odpowiedź na błąd
Usługa użyje kodów stanu HTTP, aby wskazać powodzenie lub niepowodzenie. Ponadto błędy zawierają odpowiedź w następującym formacie:
{
"error": {
"code": "BadRequest",
"message": "The key vault sku is invalid."
}
}
Nazwa elementu | Type | Opis |
---|---|---|
code | string | Typ błędu, który wystąpił. |
wiadomość | string | Opis przyczyny błędu. |