全部产品
Search
文档中心

Global Accelerator:DescribeAccelerator

更新时间:Dec 14, 2025

Mengambil detail 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

string

Yes

ID wilayah instans Global Accelerator. Tetapkan nilainya ke cn-hangzhou.

cn-hangzhou

AcceleratorId

string

Yes

ID instans Global Accelerator yang ingin Anda tanyakan.

ga-bp1odcab8tmno0hdq****

Elemen respons

Element

Type

Description

Example

object

Daftar informasi yang dikembalikan.

DdosId deprecated

string

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

ddoscoo-cn-zz11vq7j****

DnsName

string

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 akselerasi cross-region yang terkait dengan instans Global Accelerator.

Array ini hanya dikembalikan untuk akun di situs internasional (alibabacloud.com).

Bandwidth

integer

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

2

InstanceId

string

ID paket bandwidth akselerasi 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 paket bandwidth dasar. Satuan: Mbps.

2

BandwidthType

string

Tipe bandwidth. Nilai yang valid:

  • Basic: bandwidth akselerasi standar.

  • Enhanced: bandwidth akselerasi ditingkatkan.

  • 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 dikaitkan.

  • unbinding: Instans sedang diputuskan kaitannya.

  • deleting: Instans sedang dihapus.

  • finacialLocked: Instans dikunci karena pembayaran tertunda.

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

string

ID wilayah instans Global Accelerator.

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 manajer akun Anda.

Spesifikasi instans yang berbeda memiliki definisi yang berbeda. Untuk informasi selengkapnya, lihat Instance types.

1

AcceleratorId

string

ID instans Global Accelerator.

ga-bp1odcab8tmno0hdq****

BandwidthBillingType

string

Metode penagihan bandwidth. Nilai yang valid:

  • BandwidthPackage: ditagih berdasarkan paket bandwidth.

  • CDT: bayar-berdasarkan-transfer-data.

CDT

IpSetConfig

object

Konfigurasi area percepatan.

AccessMode

string

Mode akses area percepatan. Nilai yang valid:

  • UserDefine: mode akses terdekat kustom. Anda dapat memilih area percepatan dan wilayah sesuai kebutuhan. Global Accelerator menyediakan alamat IP elastis (EIP) independen untuk setiap wilayah akselerasi.

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

UserDefine

CrossPrivateState

string

Menunjukkan apakah transfer data 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 yang ditagih berdasarkan transfer data.

bpgPro: akselerasi lintas batas premium.

bpgPro

CrossBorderStatus

boolean

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

  • true: Fitur jalur lintas batas diaktifkan. Jalur lintas batas dapat dipercepat.

  • false: Fitur jalur lintas batas dinonaktifkan. Jalur lintas batas tidak dapat dipercepat.

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>

Daftar kebijakan aksi yang dapat Anda lakukan pada instans terkelola.

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

  • Ketika suatu instans dikelola, izin Anda untuk melakukan operasi pada instans tersebut dibatasi. Beberapa operasi dilarang.

object

Daftar kebijakan aksi yang dapat Anda lakukan pada instans terkelola.

Action

string

Aksi yang dilakukan pada instans terkelola. Nilai yang valid:

  • Create: Buat instans.

  • Update: Perbarui instans saat ini.

  • Delete: Hapus instans saat ini.

  • Associate: Kaitkan atau referensikan instans.

  • UserUnmanaged: Batalkan pengelolaan instans.

  • CreateChild: Buat 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 untuk kelompok titik akhir listener routing kustom.

  • EndpointPolicy: kebijakan traffic untuk titik akhir 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 ditempatkan. Nilai yang valid:

  • cn-hangzhou: Daratan Tiongkok.

  • ap-southeast-1: Luar daratan Tiongkok.

ap-southeast-1

Bandwidth

integer

Bandwidth 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. An error occurred while the request was being processed. Try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.