通用參數和標頭
下列資訊通用於針對 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 | 造成錯誤之原因的描述。 |