메서드: operations.list

요청에 지정된 필터와 일치하는 작업을 나열합니다. 서버에서 이 메서드를 지원하지 않는 경우 UNIMPLEMENTED가 반환됩니다.

참고: API 서비스는 name 바인딩을 재정의하여 users/*/operations 등의 다른 리소스 이름 스키마를 사용할 수 있습니다. API 서비스에서 바인딩을 재정의하려면 해당 서비스 구성에 "/v1/{name=users/*}/operations" 등의 바인딩을 추가합니다. 이전 버전과의 호환성을 위해 기본 이름에 작업 컬렉션 ID가 포함되지만, 재정의하는 사용자는 이름 바인딩이 작업 컬렉션 ID가 없는 상위 리소스인지 확인해야 합니다.

HTTP 요청

GET https://bigqueryreservation.googleapis.com/v1/{name}

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

작업의 상위 리소스 이름입니다.

쿼리 매개변수

매개변수
filter

string

표준 목록 필터입니다.
pageSize

integer

표준 목록 페이지 크기입니다.
pageToken

string

표준 목록 페이지 토큰입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.

Operations.ListOperations의 응답 메시지입니다.

JSON 표현 

{
  "operations": [
    {
      object (Operation)
    }
  ],
  "nextPageToken": string
}
필드
operations[]

object (Operation)

요청에 지정된 필터와 일치하는 작업 목록입니다.
nextPageToken

string

표준 목록 다음 페이지 토큰입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

작업

이 리소스는 네트워크 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/{unique_id}로 끝나는 리소스 이름이어야 합니다.
metadata

object

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

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예를 들면 다음과 같습니다. { "id": 1234, "@type": "types.example.com/standard/id" }
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입니다.

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

사용해 보기