CreateLocationEfs - AWS DataSync
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerBeispieleWeitere Informationen finden Sie unter:

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

AccessPointArn

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.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$

Erforderlich: Nein

Ec2Config

Gibt das Subnetz und die Sicherheitsgruppen an, die DataSync verwendet werden, um eine Verbindung zu einem der Mount-Ziele Ihres Amazon EFS-Dateisystems herzustellen.

Typ: Ec2Config Objekt

Erforderlich: Ja

EfsFilesystemArn

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-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]*:[0-9]{12}:file-system/fs-.*$

Erforderlich: Ja

FileSystemAccessRoleArn

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.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$

Erforderlich: Nein

InTransitEncryption

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

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, falls Sie eines mit angebenAccessPointArn). 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

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

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

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 Status Code: 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 AccessPointArnFileSystemAccessRoleArn, 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: