全部产品
Search
文档中心

边缘安全加速:VerifyCustomHostname - 校验 SaaS 域名归属

更新时间:Jan 30, 2026

校验 SaaS 域名归属,通过校验的站点将自动被激活。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

HostnameId

integer

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

1234567890123

返回参数

名称

类型

描述

示例值

object

RequestId

string

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

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

Passed

boolean

校验是否通过。

true

示例

正常返回示例

JSON格式

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

错误码

HTTP status code

错误码

错误信息

描述

200 CustomHostname.VerifyUnpassed The custom hostname ownership verification failed. Complete the verification and try again. 自定义主机名归属校验未通过,请您确保自定义主机名归属权校验通过后重试。
400 InternalException Failed to call the service. Try again later or contact technical support. 调用服务失败,请稍后重试或联系客服咨询详情。
400 InvalidParameter The specified parameter is invalid. 输入参数规范校验失败。
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.InvalidICP The specified website does not have an ICP filing or the filing information is invalid. Make sure your website is filed and try again. 您配置的自定义主机名未备案或ICP备案信息不合法,请确保站点已完成备案后重试。
400 CustomHostname.ConflictWithExistingResource The custom hostname conflicts with existing resources, such as sites, records, load balancers, source address pools, custom hostnames and Layer 4 proxy records. 自定义主机名和已有资源冲突,例如站点、记录、负载均衡器、源地址池、自定义主机名和四层代理等
404 CustomHostname.NotFound The custom hostname does not exist. Modify it and try again. 该自定义主机名不存在,请调整后重试。

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

变更历史

更多信息,参考变更详情