REST Resource: projects.locations.operations

리소스: 작업

이 리소스는 네트워크 API 호출의 결과인 장기 실행 작업을 나타냅니다.

JSON 표현 
{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field result.
}
필드
name

string

서버에 할당된 이름으로, 해당 이름을 최초로 반환한 서비스 내에서만 고유합니다. 기본 HTTP 매핑을 사용하는 경우 name은 operations/{uniqueId}로 끝나는 리소스 이름이어야 합니다.
metadata

object

{

createTime: 작업이 생성된 시간입니다.

endTime: 작업이 실행을 완료한 시간입니다.

target: 작업 대상에 대한 서버 정의 리소스 경로입니다.

verb: 작업에 의해 실행된 동사의 이름입니다.

statusDetail: 사람이 읽을 수 있는 작업 상태입니다(있는 경우).

cancelRequested: 사용자가 작업 취소를 요청했는지를 나타냅니다. 성공적으로 취소된 작업에는 Operation.error 값에 google.rpc.Status.code가 1로 설정되며 이는 Code.CANCELLED에 해당합니다.

apiVersion: 작업을 시작하는 데 사용된 API 버전입니다.

}
done

boolean

값이 false이면 작업이 아직 진행 중이라는 의미입니다. true이면 작업이 완료된 것이며, error 또는 response를 사용할 수 있습니다.
통합 필드 result는 작업 결과로, error 또는 유효한 response일 수 있습니다. done == false이면 error와 response가 모두 설정되지 않습니다. done == true이면 error 또는 response 중 정확히 하나를 설정할 수 있습니다. 일부 서비스는 결과를 제공하지 않을 수 있습니다. result는 다음 중 하나여야 합니다.
error

object (Status)

실패하거나 취소된 작업의 오류 결과입니다.
response

object

정상적인 성공한 작업 응답입니다. Delete와 같이 원래 메서드가 성공 시 데이터를 반환하지 않는 경우 응답은 google.protobuf.Empty입니다. 원래 메서드가 표준 Get/Create/Update이면 응답은 리소스여야 합니다. 다른 메서드의 경우 응답은 XxxResponse 유형이어야 하며, 여기에서 Xxx는 원래 메서드의 이름입니다. 예를 들어 원래 메서드 이름이 TakeSnapshot()이면 추론된 응답 유형은 TakeSnapshotResponse입니다.

메서드

cancel

 장기 실행 작업에 대한 비동기 취소를 시작합니다.

delete

 장기 실행 작업을 삭제합니다.

get

 장기 실행 작업의 최신 상태를 가져옵니다.

list

 요청에 지정된 필터와 일치하는 작업을 나열합니다.