

# Definir a retenção do Bloqueio de Objetos usando o Operações em Lote
<a name="batch-ops-object-lock-retention"></a>

É possível usar o Operações em Lote do Amazon S3 com o Bloqueio de Objetos do S3 para gerenciar a retenção de vários objetos do Amazon S3 de uma só vez. Especifique a lista de objetos de destino no manifesto e envie-a para as operações em lote para conclusão. Para obter mais informações, consulte [Retenção do Bloqueio de objetos do S3](batch-ops-retention-date.md) e [Retenção legal do Bloqueio de objetos do S3](batch-ops-legal-hold.md). 

Os exemplos a seguir mostram como criar um perfil do AWS Identity and Access Management (IAM) com permissões do Operações em Lote do S3 e atualizar as permissões do perfil para incluir as permissões `s3:PutObjectRetention` de modo que possa executar a retenção do Bloqueio de Objetos do S3 nos objetos do bucket do manifesto. Você também deve ter um manifesto `CSV` que identifica os objetos para o trabalho do Operações em Lote do S3. Para ter mais informações, consulte [Especificar um manifesto](batch-ops-create-job.md#specify-batchjob-manifest).

Para usar os exemplos a seguir, substitua *`user input placeholders`* por suas próprias informações. 

## Como usar o AWS CLI
<a name="batch-ops-cli-object-lock-retention-example"></a>

O exemplo AWS CLI a seguir mostra como usar o Operações em Lote para aplicar a retenção do Bloqueio de Objetos do S3 a vários objetos.

```
export AWS_PROFILE='aws-user'

read -d '' retention_permissions <<EOF
{
    "Version": "2012-10-17"		 	 	 ,		 	 	 TCX5-2025-waiver;,
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObjectRetention"
            ],
            "Resource": [
                "arn:aws:s3:::{{amzn-s3-demo-manifest-bucket}}/*"
            ]
        }
    ]
}
EOF

aws iam put-role-policy --role-name batch_operations-objectlock --policy-name retention-permissions --policy-document "${retention_permissions}"
```

## Usar o AWS SDK para Java
<a name="batch-ops-examples-java-object-lock-retention"></a>

Para ver exemplos de como usar o recurso Operações em Lote para aplicar a retenção do Bloqueio de Objetos do S3 em vários objetos com o AWS SDK para Java, consulte [Use CreateJob with an AWS SDK or CLI](https://docs.aws.amazon.com/AmazonS3/latest/API/s3-control_example_s3-control_CreateJob_section.html) na *Referência de API do Amazon S3*.