Perubahan yang biasanya menyebabkan penerapan biru/hijau Perubahan yang biasanya tidak menyebabkan penerapan biru/hijau Menentukan apakah perubahan akan menyebabkan penyebaran biru/hijau Memulai dan melacak perubahan konfigurasi Tahapan perubahan konfigurasi Dampak kinerja penerapan biru/hijau Biaya untuk perubahan konfigurasi Memecahkan masalah kesalahan validasi

Membuat perubahan konfigurasi di Amazon OpenSearch Service

Amazon OpenSearch Service menggunakan proses penyebaran biru/hijau saat memperbarui domain. Penerapan biru/hijau menciptakan lingkungan idle untuk pembaruan domain yang menyalin lingkungan produksi, dan mengarahkan pengguna ke lingkungan baru setelah pembaruan tersebut selesai. Dalam deployment blue/green, lingkungan biru adalah lingkungan produksi saat ini. Lingkungan hijau adalah lingkungan yang menganggur.

Data dimigrasikan dari lingkungan biru ke lingkungan hijau. Ketika lingkungan baru siap, OpenSearch Layanan beralih ke lingkungan untuk mempromosikan lingkungan hijau menjadi lingkungan produksi baru. Peralihan terjadi tanpa kehilangan data. Praktik ini meminimalkan waktu henti dan mempertahankan lingkungan asli jika penerapan ke lingkungan baru tidak berhasil.

Topik

Perubahan yang biasanya menyebabkan penerapan biru/hijau
Perubahan yang biasanya tidak menyebabkan penerapan biru/hijau
Menentukan apakah perubahan akan menyebabkan penyebaran biru/hijau
Memulai dan melacak perubahan konfigurasi
Tahapan perubahan konfigurasi
Dampak kinerja penerapan biru/hijau
Biaya untuk perubahan konfigurasi
Memecahkan masalah kesalahan validasi

Perubahan yang biasanya menyebabkan penerapan biru/hijau

Operasi berikut menyebabkan deployment biru/hijau:

Mengubah jenis instans
Mengaktifkan kontrol akses detail
Melakukan pembaruan perangkat lunak layanan
Mengaktifkan atau menonaktifkan simpul utama khusus
Mengaktifkan atau menonaktifkan Multi-AZ tanpa Siaga
Mengubah jenis penyimpanan, tipe volume, atau ukuran volume
Memilih VPC subnet yang berbeda
Menambahkan atau menghapus grup VPC keamanan
Mengaktifkan atau menonaktifkan otentikasi Amazon Cognito untuk Dasbor OpenSearch
Memilih kolam pengguna atau kolam identitas Amazon Cognito yang berbeda
Mengubah pengaturan lanjutan
Memutakhirkan ke OpenSearch versi baru (OpenSearch Dasbor mungkin tidak tersedia selama beberapa atau semua peningkatan)
Mengaktifkan enkripsi data saat istirahat atau node-to-node enkripsi
Mengaktifkan atau menonaktifkan UltraWarm atau penyimpanan dingin
Menonaktifkan Auto-Tune dan memutar kembali perubahannya
Mengaitkan plugin opsional ke domain dan memisahkan plugin opsional dari domain
Meningkatkan jumlah node master khusus untuk domain Multi-AZ dengan dua node master khusus
Mengurangi ukuran volume EBS
Mengubah ukuran EBS volumeIOPS,, atau throughput, jika perubahan terakhir yang Anda buat sedang berlangsung atau terjadi kurang dari 6 jam yang lalu
Mengaktifkan publikasi log audit ke CloudWatch.

Untuk Multi-AZ dengan domain Siaga, Anda hanya dapat membuat satu permintaan perubahan pada satu waktu. Jika perubahan sudah berlangsung, permintaan baru ditolak. Anda dapat memeriksa status perubahan saat ini dengan file DescribeDomainChangeProgressAPI.

Perubahan yang biasanya tidak menyebabkan penerapan biru/hijau

Dalam banyak kasus, operasi berikut tidak menyebabkan deployment biru/hijau:

