Pacote google.cloud.bigquery.reservation.v1

Index

ReservationService

Esta API permite que os usuários gerenciem reservas de taxa fixa do BigQuery.

Uma reserva fornece garantias de recurso computacional na forma de slots aos usuários. Um slot é uma unidade de capacidade computacional no BigQuery. Ele funciona como unidade básica do paralelismo. Nas verificações de uma tabela multiparticionada, um único slot opera em uma única partição da tabela. Um recurso de reserva existe como recurso filho do projeto administrativo e do local, por exemplo: projects/myproject/locations/US/reservations/reservationName.

Um compromisso de capacidade é uma forma de adquirir capacidade de computação para jobs do BigQuery (na forma de slots) com um período de uso confirmado. Um recurso de confirmação de capacidade existe como recurso filho do projeto administrativo e do local, por exemplo: projects/myproject/locations/US/capacityCommitments/id

CreateAssignment

rpc CreateAssignment(CreateAssignmentRequest) returns (Assignment)

Cria um objeto de atribuição permitindo que o projeto em questão envie jobs de um determinado tipo usando slots da reserva especificada.

Atualmente, um recurso (projeto, pasta, organização) pode ter apenas uma atribuição por cada combinação (job_type, local), e essa reserva será usada para todos os jobs do mesmo tipo.

Diferentes atribuições podem ser criadas em diferentes níveis da hierarquia de projetos, pastas ou organizações. Durante a execução da consulta, a atribuição é pesquisada nos níveis do projeto, da pasta e da organização, nessa ordem. A primeira atribuição encontrada é aplicada à consulta.

Ao criar atribuições, não faz diferença se existem outras em níveis mais altos.

Exemplo:

  • A organização organizationA contém dois projetos, project1 e project2.
  • As atribuições para as três entidades (organizationA, project1 e project2) podem ser criadas e mapeadas para a mesma ou para reservas diferentes.

Retorna google.rpc.Code.PERMISSION_DENIED se o usuário não tiver permissões 'bigquery.admin' no projeto usando a reserva e o projeto em que está a reserva.

Retorna google.rpc.Code.INVALID_ARGUMENT quando o local da atribuição não corresponde ao local da reserva.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte a Visão geral da autenticação.

CreateCapacityCommitment

rpc CreateCapacityCommitment(CreateCapacityCommitmentRequest) returns (CapacityCommitment)

Cria um novo recurso de compromisso de capacidade.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

CreateReservation

rpc CreateReservation(CreateReservationRequest) returns (Reservation)

Cria um novo recurso de reserva.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

DeleteAssignment

rpc DeleteAssignment(DeleteAssignmentRequest) returns (Empty)

Exclui uma atribuição. Não haverá nenhuma expansão.

Exemplo:

  • Organização organizationA contém dois projetos, project1 e project2.
  • A reserva res1 existe e foi criada anteriormente.
  • CreateAssignment foi usado anteriormente para definir as seguintes associações entre entidades e reservas: <organizationA, res1> e <project1, res1>

Neste exemplo, a exclusão da atribuição <organizationA, res1> não afetará a outra atribuição <project1, res1>. Após essa exclusão, as consultas de project1 ainda usarão res1, enquanto as consultas de project2 mudarão para o modo sob demanda.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

DeleteCapacityCommitment

rpc DeleteCapacityCommitment(DeleteCapacityCommitmentRequest) returns (Empty)

Exclui uma confirmação de capacidade. A tentativa de excluir a confirmação de capacidade antes do commit_end_time resultará em erro com o código google.rpc.Code.FAILED_PRECONDITION.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

DeleteReservation

rpc DeleteReservation(DeleteReservationRequest) returns (Empty)

Exclui uma reserva. Retorna o google.rpc.Code.FAILED_PRECONDITION quando a reserva tiver atribuições.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte a Visão geral da autenticação.

GetBiReservation

rpc GetBiReservation(GetBiReservationRequest) returns (BiReservation)

