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.
CreateReplicationConfiguration
Erstellt eine Replikationskonfiguration, die ein vorhandenes EFS Dateisystem in ein neues, schreibgeschütztes Dateisystem repliziert. Weitere Informationen finden Sie unter Amazon EFS Replication im EFSAmazon-Benutzerhandbuch. In der Replikationskonfiguration ist Folgendes festgelegt:
-
Quelldateisystem — Das EFS Dateisystem, das Sie replizieren möchten. Das Quelldateisystem kann in einer vorhandenen Replikationskonfiguration kein Zieldateisystem sein.
-
AWS-Region — Das, AWS-Region in dem das Zieldateisystem erstellt wird. Die EFS Amazon-Replikation ist AWS-Regionen in allem verfügbar, was verfügbar EFS ist. Die Region muss aktiviert sein. Weitere Informationen finden Sie unter Verwaltung AWS-Regionen im AWS Allgemeinen Referenzhandbuch.
-
Konfiguration des Zieldateisystems – Die Konfiguration des Zieldateisystems, in das das Quelldateisystem repliziert wird. In einer Replikationskonfiguration kann es nur ein Zieldateisystem geben.
Zu den Parametern für die Replikationskonfiguration gehören:
-
Dateisystem-ID – Die ID des Zieldateisystems für die Replikation. Wenn keine ID angegeben wird, wird ein neues Dateisystem mit den Standardeinstellungen EFS erstellt. Für bestehende Dateisysteme muss der Replikationsschutz des Dateisystems vor Überschreibung deaktiviert werden. Weitere Informationen finden Sie unter Replizieren in ein vorhandenes Dateisystem.
-
Availability Zone – Wenn Sie möchten, dass das Zieldateisystem One-Zone-Speicher verwendet, müssen Sie die Availability Zone angeben, in der das Dateisystem erstellt werden soll. Weitere Informationen finden Sie unter EFSDateisystemtypen im EFSAmazon-Benutzerhandbuch.
-
Verschlüsselung – Alle Zieldateisysteme werden mit aktivierter Verschlüsselung im Ruhezustand erstellt. Sie können den Schlüssel AWS Key Management Service (AWS KMS) angeben, der zur Verschlüsselung des Zieldateisystems verwendet wird. Wenn Sie keinen KMS Schlüssel angeben, wird Ihr vom Service verwalteter KMS Schlüssel für Amazon EFS verwendet.
Anmerkung
Nachdem das Dateisystem erstellt wurde, können Sie den KMS Schlüssel nicht mehr ändern.
-
Für neue Zieldateisysteme sind die folgenden Eigenschaften standardmäßig festgelegt:
-
Leistungsmodus — Der Leistungsmodus des Zieldateisystems entspricht dem des Quelldateisystems, es sei denn, das Zieldateisystem verwendet EFS One Zone Storage. In diesem Fall wird der Allzweck-Leistungsmodus verwendet. Der Leistungsmodus kann nicht geändert werden.
-
Durchsatzmodus – Der Durchsatzmodus des Zieldateisystems entspricht dem des Quelldateisystems. Nachdem das Dateisystem erstellt wurde, können Sie den Durchsatzmodus ändern.
-
Lebenszyklusmanagement — Das Lebenszyklusmanagement ist auf dem Zieldateisystem nicht aktiviert. Nachdem das Zieldateisystem erstellt wurde, können Sie das Lebenszyklusmanagement aktivieren.
-
Automatische Backups – Automatische tägliche Backups sind im Zieldateisystem aktiviert. Diese Einstellung kann nicht geändert werden, nachdem das Dateisystem erstellt wurde.
Weitere Informationen finden Sie unter Amazon EFS Replication im EFSAmazon-Benutzerhandbuch.
Anforderungssyntax
POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json
{
"Destinations": [
{
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"KmsKeyId": "string",
"Region": "string"
}
]
}URIParameter anfordern
Die Anfrage verwendet die folgenden URI Parameter.
- SourceFileSystemId
-
Gibt das EFS Amazon-Dateisystem an, das Sie replizieren möchten. Dieses Dateisystem kann in einer anderen Replikationskonfiguration kein Quell- oder Zieldateisystem sein.
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$Erforderlich: Ja
Anforderungstext
Die Anfrage akzeptiert die folgenden Daten im JSON Format.
- Destinations
-
Ein Array von Objekten, die eine Zielkonfiguration beschreiben. Es wird nur ein Zielkonfigurationsobjekt unterstützt.
Typ: Array von DestinationToCreate-Objekten
Erforderlich: Ja
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"Region": "string",
"Status": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemRegion": "string"
}Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.
- CreationTime
-
Der Zeitpunkt der Erstellung der Replikationskonfiguration.
Typ: Zeitstempel
- Destinations
-
Ein Array von Zielobjekten. Es wird nur ein Zielobjekt unterstützt.
Typ: Array von Destination-Objekten
- OriginalSourceFileSystemArn
-
Der Amazon-Ressourcenname (ARN) des ursprünglichen EFS Quelldateisystems in der Replikationskonfiguration.
Typ: Zeichenfolge
- SourceFileSystemArn
-
Der Amazon-Ressourcenname (ARN) des aktuellen Quelldateisystems in der Replikationskonfiguration.
Typ: Zeichenfolge
- SourceFileSystemId
-
Die ID des EFS Amazon-Quelldateisystems, das repliziert wird.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$ - SourceFileSystemRegion
-
Die, AWS-Region in der sich das EFS Quelldateisystem befindet.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern:
^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$
Fehler
- BadRequest
-
Wird zurückgegeben, wenn die Anfrage fehlerhaft ist oder einen Fehler enthält, z. B. einen ungültigen Parameterwert oder einen fehlenden erforderlichen Parameter.
HTTPStatuscode: 400
- ConflictException
-
Wird zurückgegeben, wenn das Quelldateisystem in einer Replikation verschlüsselt, das Zieldateisystem jedoch unverschlüsselt ist.
HTTPStatuscode: 409
- FileSystemLimitExceeded
-
Wird zurückgegeben, wenn die AWS-Konto bereits die maximal zulässige Anzahl von Dateisystemen pro Konto erstellt hat.
HTTPStatuscode: 403
- FileSystemNotFound
-
Wird zurückgegeben, wenn der angegebene
FileSystemIdWert im Wert des Anforderers nicht vorhanden ist AWS-Konto.HTTPStatuscode: 404
- IncorrectFileSystemLifeCycleState
-
Wird zurückgegeben, wenn der Lebenszyklusstatus des Dateisystems nicht „verfügbar“ ist.
HTTPStatuscode: 409
- InsufficientThroughputCapacity
-
Wird zurückgegeben, wenn die Kapazität nicht ausreicht, um zusätzlichen Durchsatz bereitzustellen. Dieser Wert kann zurückgegeben werden, wenn Sie versuchen, ein Dateisystem im Modus „Bereitgestellter Durchsatz“ zu erstellen, wenn Sie versuchen, den bereitgestellten Durchsatz eines vorhandenen Dateisystems zu erhöhen oder wenn Sie versuchen, ein vorhandenes Dateisystem vom Modus „Bursting Throughput“ auf „Bereitgestellter Durchsatz“ umzustellen. Bitte versuchen Sie es später erneut.
HTTPStatuscode: 503
- InternalServerError
-
Wird zurückgegeben, wenn auf der Serverseite ein Fehler aufgetreten ist.
HTTPStatuscode: 500
- ReplicationNotFound
-
Wird zurückgegeben, wenn das angegebene Dateisystem keine Replikationskonfiguration aufweist.
HTTPStatuscode: 404
- ThroughputLimitExceeded
-
Wird zurückgegeben, wenn der Durchsatzmodus oder die Menge des bereitgestellten Durchsatzes nicht geändert werden können, da die Durchsatzgrenze von 1 024 Mbit/s erreicht wurde.
HTTPStatuscode: 400
- UnsupportedAvailabilityZone
-
Wird zurückgegeben, wenn die angeforderte EFS Amazon-Funktionalität in der angegebenen Availability Zone nicht verfügbar ist.
HTTPStatuscode: 400
- ValidationException
-
Wird zurückgegeben, wenn der AWS Backup Dienst in dem Land, AWS-Region in dem die Anfrage gestellt wurde, nicht verfügbar ist.
HTTPStatuscode: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
