REST 리소스: projects.patchJobs

리소스: PatchJob

진행 중이거나 완료된 패치 작업의 상위 수준 표현입니다.

인스턴스 세부정보는 작업에 포함되지 않습니다. 인스턴스 세부정보를 페이지로 나누려면 instanceDetails.list를 사용합니다.

패치 작업에 대한 자세한 내용은 패치 작업 만들기를 참조하세요.

JSON 표현

{
      "name": string,
      "displayName": string,
      "description": string,
      "createTime": string,
      "updateTime": string,
      "state": enum (State),
      "instanceFilter": {
        object (PatchInstanceFilter)
      },
      "patchConfig": {
        object (PatchConfig)
      },
      "duration": string,
      "instanceDetailsSummary": {
        object (InstanceDetailsSummary)
      },
      "dryRun": boolean,
      "errorMessage": string,
      "percentComplete": number,
      "patchDeployment": string
    }
필드
name

string

projects/*/patchJobs/* 형식으로 된 이 패치 작업의 고유 식별자입니다.

displayName

string

이 패치 작업의 표시 이름입니다. 고유 식별자가 아닙니다.

description

string

패치 작업의 설명입니다. 설명의 길이는 1,024자(영문)로 제한됩니다.

createTime

string (Timestamp format)

이 패치 작업이 생성된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프로, 정밀도는 나노초 수준입니다. 예를 들면 "2014-10-02T15:01:23.045123456Z"입니다.

updateTime

string (Timestamp format)

이 패치 작업이 마지막으로 업데이트된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프로, 정밀도는 나노초 수준입니다. 예를 들면 "2014-10-02T15:01:23.045123456Z"입니다.

state

enum (State)

PatchJob의 현재 상태입니다.

instanceFilter

object (PatchInstanceFilter)

패치할 인스턴스입니다.

patchConfig

object (PatchConfig)

적용 중인 패치 구성입니다.

duration

string (Duration format)

패치 작업의 기간입니다. 이 기간이 끝나면 패치 작업이 타임아웃됩니다.

초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 's'로 끝납니다(예: "3.5s").

instanceDetailsSummary

object (InstanceDetailsSummary)

인스턴스 세부정보의 요약입니다.

dryRun

boolean

이 패치 작업이 연습 실행이면 에이전트는 VM 인스턴스에서 업데이트를 실행하지 않고 완료된 것으로 보고합니다.

errorMessage

string

이 패치 작업이 실패하면 이 메시지에 실패 정보가 표시됩니다.

percentComplete

number

패치 작업의 전체 진행률을 0.0(진행 안 됨)~100.0(완료됨) 범위로 표시합니다.

patchDeployment

string

출력 전용. 이 패치 작업을 만든 패치 배포의 이름입니다.

State

패치 작업이 실행되면서 거치는 다양한 상태를 열거합니다.

열거형
STATE_UNSPECIFIED 반드시 상태를 지정해야 합니다.
STARTED 패치 작업이 성공적으로 시작되었습니다.
INSTANCE_LOOKUP 패치 작업이 패치를 실행할 인스턴스를 조회하고 있습니다.
PATCHING 인스턴스에 패치를 적용하고 있습니다.
SUCCEEDED 패치 작업이 성공적으로 완료되었습니다.
COMPLETED_WITH_ERRORS 패치 작업이 완료되었지만 오류가 발생했습니다.
CANCELED 패치 작업이 취소되었습니다.
TIMED_OUT 패치 작업이 타임아웃되었습니다.

InstanceDetailsSummary

이 패치 작업이 영향을 미치는 모든 인스턴스의 현재 패치 상태에 대한 요약입니다. 다양한 상태의 인스턴스 수를 포함합니다. 이 상태는 InstancePatchState에 매핑됩니다. 패치 작업 인스턴스 세부정보를 나열하여 각 인스턴스의 특정 상태를 표시합니다.

JSON 표현

{
      "pendingInstanceCount": string,
      "inactiveInstanceCount": string,
      "notifiedInstanceCount": string,
      "startedInstanceCount": string,
      "downloadingPatchesInstanceCount": string,
      "applyingPatchesInstanceCount": string,
      "rebootingInstanceCount": string,
      "succeededInstanceCount": string,
      "succeededRebootRequiredInstanceCount": string,
      "failedInstanceCount": string,
      "ackedInstanceCount": string,
      "timedOutInstanceCount": string,
      "prePatchStepInstanceCount": string,
      "postPatchStepInstanceCount": string,
      "noAgentDetectedInstanceCount": string
    }
필드
pendingInstanceCount

string (int64 format)

패치 작업이 대기 중인 인스턴스의 수입니다.

inactiveInstanceCount

string (int64 format)

비활성화된 인스턴스의 수입니다.

notifiedInstanceCount

string (int64 format)

패치 작업에 대해 통지된 인스턴스의 수입니다.

startedInstanceCount

string (int64 format)

시작된 인스턴스의 수입니다.

downloadingPatchesInstanceCount

string (int64 format)

패치를 다운로드 중인 인스턴스의 수입니다.

applyingPatchesInstanceCount

string (int64 format)

패치를 적용 중인 인스턴스의 수입니다.

rebootingInstanceCount

string (int64 format)

재부팅 중인 인스턴스의 수입니다.

succeededInstanceCount

string (int64 format)

성공적으로 완료된 인스턴스의 수입니다.

succeededRebootRequiredInstanceCount

string (int64 format)

재부팅이 필요한 인스턴스의 수입니다.

failedInstanceCount

string (int64 format)

실패한 인스턴스의 수입니다.

ackedInstanceCount

string (int64 format)

확인하고 곧 시작될 인스턴스의 수입니다.

timedOutInstanceCount

string (int64 format)

패치를 적용하는 동안 타임아웃을 넘긴 인스턴스의 수입니다.

prePatchStepInstanceCount

string (int64 format)

패치 이전 단계를 실행 중인 인스턴스의 수입니다.

postPatchStepInstanceCount

string (int64 format)

패치 이후 단계를 실행 중인 인스턴스의 수입니다.

noAgentDetectedInstanceCount

string (int64 format)

에이전트를 실행하지 않는 것으로 보이는 인스턴스의 수입니다. 에이전트가 설치되어 실행 중이며 서비스와 통신할 수 있는지 확인합니다.

메서드

cancel

패치 작업을 취소합니다.

execute

패치 작업을 만들고 실행하여 VM 인스턴스에 패치를 적용합니다.

get

패치 작업을 가져옵니다.

list

패치 작업 목록을 가져옵니다.