ハンズオン(簡易版): AWS CLI基礎 (入力)

1.7. S3オブジェクトの一覧取得 (scenario-awscli-input-<AWSアカウントID>)

手順の目的

S3バケット"scenario-awscli-input-<AWSアカウントID>"のオブジェクトを確認します。

設定値の指定

設定値の指定

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

1. S3バケット名

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

変数の設定:

S3_BUCKET_PREFIX='scenario-awscli-input'

コマンド:

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}

結果(例):

scenario-awscli-input-<AWSアカウントID>

2. 最大表示数

最大表示数を指定します。

変数の設定:

AWSCLI_MAX_ITEMS='1'

設定値の確認

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

変数の確認:

cat << END

  # 1. S3_BUCKET_NAME:"scenario-awscli-input-<AWSアカウントID>"
       S3_BUCKET_NAME="${S3_BUCKET_NAME}"
  # 2. AWSCLI_MAX_ITEMS:"1"
       AWSCLI_MAX_ITEMS="${AWSCLI_MAX_ITEMS}"

END

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

処理の実行

オブジェクト一覧を取得します。

変数の確認:

cat << END

 # S3_BUCKET_NAME:"scenario-awscli-input-<AWSアカウントID>"
   S3_BUCKET_NAME="${S3_BUCKET_NAME}"
 # AWSCLI_MAX_ITEMS:"1"
   AWSCLI_MAX_ITEMS="${AWSCLI_MAX_ITEMS}"

END

コマンド:

aws s3api list-objects-v2 \
  --bucket ${S3_BUCKET_NAME} \
  --max-items ${AWSCLI_MAX_ITEMS}

結果(例):

{
    "Contents": [
        {
            "Key": "test-alfa.jpg",
            "LastModified": "2023-08-24T01:23:45+00:00",
            "ETag": ""xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"",
            "Size": 55560,
            "StorageClass": "STANDARD"
        }
    ],
    "NextToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

完了確認

本手順の主処理は、以下の完了条件を満たしたときに成功したものとします。

完了条件1: S3バケット"scenario-awscli-input-<AWSアカウントID>"のオブジェクトを確認できている。

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

注釈

主処理で取得できていればOKです。

手順の完了