Recupera uma reserva de BI.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

GetCapacityCommitment

rpc GetCapacityCommitment(GetCapacityCommitmentRequest) returns (CapacityCommitment)

Retorna informações sobre a confirmação de capacidade.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

GetReservation

rpc GetReservation(GetReservationRequest) returns (Reservation)

Retorna informações sobre a reserva.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

ListAssignments

rpc ListAssignments(ListAssignmentsRequest) returns (ListAssignmentsResponse)

Lista as atribuições.

Somente as atribuições criadas explicitamente serão retornadas.

Exemplo:

  • Organização organizationA contém dois projetos, project1 e project2.
  • A reserva res1 existe e foi criada anteriormente.
  • CreateAssignment foi usado anteriormente para definir as seguintes associações entre entidades e reservas: <organizationA, res1> e <project1, res1>

Neste exemplo, ListAssignments retornará apenas as duas atribuições acima para reserva res1, e nenhuma expansão/mesclagem ocorrerá.

O caractere curinga "-" pode ser usado para reservas na solicitação. Nesse caso, todas as atribuições pertencem ao projeto especificado e o local será listado.

Observe que não é possível usar "-" para projetos nem locais.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

ListCapacityCommitments

rpc ListCapacityCommitments(ListCapacityCommitmentsRequest) returns (ListCapacityCommitmentsResponse)

Lista todas as confirmações de capacidade do projeto administrativo.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

ListReservations

rpc ListReservations(ListReservationsRequest) returns (ListReservationsResponse)

Lista todas as reservas para o projeto no local especificado.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte a Visão geral da autenticação.

MergeCapacityCommitments

rpc MergeCapacityCommitments(MergeCapacityCommitmentsRequest) returns (CapacityCommitment)

Mescla os compromissos de capacidade do mesmo plano em um único compromisso.

O compromisso de capacidade resultante tem o maior commitment_end_time dos compromissos de capacidade a serem mesclados.

A tentativa de mesclar compromissos de capacidade de planos diferentes falhará e apresentará o código de erro google.rpc.Code.FAILED_PRECONDITION.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

MoveAssignment

rpc MoveAssignment(MoveAssignmentRequest) returns (Assignment)

Move uma tarefa para uma nova reserva.

Isso é diferente de remover uma atribuição existente e recriar uma nova proporcionando uma alteração transacional para que um responsável sempre tenha uma reserva associada.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

SearchAssignments

rpc SearchAssignments(SearchAssignmentsRequest) returns (SearchAssignmentsResponse)

Procura atribuições para um recurso especificado de uma região determinada. Se a solicitação for sobre um projeto:

  1. as atribuições criadas no projeto serão retornadas, caso existam;
  2. caso contrário, as atribuições criadas no ancestral mais próximo serão retornadas;
  3. atribuições para diferentes JobTypes serão retornadas.

A mesma lógica será aplicada se a solicitação for sobre uma pasta.

Se a solicitação for sobre uma organização, as atribuições criadas na organização serão retornadas (a organização não tem ancestrais).

