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

# Pembaruan perangkat lunak layanan di Amazon OpenSearch Service
<a name="service-software"></a>

**catatan**  
[Untuk penjelasan tentang perubahan dan penambahan yang dibuat di setiap pembaruan perangkat lunak layanan *utama* (non-patch), lihat catatan rilis.](release-notes.md)

Amazon OpenSearch Service secara teratur merilis pembaruan perangkat lunak layanan yang menambahkan fitur atau meningkatkan domain Anda. Panel **Notifikasi** di konsol adalah cara termudah untuk melihat apakah pembaruan tersedia atau untuk memeriksa status pembaruan. Setiap notifikasi menyertakan detail tentang pembaruan perangkat lunak layanan. Semua pembaruan perangkat lunak layanan menggunakan penerapan biru/hijau untuk meminimalkan waktu henti.

Pembaruan perangkat lunak layanan berbeda dari peningkatan *versi OpenSearch * Layanan. Untuk informasi tentang memutakhirkan ke versi OpenSearch Layanan yang lebih baru, lihat[Memutakhirkan domain OpenSearch Layanan Amazon](version-migration.md).

 OpenSearch Layanan mengharuskan Anda untuk menerapkan pembaruan perangkat lunak layanan yang diperlukan dalam waktu 30 hari sejak ketersediaannya. Pembaruan ini sangat penting untuk menjaga kepatuhan keamanan. 

 Jika Anda tidak menerapkan pembaruan yang diperlukan dalam periode 30 hari, Anda akan menerima pemberitahuan pengingat setiap 15 hari selama 30 hari. Setelah periode ini tanpa kepatuhan, domain Anda akan diisolasi dengan efek berikut: 
