全部产品
Search
文档中心

Global Accelerator:DescribeAccelerator

更新时间:Jan 06, 2026

Anda dapat memanggil operasi DescribeAccelerator untuk mengkueri informasi mengenai instans Global Accelerator tertentu.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ga:DescribeAccelerator

get

*Accelerator

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId deprecated

string

Yes

Wilayah tempat instans Global Accelerator dideploy. Tetapkan nilainya ke cn-hangzhou.

cn-hangzhou

AcceleratorId

string

Yes

ID instans Global Accelerator yang ingin Anda kueri.

ga-bp1odcab8tmno0hdq****

Elemen respons

Element

Type

Description

Example

object

Informasi yang dikembalikan.

DdosId deprecated

string

ID instans Anti-DDoS yang terkait dengan instans Global Accelerator.

ddoscoo-cn-zz11vq7j****

DnsName

string

Nama kanonik (CNAME) yang ditetapkan untuk instans Global Accelerator.

ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com

Description

string

Deskripsi instans Global Accelerator.

Accelerator

RequestId

string

ID permintaan.

6FEA0CF3-D3B9-43E5-A304-D217037876A8

InstanceChargeType

string

Metode penagihan instans Global Accelerator.

PREPAY

CreateTime

integer

Timestamp yang menunjukkan kapan instans Global Accelerator dibuat.

1650643200

CrossDomainBandwidthPackage

object

Detail paket bandwidth cross-region yang terkait dengan instans Global Accelerator.

Parameter ini hanya dikembalikan oleh Alibaba Cloud International Website (www.alibabacloud.com).

Bandwidth

integer

Bandwidth dari paket bandwidth cross-region. Satuan: Mbps.

2

InstanceId

string

ID paket bandwidth cross-region.

gbwp-bp1d8xk8bg139j0fw****

SecondDnsName

string

CNAME instans Anti-DDoS yang terkait dengan instans Global Accelerator.

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

Name

string

Nama instans Global Accelerator.

Accelerator

BasicBandwidthPackage

object

Detail paket bandwidth dasar yang terkait dengan instans Global Accelerator.

Bandwidth

integer

Bandwidth dari paket bandwidth dasar. Satuan: Mbps.

2

BandwidthType

string

Tipe bandwidth dari paket bandwidth dasar. Nilai yang valid:

  • Basic: bandwidth akselerasi standar.

  • Enhanced: bandwidth akselerasi enhanced.

  • Advanced: bandwidth akselerasi premium.

Basic

InstanceId

string

ID paket bandwidth dasar.

gbwp-bp1d8xk8bg139j0fw****

State

string

Status instans Global Accelerator. Nilai yang valid:

  • init: Instans sedang diinisialisasi.

  • active: Instans tersedia.

  • configuring: Instans sedang dikonfigurasi.

  • binding: Instans sedang diasosiasikan.

  • unbinding: Instans sedang diputus asosiasinya.

  • deleting: Instans sedang dihapus.

  • finacialLocked: Instans terkunci secara finansial.

active

ExpiredTime

integer

Timestamp yang menunjukkan kapan instans Global Accelerator kedaluwarsa.

1653235200

CenId

string

ID instans Cloud Enterprise Network (CEN) yang terkait dengan instans Global Accelerator.

cen-hjkduu767hc****

RegionId deprecated

string

Wilayah tempat instans Global Accelerator dideploy.

cn-hangzhou

Spec

string

Spesifikasi instans Global Accelerator. Nilai yang valid:

  • 1: Small I.

  • 2: Small II.

  • 3: Small III.

  • 5: Medium I.

  • 8: Medium II.

  • 10: Medium III.

  • 20: Large I.

  • 30: Large II.

  • 40: Large III.

  • 50: Large IV.

  • 60: Large V.

  • 70: Large VI.

  • 80: Large VII.

  • 90: Large VIII.

  • 100: Super Large I.

  • 200: Super Large II.

Catatan

Spesifikasi Large III dan yang lebih tinggi hanya tersedia untuk pengguna dalam daftar putih. Untuk menggunakan spesifikasi ini, hubungi account manager Anda.

Definisi spesifikasi berbeda-beda. Untuk informasi selengkapnya, lihat Instance specifications.

1

AcceleratorId

string

ID instans Global Accelerator.

ga-bp1odcab8tmno0hdq****

BandwidthBillingType

string

Metode penagihan bandwidth. Nilai yang valid:

  • BandwidthPackage: bayar-per-paket-bandwidth.

  • CDT: bayar-berdasarkan-transfer-data.

CDT

IpSetConfig

object

Konfigurasi area percepatan.

AccessMode

string

