Menggunakan Titik Akses Lambda Objek Amazon S3 - 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 Titik Akses Lambda Objek Amazon S3

Membuat permintaan melalui Titik Akses Lambda Objek Amazon S3 berfungsi sama seperti membuat permintaan melalui titik akses lainnya. Untuk informasi selengkapnya tentang cara membuat permintaan melalui titik akses, lihat Menggunakan titik akses. Anda dapat membuat permintaan melalui Titik Akses Objek Lambda dengan menggunakan konsol Amazon S3 AWS Command Line Interface ,AWS CLI(), SDK AWS , atau Amazon S3 REST API.

penting

Amazon Resource Name (ARN) untuk Titik Akses Lambda Objek menggunakan nama layanan s3-object-lambda. Dengan demikian, Titik Akses Lambda Objek ARN dimulai dengan arn:aws::s3-object-lambda, bukan arn:aws::s3, yang digunakan dengan titik akses lainnya.

Cara untuk menemukan ARN untuk Titik Akses Lambda Objek Anda

Untuk menggunakan Object Lambda Access Point dengan AWS CLI atau AWS SDK, Anda perlu mengetahui Amazon Resource Name (ARN) dari Object Lambda Access Point. Contoh berikut menunjukkan cara untuk menemukan ARN untuk Titik Akses Lambda Objek dengan menggunakan konsol Amazon S3 atau. AWS CLI

Untuk menemukan ARN untuk Titik Akses Lambda Objek Anda dengan menggunakan konsol
  1. Masuk ke AWS Management Console dan buka konsol Amazon S3 di https://console.aws.amazon.com/s3/.

  2. Di panel navigasi sebelah kiri, pilih Titik Akses Lambda Objek.

  3. Pilih tombol opsi di samping Titik Akses Lambda Objek yang ARN-nya ingin Anda salin.

  4. Pilih Salin ARN.

Untuk menemukan ARN untuk Object Lambda Access Point Anda dengan menggunakan AWS CLI
  1. Untuk mengambil daftar Titik Akses Lambda Objek yang terkait dengan Akun AWS Anda, jalankan perintah berikut. Sebelum menjalankan perintah, ganti ID akun 111122223333dengan Akun AWS ID Anda.

    aws s3control list-access-points-for-object-lambda --account-id 111122223333
  2. Tinjau output perintah untuk menemukan Titik Akses Lambda Objek ARN yang ingin Anda gunakan. Output dari perintah sebelumnya akan terlihat seperti contoh berikut.

    { "ObjectLambdaAccessPointList": [ { "Name": "my-object-lambda-ap", "ObjectLambdaAccessPointArn": "arn:aws:s3-object-lambda:us-east-1:111122223333:accesspoint/my-object-lambda-ap" }, ... ] }

Cara menggunakan alias gaya bucket untuk bucket S3 Anda Titik Akses Lambda Objek

Saat Anda membuat Titik Akses Lambda Objek, Amazon S3 secara otomatis menghasilkan alias unik untuk Titik Akses Lambda Objek Anda. Anda dapat menggunakan alias ini alih-alih nama bucket Amazon S3 atau Amazon Resource Name (ARN) Titik Akses Lamda Objek dalam permintaan untuk operasi bidang data titik akses. Untuk mengetahui daftar operasi ini, lihat Kompatibilitas titik akses dengan AWS layanan.

Nama alias Titik Akses Lambda Objek dibuat dalam namespace yang sama dengan bucket Amazon S3. Nama alias ini dibuat secara otomatis, dan tidak dapat diubah. Untuk Titik Akses Lambda Objek yang ada, alias secara otomatis ditetapkan untuk digunakan. Nama alias Titik Akses Lambda Objek memenuhi semua persyaratan nama bucket Amazon S3 yang valid dan terdiri dari bagian-bagian berikut:

Object Lambda Access Point name prefix-metadata--ol-s3

catatan

Sufiks --ol-s3dicadangkan untuk nama alias Titik Akses Lambda Objek dan tidak dapat digunakan untuk nama bucket atau Titik Akses Lambda Objek. Untuk informasi selengkapnya tentang penamaan bucket di Amazon S3, lihat Peraturan penamaan bucket.

