Udostępnij przez


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 nagłówek Host z URI. Na przykład GET https://contoso.vault.azure.net/secrets/mysecret{...} zostanie ustawione Host jako contoso.vault.azure.net. Jeśli uzyskujesz dostęp do usługi Key Vault przy użyciu nieprzetworzonego adresu IP, na przykład GET https://10.0.0.23/secrets/mysecret{...}, automatyczna wartość nagłówka Host będzie nieprawidłowa i musisz ręcznie upewnić się, że nagłówek Host zawiera nazwę hosta skarbca.
  • Zastąp znacznik {api-version} wersją interfejsu API w identyfikatorze URI.
  • Zastąp {subscription-id} swoim identyfikatorem subskrypcji w identyfikatorze URI
  • Zastąp element {resource-group-name} grupą zasobów. Aby uzyskać więcej informacji, zobacz Używanie grup zasobów do zarządzania zasobami platformy Azure.
  • Zastąp {vault-name} 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 Typ Opis
kod sznurek Typ błędu, który wystąpił.
Komunikat sznurek Opis przyczyny błędu.

Zobacz też

Dokumentacja interfejsu API REST usługi Azure Key Vault