REST Resource: projects.locations.unitOperations

리소스: UnitOperation

UnitOperation은 특정 Unit으로 표현되는 서비스 구성요소를 변경하거나 상호작용하려는 의도를 캡슐화합니다. 여러 UnitOperation을 만들어 (요청) 향후에 예약할 수 있지만 한 번에 하나의 UnitOperation만 실행할 수 있습니다 (변경되지 않는 작업의 경우 향후 변경될 수 있음).

UnitOperations를 사용하면 동일한 단위와 상호작용하는 여러 행위자가 요청한 변경사항에만 집중할 수 있습니다.

모든 단위 작업의 공통 필드를 포함하는 기본 객체입니다. 다음: 22

JSON 표현 
{
  "name": string,
  "unit": string,
  "parentUnitOperation": string,
  "rollout": string,
  "cancel": boolean,
  "state": enum (UnitOperationState),
  "conditions": [
    {
      object (UnitOperationCondition)
    }
  ],
  "schedule": {
    object (Schedule)
  },
  "engineState": string,
  "errorCategory": enum (UnitOperationErrorCategory),
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,

  // Union field unit_operation_type can be only one of the following:
  "provision": {
    object (Provision)
  },
  "upgrade": {
    object (Upgrade)
  },
  "deprovision": {
    object (Deprovision)
  }
  // End of list of possible types for union field unit_operation_type.
}
필드
name

string

식별자. 표준 명명 규칙을 따르는 리소스 이름 (리소스의 전체 URI)입니다.

"projects/{project}/locations/{location}/unitOperations/{unitOperation}"
unit

string

필수 항목입니다. 변경할 수 없습니다. 특정 UnitOperation이 작동하는 Unit입니다.
parentUnitOperation

string

선택사항입니다. 상위 리소스(UnitOperation)에 대한 참조입니다. 작업에서 워크플로의 일부로 다른 작업을 만들어야 하는 경우 각 하위 작업의 이 필드는 상위로 설정되어야 합니다. 이는 추적에 사용할 수 있습니다. (선택사항)
rollout

string

선택사항입니다. 이 단위 작업을 만든 출시를 지정합니다. 이 값은 수정할 수 없으며 필터링 목적으로만 사용됩니다. 종속 단위와 단위 작업이 다른 단위 작업의 일부로 생성되면 동일한 rolloutId를 사용합니다.
cancel

boolean

선택사항입니다. true인 경우 작업을 취소하려고 시도합니다. 작업이 이미 실행 중인 경우 취소가 실패할 수 있습니다. (선택사항)
state

enum (UnitOperationState)

선택사항입니다. 출력 전용입니다. UnitOperationState는 단위 작업의 현재 상태를 설명합니다.
conditions[]

object (UnitOperationCondition)

선택사항입니다. 출력 전용입니다. 이 리소스가 가질 수 있는 다양한 조건을 나타내는 조건 집합입니다.
schedule

object (Schedule)

선택사항입니다. 이 작업을 예약할 시간입니다.
engineState

string

선택사항입니다. 출력 전용입니다. 진행 중인 배포 엔진 작업의 엔진 상태입니다. 이 필드는 외부 사용에 불투명합니다.
errorCategory

enum (UnitOperationErrorCategory)

선택사항입니다. 출력 전용입니다. UnitOperationErrorCategory는 오류 카테고리를 설명합니다.
labels

map (key: string, value: string)

선택사항입니다. 분류에 사용할 수 있는 리소스의 라벨입니다. Kubernetes 리소스 라벨과 유사합니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
annotations

map (key: string, value: string)

선택사항입니다. 주석은 리소스와 함께 저장되는 구조화되지 않은 키-값 맵으로, 임의의 메타데이터를 저장하고 검색하기 위해 외부 도구에서 설정할 수 있습니다. 쿼리할 수 없으며 객체를 수정할 때 보존해야 합니다.

자세한 내용은 https://kubernetes.io/docs/user-guide/annotations를 참고하세요.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
uid

string

출력 전용입니다. 리소스의 고유 식별자입니다. UID는 서비스의 범위 내에서 이 리소스의 특정 시점과 공간에서 고유합니다. 일반적으로 리소스가 생성될 때 서버에서 생성되며 변경할 수 없습니다. UID는 리소스 이름을 재사용하는 리소스를 고유하게 식별하는 데 사용되며 UUID4여야 합니다.
etag

string

출력 전용입니다. 리소스의 버전 또는 세대를 고유하게 식별하는 불투명 값입니다. 클라이언트 및 서버의 리소스 작성 순서가 일치함을 확인하는 데 사용될 수 있습니다.
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"입니다.
deleteTime

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"입니다.

통합 필드 unit_operation_type.

unit_operation_type는 다음 중 하나여야 합니다.
provision

object (Provision)
upgrade

object (Upgrade)
deprovision

object (Deprovision)

프로비저닝

