Udostępnij za pośrednictwem


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łnia Host nagłówek z identyfikatora URI. Na przykład GET https://contoso.vault.azure.net/secrets/mysecret{...} parametr zostanie ustawiony Host jako contoso.vault.azure.net. Jeśli uzyskujesz dostęp do usługi Key Vault przy użyciu nieprzetworzonego adresu IP, na GET https://10.0.0.23/secrets/mysecret{...}przykład , automatyczna wartość nagłówka Host będzie nieprawidłowa i musisz ręcznie upewnić się, że Host 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.

Zobacz też

Dokumentacja interfejsu API REST usługi Azure Key Vault