AllocateIpv6InternetBandwidth - Virtual Private Cloud - Alibaba Cloud Documentation Center

Mengaktifkan bandwidth Internet untuk alamat IPv6 di VPC agar alamat IPv6 dapat berkomunikasi melalui Internet. Setelah bandwidth Internet diaktifkan, alamat IPv6 dapat memulai koneksi arah keluar ke Internet dan menerima koneksi arah masuk dari Internet.

Deskripsi operasi

Anda dapat mengaktifkan bandwidth Internet untuk dua jenis alamat IPv6 berikut:
- Alamat IPv6 yang ditetapkan ke antarmuka jaringan elastis (ENI) dari Instance ECS.
- Alamat IPv6 idle yang tidak terkait dengan 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 idle telah dibuat dengan memanggil AllocateIpv6Address.
Setelah bandwidth Internet diaktifkan, alamat IPv6 dapat memulai koneksi arah keluar ke Internet dan menerima koneksi 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 Internet IPv6 untuk Instance ECS: Memungkinkan Instance ECS mengakses Internet atau menyediakan layanan melalui IPv6.
- Akses Internet untuk alamat IPv6 idle: Bekerja dengan tabel entri rute gerbang IPv6 untuk merutekan Lalu lintas internet ke IDC on-premises.
- Komunikasi hanya arah keluar: Bekerja dengan CreateIpv6EgressOnlyRule untuk mengizinkan akses jaringan publik dan menolak koneksi arah 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, nilai valid adalah 1 hingga 1000. Jika InternetChargeType diatur ke PayByBandwidth, nilai valid adalah 1 hingga 2000.	200
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Buat nilai parameter dari klien Anda untuk memastikan keunikan di berbagai permintaan. ClientToken hanya mendukung karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem akan 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: menjalankan dry run tanpa mengaitkan daftar awalan dengan tabel entri rute. Sistem memeriksa Pasangan Kunci Akses, otorisasi pengguna Resource Access Management (RAM), dan parameter yang diperlukan. Jika pemeriksaan gagal, kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan `DryRunOperation` akan dikembalikan. false (default): mengirimkan permintaan normal. Jika pemeriksaan berhasil, kode status HTTP 2xx akan dikembalikan dan daftar awalan dikaitkan dengan tabel entri rute.	false

Elemen respons

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

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	IllegalParam.Bandwidth	The param of %s is illegal.	Nilai bandwidth yang ditentukan tidak valid.
400	MissingParam.Ipv6InstanceId	The param of Ipv6InstanceId is missing.	Parameter Ipv6InstanceId tidak ditentukan.
400	InvalidIpv6Instance.NotFound	The specified Ipv6AddressId or Ipv6InternetBandwidthId is not found.
400	IllegalParam.ChargeType	The param of %s is illegal.	ChargeType yang ditentukan tidak valid. Lihat deskripsi data deret waktu di referensi API, ubah parameter, lalu coba lagi.
400	IllegalParam.InternetChargeType	The param of %s is illegal.	InternetChargeType yang ditentukan tidak valid. Lihat deskripsi data deret waktu di referensi API, ubah parameter, lalu coba lagi.
400	OperationUnsupported.PrePaid	%s is unsupported.	Bandwidth Internet IPv6 tidak mendukung penagihan langganan. Lihat deskripsi data deret waktu di referensi API, ubah parameter, lalu coba lagi.
400	OperationFailed.Ipv6GatewayDisMatchIpv6Address	The operation is failed because of %s.	Alamat IPv6 dan gerbang IPv6 yang ditentukan tidak berada di VPC yang sama. Periksa apakah input Anda benar.
400	OperationFailed.InternetBandwidthAlreadyExisted	The operation is failed because of %s.	Instans IPv6 saat ini sudah mengaktifkan bandwidth Internet. Jangan aktifkan lagi.
400	OperationFailed.Ipv6GatewayNotExist	The operation is failed because of %s.	Tidak ada instans gerbang IPv6 di VPC tempat alamat IPv6 saat ini berada. Buat gerbang IPv6 sebelum melakukan operasi ini.
400	IncorrectStatus.Ipv6Instance	The status of %s [%s] is incorrect.	Instans IPv6 yang ditentukan sedang dalam status transien. Coba lagi nanti.
400	IllegalParam.Ipv6Address	The param of %s is illegal.	Alamat IPv6 tidak valid.
400	UnsupportedFeature.InternetChargeTypeOnFreeIpv6Address	The feature of %s is not supported.	Instans IPv6 saat ini berada dalam status detached dan tidak mendukung tipe penagihan yang ditentukan. Lihat deskripsi data deret waktu di referensi API, ubah parameter, lalu coba lagi.
400	UnsupportedFeature.InternetChargeTypeOnStaticIsp	The feature of %s is not supported.	Instans IPv6 saat ini adalah instans single-ISP dan tidak mendukung tipe penagihan yang ditentukan. Lihat deskripsi data deret waktu di referensi API, ubah parameter, lalu coba lagi.
400	OperationUnsupported.ULA	%s is unsupported.	Operasi saat ini tidak mendukung alamat ULA.
400	OperationFailed.OpenCdtServiceFirst	The operation is failed because of %s.	Tipe penagihan yang ditentukan memerlukan aktivasi Cloud Data Transfer (CDT). Aktifkan CDT dan coba lagi.
400	OperationFailed.UpgradeCdtServiceFirst	The operation is failed because of cdt is not upgraded.	Tipe instans yang Anda tentukan memerlukan peningkatan ke penagihan Cloud Data Transfer (CDT). Tingkatkan CDT lalu coba lagi.
400	OperationUnsupported.PrivateGUA	This operation does not support private GUA addresses.	Operasi saat ini tidak mendukung alamat Global Unicast Address (GUA) privat.
400	OperationDenied.UnSupportedBindTypeCloudInstance	Internet bandwidth cannot be allocated to the IPv6 address bound to the cloud service instance.	Bandwidth Internet tidak dapat diaktifkan untuk alamat IPv6 yang menyambungkan ke instans layanan cloud.
404	ResourceNotFound.Ipv6Address	The specified resource of %s is not found.	Alamat IPv6 yang ditentukan tidak ada. Periksa apakah input Anda benar.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.