프로비저닝은 단위를 통해 표현되는 기본 리소스를 프로비저닝하는 단위 작업입니다. 현재 유닛이 프로비저닝되지 않은 경우에만 실행할 수 있습니다.

JSON 표현 
{
  "release": string,
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ]
}
필드
release

string

선택사항입니다. 단위에 사용할 버전 객체에 대한 참조입니다. (선택사항).
inputVariables[]

object (UnitVariable)

선택사항입니다. 입력 변수 집합입니다. 최대 100개 (선택사항)

업그레이드

업그레이드는 프로비저닝된 단위를 업그레이드하는 단위 작업으로, Unit으로 표시되는 기본 리소스도 포함될 수 있습니다. 현재 단위가 프로비저닝된 경우에만 실행할 수 있습니다.

JSON 표현 
{
  "release": string,
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ]
}
필드
release

string

선택사항입니다. 단위에 사용할 버전 객체에 대한 참조입니다. (선택사항).
inputVariables[]

object (UnitVariable)

선택사항입니다. 입력 변수 집합입니다. 최대 100개 (선택사항)

프로비저닝 해제

이 유형에는 필드가 없습니다.

프로비저닝 해제는 단위를 나타내는 기본 리소스를 프로비저닝 해제하는 단위 작업입니다. 현재 단위가 프로비저닝된 경우에만 실행할 수 있습니다.

UnitOperationState

UnitOperationState는 단위 작업의 현재 상태를 설명합니다.

열거형
UNIT_OPERATION_STATE_UNKNOWN
UNIT_OPERATION_STATE_PENDING 단위 작업이 수락되었지만 실행할 준비가 되지 않았습니다.
UNIT_OPERATION_STATE_SCHEDULED 단위 작업이 수락되고 예약됩니다.
UNIT_OPERATION_STATE_RUNNING 단위 작업이 실행 중입니다.
UNIT_OPERATION_STATE_SUCCEEDED 단위 작업이 완료되었습니다.
UNIT_OPERATION_STATE_FAILED 단위 작업이 실패했습니다.
UNIT_OPERATION_STATE_CANCELLED 단위 작업이 취소되었습니다.

UnitOperationCondition

UnitOperationCondition은 단위 작업의 상태를 설명합니다. UnitOperationCondition은 전체 상태에 기여하는 개별 구성요소입니다.

JSON 표현 
{
  "status": enum (Status),
  "type": enum (Type),
  "lastTransitionTime": string,
  "message": string,
  "reason": string
}
필드
status

enum (Status)

필수 항목입니다. 조건의 상태입니다.
type

enum (Type)

필수 항목입니다. 조건의 유형입니다.
lastTransitionTime

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"입니다.
message

string

필수 항목입니다. 마지막 전환에 대한 세부정보를 나타내는 인간이 읽을 수 있는 메시지입니다.
reason

string

필수 항목입니다. 조건의 마지막 전환에 대한 간단한 이유입니다.

상태

조건 상태의 열거형입니다.

열거형
STATUS_UNSPECIFIED 조건 상태가 지정되지 않았습니다.
STATUS_UNKNOWN 조건을 알 수 없습니다.
STATUS_TRUE 조건이 참입니다.
STATUS_FALSE 조건이 false입니다.

유형

조건 유형의 열거형입니다.

열거형
TYPE_UNSPECIFIED 조건 유형이 지정되지 않았습니다.
TYPE_SCHEDULED 조건 유형이 예약되어 있습니다.
TYPE_RUNNING 조건 유형이 실행 중입니다.
TYPE_SUCCEEDED 조건 유형이 성공했습니다.
TYPE_CANCELLED 조건 유형이 취소되었습니다.
TYPE_APP_CREATED AppHub 앱이 생성되었는지 여부를 나타냅니다.
TYPE_APP_COMPONENTS_REGISTERED 서비스와 워크로드가 AppHub에 등록되었는지 여부를 나타냅니다.

일정

유지보수를 예약할 시간 사양입니다.

JSON 표현 
{
  "startTime": 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"입니다.

UnitOperationErrorCategory

UnitOperationErrorCategory는 단위 작업의 오류 카테고리를 설명합니다.

열거형
UNIT_OPERATION_ERROR_CATEGORY_UNSPECIFIED 단위 작업 오류 카테고리가 지정되지 않음
NOT_APPLICABLE 단위 작업 오류 카테고리가 적용되지 않거나 오류가 아님
FATAL 단위 작업 오류 카테고리가 심각함
RETRIABLE 단위 작업 오류 카테고리를 재시도할 수 있음
IGNORABLE 단위 작업 오류 카테고리는 무시할 수 있음
STANDARD 단위 작업 오류 카테고리가 표준이며 출시 오류 예산에 포함됩니다.

메서드

create

 새 단위 작업을 만듭니다.

delete

 단일 단위 작업을 삭제합니다.

get

 단일 단위 작업을 가져옵니다.

list

 단위 작업 컬렉션을 가져옵니다.

patch

 단일 단위 작업을 업데이트합니다.