Memodifikasi kebijakan akses
Memodifikasi titik akhir kustom
Mengubah kebijakan Transport Layer Security (TLS)
Mengubah jam snapshot otomatis
Mengaktifkan atau menonaktifkan Required HTTPS
Mengaktifkan Auto-Tune atau menonaktifkannya tanpa memutar kembali perubahannya
Jika domain Anda memiliki node master khusus, mengubah node data atau jumlah UltraWarm node
Jika domain Anda memiliki node master khusus, ubah jenis atau hitungan instans master khusus (kecuali untuk domain multi-AZ dengan dua node master khusus)
Mengaktifkan atau menonaktifkan publikasi log kesalahan atau memperlambat log ke CloudWatch
Menonaktifkan publikasi log audit ke CloudWatch
Meningkatkan ukuran volume hingga 3 TiB per node data, mengubah jenis volumeIOPS, atau throughput
Menambahkan atau menghapus tag

catatan

Ada beberapa pengecualian tergantung pada versi perangkat lunak layanan Anda. Jika Anda ingin memastikan bahwa perubahan tidak akan menyebabkan penyebaran biru/hijau, lakukan dry run sebelum memperbarui domain Anda, jika opsi ini tersedia. Beberapa perubahan tidak menawarkan opsi dry run. Kami biasanya menyarankan agar Anda membuat perubahan pada cluster Anda di luar jam lalu lintas puncak.

Menentukan apakah perubahan akan menyebabkan penyebaran biru/hijau

Anda dapat menguji beberapa jenis perubahan konfigurasi yang direncanakan untuk menentukan apakah perubahan tersebut akan menyebabkan penerapan biru/hijau, tanpa harus berkomitmen pada perubahan tersebut. Sebelum Anda memulai perubahan konfigurasi, gunakan konsol atau API untuk menjalankan pemeriksaan validasi untuk memastikan bahwa domain Anda memenuhi syarat untuk pembaruan.

Console

Untuk memvalidasi perubahan konfigurasi

Arahkan ke konsol OpenSearch Layanan Amazon dihttps://console.aws.amazon.com/aos/.
Di panel navigasi kiri, pilih Domain.
Pilih domain yang ingin Anda ubah konfigurasi. Ini membuka halaman detail domain. Pilih menu tarik-turun Tindakan dan kemudian pilih Edit konfigurasi cluster.
Pada halaman konfigurasi cluster Edit, Anda dapat membuat perubahan pada jenis instans, jumlah node, dan konfigurasi lainnya. Setelah mengonfirmasi perubahan di panel ringkasan, pilih Jalankan.
Setelah dry run Anda selesai, hasilnya secara otomatis ditampilkan di bagian bawah halaman, bersama dengan ID dry run. Hasil ini memberi tahu Anda kategori mana yang termasuk dalam perubahan Anda:
- Memulai penerapan biru/hijau
- Tidak memerlukan penerapan biru/hijau
- Berisi kesalahan validasi yang perlu Anda atasi sebelum Anda dapat menyimpan perubahan Anda
Perhatikan bahwa setiap dry run menimpa yang sebelumnya. Untuk mencari detail setiap dry run nanti, pastikan Anda menyimpan ID dry run Anda. Setiap dry run tersedia selama 90 hari, atau sampai Anda membuat pembaruan konfigurasi.
Untuk melanjutkan pembaruan konfigurasi Anda, pilih Simpan perubahan. Jika tidak, pilih Batalkan. Opsi mana pun membawa Anda kembali ke tab konfigurasi Cluster. Pada tab ini, Anda dapat memilih Detail Dry run untuk melihat detail dry run terbaru Anda. Halaman ini juga mencakup side-by-side perbandingan antara konfigurasi sebelum dry run dan konfigurasi dry run.

API

Anda dapat melakukan validasi dry run melalui konfigurasiAPI. Untuk menguji perubahan Anda denganAPI, atur DryRun ketrue, dan DryRunMode keVerbose. Mode verbose menjalankan pemeriksaan validasi selain menentukan apakah perubahan akan memulai penerapan biru/hijau. Misalnya, UpdateDomainConfigpermintaan ini menguji jenis penerapan yang dihasilkan dari pengaktifan UltraWarm:


POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/my-domain/config
{
   "ClusterConfig": {
    "WarmCount": 3,
    "WarmEnabled": true,
    "WarmType": "ultrawarm1.large.search"
   },
   "DryRun": true,
   "DryRunMode": "Verbose"
}

Permintaan menjalankan pemeriksaan validasi dan mengembalikan jenis penerapan yang akan menyebabkan perubahan tetapi tidak benar-benar melakukan pembaruan:


{
   "ClusterConfig": {
     ...
    },
   "DryRunResults": {
      "DeploymentType": "Blue/Green",
      "Message": "This change will require a blue/green deployment."
    }
}

Jenis penerapan yang mungkin adalah:

Blue/Green— Perubahan akan menyebabkan penyebaran biru/hijau.
DynamicUpdate— Perubahan tidak akan menyebabkan penyebaran biru/hijau.
Undetermined— Domain masih dalam status pemrosesan, sehingga jenis penerapan tidak dapat ditentukan.
None- Tidak ada perubahan konfigurasi.

Jika validasi gagal, ia mengembalikan daftar kegagalan validasi.


{
   "ClusterConfig":{
      "..."
   },
   "DryRunProgressStatus":{
      "CreationDate":"2023-01-12T01:14:33.847Z",
      "DryRunId":"db00ca39-48b2-4774-bbd3-252cf094d205",
      "DryRunStatus":"failed",
      "UpdateDate":"2023-01-12T01:14:33.847Z",
      "ValidationFailures":[
         {
            "Code":"Cluster.Index.WriteBlock",
            "Message":"Cluster has index write blocks."
         }
      ]
   }
}

Jika statusnya diampending, Anda dapat menggunakan ID dry run dalam UpdateDomainConfig respons Anda dalam DescribeDryRunProgresspanggilan berikutnya untuk memeriksa status validasi.


GET https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/my-domain/dryRun?dryRunId=my-dry-run-id
{
    "DryRunConfig": null,
    "DryRunProgressStatus": {
        "CreationDate": "2023-01-12T01:14:42.998Z",
        "DryRunId": "db00ca39-48b2-4774-bbd3-252cf094d205",
        "DryRunStatus": "succeeded",
        "UpdateDate": "2023-01-12T01:14:49.334Z",
        "ValidationFailures": null
    },
    "DryRunResults": {
        "DeploymentType": "Blue/Green",
        "Message": "This change will require a blue/green deployment."
    }
}

Untuk menjalankan analisis dry run tanpa pemeriksaan validasi, setel DryRunMode ke Basic saat Anda menggunakan konfigurasiAPI.

Python

Kode Python berikut menggunakan UpdateDomainConfigAPIuntuk melakukan pemeriksaan validasi dry run dan, jika pemeriksaan berhasil, memanggil hal yang sama API tanpa dry run untuk memulai pembaruan. Jika pemeriksaan gagal, skrip mencetak kesalahan dan berhenti.


import time
import boto3

client = boto3.client('opensearch')

response = client.UpdateDomainConfig(
    ClusterConfig={
        'WarmCount': 3,
        'WarmEnabled': True,
        'WarmCount': 123,
    },
    DomainName='test-domain',
    DryRun=True,
    DryRunMode='Verbose'
)

dry_run_id = response.DryRunProgressStatus.DryRunId

retry_count = 0

while True:

    if retry_count == 5:
        print('An error occured')
        break

    dry_run_progress_response = client.DescribeDryRunProgress('test-domain', dry_run_id)
    dry_run_status = dry_run_progress_response.DryRunProgressStatus.DryRunStatus

    if dry_run_status == 'succeeded':
        client.UpdateDomainConfig(
            ClusterConfig={
            'WarmCount': 3,
            'WarmEnabled': True,
            'WarmCount': 123,
        })
        break

    elif dry_run_status == 'failed':
        validation_failures_list = dry_run_progress_response.DryRunProgressStatus.ValidationFailures
        for item in validation_failures_list:
            print(f"Code: {item['Code']}, Message: {item['Message']}")
        break

    retry_count += 1
    time.sleep(30)

Memulai dan melacak perubahan konfigurasi

catatan

Anda dapat meminta satu perubahan konfigurasi pada satu waktu. Anda juga dapat mengelompokkan beberapa perubahan konfigurasi dalam satu permintaan. Tunggu status domain Anda menjadi Active sebelum meminta perubahan konfigurasi tambahan.

