Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Ganti nama OpenSearch Layanan Amazon - Ringkasan perubahan
Pada 8 September 2021, rangkaian pencarian dan analitik kami diubah namanya menjadi OpenSearch Layanan Amazon. OpenSearch Layanan mendukung OpenSearch serta warisan Elasticsearch OSS. Bagian berikut menjelaskan bagian-bagian berbeda dari layanan yang berubah dengan penggantian nama, dan tindakan apa yang perlu Anda ambil untuk memastikan bahwa domain Anda terus berfungsi dengan baik.
Beberapa perubahan ini hanya berlaku saat Anda memutakhirkan domain dari Elasticsearch ke. OpenSearch Dalam kasus lain, seperti di konsol Billing and Cost Management, pengalaman segera berubah.
Perhatikan bahwa daftar ini tidak lengkap. Sementara bagian lain dari produk juga berubah, pembaruan ini adalah yang paling relevan.
## Versi API baru
Versi baru API konfigurasi OpenSearch Layanan (2021-01-01) berfungsi dengan OpenSearch serta Elasticsearch OSS lama. 21 operasi API diganti dengan nama yang lebih ringkas dan agnostik mesin (misalnya, `CreateElasticsearchDomain` diubah menjadi`CreateDomain`), tetapi OpenSearch Layanan terus mendukung kedua versi API.
Kami menyarankan Anda menggunakan operasi API baru untuk membuat dan mengelola domain di masa mendatang. Perhatikan bahwa ketika Anda menggunakan operasi API baru untuk membuat domain, Anda perlu menentukan `EngineVersion` parameter dalam format `Elasticsearch_X.Y` atau`OpenSearch_X.Y`, bukan hanya nomor versi. Jika Anda tidak menentukan versi, itu default ke versi terbaru. OpenSearch
Tingkatkan AWS CLI ke versi 1.20.40 atau yang lebih baru untuk digunakan `aws opensearch ...` untuk membuat dan mengelola domain Anda. [Untuk format CLI baru, lihat referensi CLIOpenSearch .](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html)
## Jenis instance berganti nama
Jenis instans di Amazon OpenSearch Service sekarang dalam format `..search` —misalnya, `m6g.large.search` bukan`m6g.large.elasticsearch`. Anda tidak perlu mengambil tindakan apa pun. Domain yang ada akan mulai secara otomatis merujuk ke jenis instans baru di dalam API dan di konsol Billing and Cost Management.
Jika Anda memiliki Instans Cadangan (RIs), kontrak Anda tidak akan terpengaruh oleh perubahan tersebut. Versi API konfigurasi lama masih kompatibel dengan format penamaan lama, tetapi jika Anda ingin menggunakan versi API baru, Anda harus menggunakan format baru.
## Perubahan kebijakan akses
Bagian berikut menjelaskan tindakan apa yang perlu Anda ambil untuk memperbarui kebijakan akses Anda.
### Kebijakan IAM
Kami menyarankan Anda memperbarui [kebijakan IAM](ac.md) Anda untuk menggunakan operasi API yang diganti namanya. Namun, OpenSearch Layanan akan terus menghormati kebijakan yang ada dengan mereplikasi izin API lama secara internal. Misalnya, jika saat ini Anda memiliki izin untuk melakukan `CreateElasticsearchDomain` operasi, Anda sekarang dapat melakukan panggilan ke keduanya `CreateElasticsearchDomain` (operasi API lama) dan `CreateDomain` (operasi API baru). Hal yang sama berlaku untuk penyangkalan eksplisit. Untuk daftar operasi API yang diperbarui, lihat [referensi elemen kebijakan](ac.md#ac-reference).
### Kebijakan SCP
[Kebijakan kontrol layanan (SCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html) memperkenalkan lapisan kompleksitas tambahan dibandingkan dengan IAM standar. Untuk mencegah kebijakan SCP Anda melanggar, Anda perlu menambahkan operasi API lama *dan* baru ke setiap kebijakan SCP Anda. Misalnya, jika pengguna saat ini memiliki izin izin`CreateElasticsearchDomain`, Anda juga perlu memberi mereka izin izin `CreateDomain` agar mereka dapat mempertahankan kemampuan untuk membuat domain. Hal yang sama berlaku untuk penyangkalan eksplisit.
Contoh:
```
"Statement": [
{
"Effect": "Allow",
"Action": [
"es:CreateElasticsearchDomain",
"es:CreateDomain"
...
],
},
"Effect": "Deny",
"Action:" [
"es:DeleteElasticsearchDomain",
"es:DeleteDomain"
...
```
## Jenis sumber daya baru
OpenSearch Layanan memperkenalkan jenis sumber daya baru berikut:
| Sumber daya | Deskripsi |
| --- | --- |
| `AWS::OpenSearchService::Domain` | Merupakan domain OpenSearch Layanan Amazon. Sumber daya ini ada di tingkat layanan dan tidak spesifik untuk perangkat lunak yang berjalan di domain. Ini berlaku untuk layanan seperti [CloudFormation](https://aws.amazon.com/cloudformation/)dan [AWS Resource Groups](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html), di mana Anda membuat dan mengelola sumber daya untuk layanan secara keseluruhan.
Untuk petunjuk untuk memutakhirkan domain yang ditentukan dalam CloudFormation dari Elasticsearch ke OpenSearch, lihat [Keterangan di Panduan Pengguna](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opensearchservice-domain.html#aws-resource-opensearchservice-domain--remarks). CloudFormation |
| `AWS::OpenSearch::Domain` | Merupakan OpenSearch/Elasticsearch perangkat lunak yang berjalan pada domain. Sumber daya ini berlaku untuk layanan seperti [AWS CloudTrail](https://aws.amazon.com/documentation/cloudtrail/)dan [AWS Config](https://aws.amazon.com/config/), yang merujuk perangkat lunak yang berjalan pada domain daripada OpenSearch Layanan secara keseluruhan. Layanan ini sekarang berisi tipe sumber daya terpisah untuk domain yang menjalankan Elasticsearch (AWS::Elasticsearch::Domain) versus domain running (). OpenSearch AWS::OpenSearch::Domain |
**catatan**
Di [AWS Config](https://aws.amazon.com/config/), Anda akan terus melihat data Anda di bawah jenis `AWS::Elasticsearch::Domain` sumber daya yang ada selama beberapa minggu, bahkan jika Anda memutakhirkan satu atau beberapa domain ke OpenSearch.
## Kibana berganti nama menjadi Dasbor OpenSearch
[OpenSearch Dasbor](dashboards.md), AWS alternatif untuk Kibana, adalah alat visualisasi sumber terbuka yang dirancang untuk digunakan. OpenSearch Setelah Anda memutakhirkan domain dari Elasticsearch ke OpenSearch, `/_plugin/kibana` titik akhir berubah menjadi. `/_dashboards` OpenSearch Layanan akan mengalihkan semua permintaan ke titik akhir yang baru, tetapi jika Anda menggunakan titik akhir Kibana di salah satu kebijakan IAM Anda, perbarui kebijakan tersebut untuk menyertakan titik akhir yang baru juga. `/_dashboards`
Jika Anda menggunakan[Otentikasi SAMP untuk Dasbor OpenSearch](saml.md), sebelum Anda meningkatkan domain Anda ke OpenSearch, Anda perlu mengubah semua Kibana yang URLs dikonfigurasi di penyedia identitas Anda (iDP) dari ke. `/_plugin/kibana` `/_dashboards` Yang paling umum URLs adalah assertion consumer service (ACS) URLs dan penerima. URLs
`kibana_read_only`Peran default untuk OpenSearch Dasbor diubah namanya menjadi`opensearch_dashboards_read_only`, dan `kibana_user` peran diubah namanya menjadi. `opensearch_dashboards_user` Perubahan ini berlaku untuk semua yang *baru dibuat 1* OpenSearch . *x* domain yang menjalankan perangkat lunak layanan R20211203 atau yang lebih baru. Jika Anda memutakhirkan domain yang ada ke perangkat lunak layanan R20211203, nama peran tetap sama.
## Metrik berganti nama CloudWatch
Beberapa CloudWatch metrik berubah untuk domain yang berjalan. OpenSearch Saat Anda memutakhirkan domain ke OpenSearch, metrik berubah secara otomatis dan CloudWatch alarm Anda saat ini akan rusak. Sebelum memutakhirkan klaster Anda dari versi Elasticsearch ke OpenSearch versi, pastikan untuk memperbarui CloudWatch alarm Anda untuk menggunakan metrik baru.
Metrik berikut berubah:
| Nama metrik asli | Nama baru |
| --- | --- |
| `KibanaHealthyNodes` | `OpenSearchDashboardsHealthyNodes` |
| `KibanaConcurrentConnections` | `OpenSearchDashboardsConcurrentConnections` |
| `KibanaHeapTotal` | `OpenSearchDashboardsHeapTotal` |
| `KibanaHeapUsed` | `OpenSearchDashboardsHeapUsed` |
| `KibanaHeapUtilization` | `OpenSearchDashboardsHeapUtilization` |
| `KibanaOS1MinuteLoad` | `OpenSearchDashboardsOS1MinuteLoad` |
| `KibanaRequestTotal` | `OpenSearchDashboardsRequestTotal` |
| `KibanaResponseTimesMaxInMillis` | `OpenSearchDashboardsResponseTimesMaxInMillis` |
| `ESReportingFailedRequestSysErrCount` | `KibanaReportingFailedRequestSysErrCount` |
| `ESReportingRequestCount` | `KibanaReportingRequestCount` |
| `ESReportingFailedRequestUserErrCount` | `KibanaReportingFailedRequestUserErrCount` |
| `ESReportingSuccessCount` | `KibanaReportingSuccessCount` |
| `ElasticsearchRequests` | `OpenSearchRequests` |
Untuk daftar lengkap metrik yang dikirim OpenSearch Layanan ke Amazon CloudWatch, lihat[Memantau metrik OpenSearch klaster dengan Amazon CloudWatch](managedomains-cloudwatchmetrics.md).
## Perubahan konsol Billing and Cost Management
Data historis di konsol [Billing and Cost](https://console.aws.amazon.com/billing/home) Management dan [di Cost and Usage](https://aws.amazon.com/aws-cost-management/aws-cost-and-usage-reporting/) Reports akan terus menggunakan nama layanan lama, jadi Anda harus mulai menggunakan filter untuk Layanan ** OpenSearch Amazon** dan nama Elasticsearch lama saat mencari data. Jika Anda memiliki laporan tersimpan, perbarui filter untuk memastikan mereka juga menyertakan OpenSearch Layanan. Anda mungkin awalnya menerima peringatan ketika penggunaan Anda berkurang untuk Elasticsearch dan meningkat untuk OpenSearch, tetapi menghilang dalam beberapa hari.
Selain nama layanan, bidang berikut akan berubah untuk semua laporan, tagihan, dan operasi API daftar harga:
| Bidang | Format lama | Format baru |
| --- | --- | --- |
| Tipe instans | `m5.large.elasticsearch` | `m5.large.search` |
| Keluarga produk | Contoh Elasticsearch
Volume Elasticsearch | Instans OpenSearch Layanan Amazon
Volume OpenSearch Layanan Amazon |
| Deskripsi harga | $5.098 per c5.18xlarge.elasticsearch instance hour (atau sebagian jam) - UE | $5.098 per c5.18xlarge.search instance hour (atau sebagian jam) - EU |
| Keluarga instans | `ultrawarm.elasticsearch` | `ultrawarm.search` |
## Format acara baru
Format acara yang dikirim OpenSearch Layanan ke Amazon EventBridge dan Amazon CloudWatch telah berubah, khususnya `detail-type` bidangnya. Bidang sumber (`aws.es`) tetap sama. Untuk format lengkap untuk setiap jenis acara, lihat[Memantau peristiwa OpenSearch Layanan dengan Amazon EventBridge](monitoring-events.md). Jika Anda memiliki aturan acara yang ada yang bergantung pada format lama, pastikan untuk memperbaruinya agar sesuai dengan format baru.
## Apa yang tetap sama?
Fitur dan fungsionalitas berikut, antara lain yang tidak terdaftar, akan tetap sama:
+ Prinsipal layanan (`es.amazonaws.com`)
+ Kode vendor
+ Domain ARNs
+ Titik akhir domain
## Memulai: Tingkatkan domain Anda ke 1.x OpenSearch
OpenSearch 1. *x* mendukung peningkatan dari Elasticsearch versi 6.8 dan 7. *x*. Untuk petunjuk untuk meningkatkan domain Anda, lihat[Memutakhirkan domain (konsol)](starting-upgrades.md). Jika Anda menggunakan API konfigurasi AWS CLI atau untuk meningkatkan domain Anda, Anda perlu menentukan `TargetVersion` sebagai`OpenSearch_1.x`.
OpenSearch 1. *x* memperkenalkan pengaturan domain tambahan yang disebut **Aktifkan mode kompatibilitas**. Karena klien dan plugin OSS Elasticsearch tertentu memeriksa versi cluster sebelum menghubungkan, mode kompatibilitas ditetapkan OpenSearch untuk melaporkan versinya sebagai 7.10 sehingga klien ini terus bekerja.
Anda dapat mengaktifkan mode kompatibilitas saat membuat OpenSearch domain untuk pertama kalinya, atau saat Anda meningkatkan ke OpenSearch versi Elasticsearch. Jika tidak disetel, parameter default adalah `false` saat Anda membuat domain, dan `true` saat Anda memutakhirkan domain.
Untuk mengaktifkan mode kompatibilitas menggunakan [API konfigurasi](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpgradeDomain.html), atur `override_main_response_version` ke`true`:
```
POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/upgradeDomain
{
"DomainName": "{{domain-name}}",
"TargetVersion": "OpenSearch_1.0",
"AdvancedOptions": {
"override_main_response_version": "true"
}
}
```
Untuk mengaktifkan atau menonaktifkan mode kompatibilitas pada OpenSearch domain *yang ada*, Anda perlu menggunakan operasi OpenSearch [\_cluster/settings](https://docs.opensearch.org/latest/opensearch/rest-api/cluster-settings/) API:
```
PUT /_cluster/settings
{
"persistent" : {
"compatibility.override_main_response_version" : true
}
}
```