全部產品
Search

搜尋本產品

    ：AddZoneRecord - 添加解析記錄

    文件中心

    ：AddZoneRecord - 添加解析記錄

    更新時間：Sep 09, 2025

    調用AddZoneRecord添加內建權威解析記錄。在解析生效範圍內，該網域名稱的內網解析記錄會覆蓋其公網解析記錄。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    pvtz:AddZoneRecord

    create

    *Zone

    acs:pvtz::{#accountId}:zone/{#ZoneId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ZoneId

    string

    是

    Zone ID，Zone 的唯一識別碼。

    df2d03865266bd9842306db586d3****
    Lang

    string

    否

    傳回值語言，取值：

    • zh：中文。

    • en：英文。

    預設值：en

    en
    Rr

    string

    是

    主機記錄。主機記錄就是網域名稱首碼，常見用法有 www、@、*（泛解析）、mail（常用於郵箱）。

    例如要解析@.exmaple.com，主機記錄要填寫"@”，而不是空。

    www
    Type

    string

    是

    解析記錄類型，目前支援如下：

    • A：將網域名稱指向一個 IPV4（點分十進位格式的 IPv4 地址）。

    • AAAA：將網域名稱指向一個 IPV6（IPv6 地址）。

    • CNAME：將網域名稱指向另一個網域名稱（網域名稱地址）。

    • TXT：文本長度限制 255，通常做 SPF 記錄（反垃圾郵件）。

    • MX：將網域名稱指向郵件伺服器地址（郵件伺服器的網域名稱）。

    • PTR：將 IP 位址指向一個網域名稱。

    • SRV：記錄提供特定的服務的伺服器（格式為 優先順序 權重 連接埠 目標地址，每項中間需以空格分隔）。

    說明

    添加 PTR 記錄前需要先配置反解 Zone，具體操作請參考反向解析及 PTR 記錄

    A
    Line

    string

    否

    解析請求來源。取值：

    • default：預設解析線路（相當於全域線路，建議您配置預設線路用於兜底，保障沒有智能線路命中的情況下可以返回解析記錄）。

    • 阿里雲線路（指解析請求來自阿里雲，包括公用雲、金融雲、政務雲）。

    • 自訂線路（可以定製內網網域名稱解析針對來源於某個特殊 IP 段的 DNS 查詢請求返回特定的 IP 位址）

    說明

    • 內建權威加速地區名才支援添加的解析請求來源線路。

    • 選擇預設解析，輸入“default”即可，阿里雲線路和自訂線路需填寫指定線路編碼。 例：aliyun_r_cn-beijing-a

    default
    Weight

    integer

    否

    權重值（1-100 內的整數，包括 1 和 100，預設為 1），支援對每個地址設定不同的權重值，實現解析查詢按照權重比例返回地址。

    1
    Ttl

    integer

    否

    本機快取時間。目前取值僅支援 5、30、60、3600（1 小時）、43200（12 小時）、86400（一天），單位秒（s），預設 60。

    60
    Priority

    integer

    否

    MX 記錄的優先順序。取值越小，優先順序越高，取值範圍：[1,99]。

    5
    Value

    string

    是

    記錄值。根據不同解析記錄類型，填寫相應的記錄值。

    114.55.XX.XX

    UserClientIp

    string

    否

    使用者 Ip。

    127.0.XX.XX
    Remark

    string

    否

    備忘。

    en
    ClientToken

    string

    否

    用戶端 Token，用於保證請求的等冪性。由用戶端產生該參數值，要保證在不同請求間唯一，最大值不超過 64 個 ASCII 字元。

    6447728c8578e66aacf062d2df4446dc

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    唯一請求識別碼。

    0B7AD377-7E86-44A8-B9A8-53E8666E72FE
    RecordId

    integer

    解析記錄 ID。

    429570****
    Success

    boolean

    是否成功。

    true

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "0B7AD377-7E86-44A8-B9A8-53E8666E72FE",
  "RecordId": 0,
  "Success": true
}

    異常返回樣本

    JSON格式

    {
    "Message": "The request processing has failed due to some unknown error, exception or failure", 
    "RequestId": "E246E023-F2EB-4034-83F7-B13FCF31459C", 
    "Code": "InternalError"
}

    錯誤碼

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

    變更歷史

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