REST 리소스: 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 매핑을 사용하는 경우 nameoperations/some/unique/name 형식이어야 합니다.

metadata

object

작업과 관련된 서비스별 메타데이터입니다. 일반적으로 진행률 정보 및 생성 시간과 같은 일반 메타데이터가 포함됩니다. 일부 서비스는 이러한 메타데이터를 제공하지 않을 수 있습니다. 장기 실행 작업을 반환하는 메소드는 메타데이터 유형이 있는 경우 이를 문서화해야 합니다.

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }

done

boolean

값이 false이면 작업이 아직 진행 중이라는 의미입니다. true이면 작업이 완료된 것이며, error 또는 response를 사용할 수 있습니다.

공용체 필드 result는 작업 결과로 error 또는 유효한 response일 수 있습니다. done == false이면 errorresponse도 설정되지 않습니다. done == true이면 error 또는 response 중 하나만 설정됩니다. result는 다음 중 하나여야 합니다.
error

object(Status)

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

response

object

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

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }

메소드

cancel

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

delete

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

get

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

list

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