AssignIpv6Addresses - - Alibaba Cloud Documentation Center

Menetapkan satu atau beberapa alamat IPv6 ke elastic network interface (ENI).

Catatan penggunaan

Anda dapat menentukan alamat IPv6 dalam Blok CIDR vSwitch yang terhubung ke ENI atau menentukan jumlah alamat IPv6 yang dibuat secara otomatis untuk ENI tersebut. Perhatikan hal-hal berikut:

IPv6 harus diaktifkan untuk vSwitch tempat ENI terhubung. Untuk informasi selengkapnya, lihat Enable IPv6 for a vSwitch.
ENI harus berada dalam status Available atau InUse.
Jika Anda ingin menetapkan alamat IPv6 ke ENI primer, pastikan instance Elastic Compute Service (ECS) tempat ENI tersebut terpasang berada dalam status Running atau Stopped.
Jumlah maksimum alamat IPv6 yang dapat ditetapkan ke ENI bervariasi berdasarkan tipe instans.
- Jika ENI berada dalam status Available, ENI tersebut dapat diberi maksimal 10 alamat IPv6.
- Jika ENI sudah terpasang pada instance ECS, jumlah maksimum alamat IPv6 yang dapat ditetapkan ke ENI bervariasi berdasarkan tipe instans. Untuk informasi selengkapnya, lihat Instance families.
Setelah operasi dipanggil, Anda dapat memperoleh alamat IPv6 yang ditetapkan ke ENI dari respons.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	AssignIpv6Addresses	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke AssignIpv6Addresses.
RegionId	String	Yes	cn-hangzhou	ID wilayah ENI. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
NetworkInterfaceId	String	Yes	eni-bp1iqejowblx6h8j****	ID ENI.
Ipv6AddressCount	Integer	No	1	Jumlah alamat IPv6 yang dibuat secara acak untuk ENI. Nilai valid: 1 hingga 10. Catatan Anda harus menentukan `Ipv6Addresses.N` atau `Ipv6AddressCount`, tetapi tidak keduanya sekaligus.
Ipv6Address.N	String	No	2001:db8:1234:1a00::****	Alamat IPv6 ke-N yang akan ditetapkan ke ENI. Nilai valid N: 1 hingga 10. Contoh: Ipv6Address.1=2001:db8:1234:1a00::** Catatan** Anda harus menentukan `Ipv6Addresses.N` atau `Ipv6AddressCount`, tetapi tidak keduanya sekaligus.
Ipv6Prefix.N	String	No	2001:db8:1234:1a00:****::/80	Awalan IPv6 ke-N yang akan ditetapkan ke ENI. Nilai valid N: 1 hingga 10. Catatan Untuk menetapkan awalan IPv6 ke ENI, Anda harus menentukan Ipv6Prefix.N atau Ipv6PrefixCount, tetapi tidak keduanya sekaligus.
Ipv6PrefixCount	Integer	No	1	Jumlah awalan IPv6 yang akan ditetapkan ke ENI. Nilai valid: 1 hingga 10. Catatan Untuk menetapkan awalan IPv6 ke ENI, Anda harus menentukan Ipv6Prefix.N atau Ipv6PrefixCount, tetapi tidak keduanya sekaligus.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat How to ensure idempotence.

Parameter respons

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
NetworkInterfaceId	String	eni-bp1iqejowblx6h8j****	ID ENI.
Ipv6Sets	Array of String	2001:db8:1234:1a00::****	Alamat IPv6 yang ditetapkan ke ENI.
Ipv6PrefixSets	Array of String	2001:db8:1234:1a00:****::/80	Awalan IPv6 yang ditetapkan ke ENI.

Contoh

Permintaan contoh

https://ecs.aliyuncs.com/?Action=AssignIpv6Addresses
&NetworkInterfaceId=eni-bp1iqejowblx6h8j****
&RegionId=cn-hangzhou
&Ipv6Address.1=2001:db8:1234:1a00::****
&Ipv6Address.2=2001:db8:1234:1a01::****
&<Common request parameters>

Respons sukses contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<AssignIpv6AddressesResponse>
    <Ipv6Sets>
        <Ipv6Address>2001:db8:1234:1a00::****</Ipv6Address>
        <Ipv6Address>2001:db8:1234:1a01::****</Ipv6Address>
    </Ipv6Sets>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <NetworkInterfaceId>eni-bp1iqejowblx6h8j****</NetworkInterfaceId>
