全部產品
Search

搜尋本產品

    Direct Mail：DescDomain - 佈建網域名

    文件中心

    Direct Mail：DescDomain - 佈建網域名

    更新時間：Apr 21, 2026

    佈建網域名。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dm:DescDomain

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    DomainId

    integer

    是

    網域名稱 ID。可以通過 QueryDomainByParam 擷取。

    13464
    RequireRealTimeDnsRecords

    boolean

    否

    判斷是否要即時 DNS 解析

    true

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    SpfRecord

    string

    Direct Mail控制台提供的 spf 記錄值

    include:spf1.dm.aliyun.com
    CnameConfirmStatus

    string

    是否改動了 CNAME 的主機記錄，已改動：1（改回原來值也算改動），未改動：0。

    0
    DefaultDomain

    string

    是否為預設網域名稱，

    值：0 否（該欄位已棄用）

    0
    CreateTime

    string

    建立時間

    2025-03-19T12:49Z
    CnameRecord

    string

    CNAME 主機記錄自訂部分

    dmtrace
    CnameAuthStatus

    string

    CNAME 驗證標誌，成功：0，失敗：1。

    1
    IcpStatus

    string

    備案狀態。1 表示已備案，0 表示未備案。

    1
    DnsTxt

    string

    通過公網網域名稱解析到的所有權記錄值

    0c40d5f125af4e42892a
    DomainName

    string

    網域名稱

    test.example.net
    DomainId

    string

    網域名稱 ID

    158910
    DnsSpf

    string

    通過公網網域名稱解析到的 spf 記錄值

    v=xxxx
    SpfAuthStatus

    string

    spf 驗證標誌，成功：0，失敗：1。

    1
    RequestId

    string

    請求 ID

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

    string

    Direct Mail控制台提供的 MX 記錄值

    mx01.dm.aliyun.com
    MxAuthStatus

    string

    mx 驗證標誌，成功：0，失敗：1。

    1
    DnsMx

    string

    通過公網網域名稱解析到的 MX 記錄值

    mx01.dm.aliyun.com
    DomainStatus

    string

    網域名稱狀態。說明是否驗證成功，取值：

    • 0：可用，已驗證通過

    • 1：不可用，驗證未通過

    1
    TlDomainName

    string

    主網域名稱

    example.com
    TracefRecord

    string

    Direct Mail控制台提供的 CNAME 記錄值

    tracedm.aliyuncs.com
    DomainType

    string

    Direct Mail控制台提供的所有權記錄

    0c40d5f125af4e42892a
    SpfRecordV2

    string

    spf 記錄，以前 spf 展示內容需要調用端根據響應中的 spfRecord 計算得出，新增欄位 spfRecordV2 取代 spfRecord， 調用端拿到該欄位後可以直接進行展示；

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

    string

    DKIM 主機記錄，使用者需要在 dns 上設定的 dkim 記錄的 key

    aliyun-cn-hangzhou._domainkey.hangzhou26
    DkimPublicKey

    string

    DKIM 公開金鑰值，使用者需要在 dns 上設定的 dkim 記錄的 value

    v=DKIM1; k=rsa; p=MIGfMA0GCSqGSI...
    DkimAuthStatus

    string

    DKIM 驗證標誌，使用者在 dns 設定的 dkim 記錄是否已經校正通過, 0:通過， 1:未通過

    0
    HostRecord

    string

    主機記錄

    xxx
    DmarcRecord

    string

    DMARC 記錄值

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

    string

    通過公網網域名稱解析到的 DMARC 記錄值

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

    integer

    DMARC 驗證標誌，使用者在 dns 設定的 DMARC 記錄是否已經校正通過, 0:通過， 1:未通過

    1
    DmarcHostRecord

    string

    DMARC 主機記錄值

    _dmarc.xxx
    DkimRsaLength

    integer

    DKIM 使用的 RSA 密鑰的長度，例如 1024、2048

    1024
    DomainVersion

    integer

    樣本

    正常返回樣本

    JSON格式

    {
  "SpfRecord": "include:spf1.dm.aliyun.com",
  "CnameConfirmStatus": "0",
  "DefaultDomain": "0",
  "CreateTime": "2025-03-19T12:49Z",
  "CnameRecord": "dmtrace",
  "CnameAuthStatus": "1",
  "IcpStatus": "1",
  "DnsTxt": "0c40d5f125af4e42892a",
  "DomainName": "test.example.net",
  "DomainId": "158910",
  "DnsSpf": "v=xxxx",
  "SpfAuthStatus": "1",
  "RequestId": "51B74264-46B4-43C8-A9A0-6B8E8BC04F34",
  "MxRecord": "mx01.dm.aliyun.com",
  "MxAuthStatus": "1",
  "DnsMx": "mx01.dm.aliyun.com",
  "DomainStatus": "1",
  "TlDomainName": "example.com",
  "TracefRecord": "tracedm.aliyuncs.com",
  "DomainType": "0c40d5f125af4e42892a",
  "SpfRecordV2": "v=spf1 include:spf1.dm.aliyun.com -all",
  "DkimRR": "aliyun-cn-hangzhou._domainkey.hangzhou26",
  "DkimPublicKey": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSI...",
  "DkimAuthStatus": "0",
  "HostRecord": "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",
  "DmarcAuthStatus": 1,
  "DmarcHostRecord": "_dmarc.xxx",
  "DkimRsaLength": 1024,
  "DomainVersion": 0
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。