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

プレフィックスリストの構成を変更します。

操作説明

ModifyVpcPrefixList インターフェースは非同期インターフェースです。つまり、システムはリクエスト ID を返しますが、その時点ではプレフィックスリストインスタンスの構成情報はまだ変更されておらず、バックグラウンドで変更タスクが実行中です。ListPrefixLists を呼び出して、プレフィックスリストインスタンスのステータスを確認できます。
- プレフィックスリストインスタンスのステータスが Modifying の場合、構成情報が変更中の状態です。
- プレフィックスリストインスタンスのステータスが Created の場合、構成情報の変更が完了しています。
- プレフィックスリストインスタンスの構成情報の変更が完了した後は、GetVpcPrefixListAssociations インターフェースを呼び出してプレフィックスリストの関連付け情報を確認し、関連付けられたリソースが変更後の CIDR ブロックを使用しているかを判断できます。プレフィックスリストの関連ステータス（Status パラメーター）が Created である場合、関連付けられたリソースは変更後の CIDR ブロックを使用しています。
ModifyVpcPrefixList インターフェースは、同一のプレフィックスリストインスタンスの構成情報を並行して変更することをサポートしていません。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
PrefixListId	string	必須	プレフィックスリストの ID です。	pl-0b7hwu67****
PrefixListName	string	任意	プレフィックスリストの新しい名前です。名前は 1～128 文字で指定する必要があります。また、`http://` または `https://` で開始することはできません。	newname
ClientToken	string	任意	リクエストのべき等性を保証するために使用されるクライアントトークンです。クライアント側で値を生成できますが、異なるリクエスト間で一意となるようにしてください。トークンには ASCII 文字のみを使用できます。説明このパラメーターを指定しない場合、システムは RequestId を ClientToken として使用します。RequestId は各 API リクエストごとに異なる可能性があります。	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	任意	リクエストの事前チェックのみを行うかどうかを指定します。有効な値は次のとおりです。 true：操作を実行せずにリクエストをチェックします。システムは必須パラメーター、リクエスト構文、および制限を事前チェックします。事前チェックに失敗した場合はエラーメッセージが返されます。事前チェックに成功した場合は、`DryRunOperation` エラーコードが返されます。 false (デフォルト)：リクエストを送信します。チェックに合格した場合、2xx HTTP ステータスコードが返され、操作が実行されます。	false
AddPrefixListEntry	array<object>	任意	プレフィックスリストに追加する CIDR ブロックの情報です。
	object	任意
Cidr	string	任意	プレフィックスリストに追加する CIDR ブロックです。説明 CIDR ブロックがすでにプレフィックスリストに存在する場合、AddPrefixListEntry.N.Description パラメーターを設定することで、CIDR ブロックの説明のみを変更できます。	172.16.0.0/12
Description	string	任意	プレフィックスリストに追加する CIDR ブロックの説明です。説明は 1～128 文字で指定する必要があります。また、`http://` または `https://` で開始することはできません。	newcidr
RemovePrefixListEntry	array<object>	任意	プレフィックスリストから削除する CIDR ブロックの情報です。
	object	任意
Cidr	string	任意	プレフィックスリストから削除する CIDR ブロックです。	192.168.0.0/16
Description	string	任意	削除する CIDR ブロックの説明です。	cidr
RegionId	string	必須	プレフィックスリストのリージョン ID です。	cn-hangzhou
PrefixListDescription	string	任意	プレフィックスリストの新しい説明です。説明は 1～256 文字で指定する必要があります。また、`http://` または `https://` で開始することはできません。	newdescription
MaxEntries	integer	任意	プレフィックスリストの構成を変更した後に、プレフィックスリストがサポートする CIDR ブロックの最大数です。	20

レスポンスフィールド

フィールド	型	説明	例
	object
PrefixListId	string	プレフィックスリストの ID です。	pl-0b7hwu67****
RequestId	string	リクエストの ID です。	54B48E3D-DF70-471B-AA93-08E683A1B45

例

成功レスポンス

JSONJSON

{
  "PrefixListId": "pl-0b7hwu67****",
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	ResourceNotFound.PrefixList	The specified resource of prefixList is not found.
400	OperationFailed.CidrCountExceedMaxCount	The operation is failed because of cidrCountExceedMaxCount.
400	OperationDenied.RemoveCountExceedExistCount	The operation is not allowed because of remove-count exceed exist-count.
400	DuplicatedParam.CidrBlock	The param of cidrBlock is duplicated.
400	IllegalParam.CidrBlock	The param of cidrBlock is illegal.
400	IllegalParam.CidrName	The param of cidrName is illegal.
400	OperationDenied.SystemPrefixList	This is not allowed to operate system prefixList.
400	OperationFailed.OperateShareResource	This is not allowed to operate shared prefixList.
400	IncorrectStatus.PrefixList	The status of prefixList is incorrect.
400	QuotaExceeded.PrefixListCidrCount	The quota of prefixList entry maxEntry count is exceeded.
400	QuotaExceeded	Route entry quota exceeded in associated route table.
400	OperationDenied.QuotaExceededWithNetworkAcl	If the prefix list increases MaxEntries, the quota for the maximum number of entries for the associated network ACL instance %s is exceeded.
400	ServiceUnavailable	The request has failed due to a temporary failure of the server.	一時的なサーバー障害が発生したため、リクエストに失敗しました。

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

変更履歴

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