AssociateVpcCidrBlock - Virtual Private Cloud - Alibaba Cloud Documentation Center

Menambahkan Blok CIDR sekunder ke VPC.

Deskripsi operasi

Jumlah maksimum Blok CIDR sekunder yang dapat ditambahkan ke VPC adalah sebagai berikut:
- Maksimum 5 Blok CIDR IPv4 sekunder dapat ditambahkan ke VPC.
- Maksimum 5 Blok CIDR IPv6 sekunder dapat ditambahkan ke VPC.
Operasi AssociateVpcCidrBlock tidak mendukung penambahan Blok CIDR sekunder secara bersamaan ke VPC yang sama.

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

create

*VPC.

acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID Wilayah VPC tempat Anda ingin menambahkan Blok CIDR sekunder. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.	ch-hangzhou
VpcId	string	Yes	ID VPC tempat Anda ingin menambahkan Blok CIDR sekunder.	vpc-o6wrloqsdqc9io3mg****
SecondaryCidrBlock	string	No	Blok CIDR IPv4 sekunder yang akan ditambahkan. Blok CIDR harus memenuhi persyaratan berikut: Gunakan alamat IPv4 privat yang ditentukan dalam RFC 1918 sebagai Blok CIDR IPv4 sekunder dari virtual private cloud (VPC). Subnet mask harus memiliki panjang 16 hingga 28 bit. Contoh: 10.0.0.0/16, 172.16.0.0/16, dan 192.168.0.0/16. Anda dapat menggunakan Blok CIDR kustom selain 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, atau 169.254.0.0/16 dan subnetnya sebagai Blok CIDR IPv4 sekunder dari virtual private cloud (VPC). Batas konfigurasi: Blok CIDR tidak boleh dimulai dengan 0. Subnet mask harus memiliki panjang 16 hingga 28 bit. Blok CIDR sekunder tidak boleh tumpang tindih dengan Blok CIDR utama atau Blok CIDR sekunder yang ada di VPC. Catatan Jika Anda tidak menggunakan Kolam IPAM untuk menambahkan Blok CIDR sekunder ke VPC, Anda harus menentukan parameter SecondaryCidrBlock atau parameter Ipv6CidrBlock, tetapi tidak keduanya.	192.168.0.0/16
SecondaryCidrMask	integer	No	Subnet mask yang digunakan untuk menambahkan Blok CIDR IPv4 sekunder dari Kolam IPAM ke VPC. Catatan Saat Anda menggunakan Kolam IPAM untuk menambahkan Blok CIDR IPv4 sekunder ke VPC, Anda harus menentukan setidaknya satu dari SecondaryCidrBlock atau SecondaryCidrMask.	16
IPv6CidrBlock	string	No	Blok CIDR IPv6 yang ditentukan untuk VPC. Catatan Anda tidak dapat menentukan SecondaryCidrBlock dan Ipv6CidrBlock secara bersamaan.	2408:XXXX:0:6a::/56
Ipv6Isp	string	No	Tipe Blok CIDR IPv6 VPC. Nilai valid: BGP (default): Alibaba Cloud BGP IPv6. ChinaMobile: China Mobile (ISP tunggal). ChinaUnicom: China Unicom (ISP tunggal). ChinaTelecom: China Telecom (ISP tunggal). Catatan Jika akun Anda termasuk dalam daftar putih bandwidth ISP tunggal Tiongkok, Anda dapat menyetel parameter ini ke ChinaTelecom (China Telecom), ChinaUnicom (China Unicom), atau ChinaMobile (China Mobile).	BGP
IpVersion	string	No	Versi alamat IP. Nilai valid: IPV4: Alamat IPv4. IPV6: Alamat IPv6. Ketika IpVersion disetel ke IPV6 dan SecondaryCidrBlock tidak ditentukan, Blok CIDR IPv6 sekunder ditambahkan ke VPC.	IPV4
IpamPoolId	string	No	ID instans Kolam IPAM.	ipam-pool-sycmt3p2a9v63i****
Ipv6CidrMask	integer	No	Subnet mask yang digunakan untuk menambahkan Blok CIDR IPv6 dari Kolam IPAM ke VPC. Catatan Saat Anda menggunakan Kolam IPAM untuk menambahkan Blok CIDR IPv6 sekunder ke VPC, Anda harus menentukan setidaknya satu dari IPv6CidrBlock atau Ipv6CidrMask.	56

Elemen respons

Element	Type	Description	Example
	object	ID permintaan.
RequestId	string	ID permintaan.	C1221A1F-2ACD-4592-8F27-474E02883159
CidrBlock	string	Blok CIDR sekunder yang ditambahkan ke VPC.	192.168.0.0/16
IpVersion	string	Versi alamat IP dari Blok CIDR sekunder.	IPV4

Contoh

Respons sukses

JSONformat

