全部產品
Search

搜尋本產品

    Cloud Enterprise Network：UpdateTransitRouterVpcAttachmentZones

    文件中心

    Cloud Enterprise Network：UpdateTransitRouterVpcAttachmentZones

    更新時間：Sep 02, 2026

    呼叫 UpdateTransitRouterVpcAttachmentZones 介面修改專有網路 VPC（Virtual Private Cloud）連線關聯的可用區和交換器。

    介面說明

    • 在為 VPC 連線新增可用區和交換器時，請確保交換器中擁有一個空閒的 IP 位址，在修改過程中，企業版轉送路由器將在交換器中建立一個彈性網卡 ENI（Elastic Network Interface）（該 ENI 將佔用交換器下的一個 IP 位址），作為 VPC 執行個體與企業版轉送路由器流量互通的介面。

    • UpdateTransitRouterVpcAttachmentZones 介面屬於非同步介面，即系統會先返回一個 RequestId，但該 VPC 連線並未修改完成，系統背景的修改任務仍在進行。您可以呼叫 ListTransitRouterVpcAttachments 介面查詢 VPC 連線的狀態。

      • 當 VPC 連線處於 Modifying 狀態時，表示 VPC 連線正在修改中，在該狀態下，您只能對 VPC 連線執行查詢操作，不能執行其他操作。

      • 當 VPC 連線處於 Attached 狀態時，表示 VPC 連線修改完成。

    • VPC 連線 ID 下至少有一個 VPC 連線的可用區和交換器不能全部刪除。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    cen:UpdateTransitRouterVpcAttachmentZones

    update

    *TransitRouterVpcAttachment

    acs:cen:*:{#accountId}:centransitrouterattachment/{#centransitrouterattachmentId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ClientToken

    string

    否

    用戶端 Token，用於保證請求的冪等性。

    從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

    說明

    若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 識別碼。每次 API 請求的 RequestId 不一樣。

    123e4567-e89b-12d3-a456-42665544****
    DryRun

    boolean

    否

    是否僅預檢此次請求。取值：

    • true：傳送檢查請求，不會修改 VPC 連線的可用區和交換器。檢查項目包括是否填寫了必要參數、請求格式、業務限制。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼 DryRunOperation。

    • false（預設值）：傳送正常請求，通過檢查後直接修改 VPC 連線的可用區和交換器。

    false
    TransitRouterAttachmentId

    string

    是

    VPC 連線 ID。

    tr-attach-9bbqyygouv4cpn****
    AddZoneMappings

    array<object>

    否

    待為 VPC 連線新增的可用區和交換器清單。

    object

    否

    待 VPC 連線新增的交換器 ID。

    一次最多支援新增 10 個交換器。

    VSwitchId

    string

    否

    待為 VPC 連線新增的交換器 ID。

    一次最多支援新增 10 個交換器。

    • 如果您目前登入的阿里雲帳號和 VPC 執行個體屬於同一個帳號，您可以呼叫 DescribeVSwitches 介面查詢 VPC 執行個體下交換器 ID 及其所屬可用區的 ID。

    • 如果您目前登入的阿里雲帳號和 VPC 執行個體屬於不同的帳號，您可以呼叫 ListGrantVSwitchesToCen 介面查詢 VPC 執行個體下交換器 ID 及其所屬可用區的 ID。

    當填寫 VSwitchId 後 ZoneId 為必填。

    vsw-wz988dda8ldm4uvmx****
    ZoneId

    string

    否

    待為 VPC 連線新增的交換器所屬的可用區 ID。

    一次最多支援新增 10 個交換器。

    當填寫 ZoneId 後 VSwitchId 為必填。

    cn-hangzhou-h
    RemoveZoneMappings

    array<object>

    否

    待為 VPC 連線刪除的可用區和交換器清單。

    object

    否

    待為 VPC 連線刪除的可用區和交換器清單。

    一次最多支援輸入 10 組可用區和交換器資訊。

    VSwitchId

    string

    否

    待為 VPC 連線刪除的交換器 ID。

    一次最多支援刪除 10 個交換器。

    當填寫 VSwitchId 後 ZoneId 為必填。

    vsw-wz9f5izl6wshndmta****
    ZoneId

    string

    否

    待為 VPC 連線刪除的交換器所屬的可用區 ID。

    一次最多支援刪除 10 個交換器。

    當填寫 ZoneId 後 VSwitchId 為必填。

    cn-hangzhou-i

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    595AE52F-49FF-5788-A677-0DD1467941A1

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "595AE52F-49FF-5788-A677-0DD1467941A1"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 IllegalParam.ZoneId The specified ZoneId is illegal. 傳入的可用區非法。
    400 IncorrectStatus.TransitRouterAttachment The status of TransitRouterAttachment is incorrect. 目前 TransitRouterAttachment 的狀態不支援此操作，請稍後重試。
    400 IllegalParam.VSwitchId VSwitchId is illegal. 參數中指定的 VSwitchId 不合法。
    400 InvalidTransitRouterAttachmentId.NotFound TransitRouterAttachmentId is not found. 參數中指定的 TransitRouterAttachmentId 不存在。
    400 OperationUnsupported.ServiceMode The specified TransitRouter does not support the operation. 目前轉發路由器模式不支援此操作。
    400 IllegalParam.AddOrRemoveZoneMappings The specified AddZoneMappings or RemoveZoneMappings are illegal. 參數中指定的 AddZoneMappings 或 RemoveZoneMappings 不合法。
    400 IncorrectStatus.Vpc The resource is not in a valid state for the attachment operation. 目前 VPC 的狀態不支援此操作，請稍後重試。
    400 OperationDenied.RouteEntryOnEni Operation is failed because there is at least one route entry which next hop is the specified eni. 存在指向 ENI 的路由，無法支援此操作。
    400 IncorrectStatus.VpcRouteEntry The resource is not in a valid state for the attachment operation. 目前 VpcRouteEntry 的狀態不支援此操作，請稍後重試。
    400 IncorrectStatus.VpcSwitch The resource is not in a valid state for the attachment operation. 目前 Vswitch 的狀態不支援此操作，請稍後重試。
    400 OperationUnsupported.TransitRouterType The specified TransitRouterType does not support the operation. 目前的 TransitRouter 類型不支援此操作。
    400 InsufficientIpAddr.vsw Insufficient available IP addresses in the vSwitch. 虛擬交換器中的可用 IP 數目不足。
    400 OperationFailed.VSwitchIpv6CidrNotAllocated The specified vswitch does not have IPv6 address allocated. 指定的 VSwitch 未啟用 IPv6，請啟用 IPv6 後再進行此操作。
    400 InvalidTransitRouterMode.NeedUpgrade TransitRouter need to upgrade. 目前轉發路由器模式不支援。
    400 OperationInvalid.EniReferencedIPv6RouteEntryExisted Operation is failed because there is at least one route entry(IPv6) which next hop is network interface that the specified attachment referenced. VPC 中存在指向 attachment 相關 ENI 的 IPv6 路由條目，無法支援此操作。請先清除此路由條目，再執行此操作。
    400 InvalidParameter Invalid parameter. 參數不合法。
    400 Unauthorized The AccessKeyId is unauthorized. 帳號無權限操作。
    400 InvalidParameter.TransitRouterAttachmentId The specified parameter TransitRouterAttachmentId is invalid.
    404 IllegalParam.ZoneId The specified ZoneId is illegal.
    404 InvalidVSwitchId.NotFound The specified VSwitchId is not found. VSwitchId 不存在。
    409 IncorrectStatus.VpcSwitch The resource is not in a valid state for the attachment operation.

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

    變更歷史

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