REST Resource: projects.locations.privateClouds.upgrades

리소스: 업그레이드

프라이빗 클라우드 업그레이드를 설명합니다.

JSON 표현 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "endTime": string,
  "state": enum (State),
  "type": enum (Type),
  "description": string,
  "estimatedDuration": string,
  "schedule": {
    object (Schedule)
  },
  "version": string,
  "etag": string,
  "uid": string,
  "componentUpgrades": [
    {
      object (VmwareUpgradeComponent)
    }
  ],
  "startVersion": string,
  "targetVersion": string
}
필드
name

string

출력 전용입니다. 식별자. 프라이빗 클라우드 Upgrade의 리소스 이름입니다. 리소스 이름은 https://cloud.google.com/apis/design/resource_names의 규칙을 따르는 스키마가 없는 URI입니다. 예를 들면 projects/my-project/locations/us-west1-a/privateClouds/my-cloud/upgrades/my-upgrade입니다.
createTime

string (Timestamp format)

출력 전용입니다. 출력 전용입니다. 이 리소스의 생성 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 출력 전용입니다. 이 리소스의 마지막 업데이트 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
endTime

string (Timestamp format)

출력 전용입니다. 출력 전용입니다. 업그레이드 종료 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
state

enum (State)

출력 전용입니다. 업그레이드의 현재 상태입니다.
type

enum (Type)

출력 전용입니다. 출력 전용입니다. 업그레이드 유형입니다.
description

string

출력 전용입니다. 출력 전용입니다. 업그레이드에 대한 설명입니다. 업그레이드의 목적, 업그레이드에 포함된 변경사항, 업그레이드와 관련된 기타 정보와 같은 비공개 클라우드 업그레이드에 관한 추가 정보를 제공하는 데 사용됩니다.
estimatedDuration

string (Duration format)

출력 전용입니다. 출력 전용입니다. 업그레이드의 예상 총 기간입니다. 이 정보를 사용하여 중단을 최소화하도록 업그레이드를 계획하거나 예약할 수 있습니다. 예상 기간은 추정치일 뿐입니다. 실제 업그레이드 기간은 다를 수 있습니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
schedule

object (Schedule)

업그레이드 일정 세부정보입니다.
version

string

출력 전용입니다.

etag

string

업그레이드 리소스의 etag입니다. 업데이트 시 제공되는 경우, 서버의 etag와 일치해야 합니다.
uid

string

출력 전용입니다. 리소스에 대해 시스템에서 생성한 고유 식별자입니다.
componentUpgrades[]

object (VmwareUpgradeComponent)

출력 전용입니다. 출력 전용입니다. 구성요소 업그레이드 목록입니다.
startVersion

string

출력 전용입니다. 출력 전용입니다. 시작 버전
targetVersion

string

출력 전용입니다. 출력 전용입니다. 타겟 버전

주

프라이빗 클라우드 Upgrade의 가능한 상태입니다.

열거형
STATE_UNSPECIFIED 기본값입니다. 절대로 이 값을 사용하지 마세요.
SCHEDULED 업그레이드가 예약되었지만 아직 시작되지 않았습니다.
ONGOING 현재 업그레이드가 진행 중이며 아직 완료되지 않았습니다.
SUCCEEDED 업그레이드가 완료되었습니다.
PAUSED 현재 업그레이드가 일시중지되어 있습니다.
FAILED 업그레이드에 실패했습니다.
CANCELLING 업그레이드가 취소되는 중입니다.
CANCELLED 업그레이드가 취소되었습니다.
RESCHEDULING 업그레이드 일정을 변경하는 중입니다.

유형

가능한 업그레이드 유형입니다. 향후 더 많은 유형이 추가될 수 있습니다.

열거형
TYPE_UNSPECIFIED 기본값입니다. 절대로 이 값을 사용하지 마세요.
VSPHERE_UPGRADE 주 버전이 제공될 때 VMware 구성요소 업그레이드 7.0u2 -> 7.0u3
VSPHERE_PATCH 부 버전을 사용할 수 있는 경우 VMware 구성요소 패치 7.0u2c -> 7.0u2d
WORKAROUND 해결 방법은 패치나 업데이트가 출시될 때까지 알려진 취약점이나 문제를 완화하기 위해 적용되는 취약점이나 문제에 대한 핫픽스입니다. 업그레이드 설명에 자세한 내용이 나와 있습니다.
FIRMWARE_UPGRADE 프라이빗 클라우드에서 사용되는 VMware 제품의 펌웨어 업그레이드입니다.
SWITCH_UPGRADE 스위치 업그레이드
OTHER 다른 카테고리에 해당하지 않는 업그레이드 유형입니다.
INFRASTRUCTURE_UPGRADE BM 노드 유지보수의 인프라 업그레이드

