创建公网子域名授权 - CreateAuthorizeTxtRecord
功能介绍
当创建子域名时提示“域名与其他租户冲突，你需要添加TXT授权校验”，通过调用当前接口生成子域名授权的TXT记录验证信息。
公网域名为全局资源，请选择“华北-北京四（cn-north-4）”区域调用。
调用方法
请参见如何调用API。
URI
POST /v2/authorize-txtrecord
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 获取用户Token请参见获取用户Token。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
zone_name |
是 |
String |
参数解释： 待创建的子域名。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释： 授权请求ID。 取值范围： 不涉及。 |
|
zone_name |
String |
参数解释： 待创建的子域名。 取值范围： 不涉及。 |
|
record |
RecordInfo object |
参数解释： 解析记录信息。 取值范围： 不涉及。 |
|
status |
String |
参数解释： 授权状态。 取值范围：
|
|
second_level_zone_name |
String |
参数解释： 子域名所属的二级域名。 取值范围： 不涉及。 |
|
created_at |
String |
参数解释： 创建时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS。 取值范围： 不涉及。 |
|
updated_at |
String |
参数解释： 更新时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS。 取值范围： 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
host |
String |
参数解释： 解析记录的主机记录。 取值范围： 不涉及。 |
|
value |
String |
参数解释： 解析记录的记录值。 取值范围： 不涉及。 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释： 错误码。 取值范围： 不涉及。 |
|
message |
String |
参数解释： 错误描述。 取值范围： 不涉及。 |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释： 错误码。 取值范围： 不涉及。 |
|
message |
String |
参数解释： 错误描述。 取值范围： 不涉及。 |
请求示例
创建公网子域名授权请求。
POST https://{endpoint}/v2/authorize-txtrecord
{
"zone_name" : "www.example.com"
}
响应示例
状态码：200
创建公网子域名授权响应。
{
"id" : "a86dba5800434cc6a1bb69d5e86f3ca3",
"zone_name" : "www.example.com.",
"second_level_zone_name" : "example.com.",
"record" : {
"host" : "authorize-aa6c2459738d403daf37a3b206197ea1",
"value" : "a86dba5800434cc6a1bb69d5e86f3ca3"
},
"status" : "CREATED",
"created_at" : "2016-11-17T11:56:03.439",
"updated_at" : "2016-11-17T11:56:03.439"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
创建公网子域名授权响应。 |
|
400 |
接口错误响应。 |
|
500 |
接口错误响应。 |
错误码
请参见错误码。
