유지보수 기간 찾기 및 설정

MySQL | PostgreSQL | SQL Server

이 페이지는 Cloud SQL 인스턴스의 유지보수 기간을 찾고 설정하는 절차를 제공합니다. Cloud SQL이 유지보수를 수행하는 방법과 이유에 대한 자세한 내용은 Cloud SQL 인스턴스의 유지보수 개요를 참조하세요.

유지보수 알림 수신을 선택한 경우 Cloud SQL 인스턴스에 유지보수 업데이트를 사용할 수 있으면 Cloud SQL에서 이메일 알림을 보냅니다. Cloud SQL은 유지보수 출시 전에 알림을 보낸 다음 주간 일정에 따라 업데이트를 인스턴스 그룹에 적용합니다. 인스턴스 유지보수 시점을 선택하여 인스턴스에서 유지보수 업데이트를 수신하기 전에 수신하는 사전 알림의 양을 제어할 수 있습니다.

유지보수 업데이트 시간을 예약하는 옵션은 다음과 같습니다.

Any를 선택하거나 이 설정을 구성하지 않으면 언제든지 유지보수 업데이트가 진행될 수 있지만 일반적으로 출시 후 첫 주 이내에 진행됩니다.
Week 1(preview 및 canary라고도 함)을 선택하면 유지보수 알림이 전송된 지 7~14일 후에 유지보수 업데이트가 진행됩니다.
Week 2(production 및 stable이라고도 함)를 선택하면 알림이 전송된 지 15~21일 후에 유지보수 업데이트가 진행됩니다.
Week 5를 선택하면 알림이 전송된 지 35~42일 후에 유지보수 업데이트가 진행됩니다.

인스턴스 유지보수가 이미 진행 중이거나 예약된 상태에서 유지보수 기간 설정을 변경하면 변경사항이 즉시 적용되지 않습니다. 이러한 변경사항은 향후 유지보수 이벤트에 반영됩니다.

시작하기 전에

Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

Google Cloud CLI를 설치합니다.

gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

Google Cloud CLI를 설치합니다.

gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

gcloud init

인스턴스 유지보수 기간 설정

Console

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
유지보수 섹션에서 유지보수 환경설정 수정을 클릭합니다.
구성 옵션 섹션에서 유지보수를 엽니다.
다음 옵션을 구성합니다.
- 유지보수 시점. 주를 선택하여 자동 유지보수 업데이트를 적용합니다. 다음과 같은 옵션이 있습니다.
  - 모두: 유지보수 업데이트가 언제든지 진행될 수 있지만 일반적으로 1주 차 내에 진행됩니다.
  - 1주 차: 유지보수 알림이 전송된 지 7~14일 후에 유지보수가 진행됩니다.
  - 2주 차: 알림이 전송된 지 15~21일 후에 유지보수 업데이트가 진행됩니다.
  - 5주 차: 알림이 전송된 지 35~42일 후에 유지보수 업데이트가 진행됩니다.
- 유지보수 범위. 원하는 요일과 기간을 선택합니다. 옵션은 다음과 같습니다.
  - 시스템 자동 선택 기간: 기본 유지보수 기간입니다. 유지보수 업데이트는 특정 요일이나 시간으로 제한되지 않습니다.
  - 요일: 토요일, 일요일, 월요일, 화요일, 수요일, 목요일 또는 금요일 유지보수 기간 요일을 선택합니다.
  - 시간: 요일을 선택한 경우 시간을 선택할 수도 있습니다. 현지 시간대에서 1시간 간격을 선택합니다.

gcloud

Cloud SQL에서 유지보수 기간과 유지보수 시점을 구성하려면 다음 명령어를 실행합니다.

gcloud sql instances patch INSTANCE_ID \
  --maintenance-window-day=DAY \
  --maintenance-window-hour=HOUR \
  --maintenance-release-channel=MAINTENANCE_TIMING

다음 변수를 바꿉니다.

INSTANCE_ID: 읽기 복제본 인스턴스일 수 있는 인스턴스 ID입니다.
DAY: 유지보수를 진행할 요일입니다. MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY 또는 SUNDAY로 설정합니다. UTC 시간대로 지정합니다.
HOUR: 유지보수 기간 시간(0~23)입니다. UTC 시간대로 지정합니다.
MAINTENANCE_TIMING: 유지보수 업데이트를 적용할 유지보수 출시 기간(주)입니다. 옵션은 다음과 같습니다.

preview: 유지보수 알림이 전송된 후 1주 차로 변환됩니다. 유지보수 업데이트는 알림 후 7~14일 사이에 예약됩니다.
production: 유지보수 알림이 전송된 후 2주 차로 변환됩니다. 유지보수 업데이트는 알림 후 15~21일 사이에 예약됩니다.
week5: 유지보수 업데이트는 유지보수 알림이 전송된 지 35~42일 후에 예약됩니다.

