全部产品
Search
文档中心

数字证书管理服务:UpdateInstance - 更新实例

更新时间:Aug 31, 2026

更新实例。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-cert:UpdateInstance

update

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

是

实例的 ID。

cas-cn-68n1mm16****

CertificateName

string

否

实例的名称,签发证书时则为作为证书的默认名称。

123

Domain

string

否

证书要绑定的域名。具体要求如下:

  • 支持设置单域名或者通配符域名(例如,*.aliyundoc.com)。

  • 支持设置多个域名。多个域名间使用英文逗号(,)分隔。是否赠送域名以第一个域名判断为准。

重要

证书绑定多个域名时,该参数为必填项。该参数与 Csr 参数不允许同时为空。如果您同时设置了该参数和 Csr 参数,则取 Csr 中的 CN 字段值作为证书绑定的域名。

test.com

KeyAlgorithm

string

否

证书算法,默认为 RSA_2048。

  • RSA_2048

  • RSA_3072

  • RSA_4096

  • ECC_256

  • SM2

RSA_2048

AutoReissue

string

否

是否开启自动托管。

  • enable:开启

  • disable:未开启

enable

CompanyId

integer

否

公司信息 ID,OV 和 EV 要求必填,否则无法调用 ApplyCertificate 申请证书。

44211

ContactIdList

array

否

联系人 ID 列表。如果已有联系人,可以不传,如果之前没有设置,则要求至少传一个,否则后续无法调用 ApplyCertificate 申请证书。

integer

否

联系人信息 ID。

123

GenerateCsrMethod

string

否

CSR 生成方式。默认为 online。

  • online:系统生成,则会忽略 Csr 字段。

  • upload:用户上传,则要求 Csr 为必填。

online

Csr

string

否

CSR 内容。您可以通过 OpenSSL 工具或者 Keytool 工具生成 CSR。更多信息,请参见如何制作 CSR 文件。

-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----

ValidationMethod

string

否

申请证书验证方式。

  • DNS:DNS 验证方式,TXT 或者 CNAME。

  • HTTP:文件验证方式。

DNS

City

string

否

购买证书的用户所属的公司或组织所在的城市。DV 证书生成 CSR 时需要该字段,默认为 Beijing。

Beijing

Province

string

否

公司所在省份或者地区。DV 证书生成 CSR 时需要该字段,默认为 Beijing。

Beijing

CountryCode

string

否

设置证书组织机构所在国家或地区的代码。例如,CN 表示中国,US 表示美国。DV 证书生成 CSR 时需要该字段,默认为 CN。

CN

ResourceGroupId

string

否

资源分组 ID。

rg-ae******4wia

Tags

array<object>

否

标签列表。

object

否

Tag 列表。

TagKey

string

否

实例的标签键。N 的取值范围:1~20。一旦输入该值,则不允许为空字符串。

最多支持 64 个字符,不能以aliyun和acs:开头,不能包含http://或者https://。

test

TagValue

string

否

实例的标签值。N 的取值范围:1~20。一旦输入该值,可以为空字符串。

最多支持 128 个字符,不能以aliyun和acs:开头,不能包含http://或者https://。

test

返回参数

名称

类型

描述

示例值

object

RequestId

string

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

0068247C-A454-5FC9-93BF-C41CBB5CD19E

示例

正常返回示例

JSON格式

{
  "RequestId": "0068247C-A454-5FC9-93BF-C41CBB5CD19E"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。