すべてのプロダクト
Search

このプロダクト

    Elastic Compute Service:CreatePrefixList

    ドキュメントセンター

    Elastic Compute Service:CreatePrefixList

    最終更新日:Apr 04, 2026

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

    操作説明

    注意事項

    • プレフィックスリストは、ネットワークプレフィックス (CIDR ブロック) のコレクションであり、他のリソースのネットワークルールを設定するために参照できます。 詳細については、「概要」をご参照ください。

    • プレフィックスリストを作成する際は、次の点にご注意ください。

      • プレフィックスリストの IP アドレスファミリ (IPv4 または IPv6) を指定する必要があります。プレフィックスリストの作成後に IP アドレスファミリを変更することはできません。 1 つのプレフィックスリストに IPv4 と IPv6 の CIDR ブロックを混在させることはできません。

      • プレフィックスリストに含めることができる最大エントリ数を指定する必要があります。 プレフィックスリストの作成後に最大エントリ数を変更することはできません。

      • プレフィックスリストのエントリを指定できます。 各エントリは、CIDR ブロックと CIDR ブロックの説明で構成されます。 エントリの総数は、指定した最大エントリ数を超えることはできません。

    • プレフィックスリストやその他のリソースの制限事項の詳細については、「使用制限」をご参照ください。

    • Resource Access Management (RAM) ユーザーを作成し、最小権限を付与することができます。 これにより、Alibaba Cloud アカウントの AccessKey ペアを他のユーザーと共有する必要がなくなり、企業のセキュリティリスクが軽減されます。 プレフィックスリストに対する権限を RAM ユーザーに付与する方法については、「プレフィックスリストに対する権限を RAM ユーザーに付与する」をご参照ください。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ecs:CreatePrefixList

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    プレフィックスリストを作成するリージョンの ID。

    cn-chengdu
    RegionId

    string

    必須

    プレフィックスリストを作成するリージョンの ID。

    cn-chengdu
    MaxEntries

    integer

    必須

    プレフィックスリストに含めることができる最大エントリ数。 有効値：1～200。

    10
    AddressFamily

    string

    必須

    IP アドレスファミリ。 有効値：

    • IPv4

    • IPv6

    IPv4
    ClientToken

    string

    任意

    リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。 token には ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。 詳細については、「べき等性を確保する方法」をご参照ください。

    0c593ea1-3bea-11e9-b96b-88e9fe637760
    PrefixListName

    string

    必須

    プレフィックスリストの名前。 名前は 2～128 文字で、文字、数字、コロン (:)、アンダースコア (_)、ピリオド (.)、ハイフン (-) を使用できます。 先頭は文字である必要があり、http://、https://、com.aliyun、com.alibabacloud で始めることはできません。

    PrefixListNameSample
    Description

    string

    任意

    プレフィックスリストの説明。 説明は 2～256 文字で、http:// または https:// で始めることはできません。

    This is description.
    Entry

    array<object>

    任意

    プレフィックスリストのエントリの詳細。

    object

    任意

    Description

    string

    任意

    エントリ N の説明。 説明は 2～32 文字で、http:// または https:// で始めることはできません。 N の有効値：0～200。

    Description Sample 01
    Cidr

    string

    必須

    エントリ N の CIDR ブロック。 N の有効値：0～200。 注意事項：

    • エントリの総数は MaxEntries の値を超えることはできません。

    • CIDR ブロックのタイプは、IP アドレスファミリによって決まります。 1 つのプレフィックスリストに IPv4 と IPv6 の CIDR ブロックを混在させることはできません。

    • CIDR ブロックは、プレフィックスリスト内のすべてのエントリで一意である必要があります。 たとえば、プレフィックスリストのエントリに 192.168.1.0/24 を 2 回指定することはできません。

    • 単一の IP アドレスを設定できます。 システムは IP アドレスを自動的に CIDR ブロックに変換します。 たとえば、192.168.1.100 を設定すると、システムは自動的に 192.168.1.100/32 に変換します。

    • IPv6 CIDR ブロックを使用する場合、システムは CIDR ブロックをゼロ圧縮し、文字を小文字に自動的に変換します。 たとえば、2001:0DB8:0000:0000:0000:0000:0000:0000/32 を指定すると、システムはそれを 2001:db8::/32 に変換します。

    CIDR ブロックの詳細については、「CIDR とは」をご参照ください。

    このパラメーターは、デフォルトでは空のままです。

    192.168.1.0/24
    Tag

    array<object>

    任意

    プレフィックスリストに追加するタグ。

    object

    任意

    プレフィックスリストに追加するタグ N。

    Key

    string

    任意

    タグ N のキー。 N の有効値：1～20。 タグキーは空の文字列にできません。 タグキーは最大 128 文字で、acs: または aliyun で始めることはできません。 http:// または https:// を含めることはできません。

    TestKey
    Value

    string

    任意

    タグ N の値。 N の有効値：1～20。 タグ値は空の文字列にできます。

    タグ値は最大 128 文字で、 http:// または https:// を含めることはできません。

    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.
    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.
    400 InvalidParameter.CidrMalformed %s
    400 InvalidParameter.CidrDuplicated %s
    400 LimitExceed.Entry The number of entries added or removed exceeds the limit.
    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.
    404 InvalidResourceGroup.NotFound The specified resource group is not found.

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

    変更履歴

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