이 문서에서는 AI Hypercomputer에서 사용할 수 있는 호스트 유지관리 기능을 사용하는 방법을 설명합니다. 예약된 용량 블록을 모니터링하고, 계획하고, 예약된 유지보수를 실행하는 방법을 설명합니다. Compute Engine 인스턴스의 유지보수를 관리하려면 대신 컴퓨팅 인스턴스 전반에서 호스트 이벤트 관리를 참고하세요.
인스턴스가 실행 중인지 여부와 관계없이 예약된 용량 블록에서 예정된 유지보수 호스트 이벤트를 사전 대응 방식으로 관리할 수 있습니다. 이 방법을 사용하면 중단을 최소화하고 최적의 성능을 유지할 수 있습니다.
시작하기 전에
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
Google Cloud CLI를 설치합니다. 설치 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.
gcloud init외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.
필요한 역할
예약 전반에서 호스트 유지관리 이벤트를 관리하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.
-
프로젝트에 대한 Compute 관리자(
roles/compute.admin) -
시스템 이벤트 감사 로그에 대한 읽기 전용 액세스의 경우:
프로젝트에 대한 로그 뷰어 (
roles/logging.viewer)
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이러한 사전 정의된 역할에는 예약 전반에서 호스트 유지보수 이벤트를 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
예약 전반에서 호스트 유지보수 이벤트를 관리하려면 다음 권한이 필요합니다.
-
예약의 호스트 유지보수를 시작하려면 프로젝트에 대한
compute.reservations.performMaintenance권한이 있어야 합니다. -
예약 블록의 호스트 유지보수를 시작하려면 프로젝트에 대한
compute.reservationBlocks.performMaintenance권한이 있어야 합니다. -
예약 하위 블록의 호스트 유지보수를 시작하려면 프로젝트에 대한
compute.reservationSubBlocks.performMaintenance권한이 있어야 합니다. -
예약 목록 보기: 프로젝트에 대한
compute.reservations.list권한 -
예약의 세부정보 보기:
프로젝트에 대한
compute.reservations.get권한 -
예약 내 블록 목록 보기: 프로젝트에 대한
compute.reservationBlocks.list권한 -
예약 블록 내의 하위 블록 목록을 보려면 프로젝트에 대한
compute.reservationSubBlocks.list권한이 필요합니다.
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
개요
아직 검토하지 않았다면 호스트 유지보수 이해 및 처리를 검토하세요.
예약된 용량 블록의 유지보수를 최적화하려면 다음 단계를 완료하세요.
알림 설정 예약, 예약 블록 또는 예약 하위 블록의 예약된, 시작된 또는 완료된 유지보수 이벤트에 대한 알림을 받으려면 로그 기반 알림을 만드세요. 이 접근 방식을 사용하면 활동을 사전 대응 방식으로 계획하고 예기치 않은 다운타임을 방지할 수 있습니다.
용량 블록 전반에서 유지보수 관리 예약, 예약 블록 또는 예약 하위 블록에서 유지보수를 확인하고 필요한 경우 수동으로 시작합니다. 이 프로세스를 통해 호스트 오류에 대한 워크로드의 복원력을 높이고, 다운타임을 방지하고, 애플리케이션의 가용성을 유지할 수 있습니다.
예약 알림 설정
로그 기반 알림 정책을 만들어 예약, 예약 블록 또는 예약 하위 블록의 예약된, 시작된 또는 완료된 유지보수 이벤트에 대한 알림을 받을 수 있습니다.
예약, 예약 블록 또는 예약 하위 블록의 유지보수 이벤트에 대한 알림을 만들려면 다음 절차를 완료하세요. 만들려는 각 알림에 대해 이 절차를 반복합니다.
-
Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Logging인 결과를 선택합니다.
쿼리 표시 전환 버튼을 클릭하여 설정 위치로 전환합니다.
쿼리 창에서 다음 쿼리 중 하나를 빌드합니다. 이러한 쿼리는 로그 항목을 필터링하여 특정 유지보수 이벤트를 식별합니다. 만들려는 각 쿼리에 대해 이 절차를 반복합니다.
예약에 대한 유지보수 알림 수신:
유지보수가 예약될 때 알림을 받으려면 다음 단계를 따르세요.
protoPayload.methodName="compute.reservations.upcomingGroupMaintenance" severity>=DEFAULT protoPayload.status.message =~ "scheduled"유지보수가 완료되면 알림을 받으려면 다음 단계를 따르세요.
protoPayload.methodName="compute.reservations.completedGroupMaintenance" severity>=DEFAULT protoPayload.status.message =~ "completed"
예약 블록에 대한 유지보수 알림 수신:
유지보수가 예약될 때 알림을 받으려면 다음 단계를 따르세요.
protoPayload.methodName="compute.reservations.block.upcomingGroupMaintenance" severity>=DEFAULT protoPayload.status.message =~ "scheduled"유지보수가 시작될 때 알림을 받으려면 다음 단계를 따르세요.
protoPayload.methodName="compute.reservations.block.startGroupMaintenance" severity>=DEFAULT protoPayload.status.message =~ "started"유지보수가 완료되면 알림을 받으려면 다음 단계를 따르세요.
protoPayload.methodName="compute.reservations.block.completedGroupMaintenance" severity>=DEFAULT protoPayload.status.message =~ "completed"
A4X Max 또는 A4X 인스턴스의 예약 하위 블록에 대한 유지보수 알림 수신:
유지보수가 예약될 때 알림을 받으려면 다음 단계를 따르세요.
protoPayload.methodName="compute.reservations.subBlock.upcomingGroupMaintenance" severity>=DEFAULT protoPayload.status.message =~ "scheduled"유지보수가 시작될 때 알림을 받으려면 다음 단계를 따르세요.
protoPayload.methodName="compute.reservations.subBlock.startGroupMaintenance" severity>=DEFAULT protoPayload.status.message =~ "started"유지보수가 완료되면 알림을 받으려면 다음 단계를 따르세요.
protoPayload.methodName="compute.reservations.subBlock.completedGroupMaintenance" severity>=DEFAULT protoPayload.status.message =~ "completed"A4X Max 또는 A4X 머신에 오류가 발생하고 Compute Engine에서 유지보수를 시작할 때 알림을 받으려면 다음 단계를 따르세요.
protoPayload.methodName="compute.reservations.subblock.unusedmachinerepair" severity>=DEFAULT protoPayload.status.message =~ "maintenance"오류가 발생한 A4X Max 또는 A4X 머신의 유지보수가 완료되면 알림을 받으려면 다음 단계를 따르세요.
protoPayload.methodName="compute.reservations.subblock.unusedmachinerepaircomplete" severity>=DEFAULT protoPayload.status.message =~ "repaired"
쿼리를 검사하려면 쿼리 실행을 클릭합니다. 쿼리가 유효하면 쿼리 결과 창에 쿼리와 일치하는 로그 항목이 표시됩니다.
쿼리 결과 툴바에서 작업 목록을 클릭한 후 로그 알림 만들기를 선택합니다. 로그 기반 알림 정책 만들기 창이 표시됩니다.
알림 세부정보 섹션에서 다음을 수행합니다.
알림 정책 이름 필드에 정책 이름을 입력합니다.
정책 심각도 수준 목록에서 경고 (또는 더 높은 심각도)를 선택합니다.
다음을 클릭합니다.
알림에 포함할 로그 선택 섹션에서 다음을 클릭합니다.
알림 빈도 및 자동 종료 기간 설정 섹션에서 다음을 지정합니다.
알림 간 시간 목록에서 알림을 받을 빈도를 선택합니다.
사고 자동 종료 기간 목록에서 Cloud Logging이 알림 전송을 중지하고 사고를 자동으로 종료하는 기간을 선택합니다.
다음을 클릭합니다.
알림 수신 대상 섹션에서 로깅이 알림을 보낼 알림 채널을 지정합니다.
저장을 클릭합니다.
예약 전반에서 유지보수 관리
예약, 예약 블록, 예약 하위 블록의 유지보수는 다음과 같이 확인하고 제어할 수 있습니다.
예약, 예약 블록 또는 예약 하위 블록의 예정된 유지보수 상태와 시간을 확인하려면 유지보수 상태를 확인하세요.
예약된 유지보수 날짜와 시간을 기다리지 않고 예약, 예약 블록 또는 예약 하위 블록에서 유지보수를 수동으로 시작하려면 유지보수를 수동으로 시작하세요.
호스트 오류 또는 장애가 있는 호스트 신고 후 컴퓨팅 인스턴스의 호스트에 긴급하고 계획되지 않은 유지보수가 필요한 경우 알림을 얼마나 일찍 수신할지 관리하려면 하드웨어 긴급 유지보수 알림을 관리하세요.
유지보수 상태 보기
예약, 예약 블록 또는 예약 하위 블록의 메타데이터에서 upcomingGroupMaintenance 필드의 값을 확인하여 예정된 유지보수 상태를 확인할 수 있습니다. 예약에 upcomingGroupMaintenance 필드가 없으면 예약, 예약 블록 또는 예약 하위 블록에 유지보수가 예약되지 않습니다. upcomingGroupMaintenance의 필드에 대한 자세한 내용은 Compute Engine 문서의 유지보수 상태 정의를 참고하세요.
또한 예약 블록 또는 하위 블록에 유지보수가 예약된 경우 upcomingGroupMaintenance 필드에 maintenanceReasons 필드가 포함됩니다.
이 필드는 다음 표에 설명된 대로 예약 블록 또는 하위 블록에 유지보수가 예약된 이유를 설명합니다.
| 유지보수 유형 | 유지보수 이유 | 컴퓨팅 인스턴스 상태 |
|---|---|---|
| 장애가 있는 호스트 신고 후 계획된 유지보수 | FAILURE_GPU_CUSTOMER_REPORTED |
장애가 있는 것으로 신고한 호스트에서 실행되는 인스턴스에만 적용됩니다. |
| 정기 유지보수를 위한 계획된 유지보수 |
|
실행 중, 중지됨 또는 정지된 인스턴스에 적용됩니다. |
| 예정되지 않은 긴급 유지관리 |
|
실행 중인 인스턴스에만 적용됩니다. |
예약 블록 또는 하위 블록에서 maintenanceReasons 필드를 보거나 하위 블록의 유지보수 상태를 보려면 gcloud CLI 또는 REST API를 사용해야 합니다. 그렇지 않으면 다음 옵션 중 하나를 선택합니다.
콘솔
Google Cloud 콘솔에서 예약 페이지로 이동합니다.
유지보수 상태 열에 Compute Engine에서 예약의 유지보수 상태가 표시됩니다. 주문형 예약 표에 이 열이 표시되지 않으면 열 표시 옵션을 클릭하고 유지보수 상태 체크박스를 선택한 후 확인을 클릭합니다.
예약 블록의 유지보수 상태를 보려면 다음 단계를 완료하세요.
이름 열에서 예약 이름을 클릭합니다. 예약 세부정보를 제공하는 페이지가 표시됩니다.
블록 표의 유지보수 열에 Compute Engine이 예약 내 블록의 유지보수 상태를 표시합니다.
gcloud
예약의 유지보수 상태를 보려면
--flatten플래그를resourceStatus.reservationMaintenance로 설정하고gcloud compute reservations describe명령어를 사용합니다.gcloud compute reservations describe RESERVATION_NAME \ --flatten=resourceStatus.reservationMaintenance \ --zone=ZONE다음을 바꿉니다.
RESERVATION_NAME: 예약 이름.ZONE: 예약이 있는 영역입니다.
출력은 다음 중 하나와 비슷합니다.
예약에 유지보수가 예약된 경우 출력은 다음과 비슷합니다.
--- maintenanceOngoingCount: 0 maintenancePendingCount: 6 schedulingType: GROUPED upcomingGroupMaintenance: canReschedule: true maintenanceStatus: PENDING type: UNSCHEDULED windowEndTime: '2025-11-13T14:00:00.000-08:00' windowStartTime: '2025-11-13T12:00:00.000-08:00'schedulingType필드가INDEPENDENT로 설정되면upcomingGroupMaintenance필드에windowStartTime및windowEndTime필드가 포함되지 않습니다. 예약된 호스트에서 실행되는 인스턴스의 유지보수 일정을 확인하려면 인스턴스의 유지보수 상태를 확인하세요.예약에 유지보수가 예약되어 있지 않으면 출력은 다음과 비슷합니다.
--- schedulingType: GROUPED
예약에 유지보수가 예약된 경우 예약 내 블록의 유지보수 상태를 보려면
gcloud compute reservations blocks list명령어를 사용합니다.gcloud compute reservations blocks list RESERVATION_NAME \ --zone=ZONE예약 블록에 유지보수가 예약되어 있거나 진행 중인 경우 출력은 다음과 비슷합니다.
--- ... name: example-fr-a3u-dense-1-block-0001 ... reservationBlockMaintenance: maintenanceOngoingCount: 0 maintenancePendingCount: 6 schedulingType: GROUPED upcomingGroupMaintenance: canReschedule: true maintenanceReasons: - PLANNED_UPDATE - PLANNED_NETWORK_UPDATE maintenanceStatus: PENDING type: UNSCHEDULED windowEndTime: '2025-11-13T14:00:00.000-08:00' windowStartTime: '2025-11-13T12:00:00.000-08:00' ... --- ... name: example-fr-a3u-dense-1-block-0002 ... schedulingType: GROUPED ...예약 블록에 유지보수가 예약된 경우 예약 블록 내 하위 블록의 유지보수 상태를 보려면
gcloud compute reservations sub-blocks list명령어를 사용합니다.gcloud compute reservations sub-blocks list RESERVATION_NAME \ --block-name=BLOCK_NAME \ --zone=ZONEBLOCK_NAME을 예약 내에 있는 블록의 이름으로 바꿉니다.예약 하위 블록에 유지보수가 예약되어 있거나 진행 중인 경우 출력은 다음과 비슷합니다.
... reservationSubBlockMaintenance: instanceMaintenanceOngoingCount: 0 instanceMaintenancePendingCount: 3 maintenanceOngoingCount: 0 maintenancePendingCount: 32 schedulingType: GROUPED subblockInfraMaintenanceOngoingCount: 0 subblockInfraMaintenancePendingCount: 0 upcomingGroupMaintenance: canReschedule: true maintenanceReasons: - PLANNED_UPDATE - PLANNED_NETWORK_UPDATE maintenanceStatus: PENDING type: SCHEDULED windowEndTime: '2025-11-13T14:00:00.000-08:00' windowStartTime: '2025-11-13T12:00:00.000-08:00' ...
REST
예약의 유지보수 상태를 보려면 다음 메서드 중 하나에
GET요청을 전송합니다.모든 영역의 예약을 보려면
reservations.aggregatedList메서드를 사용합니다.특정 영역의 예약을 보려면
reservations.list메서드를 사용합니다.
요청 URL에 다음 쿼리 파라미터를 포함합니다.
예약의 이름, 예약된 머신 유형, 유지보수 상태만 표시하려면
items.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance로 설정된fields쿼리 매개변수를 포함합니다.특정 머신 유형을 지정하는 예약으로만 필터링하려면 URL 인코딩 값을 사용하여
specificReservation.instanceProperties.machineType:MACHINE_TYPE로 설정된filter쿼리 매개변수를 포함합니다.
예를 들어 모든 영역의 예약을 보려면 다음과 같이
GET요청을 수행합니다.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/reservations?fields=items.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance&filter=specificReservation.instanceProperties.machineType%3AMACHINE_TYPE다음을 바꿉니다.
PROJECT_ID: 예약이 있는 프로젝트의 IDMACHINE_TYPE: 예약을 필터링할 예약된 머신 유형입니다.
예약에 대해 유지보수가 예약되어 있거나 진행 중인 경우 출력은 다음과 비슷합니다.
{ "items": [ { "specificReservation": { "instanceProperties": { "machineType": "MACHINE_TYPE" } }, "name": "example-reservation", "resourceStatus": { "reservationMaintenance": { maintenanceOngoingCount: 0, maintenancePendingCount: 6, "schedulingType": "GROUPED", "upcomingGroupMaintenance": { "type": "SCHEDULED", "canReschedule": true, "windowStartTime": "2025-11-13T12:00:00.000-08:00", "windowEndTime": "2025-11-13T14:00:00.000-08:00", "maintenanceStatus": "PENDING" } } } }, ... ] }원하는 경우 컴퓨팅 인스턴스 목록을 더 좁히려면
filter쿼리 매개변수를 다른 필터 표현식으로 설정합니다.예약에 유지보수가 예정된 경우 예약 내 블록의 유지보수 상태를 보려면
reservationBlocks.list메서드에GET요청을 합니다. 요청 URL에items.name,items.reservationMaintenance로 설정된fields쿼리 매개변수를 포함합니다.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks?fields=items.name,items.reservationMaintenanceRESERVATION_NAME을 예약 이름으로 바꿉니다.예약 블록에 유지보수가 예약되어 있거나 진행 중인 경우 출력은 다음과 비슷합니다.
{ "items": [ { "name": "example-fr-a3u-dense-1-block-0001", "reservationBlockMaintenance": { "maintenanceOngoingCount": 0, "maintenancePendingCount": 6, "schedulingType": "GROUPED", "upcomingGroupMaintenance": { "type": "SCHEDULED", "canReschedule": true, "windowStartTime": "2025-11-13T12:00:00.000-08:00", "windowEndTime": "2025-11-13T14:00:00.000-08:00", "maintenanceStatus": "PENDING", "maintenanceReasons": [ "PLANNED_UPDATE", "PLANNED_NETWORK_UPDATE" ] } } }, ... ] }schedulingType필드가 블록에 대해INDEPENDENT로 설정되면upcomingGroupMaintenance필드에windowStartTime및windowEndTime필드가 포함되지 않습니다. 예약된 블록에서 실행되는 인스턴스의 유지보수 일정을 확인하려면 인스턴스의 유지보수 상태를 확인하세요.예약 블록에 유지보수가 예정되어 있는 경우 예약 블록 내 하위 블록의 유지보수 상태를 보려면
reservationSubBlocks.list메서드에GET요청을 실행합니다.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocksBLOCK_NAME을 예약 내에 있는 블록의 이름으로 바꿉니다.예약 하위 블록에 유지보수가 예약되어 있거나 진행 중인 경우 출력은 다음과 비슷합니다.
{ "items": [ { "name": "example-fr-a3u-dense-1-block-0001", "reservationSubBlockMaintenance": { "instanceMaintenanceOngoingCount": 0, "instanceMaintenancePendingCount": 3, "maintenanceOngoingCount": 0, "maintenancePendingCount": 6, "schedulingType": "GROUPED", "subblockInfraMaintenanceOngoingCount": 0, "subblockInfraMaintenancePendingCount": 0, "upcomingGroupMaintenance": { "type": "SCHEDULED", "canReschedule": true, "windowStartTime": "2025-11-13T12:00:00.000-08:00", "windowEndTime": "2025-11-13T14:00:00.000-08:00", "maintenanceStatus": "PENDING", "maintenanceReasons": [ "PLANNED_UPDATE", "PLANNED_NETWORK_UPDATE" ] } } }, ... ] }
유지보수 수동 시작
예약된 시간을 기다리지 않고 예약, 예약 블록 또는 예약 하위 블록의 유지보수를 수동으로 시작할 수 있습니다. 이 작업을 통해 워크로드 중단을 더 선제적으로 제어할 수 있습니다.
예약, 예약 블록 또는 예약 하위 블록의 유지보수 상태에 따라 다음이 발생합니다.
| 유지보수 상태 | 설명 | 결과 |
|---|---|---|
| 예약됨 | Compute Engine에서 정기 유지보수를 예약했습니다. 예약된 시간 전에 유지보수를 수동으로 시작할 수 있습니다. |
|
| 진행 중 | 유지보수가 진행 중입니다. 일정을 변경할 수 없습니다. |
|
| 완료 | 유지보수가 완료되었습니다. Compute Engine에서 인스턴스의 모든 유지보수 알림을 삭제했습니다. |
|
예약 블록 내의 특정 호스트에서 유지보수를 수동으로 시작하거나 예약 하위 블록에서 유지보수를 수동으로 시작하려면 gcloud CLI 또는 REST API를 사용하세요. 그렇지 않으면 다음 옵션 중 하나를 선택합니다.
콘솔
Google Cloud 콘솔에서 예약 페이지로 이동합니다.
이름 열에서 예약 이름을 클릭합니다. 예약 세부정보를 제공하는 페이지가 표시됩니다.
유지보수 실행을 클릭한 후 다음 옵션 중 하나를 선택합니다.
모든 블록에서 유지보수를 시작하려면 전체 용량을 선택합니다.
실행 중인 인스턴스가 있는 블록에서만 유지보수를 시작하려면 사용 중인 용량을 선택합니다.
미사용 블록과 중지되거나 정지된 인스턴스가 있는 블록에서만 유지보수를 시작하려면 미사용 용량을 선택합니다.
확인을 클릭하여 확인합니다.
gcloud
예약에서 유지보수를 시작하려면
gcloud compute reservations perform-maintenance명령어를 사용합니다.gcloud compute reservations perform-maintenance RESERVATION_NAME \ --scope=RESERVATION_MAINTENANCE_SCOPE \ --zone=ZONE예약 블록에서 유지보수를 시작하려면
gcloud compute reservations blocks perform-maintenance명령어를 사용합니다.gcloud compute reservations blocks perform-maintenance RESERVATION_NAME \ --block-name=BLOCK_NAME \ --scope=BLOCK_MAINTENANCE_SCOPE \ --zone=ZONE예약 하위 블록에서 유지보수를 시작하려면
gcloud compute reservations sub-blocks perform-maintenance명령어를 사용합니다.gcloud compute reservations sub-blocks perform-maintenance RESERVATION_NAME \ --block-name=BLOCK_NAME \ --subblock-name=SUB_BLOCK_NAME \ --zone=ZONE
다음을 바꿉니다.
RESERVATION_NAME: 예약 이름.RESERVATION_MAINTENANCE_SCOPE: 예약의 유지관리 범위입니다. 다음 값 중 하나를 지정합니다.모든 블록에서 유지보수를 시작하려면
all를 실행합니다.실행 중인 인스턴스가 있는 블록에서만 유지보수를 시작하려면 다음을 실행하세요.
running미사용 블록과 중지되거나 일시중지된 인스턴스가 있는 블록에서만 유지보수를 시작하려면 다음을 실행하세요.
unused
BLOCK_NAME: 예약 내에 있는 블록의 이름입니다.SUB_BLOCK_NAME: 예약 블록 내에 있는 하위 블록의 이름입니다.BLOCK_MAINTENANCE_SCOPE: 예약 블록의 유지보수 범위입니다. 다음 값 중 하나를 지정합니다.모든 호스트에서 유지보수를 시작하려면 다음을 실행하세요.
all실행 중인 인스턴스가 있는 호스트에서만 유지보수를 시작하려면 다음을 실행하세요.
running미사용 호스트와 중지되거나 일시중지된 인스턴스가 있는 호스트에서만 유지보수를 시작하려면 다음을 실행하세요.
unused
ZONE: 예약이 있는 영역입니다.
REST
예약에 대한 유지보수를 시작하려면
reservations.performMaintenance메서드에POST요청을 보냅니다.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/performMaintenance { "maintenanceScope": "RESERVATION_MAINTENANCE_SCOPE" }예약 블록에서 유지보수를 시작하려면
reservationBlocks.performMaintenance메서드에POST요청을 수행합니다.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/performMaintenance { "maintenanceScope": "BLOCK_MAINTENANCE_SCOPE" }예약 하위 블록에서 유지보수를 시작하려면
reservationSubBlocks.performMaintenance메서드에POST요청을 실행합니다.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks/SUB_BLOCK_NAME/performMaintenance { "maintenanceScope": "BLOCK_MAINTENANCE_SCOPE" }
다음을 바꿉니다.
PROJECT_ID: Compute Engine에서 자동으로 예약을 만든 프로젝트의 ID입니다.ZONE: 예약이 있는 영역입니다.RESERVATION_NAME: 예약 이름.RESERVATION_MAINTENANCE_SCOPE: 예약의 유지관리 범위입니다. 다음 값 중 하나를 지정합니다.모든 블록에서 유지보수를 시작하려면
ALL를 실행합니다.실행 중인 인스턴스가 있는 블록에서만 유지보수를 시작하려면 다음을 실행하세요.
RUNNING미사용 블록과 중지되거나 일시중지된 인스턴스가 있는 블록에서만 유지보수를 시작하려면 다음을 실행하세요.
UNUSED
BLOCK_NAME: 예약 내에 있는 블록의 이름입니다.SUB_BLOCK_NAME: 예약 블록 내에 있는 하위 블록의 이름입니다.BLOCK_MAINTENANCE_SCOPE: 예약 블록의 유지보수 범위입니다. 다음 값 중 하나를 지정합니다.모든 호스트에서 유지보수를 시작하려면 다음을 실행하세요.
ALL실행 중인 인스턴스가 있는 호스트에서만 유지보수를 시작하려면 다음을 실행하세요.
RUNNING미사용 호스트와 중지되거나 일시중지된 인스턴스가 있는 호스트에서만 유지보수를 시작하려면 다음을 실행하세요.
UNUSED
하드웨어 긴급 유지보수 알림 관리
인스턴스에 호스트 오류가 발생하거나 호스트가 장애가 있는 것으로 신고되면 인스턴스의 호스트에 긴급하고 계획되지 않은 유지보수가 필요합니다. 기본적으로 Compute Engine은 이러한 유형의 유지보수를 예약할 때 몇 시간 전에 사전 알림을 제공합니다. 예약된 호스트의 경우 긴급 유지보수 알림을 사용 설정하여 이 알림 기간을 최소 7일로 늘릴 수 있습니다. 이 접근 방식을 사용하면 워크로드의 중단을 더 적극적으로 제어할 수 있습니다.
예약의 하드웨어 긴급 유지보수 알림을 사용 설정하거나 사용 중지하려면 다음 옵션 중 하나를 선택하세요.
gcloud
예약에 하드웨어 긴급 유지보수 알림을 사용 설정하려면
--enable-emergent-maintenance플래그와 함께gcloud compute reservations update명령어를 사용합니다.gcloud compute reservations update RESERVATION_NAME \ --enable-emergent-maintenance \ --zone=ZONE예약의 하드웨어 긴급 유지보수 알림을 사용 중지하려면
--no-enable-emergent-maintenance플래그와 함께gcloud compute reservations update명령어를 사용합니다.gcloud compute reservations update RESERVATION_NAME \ --no-enable-emergent-maintenance \ --zone=ZONE
다음을 바꿉니다.
RESERVATION_NAME: 예약 이름.ZONE: 예약이 있는 영역입니다.
REST
예약의 하드웨어 긴급 유지보수 알림을 사용 설정 또는 사용 중지하려면 reservations.update 메서드에 PATCH 요청을 실행합니다.
요청 URL에 enableEmergentMaintenance으로 설정된 paths 쿼리 파라미터를 포함합니다.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=enableEmergentMaintenance
{
"name": "RESERVATION_NAME",
"enableEmergentMaintenance": EMERGENCY_MAINTENANCE_NOTIFICATIONS
}
다음을 바꿉니다.
PROJECT_ID: 예약이 있는 프로젝트의 IDZONE: 예약이 있는 영역입니다.RESERVATION_NAME: 예약 이름.EMERGENCY_MAINTENANCE_NOTIFICATIONS: 다음 값 중 하나를 지정합니다.알림을 사용 설정하려면 다음 단계를 따르세요.
true알림을 사용 중지하려면 다음 단계를 따르세요.
false
다음 단계
호스트 이벤트 후 워크로드를 테스트하려면 벤치마킹 레시피를 참고하세요.
예약 모니터링에 대해 자세히 알아보려면 예약 사용 모니터링을 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-02-24(UTC)