Rolling Upgrade Cluster
- 인쇄
- PDF
Rolling Upgrade Cluster
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VPC 환경에서 이용 가능합니다.
설명
OpenSearch Version을 Rolling 방식으로 업그레이드합니다.
주의
업그레이드 진행 전 필수 체크 사항은 다음과 같습니다.
- RollingUpgradePreCheck를 반드시 먼저 진행해 주십시오.
- RollingUpgrade 진행 시 최소 6시간 또는 실행 직전 스냅샷을 생성해 주십시오.
- SnapShot으로 백업하지 않고 Upgrade하는 과정에서 사용자 데이터 유실이 발생하는 경우, 복구가 불가능하므로 주의하여 진행해 주십시오.
요청
요청 URL
POST https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/cluster/rollingUpgradeCluster [수도권]
POST https://vpcsearchengine.apigw.gov-ntruss.com/api/krs-v2/cluster/rollingUpgradeCluster [남부권]
요청 헤더
| 헤더명 | 설명 |
|---|---|
| x-ncp-apigw-timestamp | - 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타냄 - API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 x-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값x-ncp-iam-access-key:{Account Access Key} |
| x-ncp-apigw-signature-v2 | Access Key ID 값과 Secret Key로 암호화한 서명x-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type | Request body content type을 application/json으로 지정Content-Type: application/json |
요청 파라미터
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| targetVersionCode | String | Y | 업그레이드할 Application 의 Version Code |
| ServiceGroupInstanceNo | String | Y | 대상 Cluster의 번호 |
요청 예시
POST https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/cluster/rollingUpgradeCluster
HOST: vpcsearchengine.apigw.gov-ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: Qj8Jowjqu3MRMyEk/NKdagftTL/5/VhBJkTv1XKCMGQ=
x-ncp-apigw-timestamp: 1709700150235
x-ncp-iam-access-key: ANJNnR1jz1gUzaiS0aV2
{
"serviceGroupInstanceNo": "3427188",
"targetVersionCode": "2111"
}
curl -X 'POST' \
'https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/cluster/rollingUpgradeCluster' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-ncp-iam-access-key: ANJNnR1jz1gUzaiS0aV2' \
-H 'x-ncp-apigw-timestamp: 1709700150235' \
-H 'x-ncp-apigw-signature-v2: Qj8Jowjqu3MRMyEk/NKdagftTL/5/VhBJkTv1XKCMGQ=' \
-d '{
"serviceGroupInstanceNo": "3427188",
"targetVersionCode": "2111"
}'
응답
응답 예시
버전 업그레이드 진행이 가능한 경우
다음 단계로 진행이 가능합니다.
{
"code": 0,
"message": "SUCCESS",
"result": true,
"requestId": "1a8954a8-fd75-46e1-bc73-568e96c6d48c"
}
TargetVersionCode 가 잘못된 경우
getSearchEngineVersionList API를 통해 searchEngineVersionCode를 재확인 후 요청해 주십시오.
{
"code": 10154,
"message": "잘못된 클러스터 버전입니다. 재 확인 하세요",
"result": null,
"requestId": "305653e0-4bf7-4f8b-8acd-3d719815b273"
}
이 문서가 도움이 되었습니까?