3.5. S3オブジェクトの特定バージョンのダウンロード (handson-cli-s3-versioning-XXXXXXXXXXXX/handson-cli-s3.txt)¶

目的¶

S3バケット"handson-cli-s3-versioning-XXXXXXXXXXXX"のオブジェクト"handson-cli-s3.txt"の"1"つ前のバージョンをダウンロードします。

パラメータの指定¶

作業に必要なパラメータを変数に格納をします。

0. プロファイルの指定

AWS認証ファイルを指定します。

環境変数の設定:

export AWS_SHARED_CREDENTIALS_FILE="${HOME}/environment/credentials-handson-cli-s3-MaintUser/handson-cli-s3-MaintUser.ini"

プロファイルを指定します。

環境変数の設定:

export AWS_DEFAULT_PROFILE='handson-cli-s3-MaintUser'

1. S3バケット名

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

変数の設定:

S3_BUCKET_PREFIX='handson-cli-s3-versioning'

コマンド:

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

結果(例):

XXXXXXXXXXXX

変数の設定:

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

結果(例):

handson-cli-s3-versioning-XXXXXXXXXXXX

2. S3オブジェクトキー

オブジェクトキーを指定します。

変数の設定:
S3_OBJECT_KEY='handson-cli-s3.txt'

3. S3オブジェクトの前世代数

S3オブジェクトの前世代数を指定します。

変数の設定:
COUNT_OLDER='1'

4. ダウンロード用ディレクトリ

ダウンロード用ディレクトリを指定します。

変数の設定:

DIR_S3_OBJECT_OUTPUT="${HOME}/environment/tmp-handson-cli-s3"

ディレクトリが存在することを確認します。

コマンド:
ls -d ${HOME}/environment/tmp-handson-cli-s3
結果(例:存在する場合):
${HOME}/environment/tmp-handson-cli-s3

存在しない場合は作成します。

コマンド:

mkdir -p ${HOME}/environment/tmp-handson-cli-s3

5. ダウンロードファイル名

ダウンロードしたファイルの保存ファイル名を指定します。

変数の設定:

FILE_S3_OBJECT_OUTPUT="${DIR_S3_OBJECT_OUTPUT}/${S3_BUCKET_NAME}-${S3_OBJECT_KEY}" \
  && echo ${FILE_S3_OBJECT_OUTPUT}

結果(例):

${HOME}/environment/tmp-handson-cli-s3/handson-cli-s3-versioning-XXXXXXXXXXXX-handson-cli-s3.txt

各変数に正しいパラメータ値が格納されていることを確認します。

変数の確認:

cat << END

  # 0. AWS_SHARED_CREDENTIALS_FILE:"${HOME}/environment/credentials-handson-cli-s3-MaintUser/handson-cli-s3-MaintUser.ini"
       AWS_SHARED_CREDENTIALS_FILE="${AWS_SHARED_CREDENTIALS_FILE}"
  #    AWS_DEFAULT_PROFILE:"handson-cli-s3-MaintUser"
       AWS_DEFAULT_PROFILE="${AWS_DEFAULT_PROFILE}"

  # 1. S3_BUCKET_NAME:"handson-cli-s3-versioning-XXXXXXXXXXXX"
       S3_BUCKET_NAME="${S3_BUCKET_NAME}"
  # 2. S3_OBJECT_KEY:"handson-cli-s3.txt"
       S3_OBJECT_KEY="${S3_OBJECT_KEY}"
  # 3. COUNT_OLDER:"1"
       COUNT_OLDER="${COUNT_OLDER}"
  # 4. DIR_S3_OBJECT_OUTPUT:"${HOME}/environment/tmp-handson-cli-s3"
       DIR_S3_OBJECT_OUTPUT="${DIR_S3_OBJECT_OUTPUT}"
  # 5. FILE_S3_OBJECT_OUTPUT:"${HOME}/environment/tmp-handson-cli-s3/handson-cli-s3-versioning-XXXXXXXXXXXX-handson-cli-s3.txt"
       FILE_S3_OBJECT_OUTPUT="${FILE_S3_OBJECT_OUTPUT}"

END

手順¶

オブジェクトのバージョンIDを取得します。

コマンド:

S3_OBJECT_VERSION_ID=$( \
  aws s3api list-object-versions \
    --bucket ${S3_BUCKET_NAME} \
    --prefix ${S3_OBJECT_KEY} \
    --query "reverse(sort_by(Versions, &LastModified))["${COUNT_OLDER}"].VersionId" \
    --output text \
) \
  && echo ${S3_OBJECT_VERSION_ID}

結果(例):

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

S3オブジェクトをダウンロードします。

変数の確認:

cat << ETX

  # S3_BUCKET_NAME:"handson-cli-s3-versioning-XXXXXXXXXXXX"
    S3_BUCKET_NAME="${S3_BUCKET_NAME}"
  # S3_OBJECT_KEY:"handson-cli-s3.txt"
    S3_OBJECT_KEY="${S3_OBJECT_KEY}"
  # FILE_S3_OBJECT_OUTPUT:"${HOME}/environment/tmp-handson-cli-s3/handson-cli-s3-versioning-XXXXXXXXXXXX-handson-cli-s3.txt"
    FILE_S3_OBJECT_OUTPUT="${FILE_S3_OBJECT_OUTPUT}"
  # S3_OBJECT_VERSION_ID:"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    S3_OBJECT_VERSION_ID="${S3_OBJECT_VERSION_ID}"

ETX

コマンド:

aws s3api get-object \
  --bucket ${S3_BUCKET_NAME} \
  --key ${S3_OBJECT_KEY} \
  ${FILE_S3_OBJECT_OUTPUT} \
  --version-id ${S3_OBJECT_VERSION_ID}

結果(例):

{
    "AcceptRanges": "bytes",
    "LastModified": "Thu, 08 Oct 2020 10:05:16 GMT",
    "ContentLength": 7,
    "ETag": "\"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"",
    "VersionId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ContentType": "text/plain",
    "Metadata": {}
}

完了確認¶

「ダウンロードファイル"${HOME}/environment/local-handson-cli-s3/handson-cli-s3.txt"が存在する。」ことを確認します。

コマンド:

ls ${FILE_S3_OBJECT_OUTPUT}

結果(例):

${HOME}/environment/tmp-handson-cli-s3/handson-cli-s3-versioning-XXXXXXXXXXXX-handson-cli-s3.txt

環境変数を削除して、プロファイルの権限を無効にします。

環境変数の設定:
export -n AWS_DEFAULT_PROFILE

ファイルの表示

ダウンロードしたファイルを表示します。

コマンド:
cat ${FILE_S3_OBJECT_OUTPUT}
結果(例):
Alpha.