Mode akses area percepatan. Nilai yang valid:

  • UserDefine: kustom. Anda dapat memilih area percepatan dan wilayah sesuai kebutuhan bisnis Anda. Global Accelerator menyediakan alamat EIP (elastic IP address) terpisah untuk setiap wilayah akselerasi.

  • Anycast: otomatis. Anda tidak perlu mengonfigurasi area percepatan. Global Accelerator menyediakan EIP Anycast untuk beberapa wilayah. Pengguna dapat terhubung ke titik akses terdekat dari jaringan Alibaba Cloud menggunakan EIP Anycast.

UserDefine

CrossPrivateState

string

Menunjukkan apakah bandwidth lintas batas diaktifkan.

  • true: diaktifkan.

  • false: dinonaktifkan.

false

ResourceGroupId

string

ID kelompok sumber daya.

rg-acfmw2vwdbujqbq

Tags

array<object>

Tag resource.

object

Tag resource.

Key

string

Kunci tag.

tag-key

Value

string

Nilai tag.

tag-value

CrossBorderMode

string

Jenis akselerasi lintas batas. Parameter ini dikembalikan untuk instans bayar-berdasarkan-transfer-data.

bpgPro: bandwidth premium untuk akselerasi lintas batas.

bpgPro

CrossBorderStatus

boolean

Menunjukkan apakah fitur jalur lintas batas diaktifkan untuk instans Global Accelerator. Nilai yang valid:

  • true: Fitur jalur lintas batas diaktifkan. Anda dapat menggunakan Global Accelerator untuk mempercepat transmisi data lintas batas.

  • false: Fitur jalur lintas batas dinonaktifkan. Anda tidak dapat menggunakan Global Accelerator untuk mempercepat transmisi data lintas batas.

false

UpgradableStatus

string

Status peningkatan instans Global Accelerator. Nilai yang valid:

  • notUpgradable: Instans tidak perlu ditingkatkan.

  • upgradable: Instans dapat ditingkatkan.

  • upgradeFailed: Instans gagal ditingkatkan.

notUpgradable

ServiceId

string

ID layanan yang mengelola instans.

Catatan

Parameter ini hanya berlaku ketika ServiceManaged diatur ke True.

ALB

ServiceManaged

boolean

Menunjukkan apakah instans tersebut merupakan instans terkelola. Nilai yang valid:

  • true: Instans merupakan instans terkelola.

  • false: Instans bukan instans terkelola.

true

ServiceManagedInfos

array<object>

Aksi yang dapat Anda lakukan pada instans terkelola.

Catatan
  • Parameter ini hanya berlaku ketika ServiceManaged diatur ke True.

  • Ketika instans dikelola, Anda tidak dapat melakukan beberapa operasi pada instans tersebut.

object

Aksi yang dapat Anda lakukan pada instans terkelola.

Action

string

Nama aksi pada instans terkelola. Nilai yang valid:

  • Create: membuat instans.

  • Update: memperbarui instans saat ini.

  • Delete: menghapus instans saat ini.

  • Associate: mengasosiasikan instans dengan resource lain.

  • UserUnmanaged: membatalkan pengelolaan instans.

  • CreateChild: membuat resource anak dalam instans.

Update

ChildType

string

Jenis resource anak. Nilai yang valid:

  • Listener: listener.

  • IpSet: wilayah akselerasi.

  • EndpointGroup: kelompok titik akhir.

  • ForwardingRule: aturan pengalihan.

  • Endpoint: titik akhir.

  • EndpointGroupDestination: pemetaan protokol dari kelompok titik akhir yang terkait dengan listener routing kustom.

  • EndpointPolicy: kebijakan akses dari titik akhir yang terkait dengan listener routing kustom.

Catatan

Parameter ini hanya berlaku ketika Action diatur ke CreateChild.

Listener

IsManaged

boolean

Menunjukkan apakah aksi yang ditentukan dikelola. Nilai yang valid:

  • true: Aksi dikelola. Anda tidak dapat melakukan aksi yang ditentukan pada instans terkelola.

  • false: Aksi tidak dikelola. Anda dapat melakukan aksi yang ditentukan pada instans terkelola.

false

DdosConfigList

array<object>

Daftar instans Anti-DDoS yang terkait dengan instans Global Accelerator.

object

DdosId

string

ID instans Anti-DDoS yang terkait dengan instans Global Accelerator.

ddoscoo-cn-zz11vq7j****

DdosRegionId

string

Wilayah tempat instans Anti-DDoS dideploy. Nilai yang valid:

  • cn-hangzhou: Daratan Tiongkok.

  • ap-southeast-1: Luar daratan Tiongkok.

ap-southeast-1

Bandwidth

integer

Bandwidth dari instans Global Accelerator standar. Satuan: Mbps.

Catatan

Parameter ini hanya berlaku ketika mode akses area percepatan adalah Anycast.

200

Contoh

Respons sukses

JSONformat

{
  "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
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

500 UnknownError An error occurred while processing your request. Please try again. If the error persists, please submit a ticket.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.