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.
CreateLocationNfs
Definiert ein Dateisystem auf einem NFS-Server (Network File System), das ausgelesen oder.
Anforderungssyntax
{
"MountOptions": {
"Version": "string"
},
"OnPremConfig": {
"AgentArns": [ "string" ]
},
"ServerHostname": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Anfrageparameter
Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- MountOptions
-
Die NFS-Mount-Optionen, dieDataSync Sie zum Mounten Ihrer NFS-Freigabe verwenden.
Typ: NfsMountOptions Objekt
Required: No
- OnPremConfig
-
Enthält eine Liste der Amazon-Ressourcennamen (ARNs) von Agents, die zur Verbindung mit einem NFS-Server verwendet werden.
Wenn Sie Daten auf oder von Ihrem AWS Snowcone-Gerät kopieren, finden Sie weitere Informationen unter NFS-Server auf AWS Snowcone.
Typ: OnPremConfig Objekt
Erforderlich: Ja
- ServerHostname
-
Der Name des NFS-Servers. Dieser Wert ist die IP-Adresse oder der DNS-Name (Domain Name Service) des NFS-Servers. Ein Agent, der On-Premises installiert ist, verwendet diesen Hostnamen, um den NFS-Server in einem Netzwerk einzubinden.
Wenn Sie Daten auf oder von Ihrem AWS Snowcone-Gerät kopieren, finden Sie weitere Informationen unter NFS-Server auf AWS Snowcone.
Anmerkung
Dieser Name muss entweder DNS-konform oder eine IPv4-Adresse sein.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge von 255.
Pattern:
^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$Erforderlich: Ja
- Subdirectory
-
Das Unterverzeichnis im NFS-Dateisystem, das zum Lesen von Daten aus dem NFS-Quellspeicherort oder zum Schreiben von Daten in das NFS-Ziel verwendet wird. Der NFS-Pfad sollte ein Pfad sein, der vom NFS-Server exportiert wurde, oder ein Unterverzeichnis dieses Pfads. Der Pfad sollte so beschaffen sein, dass er von anderen NFS-Clients in Ihrem Netzwerk gemountet werden kann.
Um alle Pfade zu sehen, die von Ihrem NFS-Server exportiert wurden, führen Sie über einen NFS-Client mit Zugriff auf Ihren Server "
showmount -e nfs-server-name" aus. Sie können jedes Verzeichnis, das in den Ergebnissen erscheint, und jedes Unterverzeichnis dieser Verzeichnisse angeben. Stellen Sie sicher, dass der NFS-Export ohne Kerberos-Authentifizierung möglich ist.Um alle Daten in dem von Ihnen angegebenen Ordner zu übertragen, benötigt DataSync die Berechtigung zum Lesen aller Daten. Dazu konfigurieren Sie entweder den NFS-Export mit
no_root_squash,oder stellen Sie sicher, dass die Berechtigungen für alle von Ihnen zu lesenden DateienDataSync Lesezugriff für alle Benutzer gewähren. Wenn Sie eine dieser Aktionen ausführen, kann der Agent die Dateien lesen. Damit der Agent auf Verzeichnisse zugreifen kann, müssen Sie zusätzlich Zugriff für die uneingeschränkte Ausführung aktivieren.Wenn Sie Daten auf oder von Ihrem AWS Snowcone-Gerät kopieren, finden Sie weitere Informationen unter NFS-Server auf AWS Snowcone.
Weitere Informationen zur NFS-Exportkonfiguration finden Sie unter 18.7. Die /etc/exports-Konfigurationsdatei
in der Dokumentation zu Red Hat Enterprise Linux. Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge von 4096.
Pattern:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$Erforderlich: Ja
- Tags
-
Das Schlüssel-Wert-Paar, das für das Tag steht, das Sie dem Speicherort hinzufügen möchten. Der Wert kann auch eine leere Zeichenfolge sein. Wir empfehlen, zum Benennen Ihrer Ressourcen Tags zu verwenden.
Typ: Array von TagListEntry-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente.
Required: No
Antwortsyntax
{
"LocationArn": "string"
}Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
- LocationArn
-
Der Amazon-Ressourcenname (ARN) des zu lesenden Quell-Speicherorts des NFS-Dateisystems.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge von 128.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$
Fehler
Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.
- InternalException
-
Diese Ausnahme wird ausgelöst, wenn ein Fehler imAWS DataSync Dienst auftritt.
HTTP Status Code: 500
- InvalidRequestException
-
Diese Ausnahme wird ausgelöst, wenn der Client eine fehlerhafte Anfrage sendet.
HTTP Status Code: 400
Beispiele
Beispiel
Im folgenden Beispiel wird ein Endpunkt für ein NFS-Dateisystem erstellt, wobei die angegebene NFS-Version als Mount-Option verwendet wird.
Beispielanforderung
{
"MountOptions": {
"Version": : "NFS4_0"
},
"OnPremConfig": {
"AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
},
"ServerHostname": "MyServer@amazon.com",
"Subdirectory": "/MyFolder",
"Tags": [
{
"Key": "Name",
"Value": "ElasticFileSystem-1"
}
]
}Beispiel
Die Antwort gibt den Amazon-Ressourcennamen (ARN) des NFS-Standorts zurück.
Beispielantwort
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
