

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Supervise la replicación entre cuentas

Cross-account la replicación es asincrónica. Para monitorear el progreso, llame [`DescribeSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) periódicamente desde cualquiera de las dos cuentas y comprueba la `ReplicationStatus` campo.

## Campos de estado de replicación
<a name="cross-account-replicate-status_fields"></a>

Los campos que [`DescribeSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) las devoluciones dependen de si se describe la réplica o el secreto principal:
+ Cuando describas el *réplica* secreto, Secrets Manager regresa `CrossAccountPrimary`, que contiene `PrimarySecretARN`, `ReplicationStatus`, y `StatusMessage`.
+ Cuando describes el *primaria* secreto, vuelve Secrets Manager `CrossAccountReplicas`, una lista en la que cada entrada contiene `ReplicaSecretARN`, `ReplicationRoleARN`, `ReplicationStatus`, y `StatusMessage`.

El `StatusMessage` El campo proporciona detalles cuando la replicación falla o se detiene, por ejemplo, cuando AWS KMS falta el permiso clave.

## Valores de estado de la replicación
<a name="cross-account-replicate-status_values"></a>

El `ReplicationStatus` el campo indica uno de los valores siguientes:

Pendiente  
Secrets Manager ha registrado la relación de replicación, pero aún no ha empezado a copiar el valor secreto. Solo el secreto de la réplica muestra este estado.

InProgress  
Secrets Manager está copiando el valor secreto del principal a la réplica.

InSync  
La réplica tiene el mismo valor secreto que la principal.

Con error  
Secrets Manager no pudo completar la replicación. Consulte [Determine la causa de un error en la replicación](#cross-account-replicate-status_cause).

Desconectado  
Una de las dos cuentas detuvo la replicación, por lo que los secretos principales y de réplica ya no están vinculados. Para obtener más información, consulte [Detenga la replicación entre cuentas](cross-account-replicate-remove.md).

## Determine la causa de un error en la replicación
<a name="cross-account-replicate-status_cause"></a>

A `Failed` el estado significa que Secrets Manager no pudo completar la replicación. Revise el `StatusMessage` para determinar por qué falló la replicación; contiene información adicional sobre la causa. Los motivos más comunes por los que se produce un error en la replicación están relacionados con la autorización. Estos errores suelen ser uno de los siguientes:
+ Secrets Manager no tiene permiso para llamar `kms:Decrypt` en la clave KMS principal o `kms:Encrypt` en la clave de KMS de réplica.
+ Secrets Manager no puede asumir la función de replicación.

Para AWS KMS fallos, revise el `StatusMessage` para identificar el origen del fallo. Si utiliza una sesión de acceso directo (FAS) en lugar de una función de replicación, compruebe que la identidad de la persona que llama cumple con los requisitos `kms:Decrypt` y `kms:Encrypt` permisos. Para obtener más información acerca de los permisos que requiere la replicación, consulte [Cómo autoriza Secrets Manager la replicación entre cuentas](cross-account-replicate-permissions.md).

### Ejemplo StatusMessage valora
<a name="cross-account-replicate-status_statusmessage-examples"></a>

Los siguientes ejemplos muestran los valores comunes `StatusMessage` valores para réplicas fallidas.

**Example KMS:Se ha denegado el descifrado de la clave del secreto principal**  

```
Replication failed: User: arn:aws:sts::111122223333:assumed-role/CrossAccountReplicationRole-1234567890123456789/SecretsManagerCrossAccountReplication-444455556666 is not authorized to perform: kms:Decrypt on resource: arn:aws:kms:us-west-2:111122223333:key/a8c8999a-a026-4df3-a42a-d0972222fe36 because no resource-based policy allows the kms:Decrypt action (Service: AWSKMS; Status Code: 400; Error Code: AccessDeniedException; Request ID: 12345678-1234-1234-1234-123456781234; Proxy: null)
```

**Example KMS:Se ha denegado el cifrado de la clave del secreto de la réplica**  

```
Replication failed: User: arn:aws:sts::111122223333:assumed-role/CrossAccountReplicationRole-9876543210987654321/SecretsManagerCrossAccountReplication-444455556666 is not authorized to perform: kms:Encrypt on this resource because the resource does not exist in this Region, no resource-based policies allow access, or a resource-based policy explicitly denies access (Service: AWSKMS; Status Code: 400; Error Code: AccessDeniedException; Request ID: 87654321-4321-4321-4321-aaaabbbbcccc; Proxy: null)
```

**Example No se puede asumir la función de replicación**  

```
Replication failed: Secrets Manager failed to assume role arn:aws:iam::111122223333:role/CrossAccountReplicationRole
```

## Recupérese de una replicación fallida
<a name="cross-account-replicate-status_failed"></a>

Después de corregir los permisos, el propietario de la cuenta principal llama [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) nuevamente para que la misma réplica vuelva a intentar la replicación. Esta llamada no corrige los permisos; solo vuelve a activar el intento de replicación. Si persisten los problemas de permisos, Secrets Manager actualizará el `StatusMessage`. Cuando se resuelvan todos los problemas de permisos, la replicación finaliza y el estado cambia a `InSync`.

**Example Vuelva a intentar una replicación fallida**  

```
aws secretsmanager associate-cross-account-replica \
    --secret-id MyPrimarySecret \
    --cross-account-replica-arn arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3 \
    --replication-role-arn arn:aws:iam::111122223333:role/SecretsManagerCrossAccountReplicationRole
```