Deployments: patch

배포 매니페스트에 설명된 배포 및 모든 리소스를 패치합니다. 이 메서드는 패치 시맨틱스를 지원합니다. 사용해 보기.

요청

HTTP 요청

PATCH https://www.googleapis.com/deploymentmanager/v2/projects/project/global/deployments/deployment

매개변수

매개변수 이름 값 설명
경로 매개변수
deployment string 이 요청의 배포 이름입니다.
project string 이 요청의 프로젝트 ID입니다.
선택적 쿼리 매개변수
createPolicy string 새 리소스를 만드는 데 사용할 정책을 설정합니다.

허용되는 값은 다음과 같습니다.
  • 'ACQUIRE': 기존 리소스를 획득합니다. 리소스가 없으면 배포가 실패합니다.
  • 'CREATE_OR_ACQUIRE': 리소스가 있는 경우 리소스를 획득하고, 없는 경우 리소스를 만듭니다. (기본)
deletePolicy string 리소스 삭제에 사용할 정책을 설정합니다.

허용되는 값은 다음과 같습니다.
  • 'ABANDON': Deployment Manager에서 리소스를 삭제하지만 기본 리소스는 삭제하지 않습니다.
  • 'DELETE': 배포 관리자에서 리소스를 삭제하고 기본 리소스를 삭제합니다. (기본)
preview boolean true로 설정하면 배포를 업데이트하고 '셸' 리소스를 만들고 업데이트하지만 이러한 리소스를 실제로 변경하거나 인스턴스화하지는 않습니다. 이렇게 하면 배포가 어떻게 표시되는지 미리 볼 수 있습니다. 이 인텐트를 사용하여 업데이트가 배포에 미치는 영향을 미리 볼 수 있습니다. 이 속성이 true로 설정된 경우 구성이 포함된 target.config를 제공해야 합니다. 배포를 미리 본 후 update()를 사용하여 요청하여 리소스를 배포하거나 cancelPreview()를 사용하여 미리보기를 완전히 삭제할 수 있습니다. 미리보기를 취소해도 배포는 계속 존재하며 삭제하려면 이 배포를 별도로 삭제해야 합니다. (기본값: false)

요청 본문

요청 본문에는 패치 시맨틱스의 규칙에 따라 Deployments 리소스의 관련 부분을 제공합니다.

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.