Anda dapat melihat bidang Status Pemrosesan Domain dan Ubah Status Konfigurasi di konsol OpenSearch Layanan Amazon untuk melacak perubahan domain dan konfigurasi. Anda juga dapat melacak perubahan domain dan konfigurasi melalui ConfigChangeStatus parameter DomainProcessingStatus dan dalam API tanggapan. Untuk informasi selengkapnya, lihat tipe DomainStatusdata dalam API referensi OpenSearch Layanan.

Visibilitas status pemrosesan domain: Anda dapat dengan mudah menentukan status konfigurasi domain dengan melihat bidang Status Pemrosesan Domain di konsol. Demikian pula, DomainProcessingStatus API parameter dapat digunakan untuk mengidentifikasi status. Nilai-nilai berikut memproses status untuk domain:

Active: Tidak ada perubahan konfigurasi yang sedang berlangsung. Anda dapat mengirimkan permintaan perubahan konfigurasi baru.
Creating: Domain sedang dibuat.
Modifying: Perubahan konfigurasi, seperti penambahan node data baru,EBS, gp3, IOPS penyediaan, atau pengaturan KMS kunci, sedang berlangsung.

catatan
Anda mungkin melihat status seperti Modifying dalam situasi di mana domain memerlukan gerakan pecahan untuk menyelesaikan perubahan konfigurasi. Untuk kompatibilitas mundur, perilaku Processing parameter tetap tidak berubah dalam API respons, dan disetel ke false segera setelah perubahan konfigurasi inti selesai, tanpa menunggu penyelesaian gerakan pecahan.
Upgrading Engine Version: Upgrade versi mesin sedang berlangsung.
Updating Service Software: Pembaruan perangkat lunak layanan sedang berlangsung.
Deleting: Domain sedang dihapus.
Isolated: Domain ditangguhkan.

Visibilitas status konfigurasi: Perubahan konfigurasi dapat dimulai oleh operator (misalnya penambahan node data baru, perubahan tipe instance) atau oleh layanan (misalnya Auto-Tune dan pembaruan off-peak hour). Anda dapat menemukan status detail perubahan konfigurasi terbaru di bidang Status Perubahan Konfigurasi pada konsol OpenSearch Layanan Amazon, dan dalam ConfigChangeStatus API respons. Nilai berikut menunjukkan status konfigurasi domain:

Pending: Permintaan perubahan konfigurasi telah dikirimkan.
Initializing: Layanan menginisialisasi permintaan perubahan konfigurasi.
Validating: Layanan memvalidasi perubahan yang diminta dan sumber daya yang diperlukan.
Awaiting user inputs: Berlaku ketika operator mengharapkan beberapa perubahan konfigurasi seperti perubahan jenis instance untuk melanjutkan lebih jauh. Anda dapat mengedit perubahan konfigurasi.
Applying changes: Layanan menerapkan perubahan konfigurasi yang diminta.
Cancelled: Perubahan konfigurasi dibatalkan. Jika Anda menerima status gagal validasi, Anda dapat mengklik Batal di konsol atau memanggil CancelDomainConfigChange API operasi. Jika Anda melakukan ini, semua perubahan yang diterapkan digulung kembali.
Completed: Perubahan konfigurasi yang diminta telah selesai dengan sukses.
Validation Failed: Perubahan yang diminta gagal validasi. Tidak ada perubahan konfigurasi yang diterapkan.

catatan
Kegagalan validasi dapat disebabkan oleh indeks merah yang ada di domain Anda, tidak tersedianya jenis instans yang dipilih, atau ruang disk yang rendah. Untuk daftar kesalahan validasi, lihatMemecahkan masalah kesalahan validasi. Selama peristiwa kegagalan validasi, Anda dapat membatalkan, mencoba lagi, atau mengedit perubahan konfigurasi.

APIRingkasan: Anda dapat menggunakanDescribeDomain,DescribeDomainChangeProgress, dan DescribeDomainConfig API operasi untuk mendapatkan status pembaruan konfigurasi terperinci. Selain itu, Anda dapat menggunakan CancelDomainConfigChange untuk membatalkan pembaruan jika terjadi kegagalan validasi. Untuk informasi selengkapnya, lihat APIdokumentasi OpenSearch Layanan

