调用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不存在 |
访问错误中心查看更多错误码。