{
  "RequestId": "C1221A1F-2ACD-4592-8F27-474E02883159",
  "CidrBlock": "192.168.0.0/16",
  "IpVersion": "IPV4"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidVpc.NotFound	%s
400	IncorrectStatus.Vpc	%s
400	ParamExclusive.SecondaryCidrAndIpv6Cidr	%s
400	OperationUnsupported.VpcMultiCidr	%s
400	MissingParam.SecondaryCidrOrIpv6Cidr	%s
400	OperationUnsupported.IPv6ULA	%s
400	OperationFailed.Ipv6CidrBlockExisted	%s
400	InvalidIpv6ULACidrBlock.Malformed	%s
400	QuotaExceeded.GUAIpv6CidrBlock	%s
400	IllegalParam.Ipv6CidrType	%s
400	OperationUnsupported.OnlyULA	%s
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
400	IllegalParam.SecondaryCidrBlock	%s
400	Duplicated.SecondaryCidrBlock	%s
400	OperationFailed.ConflictWithEntry	%s
400	QuotaExceeded.VpcMultiCidr	%s
400	MissingParam.SecondaryCidrBlockOrIpv6CidrBlock	Either SecondaryCidrBlock or Ipv6CidrBlock must be specified.	Parameter yang diperlukan, yaitu blok CIDR sekunder atau blok CIDR IPv6, tidak ditemukan.
400	MissingParam.VpcId	You must specify VpcId.	Parameter VpcId yang diperlukan tidak ditemukan.
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.	Fitur Ipv6Isp yang ditentukan tidak didukung.
400	IllegalParam.IpVersion	%s
400	OperationDenied.GUAIpv6CidrBlock	The operation is not allowed because this ipv6 CIDR is not reserved.
400	OperationFailed.IPv6CidrNotReserved	Operation failed because this ipv6 cidr is not reserved.
400	InvalidCidrBlock	Specified CIDR block is already exists.
400	IllegalParam.IpamPool	The specified IPAM pool cannot be empty.	Kolam IPAM tidak boleh kosong.
400	MissingParam.SecondaryCidrMask	The parameter SecondaryCidrMask must be input.	Parameter SecondaryCidrMask diperlukan.
400	IllegalParam.SecondaryCidrMask	The specified Secondary CIDR Mask is illegal.	SecondaryCidrMask yang ditentukan tidak valid.
400	OperationDenied.RequestRegionInvalid	The operation is not allowed because the request is not invoked in the region of the IPAM pool.	Operasi ditolak karena permintaan tidak dipanggil di wilayah tempat kolam IPAM berada.
400	OperationDenied.IpamPoolNotInRegion	The operation is not allowed because the IPAM pool not in specific region does not support creating VPC or associating CIDR for VPC.	Operasi ditolak karena Anda tidak dapat membuat VPC atau menambahkan Blok CIDR sekunder ke VPC dari kolam IPAM yang tidak memiliki atribut wilayah.
400	MissingParam.CidrOrCidrMask	The CIDR or CIDR Mask must be input.	Tentukan parameter Cidr atau CidrMask saat Anda membuat sumber daya dari kolam IPAM.
400	OperationDenied.CidrInExcludeCidrs	The operation is not allowed because the input CIDR is within the illegal CIDRs.	Operasi ditolak karena Blok CIDR yang ditentukan berada dalam rentang Blok CIDR yang tidak valid.
400	OperationDenied.AvailableCidrInsufficient	The operation is not allowed because available CIDR is insufficient.	Operasi ditolak karena sumber daya Blok CIDR yang tersedia tidak mencukupi.
400	UnsupportedFeature.Ipam	IPAM is not supported in this region.
400	UnsupportedFeature.VpcIpamIpv6	The specified IPAM pool does not support the IPv6 feature.	Kolam IPAM yang ditentukan tidak mendukung IPv6.
400	OperationDenied.CidrUnavailableInPool	The operation is not allowed because the CIDR is unavailable in the IPAM pool.	Operasi ditolak karena blok CIDR tidak tersedia di kolam IPAM.
400	InvalidIpv6CidrBlock.Malformed	Param Ipv6CidrBlock is malformed.	Parameter blok CIDR IPv6 tidak valid.
400	MissingParam.IpVersion	The parameter IpVersion is missing.	Parameter IpVersion hilang.
400	Mismatch.IpVersionAndIpamPoolIpVersion	The input IpVersion is inconsistent with the IpVersion of the input IPAM pool.	IpVersion yang ditentukan tidak cocok dengan IpVersion dari kolam alamat yang ditentukan.
400	IllegalParam.Ipv6CidrBlock	The parameter of Ipv6CidrBlock is illegal.	Blok CIDR IPv6 tidak valid.
400	OperationFailed.Ipv6CidrBlockOverLapped	The input IPv6 CIDR block overlaps with the existing ones.	Blok CIDR IPv6 yang ditentukan tumpang tindih dengan blok CIDR yang ada.
400	QuotaExceeded.IPv6CidrBlock	The number of IPv6 CIDR blocks in the VPC exceeds the limit.	Jumlah blok CIDR IPv6 di VPC telah melebihi batas.
400	OperationDenied.MaskOfCidrIsNotAllowed	The input mask or mask of the input CIDR is not allowed.	Masker atau masker blok CIDR yang ditentukan tidak berada dalam rentang yang diizinkan.
400	IllegalParam.Ipv6Isp	The specified Ipv6Isp is illegal.	Parameter Ipv6Isp yang ditentukan tidak valid.
400	IllegalParam.CidrMask	The input CIDR mask is illegal.	Masker blok CIDR yang ditentukan tidak valid.
400	OperationDenied.CidrMaskTooLarge	The operation is denied because the CIDR mask %s is larger than the allocationMaxNetmask %s of the pool.	Masker parameter Cidr atau parameter CidrMask melebihi panjang masker jaringan maksimum yang ditentukan dalam aturan kepatuhan kolam IPAM.
500	OperationFailed.ResourceNotEnough	Insufficient resources.
403	Forbbiden	User not authorized to operate on the specified resource.	EIP bukan milik pemanggil saat ini. Periksa apakah Anda memiliki izin untuk mengakses EIP ini.
404	ResourceNotFound.IpamPool	The dependent IPAM pool is not found.	Sumber daya dependen kolam IPAM tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.