AWS CLI 使用時、最大で取得できる結果の件数 (MaxResults) があるデータを全件取得する方法を教えてください

AWSテクニカルサポートノート

#AWS

#AWS CLI

片方裕人

2025.04.03

困っていること

AWS CLI コマンドを使用してインベントリリスト取得を考えています。
以下のコマンドで取得しようとしましたが、最大で取得できる結果の件数 (MaxResults) が 50 に制限されているようで、50 件しか取得できません。全件取得する方法を教えてください。

$ aws ssm list-inventory-entries --instance-id xx-xxxxxxxxxxxxxxxx --type-name "AWS:Application"

なお、オプションの --max-results 100 を付与して実行した際は、以下のエラーが発生します。

An error occurred (ValidationException) when calling the ListInventoryEntries operation: 1 validation error detected: Value '100' at 'maxResults' failed to satisfy constraint: Member must have value less than or equal to 50

どう対応すればいいの?

AWS の API によっては、最大で取得できる結果の件数 (MaxResults) が設定されていることがございます。
MaxResults の数値を超える結果が返される場合、コマンドの実行結果に NextToken が含まれます。
そのため、前回のコマンド実行から返されたトークンを --next-token の引数に指定して実行することで続きを取得でき、NextToken がなくなるまでループさせることで全件の取得が可能です。

コマンドの実行結果に NextToken が含まれる例

{
            "ApplicationType": "System Environment/Libraries",
            "Architecture": "x86_64",
            "InstalledTime": "2025-xx-xxT01:33:22Z",
            "Name": "jansson",
            "PackageId": "xxxxxxxx-2.xx-x.el8.src.rpm",
            "Publisher": "xxxxx xxxxxx",
            "Release": "1.el8",
            "Summary": "C library for encoding, decoding and manipulating JSON data",
            "URL": "http://www.xxxx.xxxx/xxxxx/",
            "Version": "2.14"
        }
    ],
    "NextToken": "AAEAAYqF/ccccccccccccccccc/fffffffffffffffffffffffff/AqhuL0vKhIrTxjGo/xxxxxxxxx/LlIEOUZd3UsS1hi76/aaaaaaaaaaaaaaaaaaaaa/xxxxxxxxxxxxxxxxx/GUBZnUiEyIwN23GQ9aQwtI99coA/9yv9CTLiXJQqpy/aaaaaaaaaaaaaaaaaaaaa=="
}

出力された NextToken の値を次のコマンド実行時に --next-token パラメータとして指定することで続きを取得できます。

NextToken の値を次のコマンド実行時に --next-token パラメータとして指定する例

$ aws ssm list-inventory-entries --instance-id xx-xxxxxxxxxxxxxxxx --type-name "AWS:Application" --next-token "AAEAAYqF/ccccccccccccccccc/fffffffffffffffffffffffff/AqhuL0vKhIrTxjGo/xxxxxxxxx/LlIEOUZd3UsS1hi76/aaaaaaaaaaaaaaaaaaaaa/xxxxxxxxxxxxxxxxx/GUBZnUiEyIwN23GQ9aQwtI99coA/9yv9CTLiXJQqpy/aaaaaaaaaaaaaaaaaaaaa=="

--next-token (string)
The token for the next set of items to return. (You received this token from a previous call.)
--max-results (integer)
The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.