AllocateIpv6InternetBandwidth - Virtual Private Cloud - Alibaba Cloud Documentation Center

Memanggil operasi AllocateIpv6InternetBandwidth untuk mengaktifkan bandwidth Internet untuk alamat IPv6 di VPC, sehingga memberikan kemampuan komunikasi jaringan publik. Setelah diaktifkan, alamat IPv6 dapat memulai akses arah keluar ke Internet dan dapat diakses dari Internet.

Deskripsi operasi

Anda dapat mengalokasikan bandwidth Internet ke jenis alamat IPv6 berikut:
- Alamat IPv6 yang ditetapkan ke antarmuka jaringan elastis (ENI) Instance ECS.
- Alamat IPv6 yang tidak terasosiasi dan tidak terpasang pada instans Sumber daya apa pun.
Sebelum memanggil operasi ini, pastikan alamat IPv6 target sudah ada. Artinya, Instance ECS di VPC telah ditetapkan alamat IPv6, atau alamat IPv6 yang tidak terasosiasi telah dibuat dengan memanggil AllocateIpv6Address.
Setelah alokasi, alamat IPv6 dapat memulai koneksi keluar ke Internet dan menerima arah masuk dari Internet. Untuk mengizinkan akses jaringan publik ke Internet, panggil CreateIpv6EgressOnlyRule untuk mengonfigurasi aturan egress-only IPv6.
Operasi AllocateIpv6InternetBandwidth tidak mendukung pembelian bandwidth Internet secara bersamaan untuk alamat IPv6 yang sama.
Skenario:
- Akses publik IPv6 untuk Instance ECS: Memungkinkan Instance ECS mengakses Internet atau menyediakan layanan melalui IPv6.
- Akses publik untuk alamat IPv6 yang tidak terasosiasi: Bekerja dengan tabel rute gerbang IPv6 untuk entri rute Lalu lintas internet ke IDC on-premises.
- Komunikasi egress-only: Bekerja dengan CreateIpv6EgressOnlyRule untuk mengizinkan akses jaringan publik dan menolak koneksi masuk dari Internet.

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

vpc:AllocateIpv6InternetBandwidth

create

*Ipv6InternetBandwidth

acs:vpc:{#regionId}:{#accountId}:ipv6bandwidth/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah gerbang IPv6. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-huhehaote
Ipv6GatewayId	string	No	ID gerbang IPv6.	ipv6gw-uf6hcyzu65v98v3du****
Ipv6AddressId	string	Yes	ID alamat IPv6.	ipv6-2zen5j4axcp5l5qyy****
InternetChargeType	string	No	Metode penagihan untuk bandwidth Internet IPv6. Nilai valid: PayByTraffic: bayar berdasarkan transfer data. PayByBandwidth (default): bayar berdasarkan bandwidth. .	PayByBandwidth
Bandwidth	integer	Yes	Bandwidth Internet alamat IPv6. Unit: Mbit/s. Jika InternetChargeType diatur ke PayByTraffic, rentang nilai bandwidth Internet adalah 1 hingga 1000. Jika InternetChargeType diatur ke PayByBandwidth, rentang nilai bandwidth Internet adalah 1 hingga 2000. .	200
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya dapat berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	No	Apakah akan menjalankan dry run. Nilai valid: true: mengirim permintaan pemeriksaan tanpa mengasosiasikan daftar awalan dengan tabel rute. Sistem memeriksa permintaan untuk potensi masalah, termasuk pasangan AccessKey yang tidak valid, status otorisasi pengguna RAM, dan parameter wajib yang hilang. Jika permintaan gagal dalam dry run, Paket error yang sesuai akan dikembalikan. Jika permintaan lulus dry run, kode kesalahan `DryRunOperation` akan dikembalikan. false (default): mengirim permintaan normal. Setelah permintaan lulus pemeriksaan, kode status HTTP 2xx akan dikembalikan dan sistem mengasosiasikan daftar awalan dengan tabel rute.	false
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya dapat berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	123e4567-e89b-12d3-a456-426655440000
RegionId	string	Yes	ID wilayah gerbang IPv6. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-huhehaote

Elemen respons

Element	Type	Description	Example
	object
Ipv6AddressId	string	ID alamat IPv6.	ipv6-2zen5j4axcp5l5qyy****
RequestId	string	ID permintaan.	6972A26E-99B1-4367-9890-FBDEBB0F5E7D
InternetBandwidthId	string	ID instans bandwidth Internet yang diasosiasikan dengan gerbang IPv6 setelah mengalokasikan bandwidth Internet.	ipv6bw-uf6hcyzu65v98v3du****

Contoh

Respons sukses

JSONformat

{
  "Ipv6AddressId": "ipv6-2zen5j4axcp5l5qyy****",
  "RequestId": "6972A26E-99B1-4367-9890-FBDEBB0F5E7D",
  "InternetBandwidthId": "ipv6bw-uf6hcyzu65v98v3du****"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	IllegalParam.Bandwidth	The param of %s is illegal.
400	MissingParam.Ipv6InstanceId	The param of Ipv6InstanceId is missing.
400	InvalidIpv6Instance.NotFound	The specified Ipv6AddressId or Ipv6InternetBandwidthId is not found.
400	IllegalParam.ChargeType	The param of %s is illegal.
400	IllegalParam.InternetChargeType	The param of %s is illegal.
400	OperationUnsupported.PrePaid	%s is unsupported.
400	OperationFailed.Ipv6GatewayDisMatchIpv6Address	The operation is failed because of %s.
400	OperationFailed.InternetBandwidthAlreadyExisted	The operation is failed because of %s.
400	OperationFailed.Ipv6GatewayNotExist	The operation is failed because of %s.
400	IncorrectStatus.Ipv6Instance	The status of %s [%s] is incorrect.
400	IllegalParam.Ipv6Address	The param of %s is illegal.
400	UnsupportedFeature.InternetChargeTypeOnFreeIpv6Address	The feature of %s is not supported.
400	UnsupportedFeature.InternetChargeTypeOnStaticIsp	The feature of %s is not supported.
400	OperationUnsupported.ULA	%s is unsupported.
400	OperationFailed.OpenCdtServiceFirst	The operation is failed because of %s.
400	OperationFailed.UpgradeCdtServiceFirst	The operation is failed because of cdt is not upgraded.
400	OperationUnsupported.PrivateGUA	This operation does not support private GUA addresses.
400	OperationDenied.UnSupportedBindTypeCloudInstance	Internet bandwidth cannot be allocated to the IPv6 address bound to the cloud service instance.
500	OperationFailed.QueryAccountInfo	Query account info failed when create order.
500	OperationFailed.SaleValidate	Validate sale condition with subArticle failed.
500	SystemBusy	The system is busy. Please try again later.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.
404	ResourceNotFound.Ipv6Address	The specified resource of %s is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.