Solução de problemas do Operações em Lote

Os tópicos a seguir abordam os erros comuns para ajudar a solucionar problemas que você pode encontrar ao trabalhar com o recurso Operações em Lote do Amazon S3.

Para solucionar problemas com o Replicação em Lote do S3, consulte Erros de replicação em lote.

Existem dois tipos principais de falha que geram erros de operação em lote:

• Falha na API: a API solicitada (como CreateJob) não foi executada.

• Falha no trabalho: a solicitação inicial da API foi bem-sucedida, mas o trabalho apresentou falha devido, por exemplo, a problemas com o manifesto ou com as permissões dos objetos especificados no manifesto.

NoSuchJobException

Tipo: falha na API.

Isso pode ocorrer se o trabalho tiver expirado ou quando o ID usado na solicitação CreateJob não for o mesmo usado na solicitação UpdateJobStatus ou DescribeJob.

Os trabalhos expiram após noventa dias em um estado terminal (Complete,Cancelled ou Failed). Para ter mais informações, consulte Monitoramento de relatórios de status e conclusão.

Mensagens de erro relacionadas

No such job

Ações recomendadas

Para solucionar o problema NoSuchJobException, você pode tentar o seguinte:

1. Verifique se o trabalho existe e está na sua conta. É possível usar o seguinte comando da AWS CLI: aws s3control list-jobs --account-id 111122223333.

2. Verifique se o ID recebido na solicitação CreateJob é o mesmo usado na solicitação UpdateJobStatus ou DescribeJob.

AccessDeniedException

Tipo: falha na API.

O exceção AccessDeniedException ocorre quando uma solicitação do recurso Operações em Lote do S3 é bloqueada devido a operações não permitidas ou porque a identidade do IAM que está fazendo a solicitação não tem permissões suficientes para realizar uma ação.

Mensagens de erro relacionadas

Access Denied

Ações recomendadas

Para solucionar o problema AccessDeniedException, você pode tentar o seguinte:

1. Verifique se o recurso Operações em Lote do S3 é compatível com a operação ou o recurso na região. Para ver uma lista das operações suportadas, consulte Operações suportadas pelo S3 Batch Operations. É possível usar operações em lote com buckets de uso geral em todas as regiões, mas as operações para buckets de diretório só estão disponíveis em endpoints regionais e zonais para buckets de diretório.

2. Garanta a identidade do IAM que fez a solicitação tenha permissões para criar e gerenciar operações em lote. Para obter uma lista de permissões, consulte Conceder permissões para operações em lote.

SlowDownError

Tipo: falha na API.

A exceção SlowDownError ocorre quando sua conta excede o limite da taxa de solicitação para o recurso Operações em Lote do S3.

Ações recomendadas

Para resolver exceções SlowDownError, você pode tentar o seguinte:

1. Diminua a taxa de solicitações e tente novamente. Para ter mais informações, consulte Retry with backoff pattern em “Recomendações da AWS”.

InvalidManifestContent

Tipo: falha no trabalho.

A exceção InvalidManifestContent ocorre quando há problemas com o formato do arquivo de manifesto ou problemas com o conteúdo que o recurso Operações em Lote do S3 usa para processar objetos.

Mensagens de erro relacionadas

• Required fields are missing in the schema: + missingFields

• Invalid Manifest Content

• The S3 Batch Operations job failed because it contains more keys than the maximum allowed in a single job. Please split the job into multiple smaller jobs or reach out to customer support for next steps.

Ações recomendadas

Para solucionar o problema InvalidManifestContent, você pode tentar o seguinte:

Com relação a problemas no formato de manifesto:

1. Garanta que o manifesto siga as especificações de formato exigidas. Todas as colunas necessárias devem estar presentes, formatadas adequadamente e consistentes em todo o manifesto. Para obter exemplos, consulte Especificar um manifesto.

Com relação a problemas de conteúdo:

1. Substitua caracteres especiais nas chaves de objeto pelos respectivos códigos de entidade XML e garanta que as chaves de objeto atendam às convenções de nomenclatura do Amazon S3. Para ter mais informações, consulte Nomear objetos do Amazon S3.

2. Garanta que todas as chaves de objeto estejam codificadas em URL.

3. Divida trabalhos grandes em trabalhos menores. É possível ver quantos objetos são compatíveis com cada operaçãoOperações suportadas pelo S3 Batch Operations.