プレフィックスリストを作成します。
操作説明
操作の説明
-
プレフィックスリストは、CIDR ブロックであるネットワークプレフィックスのコレクションです。他のリソースのネットワークルールを設定する際に、プレフィックスリストをリファレンスできます。プレフィックスリストの詳細については、「プレフィックスリストの概要」を参照してください。
-
プレフィックスリストを作成する際:
プレフィックスリストのアドレスファミリ (IPv4 または IPv6) を指定する必要があります。同じプレフィックスリスト内のエントリは同じアドレスファミリに属している必要があり、プレフィックスリストの作成後にアドレスファミリを変更することはできません。
プレフィックスリストのエントリの最大値の設定項目を設定する必要があります。これはプレフィックスリストの作成後に変更することはできません。
プレフィックスリストのエントリを指定できます。各エントリは CIDR ブロックと説明で構成されます。エントリの数は、設定項目で設定したエントリの最大値を超えることはできません。
-
プレフィックスリストおよびその他のリソースの使用制限については、「使用制限」を参照してください。
-
RAM ユーザーを使用すると、Alibaba Cloud アカウントの認証情報を他のユーザーと共有することを回避できます。必要に応じてユーザーに最小権限を割り当てることで、企業の情報セキュリティリスクを軽減できます。Resource Access Management (RAM) ユーザーにプレフィックスリスト関連の権限を付与する方法の詳細については、「RAM ユーザーへのプレフィックスリスト関連の権限の付与」を参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ecs:CreatePrefixList |
create |
*All resources
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
リージョン ID。 |
cn-chengdu |
| MaxEntries |
integer |
必須 |
プレフィックスリストでサポートされるエントリの最大値。有効な値: 1~200。 |
10 |
| AddressFamily |
string |
必須 |
プレフィックスリストのアドレスファミリ。有効な値:
|
IPv4 |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを使用でき、長さは 64 文字を超えることはできません。詳細については、「べき等性の確保」を参照してください。 |
0c593ea1-3bea-11e9-b96b-88e9fe637760 |
| PrefixListName |
string |
必須 |
プレフィックスリストの名前。名前の長さは 2~128 文字で、先頭は英字または漢字にする必要があります。 |
PrefixListNameSample |
| Description |
string |
任意 |
プレフィックスリストの説明。説明の長さは 2~256 文字で、 |
This is description. |
| Entry |
array<object> |
任意 |
プレフィックスリストのエントリ情報。 |
|
|
object |
任意 |
|||
| Description |
string |
任意 |
プレフィックスリストのエントリの説明。説明の長さは 2~32 文字で、 |
Description Sample 01 |
| Cidr |
string |
必須 |
プレフィックスリストのエントリの CIDR ブロック。N の有効な値: 0~200。注意事項:
CIDR ブロックの詳細については、「CIDR とは」を参照してください。 デフォルト値: 空。 |
192.168.1.0/24 |
| Tag |
array<object> |
任意 |
タグ。 |
|
|
object |
任意 |
タグ。 |
||
| Key |
string |
任意 |
プレフィックスリストのタグキー。N の有効な値: 1~20。このパラメーターを指定する場合、空文字列にすることはできません。タグキーの長さは最大 128 文字で、 |
TestKey |
| Value |
string |
任意 |
プレフィックスリストのタグ値。N の有効な値: 1~20。このパラメーターは空文字列にすることができます。 タグ値の長さは最大 128 文字で、 |
TestValue |
| ResourceGroupId |
string |
任意 |
プレフィックスリストが属するリソースグループの ID。 |
rg-bp67acfmxazb4p**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| PrefixListId |
string |
プレフィックスリストの ID。 |
pl-x1j1k5ykzqlixdcy**** |
| RequestId |
string |
リクエスト ID |
38793DB8-A4B2-4AEC-BFD3-111234E9188D |
例
成功レスポンス
JSONJSON
{
"PrefixListId": "pl-x1j1k5ykzqlixdcy****",
"RequestId": "38793DB8-A4B2-4AEC-BFD3-111234E9188D"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | MissingParameter | %s | 必須パラメーターが指定されていません。 |
| 400 | InvalidParameter.AddressFamily | The parameter AddressFamily should be IPv4 or IPv6. | アドレスファミリは IPv4 または IPv6 である必要があります。 |
| 400 | InvalidParameter | %s | 現在のリクエストパラメーターが無効です。もう一度お試しください。 |
| 400 | InvalidParameter.PrefixListName | The parameter PrefixListName is not valid. | プレフィックスリスト名が無効です。 |
| 400 | InvalidDescription.Malformed | The specified Description is wrongly formed. | |
| 400 | InvalidClientToken.ValueNotSupported | The ClientToken provided is invalid. | 指定された ClientToken が無効です。 |
| 400 | InvalidParameter.CidrMalformed | %s | 指定された Classless Inter-Domain Routing (CIDR) ブロックが無効です。 |
| 400 | InvalidParameter.CidrDuplicated | %s | 指定された CIDR ブロックが重複しています。 |
| 400 | LimitExceed.Entry | The number of entries added or removed exceeds the limit. | 1 回のリクエストで追加または削除されるエントリ数が上限を超えています。 |
| 400 | LimitExceed.MaxEntries | The number of entries exceeds the MaxEntries of the specified prefix list. | エントリ数が、指定されたプレフィックスリストでサポートされているエントリの最大数を超えています。 |
| 404 | LimitExceed.PrefixListPerRegion | The number of prefix lists in the region exceeds the limit. | 現在のリージョンにおけるプレフィックスリストの数が上限を超えています。 |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定された RegionId が存在しません。指定されたリージョンでこのプロダクトが利用可能かどうかを確認してください。 |
| 404 | InvalidResourceGroup.NotFound | The specified resource group is not found. | レコードにリソースグループが見つかりません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。