Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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:
Untuk informasi selengkapnya, lihat Mengonfigurasi transfer dengan Amazon 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.
Permintaan menerima data berikut dalam format JSON.
- AgentArns
-
(Amazon S3 hanya di Outposts) Menentukan Nama Sumber Daya Amazon (ARN) agen di Outpost Anda. DataSync
Untuk informasi selengkapnya, lihat Menerapkan DataSync agen Anda di AWS Outposts.
Tipe: Array string
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 4 item.
Batasan Panjang: Panjang maksimum 128.
Pola:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$Wajib: Tidak
- S3BucketArn
-
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 di Panduan Pengguna Amazon S3.
Tipe: String
Kendala Panjang: Panjang maksimum 268.
Pola:
^arn:(aws|aws-cn|aws-us-gov|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-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-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$Wajib: Ya
- S3Config
-
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.
Tipe: Objek S3Config
Wajib: Ya
- S3StorageClass
-
Menentukan kelas penyimpanan yang Anda ingin objek Anda gunakan saat Amazon S3 adalah tujuan transfer.
Untuk bucket masuk Wilayah AWS, kelas penyimpanan default ke.
STANDARDUntuk bucket aktif AWS Outposts, kelas penyimpanan default ke.OUTPOSTSUntuk informasi selengkapnya, lihat Pertimbangan kelas penyimpanan dengan transfer Amazon S3.
Tipe: String
Nilai yang Valid:
STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVALWajib: Tidak
- Subdirectory
-
Menentukan awalan di bucket S3 yang DataSync membaca dari atau menulis ke (tergantung pada apakah bucket adalah lokasi sumber atau tujuan).
catatan
DataSync tidak dapat mentransfer objek dengan awalan yang dimulai dengan garis miring (
/) atau termasuk//,/./, atau/../pola. Sebagai 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
-
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
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
-
ARN dari lokasi S3 yang Anda buat.
Tipe: String
Batasan Panjang: Panjang maksimum 128.
Pola:
^arn:(aws|aws-cn|aws-us-gov|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.
- 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
Contoh
Langkah 1. Izinkan untuk mengasumsikan IAM role yang diperlukan untuk menulis ke bucket
Contoh berikut menunjukkan kebijakan paling sederhana yang memberikan izin yang diperlukan AWS DataSync untuk mengakses bucket Amazon S3 tujuan, diikuti dengan peran IAM yang telah dilampirkan kebijakan create-location-s3-iam-role tersebut.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}"Role": {
"Path": "/",
"RoleName": "amzn-s3-demo-bucket-access-role",
"RoleId": "role-id",
"Arn": "arn:aws:iam::account-id:role/amzn-s3-demo-bucket-access-role",
"CreateDate": "2018-07-27T02:49:23.117Z",
"AssumeRolePolicyDocument": {
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
}
}Langkah 2. Izinkan IAM role yang dibuat untuk menulis ke bucket
Lampirkan kebijakan yang memiliki izin yang memadai untuk mengakses bucket ke peran. Contoh kebijakan tersebut adalah kebijakan yang dikelola AWSDataSyncFullAccess.
Untuk informasi selengkapnya, lihat AWSDataSyncFullAccess
Anda tidak perlu membuat kebijakan ini. Ini dikelola oleh AWS, jadi semua yang perlu Anda lakukan adalah menentukan ARN dalam perintah. attach-role-policy
IAM_POLICY_ARN='arn:aws:iam::aws:policy/AWSDataSyncFullAccess'Langkah 3. Buat titik akhir untuk bucket Amazon S3
Contoh berikut membuat titik akhir untuk bucket Amazon S3.
Ketika titik akhir S3 dibuat, respons yang mirip dengan contoh kedua berikut mengembalikan Amazon Resource Name (ARN) untuk lokasi Amazon S3 baru.
Contoh Permintaan
{
"S3BucketArn": "arn:aws:s3:::amzn-s3-demo-bucket",
"S3Config": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/amzn-s3-demo-bucket-access-role",
},
"S3StorageClass": "STANDARD",
"Subdirectory": "/MyFolder",
"Tags": [
{
"Key": "Name",
"Value": "s3Bucket-1"
}
]
}Contoh Respons
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
