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. # CreateLocationEfs Erstellt einen *Übertragungsort* für ein Amazon EFS-Dateisystem. AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. Bevor Sie beginnen, stellen Sie sicher, dass Sie wissen, wie DataSync [auf Amazon EFS-Dateisysteme zugegriffen](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access) wird. ## Anforderungssyntax ``` { "AccessPointArn": "string", "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "EfsFilesystemArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Anforderungsparameter Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md). Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des Access Points an, der zum Mounten Ihres Amazon EFS-Dateisystems DataSync verwendet wird. Weitere Informationen finden Sie unter [Zugreifen auf eingeschränkte Dateisysteme](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` Erforderlich: Nein ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) ** Gibt das Subnetz und die Sicherheitsgruppen an, die DataSync verwendet werden, um eine Verbindung zu einem der [Mount-Ziele](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) Ihres Amazon EFS-Dateisystems herzustellen. Typ: [Ec2Config](API_Ec2Config.md) Objekt Erforderlich: Ja ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) ** Gibt den ARN für Ihr Amazon EFS-Dateisystem an. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]{8,40}$` Erforderlich: Ja ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) ** Gibt eine AWS Identity and Access Management (IAM-) Rolle an, die DataSync den Zugriff auf Ihr Amazon EFS-Dateisystem ermöglicht. Informationen zum Erstellen dieser Rolle finden Sie unter [Eine DataSync IAM-Rolle für den Dateisystemzugriff erstellen](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` Erforderlich: Nein ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) ** Gibt an, ob Sie DataSync die Transport Layer Security (TLS) 1.2-Verschlüsselung verwenden möchten, wenn Daten zu oder von Ihrem Amazon EFS-Dateisystem übertragen werden. Wenn Sie einen Zugriffspunkt mit `AccessPointArn` oder eine IAM-Rolle mit `FileSystemAccessRoleArn` angeben, müssen Sie diesen Parameter auf `TLS1_2` setzen. Typ: Zeichenfolge Zulässige Werte: `NONE | TLS1_2` Erforderlich: Nein ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) ** Gibt einen Mount-Pfad für Ihr Amazon-EFS-Dateisystem an. Hier werden Daten in Ihrem Dateisystem DataSync gelesen oder geschrieben (je nachdem, ob es sich um einen Quell- oder Zielspeicherort handelt). DataSync Verwendet standardmäßig das Stammverzeichnis (oder den [Zugriffspunkt](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html), falls Sie eines mit angeben`AccessPointArn`). Sie können Unterverzeichnisse auch mit Schrägstrichen einbeziehen (z. B.`/path/to/folder`). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$` Erforderlich: Nein ** [Tags](#API_CreateLocationEfs_RequestSyntax) ** Gibt Schlüssel-Wert-Paar an, das für ein Tag steht, das Sie der Ressource hinzufügen möchten. Der Wert kann auch eine leere Zeichenfolge sein. Dieser Wert hilft Ihnen, Ressourcen zu verwalten, zu filtern und zu suchen. Wir empfehlen Ihnen, für Ihren Speicherort ein Namens-Tag anzulegen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ## 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](#API_CreateLocationEfs_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) des Amazon EFS-Dateisystemspeicherorts, den Sie erstellen. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` ## Fehler Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md). ** InternalException ** Diese Ausnahme wird ausgelöst, wenn im AWS DataSync Service ein Fehler auftritt. HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Beispiele ### Beispielanforderung Im folgenden Beispiel wird ein Speicherort für ein Amazon EFS-Dateisystem erstellt. ``` { "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2" ] }, "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### Beispielanforderung: Erstellen eines Speicherorts für ein eingeschränktes Amazon EFS-Dateisystem Im folgenden Beispiel wird ein Speicherort für ein Amazon EFS-Dateisystem mit eingeschränktem Zugriff erstellt. In einem solchen Szenario müssen Sie möglicherweise Werte für `AccessPointArn``FileSystemAccessRoleArn`, und `InTransitEncryption` in Ihrer Anfrage angeben. ``` { "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0", "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew", "InTransitEncryption": "TLS1_2", "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### Beispielantwort Eine Antwort gibt den Standort-ARN des Amazon EFS-Dateisystems zurück. ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" } ``` ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs)