全部产品
Search

搜索本产品

    邮件推送：DescDomain

    文档中心

    邮件推送：DescDomain

    更新时间：Jul 08, 2024

    调用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不存在

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