Menetapkan satu atau beberapa alamat IP pribadi sekunder ke elastic network interface (ENI). Anda dapat menentukan alamat IP pribadi yang tersedia dalam blok CIDR dari vSwitch yang terhubung ke ENI tersebut atau menentukan jumlah alamat IP pribadi yang akan ditetapkan secara otomatis dari blok CIDR vSwitch ke ENI.
Catatan penggunaan
-
ENI yang akan diberi alamat IP pribadi sekunder harus berada dalam status Available atau InUse.
-
Saat menetapkan alamat IP pribadi sekunder ke ENI primer, instance Elastic Compute Service (ECS) yang terhubung ke ENI tersebut harus berada dalam status Running atau Stopped.
-
Saat ENI berada dalam status Available, Anda dapat menetapkan hingga 49 alamat IP pribadi sekunder ke ENI tersebut. Jika ENI terhubung ke instance, jumlah alamat IP pribadi sekunder yang dapat ditetapkan bergantung pada tipe instance. Untuk informasi selengkapnya, lihat Overview of instance families.
-
Setelah memanggil operasi ini untuk suatu ENI, Anda dapat memperoleh alamat IP pribadi sekunder yang ditetapkan ke ENI tersebut dari respons.
Debugging
Parameter permintaan
|
Parameter |
Type |
Required |
Example |
Description |
|
Action |
String |
Yes |
AssignPrivateIpAddresses |
Operasi yang ingin Anda lakukan. Tetapkan nilainya ke AssignPrivateIpAddresses. |
|
RegionId |
String |
Yes |
cn-hangzhou |
ID wilayah dari ENI. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru. |
|
NetworkInterfaceId |
String |
Yes |
eni-bp67acfmxazb4p**** |
ID ENI. |
|
SecondaryPrivateIpAddressCount |
Integer |
No |
1 |
Jumlah alamat IP pribadi yang akan ditetapkan secara otomatis dari blok CIDR vSwitch yang terhubung ke ENI. Untuk menetapkan alamat IP pribadi sekunder ke ENI, Anda tidak boleh menentukan |
|
ClientToken |
String |
No |
123e4567-e89b-12d3-a456-426655440000 |
Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client 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. |
|
PrivateIpAddress.N |
String |
No |
10.1.**.** |
Alamat IP pribadi sekunder N, yang dipilih dari dalam blok CIDR vSwitch yang terhubung ke ENI. Nilai valid N:
Catatan
Untuk menetapkan alamat IP pribadi sekunder ke ENI, Anda tidak boleh menentukan |
|
Ipv4Prefix.N |
String |
No |
192.168.**.**/28 |
Awalan IPv4 N. Nilai valid N: 1 hingga 10. Catatan
Untuk menetapkan awalan IPv4 ke ENI, Anda harus menentukan Ipv4Prefix.N atau Ipv4PrefixCount, tetapi tidak keduanya sekaligus. |
|
Ipv4PrefixCount |
Integer |
No |
1 |
Jumlah awalan IPv4 yang akan dihasilkan secara acak untuk ENI. Nilai valid: 1 hingga 10. Catatan
Untuk menetapkan awalan IPv4 ke ENI, Anda harus menentukan Ipv4Prefix.N atau Ipv4PrefixCount, tetapi tidak keduanya sekaligus. |
Parameter respons
|
Parameter |
Type |
Example |
Description |
|
RequestId |
String |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
ID permintaan. |
|
AssignedPrivateIpAddressesSet |
Object |
Alamat IP pribadi sekunder yang ditetapkan ke ENI. |
|
|
NetworkInterfaceId |
String |
eni-bp125p95hhdhn3ot**** |
ID ENI. |
|
PrivateIpSet |
Array of String |
192.168.**.** |
Alamat IP pribadi sekunder. |
|
Ipv4PrefixSet |
Array of String |
192.168.**.**/28 |
Awalan IPv4. |
Contoh
Contoh permintaan
https://ecs.aliyuncs.com/?Action=AssignPrivateIpAddresses
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&PrivateIpAddress.1=10.1.**.**
&PrivateIpAddress.2=10.1.**.**
&<Common request parameters>Contoh respons sukses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<AssignPrivateIpAddressesResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<AssignedPrivateIpAddressesSet>
<PrivateIpSet>
<PrivateIpAddress>192.168.**.**</PrivateIpAddress>
</PrivateIpSet>
<NetworkInterfaceId>eni-bp125p95hhdhn3ot****</NetworkInterfaceId>
</AssignedPrivateIpAddressesSet>
</AssignPrivateIpAddressesResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"AssignedPrivateIpAddressesSet" : {
"PrivateIpSet" : {
"PrivateIpAddress" : [ "192.168.**.**" ]
},
"NetworkInterfaceId" : "eni-bp125p95hhdhn3ot****"
}
}Kode kesalahan
|
Kode status HTTP |
Kode kesalahan |
Pesan kesalahan |
Deskripsi |
|
400 |
Throttling |
Request was denied due to request throttling. |
Permintaan dibatasi lajunya. |
|
400 |
UnsupportedParameter |
%s |
Parameter yang ditentukan tidak didukung. |
|
400 |
InvalidParameter |
%s |
Parameter tidak valid. |
|
400 |
InvalidInstanceID.Malformed |
%s |
Nilai InstanceId tidak valid. |
|
400 |
InvalidOperation.InvalidEcsState |
%s |
Operasi ini tidak dapat dilakukan pada instans dalam status saat ini. |
|
400 |
InvalidOperation.InvalidEniState |
%s |
Operasi ini tidak dapat dilakukan pada ENI dalam status saat ini. |
|
400 |
InvalidOperation.DetachPrimaryEniNotAllowed |
%s |
ENI tidak dapat dilepas dari instans. |
|
400 |
MissingParameter |
%s |
Parameter yang diperlukan tidak ditentukan. |
|
400 |
Forbidden.RegionId |
%s |
Layanan tidak tersedia di wilayah tersebut untuk sementara waktu. |
|
400 |
InvalidAction |
%s |
Operasi tidak valid. |
|
400 |
IncorrectVSwitchStatus |
The current status of vSwitch does not support this operation. |
Operasi tidak dapat dilakukan pada vSwitch dalam status saat ini. |
|
400 |
InvalidPrivateIpAddress.Duplicated |
Specified private IP address is duplicated. |
Alamat IP pribadi yang ditentukan sudah sedang digunakan. Coba gunakan alamat IP lain. |
|
400 |
InvalidParameter.Conflict |
%s |
Parameter yang ditentukan 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 ada atau Pasangan Kunci Akses Anda telah kedaluwarsa. |
|
403 |
Forbidden.NotSupportRAM |
%s |
Pengguna Resource Access Management (RAM) tidak memiliki akses ke operasi ini. |
|
403 |
Forbidden.SubUser |
%s |
Anda tidak memiliki akses ke resource tersebut. Hubungi pemilik akun Alibaba Cloud. |
|
403 |
MaxEniCountExceeded |
%s |
Jumlah maksimum ENI yang dapat dikelola telah terlampaui. |
|
403 |
EniPerInstanceLimitExceeded |
%s |
Jumlah maksimum ENI yang dapat disambungkan ke instans telah tercapai. |
|
403 |
InvalidOperation.AvailabilityZoneMismatch |
%s |
Operasi tidak valid. |
|
403 |
InvalidOperation.VpcMismatch |
%s |
Operasi tidak valid. Periksa apakah virtual private cloud (VPC) dalam operasi sesuai dengan parameter lainnya. |
|
403 |
SecurityGroupInstanceLimitExceed |
%s |
Jumlah maksimum instans dalam security group yang ditentukan telah tercapai. |
|
403 |
InvalidSecurityGroupId.NotVpc |
%s |
Nilai SecurityGroupId tidak valid. Jenis jaringan dari security group yang ditentukan bukan VPC. |
|
403 |
InvalidOperation.InvalidEniType |
%s |
Operasi ini tidak dapat dilakukan pada jenis ENI ini. |
|
403 |
InvalidVSwitchId.IpNotEnough |
%s |
Alamat IP yang tersedia dalam blok CIDR VSwitch yang ditentukan tidak mencukupi. |
|
403 |
InvalidVSwitchId.IpInvalid |
%s |
Alamat IP pribadi tidak valid. |
|
403 |
InvalidIp.IpAssigned |
%s |
Alamat IP yang ditentukan sudah ditetapkan. |
|
403 |
MaxEniPrivateIpsCountExceeded |
%s |
Jumlah maksimum alamat IP pribadi sekunder yang dapat ditetapkan ke ENI telah terlampaui. Untuk informasi selengkapnya, lihat nilai kembali dari placeholder %s dalam pesan kesalahan. |
|
403 |
Operation.Conflict |
%s |
Operasi ini bertentangan dengan operasi lain yang sedang berlangsung. Coba lagi nanti. |
|
403 |
InvalidOperation.Ipv4CountExceeded |
%s |
Jumlah maksimum alamat IPv4 telah tercapai. |
|
403 |
InvalidOperation.EniServiceManaged |
%s |
Operasi tidak valid. |
|
403 |
InvalidIp.IpRepeated |
%s |
Alamat IP sudah ada. |
|
403 |
InvalidIp.IpPrefixIllegal |
The ip prefixes %s is/are illegal. |
Awalan IP tidak valid dan tidak dalam notasi 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. |
|
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 notasi CIDR. |
|
403 |
InvalidVSwitchId.IpPrefixNotEnough |
The specified vSwitch has not enough ip prefix. |
Awalan IP yang tersedia dalam blok CIDR vSwitch yang ditentukan tidak mencukupi. |
|
403 |
MissingParameter |
These parameters %s cannot be both empty. |
Parameter yang diperlukan tidak ditentukan. |
|
404 |
InvalidEcsId.NotFound |
%s |
ID instans tidak ditemukan. |
|
404 |
InvalidEniId.NotFound |
%s |
ID ENI tidak ditemukan. |
|
404 |
InvalidVSwitchId.NotFound |
%s |
vSwitch tidak ditemukan. |
|
404 |
InvalidSecurityGroupId.NotFound |
%s |
ID security group tidak ditemukan. |
|
404 |
InvalidInstanceId.NotFound |
%s |
Nilai InstanceId tidak ditemukan. |
|
500 |
InvalidOperation.RegionNotSupportIpPrefix |
The current region does not support ip prefix. |
Awalan IP tidak dapat ditetapkan di wilayah tersebut. |
Untuk daftar kode kesalahan, lihat Service error codes.