全部產品
Search

搜尋本產品

    Global Accelerator：DescribeAccelerator - 查詢指定的Global Acceleration執行個體資訊

    文件中心

    Global Accelerator：DescribeAccelerator - 查詢指定的Global Acceleration執行個體資訊

    更新時間：Jan 06, 2026

    調用DescribeAccelerator介面查詢指定的Global Acceleration執行個體資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ga:DescribeAccelerator

    get

    *Accelerator

    acs:ga:{#regionId}:{#accountId}:ga/{#acceleratorId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId deprecated

    string

    是

    Global Acceleration執行個體所屬的地區，僅取值：cn-hangzhou。

    cn-hangzhou
    AcceleratorId

    string

    是

    要查詢的Global Acceleration執行個體 ID。

    ga-bp1odcab8tmno0hdq****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回資訊列表。

    DdosId deprecated

    string

    與Global Acceleration執行個體綁定的 DDoS 高防執行個體 ID。

    ddoscoo-cn-zz11vq7j****
    DnsName

    string

    Global Acceleration執行個體分配的 CNAME 地址。

    ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com
    Description

    string

    Global Acceleration執行個體的描述資訊。

    Accelerator
    RequestId

    string

    請求 ID。

    6FEA0CF3-D3B9-43E5-A304-D217037876A8

    InstanceChargeType

    string

    Global Acceleration執行個體的計費方式。

    PREPAY
    CreateTime

    integer

    Global Acceleration執行個體建立時間的時間戳記。

    1650643200
    CrossDomainBandwidthPackage

    object

    Global Acceleration執行個體綁定的跨地區加速包的詳情。

    僅國際站支援返回該數組。

    Bandwidth

    integer

    跨地區加速包的頻寬值，單位：Mbps。

    2
    InstanceId

    string

    跨地區加速包的執行個體 ID。

    gbwp-bp1d8xk8bg139j0fw****
    SecondDnsName

    string

    Global Acceleration聯動 DDoS 高防執行個體的 CNAME。

    ga-bp1f609c76zg6zuna****-1.aliyunga0047.com
    Name

    string

    Global Acceleration執行個體的名稱。

    Accelerator
    BasicBandwidthPackage

    object

    Global Acceleration執行個體綁定的基礎頻寬包的詳情。

    Bandwidth

    integer

    基礎頻寬包的頻寬值。單位：Mbps。

    2
    BandwidthType

    string

    基礎頻寬包的頻寬類型。取值：

    • Basic：標準加速頻寬。

    • Enhanced：增強加速頻寬。

    • Advanced：精品加速頻寬。

    Basic
    InstanceId

    string

    基礎頻寬包的執行個體 ID。

    gbwp-bp1d8xk8bg139j0fw****
    State

    string

    Global Acceleration執行個體的狀態。取值：

    • init：初始化。

    • active：可用。

    • configuring：配置中。

    • binding：綁定中。

    • unbinding：解除綁定中。

    • deleting：刪除中。

    • finacialLocked：欠費鎖定。

    active
    ExpiredTime

    integer

    Global Acceleration執行個體到期時間的時間戳記。

    1653235200
    CenId

    string

    Global Acceleration執行個體綁定的雲企業網執行個體 ID。

    cen-hjkduu767hc****
    RegionId deprecated

    string

    Global Acceleration執行個體所在的地區。

    cn-hangzhou
    Spec

    string

    Global Acceleration執行個體的規格，取值：

    • 1：小型Ⅰ。

    • 2：小型Ⅱ。

    • 3：小型Ⅲ。

    • 5：中型Ⅰ。

    • 8：中型Ⅱ。

    • 10：中型Ⅲ。

    • 20：大型Ⅰ。

    • 30：大型Ⅱ。

    • 40：大型Ⅲ。

    • 50：大型 IV。

    • 60：大型 V。

    • 70：大型 VI。

    • 80：大型 VII。

    • 90：大型 VIII。

    • 100：超大型Ⅰ。

    • 200：超大型Ⅱ。

    說明

    目前，大型Ⅲ及以上規格僅白名單開放。如需使用，請聯絡阿里雲客戶經理。

    執行個體規格不同，定義也不同。更多資訊，請參見執行個體規格。

    1
    AcceleratorId

    string

    Global Acceleration執行個體 ID。

    ga-bp1odcab8tmno0hdq****
    BandwidthBillingType

    string

    頻寬計費方式。取值：

    • BandwidthPackage：按頻寬包計費。

    • CDT：按流量計費。

    CDT
    IpSetConfig

    object

    加速地區配置。

    AccessMode

    string

    加速地區接入模式。取值：

    • UserDefine：自訂就近接入模式。您可以根據業務需要，定向選擇加速地區和地區，Global Acceleration為每個加速地區提供獨立的 EIP。

    • Anycast：採用自動就近接入模式。您無需配置加速地區。Global Acceleration在全球多地區提供一個 Anycast EIP，使用者可通過 Anycast EIP 從就近存取點進入阿里雲加速網路。

    UserDefine
    CrossPrivateState

    string

    是否開啟了跨地區頻寬跨境。

    • true：是。

    • false：否。

    false
    ResourceGroupId

    string

    資源群組 ID。

    rg-acfmw2vwdbujqbq
    Tags

    array<object>

    資源標籤。

    object

    資源標籤。

    Key

    string

    標籤鍵。

    tag-key
    Value

    string

    標籤值。

    tag-value
    CrossBorderMode

    string

    用於頻寬計費方式為按流量計費（CDT）的執行個體，顯示其跨境加速類型，取值：

    bpgPro：精品頻寬跨境加速。

    bpgPro
    CrossBorderStatus

    boolean

    Global Acceleration執行個體是否開啟跨境線路功能。取值：

    • true：開啟跨境線路功能，可以加速跨境線路。

    • false：關閉跨境線路功能，不可以加速跨境線路。

    false
    UpgradableStatus

    string

    Global Acceleration執行個體的可升級狀態。取值：

    • notUpgradable：當前執行個體不需要升級。

    • upgradable：當前執行個體可升級至最新版本。

    • upgradeFailed：當前執行個體執行過升級操作且升級失敗。

    notUpgradable
    ServiceId

    string

    受管理的執行個體所屬的服務方 ID。

    說明

    僅在 ServiceManaged 參數為 True 時有效。

    ALB
    ServiceManaged

    boolean

    是否為受管理的執行個體。取值：

    • true：是受管理的執行個體。

    • false：不是受管理的執行個體。

    true
    ServiceManagedInfos

    array<object>

    使用者在此受管理的執行個體下可執行檔動作策略列表。

    說明

    • 僅在 ServiceManaged 參數為 True 時有效。

    • 當執行個體處於託管狀態時，使用者對執行個體的操作會受到限制，某些操作行為會被禁止。

    object

    使用者在此受管理的執行個體下可執行檔動作策略列表。

    Action

    string

    託管策略動作名稱，取值：

    • Create：建立執行個體。

    • Update：更新當前執行個體。

    • Delete：刪除當前執行個體。

    • Associate：引用/被引用當前執行個體。

    • UserUnmanaged：使用者解受管理的執行個體。

    • CreateChild：在當前執行個體下建立子資源。

    Update
    ChildType

    string

    子資源類型，取值：

    • Listener：監聽資源。

    • IpSet：加速地區資源。

    • EndpointGroup：終端節點群組資源。

    • ForwardingRule：轉寄策略資源。

    • Endpoint：終端節點資源。

    • EndpointGroupDestination：自訂路由監聽下的終端節點群組協議映射資源。

    • EndpointPolicy：自訂路由監聽下的終端節點通行策略資源。

    說明

    僅在 Action 參數為 CreateChild 時有效。

    Listener
    IsManaged

    boolean

    託管策略動作是否被託管，取值：

    • true：託管策略動作被託管，使用者無權在受管理的執行個體下執行 Action 指定的操作。

    • false：託管策略動作未被託管，使用者可在受管理的執行個體下執行 Action 指定的操作。

    false
    DdosConfigList

    array<object>

    與Global Acceleration執行個體綁定的 DDoS 高防執行個體列表。

    object

    DdosId

    string

    與Global Acceleration執行個體綁定的 DDoS 高防執行個體 ID。

    ddoscoo-cn-zz11vq7j****
    DdosRegionId

    string

    DDoS 高防執行個體所在的地區，取值：

    • cn-hangzhou：中國內地。

    • ap-southeast-1：非中國內地。

    ap-southeast-1
    Bandwidth

    integer

    標準型Global Acceleration執行個體頻寬。單位：Mbps。

    說明

    僅加速地區接入模式為 Anycast 時有效。

    200

    樣本

    正常返回樣本

    JSON格式

    {
  "DdosId": "ddoscoo-cn-zz11vq7j****",
  "DnsName": "ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com",
  "Description": "Accelerator",
  "RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8\t",
  "InstanceChargeType": "PREPAY",
  "CreateTime": 1650643200,
  "CrossDomainBandwidthPackage": {
    "Bandwidth": 2,
    "InstanceId": "gbwp-bp1d8xk8bg139j0fw****"
  },
  "SecondDnsName": "ga-bp1f609c76zg6zuna****-1.aliyunga0047.com",
  "Name": "Accelerator",
  "BasicBandwidthPackage": {
    "Bandwidth": 2,
    "BandwidthType": "Basic",
    "InstanceId": "gbwp-bp1d8xk8bg139j0fw****"
  },
  "State": "active",
  "ExpiredTime": 1653235200,
  "CenId": "cen-hjkduu767hc****",
  "RegionId": "cn-hangzhou",
  "Spec": "1",
  "AcceleratorId": "ga-bp1odcab8tmno0hdq****",
  "BandwidthBillingType": "CDT",
  "IpSetConfig": {
    "AccessMode": "UserDefine"
  },
  "CrossPrivateState": "false",
  "ResourceGroupId": "rg-acfmw2vwdbujqbq",
  "Tags": [
    {
      "Key": "tag-key",
      "Value": "tag-value"
    }
  ],
  "CrossBorderMode": "bpgPro",
  "CrossBorderStatus": false,
  "UpgradableStatus": "notUpgradable",
  "ServiceId": "ALB",
  "ServiceManaged": true,
  "ServiceManagedInfos": [
    {
      "Action": "Update",
      "ChildType": "Listener",
      "IsManaged": false
    }
  ],
  "DdosConfigList": [
    {
      "DdosId": "ddoscoo-cn-zz11vq7j****",
      "DdosRegionId": "ap-southeast-1"
    }
  ],
  "Bandwidth": 200
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    500 UnknownError An error occurred while processing your request. Please try again. If the error persists, please submit a ticket. 處理請求時出現錯誤，請稍後重試。

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

    變更歷史

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