0.txt)¶

目的¶

S3バケット"handson-cli-s3-object-XXXXXXXXXXXX"のオブジェクト"alpha/0.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-object'

コマンド:

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-object-XXXXXXXXXXXX

2. S3オブジェクトキー

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

変数の設定:
S3_OBJECT_KEY='alpha/0.txt'

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

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

変数の設定:

DIR_LOCAL="${HOME}/environment/local-handson-cli-s3-object"

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

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

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

コマンド:

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

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

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

変数の設定:

FILE_LOCAL="${DIR_LOCAL}/handson-cli-s3-object-object_operation-download.txt" \
  && echo ${FILE_LOCAL}

結果(例):

${HOME}/environment/local-handson-cli-s3-object/handson-cli-s3-object-object_operation-download.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-object-XXXXXXXXXXXX"
       S3_BUCKET_NAME="${S3_BUCKET_NAME}"
  # 2. S3_OBJECT_KEY:"alpha/0.txt"
       S3_OBJECT_KEY="${S3_OBJECT_KEY}"
  # 3. DIR_LOCAL:"${HOME}/environment/local-handson-cli-s3-object"
       DIR_LOCAL="${DIR_LOCAL}"
  # 4. FILE_LOCAL:"${HOME}/environment/local-handson-cli-s3-object/handson-cli-s3-object-object_operation-download.txt"
       FILE_LOCAL="${FILE_LOCAL}"

END

手順¶

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

変数の確認:

cat << ETX

  # S3_BUCKET_NAME:"handson-cli-s3-object-XXXXXXXXXXXX"
    S3_BUCKET_NAME="${S3_BUCKET_NAME}"
  # S3_OBJECT_KEY:"alpha/0.txt"
    S3_OBJECT_KEY="${S3_OBJECT_KEY}"
  # FILE_LOCAL:"${HOME}/environment/local-handson-cli-s3-object/handson-cli-s3-object-object_operation-download.txt"
    FILE_LOCAL="${FILE_LOCAL}"

ETX

コマンド:

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

結果(例):

{
    "AcceptRanges": "bytes",
    "LastModified": "Mon, 23 Nov 2020 01:23:45 GMT",
    "ContentLength": 6,
    "ETag": "\"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"",
    "ContentType": "binary/octet-stream",
    "Metadata": {}
}

完了確認¶

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

コマンド:

ls ${FILE_LOCAL}

結果(例):

${HOME}/environment/local-handson-cli-s3-object/handson-cli-s3-object-object_operation-download.txt

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

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

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

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