让用户创建一个新的站点。
接口说明
创建站点之前，您必须拥有可用的套餐实例。
如果加速区域包含中国内地，站点必须完成备案。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| SiteName |
string |
是 |
站点名称。 |
example.com |
| Coverage |
string |
是 |
加速区域。取值：
|
domestic |
| AccessType |
string |
是 |
站点的接入类型。取值：
|
NS |
| InstanceId |
string |
是 |
实例 ID，可通过调用 ListUserRatePlanInstances 接口获取。实例 ID 和站点 ID 至少填写一个，若两者都填，则以实例 ID 为准进行查询。 |
dbaudit-cn-nwy349jdb03 |
| ResourceGroupId |
string |
否 |
资源组 ID。不传该参数时，系统自动补全默认资源组 ID。 |
rg-acfmw4znnok**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE |
| SiteId |
integer |
站点 ID。 |
1234567890123 |
| NameServerList |
string |
为站点分配的 NS 列表，用半角逗号（,）分隔。当站点的接入方式为 NS 接入时，该字段有值，需要将站点的 DNS 服务器修改成这些 NS。随后即可验证站点的归属权，激活站点。 |
ns1.example.com,ns2.example.com |
| VerifyCode |
string |
站点的校验码。当站点的接入方式为 CNAME 接入时，需要在站点的 DNS 服务器下配置一条记录名称为_esaauth.[站点名称] 、记录值为校验码的 TXT 记录。随后即可验证站点的归属权，激活站点。 |
verify_aah9dioasmov**** |
示例
正常返回示例
JSON格式
{
"RequestId": "CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE",
"SiteId": 1234567890123,
"NameServerList": "ns1.example.com,ns2.example.com",
"VerifyCode": "verify_aah9dioasmov****"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | ServiceInvokeFailed | The call to the internal service failed. The engineer is resolving the problem. Please wait a moment before trying, or contact customer service for details. | 调用服务失败，请稍后重试或联系客服咨询详情。 |
| 400 | InternalException | Failed to call the service. Try again later or contact technical support. | 调用服务失败，请稍后重试或联系客服咨询详情。 |
| 400 | InvalidParameter | The specified parameter is invalid. | 输入参数规范校验失败。 |
| 400 | Instance.NotOnline | Your plan is unavailable due to an overdue payment. Complete the payment first. | 您的套餐实例因欠费当前处于非上线状态，请先完成续费操作以继续使用。 |
| 400 | InvalidParameter.SiteName | Invalid website name. Specify a valid name that contains letters and digits and does not contain special characters. | 站点名称无效，请重新输入站点名称，可以包含字母和数字，不能包含特殊字符。 |
| 400 | QuotaExceed.SiteCount | The maximum number of websites associated with your plan has been reached. | 站点数量超出配额限制。 |
| 400 | Site.Conflict | Duplicate website names exist across multiple accounts. Rename or delete one and try again. | 站点冲突，多个账户下存在相同名称的站点，请删除或更名后重试。 |
| 400 | Site.AlreadyExist | The website name you specified already exists. Try with another name. | 您输入的站点已存在，请您重新设置。 |
| 400 | SubSiteUnavailable | Subdomains are allowed only in Enterprise plans. Upgrade your plan to add a subdomain to ESA. | 仅企业版支持以子域名创建站点，请升级您的套餐。 |
| 400 | Site.InvalidCoverage | The selected location is unavailable in your plan. Change the location to one that is covered by the plan and try again. | 您选择的加速区域不在当前套餐支持范围内，请更换为套餐支持的加速区域后重试。 |
| 400 | InvalidSiteICP | 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 | InvalidSiteName | Invalid website name. Check and try again. | 您配置的站点名称不正确，请确保传入正确的站点名称后重试。 |
| 400 | Site.InBlacklist | The site name is in the blacklist. | 站点名称在黑名单中。 |
| 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 策略。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。