REST Resource: projects.locations.units

리소스: Unit

내부에서 작동 엔진 (예: Terraform, Helm 또는 서비스 프로듀서가 제공하는 맞춤 구현 기반)을 사용하는 CRUD API를 통해 수명 주기가 있는 배포 단위입니다. SaaS 테넌트의 구성요소입니다.

JSON 표현 
{
  "name": string,
  "unitKind": string,
  "release": string,
  "tenant": string,
  "ongoingOperations": [
    string
  ],
  "pendingOperations": [
    string
  ],
  "scheduledOperations": [
    string
  ],
  "dependents": [
    {
      object (UnitDependency)
    }
  ],
  "dependencies": [
    {
      object (UnitDependency)
    }
  ],
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "outputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "maintenance": {
    object (MaintenanceSettings)
  },
  "state": enum (UnitState),
  "conditions": [
    {
      object (UnitCondition)
    }
  ],
  "managementMode": enum (ManagementMode),
  "systemManagedState": enum (SystemManagedState),
  "systemCleanupAt": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean
}
필드
name

string

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

"projects/{project}/locations/{location}/units/{unit}"
unitKind

string

선택사항입니다. 이 단위가 속한 UnitKind에 대한 참조입니다. 설정 후 변경 불가
release

string

선택사항입니다. 출력 전용입니다. 이 단위의 현재 출시 객체입니다.
tenant

string

선택사항입니다. 이 단위가 속한 SaaS 테넌트 리소스에 대한 참조입니다. 예를 들어 이는 단위의 향후 업데이트를 예약하는 데 사용할 유지보수 정책을 알려줍니다. (선택사항이며 생성 후에는 변경할 수 없음)
ongoingOperations[]

string

선택사항입니다. 출력 전용입니다. 이 단위에서 작동하는 동시 UnitOperation 목록입니다.
pendingOperations[]

string

선택사항입니다. 출력 전용입니다. 이 단위의 대기 중 (실행 대기) UnitOperation 목록입니다.
scheduledOperations[]

string

선택사항입니다. 출력 전용입니다. 이 단위의 예약된 UnitOperation 목록입니다.
dependents[]

object (UnitDependency)

선택사항입니다. 출력 전용입니다. 이 단위를 사용하는 단위 목록입니다. 이 목록이 비어 있는 경우에만 단위를 프로비저닝 해제할 수 있습니다. 최대 1,000개
dependencies[]

object (UnitDependency)

선택사항입니다. 출력 전용입니다. 이 단위의 종속 항목 집합입니다. 최대 10개
inputVariables[]

object (UnitVariable)

선택사항입니다. 출력 전용입니다. 단위에서 배포한 현재 입력 변수를 나타냅니다.
outputVariables[]

object (UnitVariable)

선택사항입니다. 출력 전용입니다. 작동 템플릿 실행의 출력 변수에 해당하는 키/값 쌍 집합입니다. 변수는 작동 구성 (예: Helm 차트 또는 Terraform)에 선언되며 값은 실행이 완료되면 작동 엔진에 의해 가져오고 반환됩니다.
maintenance

object (MaintenanceSettings)

선택사항입니다. 기기에서 향후 유지보수를 실행하기 위해 요청된 지시어를 캡처합니다. 여기에는 일정 기간 동안 유지보수를 건너뛰고 현재 버전에 고정된 상태로 유지하라는 요청과 향후 예정된 유지보수를 연기하는 컨트롤이 포함됩니다.
state

enum (UnitState)

선택사항입니다. 출력 전용입니다. 리소스의 현재 수명 주기 상태입니다 (예: 생성 중인지 또는 사용할 준비가 되었는지).
conditions[]

object (UnitCondition)

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

enum (ManagementMode)

선택사항입니다. 변경할 수 없습니다. 단위 수명 주기가 사용자 또는 시스템에 의해 제어되는지 여부를 나타냅니다. 생성 후 변경 불가
systemManagedState

enum (SystemManagedState)

