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

Membuat, mencantumkan, dan menghapus koleksi Amazon Tanpa OpenSearch Server

Koleksi di Amazon OpenSearch Tanpa Server adalah pengelompokan logis dari satu atau lebih indeks yang mewakili beban kerja analitik. OpenSearch Layanan secara otomatis mengelola dan menyetel koleksi, membutuhkan input manual minimal.

Izin diperlukan

OpenSearch Tanpa server menggunakan izin berikut AWS Identity and Access Management (IAM) untuk membuat dan mengelola koleksi. Anda dapat menentukan kondisi IAM untuk membatasi pengguna ke koleksi tertentu.

Contoh kebijakan akses berbasis identitas berikut memberikan izin minimum yang diperlukan bagi pengguna untuk mengelola satu koleksi bernama: Logs

[
   {
      "Sid":"Allows managing logs collections",
      "Effect":"Allow",
      "Action":[
         "aoss:CreateCollection",
         "aoss:ListCollections",
         "aoss:BatchGetCollection",
         "aoss:UpdateCollection",
         "aoss:DeleteCollection",
         "aoss:CreateAccessPolicy",
         "aoss:CreateSecurityPolicy"
      ],
      "Resource":"*",
      "Condition":{
         "StringEquals":{
            "aoss:collection":"Logs"
         }
      }
   }
]

aoss:CreateAccessPolicydan aoss:CreateSecurityPolicy disertakan karena kebijakan enkripsi, jaringan, dan akses data diperlukan agar koleksi berfungsi dengan baik. Untuk informasi selengkapnya, lihat Identity and Access Management untuk Amazon Tanpa OpenSearch Server.

Membuat koleksi

Anda dapat menggunakan konsol atau AWS CLI untuk membuat koleksi tanpa server. Langkah-langkah ini mencakup cara membuat koleksi pencarian atau deret waktu. Untuk membuat koleksi pencarian vektor, lihatBekerja dengan koleksi pencarian vektor.

Buat koleksi (konsol)

Status koleksi berubah menjadi Creating saat OpenSearch Tanpa Server membuat koleksi.

Buat koleksi (CLI)

Sebelum membuat koleksi menggunakan AWS CLI, Anda harus memiliki kebijakan enkripsi dengan pola sumber daya yang cocok dengan nama koleksi yang dimaksud. Misalnya, jika Anda berencana memberi nama aplikasi log koleksi, Anda dapat membuat kebijakan enkripsi seperti ini:

aws opensearchserverless create-security-policy \
  --name logs-policy \
  --type encryption --policy "{\"Rules\":[{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AWSOwnedKey\":true}"

