CreateLocationEfs - AWS DataSync
AnforderungssyntaxAnfrageparameterAntwortsyntaxAntwortelementeFehlerBeispieleWeitere 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 Endpunkt für ein Amazon EFS-Dateisystem, auf das für eine Übertragung zugreifen AWS DataSync kann. Weitere Informationen finden Sie unter Einen Standort für Amazon EFS erstellen.

Anforderungssyntax

{
   "AccessPointArn": "string",
   "Ec2Config": { 
      "SecurityGroupArns": [ "string" ],
      "SubnetArn": "string"
   },
   "EfsFilesystemArn": "string",
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "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.

AccessPointArn

Gibt den Amazon-Ressourcennamen (ARN) des Access Points an, der für den Zugriff auf das Amazon-EFS-Dateisystem DataSync verwendet.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 128.

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 für DataSync den Zugriff auf das Amazon-EFS-Dateisystem verwenden.

Typ: Ec2Config Objekt

Erforderlich: Ja

EfsFilesystemArn

Gibt den ARN für das Amazon-EFS-Dateisystem an.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 128.

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 beim DataSync Mounten des Amazon-EFS-Dateisystems annimmt.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 2 048.

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

Erforderlich: Nein

InTransitEncryption

Gibt an, ob DataSync die Transport Layer Security (TLS) -1.2-Verschlüsselung verwenden soll, wenn Daten in das oder aus dem Amazon-EFS-Dateisystem kopiert 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

Required: No

Subdirectory

Gibt einen Mount-Pfad für Ihr Amazon-EFS-Dateisystem an. Hier werden Daten DataSync gelesen oder geschrieben (je nachdem, ob es sich um einen Quell- oder Zielspeicherort handelt). Standardmäßig wird das Root-Verzeichnis DataSync verwendet, Sie können jedoch auch Unterverzeichnisse einbeziehen.

Anmerkung

Sie müssen einen Wert mit Schrägstrichen angeben (z. B. /path/to/folder) .

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 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.

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 Amazon EFS-Dateisystemstandorts, den Sie erstellen.

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

Beispielanforderung

Das folgende Beispiel erstellt einen Speicherort für ein Amazon EFS-Dateisystem.

{
    "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"
    }]
}

Beispielanfrage: Erstellen eines Speicherorts für ein eingeschränktes Amazon EFS-Dateisystem

Das folgende Beispiel erstellt einen Speicherort für ein Amazon EFS-Dateisystem mit eingeschränktem Zugriff. 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 Speicher-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 einem der sprachspezifischen AWS-SDKs finden Sie unter: