AssociateEipAddress - Elastic IP Address - Alibaba Cloud Documentation Center

Mengaitkan elastic IP address (EIP) dengan instans sumber daya cloud di wilayah yang sama.

Deskripsi operasi

EIP dapat dikaitkan dengan instans ECS tipe VPC, instans CLB tipe VPC, antarmuka jaringan elastis (ENI) sekunder, gerbang NAT Internet, atau alamat IP virtual ketersediaan tinggi (HAVIP) di wilayah yang sama.
Operasi AssociateEipAddress bersifat asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID permintaan, tetapi pengaitan antara EIP dan instans sumber daya cloud belum selesai. Tugas pengaitan terus berjalan di latar belakang. Anda dapat memanggil DescribeEipAddresses untuk mengkueri status EIP:
- Jika EIP berada dalam status Associating, EIP sedang dikaitkan. Dalam status ini, Anda hanya dapat menjalankan operasi kueri.
- Jika EIP berada dalam status InUse, EIP telah dikaitkan.
Operasi AssociateEipAddress tidak mendukung permintaan konkuren untuk mengaitkan EIP yang sama dengan instans sumber daya cloud.

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

update

*Address

acs:vpc:{#regionId}:{#accountId}:eip/{#AllocationId}

NatGateway

acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId}

Instance

