AllocateIpv6Address - Virtual Private Cloud - Alibaba Cloud Documentation Center

Memanggil operasi AllocateIpv6Address untuk mengalokasikan alamat IPv6 gratis atau Blok CIDR awalan IPv6. Alamat ini tidak dikaitkan dengan instans Sumber daya apa pun (seperti antarmuka jaringan elastis (ENI), pengontrol antarmuka jaringan (NIC), atau Network Load Balancer (NLB)) dan ada sebagai alamat IPv6 independen di VPC.

Deskripsi operasi

Skenario: Setelah Anda mengaktifkan bandwidth Internet untuk alamat IPv6 gratis, konfigurasikan aturan routing arah masuk di tabel rute gerbang IPv6 untuk mengarahkan trafik IPv6 publik ke IDC melalui sirkuit Express Connect. Dengan cara ini, Sumber daya IDC dapat menyediakan layanan melalui Internet dengan menggunakan alamat IPv6 Alibaba Cloud.

Catatan

Untuk mengalokasikan alamat IPv6 ke antarmuka jaringan elastis (ENI) dari Instance ECS, panggil operasi ECS AssignIpv6Addresses.

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:AllocateIpv6Address

create

*Ipv6Address

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah.	cn-hangzhou
VSwitchId	string	Yes	ID vSwitch tempat alamat IPv6 berada.	vsw-asdfjlnaue4g****
Ipv6Address	string	No	Alamat IPv6 yang akan dialokasikan. Alamat IPv6 yang ditentukan harus berupa alamat yang tidak digunakan dalam Blok CIDR vSwitch.	2408:XXXX:153:3921:851c:c435:7b12:1c5f
Ipv6AddressName	string	No	Nama instans alamat IPv6. Panjang nama harus 0 hingga 128 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	ipv6-name
Ipv6AddressDescription	string	No	Deskripsi instans alamat IPv6. Panjang deskripsi harus 0 hingga 256 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	ipv6-description
AddressType	string	No	Tipe alamat IPv6. Nilai valid: IPv6Address (default): Instans berupa alamat IPv6 tunggal. IPv6Prefix: Instans berupa Blok CIDR IPv6.	IPv6Address
ResourceGroupId	string	No	ID kelompok sumber daya. Untuk informasi selengkapnya tentang kelompok sumber daya, lihat Apa itu kelompok sumber daya?.	rg-bp67acfmxazb4ph****
Tag	array<object>	No	Daftar tag untuk Sumber daya.
	object	No	Tag Sumber daya.
Key	string	No	Kunci tag Sumber daya. Anda dapat menentukan hingga 20 kunci tag. Jangan menentukan string kosong. Panjang kunci tag dapat mencapai 128 karakter. Tidak boleh diawali dengan `aliyun` atau `acs:` dan tidak boleh mengandung `http://` atau `https://`.	FinanceDept
Value	string	No	Nilai tag Sumber daya. Anda dapat menentukan hingga 20 nilai tag. Anda dapat menentukan string kosong. Panjang nilai tag dapat mencapai 128 karakter. Tidak boleh diawali dengan aliyun atau acs: dan tidak boleh mengandung http:// atau https://.	FinanceJoshua
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.	02fb3da4-130e-11e9-8e44-0016e04****
DryRun	boolean	No	Apakah akan menjalankan dry run. Nilai valid: true: menjalankan dry run. Sistem memeriksa parameter yang diperlukan, sintaks permintaan, dan batasan bisnis. Jika pemeriksaan gagal, kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation akan dikembalikan. false (default): menjalankan dry run dan mengirimkan permintaan. Jika pemeriksaan berhasil, kode status HTTP 2xx akan dikembalikan dan operasi akan dijalankan.	false
RegionId	string	Yes	ID wilayah.	cn-hangzhou

Elemen respons

Element	Type	Description	Example
	object
Ipv6AddressId	string	ID instans alamat IPv6.	ipv6-2zen5j4axcp5l5qyy****
Ipv6Address	string	Alamat IPv6.	2408:XXXX:153:3921:851c:c435:7b12:1c5f
ResourceGroupId	string	ID kelompok sumber daya.	rg-acfmxazdjdhd****
RequestId	string	ID permintaan.	54B48E3D-DF70-471B-AA93-08E683A1B45

Contoh

Respons sukses

JSONformat

{
  "Ipv6AddressId": "ipv6-2zen5j4axcp5l5qyy****",
  "Ipv6Address": "2408:XXXX:153:3921:851c:c435:7b12:1c5f",
  "ResourceGroupId": "rg-acfmxazdjdhd****",
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	OperationFailed.IPv6AddressAlreadyAllocated	The operation is failed because of the ipv6 address specified was allocated.
400	OperationFailed.AddressNotInVSwitchCidr	The operation is failed because of %s.
400	IllegalParam.IpAddress	The param of %s is illegal.
400	OperationFailed.IPv6Disabled	Operation failed because IPv6 is not enabled for the vSwitch.
400	OperationFailed.IpPrefixMustInVSwitchCidrReservation	The specified ip prefix must in reserved segment the VSwitch.
400	Forbidden.OperateShareResource	You cannot operate shared resources.
400	QuotaExceeded.IPv6PrefixMask	The quota of specifed ipv6 prefix mask is exceeded.
400	OperationUnsupported.Ipv6Feature	The IPv6 feature is not supported in the region.
400	IllegalParam.Ipv6Prefix	The param of Ipv6Prefix is illegal.
400	OperationFailed.ExistIPv6Used	The operation is failed because of some ipv6 in the ipv6 prefix is already in use.
400	OperationUnsupported.UnboundIpv6PrefixFeature	The region does not support creating IPv6 prefix that are not bound to any resources.
400	OperationUnsupported.UnboundIpv6Feature	The region does not support creating IPv6 addresses that are not bound to any resources.
400	OperationUnsupported.FreePrivateIpv6	This operation does not support free private IPv6 addresses.
404	ResourceNotFound.VSwitch	The specified resource of %s is not found.
404	ResourceNotFound.VSwitchCidrReservation	The dependent vswitch cidr reservation is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.