Deployments: cancelPreview

승인 필요

현재 배포와 연결된 미리보기를 취소하고 삭제합니다. 지금 사용해 보기

요청

HTTP 요청

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

매개변수

매개변수 이름 값 설명
경로 매개변수
deployment string 이 요청의 배포 이름입니다.
project string 이 요청의 프로젝트 ID입니다.

승인

이 요청에는 다음 범위 중 하나 이상에 대한 승인이 필요합니다 (인증 및 승인 자세히 알아보기).

범위
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/ndev.cloudman

요청 본문

요청 본문에 다음과 같은 구조의 데이터를 제공합니다.

{
  "fingerprint": bytes
}
속성 이름 값 설명 참고
fingerprint bytes cancelPreview() 요청의 디지털 지문을 지정합니다. 지문은 낙관적 잠금을 실행하기 위해 cancelPreview() 요청에 제공해야 하는 무작위로 생성된 값입니다. 이렇게 하면 배포에 요청이 충돌하지 않도록 낙관적 동시 실행이 보장됩니다. 예를 들어 한 사용자가 새 업데이트 요청을 시도하는 동안 다른 사용자가 미리보기를 취소하려고 하면 요청 중 하나가 방지됩니다.

지문은 처음에 배포 관리자에 의해 생성되며 배포를 수정할 때마다 변경됩니다. 최신 지문 값을 가져오려면 배포에 대해 get() 요청을 실행합니다.

응답

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

{
  "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 [출력 전용] 작업의 텍스트 설명입니다. 작업이 생성될 때 설정됩니다.