既存のバッチオペレーションジョブへのジョブタグの追加 - Amazon Simple Storage Service

既存のバッチオペレーションジョブへのジョブタグの追加

PutJobTagging API オペレーションを使用して、既存の Amazon S3 バッチオペレーションジョブにジョブタグを追加できます。詳細については、以下の例を参照してください。

AWS CLI を使用し、s3control put-job-tagging を使用して S3 バッチオペレーションジョブにジョブタグを追加する例を次に示します。例を使用するには、user input placeholders をユーザー自身の情報に置き換えます。

注記

タグセットを空にしてこのリクエストを送信すると、バッチオペレーション によってオブジェクトの既存のタグセットが削除されます。ただし、この方法を使用する場合は、階層 1 リクエスト (PUT) に対して料金が発生します。詳細については、「Amazon S3 の料金」を参照してください。

代わりに、バッチオペレーションジョブの既存のタグを削除するには、DeleteJobTagging オペレーションをお勧めします。このオペレーションでは、料金が発生せずに同じ結果が得られるためです。

  1. ジョブに必要なジョブ TAGS を特定します。この場合、2 つのタグ department および FiscalYear を適用し、値 Marketing および 2020 をそれぞれ使用します。

    read -d '' TAGS <<EOF
[
  {
    "Key": "department",
    "Value": "Marketing"
  },
  {
    "Key": "FiscalYear",
    "Value": "2020"
  }
]
EOF

  2. 次の必須パラメータを使用して、put-job-tagging コマンドを実行します。

    aws \
    s3control put-job-tagging \
    --account-id 123456789012 \
    --tags "${TAGS//$'\n'/}" \
    --job-id Example-e25a-4ed2-8bee-7f8ed7fc2f1c \
    --region us-east-1

次の例では、AWS SDK for Java を使用して S3 バッチオペレーションジョブのタグを配置します。

public void putJobTagging(final AWSS3ControlClient awss3ControlClient,
                          final String jobId) {
    final S3Tag departmentTag = new S3Tag().withKey("department").withValue("Marketing");
    final S3Tag fiscalYearTag = new S3Tag().withKey("FiscalYear").withValue("2020");

    final PutJobTaggingRequest putJobTaggingRequest = new PutJobTaggingRequest()
            .withJobId(jobId)
            .withTags(departmentTag, fiscalYearTag);

    final PutJobTaggingResult putJobTaggingResult = awss3ControlClient.putJobTagging(putJobTaggingRequest);
}