일정

업그레이드 일정입니다.

JSON 표현 
{
  "startTime": string,
  "weeklyWindows": [
    {
      object (TimeWindow)
    }
  ],
  "constraints": {
    object (Constraints)
  },
  "editWindow": {
    object (Interval)
  },
  "lastEditor": enum (Editor)
}
필드
startTime

string (Timestamp format)

필수 항목입니다. 업그레이드의 예약된 시작 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
weeklyWindows[]

object (TimeWindow)

필수 항목입니다. 업그레이드 활동의 주간 시간대입니다. 서버는 중단을 최소화하기 위해 이 기간 동안 업그레이드 활동을 실행합니다.
constraints

object (Constraints)

출력 전용입니다. 출력 전용입니다. 일정에 적용된 제약 조건입니다. 이러한 제약 조건은 일정을 변경할 때 적용되어야 합니다.
editWindow

object (Interval)

출력 전용입니다. 출력 전용입니다. 이 시간 간격 또는 기간 동안 일정을 수정할 수 있습니다.
lastEditor

enum (Editor)

출력 전용입니다. 출력 전용입니다. 가장 최근에 업그레이드 일정을 수정한 사용자를 나타냅니다. 업그레이드가 재예약될 때마다 값이 업데이트됩니다.

TimeWindow

업그레이드 활동을 실행할 시간대를 나타냅니다.

JSON 표현 
{
  "dayOfWeek": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "duration": string
}
필드
dayOfWeek

enum (DayOfWeek)

필수 항목입니다. 이 기간의 요일입니다.
startTime

object (TimeOfDay)

필수 항목입니다. 창이 시작되는 시간(UTC)입니다.
duration

string (Duration format)

필수 항목입니다. 기간의 길이입니다. 모든 기간의 최대 허용 시간은 24시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

DayOfWeek

요일을 나타냅니다.

열거형
DAY_OF_WEEK_UNSPECIFIED 요일이 지정되지 않습니다.
MONDAY 월요일
TUESDAY 화요일
WEDNESDAY 수요일
THURSDAY 목요일
FRIDAY 금요일
SATURDAY 토요일
SUNDAY 일요일

TimeOfDay

하루 중 특정 시간을 나타냅니다. 날짜와 시간대가 중요하지 않거나 아무 곳으로 지정됩니다. API는 윤초를 허용하도록 선택할 수 있습니다. 관련된 유형은 google.type.Date 및 google.protobuf.Timestamp입니다.

JSON 표현 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
필드
hours

integer

24시간 형식의 시간입니다. 0 이상이어야 하며 일반적으로 23 이하여야 합니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다.
minutes

integer

시간의 분입니다. 0 이상 59 이하여야 합니다.
seconds

integer

분의 초입니다. 0 이상이어야 하며 일반적으로 59 이하여야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.
nanos

integer

나노초 단위의 초수입니다. 0 이상, 999,999,999 이하여야 합니다.

제약조건

일정을 수정하는 동안 적용할 제약 조건입니다. 이러한 제약 조건은 Upgrade 특정 요구사항이 충족되도록 합니다.

JSON 표현 
{
  "minHoursDay": integer,
  "minHoursWeek": integer,
  "rescheduleDateRange": {
    object (Interval)
  },
  "disallowedIntervals": [
    {
      object (WeeklyTimeInterval)
    }
  ]
}
필드
minHoursDay

integer

출력 전용입니다. 선택한 각 날짜의 업그레이드 활동에 최소 시간을 할당해야 합니다. 이는 최소 시간이며 업그레이드 일정에 따라 해당 날짜에 더 많은 시간을 할당할 수 있습니다.
minHoursWeek

integer

출력 전용입니다. 업그레이드 활동에 최소 주간 시간이 할당되어야 합니다. 이는 최소 시간이며 일정에 더 많은 주간 시간을 할당할 수 있습니다.
rescheduleDateRange

object (Interval)

출력 전용입니다. 출력 전용입니다. 사용자는 이 범위 내에서 시작되는 업그레이드만 다시 예약할 수 있습니다.
disallowedIntervals[]

object (WeeklyTimeInterval)

출력 전용입니다. 출력 전용입니다. 유지보수 기간이 허용되지 않는 간격 목록입니다. 이러한 간격과 겹치는 시간대는 무효로 간주됩니다.