Ketika perubahan konfigurasi selesai, status domain berubah kembali keActive.

Anda dapat meninjau kesehatan klaster dan CloudWatch metrik Amazon dan melihat bahwa jumlah node di cluster untuk sementara meningkat—seringkali berlipat ganda—saat pembaruan domain terjadi. Dalam ilustrasi berikut, Anda dapat melihat jumlah node berlipat ganda dari 11 menjadi 22 selama perubahan konfigurasi dan kembali ke 11 saat pembaruan selesai.

Jumlah simpul berlipat ganda dari 11 menjadi 22 selama perubahan konfigurasi domain.

Peningkatan sementara ini dapat membebani simpul utama khusus klaster, yang tiba-tiba mungkin memiliki lebih banyak simpul untuk dikelola. Ini juga dapat meningkatkan latensi pencarian dan pengindeksan karena OpenSearch Layanan menyalin data dari cluster lama ke yang baru. Penting untuk mempertahankan kapasitas yang cukup di cluster untuk menangani overhead yang terkait dengan penerapan biru/hijau ini.

penting

Anda tidak dikenakan biaya tambahan selama perubahan konfigurasi dan pemeliharaan layanan. Anda ditagih hanya untuk jumlah node yang Anda minta untuk klaster Anda. Untuk spesifik, lihat Biaya untuk perubahan konfigurasi.

Untuk mencegah kelebihan beban node master khusus, Anda dapat memantau penggunaan dengan CloudWatch metrik Amazon. Untuk nilai maksimum yang disarankan, lihat CloudWatch Alarm yang disarankan untuk Layanan Amazon OpenSearch .

Tahapan perubahan konfigurasi

Setelah Anda memulai perubahan konfigurasi, OpenSearch Layanan akan melalui serangkaian langkah untuk memperbarui domain Anda. Anda dapat melihat kemajuan perubahan konfigurasi di bawah Status perubahan konfigurasi di konsol. Langkah-langkah tepat yang dilalui pembaruan tergantung pada jenis perubahan yang Anda buat. Anda juga dapat memantau perubahan konfigurasi menggunakan DescribeDomainChangeProgressAPIoperasi.

Berikut ini adalah tahapan yang mungkin dilakukan pembaruan selama perubahan konfigurasi:

Nama panggung	Deskripsi
Validasi	Memvalidasi bahwa domain memenuhi syarat untuk pembaruan, dan memunculkan masalah validasi jika perlu.
Menciptakan lingkungan baru	Menyelesaikan prasyarat yang diperlukan dan membuat sumber daya yang diperlukan untuk memulai penerapan biru/hijau.
Penyediaan node baru	Membuat serangkaian instance baru di lingkungan baru.
Perutean lalu lintas pada node baru	Mengarahkan lalu lintas ke node data yang baru dibuat.
Perutean lalu lintas pada node lama	Menonaktifkan lalu lintas pada node data lama.
Mempersiapkan node untuk dihapus	Bersiap untuk menghapus node. Langkah ini hanya terjadi ketika Anda menurunkan skala domain Anda (misalnya, dari 8 node menjadi 6 node).
Menyalin pecahan ke node baru	Memindahkan pecahan dari node lama ke node baru.
Mengakhiri node	Mengakhiri dan menghapus node lama setelah pecahan dihapus.
Menghapus sumber daya yang lebih lama	Menghapus sumber daya yang terkait dengan lingkungan lama (misalnya penyeimbang beban).
Pembaruan dinamis	Ditampilkan ketika pembaruan tidak memerlukan penerapan biru/hijau dan dapat diterapkan secara dinamis.
Menerapkan perubahan terkait master khusus	Ditampilkan ketika jenis atau jumlah instans master khusus diubah.
Menerapkan perubahan terkait volume	Ditampilkan saat ukuran volume, jenis, IOPS dan throughput diubah.

Dampak kinerja penerapan biru/hijau

Selama penerapan biru/hijau, kluster OpenSearch Layanan Amazon Anda tersedia untuk permintaan pencarian dan pengindeksan yang masuk. Namun, Anda mungkin mengalami masalah kinerja berikut:

Peningkatan sementara penggunaan pada node pemimpin karena cluster memiliki lebih banyak node untuk dikelola.
Peningkatan latensi pencarian dan pengindeksan saat OpenSearch Layanan menyalin data dari node lama ke node baru.
Peningkatan penolakan untuk permintaan masuk saat beban cluster meningkat selama penerapan biru/hijau.
Untuk menghindari masalah latensi dan penolakan permintaan, Anda harus menjalankan penerapan biru/hijau saat cluster sehat dan lalu lintas jaringan rendah.

Biaya untuk perubahan konfigurasi

Jika Anda mengubah konfigurasi untuk domain, OpenSearch Service akan membuat klaster baru seperti yang dijelaskan dalamMembuat perubahan konfigurasi di Amazon OpenSearch Service. Selama migrasi dari lama ke baru, Anda dikenakan biaya berikut:

Jika Anda mengubah tipe instans, Anda akan dikenakan biaya untuk kedua klaster selama satu jam pertama. Setelah satu jam pertama, Anda hanya dikenakan biaya untuk klaster baru. EBSvolume tidak dikenakan biaya dua kali karena merupakan bagian dari klaster Anda, jadi penagihan mereka mengikuti penagihan instans.

Contoh: Anda mengubah konfigurasi dari tiga instans m3.xlarge ke empat instans m4.large. Untuk jam pertama, Anda dikenakan biaya untuk kedua cluster (3 * m3.xlarge + 4 *m4.large). Setelah satu jam pertama, Anda hanya dikenakan biaya untuk cluster baru (4*m4.large).
Jika Anda tidak mengubah jenis instans, Anda hanya dikenakan biaya untuk klaster terbesar selama satu jam pertama. Setelah satu jam pertama, Anda hanya dikenakan biaya untuk cluster baru.

Contoh: Anda mengubah konfigurasi dari tiga enam instans m3.xlarge ke tiga instans m3.xlarge. Untuk jam pertama, Anda dikenakan biaya untuk cluster terbesar (6*m3.xlarge). Setelah satu jam pertama, Anda hanya dikenakan biaya untuk cluster baru (3*m3.xlarge).

Memecahkan masalah kesalahan validasi

Saat Anda memulai perubahan konfigurasi atau melakukan pemutakhiran versi OpenSearch atau Elasticsearch, OpenSearch Layanan terlebih dahulu melakukan serangkaian pemeriksaan validasi untuk memastikan bahwa domain Anda memenuhi syarat untuk pembaruan. Jika salah satu pemeriksaan ini gagal, Anda menerima pemberitahuan di konsol yang berisi masalah spesifik yang harus Anda perbaiki sebelum memperbarui domain Anda. Tabel berikut mencantumkan kemungkinan masalah domain yang mungkin muncul oleh OpenSearch Layanan, dan langkah-langkah untuk mengatasinya.