acs:vpc:{#regionId}:{#accountId}:instance/{#InstanceId}

Association

acs:vpc:{#regionId}:{#accountId}:havip/{#HaVipId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah EIP yang akan dikaitkan dengan instans sumber daya cloud. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-hangzhou
AllocationId	string	Yes	ID EIP yang akan dikaitkan dengan instans sumber daya cloud.	eip-2zeerraiwb7ujsxdc****
InstanceId	string	Yes	ID Instans dari Instans yang akan dikaitkan dengan EIP. Anda dapat memasukkan ID Instans dari gerbang NAT Internet, instans Classic Load Balancer (CLB), Instans ECS, antarmuka jaringan elastis (ENI) sekunder, alamat IP virtual ketersediaan tinggi (HAVIP), atau alamat IP.	i-2zebb08phyczzawe****
InstanceType	string	No	Tipe Instans yang akan dikaitkan dengan EIP. Nilai valid: Nat: Gerbang NAT Internet. SlbInstance: Classic Load Balancer (CLB). EcsInstance (default): Elastic Compute Service (ECS). NetworkInterface: Antarmuka jaringan elastis (ENI) sekunder. HaVip: Alamat IP virtual ketersediaan tinggi. IpAddress: Alamat IP. Catatan Tipe Instans default adalah EcsInstance. Jika tipe Instans bukan EcsInstance, parameter ini wajib diisi.	EcsInstance
InstanceRegionId	string	No	ID wilayah Instans yang akan dikaitkan dengan EIP. Catatan Parameter ini wajib diisi hanya setelah EIP ditambahkan ke instans Akselerator Global (GA) bandwidth bersama Alibaba Cloud.	cn-hangzhou
PrivateIpAddress	string	No	Alamat IP dalam blok CIDR vSwitch. Jika Anda tidak menentukan parameter ini, sistem secara otomatis menetapkan alamat IP privat berdasarkan ID VPC dan ID vSwitch. Catatan Jika InstanceType diatur ke NetworkInterface, parameter ini wajib diisi. Masukkan alamat IP privat yang akan dikaitkan.	192.168.XX.XX
Mode	string	No	Mode asosiasi. Nilai valid: NAT (default): Mode NAT (mode standar). MULTI_BINDED: Mode multi-EIP-ke-ENI. BINDED: Mode EIP-ke-ENI. Catatan Parameter ini wajib diisi hanya ketika InstanceType diatur ke NetworkInterface.	NAT
VpcId	string	No	ID VPC yang memiliki fitur gerbang IPv4 diaktifkan dan berada di wilayah yang sama dengan EIP. Ketika EIP dikaitkan dengan alamat IP, sistem menggunakan konfigurasi perutean VPC ini untuk mengaktifkan akses jaringan publik untuk alamat IP yang dikaitkan. Catatan Parameter ini wajib diisi ketika InstanceType diatur ke IpAddress.	vpc-257gqcdfvx6n****
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token unik di antara berbagai permintaan. Token hanya dapat berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	0c593ea1-3bea-11e9-b96b-88e9fe63****

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidAssociation.Duplicated	Specified instance already is associated.
400	OperationDenied	Specified instance is not in VPC.
400	InvalidParameter.Mismatch	Specified elastic IP address and ECS instance are not in the same region.
400	IncorrectEipStatus	Current elastic IP status does not support this operation
400	IncorrectInstanceStatus	Current instance status does not support this operation.
400	InvalidInstanceType.ValueNotSupported	The specified value of InstanceType is not supported.
400	IncorrectHaVipStatus	HaVip can be operated by this action only when it's status is Available or InUse.	Operasi ini hanya diperbolehkan ketika instans HaVip berada dalam status Available atau InUse.
400	InvalidParameter	The specified parameter is not valid.
400	InvalidBindingStatus	The eip binding status invalid.
400	BIND_INSTANCE_HAVE_PORTMAP_OR_BIND_EIP	The instance may have portMap or already bind eip.	Aturan penerusan port (DNAT) sudah ada untuk Instans ECS. Hapus aturan penerusan port yang sesuai sebelum melanjutkan.
400	EIP_CAN_NOT_ASSOCIATE_WITH_PUBLIC_IP	instance already bind natpublicip,cannot bind eip.
400	BIND_INSTANCE_OWENER_ERROR	Cannot operate the eip.
400	NATGATEWAY_FINANCIALLOCKED	The NatGateway has expire, cannot do bind operation.
400	InvalidParameter.InstanceTypeNotSupport	The specified instance type is not support.
400	QuotaExceeded.NumberOfTrafficEip	The number of traffic eip on natgw exceed limitation.
400	QuotaExceeded.NumberOfEip	Binded eip Quota exceed on this NatGw.	Jumlah EIP yang disambungkan ke gerbang NAT ini melebihi batas kuota.
400	Forbidden.EipCanNotBindGatgw	Eip can not bind on natgw.
400	InvalidAction.Denied	Action is denied due to unfinished Eip configuration modification.	Operasi ditolak karena modifikasi konfigurasi EIP belum selesai.
400	InstanceType.NotSupport	The instance type is invalid.
400	InvalidParams.NotFound	instance not found
400	BindInstance.NotSupported	bind instance type %s is not supported.
400	Forbidden.InstanceBandwidthNotZero	Eip can not bind with instance when it's bandwidth is not zero.
400	INSTANCE_TYPE_NOT_SUPPORT	The instance type is invalid.
400	ServerRegion.Invalid	Eip bind remote server region invalid.
400	Eni.Attached	The eni should be detached from ecs when associating with direct eip.	Saat ENI dikaitkan dengan EIP dalam mode cut-through, ENI harus dilepaskan dari Instans ECS.
400	Eni.HasSubIp	Eni has sub ip can not bind direct eip.
400	Invalid.DirectEip.BindType	The direct eip can be only associated with eni.
400	InvalidStatus.EcsStatusNotSupport	The special instance status is not support operate
400	Invalid.Function.NotSupported	Multi-IP function is under test, the region or uid is not supported.
400	InvalidStatus.EniStatusNotSupport	%s
400	InvalidParameter.EniInstanceId	%s
400	InvalidNexthop.DirectEni	The direct Eni cannot be nexthop.	ENI pass-through tidak dapat digunakan sebagai lompatan berikutnya.
400	Mode.Conflict	The eni can bind only one mode of eip.
400	Mode.NotSupport	The user cannot use multi direct eip.
400	QuotaExceed.MultiBindedEip	The number of multi binded eip is over limit.	Jumlah EIP yang dapat diasosiasikan dalam mode multi-EIP-ke-ENI melebihi batas.
400	InvalidEIPStatus.BizDisabled	The EIP has been locked.	Instans EIP terkunci.
400	OperationFailed.EniSubIp	Eni has sub ip can not bind direct eip.
400	InvalidEip.EipQuotaExceeded	The specified eni assigned eip is more than privateIp.
400	OperationUnsupported.MultiIp	Multi ip function is not support.
400	InvalidNicOrVm.NotFound	Bind nic or vm not exist.	ENI atau VM yang akan diasosiasikan yang ditentukan tidak ada.
400	OperationUnsupported.EipBindModel	The instance type of ecs does not support MULTI_BINDED model Eip.
400	IncorrectStatus.NatGateway	%s
400	EipBindRemote.BackendRegionMustBeSingle	eip bind remote instance, backend region must be single
400	InvalidParameter.BindingInstanceRegion	The specified BindingInstanceRegion is not supported.
400	OperationFailed.HavipBoundPortmap	%s
400	IllegalParam.Mode	%s
400	InvalidStatus.NotAllow	Bind instance status invalid	Status instans dari instans yang disambungkan tidak valid.
400	InvalidInstance.NotExist	Bind instance data not exist
400	InvalidBandwidthPackageId.NotFound	The specified BandwidthPackageId not exist.
400	InvalidStatus.InstanceHasBandWidth	The specified instance bandwidth invalid.
400	OperationDenied.CloudBoxResourceExist	The operation is not allowed because there are resources related to the cloud box in VPC.	Operasi dilarang karena VPC berisi Sumber daya terkait CloudBox.
400	OperationDenied.CloudBoxVSwitchExist	The operation is not allowed because a cloud box type vSwitch exists in VPC.	Operasi dilarang karena VPC berisi vSwitch bertipe CloudBox.
400	OperationDenied.NoAvailablePrivateIp	The operation is failed because of vSwitch has not availalbe private ip	Alamat IP privat yang tersedia di vSwitch saat ini tidak mencukupi.
400	ResourceAlreadyAssociated.IpAddress	%s
400	OperationFailed.Ipv4GatewayNotOpenedInVpc	The operation is failed because Ipv4Gateway is not opened in Vpc.	Gagal mengaitkan EIP dengan alamat IP karena gerbang IPv4 tidak diaktifkan untuk VPC ini.
400	OperationFailed.Ipv4GatewayNotActivatedInVpc	The operation is failed because Ipv4Gateway is not activated in Vpc.
400	OperationDenied.L2EipBindIpAddress	%s
400	Forbidden	The eip instance owner error	EIP bukan milik pemanggil saat ini. Periksa apakah Anda memiliki izin untuk menggunakan EIP ini.
400	Forbidden.FinancialLocked	The ip business status is invalid.	Operasi ini tidak dapat dilakukan ketika antarmuka router memiliki pembayaran tertunda.
400	UnsupportedFeature.EipBindIpAddress	The feature of EipBindIpAddress is not supported.	Penyambungan EIP ke alamat IP tidak didukung.
400	OperationFailed.InstanceNotExist	The ECS instance does not exist, or is not a VPC VM.	Gagal mengaitkan EIP dengan Instance ECS karena Instance ECS tidak ada atau bukan instans VPC.
400	OperationDenied.Ipv4GatewayExist	The operation is not allowed because of Ipv4GatewayExist.
400	OperationFailed.EipBindModeConflict	Eips can not bind Eni with NAT mode and MULTI_BINDED mode at the same time.
400	OperationFailed.EcsMigrating	The operation is failed because of ECS is migrating.
400	OperationFailed.IpPrefixConflict	The operation failed due to the IP prefix of the ENI.	Operasi saat ini bertentangan dengan awalan IP dari antarmuka jaringan.
400	UnsupportedFeature.EipBindPrefixIp	The feature of EipBindPrefixIp is not supported.	Penyambungan EIP ke PrefixIp tidak didukung di wilayah saat ini.
400	OperationDenied.UnsupportedEipBindMode	The operation is not supported for the NAT gateway due to its EIP binding mode.	Tipe pengikatan EIP dari gerbang NAT ini tidak mendukung operasi ini.
400	OperationDenied.Unauthorized	The operation is not allowed because the user is not in the whitelist.	Operasi tidak diizinkan karena pengguna tidak berada dalam daftar putih.
400	OperationFailed.SystemBusy	Operation failed because system is busy.	Sistem sibuk. Coba lagi nanti.
400	OperationFailed.PrivateIpAddressNotExist	The operation failed because the PrivateIpAddress is not found.	Alamat IP privat yang ditentukan tidak ada.
400	IllegalParamFormat.%s	The param format of %s is illegal.	Mode parameter tidak valid.
400	MissingParam.InstanceId	The param of InstanceId can't be null or empty.	Parameter InstanceId tidak boleh kosong.
400	InvalidEniType.SlaveEni	The eni type cannot be slave eni.	Tipe antarmuka jaringan tidak boleh berupa ENI sekunder.
400	IllegalParam.PrivateIpAddress	The specified PrivateIpAddress is illegal.	PrivateIpAddress yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi setelah melakukan koreksi.
400	OperationFailed.Ipv4GatewayNotAssociatedWithGatewayRouteTable	The operation failed because the specified IPv4 gateway of the VPC is not associated with any gateway route table.	Gerbang IPv4 VPC yang sesuai dengan alamat IP yang terhubung dengan EIP tidak terhubung dengan tabel rute gerbang apa pun.
404	InvalidAllocationId.NotFound	Specified allocation ID is not found.
404	InvalidInstanId.NotFound	Specified instance does not exist.
404	Forbidden.RegionNotFound	Specified instance is not found during access authentication.	Wilayah saat ini tidak didukung.
404	OperationDenied.VpcIpv4GatewayEnabled	The operation is not allowed because of the VPC of the NAT gateway has opened IPv4 Gateway.	Operasi tidak diizinkan karena VPC dari gerbang NAT sudah mengaktifkan gerbang IPv4.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.