이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Deployments: stop
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

승인 필요

진행 중인 작업을 중지합니다. 이렇게 해도 이미 완료된 작업은 롤백되지 않지만 새 작업이 시작되지 않습니다. 지금 사용해 보기

요청

HTTP 요청

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

매개변수

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

승인

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

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

요청 본문

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

{
  "fingerprint": bytes
}

속성 이름	값	설명	참고
`fingerprint`	`bytes`	`stop()` 요청의 디지털 지문을 지정합니다. 지문은 낙관적 잠금을 실행하기 위해 `stop()` 요청에 제공해야 하는 무작위로 생성된 값입니다. 이렇게 하면 배포에 충돌하는 요청이 없도록 낙관적 동시 실행이 보장됩니다. 예를 들어 한 사용자가 새 업데이트 요청을 시도하는 동안 다른 사용자가 진행 중인 업데이트 요청을 중지하려고 하면 충돌이 방지됩니다. 지문은 처음에 배포 관리자에 의해 생성되며 배포를 수정할 때마다 변경됩니다. 최신 지문 값을 가져오려면 배포에 대해 `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` 등의 작업 유형입니다.
`targetLink`	`string`	[출력 전용] 작업이 수정하는 리소스의 URL입니다. 스냅샷 생성과 관련된 작업의 경우 스냅샷이 생성된 영구 디스크를 가리킵니다.
`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`)가 포함됩니다.
`selfLink`	`string`	[출력 전용] 리소스의 서버 정의 URL입니다.
`region`	`string`	[출력 전용] 작업이 상주하는 지역의 URL입니다. 지역 작업을 실행할 때만 사용할 수 있습니다. 이 필드는 HTTP 요청 URL의 일부로 지정해야 합니다. 요청 본문에서 필드로 설정할 수 없습니다.
`description`	`string`	[출력 전용] 작업의 텍스트 설명입니다. 작업이 생성될 때 설정됩니다.

사용해 보기

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

Deployments: stop 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

요청

HTTP 요청

매개변수

승인

요청 본문

응답

사용해 보기

Deployments: stop
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.