Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
DescribeLocationS3
Memberikan detail tentang bagaimana lokasi AWS DataSync transfer untuk bucket S3 dikonfigurasi.
Sintaksis Permintaan
{
"LocationArn": "string"
}Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
Permintaan menerima data berikut dalam format JSON.
- LocationArn
-
Menentukan Nama Sumber Daya Amazon (ARN) dari lokasi Amazon S3.
Jenis: 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}$Diperlukan: Ya
Sintaksis Respons
{
"AgentArns": [ "string" ],
"CreationTime": number,
"LocationArn": "string",
"LocationUri": "string",
"S3Config": {
"BucketAccessRoleArn": "string"
},
"S3StorageClass": "string"
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- AgentArns
-
ARN DataSync agen yang digunakan di Outpost Anda saat menggunakan bekerja dengan Amazon S3 di Outposts.
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}$ - CreationTime
-
Waktu lokasi Amazon S3 dibuat.
Tipe: Timestamp
- LocationArn
-
ARN dari lokasi Amazon S3.
Jenis: 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}$ - LocationUri
-
URL dari lokasi Amazon S3 yang telah dijelaskan.
Jenis: String
Kendala Panjang: Panjang maksimum 4360.
Pola:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - 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 Mengakses bucket S3.
Tipe: Objek S3Config
- S3StorageClass
-
Ketika Amazon S3 adalah lokasi tujuan, ini adalah kelas penyimpanan yang Anda pilih untuk objek Anda.
Beberapa kelas penyimpanan memiliki perilaku yang dapat memengaruhi biaya penyimpanan Amazon S3 Anda. Untuk informasi selengkapnya, lihat Pertimbangan kelas penyimpanan dengan transfer Amazon S3.
Jenis: String
Nilai yang Valid:
STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL
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
Contoh
Contoh berikut mengembalikan informasi tentang lokasi Amazon S3 yang ditentukan dalam permintaan sampel.
Permintaan Sampel
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}Contoh
Contoh ini menggambarkan satu penggunaan DescribeLocation S3.
Contoh Respons
{
"CreationTime": 1532660733.39,
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3",
"LocationUri": "MyBucket.",
"S3Config": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/MyBucketAccessRole",
}
"S3StorageClass": "STANDARD"
}Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
