Menggunakan alias gaya bucket untuk titik akses bucket S3 Anda - Amazon Simple Storage Service

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan alias gaya bucket untuk titik akses bucket S3 Anda

Saat Anda membuat titik akses, Amazon S3 secara otomatis membuat alias yang dapat Anda gunakan alih-alih nama bucket Amazon S3 untuk akses data. Anda dapat menggunakan alias titik akses ini alih-alih Amazon Resource Name (ARN) untuk operasi bidang data titik akses. Untuk mengetahui daftar operasi ini, lihat Kompatibilitas titik akses dengan AWS layanan.

Berikut ini menunjukkan contoh ARN dan alias titik akses untuk titik akses bernamamy-access-point.

  • ARNarn:aws:s3:region:account-id:accesspoint/my-access-point

  • Alias titik aksesmy-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias

Untuk informasi selengkapnyaARNs, lihat Amazon Resource Names (ARNs) di Referensi Umum AWS.

Nama alias titik akses

Nama alias titik akses dibuat dalam namespace yang sama dengan bucket Amazon S3. Nama alias ini dibuat secara otomatis, dan tidak dapat diubah. Nama alias titik akses memenuhi semua persyaratan nama bucket Amazon S3 yang valid dan terdiri dari bagian-bagian berikut:

access point prefix-metadata-s3alias

catatan

Sufiks -s3alias dicadangkan untuk nama alias titik akses, dan tidak dapat digunakan untuk nama bucket atau titik akses. Untuk informasi selengkapnya tentang penamaan bucket di Amazon S3, lihat Aturan penamaan bucket tujuan umum.

Kasus penggunaan dan batasan alias titik akses

Saat mengadopsi titik akses, Anda dapat menggunakan alias titik akses tanpa memerlukan perubahan kode yang ekstensif.

Saat Anda membuat titik akses, Amazon S3 secara otomatis menghasilkan nama alias titik akses, seperti yang ditunjukkan dalam contoh berikut. Untuk menjalankan perintah ini, ganti user input placeholders dengan informasi Anda sendiri.

aws s3control create-access-point --bucket amzn-s3-demo-bucket1 --name my-access-point --account-id 111122223333 { "AccessPointArn": "arn:aws:s3:region:111122223333:accesspoint/my-access-point", "Alias": "my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias" }

Anda dapat menggunakan nama alias titik akses ini alih-alih nama bucket Amazon S3 dalam operasi bidang data apa pun. Untuk mengetahui daftar operasi ini, lihat Kompatibilitas titik akses dengan AWS layanan.

AWS CLI Contoh berikut untuk get-object perintah menggunakan alias access point bucket untuk mengembalikan informasi tentang objek yang ditentukan. Untuk menjalankan perintah ini, ganti user input placeholders dengan informasi Anda sendiri.

aws s3api get-object --bucket my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias --key dir/my_data.rtf my_data.rtf { "AcceptRanges": "bytes", "LastModified": "2020-01-08T22:16:28+00:00", "ContentLength": 910, "ETag": "\"00751974dc146b76404bb7290f8f51bb\"", "VersionId": "null", "ContentType": "text/rtf", "Metadata": {} }

Batasan

  • Alias tidak dapat dikonfigurasi oleh pelanggan.

  • Alias tidak dapat dihapus atau dimodifikasi atau dinonaktifkan pada titik akses.

  • Anda dapat menggunakan nama alias titik akses ini alih-alih nama bucket Amazon S3 dalam beberapa operasi bidang data. Untuk mengetahui daftar operasi ini, lihat Kompatibilitas titik akses dengan operasi S3.

  • Anda tidak dapat menggunakan nama alias titik akses untuk operasi bidang kontrol Amazon S3. Untuk daftar operasi pesawat kontrol Amazon S3, lihat Kontrol Amazon S3 di Referensi Layanan Penyimpanan Sederhana Amazon. API

  • Anda tidak dapat menggunakan alias titik akses S3 sebagai sumber atau tujuan untuk operasi Pindahkan di konsol Amazon S3.

  • Alias tidak dapat digunakan dalam AWS Identity and Access Management (IAM) kebijakan.

  • Alias ​​tidak dapat digunakan sebagai tujuan pencatatan untuk log akses server S3.

  • Alias tidak dapat digunakan sebagai tujuan logging untuk AWS CloudTrail log.

  • Amazon SageMaker GroundTruth tidak mendukung alias titik akses.