

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Monitora la replica su più account

Cross-account la replica è asincrona. Per monitorare i progressi, chiama [`DescribeSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) periodicamente da uno dei due account e controlla `ReplicationStatus` campo.

## Campi relativi allo stato della replica
<a name="cross-account-replicate-status_fields"></a>

I campi che [`DescribeSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) I rendimenti dipendono dal fatto che tu descriva la replica o il segreto primario:
+ Quando descrivi il *replica* segreto, Secrets Manager ritorna `CrossAccountPrimary`, che contiene `PrimarySecretARN`, `ReplicationStatus`, e `StatusMessage`.
+ Quando descrivi il *di base* segreto, Secrets Manager ritorna `CrossAccountReplicas`, un elenco in cui ogni voce contiene `ReplicaSecretARN`, `ReplicationRoleARN`, `ReplicationStatus`, e `StatusMessage`.

Il `StatusMessage` il campo fornisce dettagli in caso di errore o blocco della replica, ad esempio quando un AWS KMS manca l'autorizzazione chiave.

## Valori dello stato della replica
<a name="cross-account-replicate-status_values"></a>

I `ReplicationStatus` il campo riporta uno dei seguenti valori:

Pending (In attesa)  
Secrets Manager ha registrato la relazione di replica ma non ha ancora iniziato a copiare il valore segreto. Solo il segreto della replica mostra questo stato.

InProgress  
Secrets Manager sta copiando il valore segreto dal primario alla replica.

InSync  
La replica contiene lo stesso valore segreto della replica primaria.

Non riuscito  
Secrets Manager non è riuscito a completare la replica. Consulta [Determinare la causa di una replica non riuscita](#cross-account-replicate-status_cause).

Distaccato  
Uno dei due account ha interrotto la replica, quindi i segreti primari e di replica non sono più collegati. Per ulteriori informazioni, consulta [Interrompi la replica tra account](cross-account-replicate-remove.md).

## Determinare la causa di una replica non riuscita
<a name="cross-account-replicate-status_cause"></a>

A `Failed` lo stato indica che Secrets Manager non è stato in grado di completare la replica. Rivedi il `StatusMessage` per determinare il motivo per cui la replica non è riuscita; contiene informazioni aggiuntive sulla causa. I motivi più comuni per cui la replica fallisce sono legati all'autorizzazione. Questi errori sono in genere uno dei seguenti:
+ Secrets Manager non è autorizzato a chiamare `kms:Decrypt` sulla chiave KMS principale o `kms:Encrypt` sulla chiave KMS di replica.
+ Secrets Manager non è in grado di assumere il ruolo di replica.

Per AWS KMS guasti, rivedi il `StatusMessage` per identificare l'origine del guasto. Se utilizzi una sessione di accesso diretto (FAS) anziché un ruolo di replica, verifica che l'identità del chiamante abbia i requisiti richiesti `kms:Decrypt` e `kms:Encrypt` autorizzazioni. Per ulteriori informazioni sulle autorizzazioni richieste dalla replica, vedere [In che modo Secrets Manager autorizza la replica tra account](cross-account-replicate-permissions.md).

### Esempio StatusMessage valori
<a name="cross-account-replicate-status_statusmessage-examples"></a>

Gli esempi seguenti mostrano i comuni `StatusMessage` valori per le repliche non riuscite.

**Example KMS:Decrypt negato sulla chiave segreta primaria**  

```
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:Encrypt negato sulla chiave segreta della replica**  

```
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 Impossibile assumere il ruolo di replica**  

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

## Ripristino da una replica fallita
<a name="cross-account-replicate-status_failed"></a>

Dopo aver corretto le autorizzazioni, il proprietario dell'account principale chiama [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) nuovamente per la stessa replica per riprovare a replicare. Questa chiamata non corregge le autorizzazioni; riattiva solo il tentativo di replica. Se i problemi di autorizzazione persistono, Secrets Manager aggiornerà il `StatusMessage`. Una volta risolti tutti i problemi di autorizzazione, la replica viene completata e lo stato cambia in `InSync`.

**Example Riprovare una replica non riuscita**  

```
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
```