</AssignIpv6AddressesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Ipv6Sets" : {
    "Ipv6Address" : [ "2001:db8:1234:1a00::****", "2001:db8:1234:1a01::****" ]
  },
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "NetworkInterfaceId" : "eni-bp1iqejowblx6h8j****"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	UnsupportedParameter	%s	Parameter yang ditentukan tidak didukung.
400	InvalidParameter	%s	Nilai parameter tidak valid.
400	InvalidInstanceID.Malformed	%s	Format InstanceId tidak valid.
400	MissingParameter	%s	Parameter yang diperlukan tidak ditentukan.
400	InvalidParams.EniId	%s	Nilai NetworkInterfaceId tidak valid.
400	InvalidOperation.InvalidEcsState	%s	Operasi ini tidak dapat dilakukan pada instance dalam status saat ini.
400	InvalidOperation.InvalidEniState	%s	Operasi ini tidak dapat dilakukan pada ENI dalam status saat ini.
400	InvalidPrivateIpAddress.Duplicated	Specified private IP address is duplicated.	Alamat IP pribadi yang ditentukan sedang digunakan. Coba gunakan alamat IP yang berbeda.
400	IncorrectVSwitchStatus	The current status of vSwitch does not support this operation.	Operasi ini tidak dapat dilakukan pada vSwitch dalam status saat ini.
400	InvalidParameter.Conflict	%s	Nilai parameter tidak valid. Periksa apakah terdapat konflik parameter. %s adalah variabel. Pesan kesalahan dikembalikan secara dinamis berdasarkan kondisi pemanggilan.
403	InvalidUserType.NotSupported	%s	Akun Anda tidak mendukung operasi ini.
403	Abs.InvalidAccount.NotFound	%s	Akun Alibaba Cloud Anda tidak ditemukan, atau Pasangan Kunci Akses Anda telah kedaluwarsa.
403	Forbedden.NotSupportRAM	%s	Pengguna Resource Access Management (RAM) tidak memiliki izin yang diperlukan untuk melakukan operasi ini.
403	Forbbiden.SubUser	%s	Anda tidak memiliki otorisasi untuk mengelola resource ini. Hubungi pemilik Akun Alibaba Cloud untuk mendapatkan otorisasi.
403	InvalidOperation.InvalidEniType	%s	Operasi ini tidak didukung saat ENI berada dalam tipe saat ini.
403	MaxEniIpv6IpsCountExceeded	%s	Jumlah maksimum alamat IPv6 yang dapat ditetapkan ke ENI telah terlampaui.
403	InvalidIp.IpUnassigned	%s	Alamat IP yang ditentukan belum ditetapkan.
403	InvalidIp.IpRepeated	%s	Alamat IP yang ditentukan sudah ada.
403	InvalidIp.IpAssigned	%s	Alamat IP yang ditentukan sudah ditetapkan.
403	InvalidOperation.Ipv4CountExceeded	%s	Jumlah maksimum alamat IPv4 telah terlampaui.
403	InvalidOperation.Ipv6CountExceeded	%s	Jumlah maksimum alamat IPv6 telah terlampaui.
403	InvalidOperation.Ipv6NotSupport	%s	Alamat IPv6 tidak mendukung operasi ini.
403	InvalidVSwitch.Ipv6NotTurnOn	%s	Fitur IPv6 belum diaktifkan untuk vSwitch Anda saat ini. Aktifkan fitur tersebut dan coba lagi.
403	InvalidVSwitchId.IpInvalid	%s	Alamat IP pribadi yang ditentukan tidak valid.
403	Forbidden.RegionId	%s	Layanan tidak tersedia di wilayah saat ini.
403	InvalidOperation.EniServiceManaged	%s	Operasi tidak valid.
403	SecurityGroupInstanceLimitExceed	%s	Jumlah maksimum instance dalam security group yang ditentukan telah terlampaui.
403	InvalidIp.IpPrefixIllegal	The ip prefixes %s is/are illegal.	Awalan IP tidak valid dan tidak dalam format CIDR.
403	InvalidIp.IpPrefixMaskIllegal	The ip prefix mask is illegal.	Mask awalan IP tidak valid.
403	InvalidIp.IpPrefixMaskInvalid	The ip prefixes mask %s is illegal which must be between %s and %s.	Mask awalan IP tidak valid dan tidak berada dalam rentang yang valid.
403	InvalidIp.IpPrefixMaskNotSame	The ip prefixes %s are illegal which mask must be same.	Mask awalan IP tidak sama.
403	InvalidIp.IpPrefixMustInReserveSegment	The ip prefix must in vswitch reserve segment.	Awalan IP tidak valid dan tidak berada dalam Blok CIDR yang dicadangkan oleh vSwitch.
403	InvalidIp.IpPrefixNotAvailable	The ip prefix is/are not available.	Awalan IP tidak tersedia.
403	InvalidIp.IpPrefixNotStrict	The ip prefix must be strict cidr format.	Awalan IP tidak valid dan tidak dalam format CIDR.
403	InvalidVSwitchId.IpPrefixNotEnough	The specified vSwitch has not enough ip prefix.	Jumlah awalan IP dalam vSwitch yang ditentukan tidak mencukupi.
403	MissingParameter	These parameters %s cannot be both empty.	Parameter yang diperlukan tidak ditentukan. Parameter yang diperlukan tidak boleh kosong.
404	InvalidEniId.NotFound	%s	ID ENI yang ditentukan tidak ditemukan.
500	InvalidOperation.RegionNotSupportIpPrefix	The current region does not support ip prefix.	Anda tidak dapat menetapkan awalan IP di wilayah ini.

Untuk daftar kode kesalahan, lihat Service error codes.