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. # CreateLocationS3 Erstellt einen *Übertragungsort* für einen Amazon S3 S3-Bucket. AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. **Wichtig** Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Themen gelesen haben: [Überlegungen zur Speicherklasse bei Amazon S3 S3-Standorten](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [Bewertung der Kosten für S3-Anfragen bei der Verwendung DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) Weitere Informationen finden Sie unter [Konfiguration von Übertragungen mit Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html). ## Anforderungssyntax ``` { "AgentArns": [ "string" ], "S3BucketArn": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "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. ** [AgentArns](#API_CreateLocationS3_RequestSyntax) ** (Nur Amazon S3 bei Outposts) Gibt den Amazon-Ressourcennamen (ARN) des DataSync Agenten in Ihrem Outpost an. Weitere Informationen finden Sie unter [Bereitstellen Ihres DataSync Agenten auf](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent). AWS Outposts 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 ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) ** Gibt den ARN des S3-Buckets an, den Sie als Speicherort verwenden möchten. (Wenn Sie Ihre DataSync Aufgabe später erstellen, geben Sie an, ob es sich bei diesem Speicherort um eine Übertragungsquelle oder ein Übertragungsziel handelt.) Wenn sich Ihr S3-Bucket auf einer AWS Outposts Ressource befindet, müssen Sie einen Amazon S3 S3-Zugriffspunkt angeben. Weitere Informationen finden Sie unter [Verwaltung des Datenzugriffs mit Amazon S3 S3-Zugriffspunkten](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html) im *Amazon S3 S3-Benutzerhandbuch*. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 268. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$` Erforderlich: Ja ** [S3Config](#API_CreateLocationS3_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der AWS Identity and Access Management (IAM) -Rolle an, die für den Zugriff auf Ihren S3-Bucket DataSync verwendet wird. Weitere Informationen finden Sie unter [ DataSync Zugriff auf S3-Buckets bereitstellen](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access). Typ: [S3Config](API_S3Config.md) Objekt Erforderlich: Ja ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) ** Gibt die Speicherklasse an, die Ihre Objekte verwenden sollen, wenn Amazon S3 ein Übertragungsziel ist. Für Buckets in ist AWS-Regionen die Speicherklasse standardmäßig auf eingestellt. `STANDARD` Bei aktivierten Buckets ist AWS Outposts die Speicherklasse standardmäßig auf. `OUTPOSTS` Weitere Informationen finden Sie unter [Überlegungen zur Speicherklasse bei Amazon S3 S3-Übertragungen](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). Typ: Zeichenfolge Zulässige Werte: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` Erforderlich: Nein ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) ** Gibt ein Präfix im S3-Bucket an, das DataSync Lese- oder Schreibvorgänge vornimmt (je nachdem, ob es sich bei dem Bucket um einen Quell- oder Zielspeicherort handelt). DataSync kann keine Objekte mit einem Präfix übertragen, das mit einem Schrägstrich (`/`) beginnt oder `/../` Muster einschließt`//`. `/./` Beispiel: + `/photos` + `photos//2006/January` + `photos/./2006/February` + `photos/../2006/March` Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$` Erforderlich: Nein ** [Tags](#API_CreateLocationS3_RequestSyntax) ** Gibt Beschriftungen an, die Ihnen helfen, Ihre Ressourcen zu kategorisieren, zu filtern und nach ihnen zu AWS suchen. Wir empfehlen, mindestens ein Namensschild für Ihren Transferort 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_CreateLocationS3_ResponseSyntax) ** Der ARN des S3-Standorts, 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/CreateLocationS3) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3)