참조 정보는 gcloud sql instances patch를 확인하세요.

REST v1

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트의 ID 또는 프로젝트 번호입니다.
INSTANCE_ID: 읽기 복제본 인스턴스일 수 없는 인스턴스 ID입니다.
HOUR: 유지보수 기간 시간(0~23)입니다. UTC 시간대로 지정합니다.
DAY: 유지보수 업데이트를 진행할 요일입니다. MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY 또는 SUNDAY를 지정합니다. UTC 시간대로 지정합니다.
MAINTENANCE_TIMING: 유지보수 업데이트를 적용할 유지보수 출시 기간(주)입니다. 옵션은 다음과 같습니다.
- canary: 유지보수 알림이 전송된 후 1주 차로 변환됩니다. 유지보수 업데이트는 알림 후 7~14일 사이에 예약됩니다.
- stable: 유지보수 알림이 전송된 후 2주 차로 변환됩니다. 유지보수 업데이트는 알림 후 15~21일 사이에 예약됩니다.
- week5: 유지보수 업데이트는 유지보수 알림이 전송된 지 35~42일 후에 예약됩니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 요청 본문:

{
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트의 ID 또는 프로젝트 번호입니다.
INSTANCE_ID: 읽기 복제본 인스턴스일 수 없는 인스턴스 ID입니다.
HOUR: 유지보수 기간 시간(0~23)입니다. UTC 시간대로 지정합니다.
DAY: 유지보수 업데이트를 진행할 요일입니다. MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY 또는 SUNDAY를 지정합니다. UTC 시간대로 지정합니다.
MAINTENANCE_TIMING: 유지보수 업데이트를 적용할 유지보수 출시 기간(주)입니다. 옵션은 다음과 같습니다.
- canary: 유지보수 알림이 전송된 후 1주 차로 변환됩니다. 유지보수 업데이트는 알림 후 7~14일 사이에 예약됩니다.
- stable: 유지보수 알림이 전송된 후 2주 차로 변환됩니다. 유지보수 업데이트는 알림 후 15~21일 사이에 예약됩니다.
- week5: 유지보수 업데이트는 유지보수 알림이 전송된 지 35~42일 후에 예약됩니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 요청 본문:

{
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

유지보수 알림 수신 동의

유지보수 알림 수신을 선택하려면 먼저 인스턴스 유지보수 기간을 설정해야 합니다.

커뮤니케이션 페이지로 이동합니다. 커뮤니케이션으로 이동
Cloud SQL, 유지보수 기간 행에서 이메일 아래에 있는 라디오 버튼을 선택하여 사용으로 전환합니다.

알림을 수신해야 하는 각 사용자는 별도로 선택해야 합니다.

Google Cloud 콘솔에서 유지보수 알림 찾기

Google Cloud 콘솔의 여러 곳에서 유지보수 알림을 확인할 수 있습니다.

활동 대시보드에서 SQL 유지보수로 표시된 인스턴스를 찾습니다.
활동으로 이동
인스턴스 유지보수가 예약되면 유지보수 열의 인스턴스 페이지에 유지보수 날짜가 나열됩니다. 유지보수 열은 대개 표시되지 않지만 유지보수가 예약되면 자동으로 표시됩니다. 또한 유지보수 열을 항상 표시하려면 열 표시 옵션()에서 유지보수를 선택하면 됩니다.
또는 인스턴스를 선택하여 인스턴스 세부정보 페이지로 이동할 수 있습니다. 인스턴스 유지보수가 예약되면 유지보수 창에 메시지가 표시됩니다.
Cloud SQL 인스턴스로 이동

API를 사용하여 예약된 유지보수 찾기

gcloud

예약된 다음 유지보수를 확인하려면 다음 명령어를 사용합니다.

gcloud sql instances describe INSTANCE_ID

다음 변수를 바꿉니다.

INSTANCE_ID: 예약된 유지보수를 확인할 인스턴스입니다.

응답에서 scheduledMaintenance 섹션을 찾습니다.

REST v1

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
INSTANCE_NAME: 고가용성으로 구성하려는 인스턴스의 이름

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

응답에서 scheduledMaintenance 섹션을 찾습니다.

REST v1beta4

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
INSTANCE_NAME: 고가용성으로 구성하려는 인스턴스의 이름

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

응답에서 scheduledMaintenance 섹션을 찾습니다.

예정된 유지보수 일정 변경

Google Cloud 콘솔, gcloud CLI또는 Cloud SQL Admin API를 사용하여 유지보수 일정을 변경할 수 있습니다.

인스턴스 유지보수 시점을 1주 차 또는 2주 차로 설정하면 유지보수 일정을 최대 28일까지 변경할 수 있습니다.

인스턴스 유지보수 시점을 5주 차로 설정하면 유지보수 일정을 최대 7일까지 변경할 수 있습니다. 다음 분기별 유지보수 출시가 시작되기 전에 인스턴스에서 유지보수 업데이트를 받을 수 있도록 유지보수 일정을 이 기간 내로 변경해야 합니다.

Console

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
유지보수라는 용어로 필터링하여 유지보수가 예약된 모든 인스턴스를 나열합니다.
유지보수 열에서 일정 변경을 클릭합니다.
일정 변경 대화상자에서 유지보수를 즉시 적용하거나 계획된 유지보수 일정 변경에 정의된 대로 허용된 연기 기간 내 특정 시간에 실행되도록 일정을 변경하거나 사용 가능한 다음 유지보수 기간으로 연기할지를 선택합니다.

gcloud

Cloud SQL 인스턴스 유지보수 일정을 변경하려면 다음 명령어를 실행합니다.

gcloud sql reschedule-maintenance INSTANCE_ID \
  --reschedule-type=RESCHEDULE_TYPE \
  [--schedule-time=RESCHEDULE_TIME]

다음 변수를 바꿉니다.

INSTANCE_ID: 일정을 변경할 인스턴스입니다.
RESCHEDULE_TYPE: IMMEDIATE, NEXT_AVAILABLE_WINDOW 또는 SPECIFIC_TIME 중 하나를 사용합니다.
NEXT_AVAILABLE_WINDOW를 선택하면 유지보수 일정이 현재 예약된 시간에 따라 사용 가능한 다음 유지보수 기간으로 변경됩니다.
RESCHEDULE_TIME: RESCHEDULE_TYPE에 SPECIFIC_TIME를 지정하면 --schedule-time 플래그도 설정하여 유지보수가 진행될 새 날짜와 시간을 지정해야 합니다. ISO 8601 형식을 사용합니다. 예를 들면 2020-01-16T16:56:00.000Z입니다.

참조 정보는 gcloud sql reschedule-maintenance를 확인하세요.

최대 28일 동안 유지보수 일정을 변경하려면 gcloud의 버전 번호를 확인하세요. 버전 번호가 390.0.0_RC00 미만이면 gcloud를 다시 설치합니다.

REST v1

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: 프로젝트 ID
INSTANCE_ID: 인스턴스 ID
RESCHEDULE_TYPE: IMMEDIATE, NEXT_AVAILABLE_WINDOW 또는 SPECIFIC_TIME 중 하나를 사용합니다.
NEXT_AVAILABLE_WINDOW를 선택하면 유지보수 일정이 사용 가능한 다음 유지보수 기간으로 변경됩니다.

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance

JSON 요청 본문:

{
  "reschedule": {
    "reschedule_type": "RESCHEDULE_TYPE"
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance
"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance
" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": RESCHEDULE_MAINTENANCE,
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: 프로젝트 ID
INSTANCE_ID: 인스턴스 ID
RESCHEDULE_TYPE: IMMEDIATE, NEXT_AVAILABLE_WINDOW 또는 SPECIFIC_TIME 중 하나를 사용합니다.
NEXT_AVAILABLE_WINDOW를 선택하면 유지보수 일정이 사용 가능한 다음 유지보수 기간으로 변경됩니다.

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance

JSON 요청 본문:

{
  "reschedule": {
    "reschedule_type": "RESCHEDULE_TYPE"
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance
"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance
" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": RESCHEDULE_MAINTENANCE,
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

이 태스크와 관련된 기본 REST API 요청이 생성되는 방식을 확인하려면 instances:post 페이지의 API 탐색기를 참조하세요.

유지보수 거부 기간 구성

Cloud SQL 인스턴스에서 언제든지 최대 1개의 유지보수 거부 기간을 구성할 수 있습니다. 유지보수 거부 기간이 예약된 유지보수 기간보다 우선 적용됩니다. 유지보수 기간과 유지보수 거부 기간 사이에 충돌이 있으면 유지보수 거부 기간이 유지보수 기간을 재정의합니다.

유지보수 거부가 시작되었든 아니든 유지보수 거부 기간을 수동으로 삭제할 수 있습니다.

유지보수 거부 기간을 구성하려면 해당 기간의 시작일, 종료일, 그리고 간격 시작 및 종료 시간을 설정합니다. 유지보수 거부 기간은 1~90일입니다.

시작일 및 종료일에는 다음 두 가지 형식이 있습니다.

yyyy-mm-dd: 특정 날짜를 나타냅니다.
mm-dd: 매년 반복되는 날짜를 나타냅니다.

시작일 및 종료일은 UTC입니다. 시간대를 설정하려면 시간 필드를 사용하여 시작 시간을 조정합니다. 예를 들어 시작일 = 2020-10-10 및 시간 = 07:00:00은 시작 시간 2020-10-10 07:00:00 UTC(2020-10-10 00:00:00 PST)를 나타냅니다.

이번에는 시간 형식이 HH:mm:SS입니다.

시간은 0~23(포함) 사이입니다.
분과 초는 0에서 59(포함) 사이입니다.

콘솔

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
유지보수 섹션에서 유지보수 환경설정 수정을 클릭합니다.
유지보수 거부 기간 섹션에서 시작일 및 종료일을 설정합니다.
고급 옵션 섹션에서 원하는 경우 매년 반복을 선택합니다.
저장을 클릭합니다.

gcloud

Cloud SQL 인스턴스 유지보수 거부 기간을 구성하려면 다음 명령어를 실행합니다.

gcloud sql instances patch INSTANCE_ID\
   --deny-maintenance-period-start-date=START_DATE \
   --deny-maintenance-period-end-date=END_DATE \
   --deny-maintenance-period-time=TIME

다음 변수를 바꿉니다.

INSTANCE_ID: Cloud SQL 인스턴스 ID
START_DATE: 간격이 시작되는 날짜입니다. 예를 들면 2021-11-29입니다.
END_DATE: 간격이 종료되는 날짜입니다. 예를 들면 2021-12-02입니다.
TIME: 간격이 시작되고 종료되는 시간입니다. 예를 들면 00:00:00입니다.

REST v1

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
instance-id: 인스턴스 ID
start-date: 매년 반복되는 시작일(yyyy-mm-dd) 또는 (mm-dd)
end-date: 매년 반복되는 종료일(yyyy-mm-dd) 또는 (mm-dd)
time: 시작 및 종료 시간(HH:mm:SS)

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

JSON 요청 본문:

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
instance-id: 인스턴스 ID
start-date: 매년 반복되는 시작일(yyyy-mm-dd) 또는 (mm-dd)
end-date: 매년 반복되는 종료일(yyyy-mm-dd) 또는 (mm-dd)
time: 시작 및 종료 시간(HH:mm:SS)

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 요청 본문:

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

유지보수 거부 기간 삭제

콘솔

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
유지보수 섹션에서 유지보수 환경설정 수정을 클릭합니다.
유지보수 기간 거부 섹션에서 삭제를 클릭합니다.
저장을 클릭합니다.

gcloud

Cloud SQL 인스턴스에서 유지보수 거부 기간을 삭제하려면 다음 명령어를 실행합니다.

gcloud sql instances patch INSTANCE_ID \
--remove-deny-maintenance-period

다음 변수를 바꿉니다.

INSTANCE_ID: Cloud SQL 인스턴스 ID

REST v1

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
instance-id: 인스턴스 ID

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

JSON 요청 본문:

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
instance-id: 인스턴스 ID

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 요청 본문:

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

유지보수 거부 기간 알림

계획된 유지보수 시간이 유지보수 거부 기간에 포함되면 유지보수 기간 알림은 전송되지 않으며 유지보수 거부 기간 설정으로 인해 금지됩니다.

이전에 예약된 시간에 유지보수가 진행되지 않도록 유지보수 거부 기간 설정을 변경하면 Cloud SQL 인스턴스에서 유지보수를 건너뛰고 유지보수 취소에 대한 알림을 보냅니다. Cloud SQL은 인스턴스 업데이트가 예약될 때마다 이 취소 알림을 보냅니다.

계획된 유지보수 알림은 유지보수 거부 기간 중에 전송됩니다(이러한 유지보수가 해당 기간을 벗어나 발생하도록 예약된 경우).

유지보수 기간 찾기 및 설정

시작하기 전에

인스턴스 유지보수 기간 설정

Console

gcloud

REST v1

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

REST v1beta4

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

유지보수 알림 수신 동의

Google Cloud 콘솔에서 유지보수 알림 찾기

API를 사용하여 예약된 유지보수 찾기

gcloud

REST v1

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

REST v1beta4

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

예정된 유지보수 일정 변경

Console

gcloud

REST v1

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

REST v1beta4

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

유지보수 거부 기간 구성

콘솔

gcloud

REST v1

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

REST v1beta4

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

유지보수 거부 기간 삭제

콘솔

gcloud

REST v1

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

REST v1beta4

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

유지보수 거부 기간 알림

다음 단계