DescribeBandwidthLimitation - Elastic Compute Service - Alibaba Cloud Documentation Center

Memanggil DescribeBandwidthLimitation untuk mengkueri bandwidth publik maksimum yang dapat dibeli, ditingkatkan, atau diturunkan spesifikasinya untuk berbagai tipe instans.

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

ecs:DescribeBandwidthLimitation

get

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah target. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
InstanceChargeType	string	No	Metode penagihan instans. Untuk informasi selengkapnya, lihat Ikhtisar penagihan. Nilai valid: PrePaid: langganan. PostPaid: bayar sesuai pemakaian. Nilai default: PostPaid.	PostPaid
SpotStrategy	string	No	Strategi penawaran untuk instans bayar sesuai pemakaian. Nilai valid: NoSpot: instans bayar sesuai pemakaian reguler. SpotWithPriceLimit: instans preemptible dengan harga maksimum per jam yang ditentukan pengguna. SpotAsPriceGo: instans preemptible dengan harga sesuai harga pasar pada saat pembelian. Nilai default: NoSpot. Catatan Parameter SpotStrategy hanya berlaku jika parameter InstanceChargeType diatur ke PostPaid.	NoSpot
InstanceType	string	Yes	Tipe instans. Untuk informasi selengkapnya, lihat Keluarga instans.	ecs.g5.large
ResourceId	string	No	ID resource. Catatan Saat Anda mengatur parameter OperationType ke Upgrade atau Downgrade, parameter ResourceId wajib diisi.	i-bp67acfmxazb4ph***
OperationType	string	No	Tipe operasi untuk mengkueri batas bandwidth publik. Nilai valid: Upgrade: Meningkatkan bandwidth publik. Downgrade: Menurunkan spesifikasi bandwidth publik. Create: Membuat instans ECS. Nilai default: Create.	Upgrade

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
Bandwidths	object
Bandwidth	array<object>	Kumpulan informasi bandwidth publik maksimum.
	object	Kumpulan informasi bandwidth publik maksimum.
InternetChargeType	string	Metode penagihan bandwidth publik. Nilai valid: PayByBandwidth: bayar berdasarkan bandwidth. PayByTraffic: bayar berdasarkan trafik.	PayByTraffic
Max	integer	Bandwidth publik maksimum.	100
Min	integer	Bandwidth publik minimum.	0
Unit	string	Unit bandwidth publik.	Mbps

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "Bandwidths": {
    "Bandwidth": [
      {
        "InternetChargeType": "PayByTraffic",
        "Max": 100,
        "Min": 0,
        "Unit": "Mbps"
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	指定的参数 InstanceChargeType 无效。
400	InvalidParam	The input parameter DestinationResource that is mandatory for processing this request is not supplied.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType beyond the permitted range.	指定的实例规格不合法（超出可选范围）。
400	InvalidInstanceId.NotFound	The specified ecs instance not found.
404	Invalid.ResourceType.NotFound	The ResourceType provided does not exist in our records.
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	指定的参数 NetworkCategory 无效。
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	竞价策略参数无效。
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	指定的参数 IoOptimized 无效。
404	Invalid.ResourceId	The specified ResourceId is not valid.	指定的参数 ResourceId 无效。
404	Invalid.InstancePayType	The specified InstancePayType is not valid.	指定的参数 InstanceChargeType 无效。
404	Invalid.OperationType	The specified OperationType is not valid.	指定的参数OperationType无效。

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.