# Monitorar a replicação com métricas, notificações de eventos e status
É possível monitorar suas configurações de replicação em tempo real e os trabalhos de Replicação em Lote do S3 por meio dos seguintes mecanismos:
+ **Métricas de replicação do S3**: quando você habilita as métricas de replicação do S3, o Amazon CloudWatch emite métricas que você pode usar para monitorar bytes pendentes, operações pendentes e latência de replicação em nível de regra de replicação. É possível visualizar métricas de replicação do S3 no console do Amazon S3 ou do Amazon CloudWatch. No console do Amazon S3, é possível visualizar essas métricas na guia **Métricas** do bucket de origem. Para ter mais informações sobre as métricas de replicação do S3, consulte [Usar métricas de replicação do S3](repl-metrics.md).
+ **Métricas da Lente de Armazenamento do S3**: além das métricas de replicação do S3, é possível usar as métricas de proteção de dados relacionadas à replicação fornecidas pelos painéis da Lente de Armazenamento do S3. Por exemplo, se você usar as métricas gratuitas na Lente de Armazenamento do S3, poderá ver determinadas métricas, como o número total de bytes replicados ou a contagem de objetos replicados do bucket de origem.
Para realizar a auditoria do procedimento geral de replicação, habilite as métricas avançadas na Lente de Armazenamento do S3. Com as métricas avançadas na Lente de Armazenamento do S3, é possível ver quantas regras de replicação você tem de diferentes tipos, incluindo a contagem de regras com um destino inválido.
Para ter mais informações sobre como trabalhar com métricas de replicação na Lente de Armazenamento do S3, consulte [Visualizar métricas de replicação nos painéis da Lente de Armazenamento do S3](viewing-replication-metrics-storage-lens.md).
+ **Notificações de eventos do S3**: as notificações de eventos do S3 em instâncias podem notificar você em nível de objeto quando os objetos não são replicados para a Região da AWS de destino ou quando não são replicados dentro de determinados limites. As notificações de eventos do S3 fornecem os seguintes tipos de evento de replicação: `s3:Replication:OperationFailedReplication`, `s3:Replication:OperationMissedThreshold`, `s3:Replication:OperationReplicatedAfterThreshold` e `s3:Replication:OperationNotTracked`.
Os eventos do Amazon S3 estão disponíveis no Amazon Simple Queue Service (Amazon SQS), no Amazon Simple Notification Service (Amazon SNS) ou no AWS Lambda. Para obter mais informações, consulte [Receber eventos de falha de replicação com Notificações de Eventos do Amazon S3](replication-metrics-events.md).
+ **Valores de status de replicação**: também é possível recuperar o status de replicação dos objetos. O status da replicação pode ajudar você 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 a recuperação do status de replicação dos objetos, consulte [Obtenção de informações sobre o status da replicação](replication-status.md). Para ter mais informações sobre como usar esses valores com a replicação em lote, consulte [Filtros para um trabalho de replicação em lote](s3-batch-replication-batch.md#batch-replication-filters).
**Topics**
+ [Usar métricas de replicação do S3](repl-metrics.md)
+ [Visualizar métricas de replicação nos painéis da Lente de Armazenamento do S3](viewing-replication-metrics-storage-lens.md)
+ [Receber eventos de falha de replicação com Notificações de Eventos do Amazon S3](replication-metrics-events.md)
+ [Obtenção de informações sobre o status da replicação](replication-status.md)
# Usar métricas de replicação do S3
As métricas da funcionalidade Replicação do S3 são métricas detalhadas para as regras de replicação na configuração de replicação. Com as métricas de replicação, você pode monitorar o andamento minuto a minuto rastreando bytes pendentes, operações pendentes, operações com falha na replicação e latência de replicação.
**nota**
As métricas de replicação de S3 são cobradas usando a mesma taxa das métricas personalizadas do Amazon CloudWatch. Para saber mais, consulte [Preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).
Se você estiver usando o controle de tempo de replicação do S3, o Amazon CloudWatch começará a relatar métricas de replicação 15 minutos após você ativar o S3 RTC na respectiva regra de replicação.
As métricas de replicação do S3 são ativadas automaticamente quando você habilita o Controle de Tempo de Replicação do S3 (S3 RTC). Também é possível habilitar as métricas de replicação do S3 independentemente do S3 RTC ao [criar ou editar uma regra](replication-walkthrough1.md). O S3 RTC inclui outros recursos, como um Acordo de Serviço (SLA) e notificações para limites perdidos. Para obter mais informações, consulte [Atender aos requisitos de conformidade com o Controle do Tempo de Replicação do S3](replication-time-control.md).
Quando as métricas de replicação do S3 são habilitadas, o Amazon S3 publica as métricas a seguir no Amazon CloudWatch. As métricas do CloudWatch são entregues com base em melhor esforço.
| Nome da métrica | Descrição da métrica | A quais objetos essa métrica se aplica? | Em qual região essa métrica é publicada? | Essa métrica ainda será publicada se o bucket de destino for excluído? | Essa métrica ainda será publicada se a replicação não ocorrer? |
| --- | --- | --- | --- | --- | --- |
| **Bytes com replicação pendente** | O número total de bytes de objetos com replicação pendente para determinada regra de replicação. | Essa métrica se aplica somente a novos objetos que são replicados com Replicação do S3 Entre Regiões Diferentes (S3 CRR) ou Replicação do S3 na Mesma Região (S3 SRR). | Essa métrica é publicada na região do bucket de destino. | Não | Sim |
| **Latência da replicação** | O número máximo de segundos em que o bucket de destino da replicação fica atrás do bucket de origem de uma regra de replicação específica. | Essa métrica aplica-se somente a novos objetos replicados com S3 CRR ou S3 SRR. | Essa métrica é publicada na região do bucket de destino. | Não | Sim |
| **Operações com replicação pendente** | O número de operações com replicação pendente para uma regra de replicação específica. Essa métrica rastreia operações relacionadas a objetos, marcadores de exclusão, tags, listas de controle de acesso (ACLs) e bloqueio de objetos do S3. | Essa métrica aplica-se somente a novos objetos replicados com S3 CRR ou S3 SRR. | Essa métrica é publicada na região do bucket de destino. | Não | Sim |
| **Operações com falha de replicação** | O número de operações com falha na replicação para determinada regra de replicação. Essa métrica monitora operações relacionadas a objetos, marcadores de exclusão, tags, listas de controle de acesso (ACLs) e Bloqueio de Objetos. **Operações de replicação com falha** rastreia as falhas de replicação do S3 agregadas em um intervalo por minuto. Para identificar os objetos específicos que falharam na replicação e seus motivos, assine o evento `OperationFailedReplication` nas Notificações de eventos do Amazon S3. Para obter mais informações, consulte [Receber eventos de falha de replicação com Notificações de Eventos do Amazon S3](replication-metrics-events.md). | Essa métrica aplica-se a novos objetos que são replicados com S3 CRR ou S3 SRR e também aos objetos existentes que são replicados com a Replicação em Lote do S3. Se um trabalho de Replicação em Lote do S3 não for executado, as métricas não serão enviadas ao Amazon CloudWatch. Por exemplo, seu trabalho não será executado se você não tiver as permissões necessárias para executar um trabalho de replicação em lote do S3 ou se as tags ou o prefixo em sua configuração de replicação não coincidirem. | Essa métrica é publicada na região do bucket de origem. | Sim | Não |
Para ter mais informações sobre como trabalhar com essas métricas no CloudWatch, consulte [Métricas de replicação do S3 no CloudWatch](metrics-dimensions.md#s3-cloudwatch-replication-metrics).
## Habilitar métricas de replicação do S3
Você pode começar a usar métricas de replicação do S3 com uma regra de replicação nova ou existente. Para obter instruções completas sobre como criar regras de replicação, consulte [Configurar a replicação para buckets na mesma conta](replication-walkthrough1.md). Você pode optar por aplicar a regra de replicação a um bucket do S3 inteiro ou a objetos do Amazon S3 com um prefixo ou tag específica.
Este tópico traz instruções para ativar as métricas de replicação do S3 em sua configuração da replicação quando os buckets de origem e destino pertencerem às mesmas Contas da AWS ou a outras.
Para ativar métricas de replicação usando a AWS Command Line Interface (AWS CLI), você deve adicionar uma configuração de replicação ao bucket de origem com `Metrics` ativado. Neste exemplo de configuração, os objetos sob o prefixo `Tax` são replicados para o bucket de destino `amzn-s3-demo-bucket`, e são geradas métricas para esses objetos.
```
{
"Rules": [
{
"Status": "Enabled",
"Filter": {
"Prefix": "Tax"
},
"Destination": {
"Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
"Metrics": {
"Status": "Enabled"
}
},
"Priority": 1
}
],
"Role": "IAM-Role-ARN"
}
```
## Visualizar métricas de replicação
É possível visualizar as métricas da funcionalidade Replicação do S3 na guia **Métricas** do bucket de uso geral de origem no console do Amazon S3. Essas métricas do Amazon CloudWatch também estão disponíveis no console do Amazon CloudWatch. Quando você habilita as métricas de replicação do S3, o Amazon CloudWatch emite métricas que você pode usar para monitorar bytes pendentes, operações pendentes e latência de replicação em nível de regra de replicação.
As métricas de replicação do S3 são ativadas automaticamente quando você habilita a replicação com Controle de Tempo de Replicação do S3 (S3 RTC) usando o console do Amazon S3 ou a API REST do Amazon S3. Também é possível habilitar as métricas de replicação do S3 independentemente do S3 RTC ao [criar ou editar uma regra](replication-walkthrough1.md).
Se você estiver usando o controle de tempo de replicação do S3, o Amazon CloudWatch começará a relatar métricas de replicação 15 minutos após você ativar o S3 RTC na respectiva regra de replicação. Para obter mais informações, consulte [Usar métricas de replicação do S3](#repl-metrics).
As métricas de replicação controlam os IDs de regra da configuração de replicação. Um ID de regra de replicação pode ser específico para um prefixo, uma tag ou uma combinação de ambos.
Para obter mais informações sobre métricas do CloudWatch para o Amazon S3, consulte [Monitoramento de métricas com o Amazon CloudWatch](cloudwatch-monitoring.md).
**Pré-requisitos**
Crie uma regra de replicação que tenha métricas de replicação do S3 habilitadas. Para obter mais informações, consulte [Habilitar métricas de replicação do S3](#enabling-replication-metrics).
**Como visualizar as métricas de replicação do S3 por meio da guia **Métricas** do bucket de origem**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, escolha **Buckets de uso geral**.
1. Na lista de buckets, selecione o nome do bucket que contém os objetos para os quais você deseja métricas de replicação.
1. Escolha a guia **Métricas**.
1. Em **Métricas de replicação**, selecione as regras de replicação para as quais você deseja ver as métricas.
1. Escolha **Display charts (Exibir gráficos)**.
O Amazon S3 exibe os gráficos **Latência da replicação**, **Bytes com replicação pendente**, **Operações com replicação pendente** e **Operações com falha de replicação** correspondentes às regras selecionadas.
# Visualizar métricas de replicação nos painéis da Lente de Armazenamento do S3
Além das [métricas de replicação do S3](repl-metrics.md), é possível usar as métricas de proteção de dados relacionadas à replicação fornecidas pela Lente de Armazenamento do S3. A Lente de Armazenamento do S3 é um recurso de análise de armazenamento em nuvem que você pode usar para obter visibilidade em toda a organização sobre o uso e a atividade do armazenamento de objetos. Para obter mais informações, consulte [Como usar a Lente de Armazenamento do S3 para proteger seus dados](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-data-protection.html#storage-lens-data-protection-replication-rule).
A Lente de Armazenamento do S3 tem dois níveis de métricas: métricas gratuitas e métricas e recomendações avançadas, que podem ser adquiridas por um custo adicional. Com métricas e recomendações avançadas, você pode acessar métricas e recursos adicionais para obter informações sobre seu armazenamento. Para obter mais informações sobre a definição de preço do S3 Storage Lens, consulte [Definição de preço do Amazon S3](https://aws.amazon.com/s3/pricing).
Se você usar as métricas gratuitas na Lente de Armazenamento do S3, poderá ver determinadas métricas, como o número total de bytes replicados ou a contagem de objetos replicados do bucket de origem.
Para realizar a auditoria do procedimento geral de replicação, habilite as métricas avançadas na Lente de Armazenamento do S3. Com as métricas avançadas na Lente de Armazenamento do S3, é possível ver quantas regras de replicação você tem de diferentes tipos, incluindo a contagem de regras com um destino inválido.
Para ter uma lista completa das métricas da Lente de Armazenamento do S3, incluindo quais métricas de replicação estão em cada camada, consulte o [Glossário de métricas de lente de armazenamento do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html?icmpid=docs_s3_user_guide_replication.html).
**Pré-requisitos**
Crie uma [configuração de replicação em tempo real](replication-how-setup.md) ou um [trabalho de Replicação em Lote do S3](s3-batch-replication-batch.md).
**Como visualizar métricas de replicação na Lente de Armazenamento do S3**
1. Crie um painel da Lente de Armazenamento do S3. Para obter instruções detalhadas, consulte [Usar o console do S3](storage_lens_creating_dashboard.md#storage_lens_console_creating).
1. (Opcional) Durante a configuração do painel, se você quiser ver todas as métricas de replicação da Lente de Armazenamento do S3, selecione **Métricas e recomendações avançadas** e escolha **Métricas avançadas de proteção de dados**. Consulte uma lista completa de métricas em [Glossário de métricas de lente de armazenamento do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html?icmpid=docs_s3_user_guide_replication.html).
Se você habilitar métricas e recomendações avançadas, poderá ganhar mais insights sobre as configurações de replicação. Por exemplo, é possível usar as métricas de contagem de regras de replicação da Lente de Armazenamento do S3 para ter informações detalhadas sobre os buckets configurados para replicação. Essas informações incluem regras de replicação dentro e entre buckets e regiões. Para obter mais informações, consulte [Contar o número total de regras de replicação para cada bucket](storage-lens-data-protection.md#storage-lens-data-protection-replication-rule).
1. Depois de criar o painel, abra-o e selecione a guia **Buckets**.
1. Role para baixo até a seção **Buckets**. Em **Metrics categories** (Categorias de métricas), escolha **Data protection** (Proteção de dados). Depois, desmarque **Summary** (Resumo).
1. Para filtrar a lista **Buckets** de modo que somente as métricas de replicação sejam exibidas, escolha o ícone de preferências (![\[The preferences icon in the S3 Storage Lens dashboard.\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/preferences.png)).
1. Desmarque o botão alternador referente a todas as métricas de proteção de dados, mantendo somente as métricas de replicação selecionadas.
1. (Opcional) Em **Page size** (Tamanho da página), escolha o número de buckets a serem exibidos na lista.
1. Escolha **Continuar**.
# Receber eventos de falha de replicação com Notificações de Eventos do Amazon S3
Se você habilitou as métricas de replicação do S3 na configuração de replicação, poderá configurar as notificações de eventos do Amazon S3 para notificar você quando os objetos não forem replicados para a Região da AWS de destino. Se você habilitou o Controle de Tempo de Replicação do S3 (S3 RTC) na configuração de replicação, também poderá receber notificação quando os objetos não forem replicados no limite de 15 minutos do S3 RTC para replicação.
Ao usar os tipos de evento `Replication` a seguir, é possível acompanhar o andamento minuto a minuto dos eventos de replicação monitorando os bytes pendentes, as operações pendentes e a latência da replicação. Para ter mais informações sobre as métricas de replicação do S3, consulte [Usar métricas de replicação do S3](repl-metrics.md).
+ O tipo de evento `s3:Replication:OperationFailedReplication` notifica você quando um objeto qualificado para replicação falhou ao replicar.
+ O tipo de evento `s3:Replication:OperationMissedThreshold` notifica você quando um objeto qualificado para replicação e que usa o S3 RTC excede o limite de 15 minutos para replicação.
+ O tipo de evento `s3:Replication:OperationReplicatedAfterThreshold` notifica você quando um objeto qualificado para replicação e que usa o S3 RTC replica após o limite de 15 minutos.
+ O tipo de evento `s3:Replication:OperationNotTracked` notifica você quando um objeto que era elegível para a replicação em tempo real [Replicação na Mesma Região (SRR) ou Replicação Entre Regiões Diferentes (CRR)] não está mais sendo monitorado por métricas de replicação.
Para ter descrições completas de todos os tipos de evento de replicação compatíveis, consulte [Tipos de evento compatíveis com SQS, SNS e Lambda](notification-how-to-event-types-and-destinations.md#supported-notification-event-types).
Para ter uma lista dos códigos de falha capturados pelas notificações de eventos do S3, consulte [Motivos de falha da replicação do Amazon S3](#replication-failure-codes).
Você pode receber Notificações de eventos do S3 por meio do Amazon Simple Queue Service (Amazon SQS), do Amazon Simple Notification Service (Amazon SNS) ou do AWS Lambda. Para obter mais informações, consulte [Notificações de eventos do Amazon S3](EventNotifications.md).
Para obter instruções sobre como configurar as notificações de evento do Amazon S3, consulte [Habilitar notificações de eventos](how-to-enable-disable-notification-intro.md).
**nota**
Além das notificações de eventos, habilite também as métricas de replicação do S3. Para obter mais informações, consulte [Habilitar métricas de replicação do S3](repl-metrics.md#enabling-replication-metrics).
Veja a seguir um exemplo de mensagem que o Amazon S3 envia para publicar um evento `s3:Replication:OperationFailedReplication`. Para obter mais informações, consulte [Estrutura de mensagens de evento](notification-content-structure.md).
```
{
"Records": [
{
"eventVersion": "2.2",
"eventSource": "aws:s3",
"awsRegion": "us-east-1",
"eventTime": "2024-09-05T21:04:32.527Z",
"eventName": "Replication:OperationFailedReplication",
"userIdentity": {
"principalId": "s3.amazonaws.com"
},
"requestParameters": {
"sourceIPAddress": "s3.amazonaws.com"
},
"responseElements": {
"x-amz-request-id": "123bf045-2b4b-4ca8-a211-c34a63c59426",
"x-amz-id-2": "12VAWNDIHnwJsRhTccqQTeAPoXQmRt22KkewMV8G3XZihAuf9CLDdmkApgZzudaIe2KlLfDqGS0="
},
"s3": {
"s3SchemaVersion": "1.0",
"configurationId": "ReplicationEventName",
"bucket": {
"name": "amzn-s3-demo-bucket1",
"ownerIdentity": {
"principalId": "111122223333"
},
"arn": "arn:aws:s3:::amzn-s3-demo-bucket1"
},
"object": {
"key": "replication-object-put-test.png",
"size": 520080,
"eTag": "e12345ca7e88a38428305d3ff7fcb99f",
"versionId": "abcdeH0Xp66ep__QDjR76LK7Gc9X4wKO",
"sequencer": "0066DA1CBF104C0D51"
}
},
"replicationEventData": {
"replicationRuleId": "notification-test-replication-rule",
"destinationBucket": "arn:aws:s3:::amzn-s3-demo-bucket2",
"s3Operation": "OBJECT_PUT",
"requestTime": "2024-09-05T21:03:59.168Z",
"failureReason": "AssumeRoleNotPermitted"
}
}
]
}
```
## Motivos de falha da replicação do Amazon S3
A tabela a seguir relaciona os motivos de falha da replicação do Amazon S3. É possível visualizar esses motivos ao receber o evento `s3:Replication:OperationFailedReplication` com as notificações de eventos do Amazon S3 e, depois, examinar o valor `failureReason`.
Você também pode visualizar esses motivos de falha em um relatório de conclusão da replicação em lote do S3. Para obter mais informações, consulte [Relatório de conclusão da replicação em lote](s3-batch-replication-batch.md#batch-replication-completion-report).
| Motivos de falha da replicação | Descrição |
| --- | --- |
| `AssumeRoleNotPermitted` | O Amazon S3 não pode assumir o perfil do AWS Identity and Access Management (IAM) especificado na configuração de replicação ou no trabalho de operações em lote. |
| `DstBucketInvalidRegion` | O bucket de destino não está na mesma Região da AWS especificada pelo trabalho de operações em lote. Esse erro é específico da replicação em lote. |
| `DstBucketNotFound` | O Amazon S3 não consegue encontrar o bucket de destino especificado na configuração de replicação. |
| `DstBucketObjectLockConfigMissing` | Para replicar objetos de um bucket de origem com o bloqueio de objetos habilitado, o destino também deve ter o bloqueio de objetos habilitado. O erro indica que o bloqueio de objetos pode não estar ativado no bucket de destino. Para obter mais informações, consulte [Considerações sobre a funcionalidade Bloqueio de Objetos](object-lock-managing.md). |
| `DstBucketUnversioned` | O versionamento não está ativado no bucket de destino do S3. Para ativar objetos com replicação do S3, ative o versionamento no bucket de destino. |
| `DstDelObjNotPermitted` | O Amazon S3 não consegue replicar marcadores de exclusão no bucket de destino. A permissão `s3:ReplicateDelete` pode estar faltando para o bucket de destino. |
| `DstKmsKeyInvalidState` | A chave do AWS Key Management Service (AWS KMS) para o bucket de destino está em estado inválido. Revise e ative a chave do AWS KMS necessária. Para ter mais informações sobre o gerenciamento de chaves do AWS KMS, consulte [Estados das chaves do AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) no *Guia do desenvolvedor do AWS Key Management Service*. |
| `DstKmsKeyNotFound` | A chave AWS KMS configurada para o bucket de destino na configuração de replicação não existe. |
| `DstMultipartCompleteNotPermitted` | O Amazon S3 não consegue concluir o multipart uploads de objetos para o bucket de destino. A permissão `s3:ReplicateObject` pode estar faltando para o bucket de destino. |
| `DstMultipartInitNotPermitted` | O Amazon S3 não consegue iniciar multipart uploads de objetos para o bucket de destino. A permissão `s3:ReplicateObject` pode estar faltando para o bucket de destino. |
| `DstMultipartUploadNotPermitted` | O Amazon S3 não consegue fazer o carregamento fracionado de objetos no bucket de destino. A permissão `s3:ReplicateObject` pode estar faltando para o bucket de destino. |
| `DstObjectHardDeleted` | A replicação em lote não é compatível com a nova replicação de objetos excluídos com o ID de versão do objeto do bucket de destino. Esse erro é específico da replicação em lote. |
| `DstPutAclNotPermitted` | O Amazon S3 não consegue replicar listas de controle de acesso (ACLs) de objetos no bucket de destino. A permissão `s3:ReplicateObject` pode estar faltando para o bucket de destino. |
| `DstPutLegalHoldNotPermitted` | O Amazon S3 não consegue colocar uma retenção jurídica da funcionalidade Bloqueio de Objetos nos objetos de destino ao replicar objetos imutáveis. A permissão `s3:PutObjectLegalHold` pode estar faltando para o bucket de destino. Para obter mais informações, consulte [Retenções legais](object-lock.md#object-lock-legal-holds). |
| `DstPutObjectNotPermitted` | O Amazon S3 não consegue replicar objetos no bucket de destino. Isso pode ocorrer quando faltam as permissões (`s3:ReplicateObject` ou `s3:ObjectOwnerOverrideToBucketOwner`) necessárias para o bucket de destino ou quando a política de chaves do AWS KMS não permite que o perfil de replicação do bucket de origem use a chave do AWS KMS (ações `kms:Decrypt` e `kms:GenerateDataKey*`) no bucket de destino. |
| `DstPutRetentionNotPermitted` | O Amazon S3 não consegue colocar um período de retenção nos objetos de destino ao replicar objetos imutáveis. A permissão `s3:PutObjectRetention` pode estar faltando para o bucket de destino. |
| `DstPutTaggingNotPermitted` | O Amazon S3 não consegue replicar etiquetas de objetos no bucket de destino. A permissão `s3:ReplicateObject` pode estar faltando para o bucket de destino. |
| `DstVersionNotFound ` | O Amazon S3 não consegue encontrar a versão necessária do objeto no bucket de destino para o qual os metadados precisam ser replicados. |
| `InitiateReplicationNotPermitted` | O Amazon S3 não consegue iniciar a replicação em objetos. A permissão `s3:InitiateReplication` pode estar ausente para o trabalho de operações em lote. Esse erro é específico da replicação em lote. |
| `SrcBucketInvalidRegion` | O bucket de origem não está na mesma Região da AWS especificada pelo trabalho da funcionalidade Operações em Lote. Esse erro é específico da replicação em lote. |
| `SrcBucketNotFound` | O Amazon S3 não consegue encontrar o bucket de origem. |
| `SrcBucketReplicationConfigMissing` | O Amazon S3 não conseguiu encontrar uma configuração de replicação para o bucket de origem. |
| `SrcGetAclNotPermitted` | O Amazon S3 não consegue acessar o objeto no bucket de origem para replicação. A permissão `s3:GetObjectVersionAcl` pode estar faltando para o objeto do bucket de origem. Os objetos no bucket de origem devem ser de do proprietário do bucket. Se as ACLs estiverem habilitadas, verifique se a “Propriedade do objeto” está definida como “Proprietário do bucket preferido” ou “Autor do objeto”. Se a “Propriedade do objeto” estiver definida como “Proprietário do bucket preferido”, os objetos do bucket de origem deverão ter a ACL `bucket-owner-full-control` para que o proprietário do bucket se torne o proprietário do objeto. A conta de origem pode se tornar proprietária de todos os objetos no bucket definindo a “Propriedade do objeto” como “Imposto pelo proprietário do bucket” e desabilitando as ACLs. |
| `SrcGetLegalHoldNotPermitted` | O Amazon S3 não consegue acessar as informações de retenção legal do Bloqueio de objetos do S3. |
| `SrcGetObjectNotPermitted` | O Amazon S3 não consegue acessar o objeto no bucket de origem para replicação. A permissão `s3:GetObjectVersionForReplication` pode estar faltando para o bucket de origem. |
| `SrcGetRetentionNotPermitted` | O Amazon S3 não consegue acessar as informações do período de retenção do Bloqueio de objetos do S3. |
| `SrcGetTaggingNotPermitted` | O Amazon S3 não consegue acessar as informações da tag do objeto pelo bucket de origem. A permissão `s3:GetObjectVersionTagging` pode estar faltando para o bucket de origem. |
| `SrcHeadObjectNotPermitted` | O Amazon S3 não consegue recuperar os metadados do objeto pelo bucket de origem. A permissão `s3:GetObjectVersionForReplication` pode estar faltando para o bucket de origem. |
| `SrcKeyNotFound` | O Amazon S3 não consegue encontrar a chave do objeto de origem para replicar. O objeto de origem pode ter sido excluído antes da conclusão da replicação. |
| `SrcKmsKeyInvalidState` | A chave do AWS KMS para o para o bucket de origem não está em estado válido. Revise e ative a chave do AWS KMS necessária. Para ter mais informações sobre o gerenciamento de chaves do AWS KMS, consulte [Estados das chaves do AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) no *Guia do desenvolvedor do AWS Key Management Service*. |
| `SrcObjectNotEligible` | Alguns objetos não são elegíveis para replicação. O motivo disso pode ser a falta de correspondência entre a classe de armazenamento do objeto ou as tags do objeto com a configuração da replicação. |
| `SrcObjectNotFound` | O objeto de origem não existe. |
| `SrcReplicationNotPending` | O Amazon S3 já replicou esse objeto. Esse objeto não está mais pendente de replicação. |
| `SrcVersionNotFound` | O Amazon S3 não consegue encontrar a versão do objeto de origem para replicar. A versão do objeto de origem pode ter sido excluída antes da conclusão da replicação. |
### Tópicos relacionados
[Configurar permissões para replicação em tempo real](setting-repl-config-perm-overview.md)
[Solução de problemas de replicação](replication-troubleshoot.md)
# Obtenção de informações sobre o status da replicação
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](#replication-status-batch-replication).
**Topics**
+ [Visão geral do status da replicação](#replication-status-overview)
+ [Status da replicação, se replicar para vários intervalos de destino](#replication-status-multiple-destinations)
+ [Status da replicação se a sincronização de modificação de réplica do Amazon S3 estiver ativada](#replication-status-replica-mod-syn)
+ [Usar informações de status de replicação com trabalhos de replicação em lote](#replication-status-batch-replication)
+ [Localização do status de replicação](#replication-status-usage)
## 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 chave `TaxDocs`. 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çalho `x-amz-replication-status` com um dos seguintes valores para o status de replicação de objeto: `PENDING`, `COMPLETED` ou `FAILED`.
**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](s3-batch-replication-batch.md).
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 para `FAILED`, 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 valor `REPLICA`.
**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çalho`x-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](s3-batch-replication-batch.md#batch-replication-filters).
## 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](storage-inventory.md).
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.
### Usar o console do S3
No console do S3, é possível visualizar o status da replicação de um objeto na página de detalhes do objeto.
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, escolha **Buckets**.
1. Na lista **Buckets de uso geral**, selecione o nome do bucket de origem da replicação.
1. Na lista **Objects** (Objetos), escolha o nome do objeto. A página de detalhes do objeto é exibida.
1. 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**.
### Como usar o AWS CLI
Use o comando AWS CLI (`head-object`) da AWS Command Line Interface para recuperar metadados, como mostrado no exemplo a seguir. Substitua `amzn-s3-demo-source-bucket1` pelo nome do bucket de origem da replicação e substitua os outros `user input placeholders` por suas próprias informações.
```
aws s3api head-object --bucket amzn-s3-demo-source-bucket1 --key object-key --version-id object-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":{
}
}
```
### Uso da SDKs AWS
Os fragmentos de código a seguir recebem o status de replicação utilizando o AWS SDK para Java e o AWS SDK para .NET, respectivamente.
------
#### [ Java ]
```
GetObjectMetadataRequest metadataRequest = new GetObjectMetadataRequest(bucketName, key);
ObjectMetadata metadata = s3Client.getObjectMetadata(metadataRequest);
System.out.println("Replication Status : " + metadata.getRawMetadataValue(Headers.OBJECT_REPLICATION_STATUS));
```
------
#### [ .NET ]
```
GetObjectMetadataRequest getmetadataRequest = new GetObjectMetadataRequest
{
BucketName = sourceBucket,
Key = objectKey
};
GetObjectMetadataResponse getmetadataResponse = client.GetObjectMetadata(getmetadataRequest);
Console.WriteLine("Object replication status: {0}", getmetadataResponse.ReplicationStatus);
```
------