すべてのプロダクト
Search

このプロダクト

    Virtual Private Cloud:ListPrefixLists

    ドキュメントセンター

    Virtual Private Cloud:ListPrefixLists

    最終更新日:Apr 27, 2026

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

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vpc:ListPrefixLists

    list

    PrefixList

    acs:vpc:{#regionId}:{#accountId}:prefixlist/*

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    PrefixListIds

    array

    任意

    クエリ対象のプレフィックスリストの ID です。N の有効値は 1 ～ 100 で、一度に最大 100 個のプレフィックスリストをクエリできます。

    pl-m5estsqsdqwg88hjf****

    string

    任意

    プレフィックスリストの ID です。

    pl-0b7hwu67****
    NextToken

    string

    任意

    次のリクエストで新しいページの結果を取得するために使用するページネーショントークンです。有効値：

    • 最初のリクエストでは、このパラメーターを指定する必要はありません。

    • 前回のクエリから取得したトークンを NextToken の値として指定する必要があります。

    FFmyTO70tTpLG6I3FmYAXGKPd****
    MaxResults

    integer

    任意

    1 ページあたりのエントリ数です。有効値：1 ～ 100。デフォルト値：20。

    20
    ResourceGroupId

    string

    任意

    プレフィックスリストが属するリソースグループの ID です。

    rg-bp67acfmxazb4ph****
    Tags

    array<object>

    任意

    タグです。

    object

    任意

    Key

    string

    任意

    タグキーです。最大 20 個のタグキーを指定できます。タグキーは空文字列にできません。

    キーの長さは最大 64 文字で、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。キーは英字で始まる必要がありますが、aliyun または acs: で始まってはいけません。また、http:// または https:// を含んではいけません。

    FinanceDept
    Value

    string

    任意

    タグ値です。最大 20 個のタグ値を指定できます。タグ値は空の文字列でもかまいません。

    タグ値の長さは 128 文字以内で、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。キーは英字で始まる必要がありますが、aliyun または acs: で始めることはできません。また、キーに http:// または https:// を含めることはできません。

    FinanceJoshua
    RegionId

    string

    必須

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

    最新のリージョンリストをクエリするには、DescribeRegions 操作を呼び出してください。

    cn-hangzhou
    PrefixListName

    string

    任意

    クエリするプレフィックスリストの名前です。

    名前の長さは 1 ～ 128 文字で、http:// または https:// で始まってはいけません。

    name

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    リクエスト ID です。

    RequestId

    string

    リクエスト ID です。

    DF72F7BB-5DFA-529C-887E-B0BB70D89C4F
    NextToken

    string

    ページネーショントークンです。次のリクエストで新しいページの結果を取得するために使用できます。有効値：

    • NextToken が空の場合、次のページは存在しません。

    • NextToken に値が返された場合、その値は次のリクエストで新しいページの結果を取得するために使用するトークンを示します。

    FFmyTO70tTpLG6I3FmYAXGKPd****
    TotalCount

    integer

    返されたエントリの総数です。

    1
    MaxResults

    integer

    1 ページあたりのエントリ数です。有効値：1 ～ 100。デフォルト値：20。

    20
    PrefixLists

    array<object>

    プレフィックスリストに関する情報です。

    array<object>

    PrefixListId

    string

    プレフィックスリストの ID です。

    pl-m5estsqsdqwg88hjf****
    PrefixListName

    string

    プレフィックスリストの名前です。

    test
    PrefixListDescription

    string

    プレフィックスリストの説明です。

    Created with oss service by system.
    IpVersion

    string

    プレフィックスリストの IP バージョンです。有効値：

    • IPV4

    • IPV6

    IPV4
    CreationTime

    string

    プレフィックスリストが作成された時刻です。

    2022-07-12T14:22:32Z
    CidrBlocks

    array

    プレフィックスリストで指定された CIDR ブロックです。

    string

    プレフィックスリストで指定された CIDR ブロックです。

    100.115.XX.XX/24
    ShareType

    string

    プレフィックスリストが共有されているかどうかを示します。有効値：

    • Shared：プレフィックスリストが共有されています。

    • 空の値が返された場合、プレフィックスリストは共有されていません。

    Shared
    MaxEntries

    integer

    プレフィックスリストに指定できる CIDR ブロックの最大数です。

    10
    Status

    string

    プレフィックスリストのステータスです。有効値：

    • Created

    • Deleted

    • Modifying

    Created
    OwnerId

    string

    プレフィックスリストが属する Alibaba Cloud アカウントです。

    1210123456123456
    PrefixListStatus

    string

    プレフィックスリストのステータスです。有効値：

    • Created

    • Deleted

    • Modifying

    説明

    このパラメーターは Status パラメーターと同じです。

    Created
    RegionId

    string

    プレフィックスリストのリージョン ID です。

    cn-hangzhou
    ResourceGroupId

    string

    プレフィックスリストが属するリソースグループの ID です。

    rg-bp67acfmxazb4ph****
    Tags

    array<object>

    タグです。

    object

    Key

    string

    タグキーです。

    FinanceDept
    Value

    string

    タグ値です。

    FinanceJoshua
    PrefixListType

    string

    プレフィックスリストのタイプです。

    Custom

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 IllegalParam.NextToken The specified NextToken is invalid.

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

    変更履歴

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