CreateIpamPool - Virtual Private Cloud

Membuat kolam alamat IPAM.

Deskripsi operasi

Secara default, Anda dapat membuat maksimal satu kolam IPv6 publik tingkat atas per jenis Penyedia layanan internet (ISP) di setiap wilayah.

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

create

*IpamPool

acs:vpc:{#regionId}:{#accountId}:ipamscope/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah tempat IPAM dikelola. Panggil operasi DescribeRegions untuk mendapatkan ID wilayah.	cn-hangzhou
IpamScopeId	string	Yes	ID cakupan IPAM.	ipam-scope-glfmcyldpm8lsy****
IpamPoolName	string	No	Nama kolam alamat IPAM. Nama harus terdiri dari 1 hingga 128 karakter dan tidak boleh dimulai dengan `http://` atau `https://`.	abc
IpamPoolDescription	string	No	Deskripsi kolam alamat IPAM. Deskripsi harus terdiri dari 1 hingga 256 karakter dan harus dimulai dengan huruf atau karakter Tionghoa. Deskripsi tidak boleh dimulai dengan `http://` atau `https://`. Jika Anda tidak menentukan parameter ini, deskripsinya akan kosong.	test description
ResourceGroupId	string	No	ID kelompok sumber daya tempat kolam alamat IPAM berada.	rg-acfmxazb4ph6aiy****
PoolRegionId	string	No	Wilayah tempat kolam alamat IPAM tersedia.	cn-hangzhou
SourceIpamPoolId	string	No	ID kolam alamat IPAM sumber. Catatan Jika Anda tidak menentukan parameter ini, kolam alamat induk akan dibuat.	ipam-pool-6rcq3tobayc20t****
AllocationDefaultCidrMask	integer	No	Masker jaringan default untuk alokasi dalam kolam alamat IPAM. Catatan Masker jaringan untuk kolam alamat IPv4 harus berupa bilangan bulat dari 0 hingga 32. Masker jaringan untuk kolam alamat IPv6 harus berupa bilangan bulat dari 0 hingga 128.	28
AllocationMaxCidrMask	integer	No	Masker jaringan maksimum untuk alokasi dalam kolam alamat IPAM. Catatan Masker jaringan untuk kolam alamat IPv4 harus berupa bilangan bulat dari 0 hingga 32. Masker jaringan untuk kolam alamat IPv6 harus berupa bilangan bulat dari 0 hingga 128.	32
AllocationMinCidrMask	integer	No	Masker jaringan minimum untuk alokasi dalam kolam alamat IPAM. Catatan Masker jaringan untuk kolam alamat IPv4 harus berupa bilangan bulat dari 0 hingga 32. Masker jaringan untuk kolam alamat IPv6 harus berupa bilangan bulat dari 0 hingga 128.	8
DryRun	boolean	No	Menentukan apakah akan melakukan dry run. Nilai yang valid: true: mengirim permintaan pemeriksaan tanpa membuat kolam alamat IPAM. Sistem memeriksa parameter yang diperlukan, format permintaan, dan status instans. Jika pemeriksaan gagal, kesalahan yang sesuai dikembalikan. Jika pemeriksaan berhasil, kode kesalahan `DryRunOperation` dikembalikan. false (default): mengirim permintaan normal. Jika permintaan lolos pemeriksaan, kode status HTTP 2xx dikembalikan dan operasi dilakukan.	false
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan.	123e4567-e89b-12d3-a456-426655440000
IpVersion	string	No	Versi IP. Nilai yang valid: IPv4: IPv4. IPv6: IPv6.	IPv4
Ipv6Isp	string	No	Jenis jalur untuk blok CIDR IPv6. Parameter ini hanya berlaku untuk kolam alamat IPv6 publik. Nilai yang valid: BGP (default): IPv6 BGP Alibaba Cloud. ChinaMobile: China Mobile (jalur tunggal). ChinaUnicom: China Unicom (jalur tunggal). ChinaTelecom: China Telecom (jalur tunggal). Catatan Jika Anda adalah pengguna pada daftar putih bandwidth jalur tunggal, Anda dapat mengatur parameter ini ke ChinaTelecom, ChinaUnicom, atau ChinaMobile.	BGP
AutoImport	boolean	No	Menentukan apakah akan mengaktifkan fitur impor otomatis untuk kolam alamat.	true
Tag	array<object>	No	Tag.
	object	No	Tag.
Key	string	No	Kunci tag. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong. Kunci tag dapat memiliki panjang hingga 64 karakter dan boleh berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Kunci tag harus dimulai dengan huruf atau karakter Tionghoa, tetapi tidak boleh dimulai dengan `aliyun` atau `acs:`. Kunci tag tidak boleh berisi `http://` atau `https://`. Catatan Anda harus menentukan setidaknya salah satu dari parameter ResourceId.N atau Tag.N (Tag.N.Key dan Tag.N.Value).	FinanceDept
Value	string	No	Nilai tag. Anda dapat menentukan hingga 20 nilai tag. Nilai tag boleh berupa string kosong. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh berisi `http://` atau `https://`. Catatan Anda harus menentukan setidaknya salah satu dari parameter ResourceId.N atau Tag.N (Tag.N.Key dan Tag.N.Value).	FinanceJoshua

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
RequestId	string	ID permintaan.	BB2C39DE-CEB8-595A-981A-F2EFCBE7324E
IpamPoolId	string	ID kolam alamat IPAM.	ipam-pool-6rcq3tobayc20t****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "BB2C39DE-CEB8-595A-981A-F2EFCBE7324E",
  "IpamPoolId": "ipam-pool-6rcq3tobayc20t****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	ResourceNotFound.IpamScope	The specified resource of IPAM scope is not found.	The input IPAM scope does not exist.
400	ResourceNotFound.SourceIpamPool	The dependent source IPAM pool is not found.	The dependent resource source IPAM Pool does not exist.
400	UnsupportedFeature.PublicIpamScopeType	The feature of PublicIpamScopeType is not supported.	The IPAM you specified does not support the creation of public scope.
400	IllegalParam.AllocationDefaultNetmask	The specified AllocationDefaultNetmask is illegal.	AllocationDefaultNetmask parameter is illegal.
400	IllegalParam.AllocationMaxNetmask	The specified AllocationMaxNetmask is illegal.	AllocationMaxNetmask parameter is illegal.
400	IllegalParam.AllocationMinNetmask	The specified AllocationMinNetmask is illegal.	AllocationMinNetmask parameter is illegal.
400	IllegalParam.IpVersion	The specified IpVersion is illegal.	Invalid IpVersion.
400	QuotaExceeded.IpamPoolQuotaDepth	The quota of IpamPoolQuotaDepth count is exceeded.	Maximum number of IPAM address pool depth allowed exceeds limit
400	ResourceNotFound.Ipam	The specified resource of ipam is not found.	The IPAM entered does not exist.
400	IllegalParam.PoolRegionId	The specified PoolRegionId is illegal.	PoolRegionId parameter is illegal.
400	QuotaExceeded.IpamSubPoolQuotaPerIpamPool	The quota of ipamSubPoolQuotaPerIpamPool count is exceeded.	The number of sub-pools for the IPAM pool exceeds the limit.
400	DryRunOperation	Request validation has been passed with DryRun flag set.
400	IncorrectStatus.IpamPool	The status of the IPAM pool is incorrect.	The status of the IPAM pool is incorrect.
400	OperationDenied.OperateShareResource	The operation is not allowed because the instance is a shared resource.	The operation is not allowed because the instance is a shared resource.
400	UnsupportedFeature.IpamPublicIpv4Pool	The feature of public IPv4 pool is not supported in IPAM.	The feature of public IPv4 pool is not supported in IPAM.
400	OperationDenied.IpamPublicIpv6PoolNeedPoolRegion	The public IPv6 pool cannot be created in IPAM when its pool region is empty.	The public IPv6 pool cannot be created in IPAM when its pool region is empty.
400	IllegalParam.Ipv6Isp	The specified Ipv6Isp is illegal.	The specified Ipv6Isp is illegal.
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.	The Ipv6Isp feature is not supported.
400	UnsupportedRegion.Ipv6Isp	The current region does not support this feature.	The current region does not support this feature.
400	QuotaExceeded.IpamPublicIpv6TopPoolQuotaPerRegionIsp	The number of public IPv6 top pool in IPAM for this ISP owned by the user in this region exceeds the limit.	The number of public IPv6 top pool in IPAM for this ISP owned by the user in this region exceeds the limit.
400	Mismatch.IpamScopeAndSourceIpamPool	The input source IPAM pool is not in the input IPAM scope.	The input source IPAM pool is not in the input IPAM scope.
400	Mismatch.Ipv6IspAndSourceIpamPool	The input Ipv6Isp is inconsistent with the Ipv6Isp of the input source IPAM pool.	The input Ipv6Isp is inconsistent with the Ipv6Isp of the input source IPAM pool.
400	UnsupportedFeature.IpamIpv6	The feature of IPv6 is not supported in this region.	The feature of IPv6 is not supported in this region.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.