

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Überwachen Sie die kontoübergreifende Replikation

Cross-account Die Replikation erfolgt asynchron. Um den Fortschritt zu überwachen, rufen Sie [`DescribeSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) regelmäßig von einem der beiden Konten aus und überprüfen Sie das `ReplicationStatus` Feld.

## Felder für den Replikationsstatus
<a name="cross-account-replicate-status_fields"></a>

Die Felder, die [`DescribeSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) Die Ergebnisse hängen davon ab, ob Sie das Replikat oder das primäre Geheimnis beschreiben:
+ Wenn Sie das beschreiben *Replik* geheim, Secrets Manager kehrt zurück `CrossAccountPrimary`, das beinhaltet `PrimarySecretARN`, `ReplicationStatus`, und `StatusMessage`.
+ Wenn du das beschreibst *primär* geheim, Secrets Manager kehrt zurück `CrossAccountReplicas`, eine Liste, in der jeder Eintrag Folgendes enthält `ReplicaSecretARN`, `ReplicationRoleARN`, `ReplicationStatus`, und `StatusMessage`.

Das `StatusMessage` Das Feld enthält Details, wenn die Replikation fehlschlägt oder zum Stillstand kommt, z. B. wenn ein AWS KMS Die Schlüsselberechtigung fehlt.

## Werte für den Replikationsstatus
<a name="cross-account-replicate-status_values"></a>

Die `ReplicationStatus` Feld meldet einen der folgenden Werte:

Ausstehend  
Secrets Manager hat die Replikationsbeziehung aufgezeichnet, aber noch nicht mit dem Kopieren des Geheimwerts begonnen. Nur das Replikatgeheimnis zeigt diesen Status an.

InProgress  
Secrets Manager kopiert den geheimen Wert vom Primärwert in das Replikat.

InSync  
Das Replikat enthält denselben geheimen Wert wie das primäre Replikat.

Fehlgeschlagen  
Secrets Manager konnte die Replikation nicht abschließen. Siehe [Ermitteln Sie die Ursache einer fehlgeschlagenen Replikation](#cross-account-replicate-status_cause).

Detached (Getrennt)  
Eines der beiden Konten hat die Replikation gestoppt, sodass das primäre und das Replikatgeheimnis nicht mehr verknüpft sind. Weitere Informationen finden Sie unter [Kontoübergreifende Replikation beenden](cross-account-replicate-remove.md).

## Ermitteln Sie die Ursache einer fehlgeschlagenen Replikation
<a name="cross-account-replicate-status_cause"></a>

A `Failed` Status bedeutet, dass Secrets Manager die Replikation nicht abschließen konnte. Überprüfen Sie den `StatusMessage` um zu ermitteln, warum die Replikation fehlgeschlagen ist; es enthält zusätzliche Informationen zur Ursache. Die häufigsten Gründe dafür, dass die Replikation fehlschlägt, hängen mit der Autorisierung zusammen. Bei diesen Fehlern handelt es sich in der Regel um eine der folgenden Ursachen:
+ Secrets Manager ist nicht berechtigt, anzurufen `kms:Decrypt` auf dem primären KMS-Schlüssel oder `kms:Encrypt` auf dem Replikat-KMS-Schlüssel.
+ Secrets Manager kann die Replikationsrolle nicht übernehmen.

Für AWS KMS Fehler, überprüfen Sie das `StatusMessage` um die Ursache des Fehlers zu identifizieren. Wenn Sie eine Forward-Access-Sitzung (FAS) anstelle einer Replikationsrolle verwenden, stellen Sie sicher, dass die Identität des Anrufers die erforderliche `kms:Decrypt` und `kms:Encrypt` Genehmigungen. Weitere Informationen zu den Berechtigungen, die für die Replikation erforderlich sind, finden Sie unter [Wie Secrets Manager die kontoübergreifende Replikation autorisiert](cross-account-replicate-permissions.md).

### Beispiel StatusMessage Werte
<a name="cross-account-replicate-status_statusmessage-examples"></a>

Die folgenden Beispiele zeigen Gemeinsamkeiten `StatusMessage` Werte für fehlgeschlagene Replikationen.

**Example kms:Decrypt mit dem Schlüssel des primären Geheimnisses verweigert**  

```
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:Die Verschlüsselung wurde für den Schlüssel des Replikatgeheimnisses verweigert**  

```
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 Die Replikationsrolle kann nicht übernommen werden**  

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

## Nach einer fehlgeschlagenen Replikation wiederherstellen
<a name="cross-account-replicate-status_failed"></a>

Nachdem Sie die Berechtigungen korrigiert haben, ruft der Inhaber des primären Kontos an [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) erneut für dasselbe Replikat, um die Replikation erneut zu versuchen. Durch diesen Aufruf werden die Berechtigungen nicht korrigiert; er löst lediglich den Replikationsversuch erneut aus. Wenn weiterhin Berechtigungsprobleme bestehen, aktualisiert Secrets Manager das `StatusMessage`. Wenn alle Berechtigungsprobleme behoben sind, wird die Replikation abgeschlossen und der Status ändert sich zu `InSync`.

**Example Versuchen Sie eine fehlgeschlagene Replikation erneut**  

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