Apigee 인스턴스 유지보수 기간 관리

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

이 섹션에는 Apigee 리소스의 유지보수 기간을 찾고 설정하는 절차가 나와 있습니다. Apigee가 유지보수를 수행하는 방법과 이유에 대한 자세한 내용은 유지보수 개요를 참고하세요.

선호 유지보수 기간 설정

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

유지보수 알림을 선택한 경우 Apigee에서 리소스 유지보수가 예약된 후 유지보수가 예정된 정확한 날짜 및 시간과 함께 알림을 보냅니다. Apigee는 다음과 같이 리소스 유지보수 기간 순서 업데이트 설정에 따라 알림을 전송합니다.

  • 업데이트 순서가 1주차로 설정된 경우 Apigee는 최소 1주일 전에 유지보수 알림을 전송합니다.
  • 업데이트 순서 설정이 2주차로 설정된 경우 Apigee는 최소 2주 전에 유지보수 알림을 전송합니다.

Apigee 인스턴스당 유지보수 기간은 하나만 지정할 수 있습니다. 유지보수 기간이 두 개 이상인 요청은 거부됩니다.

동일한 조직의 여러 인스턴스에 유지보수 기간을 설정하려면 유지보수 작업이 중복되지 않도록 유지보수 기간 사이에 최소 12시간을 두어야 합니다.

유지보수 기간을 업데이트하면 이전 기간이 덮어쓰여집니다.

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": {
      "maintenanceWindows": [
        {
          "day": "SUNDAY",
          "startTime": {
            "hours": 23
          }
        }
      ],
      "maintenanceChannel": "WEEK1"
    }
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy.maintenanceWindows,maintenanceUpdatePolicy.maintenanceChannel"

각 항목의 의미는 다음과 같습니다.

  • 유지보수 startTime는 UTC로 구성됩니다.
  • ORGANIZATION_ID은 Apigee 조직 ID입니다.
  • INSTANCE_ID은 Apigee 인스턴스 ID입니다.

기존 유지보수 설정 및 유지보수 일정 찾기

다음 API 예시와 같이 maintenanceUpdatePolicy 및 scheduledMaintenance 필드를 확인하여 현재 유지보수 설정을 가져오고 예정된 유지보수를 확인할 수 있습니다.

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -H "$AUTH" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID"

각 항목의 의미는 다음과 같습니다.

  • ORGANIZATION_ID은 Apigee 조직 ID입니다.
  • INSTANCE_ID은 Apigee 인스턴스 ID입니다.

출력 예

{
  ...
  "scheduledMaintenance": {
    "startTime": "2025-01-28T23:00:00Z"
  },
  "maintenanceUpdatePolicy": {
    "maintenanceWindows": [
      {
        "day": "SUNDAY",
        "startTime": {
          "hours": 23
        }
      }
    ]
  }
}

유지보수 설정 지우기

더 이상 유지관리 설정이 필요하지 않은 경우 아래 안내에 따라 설정을 지울 수 있습니다.

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": null
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy"

각 항목의 의미는 다음과 같습니다.

  • ORGANIZATION_ID은 Apigee 조직 ID입니다.
  • INSTANCE_ID은 Apigee 인스턴스 ID입니다.

유지보수 알림 수신 동의

유지보수 알림 수신에 동의하기 전에 리소스에 유지보수를 위한 선호 기간을 설정해야 합니다.

  1. Google Cloud 콘솔에서 사용자 환경설정 > 커뮤니케이션 페이지로 이동합니다.

    커뮤니케이션으로 이동

  2. Apigee, 유지보수 기간 행에서 이메일 아래에 있는 라디오 버튼을 선택하여 사용으로 전환합니다.

알림을 수신해야 하는 각 사용자는 위의 안내에 따라 별도로 선택해야 합니다.