Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mereferensikan titik akses dengan ARNs, alias titik akses, atau gaya host virtual URIs
Setelah Anda membuat titik akses, Anda dapat menggunakan titik akhir ini untuk membentuk sejumlah operasi. Saat merujuk ke titik akses, Anda dapat menggunakan Amazon Resource Names (ARNs), alias access point, atau URI gaya host virtual.
**Topics**
+ [Titik akses ARNs](#access-points-arns)
+ [Alias titik akses](#access-points-alias)
+ [URI bergaya host virtual](#accessing-a-bucket-through-s3-access-point)
## Titik akses ARNs
Titik akses memiliki Nama Sumber Daya Amazon (ARNs). Access point 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 [Mengidentifikasi AWS sumber daya dengan Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) di *Panduan Pengguna IAM*.
Jalur akses ARNs menggunakan format berikut:
```
arn:aws:s3:{{region}}:{{account-id}}:accesspoint/{{resource}}
```
+ `arn:aws:s3:{{us-west-2}}:{{123456789012}}:accesspoint/{{test}}`mewakili titik akses bernama`{{test}}`, yang dimiliki oleh akun {{`123456789012`}} di Wilayah{{`us-west-2`}}.
+ `arn:aws:s3:{{us-west-2}}:{{123456789012}}:accesspoint/*`mewakili semua titik akses di bawah akun {{`123456789012`}} di Wilayah{{`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:{{us-west-2}}:{{123456789012}}:accesspoint/{{test}}/object/{{unit-01}}`mewakili objek{{`unit-01`}}, diakses melalui titik akses bernama{{`test`}}, dimiliki oleh akun {{`123456789012`}} di Wilayah{{`us-west-2`}}.
+ `arn:aws:s3:{{us-west-2}}:{{123456789012}}:accesspoint/{{test}}/object/*`mewakili semua objek untuk titik akses bernama{{`test`}}, dalam akun {{`123456789012`}} di Wilayah{{`us-west-2`}}.
+ `arn:aws:s3:{{us-west-2}}:{{123456789012}}:accesspoint/{{test}}/object/{{unit-01}}/{{finance}}/*`mewakili semua objek di bawah awalan {{`unit-01/finance/`}} untuk titik akses bernama{{`test`}}, dalam akun {{`123456789012`}} di Wilayah{{`us-west-2`}}.
## Alias titik akses
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](access-points-service-api-support.md).
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 NAME}}-METADATA-s3alias`(untuk titik akses yang dilampirkan ke bucket Amazon S3)
`{{ACCESS POINT NAME}}-METADATA-ext-s3alias`(untuk titik akses yang dilampirkan ke sumber data bucket non-S3)
**catatan**
`-ext-s3alias`Sufiks `-s3alias` dan disediakan 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](bucketnamingrules.md).
### Alias titik akses menggunakan kasus dan batasan
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](access-points-service-api-support.md).
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": {}
}
```
#### 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 [Kompatibilitas titik akses dengan operasi S3](access-points-service-api-support.md#access-points-operations-support).
+ 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](https://docs.aws.amazon.com/AmazonS3/latest/API/API_Operations_AWS_S3_Control.html) 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 AI GroundTruth tidak mendukung alias titik akses.
## URI bergaya host virtual
Titik akses 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, lihat[Hosting virtual dari ember tujuan umum](VirtualHosting.md).
URI bergaya host 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 {{`finance-docs`}} dimiliki oleh akun {{`123456789012`}} di Wilayah{{`us-west-2`}}, URL yang sesuai adalah`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.