Menggunakan Operasi Batch S3 dengan mode kepatuhan retensi Kunci Objek S3

Contoh berikut dibangun berdasarkan contoh sebelumnya tentang pembuatan kebijakan kepercayaan dan pengaturan izin konfigurasi Operasi Batch S3 dan Kunci Objek S3 pada objek Anda. Contoh ini menetapkan mode retensi ke COMPLIANCE dan retain until date ke 1 Januari 2025. Contoh ini membuat job yang menargetkan objek dalam bucket manifes dan melaporkan hasilnya di bucket laporan yang Anda identifikasi.

Untuk menggunakan contoh berikut, ganti user input placeholders dengan informasi Anda sendiri.

Menggunakan AWS CLI

AWS CLI Contoh berikut menunjukkan cara menggunakan Operasi Batch untuk menerapkan mode kepatuhan retensi Kunci Objek S3 di beberapa objek.

contoh - Atur mode kepatuhan retensi Kunci Objek S3 di beberapa objek

export AWS_PROFILE='aws-user'
export AWS_DEFAULT_REGION='us-west-2'
export ACCOUNT_ID=123456789012
export ROLE_ARN='arn:aws:iam::123456789012:role/batch_operations-objectlock'

read -d '' OPERATION <<EOF
{
  "S3PutObjectRetention": {
    "Retention": {
      "RetainUntilDate":"2025-01-01T00:00:00",
      "Mode":"COMPLIANCE"
    }
  }
}
EOF

read -d '' MANIFEST <<EOF
{
  "Spec": {
    "Format": "S3BatchOperations_CSV_20180820",
    "Fields": [
      "Bucket",
      "Key"
    ]
  },
  "Location": {
    "ObjectArn": "arn:aws:s3:::amzn-s3-demo-manifest-bucket/compliance-objects-manifest.csv",
    "ETag": "Your-manifest-ETag"
  }
}
EOF

read -d '' REPORT <<EOF
{
  "Bucket": "arn:aws:s3:::ReportBucket",
  "Format": "Report_CSV_20180820",
  "Enabled": true,
  "Prefix": "amzn-s3-demo-completion-report-bucket/compliance-objects-batch-operations",
  "ReportScope": "AllTasks"
}
EOF

aws \
    s3control create-job \
    --account-id "${ACCOUNT_ID}" \
    --manifest "${MANIFEST//$'\n'}" \
    --operation "${OPERATION//$'\n'/}" \
    --report "${REPORT//$'\n'}" \
    --priority 10 \
    --role-arn "${ROLE_ARN}" \
    --client-request-token "$(uuidgen)" \
    --region "${AWS_DEFAULT_REGION}" \
    --description "Set compliance retain-until to 1 Jul 2030"; 

contoh — Perpanjang COMPLIANCE mode retain until date hingga 15 Januari 2025

Contoh berikut memperpanjang retain until date mode COMPLIANCE hingga 15 Januari 2025.

export AWS_PROFILE='aws-user'
export AWS_DEFAULT_REGION='us-west-2'
export ACCOUNT_ID=123456789012
export ROLE_ARN='arn:aws:iam::123456789012:role/batch_operations-objectlock'

read -d '' OPERATION <<EOF
{
  "S3PutObjectRetention": {
    "Retention": {
      "RetainUntilDate":"2025-01-15T00:00:00",
      "Mode":"COMPLIANCE"
    }
  }
}
EOF

read -d '' MANIFEST <<EOF
{
  "Spec": {
    "Format": "S3BatchOperations_CSV_20180820",
    "Fields": [
      "Bucket",
      "Key"
    ]
  },
  "Location": {
    "ObjectArn": "arn:aws:s3:::amzn-s3-demo-manifest-bucket/compliance-objects-manifest.csv",
    "ETag": "Your-manifest-ETag"
  }
}
EOF

read -d '' REPORT <<EOF
{
  "Bucket": "arn:aws:s3:::amzn-s3-demo-completion-report-bucket",
  "Format": "Report_CSV_20180820",
  "Enabled": true,
  "Prefix": "reports/compliance-objects-batch_operations",
  "ReportScope": "AllTasks"
}
EOF

aws \
    s3control create-job \
    --account-id "${ACCOUNT_ID}" \
    --manifest "${MANIFEST//$'\n'}" \
    --operation "${OPERATION//$'\n'/}" \
    --report "${REPORT//$'\n'}" \
    --priority 10 \
    --role-arn "${ROLE_ARN}" \
    --client-request-token "$(uuidgen)" \
    --region "${AWS_DEFAULT_REGION}" \
    --description "Extend compliance retention to 15 Jan 2025"; 

Menggunakan AWS SDK for Java

Contoh AWS SDK for Java berikut menunjukkan cara menggunakan Operasi Batch untuk menerapkan mode kepatuhan retensi Kunci Objek S3 di beberapa objek, termasuk menyetel mode retensi ke COMPLIANCE dengan penyimpanan hingga tanggal dan memperpanjang mode KEPATUHAN yang dipertahankan hingga tanggal.

Untuk contoh cara menggunakan Operasi Batch untuk menerapkan mode kepatuhan retensi Kunci Objek S3 di beberapa objek dengan AWS SDK for Java, lihat CreateJob Menggunakan dengan AWS SDK atau CLI di Referensi API Amazon S3.