패키지 google.cloud.bigquery.reservation.v1

색인

ReservationService

이 API를 사용하면 BigQuery 정액제 예약을 관리할 수 있습니다.

예약은 슬롯 형식의 연산 리소스를 사용자에게 제공합니다. BigQuery의 슬롯은 연산 능력의 단위로 동시 처리의 기본 단위로 사용됩니다. 여러 개로 파티션을 나눈 테이블 스캔 시 단일 슬롯은 테이블의 단일 파티션에서 작동합니다. 예약 리소스는 관리자 프로젝트 및 위치의 하위 리소스로 존재합니다(예: projects/myproject/locations/US/reservations/reservationName

용량 약정을 사용하면 사용 기간을 약정하여 BigQuery 작업의 컴퓨팅 용량을 슬롯 단위로 구매할 수 있습니다. 용량 약정 리소스는 관리자 프로젝트 및 위치의 하위 리소스로 존재합니다(예: projects/myproject/locations/US/capacityCommitments/id

CreateAssignment

rpc CreateAssignment(CreateAssignmentRequest) returns (Assignment)

제공된 프로젝트가 지정된 예약의 슬롯을 사용하여 특정 유형의 작업을 제출할 수 있게 해주는 할당 객체를 만듭니다.

현재 리소스(프로젝트, 폴더, 조직)에는 각 (job_type, 위치) 조합당 하나의 할당만 있을 수 있으며, 일치 유형의 모든 작업에 예약이 사용됩니다.

프로젝트, 폴더 또는 조직 계층 구조의 여러 수준에서 서로 다른 할당을 만들 수 있습니다. 쿼리를 실행하는 동안 이 할당은 프로젝트, 폴더, 조직 수준에서 해당 순서로 조회됩니다. 발견된 첫 번째 할당이 쿼리에 적용됩니다.

할당을 만들 때 다른 할당이 더 높은 수준에 있는지 여부는 중요하지 않습니다.

예를 들면 다음과 같습니다.

  • organizationA 조직에는 project1 프로젝트와 project2 프로젝트가 있습니다.
  • 세 항목(organizationA, project1, project2) 모두에 대해 할당을 생성하여 동일한 예약 또는 다른 예약에 매핑할 수 있습니다.

사용자에게 예약을 사용하는 프로젝트 및 이 예약을 소유한 프로젝트에 대한 'bigquery.admin' 권한이 없으면 google.rpc.Code.PERMISSION_DENIED를 반환합니다.

할당 위치가 예약 위치와 일치하지 않으면 google.rpc.Code.INVALID_ARGUMENT를 반환합니다.

승인 범위

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

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

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

CreateCapacityCommitment

rpc CreateCapacityCommitment(CreateCapacityCommitmentRequest) returns (CapacityCommitment)

새 용량 약정 리소스를 만듭니다.

승인 범위

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

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

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

CreateReservation

rpc CreateReservation(CreateReservationRequest) returns (Reservation)

새 예약 리소스를 만듭니다.

승인 범위

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

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

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

DeleteAssignment

rpc DeleteAssignment(DeleteAssignmentRequest) returns (Empty)

할당을 삭제합니다. 확장은 수행되지 않습니다.

예를 들면 다음과 같습니다.

  • organizationA 조직에는 project1project2라는 두 개의 프로젝트가 있습니다.
  • res1 예약이 있으며 이전에 생성되었습니다.
  • 이전에 CreateAssignment를 사용하여 항목과 예약 간에 <organizationA, res1><project1, res1> 같은 연결이 정의되었습니다.

이 예에서 <organizationA, res1> 할당을 삭제해도 다른 할당 <project1, res1>에는 영향을 주지 않습니다. 삭제 후에도 project1의 쿼리는 res1을 사용하지만 project2의 쿼리는 주문형 모드를 사용하도록 전환됩니다.

승인 범위

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

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

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

DeleteCapacityCommitment

rpc DeleteCapacityCommitment(DeleteCapacityCommitmentRequest) returns (Empty)

용량 약정을 삭제합니다. commitment_end_time 전에 용량 약정을 삭제하려고 하면 google.rpc.Code.FAILED_PRECONDITION 오류 코드와 함께 실패합니다.

승인 범위

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

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

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

DeleteReservation

rpc DeleteReservation(DeleteReservationRequest) returns (Empty)

예약을 삭제합니다. 예약에 할당이 있으면 google.rpc.Code.FAILED_PRECONDITION을 반환합니다.

승인 범위

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

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

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

GetBiReservation

rpc GetBiReservation(GetBiReservationRequest) returns (BiReservation)

BI 예약을 검색합니다.

승인 범위

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

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

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

GetCapacityCommitment

rpc GetCapacityCommitment(GetCapacityCommitmentRequest) returns (CapacityCommitment)

용량 약정 정보를 반환합니다.

승인 범위

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

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

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

GetReservation

rpc GetReservation(GetReservationRequest) returns (Reservation)

예약 정보를 반환합니다.

승인 범위

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

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

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

ListAssignments

rpc ListAssignments(ListAssignmentsRequest) returns (ListAssignmentsResponse)

할당을 나열합니다.

명시적으로 생성된 할당만 반환됩니다.

예를 들면 다음과 같습니다.

  • organizationA 조직에는 project1project2라는 두 개의 프로젝트가 있습니다.
  • res1 예약이 있으며 이전에 생성되었습니다.
  • 이전에 CreateAssignment를 사용하여 항목과 예약 간에 <organizationA, res1><project1, res1> 같은 연결이 정의되었습니다.

이 예에서 ListAssignments는 res1 예약에 대해 위의 두 할당만 반환하며 확장/병합은 수행되지 않습니다.

요청의 예약에는 와일드 카드 '-'를 사용할 수 있습니다. 이 경우 모든 할당은 지정된 프로젝트에 속하며 위치가 나열됩니다.

참고 프로젝트 및 위치에 '-'를 사용할 수 없습니다.

승인 범위

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

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

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

ListCapacityCommitments

rpc ListCapacityCommitments(ListCapacityCommitmentsRequest) returns (ListCapacityCommitmentsResponse)

관리자 프로젝트의 모든 용량 약정을 나열합니다.

승인 범위

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

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

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

ListReservations

rpc ListReservations(ListReservationsRequest) returns (ListReservationsResponse)

지정된 위치에 있는 프로젝트의 모든 예약을 나열합니다.

승인 범위

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

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

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

MergeCapacityCommitments

rpc MergeCapacityCommitments(MergeCapacityCommitmentsRequest) returns (CapacityCommitment)

동일한 요금제의 용량 약정을 단일 약정으로 병합합니다.

그 결과 용량 약정은 병합할 용량 약정 중에서 더 긴 commitment_end_time을 갖게 됩니다.

다른 요금제의 용량 약정을 병합하려고 하면 오류 코드 google.rpc.Code.FAILED_PRECONDITION과 함께 실패합니다.

승인 범위

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

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

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

MoveAssignment

rpc MoveAssignment(MoveAssignmentRequest) returns (Assignment)

새 예약 아래로 할당을 이동합니다.

이것은 할당된 담당자에게 항상 연결된 예약이 있도록 트랜잭션 변경사항을 제공하여 기존 할당을 삭제하고 새 할당을 다시 만드는 것과는 다릅니다.

승인 범위

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

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

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

SearchAssignments

rpc SearchAssignments(SearchAssignmentsRequest) returns (SearchAssignmentsResponse)

특정 리전의 지정된 리소스에 대한 할당을 조회합니다. 프로젝트에 대한 요청인 경우:

  1. 프로젝트에 생성된 할당이 있으면 해당 할당이 반환됩니다.
  2. 그렇지 않으면 가장 가까운 상위 항목에 생성된 할당이 반환됩니다.
  3. 다른 JobTypes에 대한 할당이 모두 반환됩니다.

요청이 폴더에 관한 경우에도 동일한 로직이 적용됩니다.

조직에 대한 요청인 경우 조직에 생성된 할당이 반환됩니다(조직에는 상위 항목이 없음).

ListAssignments와 비교할 때 동작 면에서 다음과 같은 몇 가지 차이가 있습니다.

  1. 할당된 담당자의 권한이 이 API에서 확인됩니다.
  2. 계층 구조 조회(프로젝트 -> 폴더 -> 조직)가 이 API에서 발생합니다.
  3. 이때 상위 요소는 projects/*/locations/*reservations/* 대신 projects/*/locations/*입니다.

참고 프로젝트 및 위치에 '-'를 사용할 수 없습니다.

승인 범위

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

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

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

SplitCapacityCommitment

rpc SplitCapacityCommitment(SplitCapacityCommitmentRequest) returns (SplitCapacityCommitmentResponse)

용량 약정을 요금제와 commitment_end_time이 동일한 두 약정으로 분할합니다.

일반적인 사용 사례는 약정을 다운그레이드하는 것입니다.

예를 들어 10,000개의 슬롯에서 8,000개로 다운그레이드하려면 10,000개의 용량 약정을 2,000개와 8000개로 분할할 수 있습니다. 그런 다음 첫 번째의 계획을 FLEX로 변경한 후에 삭제합니다.

승인 범위

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

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

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

UpdateBiReservation

rpc UpdateBiReservation(UpdateBiReservationRequest) returns (BiReservation)

BI 예약을 업데이트합니다.

field_mask에 지정된 필드만 업데이트됩니다.

싱글톤 BI 예약은 항상 기본 크기 0으로 존재합니다. BI 용량을 예약하려면 0보다 큰 값으로 업데이트해야 합니다. BI 용량 예약을 해제하려면 예약 크기를 0으로 설정해야 합니다.

승인 범위

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

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

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

UpdateCapacityCommitment

rpc UpdateCapacityCommitment(UpdateCapacityCommitmentRequest) returns (CapacityCommitment)

기존 용량 약정을 업데이트합니다.

planrenewal_plan 필드만 업데이트할 수 있습니다.

요금제는 약정 기간이 더 긴 요금제로만 변경할 수 있습니다. 약정 기간이 더 짧은 요금제로 변경하려고 하면 google.rpc.Code.FAILED_PRECONDITION 오류 코드와 함께 실패합니다.

승인 범위

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

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

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

UpdateReservation

rpc UpdateReservation(UpdateReservationRequest) returns (Reservation)

기존 예약 리소스를 업데이트합니다.

승인 범위

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

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

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

Assignment

할당은 프로젝트에서 지정된 예약의 슬롯을 사용하여 특정 유형의 작업을 제출하도록 허용합니다.

필드
name

string

출력 전용. 리소스의 이름입니다. 예: projects/myproject/locations/US/reservations/team1-prod/assignments/123

assignee

string

예약을 사용하는 리소스입니다. 예: projects/myproject, folders/123 또는 organizations/456

job_type

JobType

예약을 사용하는 작업 유형입니다.

state

State

출력 전용. 할당의 상태입니다.

JobType

예약 사용 시 지정할 수 있는 작업 유형입니다.

열거형
JOB_TYPE_UNSPECIFIED 잘못된 유형. 이 값이 포함된 요청은 오류 코드 google.rpc.Code.INVALID_ARGUMENT와 함께 거부됩니다.
PIPELINE 프로젝트의 파이프라인(로드/내보내기) 작업에서 예약을 사용합니다.
QUERY 프로젝트의 쿼리 작업에서 예약을 사용합니다.

상태

활성 용량 약정이 없으면 할당은 PENDING 상태로 유지됩니다. 용량 약정이 활성화되면 할당은 ACTIVE 상태가 됩니다.

열거형
STATE_UNSPECIFIED 잘못된 상태 값입니다.
PENDING 관련 할당이 대기 중인 경우 담당자의 쿼리가 주문형으로 실행됩니다.
ACTIVE 할당이 준비되었습니다.

BiReservation

BI 예약을 나타냅니다.

필드
name

string

싱글톤 BI 예약의 리소스 이름입니다. 예약 이름은 projects/{project_id}/locations/{location_id}/bireservation 형식입니다.

update_time

Timestamp

출력 전용. 예약의 마지막 업데이트 타임스탬프입니다.

size

int64

예약 크기(바이트)입니다.

CapacityCommitment

용량 약정을 사용하면 사용 기간을 약정하여 BigQuery 작업의 컴퓨팅 용량을 슬롯 단위로 구매할 수 있습니다. 연간 약정은 기본적으로 갱신됩니다. 약정 종료 시간이 지난 후에 약정을 삭제할 수 있습니다.

연간 약정을 삭제하려면 먼저 요금제를 월간 또는 탄력 요금제로 변경해야 합니다.

용량 약정 리소스는 관리자 프로젝트의 하위 리소스로 존재합니다.

필드
name

string

출력 전용. 용량 약정의 리소스 이름입니다. 예: projects/myproject/locations/US/capacityCommitments/123

slot_count

int64

이 약정의 슬롯 수입니다.

plan

CommitmentPlan

용량 약정 요금제입니다.

state

State

출력 전용. 약정 상태입니다.

commitment_end_time

Timestamp

출력 전용. 현재 약정 기간의 종료 시점입니다. ACTIVE 용량 약정에만 적용됩니다.

failure_status

Status

출력 전용. FAILED 약정 요금제의 경우 실패 이유를 제공합니다.

renewal_plan

CommitmentPlan

commitment_end_time이 지난 후에 이 용량 약정이 전환되는 요금제입니다. 요금제를 변경하면 약정 요금제에 따라 약정 기간이 연장됩니다. ANNUAL 및 TRIAL 약정에만 적용됩니다.

CommitmentPlan

약정 요금제는 현재 약정 기간을 정의합니다. 약정 기간에는 용량 약정을 삭제할 수 없습니다.

열거형
COMMITMENT_PLAN_UNSPECIFIED 잘못된 요금제 값. 이 값이 포함된 요청은 오류 코드 google.rpc.Code.INVALID_ARGUMENT와 함께 거부됩니다.
FLEX 가변형 약정 기간은 ACTIVE가 된 후 1분입니다. 이후에는 약정 기간이 아니므로 언제든지 삭제할 수 있습니다.
TRIAL 무료 체험판 약정 기간은 ACTIVE 상태가 된 후부터 182일입니다. 이후 renewal_plan에 따라 새 약정으로 전환됩니다. 무료 체험판 약정의 기본 renewal_plan은 약정 기간이 종료된 후 바로 삭제할 수 있는 Flex입니다.
MONTHLY 월간 약정 기간은 ACTIVE 상태가 된 후 30일입니다. 이후에는 약정 기간이 아니므로 언제든지 삭제할 수 있습니다.
ANNUAL 연간 약정 기간은 ACTIVE 상태가 된 후 365일입니다. 이후 renewal_plan에 따라 새 약정으로 전환됩니다.

상태

용량 약정은 즉시 ACTIVE 상태가 되거나 PENDING 상태에서 ACTIVE 또는 FAILED 상태로 전환될 수 있습니다.

열거형
STATE_UNSPECIFIED 잘못된 상태 값입니다.
PENDING 용량 약정이 프로비저닝 대기 중입니다. 대기 중인 용량 약정은 상위 요소의 slot_capacity에 영향을 미치지 않습니다.
ACTIVE 슬롯이 프로비저닝되면 용량 약정이 ACTIVE 상태가 됩니다. slot_count가 상위 요소의 slot_capacity에 추가됩니다.
FAILED 백엔드에서 용량 약정을 활성화하지 못했습니다.

CreateAssignmentRequest

ReservationService.CreateAssignment의 요청입니다. 참고: 할당된 담당자는 'bigquery.reservationAssignments.create' 권한이 필요합니다.

필드
parent

string

필수. 할당의 상위 리소스 이름입니다(예: projects/myproject/locations/US/reservations/team1-prod).

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • bigquery.reservationAssignments.create
assignment

Assignment

만들 할당 리소스입니다.

CreateCapacityCommitmentRequest

ReservationService.CreateCapacityCommitment의 요청입니다.

필드
parent

string

필수. 상위 예약의 리소스 이름입니다. 예: projects/myproject/locations/US

capacity_commitment

CapacityCommitment

만들 용량 약정의 콘텐츠입니다.

enforce_single_admin_project_per_org

bool

true이면 조직의 다른 프로젝트에 용량 약정이 있는 경우 요청이 실패합니다.

CreateReservationRequest

ReservationService.CreateReservation의 요청입니다.

필드
parent

string

필수. 프로젝트 및 위치입니다. 예: projects/myproject/locations/US

reservation_id

string

예약 ID. 이 필드에는 소문자 영숫자 문자 또는 대시만 포함해야 합니다. 최대 길이는 64자(영문 기준)입니다.

reservation

Reservation

새로 만들 예약의 정의입니다.

DeleteAssignmentRequest

ReservationService.DeleteAssignment의 요청입니다. 참고: 할당된 담당자는 'bigquery.reservationAssignments.delete' 권한이 필요합니다.

필드
name

string

필수. 리소스의 이름입니다. 예: projects/myproject/locations/US/reservations/team1-prod/assignments/123

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • bigquery.reservationAssignments.delete

DeleteCapacityCommitmentRequest

ReservationService.DeleteCapacityCommitment의 요청입니다.

필드
name

string

필수. 삭제할 용량 약정의 리소스 이름입니다. 예: projects/myproject/locations/US/capacityCommitments/123

DeleteReservationRequest

ReservationService.DeleteReservation의 요청입니다.

필드
name

string

필수. 검색할 예약의 리소스 이름입니다. 예: projects/myproject/locations/US/reservations/team1-prod

GetBiReservationRequest

싱글톤 BI 예약을 가져오는 요청입니다.

필드
name

string

필수. 요청된 예약의 이름입니다. 예: projects/{project_id}/locations/{location_id}/bireservation

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • bigquery.bireservations.get

GetCapacityCommitmentRequest

ReservationService.GetCapacityCommitment의 요청입니다.

필드
name

string

필수. 검색할 용량 약정의 리소스 이름입니다. 예: projects/myproject/locations/US/capacityCommitments/123

GetReservationRequest

ReservationService.GetReservation의 요청입니다.

필드
name

string

필수. 검색할 예약의 리소스 이름입니다. 예: projects/myproject/locations/US/reservations/team1-prod

ListAssignmentsRequest

ReservationService.ListAssignments의 요청입니다.

필드
parent

string

필수. 상위 리소스 이름. 예:

projects/myproject/locations/US/reservations/team1-prod

또는

projects/myproject/locations/US/reservations/-

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • bigquery.reservationAssignments.list
page_size

int32

페이지당 반환하는 최대 항목 수입니다.

page_token

string

이전 List 요청에서 반환된 next_page_token 값입니다(있는 경우).

ListAssignmentsResponse

ReservationService.ListAssignments의 응답입니다.

필드
assignments[]

Assignment

사용자에게 표시되는 할당 목록입니다.

next_page_token

string

결과의 다음 페이지를 검색하는 토큰이거나 목록에 더 이상 결과가 없으면 비어 있습니다.

ListCapacityCommitmentsRequest

ReservationService.ListCapacityCommitments의 요청입니다.

필드
parent

string

필수. 상위 예약의 리소스 이름입니다. 예: projects/myproject/locations/US

page_size

int32

반환할 최대 항목 수입니다.

page_token

string

이전 List 요청에서 반환된 next_page_token 값입니다(있는 경우).

ListCapacityCommitmentsResponse

ReservationService.ListCapacityCommitments의 응답입니다.

필드
capacity_commitments[]

CapacityCommitment

사용자에게 표시되는 용량 약정 목록입니다.

next_page_token

string

결과의 다음 페이지를 검색하는 토큰이거나 목록에 더 이상 결과가 없으면 비어 있습니다.

ListReservationsRequest

ReservationService.ListReservations의 요청입니다.

필드
parent

string

필수. 프로젝트 및 위치를 포함한 상위 리소스 이름입니다. 예: 'projects/myproject/locations/US'

page_size

int32

페이지당 반환하는 최대 항목 수입니다.

page_token

string

이전 List 요청에서 반환된 next_page_token 값입니다(있는 경우).

ListReservationsResponse

ReservationService.ListReservations의 응답입니다.

필드
reservations[]

Reservation

사용자에게 표시되는 예약 목록입니다.

next_page_token

string

결과의 다음 페이지를 검색하는 토큰이거나 목록에 더 이상 결과가 없으면 비어 있습니다.

MergeCapacityCommitmentsRequest

ReservationService.MergeCapacityCommitments의 요청입니다.

필드
parent

string

관리자 프로젝트 및 위치를 식별하는 상위 리소스입니다. 예: projects/myproject/locations/us

capacity_commitment_ids[]

string

병합할 용량 약정의 ID입니다. 이러한 용량 약정은 상위 요소에 지정된 관리 프로젝트와 위치에 있어야 합니다.

MoveAssignmentRequest

ReservationService.MoveAssignment의 요청입니다.

참고: destination_id는 'bigquery.reservationAssignments.create' 권한이 필요합니다.

참고: 할당된 담당자는 'bigquery.reservationAssignments.create' 및 'bigquery.reservationAssignments.delete' 권한이 필요합니다.

필드
name

string

필수. 할당의 리소스 이름입니다(예: projects/myproject/locations/US/reservations/team1-prod/assignments/123).

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • bigquery.reservationAssignments.delete
destination_id

string

새 예약 ID입니다. 예: projects/myotherproject/locations/US/reservations/team2-prod

예약

예약은 사용자에게 슬롯을 제공하는 데 사용되는 메커니즘입니다.

필드
name

string

예약의 리소스 이름입니다. 예: projects/*/locations/*/reservations/team1-prod

slot_capacity

int64

이 예약에 사용할 수 있는 최소 슬롯입니다. BigQuery의 슬롯은 연산 능력의 단위로 동시 처리의 단위로 사용됩니다.

이 예약을 사용하는 쿼리는 ignore_idle_slots가 false로 설정되면 런타임 시 더 많은 슬롯을 사용할 수 있습니다.

새 예약의 슬롯 용량이 상위 요소의 슬롯 용량을 초과하거나 새 예약 및 같은 수준의 예약의 총 슬롯 용량이 상위 요소의 슬롯 용량을 초과하면 요청이 google.rpc.Code.RESOURCE_EXHAUSTED와 함께 실패합니다.

ignore_idle_slots

bool

false이면 이 예약을 사용하는 쿼리는 동일한 관리 프로젝트 내의 다른 예약에서 유휴 슬롯을 사용합니다. true이면 이 예약을 사용하는 쿼리가 위에 지정된 슬롯 용량으로 실행됩니다.

SearchAssignmentsRequest

ReservationService.SearchAssignments의 요청입니다. 참고: 할당된 담당자는 'bigquery.reservationAssignments.search' 권한이 필요합니다.

필드
parent

string

필수. 프로젝트 및 위치를 포함하는 관리 프로젝트의 리소스 이름입니다. 예: 'projects/myproject/locations/US'

query

string

리소스 이름을 쿼리의 할당된 담당자로 지정하세요.

예를 들면 다음과 같습니다.

  • assignee=projects/myproject
  • assignee=folders/123
  • assignee=organizations/456
page_size

int32

페이지당 반환하는 최대 항목 수입니다.

page_token

string

이전 List 요청에서 반환된 next_page_token 값입니다(있는 경우).

SearchAssignmentsResponse

ReservationService.SearchAssignments의 응답입니다.

필드
assignments[]

Assignment

사용자에게 표시되는 할당 목록입니다.

next_page_token

string

결과의 다음 페이지를 검색하는 토큰이거나 목록에 더 이상 결과가 없으면 비어 있습니다.

SplitCapacityCommitmentRequest

ReservationService.SplitCapacityCommitment의 요청입니다.

필드
name

string

필수. 리소스 이름입니다. 예: projects/myproject/locations/US/capacityCommitments/123

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • bigquery.capacityCommitments.update
slot_count

int64

분할 후 용량 약정의 슬롯 수입니다.

SplitCapacityCommitmentResponse

ReservationService.SplitCapacityCommitment의 응답입니다.

필드
first

CapacityCommitment

첫 번째 용량 약정(분할 결과)입니다.

second

CapacityCommitment

두 번째 용량 약정(분할 결과)입니다.

UpdateBiReservationRequest

BI 예약을 업데이트하는 요청입니다.

필드
bi_reservation

BiReservation

업데이트할 예약입니다.

승인을 처리하려면 지정된 리소스 biReservation에 대해 다음과 같은 IAM 권한이 필요합니다.

  • bigquery.bireservations.update
update_mask

FieldMask

이 요청에서 업데이트할 필드 목록입니다.

UpdateCapacityCommitmentRequest

ReservationService.UpdateCapacityCommitment의 요청입니다.

필드
capacity_commitment

CapacityCommitment

업데이트할 용량 약정의 콘텐츠입니다.

update_mask

FieldMask

업데이트할 필드 집합의 표준 필드 마스크입니다.

UpdateReservationRequest

ReservationService.UpdateReservation의 요청입니다.

필드
reservation

Reservation

업데이트할 예약의 콘텐츠입니다.

update_mask

FieldMask

업데이트할 필드 집합의 표준 필드 마스크입니다.