Běžné parametry a záhlaví

Následující informace jsou společné pro všechny operace, které můžete provádět s prostředky služby Key Vault:

  • Hlavička HTTP Host musí vždy existovat a musí zadat název hostitele trezoru. Příklad: Host: contoso.vault.azure.net. Všimněte si, že většina klientských technologií naplní hlavičku Host z identifikátoru URI. Například GET https://contoso.vault.azure.net/secrets/mysecret{...} nastaví Host hodnotu jako contoso.vault.azure.net. Pokud přistupujete ke službě Key Vault pomocí nezpracované IP adresy, jako GET https://10.0.0.23/secrets/mysecret{...}je , bude automatická hodnota Host hlavičky chybná a budete muset ručně zajistit, aby Host hlavička obsahovala název hostitele trezoru.
  • Nahraďte {api-version} rozhraním API-version v identifikátoru URI.
  • Nahraďte {subscription-id} identifikátorem vašeho předplatného v identifikátoru URI.
  • Nahraďte {resource-group-name} ji skupinou prostředků. Další informace najdete v článku Použití skupin prostředků ke správě prostředků Azure.
  • Nahraďte {vault-name} názvem trezoru klíčů v identifikátoru URI.
  • Nastavte hlavičku Content-Type na application/json.
  • Nastavte autorizační hlavičku na webový token JSON, který získáte z ID Microsoft Entra. Další informace najdete v tématu Ověřování požadavků Azure Resource Manageru .

Běžná odpověď na chybu

Služba použije stavové kódy HTTP k označení úspěchu nebo selhání. Selhání navíc obsahují odpověď v následujícím formátu:

   {  
     "error": {  
     "code": "BadRequest",  
     "message": "The key vault sku is invalid."  
     }  
   }  
Název prvku Typ Popis
code string Typ chyby, ke které došlo.
zpráva string Popis toho, co způsobilo chybu.

Viz také

Referenční informace k rozhraní REST API služby Azure Key Vault