View a markdown version of this page

Titik akhir pengumpulan untuk Amazon Tanpa Server OpenSearch - OpenSearch Layanan Amazon

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Titik akhir pengumpulan untuk Amazon Tanpa Server OpenSearch

Amazon OpenSearch Serverless NextGen menyediakan titik akhir berbasis sumber daya pada domain. on.aws Anda dapat menggunakan titik akhir per koleksi untuk mengakses satu koleksi, atau titik akhir per akun untuk mengakses setiap koleksi di Wilayah Anda Akun AWS melalui satu nama host. Kedua titik akhir bekerja di atas standar AWS PrivateLink — buat titik akhir VPC dari konsol VPC Amazon atau dengan Amazon EC2 API. CreateVpcEndpoint

OpenSearch Serverless Classic menggunakan titik akhir per koleksi pada. aoss.amazonaws.com

Jenis titik akhir

OpenSearch Tanpa server mendukung format titik akhir koleksi berikut.

OpenSearch Format titik akhir koleksi tanpa server
Tipe titik akhir Format Deskripsi
Per-collection (NextGen) collection-id.aoss.region.on.aws

Mengidentifikasi koleksi dari nama host. Satu titik akhir per koleksi.

Per-account (NextGen) account-id.aoss.region.on.aws

Mengidentifikasi koleksi dari header permintaan. Satu titik akhir melayani setiap koleksi di Wilayah Anda Akun AWS .

Per-collection (Klasik) collection-id.region.aoss.amazonaws.com

Mengidentifikasi koleksi dari nama host. Satu titik akhir per koleksi Klasik.

Kedua format NextGen endpoint menggunakan standar AWS PrivateLink untuk akses VPC. Untuk informasi selengkapnya tentang membuat titik akhir VPC, lihat. Akses pesawat data melalui AWS PrivateLink

Dalam mendukung FIPS Region AWS itu, OpenSearch Serverless juga menawarkan FIPS-compliant varian titik akhir ini. Lihat perinciannya di Menggunakan titik akhir FIPS dengan Tanpa Server OpenSearch.

Per-collection titik akhir

Titik akhir per koleksi menargetkan koleksi tunggal melalui nama host yang menyertakan ID koleksi. Titik akhir ditampilkan di halaman detail koleksi di konsol OpenSearch Tanpa Server, dan dikembalikan oleh BatchGetCollectionAPI di bidang. collectionEndpoint

Format
  • NextGen: collection-id.aoss.region.on.aws

  • Klasik: collection-id.region.aoss.amazonaws.com

Permintaan berikut mengindeks dokumen ke dalam movies indeks koleksi 1tg2xudton46knx2a95g dius-east-1:

PUT https://1tg2xudton46knx2a95g.aoss.us-east-1.on.aws/movies/_doc/1 { "title": "Shawshank Redemption", "year": 1994 }

Per-account titik akhir

Titik akhir per akun menargetkan setiap koleksi di Wilayah Anda Akun AWS melalui satu nama host. Karena nama host sama untuk semua koleksi, Anda mengidentifikasi koleksi target pada setiap permintaan melalui salah satu header HTTP ini (setidaknya satu diperlukan; jika Anda menyertakan keduanya, mereka harus merujuk ke koleksi yang sama):

  • x-amz-aoss-collection-name— nama koleksi yang ditetapkan pelanggan

  • x-amz-aoss-collection-id— ID koleksi yang dihasilkan layanan

Titik akhir per akun memungkinkan satu klien untuk berbagi satu kumpulan koneksi di banyak koleksi dengan mengalihkan koleksi target per permintaan melalui header. Ini berguna untuk aplikasi multi-penyewa yang memodelkan setiap penyewa sebagai koleksi terpisah.

Gunakan x-amz-aoss-collection-name agar aplikasi Anda dapat merutekan permintaan dengan nama yang sudah diketahui. Anda melewatkan penyimpanan atau mencari ID koleksi yang dihasilkan layanan.

Titik akhir per akun tidak ditampilkan di konsol Tanpa Server. OpenSearch Bangun dari Akun AWS ID Anda dan Wilayah.

Format
  • NextGen: account-id.aoss.region.on.aws

Permintaan berikut mengindeks dokumen ke dalam movies indeks koleksi my-collection di akun 123456789012 dius-east-1:

PUT https://123456789012.aoss.us-east-1.on.aws/movies/_doc/1 x-amz-aoss-collection-name: my-collection { "title": "Shawshank Redemption", "year": 1994 }
catatan

x-amz-aoss-collection-idHeader x-amz-aoss-collection-name dan harus. SigV4-signed AWS SDK melakukan ini secara otomatis.