全部產品
Search
文件中心

Global Accelerator:GetBasicIpSet - 查詢指定基礎型Global Acceleration執行個體的加速地區資訊

更新時間:Dec 14, 2025

調用GetBasicIpSet介面查詢指定基礎型Global Acceleration執行個體的加速地區資訊。

調試

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

調試

授權資訊

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

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

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ga:GetBasicIpSet

get

*BasicIpSet

acs:ga:{#regionId}:{#accountId}:ipset/{#BasicIpSetId}

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

基礎型Global Acceleration執行個體所在的地區 ID,僅取值cn-hangzhou

cn-hangzhou

ClientToken

string

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

由用戶端產生該參數值,要保證在不同請求間唯一,最大值不超過 64 個 ASCII 字元。

說明

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

123e4567-e89b-12d3-a456-426655440000

IpSetId

string

基礎型Global Acceleration執行個體的加速地區執行個體 ID。

您可以調用 GetBasicAccelerator 查詢加速地區執行個體 ID。

ips-bp11r5jb8ogp122xl****

返回參數

名稱

類型

描述

樣本值

object

返回資訊列表。

RequestId

string

請求 ID。

6D2BFF54-6AF2-4679-88C4-2F2E187F16CB

AccelerateRegionId

string

基礎型Global Acceleration執行個體的加速地區 ID。

cn-hangzhou

Bandwidth

integer

基礎型Global Acceleration執行個體的加速地區頻寬。單位:Mbps。

2

IpSetId

string

基礎型Global Acceleration執行個體的加速地區執行個體 ID。

ips-bp11ilwqjdkjeg9r7****

IpAddress

string

加速 IP。

118.31.XX.XX

AcceleratorId

string

基礎型Global Acceleration執行個體 ID。

ga-bp17frjjh0udz4qz****

IpVersion

string

加速 IP 位址協議版本。取值:IPv4

IPv4

State

string

基礎型Global Acceleration執行個體的加速地區狀態。取值:

  • init:初始化。

  • active:運行中。

  • updating:配置中。

  • deleting:刪除中。

active

IspType

string

加速地區公網線路類型。取值:

  • BGP(預設值):BGP(多線)線路

  • BGP_PRO:BGP(多線)_精品線路

如果您是單線頻寬的白名單使用者,您還可能返回以下類型:

  • ChinaTelecom:中國電信(單線)

  • ChinaUnicom:中國聯通(單線)

  • ChinaMobile:中國移動(單線)

  • ChinaTelecom_L2:中國電信(單線)_L2

  • ChinaUnicom_L2:中國聯通(單線)_L2

  • ChinaMobile_L2:中國移動(單線)_L2

BGP

樣本

正常返回樣本

JSON格式

{
  "RequestId": "6D2BFF54-6AF2-4679-88C4-2F2E187F16CB",
  "AccelerateRegionId": "cn-hangzhou",
  "Bandwidth": 2,
  "IpSetId": "ips-bp11ilwqjdkjeg9r7****",
  "IpAddress": "118.31.XX.XX",
  "AcceleratorId": "ga-bp17frjjh0udz4qz****",
  "IpVersion": "IPv4",
  "State": "active",
  "IspType": "BGP"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情