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. # CreateLocationObjectStorage Erzeugt einen *Übertragungsort* für ein Objektspeichersystem. AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. Sie können Übertragungen mit oder ohne einen [DataSyncAgenten durchführen](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required). Bevor Sie beginnen, stellen Sie sicher, dass Sie die [Voraussetzungen](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites) für DataSync die Arbeit mit Objektspeichersystemen verstehen. ## Anforderungssyntax ``` { "AccessKey": "string", "AgentArns": [ "string" ], "BucketName": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "SecretKey": "string", "ServerCertificate": blob, "ServerHostname": "string", "ServerPort": number, "ServerProtocol": "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. ** [AccessKey](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt den Zugriffsschlüssel (z. B. einen Benutzernamen) an, wenn Anmeldeinformationen für die Authentifizierung beim Objektspeicher-Server erforderlich sind. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 200 Zeichen. Pattern: `^.*$` Erforderlich: Nein ** [AgentArns](#API_CreateLocationObjectStorage_RequestSyntax) ** (Optional) Gibt die Amazon-Ressourcennamen (ARNs) der DataSync Agenten an, die eine Verbindung zu Ihrem Objektspeichersystem herstellen können. Wenn Sie eine cloudübergreifende Übertragung ohne Agenten einrichten, müssen Sie für diesen Parameter keinen Wert angeben. Stellen Sie sicher, dass Sie diesen Parameter korrekt konfigurieren, wenn Sie Ihren Speicherort zum ersten Mal erstellen. Nachdem Sie einen Speicherort erstellt haben, können Sie keine Agenten mehr hinzufügen oder daraus entfernen. Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl von 8 Artikeln. 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}:agent/agent-[0-9a-z]{17}$` Erforderlich: Nein ** [BucketName](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt den Namen des Objektspeicher-Buckets an, der an der Übertragung beteiligt ist. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 3. Maximale Länge beträgt 63 Zeichen. Pattern: `^[a-zA-Z0-9_\-\+\.\(\)\$\p{Zs}]+$` Erforderlich: Ja ** [CmkSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt die Konfigurationsinformationen für ein vom Kunden DataSync AWS KMS key verwaltetes Geheimnis an, zu dem auch der Schlüssel gehört`SecretKey`, der für den Zugriff auf einen bestimmten Objektspeicherort DataSync verwendet wird. Wenn Sie diesen Parameter als Teil einer `CreateLocationObjectStorage` Anfrage angeben, geben Sie nur den KMS-Schlüssel ARN an. DataSync verwendet diesen KMS-Schlüssel zusammen mit dem Wert, den Sie für den `SecretKey` Parameter angeben, um ein DataSync verwaltetes Geheimnis zum Speichern der Anmeldeinformationen für den Standortzugriff 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`SecretKey`) oder `CustomSecretConfig` (ohne`SecretKey`) verwenden, um Anmeldeinformationen für eine `CreateLocationObjectStorage` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [CustomSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt Konfigurationsinformationen für ein vom Kunden verwaltetes Secrets Manager-Geheimnis an, bei dem der geheime Schlüssel für einen bestimmten Objektspeicherort 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`SecretKey`) oder `CustomSecretConfig` (ohne`SecretKey`) verwenden, um Anmeldeinformationen für eine `CreateLocationObjectStorage` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [SecretKey](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt den geheimen Schlüssel (z. B. ein Passwort) an, wenn Anmeldeinformationen für die Authentifizierung beim Objektspeicher-Server erforderlich sind. Wenn Sie mithilfe von `CmkSecretConfig` oder ein Geheimnis angeben`SecretKey`, aber keine geheimen Konfigurationsdetails angeben`CustomSecretConfig`, DataSync speichert das Token unter Verwendung des Secrets Manager Manager-Geheimnisses Ihres AWS Kontos. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 200 Zeichen. Pattern: `^.*$` Erforderlich: Nein ** [ServerCertificate](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt eine Zertifikatskette für DataSync die Authentifizierung bei Ihrem Objektspeichersystem an, falls das System eine private oder selbstsignierte Zertifizierungsstelle (CA) verwendet. Sie müssen eine einzelne `.pem` Datei mit einer vollständigen Zertifikatskette angeben (z. B.`file:///home/user/.ssh/object_storage_certificates.pem`). Die Zertifikatskette könnte Folgendes beinhalten: + Das Zertifikat des Objektspeichersystems + Alle Zwischenzertifikate (falls vorhanden) + Das Stammzertifikat der signierenden Zertifizierungsstelle Sie können Ihre Zertifikate zu einer `.pem` Datei zusammenfügen (die vor der Base64-Kodierung bis zu 32768 Byte groß sein kann). Mit dem folgenden `cat` Beispielbefehl wird eine `object_storage_certificates.pem` Datei erstellt, die drei Zertifikate enthält: `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem` Um diesen Parameter zu verwenden, konfigurieren Sie `ServerProtocol` auf`HTTPS`. Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 32768. Erforderlich: Nein ** [ServerHostname](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt den Domainnamen oder die IP-Adresse (IPv4 oder IPv6) des Object Storage-Servers an, mit dem Ihr DataSync Agent eine Verbindung herstellt. 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 ** [ServerPort](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt den Port an, an dem Ihr Objektspeicher-Server eingehenden Netzwerkverkehr annimmt (z. B. Port 443). Typ: Ganzzahl Gültiger Bereich: Mindestwert 1. Der Höchstwert ist 65536. Erforderlich: Nein ** [ServerProtocol](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt das Protokoll an, das Ihr Objektspeicher-Server für die Kommunikation verwendet. Wenn nichts angegeben ist, lautet der Standardwert `HTTPS`. Typ: Zeichenfolge Zulässige Werte: `HTTPS | HTTP` Erforderlich: Nein ** [Subdirectory](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt das Objekt-Präfix für Ihren Objektspeicher-Server an. Wenn es sich um einen Quellspeicherort handelt, werden DataSync nur Objekte mit diesem Präfix kopiert. Wenn es sich um einen Zielort handelt, werden alle Objekte mit diesem Präfix DataSync geschrieben. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$` Erforderlich: Nein ** [Tags](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt Schlüssel-Wert-Paar an, das für ein Tag steht, das Sie der Ressource hinzufügen möchten. Mithilfe von Tags können Sie Ihre Ressourcen verwalten, filtern und suchen. Wir empfehlen, 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 ## 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_CreateLocationObjectStorage_ResponseSyntax) ** Gibt den ARN des Objekt-Storage-Systemspeicherorts an, 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 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/CreateLocationObjectStorage) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationObjectStorage)