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

プレフィックスリストを作成します。

操作説明

指定された期間内に CreateVpcPrefixList 操作を繰り返し呼び出すことはできません。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
PrefixListName	string	任意	プレフィックスリストの名前です。名前は 1～128 文字で指定する必要があります。また、`http://` または `https://` で始まってはいけません。	name
PrefixListDescription	string	任意	プレフィックスリストの説明です。説明は 1～256 文字で指定する必要があります。また、`http://` または `https://` で始まってはいけません。	description
ClientToken	string	任意	リクエストのべき等性を保証するために使用されるクライアントトークンです。この値はクライアント側で生成できますが、すべてのリクエストの中で一意であることを保証する必要があります。ClientToken には ASCII 文字のみを使用できます。説明このパラメーターを指定しない場合、ClientToken は RequestId の値に設定されます。各 API リクエストの RequestId の値は異なる可能性があります。	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。有効な値は次のとおりです。 true：ドライランを実行します。システムは必要なパラメーター、リクエスト構文、および制限をチェックします。ドライランに失敗した場合は、エラーメッセージが返されます。ドライランに成功した場合は、`DryRunOperation` エラーコードが返されます。 false (デフォルト)：ドライランを実行せずにリクエストを送信します。ドライランに成功した場合は、HTTP ステータスコード 2xx が返され、操作が実行されます。	false
MaxEntries	integer	任意	プレフィックスリストに指定できる CIDR ブロックの最大数です。デフォルト値は 50 です。	50
PrefixListEntries	array<object>	任意	プレフィックスリストに指定する CIDR ブロック情報です。
	object	任意
Cidr	string	任意	プレフィックスリストに指定する CIDR ブロックです。	192.168.0.0/16
Description	string	任意	プレフィックスリストに指定する CIDR ブロックの説明です。説明は 1～256 文字で指定する必要があります。また、`http://` または `https://` で始まってはいけません。	CIDR
ResourceGroupId	string	任意	プレフィックスリストが属するリソースグループの ID です。	rg-bp67acfmxazb4ph****
RegionId	string	必須	プレフィックスリストを作成するリージョンの ID です。最新のリージョンリストを確認するには、DescribeRegions 操作を呼び出してください。	cn-hangzhou
IpVersion	string	任意	IP バージョンです。有効な値は次のとおりです。 IPv4 (デフォルト) IPv6	IPv4
Tag	array<object>	任意	タグリストです。
	object	任意
Key	string	任意	タグ N のキーです。最大 20 個のタグキーを指定できます。タグキーは空文字列であってはいけません。タグキーの長さは最大 128 文字です。`aliyun` または `acs:` で始まってはいけません。また、`http://` または `https://` を含んではいけません。	FinanceDept
Value	string	任意	タグ N の値です。最大 20 個のタグ値を指定できます。タグ値は空文字列であってもかまいません。タグ値の長さは最大 128 文字です。`http://` または `https://` を含んではいけません。また、`aliyun` または `acs:` で始まってはいけません。	FinanceJoshua

レスポンスフィールド

フィールド	型	説明	例
	object
PrefixListId	string	プレフィックスリストの ID です。	pl-0b700s2ee3***
RequestId	string	リクエストの ID です。	54B48E3D-DF70-471B-AA93-08E683A1B45
ResourceGroupId	string	プレフィックスリストが属するリソースグループの ID です。	rg-bp67acfmxazb4ph****

例

成功レスポンス

JSONJSON

{
  "PrefixListId": "pl-0b700s2ee3***",
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "ResourceGroupId": "rg-bp67acfmxazb4ph****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	UnsupportedFeature.IpVersion	The ipversion type is not supported.
400	QuotaExceeded.PrefixListCidrCount	The quota of prefixListMaxEntry count is exceeded.
400	OperationFailed.CidrCountExceedMaxCount	The operation is failed because of cidrCountExceedMaxCount.
400	IllegalParam.CidrBlock	The param of cidrBlock is illegal.
400	IllegalParam.CidrName	The param of cidrName is illegal.
400	DuplicatedParam.CidrBlock	The param of cidrBlock is duplicated.
400	QuotaExceeded.PrefixListCount	The quota of prefixList count is exceeded.

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

変更履歴

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