Menggunakan alias gaya bucket untuk titik akses bucket S3 di Outposts - Amazon S3 di Outposts
Alias titik aksesMenggunakan alias titik akses dalam operasi objek S3 di OutpostsBatasan

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

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 titik akses ARN untuk operasi pesawat data apa pun. Misalnya, Anda dapat menggunakan alias titik akses untuk melakukan operasi tingkat objek sepertiPUT,, GETLIST, dan lainnya. Untuk mengetahui daftar operasi ini, lihat APIOperasi Amazon S3 untuk mengelola objek.

Contoh berikut menunjukkan alias ARN dan titik akses untuk titik akses bernamamy-access-point.

  • Titik akses ARN - arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/my-access-point

  • Alias titik akses–my-access-po-o01ac5d28a6a232904e8xz5w8ijx1qzlbp3i3kuse10--op-s3

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

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

Alias titik akses

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.

Menemukan alias titik akses

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

contoh : 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/

  2. Di panel navigasi kiri, pilih titik akses Outposts.

  3. 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.

contoh : 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"
}
contoh : 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"
}
contoh : 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

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 access point sebagai nilai untuk --bucket bukan titik ARN 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

  • 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 APIOperasi Kontrol Amazon S3 untuk mengelola bucket.

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