Isu	Kode kesalahan	Langkah pemecahan masalah
Grup keamanan tidak ditemukan	`SecurityGroupNotFound`	Grup keamanan yang terkait dengan domain OpenSearch Layanan Anda tidak ada. Untuk mengatasi masalah ini, buat grup keamanan dengan nama yang ditentukan.
Subnet tidak ditemukan	`SubnetNotFound`	Subnet yang terkait dengan domain OpenSearch Layanan Anda tidak ada. Untuk mengatasi masalah ini, buat subnet di file AndaVPC.
Peran terkait layanan tidak dikonfigurasi	`SLRNotConfigured`	Peran terkait layanan untuk OpenSearch Layanan tidak dikonfigurasi. Peran terkait layanan telah ditentukan sebelumnya oleh OpenSearch Layanan dan mencakup semua izin yang diperlukan layanan untuk memanggil lainnya AWS layanan atas nama Anda. Jika peran tidak ada, Anda mungkin perlu membuatnya secara manual.
Alamat IP tidak cukup	`InsufficientFreeIPsForSubnets`	Satu atau lebih VPC subnet Anda tidak memiliki cukup alamat IP untuk memperbarui domain Anda. Untuk menghitung berapa banyak alamat IP yang Anda butuhkan, lihatReservasi alamat IP di subnet VPC.
Kumpulan pengguna Cognito tidak ada	`CognitoUserPoolNotFound`	OpenSearch Layanan tidak dapat menemukan kumpulan pengguna Amazon Cognito. Konfirmasi bahwa Anda membuat satu dan memiliki ID yang benar. Untuk menemukan ID, Anda dapat menggunakan konsol Amazon Cognito atau yang berikut ini AWS CLI perintah: `aws cognito-idp list-user-pools --max-results 60 --region us-east-1`
Kumpulan identitas Cognito tidak ada	`CognitoIdentityPoolNotFound`	OpenSearch Layanan tidak dapat menemukan kumpulan identitas Cognito. Konfirmasi bahwa Anda membuat satu dan memiliki ID yang benar. Untuk menemukan ID, Anda dapat menggunakan konsol Amazon Cognito atau yang berikut ini AWS CLI perintah: `aws cognito-identity list-identity-pools --max-results 60 --region us-east-1`
Domain Cognito tidak ditemukan untuk kumpulan pengguna	`CognitoDomainNotFound`	Kolam pengguna tidak memiliki nama domain. Anda dapat mengonfigurasinya menggunakan konsol Amazon Cognito atau yang berikut ini AWS CLI perintah: `aws cognito-idp create-user-pool-domain --domain my-domain --user-pool-id id`
Peran Cognito tidak dikonfigurasi	`CognitoRoleNotConfigured`	IAMPeran yang memberikan izin OpenSearch Layanan untuk mengonfigurasi pengguna Amazon Cognito dan kumpulan identitas, dan menggunakannya untuk autentikasi, tidak dikonfigurasi. Konfigurasikan peran dengan set izin dan hubungan kepercayaan yang sesuai. Anda dapat menggunakan konsol, yang membuat CognitoAccessForAmazonOpenSearchperan default untuk Anda, atau Anda dapat mengonfigurasi peran secara manual menggunakan AWS CLI atau AWS SDK.
Tidak dapat mendeskripsikan kumpulan pengguna	`UserPoolNotDescribable`	Peran Amazon Cognito yang ditentukan tidak memiliki izin untuk menjelaskan kumpulan pengguna yang terkait dengan domain Anda. Pastikan kebijakan izin peran memungkinkan `cognito-identity:DescribeUserPool` tindakan. Lihat Tentang peran CognitoAccessForAmazonOpenSearch kebijakan izin lengkap.
Tidak dapat mendeskripsikan kumpulan identitas	`IdentityPoolNotDescribable`	Peran Amazon Cognito yang ditentukan tidak memiliki izin untuk menjelaskan kumpulan identitas yang terkait dengan domain Anda. Pastikan kebijakan izin peran memungkinkan `cognito-identity:DescribeIdentityPool` tindakan. Lihat Tentang peran CognitoAccessForAmazonOpenSearch kebijakan izin lengkap.
Tidak dapat mendeskripsikan pengguna dan kumpulan identitas	`CognitoPoolsNotDescribable`	Peran Amazon Cognito yang ditentukan tidak memiliki izin untuk mendeskripsikan kumpulan pengguna dan identitas yang terkait dengan domain Anda. Pastikan kebijakan izin peran memungkinkan `cognito-identity:DescribeIdentityPool` dan `cognito-identity:DescribeUserPool` tindakan. Lihat Tentang peran CognitoAccessForAmazonOpenSearch kebijakan izin lengkap.
KMSkunci tidak diaktifkan	`KMSKeyNotEnabled`	Bagian AWS Key Management Service (AWS KMS) kunci yang digunakan untuk mengenkripsi domain Anda dinonaktifkan. Aktifkan kembali kunci segera.
Sertifikat kustom tidak dalam ISSUED negara	`InvalidCertificate`	Jika domain Anda menggunakan titik akhir kustom, Anda mengamankannya dengan membuat SSL sertifikat di AWS Certificate Manager (ACM) atau mengimpor salah satu dari Anda sendiri. Status sertifikat harus Diterbitkan. Jika Anda menerima kesalahan ini, periksa status sertifikat Anda di ACM konsol. Jika status validasi Kedaluwarsa, Gagal, Tidak Aktif, atau Tertunda, lihat dokumentasi ACM pemecahan masalah untuk menyelesaikan masalah.
Tidak cukup kapasitas untuk meluncurkan jenis instans yang dipilih	`InsufficientInstanceCapacity`	Kapasitas tipe instans yang diminta tidak tersedia. Misalnya, Anda mungkin telah meminta lima `i3.16xlarge.search` node, tetapi OpenSearch Layanan tidak memiliki cukup `i3.16xlarge.search` host yang tersedia, sehingga permintaan tidak dapat dipenuhi. Periksa jenis instans yang didukung di OpenSearch Layanan dan pilih jenis instans yang berbeda.
Indeks merah dalam cluster	`RedCluster`	Satu atau lebih indeks di cluster Anda memiliki status merah, yang mengarah ke status cluster merah secara keseluruhan. Untuk memecahkan masalah dan memperbaiki masalah ini, lihat. Status klaster merah
Pemutus sirkuit memori, terlalu banyak permintaan	`TooManyRequests`	Ada terlalu banyak permintaan pencarian dan penulisan ke domain Anda, sehingga OpenSearch Layanan tidak dapat memperbarui konfigurasinya. Anda dapat mengurangi jumlah permintaan, menskalakan instance secara vertikal hingga 64 GiBRAM, atau menskalakan secara horizontal dengan menambahkan instance.
Konfigurasi baru tidak dapat menyimpan data (ruang disk rendah)	`InsufficientStorageCapacity`	Ukuran penyimpanan yang dikonfigurasi tidak dapat menampung semua data di domain Anda. Untuk mengatasi masalah ini, pilih volume yang lebih besar, hapus indeks yang tidak digunakan, atau tingkatkan jumlah node di cluster untuk segera membebaskan ruang disk.
Pecahan disematkan ke node tertentu	`ShardMovementBlocked`	Satu atau beberapa indeks di domain Anda dilampirkan ke node tertentu dan tidak dapat dipindahkan. Ini kemungkinan besar terjadi karena Anda mengonfigurasi pemfilteran alokasi pecahan, yang memungkinkan Anda menentukan node mana yang diizinkan untuk meng-host pecahan indeks tertentu. Untuk mengatasi masalah ini, hapus filter alokasi pecahan dari semua indeks yang terpengaruh: `PUT my-index/_settings { "settings": { "index.routing.allocation.require._name": null } }`
Konfigurasi baru tidak dapat menampung semua pecahan (jumlah pecahan)	`TooManyShards`	Jumlah pecahan pada domain Anda terlalu tinggi, yang mencegah OpenSearch Service memindahkannya ke konfigurasi baru. Untuk mengatasi masalah ini, skala domain Anda secara horizontal dengan menambahkan node dari jenis konfigurasi yang sama dengan node cluster Anda saat ini. Perhatikan bahwa ukuran EBS volume maksimum tergantung pada jenis instance node. Untuk mencegah masalah ini di masa mendatang, lihat Memilih jumlah serpihan dan tentukan strategi sharding yang sesuai untuk kasus penggunaan Anda.
Subnet yang terkait dengan domain Anda tidak mendukung alamat IPv4	`ResultCodeIPv4BlockNotExists`	Untuk mengatasi masalah ini, buat subnet atau perbarui subnet yang ada di Anda VPC sesuai dengan jenis alamat IP domain yang dikonfigurasi. Jika domain Anda menggunakan IPv4satu-satunya jenis alamat, gunakan subnet IPv4 -only. Jika domain Anda menggunakan mode Dual-stack, gunakan subnet dual-stack.
Subnet yang terkait dengan domain Anda tidak mendukung alamat IPv6	`ResultCodeIPv6BlockNotExists`	Untuk mengatasi masalah ini, buat subnet atau perbarui subnet yang ada di Anda VPC sesuai dengan jenis alamat IP domain yang dikonfigurasi. Jika domain Anda menggunakan IPv4satu-satunya jenis alamat, gunakan subnet IPv4 -only. Jika domain Anda menggunakan mode Dual-stack, gunakan subnet dual-stack.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Membuat dan mengelola domain

Pembaruan perangkat lunak layanan