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 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, 169.254.0.0/16, atau subnetnya sebagai blok CIDR IPv4 sekunder 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 primer 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 dan 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 China, Anda dapat mengatur 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. Saat IpVersion diatur ke IPV6 dan SecondaryCidrBlock tidak ditentukan, blok CIDR IPv6 sekunder akan 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 dan Ipv6CidrMask.	56
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

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 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
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.
400	MissingParam.VpcId	You must specify VpcId.
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.
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.
400	MissingParam.SecondaryCidrMask	The parameter SecondaryCidrMask must be input.
400	IllegalParam.SecondaryCidrMask	The specified Secondary CIDR Mask is illegal.
400	OperationDenied.RequestRegionInvalid	The operation is not allowed because the request is not invoked in the region of the IPAM pool.
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.
400	MissingParam.CidrOrCidrMask	The CIDR or CIDR Mask must be input.
400	OperationDenied.CidrInExcludeCidrs	The operation is not allowed because the input CIDR is within the illegal CIDRs.
400	OperationDenied.AvailableCidrInsufficient	The operation is not allowed because available CIDR is insufficient.
400	UnsupportedFeature.Ipam	IPAM is not supported in this region.
400	UnsupportedFeature.VpcIpamIpv6	The specified IPAM pool does not support the IPv6 feature.
400	OperationDenied.CidrUnavailableInPool	The operation is not allowed because the CIDR is unavailable in the IPAM pool.
400	InvalidIpv6CidrBlock.Malformed	Param Ipv6CidrBlock is malformed.
400	MissingParam.IpVersion	The parameter IpVersion is missing.
400	Mismatch.IpVersionAndIpamPoolIpVersion	The input IpVersion is inconsistent with the IpVersion of the input IPAM pool.
400	IllegalParam.Ipv6CidrBlock	The parameter of Ipv6CidrBlock is illegal.
400	OperationFailed.Ipv6CidrBlockOverLapped	The input IPv6 CIDR block overlaps with the existing ones.
400	QuotaExceeded.IPv6CidrBlock	The number of IPv6 CIDR blocks in the VPC exceeds the limit.
400	OperationDenied.MaskOfCidrIsNotAllowed	The input mask or mask of the input CIDR is not allowed.
400	IllegalParam.Ipv6Isp	The specified Ipv6Isp is illegal.
400	IllegalParam.CidrMask	The input CIDR mask is illegal.
500	OperationFailed.ResourceNotEnough	Insufficient resources.
403	Forbbiden	User not authorized to operate on the specified resource.
404	ResourceNotFound.IpamPool	The dependent IPAM pool is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.