Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mereferensikan titik akses untuk bucket tujuan umum dengan ARNs, alias titik akses, atau gaya host virtual URIs
Setelah membuat titik akses untuk bucket tujuan umum, Anda dapat menggunakan titik akhir ini untuk membentuk sejumlah operasi. Saat merujuk ke titik akses untuk bucket tujuan umum, Anda dapat menggunakan Amazon Resource Names (ARNs), alias access point, atau URI gaya yang di-host virtual.
Topik
Titik akses untuk ember tujuan umum ARNs
Titik akses memiliki Nama Sumber Daya Amazon (ARNs). Titik akses untuk bucket tujuan umum ARNs mirip dengan bucket ARNs, tetapi mereka secara eksplisit diketik dan menyandikan titik akses Wilayah AWS dan Akun AWS ID pemilik jalur akses. Untuk informasi selengkapnya ARNs, lihat Amazon Resource Names (ARNs) di Referensi Umum AWS.
Jalur akses ARNs menggunakan format berikut:
arn:aws:s3:
region
:account-id
:accesspoint/resource
-
arn:aws:s3:
mewakili titik akses bernamaus-west-2
:123456789012
:accesspoint/test
, yang dimiliki oleh akuntest
di Wilayah123456789012
.us-west-2
-
arn:aws:s3:
mewakili semua titik akses di bawah akunus-west-2
:123456789012
:accesspoint/*
di Wilayah123456789012
.us-west-2
ARNs untuk objek yang diakses melalui jalur akses gunakan format berikut:
arn:aws:s3:
region
:account-id
:accesspoint/access-point-name
/object/resource
-
arn:aws:s3:
mewakili objekus-west-2
:123456789012
:accesspoint/test
/object/unit-01
, diakses melalui titik akses bernamaunit-01
, dimiliki oleh akuntest
di Wilayah123456789012
.us-west-2
-
arn:aws:s3:
mewakili semua objek untuk titik akses bernamaus-west-2
:123456789012
:accesspoint/test
/object/*
, dalam akuntest
di Wilayah123456789012
.us-west-2
-
arn:aws:s3:
mewakili semua objek di bawah awalanus-west-2
:123456789012
:accesspoint/test
/object/unit-01
/finance
/*
untuk titik akses bernamaunit-01/finance/
, dalam akuntest
di Wilayah123456789012
.us-west-2
Titik akses untuk alias bucket tujuan umum
Saat Anda membuat titik akses untuk bucket tujuan umum, Amazon S3 secara otomatis menghasilkan 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 Titik akses untuk kompatibilitas bucket tujuan umum.
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 ember tujuan umum.
Titik akses untuk bucket tujuan umum menggunakan kasus dan batasan alias
Saat mengadopsi titik akses untuk bucket tujuan umum, Anda dapat menggunakan nama alias titik akses tanpa memerlukan perubahan kode yang ekstensif.
Saat Anda membuat titik akses untuk bucket tujuan umum, Amazon S3 secara otomatis menghasilkan nama alias titik akses, seperti yang ditunjukkan pada contoh berikut. Untuk menjalankan perintah ini, ganti
dengan informasi Anda sendiri.user
input placeholders
aws s3control create-access-point --bucket
amzn-s3-demo-bucket1
--namemy-access-point
--account-id111122223333
{ "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 Titik akses untuk kompatibilitas bucket tujuan umum.
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
dengan informasi Anda sendiri.user input placeholders
aws s3api get-object --bucket
my-access-point
-aqfqprnstn7aefdfbarligizwgyfouse1a
-s3alias --keydir/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": {} }
Keterbatasan alias titik akses
-
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 Titik akses untuk kompatibilitas bucket tujuan umum dengan operasi S3.
-
Anda tidak dapat menggunakan nama alias titik akses untuk operasi bidang kontrol Amazon S3. Untuk daftar operasi bidang kontrol Amazon S3, lihat Kontrol Amazon S3 di Referensi API Amazon Simple Storage Service.
-
Anda tidak dapat menggunakan alias titik akses S3 sebagai sumber atau tujuan untuk operasi Pindah di konsol Amazon S3.
-
Alias tidak dapat digunakan dalam kebijakan AWS Identity and Access Management (IAM).
-
Alias tidak dapat digunakan sebagai tujuan pencatatan untuk log akses server S3.
-
Alias tidak dapat digunakan sebagai tujuan logging untuk log AWS CloudTrail .
-
Amazon SageMaker GroundTruth tidak mendukung alias titik akses.
URI bergaya host virtual
Titik akses untuk bucket tujuan umum hanya mendukung virtual-host-style pengalamatan. Dalam URI gaya host virtual, nama titik akses Akun AWS, dan Wilayah AWS merupakan bagian dari nama domain di URL. Untuk informasi lebih lanjut tentang hosting virtual, lihatHosting virtual dari ember tujuan umum.
URI bergaya tuan rumah virtual untuk titik akses menggunakan format berikut:
https://
access-point-name
-account-id
.s3-accesspoint.region
.amazonaws.com
catatan
-
Jika nama titik akses Anda mencakup karakter tanda pisah (-), sertakan tanda pisah dalam URL dan masukkan tanda pisah lainnya sebelum ID akun. Misalnya, untuk menggunakan titik akses bernama
dimiliki oleh akunfinance-docs
di Wilayah123456789012
, URL yang sesuai adalahus-west-2
https://
.finance-docs
-123456789012
.s3-accesspoint.us-west-2
.amazonaws.com -
Jalur akses S3 tidak mendukung akses melalui HTTP. Jalur akses hanya mendukung akses aman melalui HTTPS.