調用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不存在 |
訪問錯誤中心查看更多錯誤碼。