全部產品
Search

搜尋本產品

    Alibaba Cloud DNS：UpdateZoneRecord - 修改解析記錄

    文件中心

    Alibaba Cloud DNS：UpdateZoneRecord - 修改解析記錄

    更新時間：Sep 09, 2025

    調用UpdateZoneRecord修改網域名稱（Zone）的解析記錄，包括主機記錄、解析記錄、權重等。

    介面說明

    注意事項

    普通地區名修改解析記錄至少需要等待 TTL 到期後才能全部生效，加速地區名修改解析記錄立即生效，不受 TTL 值影響。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    pvtz:UpdateZoneRecord

    update

    *Zone

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Rr

    string

    是

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

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

    www
    Lang

    string

    否

    傳回值語言，取值：

    • zh：中文。

    • en：英文。

    預設值：en

    en
    RecordId

    integer

    是

    解析記錄 ID。可以通過調用 DescribeZoneRecords 查詢解析記錄列表擷取。

    172223****
    Line

    string

    否

    解析線路，預設：default。

    default
    Weight

    integer

    否

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

    1
    Type

    string

    是

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

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

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

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

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

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

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

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

    說明

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

    A
    Ttl

    integer

    否

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

    60
    Priority

    integer

    否

    MX 記錄的優先順序。可以為不同郵件伺服器設定優先權，優先順序取值 1-99，取值越小，優先順序越高。

    說明

    記錄類型為 MX 記錄時，此參數必選。

    1
    Value

    string

    是

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

    192.16.XX.XX
    UserClientIp

    string

    否

    使用者 Ip。

    127.0.XX.XX
    ClientToken

    string

    否

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

    6447728c8578e66aacf062d2df4446dc

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    唯一請求識別碼。

    250E2C38-D0AD-4518-851D-1C1055805F82
    RecordId

    integer

    解析記錄 ID。

    172223****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "250E2C38-D0AD-4518-851D-1C1055805F82",
  "RecordId": 0
}

    錯誤碼

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

    變更歷史

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