你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
以下信息常见于对密钥保管库资源执行的所有操作:
- 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 版本。 - 将
{subscription-id}
替换为 URI 中的订阅标识符 - 将
{resource-group-name}
替换为资源组。 有关详细信息,请参阅使用资源组管理 Azure 资源。 - 将
{vault-name}
替换为 URI 中 Key Vault 的名称。 - 将 Content-Type 标头设置为 application/json。
- 将授权标头设置为从 Microsoft Entra ID 获得的 JSON Web 令牌。 有关详细信息,请参阅 对 Azure 资源管理器请求进行身份验证 。
常见错误响应
该服务将使用 HTTP 状态代码来指示成功或失败。 此外,失败还会包含采用以下格式的响应:
{
"error": {
"code": "BadRequest",
"message": "The key vault sku is invalid."
}
}
元素名称 | 类型 | DESCRIPTION |
---|---|---|
代码 | 字符串 | 发生的错误类型。 |
消息 | 字符串 | 导致错误的原因的说明。 |