Amazon S3 で保管中のデータのオブジェクトの整合性を確認する

各バッチオペレーションジョブは、異なる [ジョブステータス] で進行します。S3 コンソールで AWS CloudTrail イベントを有効にして、ジョブの状態の変化に関するアラートを受信することもできます。アクティブなジョブについては、[ジョブの詳細] ページで実行中のジョブと完了率を確認できます。

create-job コマンドを使用して、新しいバッチオペレーションジョブを作成し、オブジェクトのリストを指定できます。次に、チェックサムアルゴリズムとチェックサムタイプ、および [チェックサムを計算] レポートを保存する送信先バケットを指定します。次の例では、S3 が AWS アカウント 111122223333 に生成したマニフェストを使用して S3 バッチレプリケーションの [チェックサムを計算] ジョブを作成します。

このコマンドを使用するには、ユーザー入力プレースホルダーを独自の情報に置き換えます。

aws s3control create-job \
    --account-id 111122223333 \
    --manifest '{"Spec":{"Format":"S3BatchOperations_CSV_20180820","Fields":["Bucket","Key"]},"Location":{"ObjectArn":"arn:aws:s3:::my-manifest-bucket/manifest.csv","ETag":"e0e8bfc50e0f0c5d5a1a5f0e0e8bfc50"}}' \
    --manifest-generator '{
        "S3JobManifestGenerator": {
          "ExpectedBucketOwner": "111122223333",
          "SourceBucket": "arn:aws:s3:::amzn-s3-demo-source-bucket",
          "EnableManifestOutput": true,
          "ManifestOutputLocation": {
            "ExpectedManifestBucketOwner": "111122223333",
            "Bucket": "arn:aws:s3:::amzn-s3-demo-manifest-bucket",
            "ManifestPrefix": "prefix",
            "ManifestFormat": "S3InventoryReport_CSV_20211130"
          },
          "Filter": {
            "CreatedAfter": "2023-09-01",
            "CreatedBefore": "2023-10-01",
            "KeyNameConstraint": {
              "MatchAnyPrefix": [
                "prefix"
              ],
              "MatchAnySuffix": [
                "suffix"
              ]
            },
            "ObjectSizeGreaterThanBytes": 100,
            "ObjectSizeLessThanBytes": 200,
            "MatchAnyStorageClass": [
              "STANDARD",
              "STANDARD_IA"
            ]
          }
        }
      }' \
    --operation '{"S3ComputeObjectChecksum":{"ChecksumAlgorithm":"CRC64NVME","ChecksumType":"FULL_OBJECT"}}' \
    --report '{"Bucket":"arn:aws:s3:::my-report-bucket","Format":"Report_CSV_20180820","Enabled":true,"Prefix":"batch-op-reports/","ReportScope":"AllTasks","ExpectedBucketOwner":"111122223333"}' \
    --priority 10 \
    --role-arn arn:aws:iam::123456789012:role/S3BatchJobRole \
    --client-request-token 6e023a7e-4820-4654-8c81-7247361aeb73 \
    --description "Compute object checksums" \
    --region us-west-2

[チェックサムを計算] ジョブを送信すると、ジョブ ID がレスポンスとして受信され、S3 バッチオペレーションのリストページに表示されます。Amazon S3 はオブジェクトのリストを処理し、各オブジェクトのチェックサムを計算します。ジョブが完了すると、S3 は指定された送信先に統合された [チェックサムを計算] レポートを提供します。

[チェックサムを計算] ジョブの進行状況をモニタリングするには、describe-job コマンドを使用します。このコマンドは、指定されたバッチオペレーションジョブのステータスをチェックします。このコマンドを使用するには、ユーザー入力プレースホルダーを独自の情報に置き換えます。

例:

aws s3control describe-job --account-id 111122223333 --job-id 1234567890abcdef0

すべての [アクティブ] および [完了] バッチオペレーションジョブのリストを取得するには、「AWS CLI コマンドリファレンス」の「ジョブのリスト取得」または「list-jobs」を参照してください。

CreateJob を使用して、[チェックサムを計算] でオブジェクトの整合性を検証する REST リクエストを送信できます。REST リクエストを DescribeJob API オペレーションに送信することで、[チェックサムを計算] リクエストの進行状況をモニタリングできます。各バッチオペレーションジョブは、次のステータスで進行します。

API レスポンスは、現在のジョブ状態を通知します。