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. # CreateLocationFsxWindows Erstellt einen *Übertragungsort* für ein Dateisystem von Amazon FSx für Windows File Server. 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 [Zugriffe auf FSx Windows File Server-Dateisysteme funktionieren](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access). ## Anforderungssyntax ``` { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "FsxFilesystemArn": "string", "Password": "string", "SecurityGroupArns": [ "string" ], "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "User": "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. ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt Konfigurationsinformationen für ein vom DataSync Kunden verwaltetes Geheimnis an, zu dem auch das Kennwort gehört, das für den Zugriff auf einen bestimmten FSx Windows-Speicherort DataSync verwendet wird. AWS KMS key Wenn Sie diesen Parameter als Teil einer `CreateLocationFsxWindows` Anfrage angeben, geben Sie nur den KMS-Schlüssel ARN an. DataSync verwendet diesen KMS-Schlüssel zusammen mit dem, für den `Password` Sie angegeben haben, um ein DataSync verwaltetes Geheimnis zum Speichern der Standortzugriffsanmeldeinformationen zu erstellen. Stellen Sie sicher, dass dieser Benutzer berechtigt DataSync ist, auf den von Ihnen angegebenen KMS-Schlüssel zuzugreifen. Weitere Informationen finden Sie unter [Verwenden eines vom Dienst verwalteten Geheimnisses, das mit einem benutzerdefinierten AWS KMS key verschlüsselt](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) ist. Sie können entweder `CmkSecretConfig` (mit`Password`) oder `CustomSecretConfig` (ohne`Password`) verwenden, um Anmeldeinformationen für eine `CreateLocationFsxWindows` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt Konfigurationsinformationen für einen vom Kunden verwalteten Secrets Manager-Schlüssel an, bei dem das Passwort FSx für einen Windows-Dateiserver-Speicherort im Klartext in Secrets Manager gespeichert wird. Diese Konfiguration umfasst den geheimen ARN und den ARN für eine IAM-Rolle, die Zugriff auf den geheimen Schlüssel ermöglicht. Weitere Informationen finden Sie unter [Verwenden eines von Ihnen verwalteten Geheimnisses](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Sie können entweder `CmkSecretConfig` (mit`Password`) oder `CustomSecretConfig` (ohne`Password`) verwenden, um Anmeldeinformationen für eine `CreateLocationFsxWindows` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt den Namen der Windows-Domäne an, zu der das Dateisystem FSx für Windows File Server gehört. Wenn Sie mehrere Active Directory-Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieses Parameters sichergestellt, dass DataSync eine Verbindung zum richtigen Dateisystem hergestellt wird. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 253. Pattern: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Erforderlich: Nein ** [FsxFilesystemArn](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) für das Dateisystem FSx für Windows File Server 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):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$` Erforderlich: Ja ** [Password](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt das Passwort des Benutzers an, der berechtigt ist, die Dateien, Ordner und Dateimetadaten in Ihrem Dateisystem FSx für Windows File Server bereitzustellen und darauf zuzugreifen. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^.{0,104}$` Erforderlich: Nein ** [SecurityGroupArns](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt die ARNs der Amazon EC2-Sicherheitsgruppen an, die den Zugriff auf das bevorzugte Subnetz Ihres Dateisystems ermöglichen. Die von Ihnen angegebenen Sicherheitsgruppen müssen in der Lage sein, mit den Sicherheitsgruppen Ihres Dateisystems zu kommunizieren. Informationen zur Konfiguration von Sicherheitsgruppen für den Dateisystemzugriff finden Sie im [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html). Wenn Sie eine Sicherheitsgruppe wählen, die keine internen Verbindungen zulässt, gehen Sie wie folgt vor: + Konfigurieren Sie die Sicherheitsgruppe so, dass sie mit sich selbst kommunizieren kann. + Wählen Sie eine andere Sicherheitsgruppe, die mit der Sicherheitsgruppe des Mount-Ziels kommunizieren kann. Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 5 Elemente. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` Erforderlich: Ja ** [Subdirectory](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt einen Mount-Pfad für Ihr Dateisystem mithilfe von Schrägstrichen an. Hier werden Daten DataSync gelesen oder geschrieben (je nachdem, ob es sich um einen Quell- oder Zielort handelt). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$` Erforderlich: Nein ** [Tags](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt Bezeichnungen an, mit denen Sie Ihre AWS -Ressourcen kategorisieren, filtern und suchen können. Wir empfehlen, zumindest ein Namensschild für Ihren Standort zu erstellen. 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 ** [User](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt den Benutzer an, der berechtigt ist, die Dateien, Ordner und Dateimetadaten in Ihrem Dateisystem FSx für Windows File Server bereitzustellen und darauf zuzugreifen. Informationen zur Auswahl eines Benutzers mit der richtigen Zugriffsebene für Ihre Übertragung finden Sie unter [Erforderliche Berechtigungen](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) FSx für Windows-Dateiserverstandorte. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Erforderlich: Ja ## 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_CreateLocationFsxWindows_ResponseSyntax) ** Der ARN des Dateisystemspeicherorts FSx für Windows File Server, den Sie erstellt haben. 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 Dienst ein Fehler auftritt. HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows)