你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set Certificate Issuer - Set Certificate Issuer

参考

Service:: Key Vault

API Version:: 7.4

设置指定的证书颁发者。
SetCertificateIssuer 操作添加或更新指定的证书颁发者。此操作需要 certificates/setissuers 权限。

PUT {vaultBaseUrl}/certificates/issuers/{issuer-name}?api-version=7.4

URI 参数

名称	在	必需	类型	说明
issuer-name	path	True	string	颁发者的名称。为了运行服务，可能会全局复制你提供的值。提供的值不应包括个人身份信息或敏感信息。
vaultBaseUrl	path	True	string	保管库名称，例如 https://myvault.vault.azure.net。
api-version	query	True	string	客户端 API 版本。

请求正文

名称	必需	类型	说明
provider	True	string	颁发者提供程序。
attributes		IssuerAttributes	颁发者对象的属性。
credentials		IssuerCredentials	要用于颁发者的凭据。
org_details		OrganizationDetails	提供给颁发者的组织详细信息。

响应

名称	类型	说明
200 OK	IssuerBundle	密钥保管库证书的颁发者。
Other Status Codes	KeyVaultError	密钥保管库描述操作失败原因的错误响应。

示例

SetCertificateIssuer

Sample Request

HTTP

PUT https://myvault.vault.azure.net//certificates/issuers/issuer01?api-version=7.4

{
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser",
    "pwd": "password"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  }
}

Sample Response

Status code:: 200

{
  "id": "https://myvault.vault.azure.net/certificates/issuers/issuer01",
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  },
  "attributes": {
    "enabled": true,
    "created": 1482188806,
    "updated": 1482189526
  }
}

定义

名称	说明
AdministratorDetails	证书颁发者的组织管理员的详细信息。
CertificateIssuerSetParameters	证书颁发者设置参数。
Error	密钥保管库服务器错误。
IssuerAttributes	由密钥保管库服务管理的颁发者的属性。
IssuerBundle	密钥保管库证书的颁发者。
IssuerCredentials	要用于证书颁发者的凭据。
KeyVaultError	密钥保管库错误异常。
OrganizationDetails	证书颁发者的组织详细信息。

AdministratorDetails

证书颁发者的组织管理员的详细信息。

名称	类型	说明
email	string	电子邮件地址。
first_name	string	名字。
last_name	string	姓氏。
phone	string	电话号码。

CertificateIssuerSetParameters

证书颁发者设置参数。

名称	类型	说明
attributes	IssuerAttributes	颁发者对象的属性。
credentials	IssuerCredentials	要用于颁发者的凭据。
org_details	OrganizationDetails	提供给颁发者的组织详细信息。
provider	string	颁发者提供程序。

Error

密钥保管库服务器错误。

名称	类型	说明
code	string	错误代码。
innererror	Error	密钥保管库服务器错误。
message	string	错误消息。

IssuerAttributes

由密钥保管库服务管理的颁发者的属性。

名称	类型	说明
created	integer	创建时间（UTC）。
enabled	boolean	确定是否启用颁发者。
updated	integer	上次更新时间（UTC）。

IssuerBundle

密钥保管库证书的颁发者。

名称	类型	说明
attributes	IssuerAttributes	颁发者对象的属性。
credentials	IssuerCredentials	要用于颁发者的凭据。
id	string	颁发者对象的标识符。
org_details	OrganizationDetails	提供给颁发者的组织详细信息。
provider	string	颁发者提供程序。

IssuerCredentials

要用于证书颁发者的凭据。

名称	类型	说明
account_id	string	用户名/帐户名称/帐户 ID。
pwd	string	密码/机密/帐户密钥。

KeyVaultError

密钥保管库错误异常。

名称	类型	说明
error	Error	密钥保管库服务器错误。

OrganizationDetails

证书颁发者的组织详细信息。

名称	类型	说明
admin_details	AdministratorDetails[]	组织管理员的详细信息。
id	string	组织的 ID。