API를 사용하여 리소스 유지관리 보기

Unified Maintenance API를 사용하여 리소스의 유지보수에 관한 정보를 반환할 수 있습니다.

이 문서에서는 Cloud Shell을 사용하여 통합 유지관리 API를 호출하여 리소스 유지관리를 반환하는 방법을 설명합니다.

Cloud Hub에서 예정된 유지보수 활동과 이전 유지보수 활동을 보려면 유지보수 활동 보기를 참고하세요.

시작하기 전에

Unified Maintenance를 사용하여 리소스의 유지보수를 보기 전에 Unified Maintenance에서 리소스 유형을 지원하는지 확인합니다.

필터

여러 매개변수를 사용하여 반환되는 유지보수 활동을 필터링할 수 있습니다.

  • 주 (예: SUCCEEDED 또는 STARTED)
  • 리소스 이름
  • 리소스 위치
  • 리소스 유형
  • 유지보수 이름
  • 유지보수 시작 시간
  • 유지보수 종료 시간

자세한 내용은 통합 유지관리 API 문서를 참고하세요.

리소스 유지보수 보기

Unified Maintenance API를 사용하여 Google Cloud 프로젝트의 유지보수 활동 정보를 반환할 수 있습니다.

모든 유지보수 활동을 나열하려면 다음을 실행합니다.

  1. Cloud Shell로 이동합니다.

    Cloud Shell로 이동

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

    curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type:
    application/json" \
    https://maintenance.googleapis.com/v1beta/projects/PROJECT_ID/locations/LOCATION/resourceMaintenances
    

    다음과 같이 바꿉니다.

    • PROJECT_ID: 프로젝트의 프로젝트 ID
    • LOCATION: 프로젝트가 포함된 리전 또는 영역입니다. global, region 또는 -로 설정합니다 (모든 위치와 일치).
  3. Unified Maintenance는 지정된 프로젝트의 리소스 유지보수에 관한 정보를 반환합니다.

리소스의 유지보수 보기

Unified Maintenance API를 사용하여 지정된 리소스의 유지보수를 반환할 수 있습니다.

지정된 리소스의 유지보수를 필터링하고 출력하려면 다음 단계를 따르세요.

  1. Cloud Shell로 이동합니다.

    Cloud Shell로 이동

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

    curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type:
    application/json" \
    https://maintenance.googleapis.com/v1beta/projects/PROJECT_ID/locations/LOCATION/resourceMaintenances?filter=FILTER=%22RESOURCE_NAME%22
    

    다음과 같이 바꿉니다.

    • PROJECT_ID: 프로젝트의 프로젝트 ID
    • LOCATION: 프로젝트가 포함된 리전 또는 영역입니다. global, region 또는 -로 설정합니다 (모든 위치와 일치).
    • RESOURCE_NAME: 리소스의 전체 리소스 이름입니다.

다음 단계