2.1.2. AWS CLIのページングオプション (no paginate)¶

手順の目的¶

AWS CLIのページング機能を確認します。

手順に必要な設定値を変数に格納をします。

S3バケット名を指定します。

変数の設定:

S3_BUCKET_PREFIX='handson-cli-awscli-output'

コマンド:

aws_account_id=$( \
  aws sts get-caller-identity \
    --query 'Account' \
    --output text \
) \
  && echo ${aws_account_id}

結果(例):

<AWSアカウントID>

変数の設定:

S3_BUCKET_NAME="${S3_BUCKET_PREFIX}-${aws_account_id}" \
  && echo ${S3_BUCKET_NAME}

結果(例):

handson-cli-awscli-output-<AWSアカウントID>

各変数に正しい設定値が格納されていることを確認します。

変数の確認:

cat << END

  # 1. S3_BUCKET_NAME:"handson-cli-awscli-output-<AWSアカウントID>"
       S3_BUCKET_NAME="${S3_BUCKET_NAME}"

END

各変数について、上の行と下の行の値の内容もしくは形式が同じであることを確認します。もし異なる場合は、それぞれの手順番号に戻って変数の設定を行います。

S3バケットのオブジェクト数の確認

S3バケットのオブジェクト数を確認します。

コマンド:

aws s3api list-objects-v2 \
  --bucket ${S3_BUCKET_NAME} \
  --no-paginate \
  --query 'length(Contents[])'

結果(例):

注釈

AWS CLIは、no-paginateパラメータを指定すると、サービスのページ分割ロジックに従い、最初の1ページ目の出力だけを取得します。

S3のデフォルトページサイズは1000です。

「S3バケット"handson-cli-awscli-output-<AWSアカウントID>"のオブジェクト一覧を確認できている。」ことを確認します。

注釈

処理の実行で取得できていればOKです。