通用參數和標頭

下列資訊通用於針對 Key Vault 資源執行的所有作業:

  • HTTP Host 標頭必須一律存在,而且必須指定保存庫主機名稱。 範例:Host: contoso.vault.azure.net。 請注意,大部分的用戶端技術都會從 URI 填入 Host 標頭。 例如,GET https://contoso.vault.azure.net/secrets/mysecret{...} 會將 Host 設定為 contoso.vault.azure.net。 如果您使用原始 IP 位址 (例如 GET https://10.0.0.23/secrets/mysecret{...}) 存取 Key Vault,自動產生的 Host 標頭值會錯誤,而且您必須手動確認 Host 標頭包含保存庫主機名稱。
  • {api-version} 取代為 URI 中的 api-version。
  • {subscription-id} 取代為 URI 中的訂用帳戶識別碼
  • {resource-group-name} 取代為資源群組。 如需詳細資訊,請參閱<使用資源群組管理 Azure 資源>。
  • {vault-name} 取代為 URI 中您的金鑰保存庫名稱。
  • 將 Content-Type 標頭設定為 application/json。
  • 將授權標頭設定為您從 Microsoft Entra ID 取得的 JSON Web 權杖。 如需詳細資訊,請參閱驗證 Azure Resource Manager 要求

通用錯誤回應

服務將使用 HTTP 狀態碼指出成功或失敗。 此外,失敗包含下列格式的回應:

   {  
     "error": {  
     "code": "BadRequest",  
     "message": "The key vault sku is invalid."  
     }  
   }  
元素名稱 類型 描述
code string 所發生錯誤的類型。
message string 造成錯誤之原因的描述。

另請參閱

Azure Key Vault REST API 參考