DescDomain

调用DescDomain配置域名。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

DomainId

Integer

13464

域名ID。可以通过QueryDomainByParam获取。

Action

String

DescDomain

系统规定参数。取值:DescDomain。

RequireRealTimeDnsRecords

boolean

true

判断是否要实时DNS解析

返回数据

名称

类型

示例值

描述

SpfRecord

String

include:spf1.dm.aliyun.com

邮件推送控制台提供的spf记录值

CnameConfirmStatus

String

0

是否改动了CNAME的主机记录,已改动:1(改回原来值也算改动),未改动:0。

DefaultDomain

String

0

是否为默认域名,

值:0 否(该字段已弃用)

CreateTime

String

2019-09-29T12:49Z

创建时间

CnameRecord

String

dmtrace

CNAME主机记录自定义部分

CnameAuthStatus

String

1

CNAME验证标志,成功:0,失败:1。

IcpStatus

String

1

备案状态。1表示已备案,0表示未备案。

DnsTxt

String

0c40d5f125af4e42892a

通过公网域名解析到的所有权记录值

DomainName

String

test.example.net

域名

DomainId

String

158910

域名ID

DnsSpf

String

v=xxxx

通过公网域名解析到的spf记录值

SpfAuthStatus

String

1

spf验证标志,成功:0,失败:1。

RequestId

String

51B74264-46B4-43C8-A9A0-6B8E8BC04F34

请求ID

MxRecord

String

mx01.dm.aliyun.com

邮件推送控制台提供的MX记录值

MxAuthStatus

String

1

mx验证标志,成功:0,失败:1。

DnsMx

String

mx01.dm.aliyun.com

通过公网域名解析到的MX记录值

DomainStatus

String

1

域名状态。说明是否验证成功,取值:

0:可用,已验证通过。

1:不可用,验证未通过。

2:可使用,未做cname,未备案。

3:可使用,未备案。

4:可使用,未做cname

TlDomainName

String

example.net

主域名

TracefRecord

String

tracedm.aliyuncs.com

邮件推送控制台提供的CNAME记录值

DomainType

String

0c40d5f125af4e42892a

邮件推送控制台提供的所有权记录

SpfRecordV2

String

v=spf1 include:spf1.dm.aliyun.com -all

SPF记录值

DkimRR

String

aliyun-cn-hangzhou._domainkey.xxx

DKIM主机记录

DkimPublicKey

String

v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb...

DKIM公钥值

DkimAuthStatus

String

1

DKIM 验证标志,成功:0,失败:1。

HostRecord

String

xxx

主机记录

DmarcHostRecord

String

_dmarc.xxx

DMARC主机记录值

DmarcRecord

String

v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com

DMARC记录值

DnsDmarc

String

v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com

通过公网域名解析到的DMARC记录值

DmarcAuthStatus

Integer

1

DMARC 验证标志,成功:0,失败:1。

示例

请求示例

http(s)://dm.aliyuncs.com/?Action=DescDomain
&DomainId=401591
&<公共请求参数>

正常返回示例

JSON 格式

{
  "HostRecord": "dmailtest",
  "CnameAuthStatus": 1,
  "CnameRecord": "dmtrace",
  "IcpStatus": 1,
  "DefaultDomain": 0,
  "DomainType": "df29ab561bb140e98dfb",
  "SpfRecordV2": "v=spf1 include:spf1.dm.aliyun.com -all",
  "DkimRR": "aliyun-cn-hangzhou._domainkey.dmailtest",
  "TlDomainName": "sdysy.top",
  "SpfRecord": "include:spf1.dm.aliyun.com",
  "SpfAuthStatus": 0,
  "RequestId": "9C7FB8ED-BF86-5BA1-B0EF-BB71937C2036",
  "DomainName": "dmailtest.sdysy.top",
  "DnsMx": "mx01.dm.aliyun.com",
  "CreateTime": "2023-09-11T17:59Z",
  "DnsTxt": "df29ab561bb140e98dfb",
  "CnameConfirmStatus": 0,
  "DnsSpf": "v=spf1 include:spf1.dm.aliyun.com -all",
  "MxRecord": "mx01.dm.aliyun.com",
  "DomainId": 401591,
  "MxAuthStatus": 0,
  "TracefRecord": "tracedm.aliyuncs.com",
  "DkimPublicKey": "v=DKIM1; k=rsa; p=xxx",
  "DkimAuthStatus": 0,
  "DmarcAuthStatus": 1,
  "DomainStatus": 3,
  "DmarcHostRecord": "_dmarc.xxx",
  "DmarcRecord": "v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com",
  "DnsDmarc": "v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com"
}

错误码

Http状态码

错误代码

错误信息

描述

400

InvalidDomainId.Malformed

The specified domain ID does not exist.

域名ID不存在

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