O status da replicação pode ajudá-lo a determinar o estado atual de um objeto que está sendo replicado. O status de replicação de um objeto de origem retornará PENDING
COMPLETED
, ou FAILED
. O status de replicação de uma réplica retornará REPLICA
.
Também é possível usar valores de status de replicação ao criar trabalhos de replicação em lote do S3. Por exemplo, é possível usar esses valores de status para replicar objetos que nunca foram replicados ou que apresentaram falha na replicação. Para ter mais informações sobre como usar esses valores com a replicação em lote, consulte Usar informações de status de replicação com trabalhos de replicação em lote.
Tópicos
- Visão geral do status da replicação
- Status da replicação, se replicar para vários intervalos de destino
- Status da replicação se a sincronização de modificação de réplica do Amazon S3 estiver ativada
- Usar informações de status de replicação com trabalhos de replicação em lote
- Localização do status de replicação
Visão geral do status da replicação
Na replicação, você tem um bucket de origem em que configura a replicação e um ou mais buckets de destino nos quais o Amazon S3 replica objetos. Ao solicitar um objeto (usando GetObject
) ou metadados de objeto (usando HeadObject
) nesses buckets, o Amazon S3 exibirá o cabeçalho x-amz-replication-status
na resposta:
-
Ao solicitar um objeto no bucket de origem, o Amazon S3 retornará o cabeçalho
x-amz-replication-status
se o objeto em sua solicitação for qualificado para replicação.Por exemplo, suponha que, em sua configuração de replicação, você especifique o prefixo de objeto
TaxDocs
para dizer ao Amazon S3 para replicar somente objetos com o prefixo de nome de chaveTaxDocs
. Todos os objetos dos quais você fizer upload e tiverem esse prefixo de nome de chave, por exemplo,TaxDocs/document1.pdf
, serão replicados. Para qualquer solicitação de objeto com esse prefixo de nome de chave, o Amazon S3 retorna o cabeçalhox-amz-replication-status
com um dos seguintes valores para o status de replicação de objeto:PENDING
,COMPLETED
ouFAILED
.nota
Se a replicação do objeto falhar depois de você fazer upload de um objeto, não será possível tentar novamente a replicação. É necessário fazer upload do objeto novamente ou usar a Replicação em Lote do S3 para replicar qualquer objeto com falha. Para ter mais informações sobre o uso da replicação em lote, consulte Replicar objetos existentes com o Replicação em Lote.
Os objetos mudam para um estado
FAILED
em caso de problemas, como a ausência das permissões do perfil de replicação, do AWS Key Management Service (AWS KMS) ou do bucket. Em caso de falhas temporárias, por exemplo, se um bucket ou uma região não estiver disponível, o status da replicação não fará a transição paraFAILED
, mas permaneceráPENDING
. Depois que o recurso estiver on-line novamente, o Amazon S3 retomará a replicação desses objetos. -
Ao solicitar um objeto no bucket de destino, se o objeto da sua solicitação for uma réplica criada pelo Amazon S3, o Amazon S3 retornará o cabeçalho
x-amz-replication-status
com valorREPLICA
.
nota
Antes de excluir um objeto de um bucket de origem com a replicação habilitada, confira o status de replicação para confirmar se o objeto foi replicado.
Se a configuração de ciclo de vida do S3 estiver habilitada no bucket de origem, o Amazon S3 suspenderá as ações de ciclo de vida até que o status dos objetos seja COMPLETED
ou FAILED
.
Status da replicação, se replicar para vários intervalos de destino
Quando você replica objetos para vários intervalos de destino, o cabeçalhox-amz-replication-status
age de forma diferente. O cabeçalho do objeto de origem exibe um valor de COMPLETED
somente quando a replicação é bem-sucedida para todos os destinos. O cabeçalho permanece no valor PENDING
até que a replicação tenha sido concluída para todos os destinos. Se um ou mais destinos falharem na replicação, o cabeçalho retornará FAILED
.
Status da replicação se a sincronização de modificação de réplica do Amazon S3 estiver ativada
Quando suas regras de replicação habilitam a sincronização de modificação de réplica do Simple Storage Service (Amazon S3), as réplicas podem informar um status diferente de REPLICA
. Se alterações de metadados estiverem no processo de replicação, o cabeçalho do x-amz-replication-status
retorna PENDING
. Se a sincronização de modificação de réplica falhar ao replicar metadados, o cabeçalho retornará FAILED
. Se os metadados forem replicados corretamente, as réplicas retornarão o cabeçalho REPLICA
.
Usar informações de status de replicação com trabalhos de replicação em lote
Ao criar um trabalho de replicação em lote, é possível especificar filtros adicionais, como data de criação e status de replicação do objeto, para reduzir o escopo do trabalho.
É possível filtrar os objetos a serem replicados com base no valor de ObjectReplicationStatuses
, fornecendo um ou mais dos seguintes valores:
-
"NONE"
: indica que o Simple Storage Service (Amazon S3) nunca tentou replicar o objeto antes. -
"FAILED"
: indica que o Amazon S3 tentou replicar o objeto, mas não conseguiu. -
"COMPLETED"
: indica que o Simple Storage Service (Amazon S3) já replicou com êxito o objeto anteriormente. -
"REPLICA"
: indica que essa é uma réplica de um objeto que foi replicado pelo Amazon S3 de outra origem.
Para ter mais informações sobre como usar esses valores de status de replicação com replicação em lote, consulte Filtros para um trabalho de replicação em lote.
Localização do status de replicação
Para obter o status de replicação dos objetos em um bucket, você pode usar a ferramenta Amazon S3 Inventory. O Amazon S3 envia um arquivo CSV para o bucket de destino especificado na configuração de inventário. Você também pode usar o Amazon Athena para consultar o status da replicação no relatório de inventário. Para obter mais informações sobre o Amazon S3 Inventory, consulte Catalogar e analisar seus dados com o Inventário S3.
Também é possível encontrar o status de replicação do objeto usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI) ou o SDK da AWS.
No console do S3, é possível visualizar o status da replicação de um objeto na página de detalhes do objeto.
Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/
. -
No painel de navegação à esquerda, escolha Buckets.
-
Na lista Buckets de uso geral, selecione o nome do bucket de origem da replicação.
-
Na lista Objects (Objetos), escolha o nome do objeto. A página de detalhes do objeto é exibida.
-
Na guia Propriedades, role para baixo até a seção Visão geral do gerenciamento de objetos. Em Configurações de gerenciamento, veja o valor em Status da replicação.
Use o comando AWS CLI (head-object
) da AWS Command Line Interface para recuperar metadados, como mostrado no exemplo a seguir. Substitua
pelo nome do bucket de origem da replicação e substitua os outros amzn-s3-demo-source-bucket1
por suas próprias informações.user input
placeholders
aws s3api head-object --bucket
amzn-s3-demo-source-bucket1
--keyobject-key
--version-idobject-version-id
O comando retorna os metadados do objeto, inclusive ReplicationStatus
, conforme exibido no exemplo de resposta a seguir.
{
"AcceptRanges":"bytes",
"ContentType":"image/jpeg",
"LastModified":"Mon, 23 Mar 2015 21:02:29 GMT",
"ContentLength":3191,
"ReplicationStatus":"COMPLETED",
"VersionId":"jfnW.HIMOfYiD_9rGbSkmroXsFj3fqZ.",
"ETag":"\"6805f2cfc46c0f04559748bb039d69ae\"",
"Metadata":{
}
}
Os fragmentos de código a seguir recebem o status de replicação utilizando o AWS SDK for Java e o AWS SDK for .NET, respectivamente.