Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # CreateLocationS3 Membuat *lokasi* transfer untuk bucket Amazon S3. AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data. **penting** Sebelum Anda mulai, pastikan Anda membaca topik-topik berikut: [Pertimbangan kelas penyimpanan dengan lokasi Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [Mengevaluasi biaya permintaan S3 saat menggunakan DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) Untuk informasi selengkapnya, lihat [Mengonfigurasi transfer dengan Amazon](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html) S3. ## Sintaksis Permintaan ``` { "AgentArns": [ "string" ], "S3BucketArn": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Parameter Permintaan Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md). Permintaan menerima data berikut dalam format JSON. ** [AgentArns](#API_CreateLocationS3_RequestSyntax) ** (Amazon S3 hanya di Outposts) Menentukan Nama Sumber Daya Amazon (ARN) agen di Outpost Anda. DataSync Untuk informasi selengkapnya, lihat [Menyebarkan DataSync agen Anda di AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent). Tipe: Array string Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item. Batasan Panjang: Panjang maksimum 128. Pola: `^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}$` Wajib: Tidak ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) ** Menentukan ARN bucket S3 yang ingin Anda gunakan sebagai lokasi. (Saat membuat DataSync tugas nanti, Anda menentukan apakah lokasi ini adalah sumber transfer atau tujuan.) Jika bucket S3 Anda terletak di AWS Outposts sumber daya, Anda harus menentukan jalur akses Amazon S3. Untuk informasi selengkapnya, lihat [Mengelola akses data dengan jalur akses Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html) di Panduan Pengguna *Amazon S3*. Tipe: String Kendala Panjang: Panjang maksimum 268. Pola: `^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}$` Wajib: Ya ** [S3Config](#API_CreateLocationS3_RequestSyntax) ** Menentukan Nama Sumber Daya Amazon (ARN) peran (IAM) DataSync yang digunakan untuk mengakses bucket S3 Anda. AWS Identity and Access Management Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke bucket S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access). Tipe: Objek [S3Config](API_S3Config.md) Wajib: Ya ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) ** Menentukan kelas penyimpanan yang Anda ingin objek Anda gunakan saat Amazon S3 adalah tujuan transfer. Untuk bucket masuk Wilayah AWS, kelas penyimpanan default ke. `STANDARD` Untuk bucket aktif AWS Outposts, kelas penyimpanan default ke. `OUTPOSTS` Untuk informasi selengkapnya, lihat [Pertimbangan kelas penyimpanan dengan transfer Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). Tipe: String Nilai yang Valid: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` Wajib: Tidak ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) ** Menentukan awalan di bucket S3 yang DataSync membaca dari atau menulis ke (tergantung pada apakah bucket adalah lokasi sumber atau tujuan). DataSync tidak dapat mentransfer objek dengan awalan yang dimulai dengan garis miring (`/`) atau termasuk`//`,`/./`, atau `/../` pola. Contoh: + `/photos` + `photos//2006/January` + `photos/./2006/February` + `photos/../2006/March` Tipe: String Batasan Panjang: Panjang maksimum 4096. Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$` Wajib: Tidak ** [Tags](#API_CreateLocationS3_RequestSyntax) ** Menentukan label yang membantu Anda mengkategorikan, memfilter, dan mencari sumber daya Anda. AWS Sebaiknya buat setidaknya tag nama untuk lokasi transfer Anda. Tipe: Array objek [TagListEntry](API_TagListEntry.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item. Diperlukan: Tidak ## Sintaksis Respons ``` { "LocationArn": "string" } ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [LocationArn](#API_CreateLocationS3_ResponseSyntax) ** ARN dari lokasi S3 yang Anda buat. Tipe: String Batasan Panjang: Panjang maksimum 128. Pola: `^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}$` ## Kesalahan Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md). ** InternalException ** Pengecualian ini dilontarkan ketika terjadi kesalahan dalam layanan AWS DataSync . Kode Status HTTP: 500 ** InvalidRequestException ** Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format. Kode Status HTTP: 400 ## Lihat Juga Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini: + [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para 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 untuk 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)