CreateIpamPoolAllocation - Virtual Private Cloud - Alibaba Cloud ドキュメントセンター

IPAM プールからカスタム予約 CIDR ブロックを作成します。

操作説明

カスタム予約 CIDR ブロックを作成する前に、IPAM プールを作成し、そのプールに CIDR ブロックを追加していることを確認してください。CreateIpamPool 操作を呼び出して IPAM プールを作成し、AddIpamPoolCidr 操作を呼び出してプールに CIDR ブロックを追加できます。
Cidr または CidrMask パラメーターを指定してカスタム予約 CIDR ブロックを作成する場合、マスクは IPAM プールに指定された範囲内である必要があります。
IPAM プールにリージョン属性がある場合、カスタム予約 CIDR ブロックを作成するリクエストは、プールが配置されているリージョンから開始する必要があります。
カスタム予約 CIDR ブロックは、IPAM プール内の既存の CIDR ブロックの割り当てと競合してはなりません。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	カスタム予約 CIDR ブロックを作成するリージョンの ID。 DescribeRegions を呼び出してリージョン ID を取得できます。	cn-hangzhou
IpamPoolId	string	必須	IPAM プールの ID。	ipam-pool-6rcq3tobayc20t****
Cidr	string	任意	IPAM プールから割り当てる CIDR ブロック。説明 Cidr または CidrMask パラメーターのいずれかを指定する必要があります。	192.168.1.0/24
CidrMask	integer	任意	IPAM プールから割り当てる CIDR ブロックのマスク。説明 Cidr または CidrMask パラメーターのいずれかを指定する必要があります。	24
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。有効な値： true: チェックリクエストを送信します。カスタム予約 CIDR ブロックは作成されません。システムは、必須パラメーター、リクエストフォーマット、およびサービス制限を確認します。チェックに失敗すると、エラーが返されます。チェックに合格すると、DryRunOperation エラーコードが返されます。 false (デフォルト): 通常のリクエストを送信します。リクエストがチェックに合格すると、2xx の HTTP ステータスコードが返され、カスタム予約 CIDR ブロックが作成されます。	false
ClientToken	string	任意	リクエストのべき等性を保証するために使用されるクライアントトークン。クライアントで値を生成し、異なるリクエスト間で値が一意であることを確認してください。トークンには ASCII 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは自動的にリクエストの RequestId を ClientToken として使用します。RequestId はリクエストごとに異なる場合があります。	123e4567-e89b-12d3-a456-426655440000
IpamPoolAllocationDescription	string	任意	カスタム予約 CIDR ブロックの説明。説明は 1～256 文字である必要があります。文字または漢字で始める必要があり、`http://` または `https://` で始めることはできません。デフォルト値は空の文字列です。	test description
IpamPoolAllocationName	string	任意	カスタム予約 CIDR ブロックの名前。名前は 1～128 文字である必要があり、`http://` または `https://` で始めることはできません。	test name

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
RequestId	string	リクエスト ID。	CE9CDAE5-341E-5D0B-AC8A-2BAC707D3EB2
IpamPoolAllocationId	string	カスタム予約 CIDR ブロックの ID。	ipam-pool-alloc-112za33e4****
Cidr	string	割り当てられた CIDR ブロック。	192.168.1.0/24
SourceCidr	string	ソース CIDR ブロック。	192.168.0.0/16

例

成功レスポンス

JSONJSON

{
  "RequestId": "CE9CDAE5-341E-5D0B-AC8A-2BAC707D3EB2",
  "IpamPoolAllocationId": "ipam-pool-alloc-112za33e4****",
  "Cidr": "192.168.1.0/24",
  "SourceCidr": "192.168.0.0/16"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	OperationDenied.ResourceTypeIsNotCustom	The operation is not allowed because the resource type is not Custom.
400	MissingParam.CidrOrCidrMask	The CIDR or CIDR Mask must be input.
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	OperationDenied.RequestRegionInvalid	The operation is not allowed because the request is not invoked in the region of the IPAM pool.
400	IllegalParam.Cidr	The specified CIDR is illegal.
400	IllegalParam.CidrMask	The specified CidrMask is illegal.
400	DryRunOperation	Request validation has been passed with DryRun flag set.
400	OperationDenied.AvailableCidrInsufficient	The operation is not allowed because available CIDR is insufficient.
400	OperationDenied.CidrInExcludeCidrs	The operation is not allowed because the input CIDR is within the illegal CIDRs.
400	OperationDenied.CidrUnavailableInPool	The operation is not allowed because the CIDR is unavailable in the IPAM pool.
404	ResourceNotFound.IpamPool	The dependent IPAM pool is not found.

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

変更履歴

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