查询公网子域名授权 - ShowAuthorizeTxtRecord
功能介绍
查询已生成的子域名授权TXT记录验证信息。
公网域名为全局资源,请选择“华北-北京四(cn-north-4)”区域调用。
调用方法
请参见如何调用API。
URI
GET /v2/authorize-txtrecord
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
zone_name |
是 |
String |
待创建的子域名。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 获取用户Token请参见获取用户Token。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码: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 |
参数解释: 错误描述。 取值范围: 不涉及。 |
请求示例
查询公网子域名授权请求。
GET 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 |
接口错误响应。 |
错误码
请参见错误码。