全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

更新/补全证书信息

最近更新时间:2022-07-14 17:00:39

UpdateCertificate(更新/补全证书信息)

请求方式:POST
说明:请在调用申请证书接口后,等待2秒再调用本接口

Request Parameters(请求参数)

CertificateId

  • 描述:证书ID
  • 类型:String
  • 是否可缺省:否

AuthMethod

  • 描述:验证方式(除Sectigo外仅针对DV证书,Sectigo全部需要)
  • 类型:String
  • 是否可缺省:是
  • 可选值:DNS DNS方式 | FILE 文件方式

CSR

  • 描述:证书CSR字符串
  • 类型:String
  • 是否可缺省:是
  • 约束:当CsrSource为USER或缺省时,此值不可缺省

ContactId

  • 描述:联系人ID
  • 类型:Integer
  • 是否可缺省:是
  • 约束:当ContactId不为空时,Contact参数可缺省,两者并存时以ContactId为准,当ContactId不为空时,City、State、Country不能为空

CompanyId

  • 描述:企业信息ID
  • 类型:Integer
  • 是否可缺省:是
  • 约束:当CompanyId不为空时,CompanyName、Department、State、City、Address、CompanyPhone、PostalCode可缺省,两者并存时以CompanyId为准

CompanyName

  • 描述:企业名称
  • 类型:String
  • 是否可缺省:是

Department

  • 描述:部门名称
  • 类型:String
  • 是否可缺省:是

State

  • 描述:省份
  • 类型:String
  • 是否可缺省:是

City

  • 描述:城市
  • 类型:String
  • 是否可缺省:是

Address

  • 描述:地址
  • 类型:String
  • 是否可缺省:是

CompanyPhone

  • 描述:公司电话
  • 类型:String
  • 是否可缺省:是
  • 约束:可为座机或者手机

PostalCode

  • 描述:邮编
  • 类型:String
  • 是否可缺省:是

DcvEmail

  • 描述:可从whois查询到的注册域名时填写的邮箱信息
  • 类型:String
  • 是否可缺省:是

AdditionalDomains

  • 描述:附加域名
  • 类型:String
  • 是否可缺省:是
  • 约束:多个域名以英文,分隔

Wildcards

  • 描述:通配符域名
  • 类型:String
  • 是否可缺省:是
  • 约束:多个通配符域名以英文,分隔

Contact

  • 描述:联系人
  • 类型:Contact
  • 是否可缺省: 是
  • 约束:DV证书只需要技术联系人

IsSubmit

  • 描述:是否提交,提交后将把订单数据提交给第三方
  • 类型:String
  • 是否可缺省:是
  • 可选值:0 否 | 1 是,默认值为0
  • 约束:
    • 当值为0时:可以用来修改Contact、CompanyName、State、City、Address、CompanyPhone、PostalCode、Department等信息;
    • 当值为1时:
      • 必须保证Contact不为空
      • 且CompanyName、State、City、Address、CompanyPhone、PostalCode、Department不为空,或在IsSubmit为0时已经设置过
      • 对于DV证书,以上规则有两个例外
        • Department可为空
        • CompanyPhone可为空,但contact当中必须设置phone

BusinessLicence

  • 描述:企业营业执照图片文件
  • 类型:String
  • 是否可缺省: 是,DV证书不需要
  • 约束:图片的base64值,图片大小不超过600K

CsrSource

  • 描述:CSR字符串来源
  • 类型:String
  • 是否可缺省:是
  • 可选值:USER 用户提交 | SYSTEM 系统生成 ,默认值为USER
  • 约束:
    • IsSubmit为0时,此参数可缺省
    • IsSubmit为1时
      • 当值为USER时,参数CSR不可缺省或此前在IsSubmit为0时设置过;
      • 当值为SYSTEM时,CSR参数或此前设置的CSR无效

Algorithm

  • 描述:编码算法类型
  • 类型:String
  • 是否可缺省:是
  • 可选值:ECC|RSA 默认值:RSA

Response Elements(返回值)

RequestId

  • 描述:请求ID
  • 类型:String

Certificate

Examples(举例)

Sample Request(请求)

https://kcm.api.ksyun.com/?Action=UpdateCertificate
&Version=2016-03-04
&CertificateId=1612201230001
&AuthMethod=DNS
&CSR=jlakdsjfowqklfdjlsaf
&State=北京
&City=北京
&Address=上地八街
&CompanyPhone=13718967735
&PostalCode=100086
&AdditionalDomains=test.1234.com
&Wildcards=*.api.1234.com
&Contact={"FirstName":"San","LastName":"Zhang","Phone":"12345678901","Email":"[email protected]","Title":"经理"}
&IsSubmit=1
&CsrSource=USER

Sample Response(响应)

<UpdateCertificateResponse xmlns="http://kcm.api.ksyun.com/doc/2016-03-04>
   <RequestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</RequestId>
   <Certificate>
       <CertificateId>1612201230001</CertificateId>
       <MainDomain>www.2345.com</MainDomain>
       <CertificateBrand>Symantec</CertificateBrand>
       <CertificateLevel>OV</CertificateLevel>
       <CertificateName>混合多域名</CertificateName>
       <CertificateCode>SYMCDV01</CertificateCode> 
       <CertificateStatus>1</CertificateStatus>
       <YearLength>1</YearLength>
       <DomainCount>2</DomainCount>
       <WildcardCount>1</WildcardCount>
       <AuthMethod>DNS</AuthMethod>
       <CompanyName></CompanyName>
       <CSR>jlakdsjfowqklfdjlsaf</CSR>
       <State>北京</State>
       <City>北京</City>
       <Address>上地八街</Address>
       <CompanyPhone>13718967735</CompanyPhone>
       <PostalCode>100086</PostalCode>
       <AdditionalDomains>test.1234.com</AdditionalDomains>
       <Wildcards>*.api.1234.com</Wildcards>
   </Certificate>
   <Contact>
       <FirstName>San</FirstName>
       <LastName>Zhang</LastName>
       <Phone>13718967735</Phone>
       <AltPhone></AltPhone>
       <Email>[email protected]</Email>
       <Title>经理</Title>
   </Contact>
</UpdateCertificateResponse>
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