기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon OpenSearch Service의 서비스 소프트웨어 업데이트 **참고** 각 *주요*(패치 제외) 서비스 소프트웨어 업데이트 시 수행된 변경 사항 및 추가 사항에 대한 설명은 [릴리스 정보](release-notes.md)를 참조하세요. Amazon OpenSearch Service는 기능을 추가하거나 도메인을 개선하는 서비스 소프트웨어 업데이트를 정기적으로 릴리스합니다. 콘솔의 **Notifications**(알림) 패널은 업데이트가 있는지 확인하거나 업데이트 상태를 확인하는 가장 쉬운 방법입니다. 각 알림에는 서비스 소프트웨어 업데이트에 대한 세부 정보가 포함됩니다. 모든 서비스 소프트웨어 업데이트는 블루/그린 배포를 사용하여 가동 중단을 최소화합니다. 서비스 소프트웨어 업데이트는 OpenSearch Service *버전* 업그레이드와 다릅니다. OpenSearch Service의 최신 버전으로 업그레이드하는 방법에 대한 자세한 내용은 섹션을 참조하세요[Amazon OpenSearch Service 도메인 업그레이드](version-migration.md). OpenSearch Service를 사용하려면 가용성 후 30일 이내에 필요한 서비스 소프트웨어 업데이트를 적용해야 합니다. 이러한 업데이트는 보안 규정 준수를 유지하는 데 매우 중요합니다. 30일 기간 내에 필수 업데이트를 적용하지 않으면 30일 동안 15일마다 알림 알림을 받게 됩니다. 규정 준수 없이이 기간이 지나면 도메인이 다음과 같은 효과로 격리됩니다. + 도메인에 대한 모든 네트워크 액세스가 제거됩니다. + 도메인 상태가 **격리**됨으로 변경됨 + 필요한 업데이트를 적용할 때까지 도메인을 사용할 수 없습니다. 격리 중에는 60일 동안 15일마다 알림 알림을 계속 받게 됩니다. 이 기간 내에 필요한 업데이트를 적용하지 않으면 OpenSearch Service 도메인과 모든 관련 데이터가 영구적으로 삭제됩니다. 자세한 내용은 [검증 오류 문제 해결을 참조하세요](managedomains-configuration-changes.md#validation). ## 선택적 업데이트와 필수 업데이트 비교 OpenSearch Service에는 다음의 두 가지 범주의 서비스 소프트웨어 업데이트가 있습니다. ### 선택적 업데이트 선택적 서비스 소프트웨어 업데이트에는 일반적으로 새로운 특징이나 기능에 대한 개선 사항 및 지원이 포함됩니다. 선택적 업데이트는 도메인에 적용되지 않으며 설치 기한도 정해져 있지 않습니다. 업데이트 사용 가능 여부는 이메일과 콘솔 알림을 통해 전달됩니다. 업데이트를 즉시 적용하도록 선택하거나 더 적절한 날짜 및 시간으로 다시 예약할 수 있습니다. 도메인의 [사용량이 적은 기간](off-peak.md) 동안 일정을 잡을 수도 있습니다. 대부분의 소프트웨어 업데이트는 선택 사항입니다. 업데이트 예약 여부에 관계없이 [블루/그린 배포](managedomains-configuration-changes.md)를 유발하는 도메인을 변경하면 OpenSearch Service에서 자동으로 서비스 소프트웨어를 업데이트합니다. [사용량이 적은 기간](off-peak.md)에 선택적 업데이트를 자동으로 적용하도록 도메인을 구성할 수 있습니다. 이 옵션을 켜면 OpenSearch Service는 선택적 업데이트를 사용할 수 있는 시점으로부터 최소 13일을 기다린 다음 7일 후에 업데이트를 예약합니다. 업데이트가 예약되면 콘솔 알림을 받게 되며 나중에 업데이트하도록 일정을 조정할 수 있습니다. 자동 소프트웨어 업데이트를 켜려면 도메인을 만들거나 업데이트할 때 **자동 소프트웨어 업데이트 활성화**를 선택합니다. 를 사용하여 동일한 설정을 구성하려면 도메인을 생성하거나 업데이트할 `true` 때를 `--software-update-options`로 AWS CLI설정합니다. ### 필수 업데이트 필수 서비스 소프트웨어 업데이트에는 일반적으로 도메인의 지속적인 무결성과 기능을 보장하기 위한 중요한 보안 수정 사항이나 기타 필수 업데이트가 포함됩니다. 필수 업데이트 사항으로는 Log4j Common Vulnerabilities and Exposures(CVEs) 및 Instance Metadata Service Version 2(IMDSv2)의 적용 등이 있습니다. 연간 필수 업데이트 횟수는 보통 3회 미만입니다. OpenSearch Service는 이러한 업데이트를 자동으로 예약하고 예약된 업데이트 7일 전에 이메일 및 콘솔 알림을 통해 사용자에게 알립니다. 업데이트를 즉시 적용하거나 *허용된 기간 내에서* 더 적절한 날짜 및 시간으로 업데이트를 다시 예약하도록 선택할 수 있습니다. 도메인의 다음 [사용량이 적은 기간](off-peak.md) 동안 일정을 잡을 수도 있습니다. 필수 업데이트에 대해 아무 조치도 취하지 않고 블루/그린 배포를 야기하는 도메인 변경을 하지 않는 경우 OpenSearch Service는 지정된 기한(일반적으로 사용 가능 후 14일)이 지난 도메인의 사용량이 적은 기간 내에 언제든지 업데이트를 시작할 수 있습니다. 업데이트 예약 여부에 관계없이 [블루/그린 배포](managedomains-configuration-changes.md)를 유발하는 도메인을 변경하면 OpenSearch Service에서 자동으로 도메인을 업데이트합니다. ## 패치 업데이트 “-P”와 숫자로 끝나는 서비스 소프트웨어 버전(예: R20211203-{{P4}})은 패치 릴리스입니다. 패치에는 성능 개선, 사소한 버그 수정, 보안 수정 또는 자세 개선이 포함될 수 있습니다. 패치 릴리스에는 새로운 기능이나 주요 변경 사항이 포함되어 있지 않으며 일반적으로 사용자에게 직접적이거나 눈에 띄는 영향을 미치지 않습니다. 서비스 소프트웨어 알림은 패치 릴리스가 선택 사항인지 필수인지 알려줍니다. ## 고려 사항 도메인 업데이트 여부를 결정할 때는 다음을 고려합니다. + 도메인을 수동으로 업데이트하면 새로운 기능을 더욱 빠르게 활용할 수 있습니다. **업데이트(Update)**를 선택하면 OpenSearch Service가 요청을 대기열에 배치하고 시간이 있을 때 업데이트를 시작합니다. + 서비스 소프트웨어 업데이트를 시작하면 OpenSearch Service는 업데이트가 시작될 때와 완료될 때 알림을 보냅니다. + 소프트웨어 업데이트는 블루/그린 배포를 사용하여 가동 중단을 최소화합니다. 업데이트는 클러스터의 전용 프라이머리 노드에 일시적으로 부담을 줄 수 있으므로 관련 오버헤드를 처리할 수 있는 충분한 용량을 유지해야 합니다. + 업데이트는 일반적으로 몇 분 내에 완료되지만 시스템에 부하가 높은 경우 몇 시간 또는 며칠이 걸릴 수도 있습니다. 업데이트 기간이 길어지지 않도록 구성된 [사용량이 적은 기간](off-peak.md)에 도메인을 업데이트하는 것이 좋습니다. ## 서비스 소프트웨어 업데이트 시작 OpenSearch Service 콘솔, AWS CLI또는 SDKs. ### 콘솔 **서비스 소프트웨어 업데이트 요청** 1. [https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home) Amazon OpenSearch Service 콘솔을 엽니다. 1. 도메인 이름을 선택하여 구성을 엽니다. 1. **실행**, **업데이트**를 선택하고, 다음 옵션 중 하나를 선택합니다. + **지금 업데이트 적용** - *사용 가능한 용량이 있는 경우 *현재 시간에 작업이 수행되도록 즉시 예약합니다. 용량을 사용할 수 없는 경우 선택할 수 있는 다른 시간대를 제공합니다. + **사용량이 적은 기간에 예약** — 도메인에 사용량이 적은 기간을 활성화한 경우에만 사용할 수 있습니다. 도메인에 구성된 사용량이 적은 기간에 업데이트가 수행되도록 예약합니다. 업데이트가 바로 다음 기간에 적용된다는 보장은 없습니다. 용량에 따라 다음 날에 발생할 수 있습니다. 자세한 내용은 [사용량이 적은 기간에 소프트웨어 업데이트 예약](#service-software-offpeak) 단원을 참조하십시오. + **특정 날짜 및 시간 예약** - 특정 날짜 및 시간에 업데이트가 진행되도록 예약합니다. 용량상의 이유로 지정한 시간을 사용할 수 없는 경우 다른 시간대를 선택할 수 있습니다. 업데이트를 나중 날짜(도메인의 사용량이 적은 기간 내 또는 외부)로 예약하는 경우 언제든지 다시 일정을 조정할 수 있습니다. 지침은 [작업 일정 조정](off-peak.md#off-peak-reschedule) 섹션을 참조하세요. 1. **확인**을 선택합니다. ### AWS CLI [start-service-software-update](https://docs.aws.amazon.com/cli/latest/reference/opensearch/start-service-software-update.html) AWS CLI 요청을 보내 서비스 소프트웨어 업데이트를 시작합니다. 이 예제에서는 업데이트를 대기열에 즉시 추가합니다. ``` aws opensearch start-service-software-update \ --domain-name {{my-domain}} \ --schedule-at "NOW" ``` **응답**: ``` { "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 } } ``` **작은 정보** 업데이트를 요청한 후에는 취소할 수 있는 기간 범위가 줄어들 수 있습니다. 이 `PENDING_UPDATE` 상태의 지속 시간은와 OpenSearch Service가 수행하는 동시 업데이트 수 AWS 리전 에 따라 크게 달라질 수 있습니다. 업데이트를 취소하려면 콘솔 또는 `cancel-service-software-update` AWS CLI 명령을 사용합니다. `BaseException`를 통한 요청이 실패하면 용량상의 이유로 지정한 시간을 사용할 수 없으므로 다른 시간을 지정해야 합니다. OpenSearch Service는 응답에서 사용 가능한 대체 시간대를 제안합니다. ### AWS SDKs 이 샘플 Python 스크립트는의 [describe\_domain](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html#OpenSearchService.Client.describe_domain) 및 [start\_service\_software\_update](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html#OpenSearchService.Client.start_service_software_update) 메서드를 AWS SDK for Python (Boto3) 사용하여 도메인이 서비스 소프트웨어 업데이트에 적합한지 확인하고, 적합한 경우 업데이트를 시작합니다. `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) ``` ## 사용량이 적은 기간에 소프트웨어 업데이트 예약 2023년 2월 16일 이후에 생성된 각 OpenSearch Service 도메인에는 현지 시간으로 오후 10시에서 오전 8시 사이의 일일 10시간 기간이 있으며, 이 기간은 [사용량이 적은 기간](off-peak.md)으로 간주됩니다. OpenSearch Service는 이 기간을 사용하여 도메인에 대한 서비스 소프트웨어 업데이트를 예약합니다. 비수기 업데이트는 트래픽이 많은 기간 동안 클러스터의 전용 프라이머리 노드에 가해지는 부담을 최소화하는 데 도움이 됩니다. OpenSearch Service는 사용자의 동의 없이는 이 10시간 기간 외에는 업데이트를 시작할 수 없습니다. + *선택적* 업데이트의 경우 OpenSearch Service에서 업데이트 사용 가능 여부를 알리고 다가오는 사용량이 적은 기간에 업데이트를 예약하라는 메시지를 표시합니다. + *필수* 업데이트의 경우 OpenSearch Service는 다가오는 사용량이 적은 기간에 자동으로 업데이트를 예약하고 3일 전에 알림을 보냅니다. (사용량이 적은 기간 내 또는 이외 기간의 경우) 업데이트를 완료하는 데 필요한 기간 내에만 업데이트 일정을 조정할 수 있습니다. 각 도메인에 대해 기본 오후 10시 시작 시간을 사용자 지정 시간으로 재정의하도록 선택할 수 있습니다. 지침은 [사용량이 적은 사용자 지정 기간 구성](off-peak.md#off-peak-custom) 섹션을 참조하세요. ### 콘솔 **다가오는 사용량이 적은 기간에 업데이트를 예약하려면** 1. [https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home ) Amazon OpenSearch Service 콘솔을 엽니다. 1. 도메인 이름을 선택하여 구성을 엽니다. 1. [**Actions**], [**Update Details**]를 선택합니다. 1. **사용량이 적은 시간에 예약하기**를 선택합니다. 1. **확인**을 선택합니다. **사용량이 적은 기간** 탭에서 예약된 작업을 확인하고 언제든지 일정을 조정할 수 있습니다. [예약된 작업 보기](off-peak.md#off-peak-view)을(를) 참조하세요. ### CLI 를 사용하여 예정된 사용량이 적은 기간 동안 업데이트를 예약하려면 [StartServiceSoftwareUpdate](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_StartServiceSoftwareUpdate.html) 요청을 AWS CLI보내고 `--schedule-at` 파라미터`OFF_PEAK_WINDOW`에를 지정합니다. ``` aws opensearch start-service-software-update \ --domain-name {{my-domain}} \ --schedule-at "OFF_PEAK_WINDOW" ``` ## 서비스 소프트웨어 업데이트 이벤트 모니터링 OpenSearch Service는 서비스 소프트웨어 업데이트를 사용할 수 있거나 필요, 시작, 완료, 실패한 경우 [알림](managedomains-notifications.md)을 전송합니다. OpenSearch Service 콘솔의 **알림(Notifications)** 패널에서 이러한 알림을 확인할 수 있습니다. 알림 심각도는 업데이트가 선택 사항인 경우 `Informational`, 필수인 경우 `High`입니다. 또한, OpenSearch Service는 서비스 소프트웨어 이벤트를 Amazon EventBridge로 보냅니다. EventBridge를 사용하여 이벤트 수신 시 이메일을 보내거나 특정 작업을 수행하는 규칙을 구성할 수 있습니다. 연습 예제는 단원을 참조하십시오[자습서: 사용 가능한 소프트웨어 업데이트에 대한 Amazon SNS 알림 보내기](sns-events.md). Amazon EventBridge로 전송되는 각 서비스 소프트웨어 이벤트 형식은 [서비스 소프트웨어 업데이트 이벤트](monitoring-events.md#monitoring-events-sso) 섹션을 참조하세요. ## 도메인이 업데이트에 적합하지 않은 경우 다음 상태에 있는 도메인은 서비스 소프트웨어 업데이트에 적합하지 않습니다. | 상태 | 설명 | | --- | --- | | 처리 중 상태의 도메인 | 도메인이 구성 변경 도중에 있습니다. 작업이 완료된 후 업데이트 자격을 확인하세요. | | 빨간색 클러스터 상태 | 클러스터에서 하나 이상의 인덱스가 빨간색입니다. 문제 해결 단계는 [빨간색 클러스터 상태](handling-errors.md#handling-errors-red-cluster-status) 섹션을 참조하세요. | | 높은 오류율 | OpenSearch 클러스터가 요청을 처리하려고 시도할 때 다수의 5*xx* 오류를 반환합니다. 이 문제는 일반적으로 너무 많은 동시 읽기 또는 쓰기 요청의 결과입니다. 클러스터로 가는 트래픽을 줄이거나 도메인을 확장할 것을 고려하세요. | | 브레인 분할 | *브레인 분할*은 OpenSearch 클러스터가 여러 개의 프라이머리 노드를 가지고 자체적으로는 절대로 다시 조인되지 않는 2개의 클러스터로 분할되어 있다는 의미입니다. 권장 수의 [전용 프라이머리 노드](managedomains-dedicatedmasternodes.md)를 사용하면 브레인 분할을 방지할 수 있습니다. 브레인 분할로부터 복구하기 위해 도움이 필요하면 [지원](https://console.aws.amazon.com/support/home)에 문의하세요. | | Amazon Cognito 통합 문제 | 도메인은 [OpenSearch Dashboards에 대한 인증](cognito-auth.md)을 사용하며 OpenSearch Services는 하나 이상의 Amazon Cognito 리소스를 찾을 수 없습니다. 이 문제는 보통 Amazon Cognito 사용자 풀이 없는 경우에 발생합니다. 문제를 수정하려면 누락된 리소스를 다시 생성하고 이를 사용하도록 OpenSearch Service 도메인을 구성합니다. | | 기타 서비스 문제 | OpenSearch Service 자체에 문제가 있을 경우 도메인이 업데이트 자격이 없는 것으로 표시될 수 있습니다. 도메인에 이전 조건이 하나도 적용되지 않지만 문제가 하루를 넘게 지속될 경우 [지원](https://console.aws.amazon.com/support/home)에 문의하세요. | ## 서비스 소프트웨어 업데이트 롤백 Amazon OpenSearch Service는 서비스 소프트웨어 업데이트 롤백을 지원합니다. OpenSearch Service 콘솔, AWS CLI또는 AWS SDKs. 소프트웨어 업데이트는 블루/그린 배포를 사용하여 롤백됩니다. **참고** 롤백은 2026년 4월 24일 이후에 적용된 서비스 소프트웨어 업데이트에만 지원됩니다. 엔진 버전 업그레이드는 롤백할 수 없습니다. ### 롤백 자격 및 고려 사항 롤백을 사용하려면 도메인이 다음 조건을 모두 충족해야 합니다. + **도메인이 활성** 상태임 - 도메인이 `Active` 상태여야 합니다. 구성 변경, 소프트웨어 업데이트 또는 기타 블루/그린 배포가 진행되는 동안에는 롤백을 사용할 수 없습니다. + **롤백 기간 내** - 소프트웨어 업데이트가 허용된 롤백 기간 내에 적용되어야 합니다. [롤백 기간](#service-software-rollback-windows)을(를) 참조하세요. + **업데이트 후 구성 변경 없음** - 소프트웨어 업데이트가 적용된 후 도메인을 구성 변경한 경우 롤백이 차단됩니다. 구성 변경은 이전 소프트웨어 버전과 호환되지 않는 방식으로 도메인 설정에 영향을 미칠 수 있습니다. 예를 들어 인스턴스 유형을 변경하거나, 복제본을 활성화하거나, 업데이트 후 스토리지 설정을 조정하면 롤백이 차단됩니다. + **서비스에서 업데이트를 자동으로 적용하지 않음 -** 30일 가용성 기간 내에 필수 업데이트에 대해 조치를 취하지 않았고 OpenSearch Service가 업데이트를 자동으로 적용한 경우 해당 업데이트에 롤백을 사용할 수 없습니다. + **업데이트가 엔진 버전 업그레이드가 아님** - 엔진 버전 변경(예: OpenSearch 1.3에서 OpenSearch 2.11로 업그레이드)은 되돌릴 수 없습니다. 서비스 소프트웨어 버전 롤백만 지원됩니다. + **이전 소프트웨어 버전이 있음** - 롤백은이 기능이 정식 출시(GA)된 후에 적용된 소프트웨어 업데이트에만 사용할 수 있습니다. GA 이후 아직 소프트웨어 업데이트를 거치지 않은 도메인에는 롤백할 이전 버전이 없습니다. + **업데이트당 하나의 롤백만 허용됨** - 롤백이 완료되면 도메인이 롤백 상태로 간주됩니다. 새 소프트웨어 업데이트가 성공적으로 적용될 때까지 다시 롤백할 수 없습니다. + **소프트웨어 업데이트가 명시적으로 시작됨** - 롤백은 소프트웨어 업데이트가 사용자가 명시적으로 시작했거나 필수 또는 선택적 업데이트의 일부로 OpenSearch Service에서 자동으로 예약한 경우에만 사용할 수 있습니다. 다음과 같은 경우에는 롤백을 사용할 수 없습니다. + 구성 변경에 의해 트리거된 블루/그린 배포 중에 소프트웨어 업데이트가 적용되었습니다. 여기에는 구성 변경과 함께 최신 소프트웨어 업데이트를 번들링하는 `UseLatestServiceSoftwareForBlueGreen` 설정이 활성화된 경우가 포함됩니다. 이 설정을 비활성화할 수 있습니다. + 업데이트는 도메인의 상태와 가용성을 유지하기 위해 OpenSearch Service에서 수행하는 인프라 복구, 자동 문제 해결 또는 기타 내부 작업과 같이 도메인에서 서비스 시작 유지 관리 작업 중에 적용되었습니다. ### 롤백 기간 롤백 기간은 적용된 소프트웨어 업데이트 유형에 따라 다릅니다. | 업데이트 유형 | 롤백 기간 | 참고 | | --- | --- | --- | | 선택 사항 | 업데이트가 적용된 날짜로부터 15일 | 업데이트를 수동으로 적용했는지, 예약된지 또는 사용량이 적은 시간에 자동으로 적용되었는지 여부를 적용합니다. | | 필수 | 업데이트가 적용된 날짜로부터 15일 | 30일 가용성 기간 내에 업데이트를 직접 적용한 경우에만 사용할 수 있습니다. 서비스가 기한 이후에 업데이트를 자동으로 적용한 경우 롤백을 사용할 수 없습니다. | 롤백 기간이 만료되면 셀프 서비스 롤백을 더 이상 사용할 수 없습니다. 창이 닫힌 후 중요한 문제가 발생하는 [지원](https://console.aws.amazon.com/support/home) 경우에 문의하세요. ### 롤백을 요청하는 방법 `RollbackServiceSoftwareUpdate` API를 사용하여 롤백을 요청할 수 있습니다. #### 요청 ``` POST /2021-01-01/opensearch/serviceSoftwareUpdate/rollback ``` 요청 본문: ``` { "DomainName": "{{your-domain-name}}" } ``` #### 응답 API는 오류가 아닌 모든 경우에 HTTP 200 응답을 반환합니다. 응답 본문의 `RollbackAvailable` 필드는 롤백이 시작되었는지 여부를 나타냅니다. ``` { "RollbackServiceSoftwareOptions": { "CurrentVersion": "string", "NewVersion": "string", "RollbackAvailable": boolean, "Description": "string" } } ``` 응답 필드: | Field | Type | 설명 | | --- | --- | --- | | CurrentVersion | 문자열 | 도메인에서 현재 실행 중인 소프트웨어 버전입니다. | | NewVersion | 문자열 | 도메인이 롤백될 소프트웨어 버전입니다. 롤백을 사용할 수 없는 경우 null을 반환합니다. | | RollbackAvailable | 부울 | `true` 롤백이 성공적으로 시작된 경우. 도메인이 롤백에 적합하지 않은 `false` 경우. | | Description | 문자열 | 결과 또는 롤백을 사용할 수 없는 이유를 설명하는 사람이 읽을 수 있는 메시지입니다. | #### 오류 응답 | 오류 | 설명 | | --- | --- | | ResourceNotFoundException | 지정된 도메인이 존재하지 않습니다. | | ValidationException | 도메인이 활성 상태가 아닙니다. 재시도하기 전에 진행 중인 변경 사항이 완료될 때까지 기다립니다. | | InternalException | 서비스에 내부 오류가 발생했습니다. 요청을 다시 시도하세요. | | DisabledOperationException | 롤백 작업은이 도메인에서 지원되지 않습니다. | #### 응답 메시지 다음 표에서는 `RollbackServiceSoftwareUpdate` API에서 반환할 수 있는 응답 메시지를 설명합니다. | 사례 | 설명 | | --- | --- | | Success | 롤백이 성공적으로 시작되었습니다. 도메인은 {{현재 버전}}에서 {{이전 버전으로}} 롤백됩니다. | | 기능이 활성화되지 않음 | 롤백을 사용할 수 없습니다. 도움이 필요하면 [지원](https://console.aws.amazon.com/support/home)에 문의하세요. | | 이전 소프트웨어를 사용할 수 없음 | 롤백에 사용할 수 있는 이전 소프트웨어 버전이 없습니다. 도움이 필요하면 [지원](https://console.aws.amazon.com/support/home)에 문의하세요. | | 이전 소프트웨어가 현재 소프트웨어와 동일함 | 롤백을 사용할 수 없습니다. 롤백에 사용할 수 있는 이전 소프트웨어 버전이 없습니다. 도움이 필요하면 [지원](https://console.aws.amazon.com/support/home)에 문의하세요. | | 도메인이 이미 롤백되었습니다. | 도메인이 이미 롤백 상태입니다. | | 클러스터가 고정된 소프트웨어 버전에 있음 | 소프트웨어 재정의는 현재 도메인에 적용됩니다. | | 기간을 벗어남 | 롤백을 사용할 수 없습니다. 15일 롤백 기간이 만료되었습니다. 도움이 필요하면 [지원](https://console.aws.amazon.com/support/home)에 문의하세요. | | 필수 서비스 업데이트 자동 적용 | 롤백을 사용할 수 없습니다. 현재 버전은 필수 서비스 업데이트를 통해 적용되었습니다. 도움이 필요하면 [지원](https://console.aws.amazon.com/support/home)에 문의하세요. | | 엔진 버전 업그레이드 | 롤백을 사용할 수 없습니다. 엔진 버전 업그레이드는 되돌릴 수 없습니다. 도움이 필요하면 [지원](https://console.aws.amazon.com/support/home)에 문의하세요. | | 업데이트 후 구성이 변경됨 | 롤백을 사용할 수 없습니다. 마지막 소프트웨어 업데이트 이후 클러스터 구성이 변경되었습니다. 도움이 필요하면 [지원](https://console.aws.amazon.com/support/home)에 문의하세요. | **응답 예제:** ``` { "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." } } ``` 롤백을 사용할 수 없는 경우는를 `RollbackAvailable` 반환`false`하고 `Description` 필드에는 위 표의 이유가 포함됩니다.