+ Semua akses jaringan ke domain Anda dihapus
+ Perubahan status domain menjadi **terisolasi**
+ Domain tetap tidak dapat digunakan sampai Anda menerapkan pembaruan yang diperlukan

 Selama isolasi, Anda akan terus menerima pemberitahuan pengingat setiap 15 hari selama 60 hari. Jika Anda tidak menerapkan pembaruan yang diperlukan dalam periode ini, domain OpenSearch Layanan Anda dan semua data terkait akan dihapus secara permanen. Untuk informasi selengkapnya, lihat [Memecahkan masalah kesalahan validasi](managedomains-configuration-changes.md#validation).

## Pembaruan opsional versus yang diperlukan
<a name="service-software-optional-required"></a>

OpenSearch Layanan memiliki dua kategori pembaruan perangkat lunak layanan yang luas:

### Pembaruan opsional
<a name="service-software-optional"></a>

Pembaruan perangkat lunak layanan opsional umumnya mencakup peningkatan dan dukungan untuk fitur atau fungsionalitas baru. Pembaruan opsional tidak diberlakukan pada domain Anda, dan tidak ada tenggat waktu yang sulit untuk menginstalnya. Ketersediaan pembaruan dikomunikasikan melalui email dan pemberitahuan konsol. Anda dapat memilih untuk segera menerapkan pembaruan atau menjadwal ulang untuk tanggal dan waktu yang lebih tepat. Anda juga dapat menjadwalkannya selama [jendela off-peak](off-peak.md) domain. Sebagian besar pembaruan perangkat lunak bersifat opsional.

Terlepas dari apakah Anda menjadwalkan pembaruan atau tidak, jika Anda membuat perubahan pada domain yang menyebabkan [penyebaran biru/hijau](managedomains-configuration-changes.md), OpenSearch Layanan secara otomatis memperbarui perangkat lunak layanan Anda untuk Anda.

Anda dapat mengonfigurasi domain untuk menerapkan pembaruan opsional secara otomatis selama [jam sibuk](off-peak.md). Ketika opsi ini diaktifkan, OpenSearch Layanan menunggu setidaknya 13 hari sejak pembaruan opsional tersedia dan kemudian menjadwalkan pembaruan setelah tujuh hari. Anda menerima pemberitahuan konsol saat pembaruan dijadwalkan dan Anda dapat memilih untuk menjadwal ulang untuk kemudian hari.

Untuk mengaktifkan pembaruan perangkat lunak otomatis, pilih **Aktifkan pembaruan perangkat lunak otomatis** saat Anda membuat atau memperbarui domain Anda. Untuk mengonfigurasi pengaturan yang sama menggunakan AWS CLI, atur `--software-update-options` ke `true` saat Anda membuat atau memperbarui domain Anda.

### Pembaruan yang diperlukan
<a name="service-software-required"></a>

Pembaruan perangkat lunak layanan yang diperlukan umumnya mencakup perbaikan keamanan penting atau pembaruan wajib lainnya untuk memastikan integritas dan fungsionalitas domain Anda yang berkelanjutan. Contoh pembaruan yang diperlukan adalah Log4j Common Vulnerabilities and Exposures (CVEs) dan penegakan Instance Metadata Service Version 2 (). IMDSv2 Jumlah pembaruan wajib dalam setahun biasanya kurang dari tiga.

OpenSearch Layanan secara otomatis menjadwalkan pembaruan ini dan memberi tahu Anda tujuh hari sebelum pembaruan yang dijadwalkan melalui email dan pemberitahuan konsol. Anda dapat memilih untuk segera menerapkan pembaruan atau menjadwalkannya kembali untuk tanggal dan waktu yang lebih tepat *dalam jangka waktu yang diizinkan*. Anda juga dapat menjadwalkannya selama [jendela off-peak](off-peak.md) domain berikutnya. Jika Anda tidak mengambil tindakan pada pembaruan yang diperlukan dan Anda tidak membuat perubahan domain apa pun yang menyebabkan blue/green penerapan, OpenSearch Layanan dapat memulai pembaruan kapan saja di luar batas waktu yang ditentukan (biasanya 14 hari sejak ketersediaan), dalam jendela off-peak domain.

Terlepas dari kapan pembaruan dijadwalkan, jika Anda membuat perubahan pada domain yang menyebabkan [penyebaran biru/hijau](managedomains-configuration-changes.md), OpenSearch Layanan secara otomatis memperbarui domain Anda untuk Anda.

## Pembaruan tambalan
<a name="service-software-patches"></a>

Versi perangkat lunak layanan yang diakhiri dengan “-P” dan angka, seperti R20211203-{{P4}}, adalah rilis patch. Patch cenderung mencakup peningkatan kinerja, perbaikan bug kecil, dan perbaikan keamanan atau perbaikan postur. Rilis patch tidak menyertakan fitur baru atau perubahan yang melanggar, dan umumnya tidak memiliki dampak langsung atau nyata pada pengguna. Pemberitahuan perangkat lunak layanan memberi tahu Anda jika rilis patch bersifat opsional atau wajib.

## Pertimbangan-pertimbangan
<a name="service-software-considerations"></a>

Pertimbangkan hal berikut saat memutuskan apakah akan memperbarui domain Anda:
+ Memperbarui domain Anda secara manual memungkinkan Anda memanfaatkan fitur baru dengan lebih cepat. Ketika Anda memilih **Perbarui**, OpenSearch Layanan menempatkan permintaan dalam antrian dan memulai pembaruan ketika ada waktu. 
+ Saat Anda memulai pembaruan perangkat lunak layanan, OpenSearch Layanan mengirimkan pemberitahuan saat pembaruan dimulai dan kapan selesai.
+ Pembaruan perangkat lunak menggunakan blue/green penerapan untuk meminimalkan waktu henti. Pembaruan untuk sementara dapat menegangkan simpul utama terdedikasi klaster, jadi pastikan untuk mempertahankan kapasitas yang cukup untuk menangani overhead terkait.
+ Pembaruan biasanya selesai dalam beberapa menit, tetapi juga dapat memakan waktu beberapa jam atau bahkan berhari-hari jika sistem Anda mengalami beban berat. Pertimbangkan untuk memperbarui domain Anda selama [jendela off-peak](off-peak.md) yang dikonfigurasi untuk menghindari periode pembaruan yang lama. 

## Memulai pembaruan perangkat lunak layanan
<a name="service-software-requesting"></a>

Anda dapat meminta pembaruan perangkat lunak layanan melalui konsol OpenSearch Layanan, konsol AWS CLI, atau salah satu SDKs. 

### Konsol
<a name="service-software-request-console"></a>

**Untuk meminta pembaruan perangkat lunak layanan**

1. Buka konsol OpenSearch Layanan Amazon di [https://console.aws.amazon.com/aos/rumah](https://console.aws.amazon.com/aos/home).

1. Pilih nama domain untuk membuka konfigurasinya.

1. Pilih **Tindakan**, **Perbarui** dan pilih salah satu opsi berikut:
   + **Terapkan pembaruan sekarang** - Segera jadwalkan tindakan yang akan terjadi pada jam saat ini *jika ada kapasitas yang tersedia*. Jika kapasitas tidak tersedia, kami menyediakan slot waktu lain yang tersedia untuk dipilih.
   + **Jadwalkan di jendela off-peak** — Hanya tersedia jika jendela off-peak diaktifkan untuk domain. Menjadwalkan pembaruan yang akan dilakukan selama jendela off-peak domain yang dikonfigurasi. Tidak ada jaminan bahwa pembaruan akan terjadi selama jendela langsung berikutnya. Tergantung pada kapasitas, itu mungkin terjadi di hari-hari berikutnya. Untuk informasi selengkapnya, lihat [Menjadwalkan pembaruan perangkat lunak selama jendela off-peak](#service-software-offpeak).
   + **Jadwal untuk tanggal dan waktu tertentu** - Menjadwalkan pembaruan untuk berlangsung pada tanggal dan waktu tertentu. Jika waktu yang Anda tentukan tidak tersedia karena alasan kapasitas, Anda dapat memilih slot waktu yang berbeda.

   Jika Anda menjadwalkan pembaruan di kemudian hari (di dalam atau di luar jendela off-peak domain), Anda dapat menjadwal ulang kapan saja. Untuk petunjuk, lihat [Tindakan penjadwalan ulang](off-peak.md#off-peak-reschedule).

1. Pilih **Konfirmasi**.

### AWS CLI
<a name="service-software-request-cli"></a>

Kirim [start-service-software-update](https://docs.aws.amazon.com/cli/latest/reference/opensearch/start-service-software-update.html) AWS CLI permintaan untuk memulai pembaruan perangkat lunak layanan. Contoh ini segera menambahkan pembaruan ke antrian:

```
aws opensearch start-service-software-update \
  --domain-name {{my-domain}} \
  --schedule-at "NOW"
```

**Tanggapan**:

```
{
    "ServiceSoftwareOptions": {
        "CurrentVersion": "R20220928-P1",
        "NewVersion": "R20220928-P2",
        "UpdateAvailable": true,
        "Cancellable": true,
        "UpdateStatus": "PENDING_UPDATE",
        "Description": "",
        "AutomatedUpdateDate": "1969-12-31T16:00:00-08:00",
        "OptionalDeployment": true
    }
}
```

**Tip**  
Setelah Anda meminta pembaruan, Anda memiliki jendela waktu yang sempit di mana Anda dapat membatalkannya. Durasi `PENDING_UPDATE` status ini dapat sangat bervariasi dan tergantung pada Anda Wilayah AWS dan jumlah pembaruan bersamaan yang dilakukan OpenSearch Layanan. Untuk membatalkan pembaruan, gunakan konsol atau `cancel-service-software-update` AWS CLI perintah.

Jika permintaan gagal dengan a`BaseException`, itu berarti bahwa waktu yang Anda tentukan tidak tersedia karena alasan kapasitas, dan Anda harus menentukan waktu yang berbeda. OpenSearch Layanan memberikan saran slot alternatif yang tersedia sebagai tanggapan.

### AWS SDKs
<a name="service-software-request-sdk"></a>

Contoh skrip Python ini menggunakan metode [describe\_domain dan start\_service\_software\_update](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html#OpenSearchService.Client.describe_domain) [dari AWS SDK untuk Python (Boto3) untuk memeriksa apakah domain memenuhi syarat untuk pembaruan](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html#OpenSearchService.Client.start_service_software_update) perangkat lunak layanan dan jika demikian, mulai pembaruan. Anda harus memberikan nilai untuk`domain_name`.

```
import boto3
from botocore.config import Config
import time

# Build the client using the default credential configuration.
# You can use the CLI and run 'aws configure' to set access key, secret
# key, and default region.

my_config = Config(
    # Optionally lets you specify a Region other than your default.
    region_name='us-east-1'
)

domain_name = ''  # The name of the domain to check and update

client = boto3.client('opensearch', config=my_config)


def getUpdateStatus(client):
    """Determines whether the domain is eligible for an update"""
    response = client.describe_domain(
        DomainName=domain_name
    )
    sso = response['DomainStatus']['ServiceSoftwareOptions']
    if sso['UpdateStatus'] == 'ELIGIBLE':
        print('Domain [' + domain_name + '] is eligible for a service software update from version ' +
              sso['CurrentVersion'] + ' to version ' + sso['NewVersion'])
        updateDomain(client)
    else:
        print('Domain is not eligible for an update at this time.')


def updateDomain(client):
    """Starts a service software update for the eligible domain"""
    response = client.start_service_software_update(
        DomainName=domain_name
    )
    print('Updating domain [' + domain_name + '] to version ' +
          response['ServiceSoftwareOptions']['NewVersion'] + '...')
    waitForUpdate(client)


def waitForUpdate(client):
    """Waits for the domain to finish updating"""
    response = client.describe_domain(
        DomainName=domain_name
    )
    status = response['DomainStatus']['ServiceSoftwareOptions']['UpdateStatus']
    if status == 'PENDING_UPDATE' or status == 'IN_PROGRESS':
        time.sleep(30)
        waitForUpdate(client)
    elif status == 'COMPLETED':
        print('Domain [' + domain_name +
              '] successfully updated to the latest software version')
    else:
        print('Domain is not currently being updated.')

def main():
    getUpdateStatus(client)
```

## Menjadwalkan pembaruan perangkat lunak selama jendela off-peak
<a name="service-software-offpeak"></a>

[Setiap domain OpenSearch Layanan yang dibuat setelah 16 Februari 2023 memiliki jendela 10 jam harian antara pukul 22:00 dan 8:00 pagi waktu setempat yang kami anggap sebagai jendela off-peak.](off-peak.md) OpenSearch Layanan menggunakan jendela ini untuk menjadwalkan pembaruan perangkat lunak layanan untuk domain. Pembaruan off-peak membantu meminimalkan ketegangan pada node master khusus cluster selama periode lalu lintas yang lebih tinggi. OpenSearch Layanan tidak dapat memulai pembaruan di luar jendela 10 jam ini tanpa persetujuan Anda.
+ Untuk pembaruan *opsional*, OpenSearch Layanan memberi tahu Anda tentang ketersediaan pembaruan dan meminta Anda untuk menjadwalkan pembaruan selama jendela off-peak yang akan datang.
+ Untuk pembaruan *yang diperlukan*, OpenSearch Layanan secara otomatis menjadwalkan pembaruan selama jendela off-peak yang akan datang dan memberi tahu Anda tiga hari sebelumnya. Anda dapat menjadwal ulang pembaruan (untuk di dalam atau di luar jendela off-peak), tetapi hanya dalam jangka waktu yang diperlukan agar pembaruan selesai.

Untuk setiap domain, Anda dapat memilih untuk mengganti waktu mulai 10:00 P.M. default dengan waktu khusus. Untuk petunjuk, lihat [Mengonfigurasi jendela off-peak khusus](off-peak.md#off-peak-custom).

### Konsol
<a name="service-software-offpeak-console"></a>

**Untuk menjadwalkan pembaruan selama jendela off-peak mendatang**

1. Buka konsol OpenSearch Layanan Amazon di [https://console.aws.amazon.com/aos/rumah](https://console.aws.amazon.com/aos/home ).

1. Pilih nama domain untuk membuka konfigurasinya.

1. Pilih **Tindakan**, **Perbarui**.

1. Pilih **Jadwalkan di jendela off-peak**.

1. Pilih **Konfirmasi**.

Anda dapat melihat tindakan terjadwal pada tab **jendela Off-peak** dan menjadwal ulang kapan saja. Lihat [Melihat tindakan terjadwal](off-peak.md#off-peak-view).

### CLI
<a name="service-software-offpeak-cli"></a>

Untuk menjadwalkan pembaruan selama jendela off-peak yang akan datang menggunakan AWS CLI, kirim [StartServiceSoftwareUpdate](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_StartServiceSoftwareUpdate.html)permintaan dan tentukan `OFF_PEAK_WINDOW` `--schedule-at` parameternya:

```
aws opensearch start-service-software-update \
  --domain-name {{my-domain}} \
  --schedule-at "OFF_PEAK_WINDOW"
```

## Pemantauan pembaruan perangkat lunak layanan
<a name="service-software-monitor"></a>

OpenSearch Layanan mengirimkan [pemberitahuan](managedomains-notifications.md) ketika pembaruan perangkat lunak layanan tersedia, diperlukan, dimulai, selesai, atau gagal. Anda dapat melihat notifikasi ini di panel **Notifikasi** konsol OpenSearch Layanan. Kepelikan notifikasi adalah `Informational` jika pembaruan bersifat opsional dan `High` jika diperlukan. 

OpenSearch Layanan juga mengirimkan acara perangkat lunak layanan ke Amazon EventBridge. Anda dapat menggunakan EventBridge untuk mengonfigurasi aturan yang mengirim email atau melakukan tindakan tertentu saat acara diterima. Sebagai contoh berjalan melalui, lihat[Tutorial: Mengirim peringatan Amazon SNS untuk pembaruan perangkat lunak yang tersedia](sns-events.md).

Untuk melihat format setiap peristiwa perangkat lunak layanan yang dikirim ke Amazon EventBridge, lihat[Peristiwa pembaruan perangkat lunak layanan](monitoring-events.md#monitoring-events-sso).

## Ketika domain tidak memenuhi syarat untuk pembaruan
<a name="service-software-ineligible"></a>

Domain Anda tidak memenuhi syarat untuk pembaruan perangkat lunak layanan jika berada di salah satu status berikut:


| Status | Deskripsi | 
| --- | --- | 
| Domain dalam pemrosesan | Domain sedang di tengah-tengah perubahan konfigurasi. Periksa kelayakan pembaruan setelah operasi selesai. | 
| Status klaster merah | Satu atau lebih indeks di cluster berwarna merah. Untuk langkah-langkah pemecahan masalah, lihat [Status klaster merah](handling-errors.md#handling-errors-red-cluster-status). | 
| Tingkat kesalahan tinggi |  OpenSearch Cluster mengembalikan sejumlah besar kesalahan 5 *xx* saat mencoba memproses permintaan. Masalah ini biasanya merupakan hasil dari terlalu banyaknya permintaan baca atau tulis secara bersamaan. Pertimbangkan untuk mengurangi lalu lintas ke klaster atau menskalakan domain Anda. | 
| Split brain | *Otak terbelah* berarti OpenSearch cluster Anda memiliki lebih dari satu simpul master dan telah dibagi menjadi dua cluster yang tidak akan pernah bergabung kembali dengan sendirinya. Anda dapat menghindari split brain dengan menggunakan jumlah yang direkomendasikan untuk [simpul utama terdedikasi](managedomains-dedicatedmasternodes.md). Untuk bantuan pemulihan dari split brain, hubungi [Dukungan](https://console.aws.amazon.com/support/home). | 
| Masalah integrasi Amazon Cognito | Domain Anda menggunakan [autentikasi untuk OpenSearch Dasbor](cognito-auth.md), dan OpenSearch Layanan tidak dapat menemukan satu atau beberapa sumber daya Amazon Cognito. Masalah ini biasanya terjadi jika kolam pengguna Amazon Cognito hilang. Untuk memperbaiki masalah, buat ulang sumber daya yang hilang dan konfigurasikan domain OpenSearch Layanan untuk menggunakannya. | 
| Masalah layanan lainnya | Masalah dengan OpenSearch Layanan itu sendiri dapat menyebabkan domain Anda ditampilkan sebagai tidak memenuhi syarat untuk pembaruan. Jika tidak ada syarat sebelumnya yang berlaku untuk domain Anda dan masalah berlanjut selama lebih dari satu hari, hubungi [Dukungan](https://console.aws.amazon.com/support/home). | 

## Mengembalikan pembaruan perangkat lunak layanan
<a name="service-software-rollback"></a>

Amazon OpenSearch Service mendukung pembaruan perangkat lunak layanan bergulir kembali. Anda dapat memulai rollback menggunakan konsol OpenSearch Layanan AWS CLI, atau salah satu. AWS SDKs Pembaruan perangkat lunak digulirkan kembali menggunakan blue/green penerapan.

**catatan**  
Rollback hanya didukung untuk pembaruan perangkat lunak layanan yang diterapkan pada atau setelah 24 April 2026. Upgrade versi mesin tidak dapat diputar kembali.

### Kelayakan dan pertimbangan rollback
<a name="service-software-rollback-eligibility"></a>

Domain Anda harus memenuhi semua ketentuan berikut agar rollback tersedia:
+ **Domain aktif** — Domain harus dalam `Active` keadaan. Rollback tidak tersedia saat perubahan konfigurasi, pembaruan perangkat lunak, atau blue/green penerapan lainnya sedang berlangsung.
+ **Dalam jendela waktu rollback** - Pembaruan perangkat lunak harus telah diterapkan dalam periode rollback yang diizinkan. Lihat [Jendela waktu rollback](#service-software-rollback-windows).
+ **Tidak ada perubahan konfigurasi setelah pembaruan** — Jika Anda membuat perubahan konfigurasi ke domain setelah pembaruan perangkat lunak diterapkan, rollback diblokir. Perubahan konfigurasi dapat memengaruhi pengaturan domain dengan cara yang tidak kompatibel dengan versi perangkat lunak sebelumnya. Misalnya, mengubah jenis instance, mengaktifkan replika, atau menyesuaikan pengaturan penyimpanan setelah pembaruan akan memblokir rollback.
+ **Pembaruan tidak diterapkan secara otomatis oleh layanan** - Jika Anda tidak bertindak atas pembaruan wajib dalam jendela ketersediaan 30 hari dan OpenSearch Layanan menerapkan pembaruan secara otomatis, rollback tidak tersedia untuk pembaruan itu.
+ **Pembaruan bukan peningkatan versi mesin** - Perubahan versi mesin (misalnya, peningkatan dari OpenSearch 1.3 ke OpenSearch 2.11) tidak dapat diubah. Hanya rollback versi perangkat lunak layanan yang didukung.
+ **Versi perangkat lunak sebelumnya ada** — Rollback hanya tersedia untuk pembaruan perangkat lunak yang diterapkan setelah fitur ini tersedia secara umum (GA). Domain yang belum mengalami pembaruan perangkat lunak karena GA tidak memiliki versi sebelumnya untuk diputar kembali.
+ **Hanya satu rollback yang diizinkan per pembaruan** - Setelah rollback selesai, domain dianggap dalam keadaan rolled-back. Anda tidak dapat memutar kembali sampai pembaruan perangkat lunak baru berhasil diterapkan.
+ **Pembaruan perangkat lunak dimulai secara eksplisit** — Rollback hanya tersedia ketika pembaruan perangkat lunak secara eksplisit dimulai oleh Anda atau secara otomatis dijadwalkan oleh OpenSearch Layanan sebagai bagian dari pembaruan wajib atau opsional. Rollback tidak tersedia saat:
  + Pembaruan perangkat lunak diterapkan selama blue/green penerapan yang dipicu oleh perubahan konfigurasi. Ini termasuk kasus di mana `UseLatestServiceSoftwareForBlueGreen` pengaturan diaktifkan, yang menggabungkan pembaruan perangkat lunak terbaru dengan perubahan konfigurasi. Anda memiliki opsi untuk menonaktifkan pengaturan ini.
  + Pembaruan diterapkan selama operasi pemeliharaan yang dimulai layanan pada domain Anda, seperti pemulihan infrastruktur, remediasi otomatis, atau operasi internal lainnya yang dilakukan oleh OpenSearch Layanan untuk menjaga kesehatan dan ketersediaan domain Anda.

### Jendela waktu rollback
<a name="service-software-rollback-windows"></a>

Jendela rollback tergantung pada jenis pembaruan perangkat lunak yang diterapkan.


| Jenis pembaruan | Jendela rollback | Catatan | 
| --- | --- | --- | 
| Opsional | 15 hari sejak tanggal pembaruan diterapkan | Berlaku apakah Anda menerapkan pembaruan secara manual, menjadwalkannya, atau diterapkan secara otomatis selama jam sibuk. | 
| Wajib | 15 hari sejak tanggal pembaruan diterapkan | Hanya tersedia jika Anda menerapkan pembaruan sendiri dalam jendela ketersediaan 30 hari. Jika layanan menerapkan pembaruan secara otomatis setelah batas waktu, rollback tidak tersedia. | 

Setelah jendela rollback berakhir, rollback swalayan tidak lagi tersedia. Hubungi [Dukungan](https://console.aws.amazon.com/support/home)jika Anda mengalami masalah kritis setelah jendela ditutup.

### Cara meminta rollback
<a name="service-software-rollback-requesting"></a>

Anda dapat meminta rollback menggunakan API. `RollbackServiceSoftwareUpdate`

#### Permintaan
<a name="service-software-rollback-request"></a>

```
POST /2021-01-01/opensearch/serviceSoftwareUpdate/rollback
```

Permintaan badan:

```
{
    "DomainName": "{{your-domain-name}}"
}
```

#### Respons
<a name="service-software-rollback-response"></a>

API mengembalikan respons HTTP 200 dalam semua kasus non-kesalahan. `RollbackAvailable`Bidang di badan respons menunjukkan apakah rollback dimulai.

```
{
    "RollbackServiceSoftwareOptions": {
        "CurrentVersion": "string",
        "NewVersion": "string",
        "RollbackAvailable": boolean,
        "Description": "string"
    }
}
```

Bidang respons:


| Bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| CurrentVersion | String | Versi perangkat lunak yang saat ini berjalan di domain. | 
| NewVersion | String | Versi perangkat lunak domain akan digulung kembali. Mengembalikan null jika rollback tidak tersedia. | 
| RollbackAvailable | Boolean | `true`jika rollback telah berhasil dimulai. `false`jika domain tidak memenuhi syarat untuk rollback. | 
| Description | String | Pesan yang dapat dibaca manusia yang menjelaskan hasil atau alasan rollback tidak tersedia. | 

#### Tanggapan kesalahan
<a name="service-software-rollback-errors"></a>


| Kesalahan | Deskripsi | 
| --- | --- | 
| ResourceNotFoundException | Domain yang ditentukan tidak ada. | 
| ValidationException | Domain tidak dalam keadaan aktif. Tunggu perubahan yang sedang berlangsung selesai sebelum mencoba lagi. | 
| InternalException | Layanan mengalami kesalahan internal. Coba lagi permintaannya. | 
| DisabledOperationException | Operasi rollback tidak didukung untuk domain ini. | 

#### Pesan respons
<a name="service-software-rollback-messages"></a>

Tabel berikut menjelaskan kemungkinan pesan respons yang dikembalikan oleh `RollbackServiceSoftwareUpdate` API.


| Kasus | Deskripsi | 
| --- | --- | 
| Berhasil | Rollback dimulai dengan sukses. Domain akan digulung kembali dari {{current-version}} ke{{previous-version}}. | 
| Fitur tidak diaktifkan | Rollback tidak tersedia. Kontak [Dukungan](https://console.aws.amazon.com/support/home)untuk bantuan. | 
| Perangkat lunak sebelumnya tidak tersedia | Tidak ada versi perangkat lunak sebelumnya yang tersedia untuk rollback. Kontak [Dukungan](https://console.aws.amazon.com/support/home)untuk bantuan. | 
| Perangkat lunak sebelumnya sama dengan saat ini | Rollback tidak tersedia. Tidak ada versi perangkat lunak sebelumnya yang tersedia untuk rollback. Kontak [Dukungan](https://console.aws.amazon.com/support/home)untuk bantuan. | 
| Domain sudah digulung kembali | Domain sudah dalam keadaan rolled-back. | 
| Cluster ada di versi perangkat lunak yang disematkan | Penggantian perangkat lunak saat ini diterapkan ke domain. | 
| Di luar jendela waktu | Rollback tidak tersedia. Jendela rollback 15 hari telah kedaluwarsa. Kontak [Dukungan](https://console.aws.amazon.com/support/home)untuk bantuan. | 
| Pembaruan layanan wajib diterapkan secara otomatis | Rollback tidak tersedia. Versi saat ini diterapkan melalui pembaruan layanan wajib. Kontak [Dukungan](https://console.aws.amazon.com/support/home)untuk bantuan. | 
| Peningkatan versi mesin | Rollback tidak tersedia. Peningkatan versi mesin tidak dapat diubah. Kontak [Dukungan](https://console.aws.amazon.com/support/home)untuk bantuan. | 
| Konfigurasi berubah setelah pembaruan | Rollback tidak tersedia. Konfigurasi cluster telah berubah sejak pembaruan perangkat lunak terakhir. Kontak [Dukungan](https://console.aws.amazon.com/support/home)untuk bantuan. | 

**Contoh respon:**

```
{
    "RollbackServiceSoftwareOptions": {
        "CurrentVersion": "OpenSearch_2_11_R20240115",
        "NewVersion": "OpenSearch_2_11_R20231023",
        "RollbackAvailable": true,
        "Description": "Rollback initiated successfully. The domain will be rolled back from OpenSearch_2_11_R20240115 to OpenSearch_2_11_R20231023."
    }
}
```

Ketika rollback tidak tersedia, `RollbackAvailable` pengembalian `false` dan `Description` bidang berisi alasan dari tabel di atas.