文档首页/ 云解析服务 DNS/ API参考/ API/ 公网子域名授权/ 查询公网子域名授权 - ShowAuthorizeTxtRecord
更新时间:2025-10-17 GMT+08:00
分享

查询公网子域名授权 - ShowAuthorizeTxtRecord

功能介绍

查询已生成的子域名授权TXT记录验证信息。

公网域名为全局资源,请选择“华北-北京四(cn-north-4)”区域调用。

调用方法

请参见如何调用API

URI

GET /v2/authorize-txtrecord

表1 Query参数

参数

是否必选

参数类型

描述

zone_name

String

待创建的子域名。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

获取用户Token请参见获取用户Token

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

id

String

参数解释:

授权请求ID。

取值范围:

不涉及。

zone_name

String

参数解释:

待创建的子域名。

取值范围:

不涉及。

record

RecordInfo object

参数解释:

解析记录信息。

取值范围:

不涉及。

status

String

参数解释:

授权状态。

取值范围:

  • CREATED:已创建

  • VERIFIED:已验证

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。

取值范围:

不涉及。

表4 RecordInfo

参数

参数类型

描述

host

String

参数解释:

解析记录的主机记录。

取值范围:

不涉及。

value

String

参数解释:

解析记录的记录值。

取值范围:

不涉及。

状态码:400

表5 响应Body参数

参数

参数类型

描述

code

String

参数解释:

错误码。

取值范围:

不涉及。

message

String

参数解释:

错误描述。

取值范围:

不涉及。

状态码:500

表6 响应Body参数

参数

参数类型

描述

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

接口错误响应。

错误码

请参见错误码

相关文档