{
  "kind": "deploymentmanager#operation",
  "id": unsigned long,
  "creationTimestamp": string,
  "name": string,
  "zone": string,
  "clientOperationId": string,
  "operationType": string,
  "targetLink": string,
  "targetId": unsigned long,
  "status": string,
  "statusMessage": string,
  "user": string,
  "progress": integer,
  "insertTime": string,
  "startTime": string,
  "endTime": string,
  "error": {
    "errors": [
      {
        "code": string,
        "location": string,
        "message": string
      }
    ]
  },
  "warnings": [
    {
      "code": string,
      "message": string,
      "data": [
        {
          "key": string,
          "value": string
        }
      ]
    }
  ],
  "httpErrorStatusCode": integer,
  "httpErrorMessage": string,
  "selfLink": string,
  "region": string,
  "description": string
}
속성 이름 값 설명 참고
kind string [출력 전용] 리소스의 유형입니다. 작업 리소스의 경우 항상 compute#operation입니다.
id unsigned long [출력 전용] 리소스의 고유 식별자입니다. 이 식별자는 서버에 의해 정의됩니다.
creationTimestamp string [지원 중단됨] 이 필드는 지원 중단되었습니다.
name string [출력 전용] 리소스의 이름입니다.
zone string [출력 전용] 작업이 상주하는 영역의 URL입니다. 영역별 작업을 실행할 때만 사용할 수 있습니다. 이 필드는 HTTP 요청 URL의 일부로 지정해야 합니다. 요청 본문에서 필드로 설정할 수 없습니다.
clientOperationId string [출력 전용] 요청에 `requestId` 를 제공한 경우 해당 값입니다. 그렇지 않으면 존재하지 않습니다.
operationType string [출력 전용] insert, update, delete 등의 작업 유형입니다.
targetId unsigned long [출력 전용] 대상 리소스의 특정 구체화를 식별하는 고유한 대상 ID입니다.
status string [출력 전용] 작업의 상태로, PENDING, RUNNING, DONE 중 하나일 수 있습니다.
statusMessage string [출력 전용] 작업의 현재 상태에 대한 선택적인 텍스트 설명입니다.
user string [출력 전용] 작업을 요청한 사용자입니다(예: user@example.com).
progress integer [출력 전용] 0부터 100 사이의 선택적 진행률 표시기입니다. 반드시 선형적일 필요는 없으며, 작업 세부사항을 지원할 필요도 없습니다. 작업이 완료될 시점을 추측하는 데 사용해서는 안 됩니다. 이 숫자는 작업이 진행될수록 단조롭게 증가해야 합니다.
insertTime string [출력 전용] 이 작업이 요청된 시간으로 이 값은 RFC3339 텍스트 형식입니다.
startTime string [출력 전용] 이 작업이 서버에 의해 시작된 시간으로 이 값은 RFC3339 텍스트 형식입니다.
endTime string [출력 전용] 이 작업이 완료된 시간입니다. 이 값은 RFC3339 텍스트 형식입니다.
error object [출력 전용] 작업을 처리하는 동안 오류가 발생하면 이 필드가 채워집니다.
error.errors[] list [출력 전용] 이 작업을 처리하는 동안 발생한 오류의 배열입니다.
error.errors[].code string [출력 전용] 이 오류의 오류 유형 식별자입니다.
error.errors[].location string [출력 전용] 오류를 일으킨 요청의 필드를 나타냅니다. 이 속성은 선택사항입니다.
error.errors[].message string [출력 전용] 사람이 읽을 수 있는 선택적인 오류 메시지입니다.
warnings[] list [출력 전용] 작업을 처리하는 동안 경고 메시지가 생성되면 이 필드가 채워집니다.
warnings[].code string [출력 전용] 경고 코드입니다(해당하는 경우). 예를 들어 Compute Engine은 응답에 결과가 없으면 NO_RESULTS_ON_PAGE를 반환합니다.
warnings[].message string [출력 전용] 사람이 읽을 수 있는 경고 코드 설명입니다.
warnings[].data[] list [출력 전용] 이 경고에 관한 메타데이터(key: value 형식)입니다. 예를 들면 다음과 같습니다. 
"data": [ { "key": "scope", "value": "zones/us-east1-d" }
warnings[].data[].key string [출력 전용] 반환되는 경고에 관한 세부정보를 제공하는 키입니다. 예를 들어 특정 영역에 대한 목록 요청에 결과가 없는 경고의 경우 이 키는 scope이고 키 값은 영역 이름일 수 있습니다. 지원 중단된 리소스와 추천 대체 리소스를 나타내는 키, 잘못된 네트워크 설정에 관한 경고 (예: 인스턴스가 IP 전달을 시도하지만 IP 전달이 사용 설정되지 않은 경우)도 다른 예가 될 수 있습니다.
warnings[].data[].value string [출력 전용] 키에 해당하는 경고 데이터 값입니다.
httpErrorStatusCode integer [출력 전용] 작업이 실패하면 이 필드에 반환된 HTTP 오류 상태 코드가 포함됩니다. 예를 들어 404은 리소스를 찾을 수 없음을 의미합니다.
httpErrorMessage string [출력 전용] 작업에 실패하면 이 필드에 반환된 HTTP 오류 메시지(예: NOT FOUND)가 포함됩니다.
region string [출력 전용] 작업이 상주하는 지역의 URL입니다. 지역 작업을 실행할 때만 사용할 수 있습니다. 이 필드는 HTTP 요청 URL의 일부로 지정해야 합니다. 요청 본문에서 필드로 설정할 수 없습니다.
description string [출력 전용] 작업의 텍스트 설명입니다. 작업이 생성될 때 설정됩니다.

사용해 보기

아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요. 또는 독립형 탐색기를 사용해 보세요.