AddIpamPoolCidr API の呼び出し - VPC - Alibaba Cloud - Virtual Private Cloud

IPAMプールにCIDRブロックをプロビジョニングします。

操作説明

CIDRブロックをプロビジョニングする前に、IPAMプールが作成済みであることを確認してください。CreateIpamPoolを呼び出してIPAMプールを作成できます。
親プールにプロビジョニング済みのCIDRブロックがない場合、サブプールはCIDRブロックのプロビジョニングをサポートしません。
親プールにプロビジョニング済みのCIDRブロックがある場合、サブプールにCIDRブロックをプロビジョニングできます。プロビジョニングされるCIDRブロックは親プールのプロビジョニング済みCIDRブロックのサブセットである必要があります。
親プールにプロビジョニング済みのCIDRブロックがあり、CIDR 割り当てもある場合、サブプールにプロビジョニングするCIDRブロックは既存のCIDR 割り当てと競合してはなりません。
IPAMプールにCIDRブロックをプロビジョニングするリクエストは、IPAMのホストリージョンから開始する必要があります。
IPAMプールにプロビジョニングされるCIDRブロックは、同じスコープ内の他のプールにプロビジョニングされたCIDRブロックと競合してはなりません。
プールにプロビジョニングできるCIDRブロックの数には制限があります。パブリックIPv6トップレベルプールのデフォルトの最大値は1です。その他のタイプのプールのデフォルトの最大値は50です。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	IPAMのホストリージョンのIDです。 DescribeRegions を呼び出してリージョンIDを取得できます。	cn-hangzhou
IpamPoolId	string	必須	IPAMプールのインスタンスIDです。	ipam-pool-6rcq3tobayc20t****
Cidr	string	任意	プロビジョニングするCIDRブロックです。説明プライベートトップレベルプールは、CIDRブロックを指定する方法でのみプロビジョニングをサポートしています。	192.168.1.0/24
NetmaskLength	integer	任意	ネットマスク長を指定してCIDRブロックをプロビジョニングします。説明パブリックIPv6トップレベルプールは、ネットマスク長を指定する方法でのみプロビジョニングをサポートしています。	24
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。有効な値： true：IPAMプールにCIDRブロックをプロビジョニングせずにドライランを実行します。システムは必須パラメータ、リクエスト形式、およびビジネス上の制限を確認します。確認に失敗した場合、対応するエラーが返されます。確認に成功した場合、エラーコードDryRunOperationが返されます。 false（デフォルト）：リクエストを送信します。確認に成功した後、HTTP 2xxステータスコードが返され、操作が実行されます。	false
ClientToken	string	任意	リクエストの冪等性を確保するために使用されるクライアントトークンです。異なるリクエスト間で一意のクライアント生成値です。ClientTokenはASCII 文字のみをサポートしています。説明このパラメータを指定しない場合、システムはAPIリクエストのRequestIdをClientTokenとして使用します。RequestIdはAPIリクエストごとに異なります。	123e4567-e89b-12d3-a456-426655440000

レスポンスフィールド

フィールド	型	説明	例
	object	BaseResult
RequestId	string	リクエストIDです。	558BC336-8B88-53B0-B4AD-980EE900AB01
Cidr	string	IPAMプールに正常にプロビジョニングされたCIDRブロックです。	192.168.1.0/24

例

成功レスポンス

JSONJSON

{
  "RequestId": "558BC336-8B88-53B0-B4AD-980EE900AB01",
  "Cidr": "192.168.1.0/24"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	IllegalParam.IpVersion	The specified IpVersion is illegal.
400	UnsupportedFeature.PublicIpamScopeType	The feature of PublicIpamScopeType is not supported.
400	IllegalParam.IpamPool	The specified IPAM pool cannot be empty.
400	OperationDenied.PoolRegionNotSupportAddPoolCidr	The operation is not allowed because pool region does not support adding CIDR.
400	OperationDenied.CidrConflictWithTopCidrs	The operation is not allowed because the input CIDR conflicts with existing top CIDRs.
400	OperationDenied.SourceCidrIsNull	The operation is not allowed because the source CIDR is null.
400	OperationDenied.CidrNotInSourceCidr	The operation is not allowed because the input CIDR is not in source CIDR.
400	ResourceNotFound.SourceIpamPool	The dependent source IPAM pool is not found.
400	OperationDenied.CidrConflictWithExistAllocation	The operation is not allowed because the input CIDR conflicts with the existing allocation.
400	DryRunOperation	Request validation has been passed with DryRun flag set.
400	IllegalParam.Cidr	The specified CIDR is illegal.
400	QuotaExceeded.IpamCidrQuotaPerIpamPool	The quota of ipamCidrQuotaPerIpamPool count is exceeded.
400	OperationDenied.OperateShareResource	The operation is not allowed because the instance is a shared resource.
400	IncorrectStatus.IpamPool	The status of the IPAM pool is incorrect.
400	MissingParam.CidrOrNetmaskLength	The Cidr or NetmaskLength must be input.
400	Mismatch.CidrAndPoolIpVersion	The ip verion of input Cidr is inconsistent with that of the input IPAM pool.
400	Mismatch.CidrAndNetmaskLength	The mask of the input Cidr is inconsistent with the input NetmaskLength.
400	MissingParam.Cidr	The Cidr must be input when adding CIDR for IPAM private top pool.
400	UnsupportedFeature.AddCidrForIpamPrivateIpv6Pool	Adding CIDR for IPAM private IPv6 pool is not supported for this user.
400	UnsupportedFeature.AddUlaCidrForIpamPublicIpv6Pool	Adding ULA CIDR for IPAM public IPv6 pool is not supported.
400	IllegalParam.NetmaskLength	The specified NetmaskLength is illegal.
400	OperationDenied.CidrConflictWithOfficialGuaCidrs	The operation is not allowed because the input CIDR conflicts with official GUA CIDRs.
400	OperationDenied.CidrUnavailableInPool	The operation is not allowed because the CIDR is unavailable in the IPAM pool.
400	OperationDenied.AvailableCidrInsufficient	The operation is not allowed because available CIDR is insufficient.
400	OperationDenied.OfficialCidrInsufficient	The operation is not allowed because the official CIDR is insufficient.
400	OperationDenied.OfficialCidrUnavailable	The operation is not allowed because the official CIDR is unavailable.
400	OperationDenied.OfficialCidrTmpUnavailable	The operation is not allowed because the official CIDR is temporarily unavailable.
400	UnsupportedFeature.AddUlaCidrForIpamPrivateIpv6Pool	Adding ULA CIDR for IPAM private IPv6 pool is not supported for this user.
400	UnsupportedFeature.AddByoipCidrForIpamPrivateIpv6Pool	Adding BYOIP CIDR for IPAM private IPv6 pool is not supported for this user.
400	OperationDenied.CidrMaskTooSmall	The operation is not allowed because the CIDR mask length %s is smaller than the minimum allowed %s.
400	OperationDenied.CidrMaskTooLarge	The operation is not allowed because the CIDR mask length %s is larger than the maximum allowed %s.
404	ResourceNotFound.IpamPool	The dependent IPAM pool is not found.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。