Jika Anda berencana untuk menggunakan kebijakan untuk koleksi tambahan, Anda dapat membuat aturan lebih luas, seperti collection/logs* ataucollection/*.

Anda juga perlu mengkonfigurasi pengaturan jaringan untuk koleksi dalam bentuk kebijakan jaringan. Menggunakan contoh aplikasi log sebelumnya, Anda dapat membuat kebijakan jaringan berikut:

aws opensearchserverless create-security-policy \
  --name logs-policy \
  --type network --policy "[{\"Description\":\"Public access for logs collection\",\"Rules\":[{\"ResourceType\":\"dashboard\",\"Resource\":[\"collection\/logs-application\"]},{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AllowFromPublic\":true}]"

Untuk membuat koleksi, kirim CreateCollectionpermintaan:

aws opensearchserverless create-collection --name "logs-application" --type SEARCH --description "A collection for storing log data"

Untuk type, tentukan salah satu, SEARCH atau TIMESERIES. Untuk informasi selengkapnya, lihat Memilih jenis koleksi.

Sampel respon

{
    "createCollectionDetail": {
        "id": "07tjusf2h91cunochc",
        "name": "books",
        "description":"A collection for storing log data",
        "status": "CREATING",
        "type": "SEARCH",
        "kmsKeyArn": "auto",
        "arn": "arn:aws:aoss:us-east-1:123456789012:collection/07tjusf2h91cunochc",
        "createdDate": 1665952577473
    }
}

Jika Anda tidak menentukan jenis koleksi dalam permintaan, defaultnya adalah. TIMESERIES Jika koleksi Anda dienkripsi dengan Kunci milik AWS, itu kmsKeyArn auto bukan ARN.

Mengakses Dasbor OpenSearch

Setelah Anda membuat koleksi dengan AWS Management Console, Anda dapat menavigasi ke URL OpenSearch Dasbor koleksi. Anda dapat menemukan URL Dasbor dengan memilih Koleksi di panel navigasi kiri dan memilih koleksi untuk membuka halaman detailnya. URL mengambil formathttps://dashboards.us-east-1.aoss.amazonaws.com/_login/?collectionId=07tjusf2h91cunochc. Setelah Anda menavigasi ke URL, Anda akan secara otomatis masuk ke Dasbor.

Jika Anda sudah memiliki URL OpenSearch Dasbor yang tersedia tetapi tidak ada AWS Management Console, memanggil URL Dasbor dari browser akan dialihkan ke konsol. Setelah Anda memasukkan AWS kredensil Anda, Anda akan secara otomatis masuk ke Dasbor. Untuk informasi tentang mengakses koleksi untuk SALL, lihat Mengakses OpenSearch Dasbor dengan SALL.

Batas waktu konsol OpenSearch Dasbor adalah satu jam dan tidak dapat dikonfigurasi.

Melihat koleksi

Anda dapat melihat koleksi yang ada Akun AWS di tab Koleksi di konsol OpenSearch Layanan Amazon.

Untuk membuat daftar koleksi beserta ID mereka, kirim ListCollectionspermintaan.

aws opensearchserverless list-collections

Sampel respon

{
   "collectionSummaries":[
      {
         "arn":"arn:aws:aoss:us-east-1:123456789012:collection/07tjusf2h91cunochc",
         "id":"07tjusf2h91cunochc",
         "name":"my-collection",
         "status":"CREATING"
      }
   ]
}

Untuk membatasi hasil pencarian, gunakan filter koleksi. Permintaan ini memfilter respons terhadap koleksi di ACTIVE negara bagian:

aws opensearchserverless list-collections --collection-filters '{ "status": "ACTIVE" }'

Untuk mendapatkan informasi lebih rinci tentang satu atau beberapa koleksi, termasuk OpenSearch titik akhir dan titik akhir OpenSearch Dasbor, kirim permintaan: BatchGetCollection

aws opensearchserverless batch-get-collection --ids ["07tjusf2h91cunochc", "1iu5usc4rame"]

Sampel respon

{
   "collectionDetails":[
      {
         "id": "07tjusf2h91cunochc",
         "name": "my-collection",
         "status": "ACTIVE",
         "type": "SEARCH",
         "description": "",
         "arn": "arn:aws:aoss:us-east-1:123456789012:collection/07tjusf2h91cunochc",
         "kmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab",
         "createdDate": 1667446262828,
         "lastModifiedDate": 1667446300769,
         "collectionEndpoint": "https://07tjusf2h91cunochc.us-east-1.aoss.amazonaws.com",
         "dashboardEndpoint": "https://07tjusf2h91cunochc.us-east-1.aoss.amazonaws.com/_dashboards"
      },
      {
         "id": "178ukvtg3i82dvopdid",
         "name": "another-collection",
         "status": "ACTIVE",
         "type": "TIMESERIES",
         "description": "",
         "arn": "arn:aws:aoss:us-east-1:123456789012:collection/178ukvtg3i82dvopdid",
         "kmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab",
         "createdDate": 1667446262828,
         "lastModifiedDate": 1667446300769,
         "collectionEndpoint": "https://178ukvtg3i82dvopdid.us-east-1.aoss.amazonaws.com",
         "dashboardEndpoint": "https://178ukvtg3i82dvopdid.us-east-1.aoss.amazonaws.com/_dashboards"
      }
   ],
   "collectionErrorDetails":[]
}

Menghapus koleksi

Menghapus koleksi akan menghapus semua data dan indeks dalam koleksi. Anda tidak dapat memulihkan koleksi setelah Anda menghapusnya.

Untuk menghapus koleksi menggunakan AWS CLI, kirim DeleteCollectionpermintaan:

aws opensearchserverless delete-collection --id 07tjusf2h91cunochc

Sampel respon

{
   "deleteCollectionDetail":{
      "id":"07tjusf2h91cunochc",
      "name":"my-collection",
      "status":"DELETING"
   }
}