Em comparação com ListAssignments, existem algumas diferenças de comportamento:

  1. a permissão no responsável será verificada nessa API;
  2. a pesquisa de hierarquia (projeto->pasta->organização) ocorre nessa API;
  3. o pai aqui é projects/*/locations/*, em vez de projects/*/locations/*reservations/*.

Observe que não é possível usar "-" para projetos nem locais.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte a Visão geral da autenticação.

SplitCapacityCommitment

rpc SplitCapacityCommitment(SplitCapacityCommitmentRequest) returns (SplitCapacityCommitmentResponse)

Divide o compromisso de capacidade em dois compromissos do mesmo plano e commitment_end_time.

Um caso de uso comum é ativar o downgrade de compromissos.

Por exemplo, para fazer downgrade de 10.000 slots para 8.000, divida um compromisso de capacidade de 10.000 em compromissos de 2.000 e 8.000. Depois, altere o plano do primeiro para FLEX e, em seguida, exclua-o.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte a Visão geral da autenticação.

UpdateBiReservation

rpc UpdateBiReservation(UpdateBiReservationRequest) returns (BiReservation)

Atualiza uma reserva de BI.

Somente os campos especificados no field_mask são atualizados.

Uma reserva de BI singleton sempre existe com o tamanho padrão 0. Para reservar a capacidade de BI, é necessário atualizá-la para um valor maior que 0. Para liberar a capacidade de BI, é necessário definir o tamanho da reserva como 0.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte a Visão geral da autenticação.

UpdateCapacityCommitment

rpc UpdateCapacityCommitment(UpdateCapacityCommitmentRequest) returns (CapacityCommitment)

Atualiza um compromisso de capacidade.

Somente os campos plan e renewal_plan podem ser atualizados.

Só é possível alterar um plano para outro de maior período de compromisso. A tentativa de mudar para um plano com um período de compromisso mais curto falhará e apresentará o código de erro google.rpc.Code.FAILED_PRECONDITION.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

UpdateReservation

rpc UpdateReservation(UpdateReservationRequest) returns (Reservation)

Atualiza um recurso de reserva atual.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

Atribuição

Uma atribuição permite que um projeto envie jobs de um determinado tipo usando slots da reserva especificada.

Campos
name

string

Somente saída. Nome do recurso. Exemplo: projects/myproject/locations/US/reservations/team1-prod/assignments/123

assignee

string

O recurso que usará a reserva. por exemplo: projects/myproject, folders/123 ou organizations/456.

job_type

JobType

Quais tipos de job usarão a reserva.

state

State

Somente saída. Estado da atribuição.

JobType

Tipos de job, que podem ser especificados ao usar a reserva.

Enums
JOB_TYPE_UNSPECIFIED Tipo inválido. As solicitações com esse valor serão rejeitadas com o código do erro google.rpc.Code.INVALID_ARGUMENT.
PIPELINE Os jobs de pipeline (carregar/exportar) do projeto usarão a reserva.
QUERY Os jobs de consulta do projeto usarão a reserva.

Estado

A atribuição permanecerá no estado PENDING se nenhum compromisso de capacidade ativo estiver presente. Ele se tornará ACTIVE quando um compromisso de capacidade se tornar ativo.

Enums
STATE_UNSPECIFIED Valor de estado inválido.
PENDING As consultas do responsável pela atribuição serão executadas sob demanda se a atribuição relacionada estiver pendente.
ACTIVE A atribuição está pronta.

BiReservation

Representa uma reserva de BI.

Campos
name

string

O nome do recurso da reserva de BI de singleton. Os nomes de reserva têm o formato projects/{project_id}/locations/{location_id}/bireservation.

update_time

Timestamp

Somente saída. O último carimbo de data/hora da atualização de uma reserva.

size

int64

Tamanho de uma reserva, em bytes.

CapacityCommitment

Compromisso de capacidade é uma maneira de adquirir capacidade computacional para jobs do BigQuery, na forma de slots, por um período de compromisso de uso. Os compromissos anuais são renovados por padrão. Os compromissos podem ser removidos após sua hora de término.

Para remover o compromisso anual, primeiro, o plano precisa ser alterado para mensal ou flexível.

O recurso de compromisso de capacidade existe como um recurso filho do projeto administrativo.

Campos
name

string

Apenas saída. O nome do recurso do compromisso de capacidade, por exemplo, projects/myproject/locations/US/capacityCommitments/123

slot_count

int64

Número de slots neste compromisso.

plan

CommitmentPlan

Plano de compromisso do compromisso de capacidade.

state

State

Somente saída. Estado da confirmação.

commitment_end_time

Timestamp

Somente saída. O fim do período de compromisso atual. Ele é aplicável apenas a compromissos de capacidade ACTIVE.

failure_status

Status

Somente saída. Para planos de comprometimento FAILED, dá o motivo da falha.

renewal_plan

CommitmentPlan

Plano para o qual esse compromisso de capacidade é convertido depois que o commitment_end_time passar. Depois que o plano é alterado, o período do compromisso é estendido de acordo com o respectivo plano. Aplicável somente a compromissos ANNUAL e TRIAL.

CommitmentPlan

O plano de compromisso define o período de compromisso atual. Não é possível excluir o compromisso de capacidade durante o período de compromisso dele.

Enums
COMMITMENT_PLAN_UNSPECIFIED Valor de plano inválido. As solicitações com esse valor serão rejeitadas com o código do erro google.rpc.Code.INVALID_ARGUMENT.
FLEX Compromissos flexíveis têm um período de compromisso de um minuto depois de se tornarem ACTIVE. Após esse tempo, eles deixarão de estar em um período de compromisso e, então, será possível removê-los a qualquer momento.
TRIAL As avaliações têm um período de compromisso de 182 dias depois de se tornarem ACTIVE. Depois disso, eles são convertidos em um novo compromisso com base no renewal_plan. A renovação padrão do plano de avaliação é o Flex para que possa ser excluído logo após o término do período de confirmação.
MONTHLY Compromissos mensais têm um período de compromisso de 30 dias após se tornarem ACTIVE. Após esse tempo, eles deixarão de estar em um período de compromisso e, então, será possível removê-los a qualquer momento.
ANNUAL Compromissos anuais têm um período de 365 dias após se tornarem ACTIVE. Depois disso, eles são convertidos em um novo compromisso com base no renewal_plan.

State

É possível que o compromisso de capacidade se torne ACTIVE imediatamente ou que passe de PENDING para ACTIVE ou FAILED.

Enums
STATE_UNSPECIFIED Valor de estado inválido.
PENDING A confirmação de capacidade está com provisionamento pendente. A confirmação de capacidade pendente não contribui para o slot_capacity do pai.
ACTIVE Assim que os slots forem provisionados, a confirmação de capacidade ficará ativa. O slot_count será adicionado à slot_capacity do pai.
FAILED O compromisso de capacidade falhará para ser ativado pelo back-end.

CreateAssignmentRequest

A solicitação para ReservationService.CreateAssignment. Observação: a permissão "bigquery.reservationAssignments.create" é obrigatória para o cessionário relacionado.

Campos
parent

string

Obrigatório. O nome do recurso pai da atribuição, por exemplo, projects/myproject/locations/US/reservations/team1-prod

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • bigquery.reservationAssignments.create
assignment

Assignment

Criar um recurso de atribuição.

CreateCapacityCommitmentRequest

A solicitação para ReservationService.CreateCapacityCommitment.

Campos
parent

string

Obrigatório. Nome do recurso da reserva pai. Ex.: projects/myproject/locations/US

capacity_commitment

CapacityCommitment

Conteúdo do compromisso de capacidade a ser criado.

enforce_single_admin_project_per_org

bool

Se verdadeiro, cancele a solicitação se outro projeto na organização tiver um compromisso de capacidade.

CreateReservationRequest

A solicitação para ReservationService.CreateReservation.

Campos
parent

string

Obrigatório. Projeto, local. Exemplo, projects/myproject/locations/US

reservation_id

string

O ID da reserva. É necessário que esse campo contenha apenas caracteres alfanuméricos em minúsculas ou travessão. O comprimento máximo é de 64 caracteres.

reservation

Reservation

Definição da nova reserva a ser criada.

DeleteAssignmentRequest

A solicitação para ReservationService.DeleteAssignment. Observação: a permissão "bigquery.reservationAssignments.delete" é obrigatória para o cessionário relacionado.

Campos
name

string

Obrigatório. Nome do recurso, por exemplo, projects/myproject/locations/US/reservations/team1-prod/assignments/123

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • bigquery.reservationAssignments.delete

DeleteCapacityCommitmentRequest

A solicitação para ReservationService.DeleteCapacityCommitment.

Campos
name

string

Obrigatório. Nome do recurso do compromisso de capacidade a ser excluído. Ex.: projects/myproject/locations/US/capacityCommitments/123

DeleteReservationRequest

A solicitação para ReservationService.DeleteReservation.

Campos
name

string

Obrigatório. Nome do recurso da reserva a ser recuperada. Ex.: projects/myproject/locations/US/reservations/team1-prod

GetBiReservationRequest

Uma solicitação para receber uma reserva de BI de singleton.

Campos
name

string

Obrigatório. Nome da reserva solicitada, por exemplo: projects/{project_id}/locations/{location_id}/bireservation

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • bigquery.bireservations.get

GetCapacityCommitmentRequest

A solicitação para ReservationService.GetCapacityCommitment.

Campos
name

string

Obrigatório. Nome do recurso da confirmação de capacidade a ser recuperada. Ex.: projects/myproject/locations/US/capacityCommitments/123

GetReservationRequest

A solicitação para ReservationService.GetReservation.

Campos
name

string

Obrigatório. Nome do recurso da reserva a ser recuperada. Ex.: projects/myproject/locations/US/reservations/team1-prod

ListAssignmentsRequest

A solicitação para ReservationService.ListAssignments.

Campos
parent

string

Obrigatório. O nome do recurso pai, por exemplo:

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

Ou:

projects/myproject/locations/US/reservations/-

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • bigquery.reservationAssignments.list
page_size

int32

O número máximo de itens que serão retornados por página.

page_token

string

O valor next_page_token retornado de uma solicitação List anterior, se houver.

ListAssignmentsResponse

A resposta para ReservationService.ListAssignments.

Campos
assignments[]

Assignment

Lista de atribuições visíveis para o usuário.

next_page_token

string

Token para recuperar a próxima página de resultados ou esvaziar se não houver mais resultados na lista.

ListCapacityCommitmentsRequest

A solicitação para ReservationService.ListCapacityCommitments.

Campos
parent

string

Obrigatório. Nome do recurso da reserva pai. Ex.: projects/myproject/locations/US

page_size

int32

Número máximo de itens a serem retornados.

page_token

string

Valor next_page_token retornado de uma solicitação List anterior, se houver.

ListCapacityCommitmentsResponse

A resposta para ReservationService.ListCapacityCommitments.

Campos
capacity_commitments[]

CapacityCommitment

Lista de compromissos de capacidade visíveis para o usuário.

next_page_token

string

Token para recuperar a próxima página de resultados ou esvaziar se não houver mais resultados na lista.

ListReservationsRequest

A solicitação para ReservationService.ListReservations.

Campos
parent

string

Obrigatório. O nome do recurso pai que contém o projeto e o local, por exemplo: "projects/myproject/locations/US"

page_size

int32

O número máximo de itens que serão retornados por página.

page_token

string

O valor next_page_token retornado de uma solicitação List anterior, se houver.

ListReservationsResponse

A resposta para ReservationService.ListReservations.

Campos
reservations[]

Reservation

Lista de atribuições visíveis para o usuário.

next_page_token

string

Token para recuperar a próxima página de resultados ou esvaziar se não houver mais resultados na lista.

MergeCapacityCommitmentsRequest

A solicitação para ReservationService.MergeCapacityCommitments.

Campos
parent

string

Recurso pai que identifica o projeto e o local do administrador, por exemplo: projects/myproject/locations/us

capacity_commitment_ids[]

string

Códigos dos compromissos de capacidade a serem mesclados. É necessário que esses compromissos de capacidade existam no projeto e no local do administrador especificados no principal.

MoveAssignmentRequest

A solicitação para ReservationService.MoveAssignment.

Observação: a permissão "bigquery.reservationAssignments.create" é exigida no destination_id.

Observação: as permissões "bigquery.reservationAssignments.create" e "bigquery.reservationAssignments.delete" são obrigatórias no responsável relacionado.

Campos
name

string

Obrigatório. O nome do recurso da atribuição, por exemplo, projects/myproject/locations/US/reservations/team1-prod/assignments/123

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • bigquery.reservationAssignments.delete
destination_id

string

O novo ID da reserva, por exemplo:

Reserva

Uma reserva é um mecanismo usado para garantir slots aos usuários.

Campos
name

string

O nome do recurso da reserva, por exemplo: projects/*/locations/*/reservations/team1-prod

slot_capacity

int64

Mínimo de slots disponíveis para esta reserva. Slot é uma unidade de capacidade computacional no BigQuery e funciona como unidade de paralelismo.

É possível que as consultas que usam essa reserva utilizem mais slots durante o tempo de execução se ignore_idle_slots estiver definido como falso.

Se a capacidade de slots da nova reserva exceder a capacidade de slots do pai ou se a capacidade de slots total da nova reserva e dos irmãos dela excederem a capacidade de slots do pai, a solicitação falhará com google.rpc.Code.RESOURCE_EXHAUSTED.

ignore_idle_slots

bool

Se for falso, qualquer consulta que usar essa reserva utilizará slots de outras reservas no mesmo projeto do administrador. Se verdadeiro, uma consulta que usar essa reserva será executada com a capacidade de slots especificada acima no máximo.

SearchAssignmentsRequest

A solicitação para ReservationService.SearchAssignments. Observação: a permissão "bigquery.reservationAssignments.search" é obrigatória para o cessionário relacionado.

Campos
parent

string

Obrigatório. O nome do recurso do projeto do administrador (com projeto e local), por exemplo: "projetos/meuprojeto/locais/BR".

query

string

Especifique o nome do recurso como responsável na consulta.

Exemplos:

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

int32

O número máximo de itens que serão retornados por página.

page_token

string

O valor next_page_token retornado de uma solicitação List anterior, se houver.

SearchAssignmentsResponse

A resposta para ReservationService.SearchAssignments.

Campos
assignments[]

Assignment

Lista de atribuições visíveis para o usuário.

next_page_token

string

Token para recuperar a próxima página de resultados ou esvaziar se não houver mais resultados na lista.

SplitCapacityCommitmentRequest

A solicitação para ReservationService.SplitCapacityCommitment.

Campos
name

string

Obrigatório. Nome do recurso, por exemplo: projects/myproject/locations/US/capacityCommitments/123

A autorização requer a seguinte permissão do IAM no recurso especificado name:

  • bigquery.capacityCommitments.update
slot_count

int64

Número de slots no compromisso de capacidade após a divisão.

SplitCapacityCommitmentResponse

A resposta para ReservationService.SplitCapacityCommitment.

Campos
first

CapacityCommitment

Primeiro compromisso de capacidade, resultado de uma divisão.

second

CapacityCommitment

Segundo compromisso de capacidade, resultado de uma divisão.

UpdateBiReservationRequest

Uma solicitação para atualizar uma reserva de BI.

Campos
bi_reservation

BiReservation

Reserva a ser atualizada.

A autorização requer a seguinte permissão do IAM no recurso especificado biReservation:

  • bigquery.bireservations.update
update_mask

FieldMask

Lista de campos a serem atualizados nesta solicitação.

UpdateCapacityCommitmentRequest

A solicitação para ReservationService.UpdateCapacityCommitment.

Campos
capacity_commitment

CapacityCommitment

Conteúdo do compromisso de capacidade a ser atualizado.

update_mask

FieldMask

Máscara de campo padrão para o conjunto de campos a ser atualizado.

UpdateReservationRequest

A solicitação para ReservationService.UpdateReservation.

Campos
reservation

Reservation

Conteúdo da reserva a ser atualizada.

update_mask

FieldMask

Máscara de campo padrão para o conjunto de campos a ser atualizado.