# Supervisión de replicación con métricas, notificaciones de eventos y estados
Puede supervisar las configuraciones de replicación en directo y los trabajos de replicación por lotes de S3 a través de los siguientes mecanismos:
+ **Métricas de replicación de S3**: cuando habilita las métricas de replicación de S3, Amazon CloudWatch emite métricas que puede utilizar para realizar un seguimiento de los bytes pendientes, las operaciones pendientes y la latencia de replicación en el nivel de regla de replicación. Puede ver métricas de replicación de S3 en la consola de Amazon S3 y la consola de Amazon CloudWatch. En la consola de Amazon S3, puede ver estas métricas en la pestaña **Métricas** del bucket de origen. Para obtener más información acerca de las métricas de replicación de S3, consulte [Uso de métricas de replicación de S3](repl-metrics.md).
+ **Métricas de lente de almacenamiento de S3**: además de las métricas de replicación de S3, puede utilizar las métricas de protección de datos relacionadas con la replicación que proporcionan los paneles de lente de almacenamiento de S3. Por ejemplo, si utiliza las métricas gratuitas de lente de almacenamiento de S3, puede ver métricas como el número total de bytes que se replican desde el bucket de origen o el recuento de objetos replicados desde el bucket de origen.
Para auditar el estado general de replicación, puede habilitar las métricas avanzadas en lente de almacenamiento de S3. Con las métricas avanzadas en lente de almacenamiento de S3, puede ver cuántas reglas de replicación tiene de distintos tipos, como el recuento de reglas de replicación con un destino de replicación que no es válido.
Para obtener más información sobre cómo trabajar con métricas de replicación en lente de almacenamiento de S3, consulte [Visualización de métricas de replicación en paneles de lente de almacenamiento de S3](viewing-replication-metrics-storage-lens.md).
+ **Notificaciones de eventos de S3**: las notificaciones de eventos de S3 pueden notificarle en el nivel de objeto en los casos en que los objetos no se replican en su Región de AWS de destino o cuando los objetos no se replican dentro de determinados umbrales. Las notificaciones de eventos de S3 proporcionan los siguientes tipos de eventos de replicación: `s3:Replication:OperationFailedReplication`, `s3:Replication:OperationMissedThreshold`, `s3:Replication:OperationReplicatedAfterThreshold` y `s3:Replication:OperationNotTracked`.
Los eventos de Amazon S3 están disponibles a través de Amazon Simple Queue Service (Amazon SQS), Amazon Simple Notification Service (Amazon SNS) o AWS Lambda. Para obtener más información, consulte [Recepción de eventos de error de replicación con notificaciones de eventos de Amazon S3](replication-metrics-events.md).
+ **Valores del estado de replicación**: también puede recuperar el estado de replicación de los objetos. El estado de replicación puede ayudarle a determinar el estado actual de un objeto que se está replicando. El estado de replicación de un objeto de origen devolverá `PENDING`, `COMPLETED`, o `FAILED`. Se devolverá el estado de replicación de una réplica `REPLICA`.
También puede usar valores de estado de replicación al crear trabajos de replicación por lotes de S3. Por ejemplo, puede utilizar estos valores de estado para replicar objetos que nunca se han replicado o que han producido un error en la replicación.
Para obtener más información sobre la recuperación del estado de replicación de los objetos, consulte [Obtención de información del estado de replicación](replication-status.md). Para obtener más información sobre el uso de estos valores con la replicación por lotes, consulte [Filtros para un trabajo de replicación por lotes](s3-batch-replication-batch.md#batch-replication-filters).
**Topics**
+ [Uso de métricas de replicación de S3](repl-metrics.md)
+ [Visualización de métricas de replicación en paneles de lente de almacenamiento de S3](viewing-replication-metrics-storage-lens.md)
+ [Recepción de eventos de error de replicación con notificaciones de eventos de Amazon S3](replication-metrics-events.md)
+ [Obtención de información del estado de replicación](replication-status.md)
# Uso de métricas de replicación de S3
Las métricas de replicación de S3 proporcionan métricas detalladas para las reglas de replicación en la configuración de la misma. Con las métricas de replicación, puede monitorizar su progreso minuto a minuto mediante el seguimiento de los bytes pendientes, las operaciones que no se han replicado y la latencia de replicación.
**nota**
Las métricas de replicación de S3 se facturan al mismo precio que las métricas personalizadas de Amazon CloudWatch. Para más información, consulte [Precios de Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).
Si utiliza Control de tiempo de replicación de S3, Amazon CloudWatch comienza a informar sobre las métricas de replicación 15 minutos después de activar S3 RTC en la regla de replicación respectiva.
Las métricas de replicación de S3 se activan automáticamente cuando se habilita el control de tiempo de replicación de S3 (S3 RTC). También puede habilitar las métricas de replicación de S3 independientemente del RTC de S3 al [crear o editar una regla](replication-walkthrough1.md). S3 RTC incluye otras características, como un acuerdo de nivel de servicio (SLA) y notificaciones de umbrales perdidos. Para obtener más información, consulte [Cumplimiento de los requisitos de conformidad mediante Control del tiempo de replicación de S3](replication-time-control.md).
Cuando están habilitadas las métricas de replicación de S3, Amazon S3 publica las siguientes métricas en Amazon CloudWatch. Las métricas de CloudWatch se entregan en la medida que es posible.
| Nombre de métrica | Descripción de métricas | ¿A qué objetos se aplica esta métrica? | ¿En qué región se publica esta métrica? | ¿Se sigue publicando esta métrica si se elimina el bucket de destino? | ¿Se sigue publicando esta métrica si no se produce la replicación? |
| --- | --- | --- | --- | --- | --- |
| **Bytes pendientes de replicación** | Número total de bytes de objetos pendientes de replicación para una regla de replicación determinada. | Esta métrica se aplica solo a los objetos nuevos que se replican con la replicación entre regiones de S3 (S3 CRR) o la replicación en la misma región de S3 (S3 SRR). | Esta métrica se publica en la región del bucket de destino. | No | Sí |
| **Latencia de replicación** | El número máximo de segundos de retraso del bucket de destino de la replicación respecto al bucket de origen para una regla de replicación determinada. | Esta métrica se aplica solo a los objetos nuevos que se replican con S3 CRR o S3 SRR. | Esta métrica se publica en la región del bucket de destino. | No | Sí |
| **Operaciones pendientes de replicación** | El número de operaciones pendientes de replicación para una regla de replicación determinada. Esta métrica realiza un seguimiento de las operaciones relacionadas con los objetos, los marcadores de eliminación, las etiquetas, las listas de control de acceso (ACL) y el bloqueo de objetos de S3. | Esta métrica se aplica solo a los objetos nuevos que se replican con S3 CRR o S3 SRR. | Esta métrica se publica en la región del bucket de destino. | No | Sí |
| **Se ha producido un error en la replicación de las operaciones** | El número de operaciones cuya replicación ha producido un error para una regla de replicación determinada. Esta métrica realiza un seguimiento de las operaciones relacionadas con los objetos, los marcadores de eliminación, las etiquetas, las listas de control de acceso (ACL) y el bloqueo de objetos. **Operaciones en las que se produjo un error en la replicación** rastrea los errores de replicación de S3 agregados en un intervalo por minuto. Para identificar los objetos específicos que han fallado la replicación y los motivos de dichos fallos, suscríbase al evento `OperationFailedReplication` en las Notificaciones de eventos de Amazon S3. Para obtener más información, consulte [Recepción de eventos de error de replicación con notificaciones de eventos de Amazon S3](replication-metrics-events.md). | Esta métrica se aplica a los objetos nuevos que se replican con S3 CRR o S3 SRR y también a los objetos existentes que se replican con la replicación por lotes de S3. Si un trabajo de replicación por lotes de S3 no se ejecuta en absoluto, las métricas no se envían a Amazon CloudWatch. Por ejemplo, su trabajo no se ejecutará si no tiene los permisos necesarios para ejecutar un trabajo de replicación por lotes de S3 o si las etiquetas o el prefijo de la configuración de replicación no coinciden. | Esta métrica se publica en la región del bucket de origen. | Sí | No |
Para obtener información acerca del uso de estas métricas en CloudWatch, consulte [Métricas de replicación de S3 en CloudWatch](metrics-dimensions.md#s3-cloudwatch-replication-metrics).
## Habilitación de métricas de replicación de S3
Puede comenzar a utilizar métricas de replicación de S3 con una regla de replicación nueva o existente. Para obtener instrucciones completas sobre cómo crear reglas de replicación, consulte [Configuración de replicación para buckets en la misma cuenta](replication-walkthrough1.md). Puede optar por aplicar la regla de replicación a un bucket de S3 completo o a objetos de Amazon S3 con un prefijo o etiqueta específicos.
Este tema proporciona instrucciones para habilitar las métricas de la replicación de S3 en la configuración de replicación cuando los buckets de origen y destino pertenecen a la misma o a otras Cuentas de AWS.
Para habilitar las métricas de replicación mediante la AWS Command Line Interface (AWS CLI), debe agregar una configuración de replicación al bucket de origen con `Metrics` habilitado. En esta configuración de ejemplo, los objetos con el prefijo `Tax` se replican en el bucket de destino `amzn-s3-demo-bucket` y se generan métricas de esos 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"
}
```
## Consultar métricas de replicación
Puede consultar las métricas de replicación de S3 en la pestaña **Métricas** del bucket de uso general de origen en la consola de Amazon S3. Estas métricas de Amazon CloudWatch también están disponibles en la consola de Amazon CloudWatch. Al habilitar las métricas de replicación de S3, Amazon CloudWatch emite métricas que puede utilizar para realizar un seguimiento de los bytes pendientes, las operaciones pendientes y la latencia de replicación en el nivel de regla de replicación.
Las métricas de replicación de S3 se activan automáticamente cuando se habilita la replicación con control del tiempo de replicación de S3 (S3 RTC) a través de la consola de Amazon S3 o la API de REST de Amazon S3. También puede habilitar las métricas de replicación de S3 independientemente del RTC de S3 al [crear o editar una regla](replication-walkthrough1.md).
Si utiliza Control de tiempo de replicación de S3, Amazon CloudWatch comienza a informar sobre las métricas de replicación 15 minutos después de activar S3 RTC en la regla de replicación respectiva. Para obtener más información, consulte [Uso de métricas de replicación de S3](#repl-metrics).
Las métricas de replicación realizan un seguimiento de los ID de regla de la configuración de replicación. Un ID de regla de replicación puede ser específico de un prefijo, de una etiqueta o de una combinación de ambos.
Para obtener más información acerca de las métricas de CloudWatch para Amazon S3, consulte [Monitorización de métricas con Amazon CloudWatch](cloudwatch-monitoring.md).
**Requisitos previos**
Cree una regla de replicación que tenga métricas de replicación de S3 habilitadas. Para obtener más información, consulte [Habilitación de métricas de replicación de S3](#enabling-replication-metrics).
**Visualización de métricas de replicación de S3 a través de la pestaña **Métricas** del bucket de origen**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En el panel de navegación izquierdo, elija **Buckets de uso general**.
1. En la lista de buckets, elija el nombre del bucket de origen que contiene los objetos cuyas métricas de replicación desea obtener.
1. Elija la pestaña **Metrics** (Métricas).
1. En **Métricas de replicación**, elija las reglas de replicación cuyas métricas desee ver.
1. Elija **Display charts** (Mostrar gráficos).
Amazon S3 muestra los gráficos de **Latencia de replicación**, **Bytes pendientes de replicación**, **Operaciones pendientes de replicación** y **Operaciones en las que se produjo un error en la replicación** para las reglas que seleccionó.
# Visualización de métricas de replicación en paneles de lente de almacenamiento de S3
Además de las [métricas de replicación de S3](repl-metrics.md), puede utilizar las métricas de protección de datos relacionadas con la replicación que proporciona la lente de almacenamiento de S3. Lente de almacenamiento de S3 es una función de análisis de almacenamiento en la nube que puede utilizar para obtener visibilidad en toda la organización sobre el uso y la actividad del almacenamiento de objetos. Para obtener más información, consulte [Uso de Lente de almacenamiento de S3 para proteger los datos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-data-protection.html#storage-lens-data-protection-replication-rule).
La lente de almacenamiento de S3 ofrece dos niveles de métricas: gratuitas y avanzadas y recomendaciones, que puede actualizar por un cargo adicional. Con métricas y recomendaciones avanzadas, puede acceder a métricas y características adicionales para obtener información sobre el almacenamiento. Para obtener información acerca de los precios de S3 Storage Lens, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing).
Si utiliza las métricas gratuitas de lente de almacenamiento de S3, puede ver métricas como el número total de bytes que se replican desde el bucket de origen o el recuento de objetos replicados desde el bucket de origen.
Para auditar su estado general de replicación, puede habilitar las métricas avanzadas en lente de almacenamiento de S3. Con las métricas avanzadas de lente de almacenamiento de S3, puede ver cuántas reglas de replicación tiene de distintos tipos, como el recuento de reglas de replicación con un destino de replicación que no es válido.
Para obtener una lista completa de métricas de lente de almacenamiento de S3, incluidas las métricas de replicación de cada nivel, consulte el [glosario de métricas de lente de almacenamiento de S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html?icmpid=docs_s3_user_guide_replication.html).
**Requisitos previos**
Cree una [configuración de replicación en directo](replication-how-setup.md) o un [trabajo de replicación por lotes de S3](s3-batch-replication-batch.md).
**Visualización de métricas de replicación en lente de almacenamiento de Amazon S3**
1. Creación de un panel de lente de almacenamiento de S3. Para obtener instrucciones paso a paso, consulte [Uso de la consola de S3](storage_lens_creating_dashboard.md#storage_lens_console_creating).
1. (Opcional) Durante la configuración del panel, si desea ver todas las métricas de replicación de lente de almacenamiento de S3, seleccione **Métricas y recomendaciones avanzadas** y, a continuación, seleccione **Métricas de protección de datos avanzadas**. Para obtener una lista completa de las métricas, consulte el [Glosario de métricas de Almacenamiento de lente de S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html?icmpid=docs_s3_user_guide_replication.html).
Si habilita métricas y recomendaciones avanzadas, puede obtener más información sobre las configuraciones de replicación. Por ejemplo, puede utilizar las métricas de recuento de reglas de replicación de lente de almacenamiento de S3 para obtener información detallada sobre los buckets configurados para la replicación. Esta información incluye reglas de replicación dentro y entre buckets y regiones. Para obtener más información, consulte [Cuente el número total de reglas de replicación para cada bucket](storage-lens-data-protection.md#storage-lens-data-protection-replication-rule).
1. Una vez que haya creado el panel, ábralo y elija la pestaña **Buckets**.
1. Desplácese hacia abajo hasta la sección **Buckets**. En **Metric categories** (Categorías de métricas), elija **Data protection** (Protección de datos). A continuación, elimine **Summary** (Resumen).
1. Para filtrar la lista de **Buckets** para mostrar solo las métricas de replicación, elija el icono de preferencias (![\[The preferences icon in the S3 Storage Lens dashboard.\]](http://docs.aws.amazon.com/es_es/AmazonS3/latest/userguide/images/preferences.png)).
1. Desactive los botones de todas las métricas de protección de datos hasta que solo queden seleccionadas las métricas de replicación.
1. (Opcional) En **Page size** (Tamaño de página), elija el número de buckets que desea mostrar en la lista.
1. Elija **Continuar**.
# Recepción de eventos de error de replicación con notificaciones de eventos de Amazon S3
Si ha habilitado las métricas de replicación de S3 en la configuración de replicación, puede configurar las notificaciones de eventos de Amazon S3 para que le notifiquen cuando los objetos no se replican en la Región de AWS de destino. Si ha habilitado el control del tiempo de replicación de S3 (S3 RTC) en la configuración de replicación, también podrá recibir una notificación cuando los objetos no se repliquen dentro del límite de 15 minutos del RTC de S3 para la replicación.
Mediante los siguientes tipos de eventos de `Replication`, puede supervisar el progreso de los eventos de replicación minuto a minuto al realizar el seguimiento de los bytes y las operaciones pendientes, y la latencia de replicación. Para obtener más información acerca de las métricas de replicación de S3, consulte [Uso de métricas de replicación de S3](repl-metrics.md).
+ El tipo de evento `s3:Replication:OperationFailedReplication` le notifica cuando un objeto que era apto para la replicación no pudo replicarse.
+ El tipo de evento `s3:Replication:OperationMissedThreshold` le notifica cuando un objeto que era elegible para la replicación que usa S3 RTC supera el umbral de 15 minutos para la replicación.
+ El tipo de evento `s3:Replication:OperationReplicatedAfterThreshold` le notifica cuando un objeto que era elegible para la replicación que usa S3 RTC replica después del umbral de 15 minutos.
+ El tipo de evento `s3:Replication:OperationNotTracked` le notifica cuando un objeto que era elegible para la replicación en directo (replicación en la misma región [SRR] o replicación entre regiones [CRR]) deja de someterse al seguimiento de las métricas de replicación.
Para obtener descripciones completas de todos los tipos de eventos de replicación compatibles, consulte [Tipos de eventos admitidos para SQS, SNS y Lambda](notification-how-to-event-types-and-destinations.md#supported-notification-event-types).
Para obtener una lista de los códigos de error capturados por las notificaciones de eventos de S3, consulte [Motivos de errores de replicación de Amazon S3](#replication-failure-codes).
Puede recibir notificaciones de eventos de S3 a través de Amazon Simple Queue Service (Amazon SQS), Amazon Simple Notification Service (Amazon SNS) o AWS Lambda. Para obtener más información, consulte [Notificaciones de eventos de Amazon S3](EventNotifications.md).
Para obtener instrucciones sobre cómo configurar notificaciones de eventos de Amazon S3, consulte [Enabling event notifications](how-to-enable-disable-notification-intro.md) (Habilitación de notificaciones de eventos).
**nota**
Además de habilitar las notificaciones de eventos, asegúrese de habilitar también las métricas de replicación de S3. Para obtener más información, consulte [Habilitación de métricas de replicación de S3](repl-metrics.md#enabling-replication-metrics).
El siguiente mensaje es un ejemplo de un mensaje que Amazon S3 envía para publicar un evento de `s3:Replication:OperationFailedReplication`. Para obtener más información, consulte [Estructura de mensaje 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 errores de replicación de Amazon S3
En el siguiente gráfico se muestran los motivos de los errores de replicación de Amazon. Puede ver estos motivos al recibir el evento `s3:Replication:OperationFailedReplication` con las notificaciones de eventos de Amazon S3 y, a continuación, consultar el valor `failureReason`.
También puede ver estos motivos de error en un informe de finalización de replicación por lotes de S3. Para obtener más información, consulte [Informe de finalización de replicación por lotes](s3-batch-replication-batch.md#batch-replication-completion-report).
| Motivo de error de replicación | Descripción |
| --- | --- |
| `AssumeRoleNotPermitted` | Amazon S3 no puede asumir el rol de AWS Identity and Access Management (IAM) especificado en la configuración de la replicación o en el trabajo de operaciones por lotes. |
| `DstBucketInvalidRegion` | El bucket de destino no está en la misma Región de AWS que la especificada en el trabajo de Operaciones por lotes. Este error es específico de la replicación por lotes. |
| `DstBucketNotFound` | Amazon S3 no encuentra el bucket de destino especificado en la configuración de replicación. |
| `DstBucketObjectLockConfigMissing` | Para replicar objetos de un bucket de origen con el bloqueo de objetos activado, el bucket de destino también debe tener habilitado el bloqueo de objetos. El error indica que es posible que el bloqueo de objetos no esté habilitado en el bucket de destino. Para obtener más información, consulte [Consideraciones sobre el bloqueo de objetos](object-lock-managing.md). |
| `DstBucketUnversioned` | El control de versiones no está habilitado en el bucket de destino de S3. Habilite el control de versiones en el bucket de destino para replicar objetos con Replicación de S3. |
| `DstDelObjNotPermitted` | Amazon S3 no puede replicar los marcadores de eliminación en el bucket de destino. Es posible que falte el permiso `s3:ReplicateDelete` para el bucket de destino. |
| `DstKmsKeyInvalidState` | La clave de AWS Key Management Service (AWS KMS) del bucket de destino se encuentra en un estado no válido. Revise y habilite la clave AWS KMS requerida. Para obtener más información sobre la administración de claves de AWS KMS, consulte [Estados de las claves de AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) en la *Guía para desarrolladores de AWS Key Management Service*. |
| `DstKmsKeyNotFound` | La clave de AWS KMS clave configurada para el bucket de destino en la configuración de replicación no existe. |
| `DstMultipartCompleteNotPermitted` | Amazon S3 no puede completar la carga multiparte de objetos en el bucket de destino. Es posible que falte el permiso `s3:ReplicateObject` para el bucket de destino. |
| `DstMultipartInitNotPermitted` | Amazon S3 no puede iniciar la carga multiparte de objetos en el bucket de destino. Es posible que falte el permiso `s3:ReplicateObject` para el bucket de destino. |
| `DstMultipartUploadNotPermitted` | Amazon S3 no puede cargar objetos de carga multiparte en el bucket de destino. Es posible que falte el permiso `s3:ReplicateObject` para el bucket de destino. |
| `DstObjectHardDeleted` | La replicación por lotes de S3 no admite volver a replicar objetos eliminados con el ID de versión del objeto del bucket de destino. Este error es específico de la replicación por lotes. |
| `DstPutAclNotPermitted` | Amazon S3 no puede replicar las listas de control de acceso (ACL) del objeto en el bucket de destino. Es posible que falte el permiso `s3:ReplicateObject` para el bucket de destino. |
| `DstPutLegalHoldNotPermitted` | Amazon S3 no puede aplicar una retención legal de Bloqueo de objetos en los objetos de destino durante la replicación de objetos inmutables. Es posible que falte el permiso `s3:PutObjectLegalHold` para el bucket de destino. Para obtener más información, consulte [Retenciones legales](object-lock.md#object-lock-legal-holds). |
| `DstPutObjectNotPermitted` | Amazon S3 no puede replicar objetos en el bucket de destino. Esto puede ocurrir cuando faltan los permisos necesarios (permisos `s3:ReplicateObject` o `s3:ObjectOwnerOverrideToBucketOwner`) para el bucket de destino o cuando la política de claves de AWS KMS no permite que el rol de replicación del bucket de origen utilice la clave AWS KMS (acciones `kms:Decrypt` y `kms:GenerateDataKey*`) en el bucket de destino. |
| `DstPutRetentionNotPermitted` | Amazon S3 no puede aplicar un periodo de retención en los objetos de destino durante la replicación de objetos inmutables. Es posible que falte el permiso `s3:PutObjectRetention` para el bucket de destino. |
| `DstPutTaggingNotPermitted` | Amazon S3 no puede replicar etiquetas de objetos en el bucket de destino. Es posible que falte el permiso `s3:ReplicateObject` para el bucket de destino. |
| `DstVersionNotFound ` | Amazon S3 no puede encontrar la versión del objeto requerida en el bucket de destino para la que se deben replicar los metadatos. |
| `InitiateReplicationNotPermitted` | Amazon S3 no puede iniciar la replicación en objetos. Puede que falte el permiso `s3:InitiateReplication` para el trabajo de operaciones por lotes. Este error es específico de la replicación por lotes. |
| `SrcBucketInvalidRegion` | El bucket de origen no está en la misma Región de AWS que la especificada en el trabajo de operaciones por lotes. Este error es específico de la replicación por lotes. |
| `SrcBucketNotFound` | Amazon S3 no puede encontrar el bucket de origen. |
| `SrcBucketReplicationConfigMissing` | Amazon S3 no encuentra una configuración de replicación para el bucket de origen. |
| `SrcGetAclNotPermitted` | Amazon S3 no puede acceder al objeto del bucket de origen para la replicación. Es posible que falte el permiso `s3:GetObjectVersionAcl` para el objeto del bucket de origen. Los objetos del bucket de origen deben pertenecer al propietario del bucket. Si las ACL están habilitadas, compruebe si la propiedad del objeto está establecida en Propietario del bucket preferido o Escritor de objetos. Si la propiedad del objeto está establecida en Propietario del bucket preferido, los objetos del bucket de origen deben tener la ACL `bucket-owner-full-control` para que el propietario del bucket se convierta en propietario del objeto. La cuenta de origen puede asumir la propiedad de todos los objetos de su bucket configurando la propiedad de los objetos en Propietario del bucket obligatorio y desactivando las ACL. |
| `SrcGetLegalHoldNotPermitted` | Amazon S3 no puede acceder a la información de retención legal de Bloqueo de objetos de S3. |
| `SrcGetObjectNotPermitted` | Amazon S3 no puede acceder al objeto del bucket de origen para la replicación. Es posible que falte el permiso `s3:GetObjectVersionForReplication` para el bucket de origen. |
| `SrcGetRetentionNotPermitted` | Amazon S3 no puede acceder a la información del periodo de retención de Bloqueo de objetos de S3. |
| `SrcGetTaggingNotPermitted` | Amazon S3 no puede acceder a la información de las etiquetas de objetos desde el bucket de origen. Es posible que falte el permiso `s3:GetObjectVersionTagging` para el bucket de origen. |
| `SrcHeadObjectNotPermitted` | Amazon S3 no puede recuperar los metadatos del objeto del bucket de origen. Es posible que falte el permiso `s3:GetObjectVersionForReplication` para el bucket de origen. |
| `SrcKeyNotFound` | Amazon S3 no puede encontrar la clave del objeto de origen para replicarla. Es posible que el objeto de origen se haya eliminado antes de que se completara la replicación. |
| `SrcKmsKeyInvalidState` | La clave de AWS KMS del bucket de origen no tiene un estado válido. Revise y habilite la clave AWS KMS requerida. Para obtener más información sobre la administración de claves de AWS KMS, consulte [Estados de las claves de AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) en la *Guía para desarrolladores de AWS Key Management Service*. |
| `SrcObjectNotEligible` | Algunos objetos no son aptos para la replicación. Esto puede deberse a la clase de almacenamiento del objeto o a que las etiquetas del objeto no coinciden con la configuración de replicación. |
| `SrcObjectNotFound` | El objeto de origen no existe. |
| `SrcReplicationNotPending` | Amazon S3 ya ha replicado este objeto. Este objeto ya no está pendiente de replicación. |
| `SrcVersionNotFound` | Amazon S3 no puede encontrar la versión del objeto de origen para replicarla. Es posible que la versión del objeto de origen se haya eliminado antes de que se completara la replicación. |
### Temas relacionados
[Configuración de permisos para la replicación en directo](setting-repl-config-perm-overview.md)
[Solución de problemas de replicación](replication-troubleshoot.md)
# Obtención de información del estado de replicación
El estado de replicación puede ayudarle a determinar el estado actual de un objeto que se replica. El estado de replicación de un objeto de origen devolverá `PENDING`, `COMPLETED`, o `FAILED`. Se devolverá el estado de replicación de una réplica `REPLICA`.
También puede usar valores de estado de replicación al crear trabajos de replicación por lotes de S3. Por ejemplo, puede utilizar estos valores de estado para replicar objetos que nunca se han replicado o que han producido un error en la replicación. Para obtener más información sobre el uso de estos valores con la replicación por lotes, consulte [Uso de la información del estado de la replicación con los trabajos de replicación por lotes](#replication-status-batch-replication).
**Topics**
+ [Información general sobre el estado de replicación](#replication-status-overview)
+ [Estado de replicación si se replica en varios buckets de destino](#replication-status-multiple-destinations)
+ [Estado de replicación si la sincronización de modificación de réplica de Amazon S3 está habilitada](#replication-status-replica-mod-syn)
+ [Uso de la información del estado de la replicación con los trabajos de replicación por lotes](#replication-status-batch-replication)
+ [Hallazgo del estado de replicación](#replication-status-usage)
## Información general sobre el estado de replicación
En la replicación, tiene un bucket de origen en el que se configura la replicación y uno o más buckets de destino donde Amazon S3 replica los objetos. Cuando solicita un objeto (mediante `GetObject`) o los metadatos de un objeto (mediante `HeadObject`) de estos buckets, Amazon S3 devuelve el encabezado `x-amz-replication-status` en la respuesta:
+ Al solicitar un objeto del bucket de origen, Amazon S3 devuelve el encabezado `x-amz-replication-status` si el objeto de su solicitud cumple los requisitos para la replicación.
Por ejemplo, supongamos que en la configuración de replicación, usted especifica el prefijo del objeto `TaxDocs` en la configuración de replicación para indicar a Amazon S3 que replique objetos con el prefijo de nombre de clave `TaxDocs`. Cualquier objeto que cargue que tenga este prefijo de nombre de clave, por ejemplo, `TaxDocs/document1.pdf` se replicará. Para solicitudes de objetos con este prefijo de nombre de clave, Amazon S3 devuelve el encabezado `x-amz-replication-status` con uno de los siguientes valores para el estado de replicación del objeto: `PENDING`, `COMPLETED` o `FAILED`.
**nota**
Si la replicación de objetos genera un error después de cargar un objeto, no puede volver a intentar la replicación. Debe volver a cargar el objeto o debe utilizar la replicación por lotes de S3 para replicar los objetos que han producido errores. Para obtener más información sobre el uso de la replicación por lotes, consulte [Replicación de objetos existentes con Replicación por lotes](s3-batch-replication-batch.md).
Los objetos pasan a un estado `FAILED` para problemas como la falta de permisos de rol de replicación, permisos de AWS Key Management Service (AWS KMS) o permisos de bucket. En el caso de los errores temporales, como si un bucket o región no están disponibles, el estado de replicación no pasa a `FAILED`, sino que permanece `PENDING`. Después de que el recurso vuelva a estar en línea, Amazon S3 reanuda la replicación de esos objetos.
+ Cuando solicita un objeto desde un bucket de destino, si el objeto de la solicitud es una réplica creada por Amazon S3, este devuelve el `x-amz-replication-status` encabezado con el valor `REPLICA`.
**nota**
Antes de eliminar un objeto de un bucket de origen que tiene habilitada la replicación, compruebe el estado de replicación del objeto para asegurarse de que el objeto se haya replicado.
Si la configuración de un S3 Lifecycle está habilitada en el bucket de origen, Amazon S3 suspende las acciones del ciclo de vida hasta que marque el estado de los objetos como `COMPLETED` o `FAILED`.
## Estado de replicación si se replica en varios buckets de destino
Cuando se replican objetos en varios buckets de destino, el `x-amz-replication-status` encabezado actúa de manera diferente. El encabezado del objeto de origen devuelve un valor de `COMPLETED` cuando la replicación se realiza correctamente en todos los destinos. El encabezado permanece en el `PENDING` valor hasta que se complete la replicación para todos los destinos. Si uno o más destinos fallan la replicación, el encabezado devuelve `FAILED`.
## Estado de replicación si la sincronización de modificación de réplica de Amazon S3 está habilitada
Cuando las reglas de replicación habilitan la sincronización de las réplicas de modificación de Amazon S3, las réplicas pueden informar estados distintos de `REPLICA`. Si los cambios de metadatos están en proceso de replicación, el encabezado de `x-amz-replication-status` devuelve `PENDING`. Si la sincronización de modificaciones de réplica no permite replicar metadatos, el encabezado devuelve `FAILED`. Si los metadatos se replican correctamente, las réplicas devuelven el encabezado `REPLICA`.
## Uso de la información del estado de la replicación con los trabajos de replicación por lotes
En el momento de crear un trabajo de replicación por lotes, tiene la opción de especificar filtros adicionales, como la fecha de creación de los objetos y el estado de replicación para reducir el alcance del trabajo.
Puede filtrar los objetos para replicar en función del valor `ObjectReplicationStatuses`, proporcionando uno o varios de los siguientes valores:
+ `"NONE"`: indica que Amazon S3 nunca intentó replicar el objeto antes.
+ `"FAILED"`: indica que Amazon S3 intentó replicar el objeto antes, pero no pudo.
+ `"COMPLETED"`: indica que Amazon S3 replicó el objeto correctamente antes.
+ `"REPLICA"`: indica que se trata de un objeto de réplica que Amazon S3 ha replicado desde otro origen.
Para obtener más información sobre el uso de estos valores de estado de replicación con la replicación por lotes, consulte [Filtros para un trabajo de replicación por lotes](s3-batch-replication-batch.md#batch-replication-filters).
## Hallazgo del estado de replicación
Para obtener el estado de replicación de los objetos de un bucket, puede utilizar la herramienta de Amazon S3 Inventory. Amazon S3 envía un archivo CSV al bucket de destino que especifique en la configuración del inventario. También puede usar Amazon Athena para consultar el estado de replicación en el informe de inventario. Para obtener más información acerca del Amazon S3 Inventory, consulte [Catálogo y análisis de sus datos con Inventario de S3](storage-inventory.md).
Puede buscar también el estado de replicación de un objeto mediante la consola de Amazon S3, la AWS Command Line Interface (AWS CLI) o el SDK de AWS.
### Uso de la consola de S3
En la consola de Amazon S3, puede ver el estado de replicación de un objeto en la página de detalles del objeto.
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En el panel de navegación izquierdo, elija **Buckets**.
1. En la lista **Buckets de uso general**, elija el nombre del bucket de origen de replicación.
1. En la lista **Objects** (Objetos), elija el nombre del objeto. Aparece la página de detalles del objeto.
1. En la pestaña **Propiedades**, desplácese hacia abajo hasta la sección **Información general sobre la administración de objetos**. En **Configuraciones de administración**, consulte el valor en **Estado de replicación**.
### Uso de AWS CLI
Use el comando `head-object` de AWS Command Line Interface (AWS CLI) para recuperar metadatos de objetos, como se muestra en el siguiente ejemplo. Sustituya `amzn-s3-demo-source-bucket1` por el nombre del bucket de origen de la replicación y sustituya el otro `user input placeholders` por su propia información.
```
aws s3api head-object --bucket amzn-s3-demo-source-bucket1 --key object-key --version-id object-version-id
```
El comando devuelve los metadatos del objeto, incluido el `ReplicationStatus` como se muestra en el siguiente ejemplo de respuesta.
```
{
"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 de los AWS SDK
Los siguientes fragmentos de código obtienen el estado de replicación mediante AWS SDK para Java y 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);
```
------