全部產品
Search

搜尋本產品

    Virtual Private Cloud：EnableVpcIpv4Gateway - 啟用IPv4網關

    文件中心

    Virtual Private Cloud：EnableVpcIpv4Gateway - 啟用IPv4網關

    更新時間：Apr 27, 2026

    調用EnableVpcIpv4Gateway介面啟用IPv4網關。

    介面說明

    • EnableVpcIpv4Gateway 介面屬於非同步介面，即系統會先返回一個 RequestId，但該 IPv4 網關執行個體並未啟用完成，系統背景啟用任務仍在進行。您可以調用 GetIpv4GatewayAttribute 查詢 IPv4 網關執行個體的狀態。

      • 當 IPv4 網關執行個體處於 Activating 狀態時，表示正在啟用中。

      • 當 IPv4 網關執行個體處於 Created 狀態時，表示啟用完成。

    • EnableVpcIpv4Gateway 介面不支援並發啟用同一個 IPv4 網關。

    調試

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

    調試

    授權資訊

    當前API暫無授權資訊透出。

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Ipv4GatewayId

    string

    是

    要啟用的 IPv4 網關的執行個體 ID。

    ipv4gw-5tsp9lumsxoqizvq2****
    RegionId

    string

    是

    IPv4 網關所在地區 ID。

    您可以通過調用 DescribeRegions 介面擷取地區 ID。

    ap-southeast-6
    DryRun

    boolean

    否

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

    • true：發送檢查請求，不會啟用 IPv4 網關。檢查項包括是否填寫了必需參數、請求格式、業務限制。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼DryRunOperation。

    • false（預設值）：發送正常請求，通過檢查後返回 HTTP 2xx 狀態代碼並直接啟用 IPv4 網關。

    false
    ClientToken

    string

    否

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

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

    說明

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

    123e4567-e89b-12d3-a456-426655440000
    RouteTableList

    array

    否

    路由表列表。系統會為路由表列表中的路由表添加一條 0.0.0.0/0 指向 IPv4 網關的路由條目。

    string

    否

    路由表列表。系統會為路由表列表中的路由表添加一條 0.0.0.0/0 指向 IPv4 網關的路由條目。系統支援的最大路由表數量為 10。

    說明

    路由表與 IPv4 網關需要屬於同一個 VPC。

    vtb-5ts0ohchwkp3dydt2****
    RegionId

    string

    是

    IPv4 網關所在地區 ID。

    您可以通過調用 DescribeRegions 介面擷取地區 ID。

    ap-southeast-6

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    54B48E3D-DF70-471B-AA93-08E683A1B45

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 VPC_ROUTE_ENTRY_CIDR_BLOCK_DUPLICATE Specified CIDR block is already exists.
    400 ResourceNotFound.Ipv4Gateway The specified resource ipv4Gateway is not found. 未找到指定的Ipv4網關，無法刪除
    400 IncorrectStatus.Ipv4Gateway The status of %s [%s] is incorrect. 指定的Ipv4Gateway處於非穩態，請稍後重試
    400 OperationFailed.Ipv4GatewayAlreadyActive. The operation failed because of ipv4Gateway is already active.
    400 OperationDenied.ConflictOfAllZeroRouting The operation is not allowed because of routetable [%s] exist all-zero route entry.
    400 UnsupportedFeature.Ipv4Gateway The feature of ipv4Gateway is not supported for [%s]. 建立ipv4網關失敗，因為不支援ipv4網關特性
    400 OperationDenied.VpnExist The operation is not allowed because of existing vpn. 不允許建立IPv4網關，因為VPC已經存在VPN網關
    400 OperationDenied.NatgatewayExist The operation is not allowed because of existing nat.
    400 OperationDenied.DirectEipExist The operation is not allowed because of existing directEip. 操作不允許，該VPC下存在直通EIP或增強型NAT Gateway
    400 OperationDenied.VpcHasAlreadyActive The operation is not allowed because of vpc has already been active.

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

    變更歷史

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