Contoh berikut menunjukkan ARN dan alias Titik Akses Lambda Objek untuk Titik Akses Lambda Objek bernama my-object-lambda-access-point:

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

  • Alias Titik Akses Lambda Objekmy-object-lambda-acc-1a4n8yjrb3kda96f67zwrwiiuse1a--ol-s3

Bila Anda menggunakan Titik Akses Lambda Objek, Anda dapat menggunakan nama alias Titik Akses Lambda Objek tanpa memerlukan perubahan kode yang ekstensif.

Ketika Anda menghapus Titik Akses Lambda Objek, nama alias Titik Akses Lambda Objek menjadi tidak aktif dan tidak tersedia.

Cara menemukan alias untuk Titik Akses Lambda Objek Anda

Untuk menemukan alias untuk Titik Akses Lambda Objek Anda dengan menggunakan konsol
  1. Masuk ke AWS Management Console dan buka konsol Amazon S3 di https://console.aws.amazon.com/s3/.

  2. Di panel navigasi sebelah kiri, pilih Titik Akses Lambda Objek.

  3. Untuk Access Point Lambda Objek yang ingin Anda gunakan, salin nilai Alias Titik Akses Lambda Objek.

Saat Anda membuat Titik Akses Lambda Objek, Amazon S3 secara otomatis menghasilkan nama alias Titik Akses Lambda Objek, seperti yang ditunjukkan pada perintah contoh berikut. Untuk menjalankan perintah ini, ganti user input placeholders dengan informasi Anda sendiri. Untuk informasi tentang cara membuat Titik Akses Objek Lambda menggunakan AWS CLI, lihat. Untuk membuat Object Lambda Access Point dengan menggunakan AWS CLI

aws s3control create-access-point-for-object-lambda --account-id 111122223333 --name my-object-lambda-access-point --configuration file://my-olap-configuration.json { "ObjectLambdaAccessPointArn": "arn:aws:s3:region:111122223333:accesspoint/my-access-point", "Alias": { "Value": "my-object-lambda-acc-1a4n8yjrb3kda96f67zwrwiiuse1a--ol-s3", "Status": "READY" } }

Nama alias Titik Akses Lambda Objek yang dihasilkan memiliki dua bidang:

  • Kolom Value tersebut adalah nilai alias Titik Akses Lambda Objek.

  • Bidang Status adalah status alias Titik Akses Lambda Objek. Jika statusnya adalah PROVISIONING, Amazon S3 menyediakan alias Titik Akses Lambda Objek, dan alias belum siap untuk digunakan. Jika statusnya adalah READY, alias Titik Akses Lambda Objek telah berhasil disediakan dan siap digunakan.

Untuk informasi selengkapnya tentang jenis data ObjectLambdaAccessPointAlias di API REST, lihat CreateAccessPointForObjectLambdadan ObjectLambdaAccessPointAlias dalam Referensi API Amazon Simple Storage Service.

Cara untuk menggunakan alias Titik Akses Lambda Objek alias

Anda dapat menggunakan alias Titik Akses Lambda Objek, bukan nama bucket Amazon S3 untuk operasi yang tercantum di dalam Kompatibilitas titik akses dengan AWS layanan.

AWS CLI Contoh berikut untuk get-bucket-location perintah menggunakan alias access point bucket untuk mengembalikan tempat Wilayah AWS bucket berada. Untuk menjalankan perintah ini, ganti user input placeholders dengan informasi Anda sendiri.

aws s3api get-bucket-location --bucket my-object-lambda-acc-w7i37nq6xuzgax3jw3oqtifiusw2a--ol-s3 { "LocationConstraint": "us-west-2" }

Jika alias Titik Akses Lambda Object dalam permintaannya tidak valid, kode kesalahan InvalidAccessPointAliasError dikembalikan. Untuk informasi selengkapnya tentang InvalidAccessPointAliasError, lihat Daftar Kode Kesalahan dalam Referensi API Amazon Simple Storage Service.

Keterbatasan alias Titik Akses Lambda Objek sama dengan alias titik akses. Untuk informasi lebih lanjut tentang batasan alias titik akses, lihat Batasan.