本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateLocationS3 建立 Amazon S3 儲存貯體的傳輸*位置*。 AWS DataSync 可以使用此位置做為傳輸資料的來源或目的地。 **重要** 開始之前，請確定您已閱讀下列主題： [Amazon S3 位置的儲存類別考量](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [使用 DataSync 時評估 S3 請求成本](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 如需詳細資訊，請參閱[使用 Amazon S3 設定傳輸](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html)。 ## 請求語法 ``` { "AgentArns": [ "string" ], "S3BucketArn": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [AgentArns](#API_CreateLocationS3_RequestSyntax) ** （僅限 Outposts 上的 Amazon S3) 指定 Outpost 上 DataSync 代理程式的 Amazon Resource Name (ARN)。 如需詳細資訊，請參閱在 [上部署 DataSync 代理程式 AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent)。 類型：字串陣列 陣列成員：項目數下限為 1。最多 8 個項目。 長度限制：長度上限為 128。 模式：`^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}$` 必要：否 ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) ** 指定您要用作位置之 S3 儲存貯體的 ARN。（稍後建立 DataSync 任務時，您可以指定此位置是傳輸來源還是目的地。) 如果您的 S3 儲存貯體位於 AWS Outposts 資源上，您必須指定 Amazon S3 存取點。如需詳細資訊，請參閱《[Amazon S3 使用者指南》中的使用 Amazon S3 存取點管理資料存取](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html)。 *Amazon S3 * 類型：字串 長度限制：長度上限為 268。 模式：`^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}$` 必要：是 ** [S3Config](#API_CreateLocationS3_RequestSyntax) ** 指定 DataSync 用來存取 S3 儲存貯體之 AWS Identity and Access Management (IAM) 角色的 Amazon Resource Name (ARN)。 如需詳細資訊，請參閱[提供 S3 儲存貯體的 DataSync 存取權](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access)。 類型：[S3Config](API_S3Config.md) 物件 必要：是 ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) ** 指定當 Amazon S3 是傳輸目的地時，您希望物件使用的儲存體方案。 對於 中的儲存貯體 AWS 區域，儲存類別預設為 `STANDARD`。對於 上的儲存貯體 AWS Outposts，儲存體方案預設為 `OUTPOSTS`。 如需詳細資訊，請參閱 [Amazon S3 傳輸的儲存類別考量](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)。 類型：字串 有效值:`STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` 必要：否 ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) ** 在 DataSync 讀取或寫入的 S3 儲存貯體中指定字首 （取決於儲存貯體是來源或目的地位置）。 DataSync 無法傳輸字首開頭為斜線 (`/`) 或包含 `//`、 `/./`或 `/../` 模式的物件。例如： + `/photos` + `photos//2006/January` + `photos/./2006/February` + `photos/../2006/March` 類型：字串 長度限制：長度上限為 4096。 模式：`^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$` 必要：否 ** [Tags](#API_CreateLocationS3_RequestSyntax) ** 指定可協助您分類、篩選和搜尋 AWS 資源的標籤。我們建議為您的傳輸位置建立至少一個名稱標籤。 類型：[TagListEntry](API_TagListEntry.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 50。 必要：否 ## 回應語法 ``` { "LocationArn": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [LocationArn](#API_CreateLocationS3_ResponseSyntax) ** 您建立之 S3 位置的 ARN。 類型：字串 長度限制：長度上限為 128。 模式：`^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}$` ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InternalException ** 當服務發生錯誤時，就會擲出此 AWS DataSync 例外狀況。 HTTP 狀態碼：500 ** InvalidRequestException ** 當用戶端提交格式不正確的請求時，會擲回此例外狀況。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationS3) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3)