全部產品
Search

搜尋本產品

    ：AddZone - 添加zone

    文件中心

    ：AddZone - 添加zone

    更新時間：Sep 09, 2025

    調用AddZone建立內建權威網域名稱，內建權威網域名稱可以添加在普通區或加速區。

    介面說明

    2025 年 4 月 30 日（UTC+8）起，新開通Alibaba Cloud DNS PrivateZone 的使用者在添加 Zone 時，預設將設定為加速區 Zone。 2026 年 4 月 30 日（UTC+8）起，所有使用者的普通區內建權威 Zone 將自動切換至加速區。切換後解析請求量可能增加，導致使用成本上升。建議為ECS 開啟 NSCD，以減少無本機快取引發的解析請求增長。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    pvtz:AddZone

    create

    *Zone

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Lang

    string

    否

    傳回值語言，取值：

    • zh：中文。

    • en：英文。

    預設：en

    en
    ZoneName

    string

    否

    需要新增的 zone 名稱。

    example.com
    ProxyPattern

    string

    否

    是否開啟子網域名稱遞迴代理。取值：

    • ZONE: 關閉（當解析本網域名稱下不存在的子網域名稱時，直接返回 NXDOMAIN，表示子網域名稱不存在）

    • RECORD: 開啟（當解析本網域名稱下不存在的子網域名稱時，會依次查詢“轉寄”和“遞迴”模組，並以最終查詢到的解析結果來應答解析請求）

    預設：ZONE

    ZONE
    ResourceGroupId

    string

    否

    資源群組 ID。

    rg-acfmykd63gt****
    ZoneType

    string

    否

    暫不對使用者開放，無需傳值。

    CLOUD_PRODUCT_ZONE
    ZoneTag

    string

    否

    暫不對使用者開放，無需傳值。

    BLINK
    ClientToken

    string

    否

    保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。只支援 ASCII 字元，且不能超過 64 個字元。

    21079fa016944979537637959d09bc
    DnsGroup

    string

    否

    內建權威位置區。取值：

    • NORMAL_ZONE：普通區（解析應答結果會被緩衝，緩衝不命中的情況下才回源到內建權威普通區，解析變更生效受 TTL 時間影響；無法使用自訂線路解析、權重解析功能。）

    • FAST_ZONE：快速區（推薦：直接應答解析請求、解析時延最低，記錄變更即時生效；支援自訂線路解析、權重解析。）

    預設：NORMAL_ZONE

    說明

    內建權威加速區在緩衝模組前，解析結果不進入緩衝，因此將產生更多解析量請求費用。

    FAST_ZONE

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    ZoneName

    string

    zone 名稱。

    example.com
    ZoneId

    string

    Zone ID，Zone 的唯一識別碼。

    6fc186295683a131f63bb8b0cddc****
    RequestId

    string

    唯一請求識別碼。

    54F10A2A-C3CF-59D4-810F-F18DDD93FE20
    Success

    boolean

    是否成功。

    true

    樣本

    正常返回樣本

    JSON格式

    {
  "ZoneName": "example.com",
  "ZoneId": "6fc186295683a131f63bb8b0cddc****",
  "RequestId": "54F10A2A-C3CF-59D4-810F-F18DDD93FE20",
  "Success": true
}

    錯誤碼

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

    變更歷史

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