

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menggunakan Operasi Batch S3 dengan mode kepatuhan retensi Kunci Objek S3
<a name="batch-ops-compliance-mode"></a>

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
<a name="batch-ops-cli-object-lock-compliance-example"></a>

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

**Example - 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}}";
```

**Example — 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
<a name="batch-ops-examples-java-object-lock-compliance"></a>

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 COMPLIANCE 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](https://docs.aws.amazon.com/AmazonS3/latest/API/s3-control_example_s3-control_CreateJob_section.html) CLI di Referensi API *Amazon* S3.