

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 di Outposts
<a name="s3-outposts-access-points-alias"></a>

Dengan S3 di Outposts, Anda harus menggunakan titik akses untuk mengakses objek apa pun dalam bucket Outposts. Setiap kali Anda membuat titik akses untuk bucket, S3 di Outposts secara otomatis menghasilkan alias titik akses. Anda dapat menggunakan alias titik akses ini alih-alih ARN titik akses untuk operasi bidang data apa pun. Misalnya, Anda dapat menggunakan alias titik akses untuk melakukan operasi tingkat objek seperti PUT, GET, LIST, dan lainnya. Untuk mengetahui daftar operasi ini, lihat [Operasi API Amazon S3 untuk mengelola objek](S3OutpostsAPI.md#S3OutpostsAPIsObject).

Contoh berikut menunjukkan ARN dan alias titik akses untuk titik akses bernama `my-access-point`.
+ **ARN titik akses**–`arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/my-access-point`
+ **Alias titik akses**–`my-access-po-o01ac5d28a6a232904e8xz5w8ijx1qzlbp3i3kuse10--op-s3`

Untuk informasi selengkapnya ARNs, lihat [Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) di *Referensi Umum AWS*.

Untuk informasi selengkapnya tentang alias titik akses, lihat topik berikut.

**Topics**
+ [Alias titik akses](#access-points-alias-name-s3-outposts)
+ [Menggunakan alias titik akses dalam operasi objek S3 di Outposts](#access-points-alias-use-case-s3-outposts)
+ [Batasan](#access-points-alias-limitations-s3-outposts)

## Alias titik akses
<a name="access-points-alias-name-s3-outposts"></a>

Alias titik akses dibuat dalam namespace yang sama dengan bucket S3 di Outposts. Saat Anda membuat titik akses, S3 di Outposts secara otomatis menghasilkan alias titik akses yang tidak dapat diubah. Alias titik akses memenuhi semua persyaratan nama bucket S3 di Outposts yang valid dan terdiri atas bagian berikut:

`access point name prefix-metadata--op-s3`

**catatan**  
Sufiks `--op-s3` dipesan untuk alias titik akses, kami menyarankan agar Anda tidak menggunakannya untuk nama bucket atau titik akses. Untuk informasi selengkapnya tentang aturan penamaan bucket S3 di Outposts, lihat [Bekerja dengan S3 di bucket Outposts](S3OutpostsWorkingBuckets.md).

### Menemukan alias titik akses
<a name="access-points-alias-name-s3-outposts-find"></a>

Contoh berikut menunjukkan cara menemukan alias titik akses menggunakan konsol Amazon S3 dan AWS CLI.

**Example : Temukan dan salin alias titik akses di konsol Amazon S3**  
Setelah Anda membuat titik akses di konsol, Anda dapat memperoleh alias titik akses dari kolom **alias Titik Akses** di daftar **Titik Akses**.   

**Untuk menyalin alias titik akses**

1. Buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Di panel navigasi kiri, pilih **titik akses Outposts**.

1. Untuk menyalin alias titik akses, lakukan salah satu hal berikut:
   + Dalam daftar **Titik Akses**, pilih tombol opsi di sebelah nama titik akses, lalu pilih **Salin alias Titik Akses**.
   + Pilih nama titik akses. Kemudian, dalam **ikhtisar titik akses Outposts**, salin alias titik akses.

**Example : Buat titik akses dengan menggunakan AWS CLI dan temukan alias titik akses dalam respons**  
 AWS CLI Contoh berikut untuk `create-access-point` perintah menciptakan titik akses dan mengembalikan alias titik akses yang dihasilkan secara otomatis. Untuk menjalankan perintah ini, ganti `user input placeholders` dengan informasi Anda sendiri.  

```
aws s3control create-access-point --bucket example-outposts-bucket --name example-outposts-access-point --account-id 123456789012

{
    "AccessPointArn":
    "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point",
    "Alias": "example-outp-o01ac5d28a6a232904e8xz5w8ijx1qzlbp3i3kuse10--op-s3"
}
```

**Example : Dapatkan alias access point dengan menggunakan AWS CLI**  
 AWS CLI Contoh berikut untuk `get-access-point` perintah mengembalikan informasi tentang titik akses yang ditentukan. Informasi ini termasuk alias titik akses. Untuk menjalankan perintah ini, ganti `user input placeholders` dengan informasi Anda sendiri.  

```
aws s3control get-access-point --bucket arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket --name example-outposts-access-point --account-id 123456789012

{
    "Name": "example-outposts-access-point",
    "Bucket": "example-outposts-bucket",
    "NetworkOrigin": "Vpc",
    "VpcConfiguration": {
        "VpcId": "vpc-01234567890abcdef"
    },
    "PublicAccessBlockConfiguration": {
        "BlockPublicAcls": true,
        "IgnorePublicAcls": true,
        "BlockPublicPolicy": true,
        "RestrictPublicBuckets": true
    },
    "CreationDate": "2022-09-18T17:49:15.584000+00:00",
    "Alias": "example-outp-o0b1d075431d83bebde8xz5w8ijx1qzlbp3i3kuse10--op-s3"
}
```

**Example : Daftar titik akses untuk menemukan alias titik akses dengan menggunakan AWS CLI**  
 AWS CLI Contoh berikut untuk `list-access-points` perintah mencantumkan informasi tentang titik akses yang ditentukan. Informasi ini termasuk alias titik akses. Untuk menjalankan perintah ini, ganti `user input placeholders` dengan informasi Anda sendiri.  

```
aws s3control list-access-points --account-id 123456789012 --bucket arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket

{
    "AccessPointList": [
        {
            "Name": "example-outposts-access-point",
            "NetworkOrigin": "Vpc",
            "VpcConfiguration": {
                "VpcId": "vpc-01234567890abcdef"
            },
            "Bucket": "example-outposts-bucket",
            "AccessPointArn": "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point",
            "Alias": "example-outp-o0b1d075431d83bebde8xz5w8ijx1qzlbp3i3kuse10--op-s3"
        }
    ]
}
```

## Menggunakan alias titik akses dalam operasi objek S3 di Outposts
<a name="access-points-alias-use-case-s3-outposts"></a>

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

 AWS CLI Contoh ini menunjukkan `get-object` operasi untuk bucket S3 pada Outposts. Contoh ini menggunakan alias titik akses sebagai nilai untuk `--bucket` bukan ARN titik akses penuh.

```
aws s3api get-object --bucket my-access-po-o0b1d075431d83bebde8xz5w8ijx1qzlbp3i3kuse10--op-s3 --key  testkey  sample-object.rtf

{
    "AcceptRanges": "bytes",
    "LastModified": "2020-01-08T22:16:28+00:00",
    "ContentLength": 910,
    "ETag": "\"00751974dc146b76404bb7290f8f51bb\"",
    "VersionId": "null",
    "ContentType": "text/rtf",
    "Metadata": {}
}
```

## Batasan
<a name="access-points-alias-limitations-s3-outposts"></a>
+ Alias tidak dapat dikonfigurasi oleh pelanggan.
+ Alias tidak dapat dihapus atau dimodifikasi atau dinonaktifkan pada titik akses.
+ Anda tidak dapat menggunakan alias titik akses untuk operasi bidang kontrol S3 di Outposts. Untuk daftar oeprasi bidang kontrol S3 di Outposts, lihat [Operasi API Amazon S3 Control untuk mengelola bucket](S3OutpostsAPI.md#S3OutpostsAPIsBucket).
+ Alias tidak dapat digunakan dalam kebijakan AWS Identity and Access Management (IAM).