간격

타임스탬프 시작(포함) 및 타임스탬프 종료(제외)로 인코딩된 시간 간격을 나타냅니다.

시작은 종료보다 작거나 같아야 합니다. 시작이 종료와 같으면 간격이 비어 있습니다(시간과 일치하지 않음). 시작과 종료가 모두 지정되지 않은 경우 간격은 모든 시간과 일치합니다.

JSON 표현 
{
  "startTime": string,
  "endTime": string
}
필드
startTime

string (Timestamp format)

선택사항입니다. 간격의 시작(포함)입니다.

지정된 경우 이 간격과 일치하는 타임스탬프는 시작과 같거나 시작 이후여야 합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
endTime

string (Timestamp format)

선택사항입니다. 간격의 끝(제외)입니다.

지정된 경우 이 간격과 일치하는 타임스탬프는 종료 시간 이전이어야 합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

WeeklyTimeInterval

요일에 걸쳐 있는 시간 간격을 나타냅니다. 현지 시간대가 지원될 때까지 이 간격은 UTC로 표시됩니다.

JSON 표현 
{
  "startDay": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "endDay": enum (DayOfWeek),
  "endTime": {
    object (TimeOfDay)
  }
}
필드
startDay

enum (DayOfWeek)

출력 전용입니다. 간격이 시작되는 날짜입니다.
startTime

object (TimeOfDay)

출력 전용입니다. 시작일의 시간으로, 간격이 시작되는 시간입니다.
endDay

enum (DayOfWeek)

출력 전용입니다. 간격이 종료되는 날짜입니다. 시작일과 동일할 수 있습니다.
endTime

object (TimeOfDay)

출력 전용입니다. 간격이 종료되는 종료일의 시간입니다.

편집자

업그레이드 일정을 수정한 사용자의 가능한 값입니다. 값은 개인 대신 그룹 또는 법인을 식별합니다.

열거형
EDITOR_UNSPECIFIED 기본값입니다. 절대로 이 값을 사용하지 마세요.
SYSTEM 업그레이드는 시스템 또는 내부 서비스에 의해 예약됩니다.
USER 최종 사용자가 업그레이드를 예약합니다.

VmwareUpgradeComponent

구성요소별 업그레이드 리소스

JSON 표현 
{
  "componentType": enum (VmwareComponentType),
  "state": enum (State)
}
필드
componentType

enum (VmwareComponentType)

출력 전용입니다. 구성요소 유형
state

enum (State)

출력 전용입니다. 구성요소의 업그레이드 상태입니다.

VmwareComponentType

vmware 구성요소의 유형

열거형
VMWARE_COMPONENT_TYPE_UNSPECIFIED 기본값입니다. 절대로 이 값을 사용하지 마세요.
VCENTER vcenter
ESXI ESXi 노드 + 전송 노드
NSXT_UC nsxt 업그레이드 코디네이터
NSXT_EDGE nsxt edges cluster
NSXT_MGR nsxt 관리자/관리 영역
HCX hcx
VSAN VSAN 클러스터
DVS DVS 스위치
NAMESERVER_VM 네임서버 VM
KMS_VM vsan 암호화에 사용되는 KMS VM
WITNESS_VM 스트레치 PC의 경우 감시 VM
NSXT nsxt
CLUSTER BM의 경우 클러스터가 사용됩니다.
VM_TOOLS VMware Tools

주

상태는 업그레이드의 현재 상태를 정의합니다.

열거형
STATE_UNSPECIFIED 기본값입니다. 절대로 이 값을 사용하지 마세요.
RUNNING 구성요소 업그레이드가 진행 중입니다.
PAUSED 구성요소의 업그레이드가 일시중지됩니다. 업그레이드 작업이 재개되면 다시 시작됩니다.
SUCCEEDED 구성요소 업그레이드가 완료됨
FAILED 구성요소 업그레이드에 실패했습니다. 업그레이드가 재개되면 '재개'로 이동하고, 그렇지 않으면 그대로 유지됩니다.
NOT_STARTED 구성요소의 업그레이드가 아직 시작되지 않음
NOT_APPLICABLE 이 업그레이드에는 구성요소 업그레이드가 적용되지 않습니다. 건너뜁니다.

메서드

get

 리소스 이름으로 프라이빗 클라우드 Upgrade 리소스를 가져옵니다.

list

 지정된 프라이빗 클라우드의 과거, 진행 중, 예정된 Upgrades를 나열합니다.

patch

 프라이빗 클라우드 Upgrade 리소스를 업데이트합니다.