선택사항입니다. 출력 전용입니다. 단위의 시스템 관리 상태를 나타냅니다.
systemCleanupAt

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

boolean

출력 전용입니다. 리소스 위치가 영역 분리 제약 조건을 충족하는지 여부를 나타냅니다. 기본적으로 false입니다.
satisfiesPzi

boolean

출력 전용입니다. 리소스 위치가 영역 격리 제약 조건을 충족하는지 여부를 나타냅니다. 기본적으로 false입니다.

UnitDependency

이 단위의 종속 항목 집합입니다. 최대 10개

JSON 표현 
{
  "alias": string,
  "unit": string
}
필드
alias

string

출력 전용입니다. 종속 항목 이름의 별칭입니다.
unit

string

출력 전용입니다. Unit 객체에 대한 참조입니다.

MaintenanceSettings

기기에서 향후 유지보수를 실행하기 위해 요청된 지시어를 캡처합니다. 여기에는 일정 기간 동안 유지보수를 건너뛰고 현재 버전에 고정된 상태로 유지하라는 요청과 향후 예정된 유지보수를 연기하는 컨트롤이 포함됩니다.

JSON 표현 
{
  "pinnedUntilTime": string
}
필드
pinnedUntilTime

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

UnitState

UnitState는 단위 자체의 현재 상태를 주석으로 표시합니다.

열거형
UNIT_STATE_UNSPECIFIED 지정되지 않은 상태입니다.
UNIT_STATE_NOT_PROVISIONED 단위가 프로비저닝되지 않았습니다.
UNIT_STATE_PROVISIONING 단위를 프로비저닝하는 중입니다.
UNIT_STATE_UPDATING 단위를 업데이트하는 중입니다. 일반적으로 이는 단위가 새 버전으로 업그레이드되거나 단위의 일부 입력 변수가 변경되는 경우에 발생합니다. 특정 종류의 업데이트는 업데이트가 진행되는 동안 기기를 사용할 수 없게 만들 수 있습니다.
UNIT_STATE_DEPROVISIONING 단위를 삭제하는 중입니다.
UNIT_STATE_READY 장치가 프로비저닝되었으며 사용할 준비가 되었습니다.
UNIT_STATE_ERROR 준비되지 않은 상태에서 오류 작업이 발생하면 기기에 오류가 있습니다.

UnitCondition

UnitCondition은 Unit의 상태를 설명합니다. UnitCondition은 전체 상태에 기여하는 개별 구성요소입니다.

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_READY 조건 유형이 준비되었습니다.
TYPE_UPDATING 조건 유형이 업데이트되고 있습니다.
TYPE_PROVISIONED 조건 유형이 프로비저닝됩니다.
TYPE_OPERATION_ERROR 조건 유형이 operationError입니다. 마지막 단위 작업이 무시할 수 없는 오류로 실패한 경우 true입니다.

ManagementMode

ManagementMode는 단위 관리를 담당하는 주체를 설명합니다.

열거형
MANAGEMENT_MODE_UNSPECIFIED
MANAGEMENT_MODE_USER 단위의 수명 주기는 사용자가 관리합니다.
MANAGEMENT_MODE_SYSTEM 시스템에서 단위를 프로비저닝 해제하고 삭제할 시기를 결정합니다. 사용자는 여전히 수동으로 단위를 프로비저닝 해제하거나 삭제할 수 있습니다.

SystemManagedState

열거형
SYSTEM_MANAGED_STATE_UNSPECIFIED
SYSTEM_MANAGED_STATE_ACTIVE 단위에 종속 항목이 연결되어 있습니다.
SYSTEM_MANAGED_STATE_INACTIVE 단위에 연결된 종속 항목이 없지만 연결은 허용됩니다.
SYSTEM_MANAGED_STATE_DECOMMISSIONED 단위에 연결된 종속 항목이 없으며 연결이 허용되지 않습니다.

메서드

create

 새 단위를 만듭니다.

delete

 단일 단위를 삭제합니다.

get

 단일 단위를 가져옵니다.

list

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

patch

 단일 단위를 업데이트합니다.