UpdateCustomHostname - 更新 SaaS 域名

更新时间:
复制为 MD 格式

更新 SaaS 域名,支持修改绑定的记录 ID、证书类型等。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

HostnameId

integer

SaaS 域名的 ID,可通过调用 ListCustomHostnames 接口获取。

1234567890123

RecordId

integer

待绑定记录的 ID,可以通过 ListRecords 获取。

1234567890123

SslFlag

string

SSL 开关。

  • on: 开启 SSL。

  • off: 关闭 SSL。

on

CertType

string

证书类型,SslFlag 为 on 时需要输入该参数。

  • free: 免费证书。

  • upload: 上传证书。

  • cas: 云盾证书。

cas

Certificate

string

证书内容,CertType 为 upload 时需要输入该参数。

-----BEGIN CERTIFICATE-----

PrivateKey

string

证书私钥,CertType 为 upload 时需要输入该参数。

-----BEGIN PRIVATE KEY-----

CasId

integer

云盾证书 ID,CertType 为 cas 时需要输入该参数。

30000478

CasRegion

string

云盾证书地域,CertType 为 cas 时需要输入该参数。

  • 中国站账号传参数值:cn-hangzhou。

  • 国际站账号传参数值:ap-southeast-1。

cn-hangzhou

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID,阿里云为该请求生成的唯一标识符。

0AEDAF20-4DDF-4165-8750-47FF9C1929C9

示例

正常返回示例

JSON格式

{
  "RequestId": "0AEDAF20-4DDF-4165-8750-47FF9C1929C9"
}

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParameter The specified parameter is invalid. 输入参数规范校验失败。
400 InternalException Failed to call the service. Try again later or contact technical support. 调用服务失败,请稍后重试或联系客服咨询详情。
400 NoPermission You do not have permissions to access or operate on the resource.Contact your account administrator to attach the AliyunESAFullAccess policy to the current user. 对当前资源无权限访问或者操作。请联系您阿里云账户的管理员,以授予您 AliyunESAFullAccess 策略。
400 Instance.NotOnline Your plan is unavailable due to an overdue payment. Complete the payment first. 您的套餐实例因欠费当前处于非上线状态,请先完成续费操作以继续使用。
400 Record.ServiceBusy The record is being configured. Try again later. 该记录正在配置中,请稍后再试。
400 CustomHostname.QueryCasCertFailed Fail to query CAS certificate details. Please try again later. 查询云盾证书详情失败,请稍后重试。
400 CustomHostname.CheckQuotaFailed Fail to check quota for custom hostname. Please try again later. 检查站点的自定义主机名配额失败,请稍后重试。
400 QuotaExceed.CustomHostname The number of custom hostnames exceeds the plan quota. Contact the sales team to increase your quota. 自定义主机名的数量超限,请联系销售增加额度。
400 CustomHostname.OfflineForMultiReason Unable to activate the custom hostname because it is offline due to multiple reasons. 该自定义主机名因多种原因下线,因此无法激活。
404 CustomHostname.NotFound The custom hostname does not exist. Modify it and try again. 该自定义主机名不存在,请调整后重试。
404 CustomHostname.ApplyCertFailed Fail to apply a free cert for custom hostname. Please try again later.
404 CustomHostname.SetCertFailed Fail to deploy a cert for custom hostname. Please try again later.

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

变更历史

更多信息,参考变更详情