ハンズオン(簡易版): S3基礎 バージョニング

3.7. S3オブジェクトの最新バージョンのダウンロード (handson-cli-s3-versioning-XXXXXXXXXXXX/handson-cli-s3.txt)

目的

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

パラメータの指定

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

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. ダウンロード用ディレクトリ

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

変数の設定:

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

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

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

変数の設定:

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. DIR_S3_OBJECT_OUTPUT:"${HOME}/environment/tmp-handson-cli-s3"
       DIR_S3_OBJECT_OUTPUT="${DIR_S3_OBJECT_OUTPUT}"
  # 4. 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

手順

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}"

ETX

コマンド:

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

結果(例):

{
    "AcceptRanges": "bytes",
    "LastModified": "Mon, 05 Oct 2020 23:05:16 GMT",
    "ContentLength": 6,
    "ETag": "\"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"",
    "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.