全部產品
Search

搜尋本產品

    Cloud Enterprise Network：ListTransitRouterCidrAllocation - 查詢CIDR位址區段的分配資訊

    文件中心

    Cloud Enterprise Network：ListTransitRouterCidrAllocation - 查詢CIDR位址區段的分配資訊

    更新時間：Aug 07, 2025

    調用ListTransitRouterCidrAllocation介面查詢CIDR位址區段的分配資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    cen:ListTransitRouterCidrAllocation

    get

    *TransitRouter

    acs:cen:*:{#accountId}:centransitrouter/{#centransitrouterId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ClientToken

    string

    否

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

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

    說明

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

    123e4567-e89b-12d3-a456-426****
    TransitRouterId

    string

    是

    轉寄路由器執行個體 ID。

    tr-p0w3x8c9em72a40nw****
    RegionId

    string

    是

    轉寄路由器執行個體所屬的地區 ID。

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

    cn-hangzhou
    TransitRouterCidrId

    string

    否

    轉寄路由器位址區段 ID。

    您可以通過調用 ListTransitRouterCidr 介面查詢轉寄路由器位址區段 ID。

    cidr-0zv0q9crqpntzz****
    CidrBlock

    string

    否

    轉寄路由器位址區段下已指派地址的網段。

    192.168.10.0/28
    Cidr

    string

    否

    轉寄路由器位址區段。

    192.168.10.0/24
    DedicatedOwnerId

    string

    否

    專用網段。

    僅取值：VPN，表示您要查詢系統保留的用於系統後台建立 VPN 串連的網段。

    VPN
    AttachmentId

    string

    否

    網路執行個體串連 ID。

    tr-attach-2nalp6yksc805w****
    AttachmentName

    string

    否

    網路執行個體串連的名稱。

    nametest
    DryRun

    boolean

    否

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

    • true：發送檢查請求，不會開始查詢轉寄路由器位址區段分配詳情。檢查項包括是否填寫了必需參數、請求格式、業務限制等。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼DryRunOperation。

    • false（預設值）：發送正常請求，通過檢查後直接查詢轉寄路由器位址區段分配詳情。

    false
    MaxResults

    integer

    否

    分批次查詢時每次顯示的條目數。

    • 如果您不指定 MaxResults 參數的值，則表示您不需要分批次查詢。調用該介面後返回參數 MaxResults 的值表示列表條目總數。

    • 如果您指定 MaxResults 參數的值，則表示您需要分批次查詢。取值範圍：1~100。建議指定 MaxResults 參數的值為 20。

      調用該介面後返回參數 MaxResults 的值表示當前查詢批次下列表條目的數量。

    20
    NextToken

    string

    否

    是否擁有下一次查詢的令牌（Token）。取值：

    • 第一次查詢和沒有下一次查詢時，均無需填寫。

    • 如果有下一次查詢，取值為上一次 API 呼叫返回的 NextToken 值。

    FFmyTO70tTpLG6I3FmYAXGKPd****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    NextToken

    string

    是否擁有下一次查詢的令牌（Token）。取值：

    • 如果 NextToken 為空白表示沒有下一次查詢。

    • 如果 NextToken 有傳回值，該取值表示下一次查詢開始的令牌。

    FFmyTO70tTpLG6I3FmYAXGKPd****
    RequestId

    string

    請求 ID。

    0876E54E-3E36-5C31-89F0-9EE8A9266F9A
    TotalCount

    integer

    列表條目數。

    1
    MaxResults

    integer

    分批次查詢時每次顯示的條目數。

    • 如果您未指定請求參數 MaxResults 的值，則表示您不需要分批次查詢。返回參數 MaxResults 的值表示列表條目總數。

    • 如果您指定了請求參數 MaxResults 的值，則表示您需要分批次查詢。返回參數 MaxResults 的值表示當前查詢批次下列表條目的數量。

    1
    TransitRouterCidrAllocations

    array<object>

    轉寄路由器位址區段分配詳情。

    object

    轉寄路由器位址區段分配詳情。

    TransitRouterCidrId

    string

    轉寄路由器位址區段 ID。

    cidr-0zv0q9crqpntzz****
    AllocatedCidrBlock

    string

    轉寄路由器位址區段下已指派地址的網段。

    192.168.10.0/28
    AttachmentId

    string

    網路執行個體串連 ID。

    tr-attach-2nalp6yksc805w****
    Cidr

    string

    轉寄路由器位址區段。

    192.168.10.0/24
    AttachmentName

    string

    網路執行個體串連的名稱。

    nametest

    樣本

    正常返回樣本

    JSON格式

    {
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "0876E54E-3E36-5C31-89F0-9EE8A9266F9A",
  "TotalCount": 1,
  "MaxResults": 1,
  "TransitRouterCidrAllocations": [
    {
      "TransitRouterCidrId": "cidr-0zv0q9crqpntzz****",
      "AllocatedCidrBlock": "192.168.10.0/28",
      "AttachmentId": "tr-attach-2nalp6yksc805w****",
      "Cidr": "192.168.10.0/24",
      "AttachmentName": "nametest"
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 IllegalParam.NextToken The parameter NextToken is invalid. 指定的NextToken無效。請檢查參數約束，並在修改後重試。
    400 IllegalParam.TransitRouterId The parameter TransitRouterId or RegionId is invalid. 參數TransitRouterId或RegionId無效。
    400 InvalidParameter Invalid parameter. 參數不合法。
    400 Unauthorized The AccessKeyId is unauthorized. 帳號無許可權操作。

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

    變更歷史

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