Package google.cloud.bigquery.reservation.v1

Index

ReservationService

Cette API permet aux utilisateurs de gérer leurs réservations BigQuery aux tarifs forfaitaires.

Une réservation fournit aux utilisateurs des ressources de calcul garanties sous la forme d'emplacements. Un emplacement est une unité de capacité de calcul dans BigQuery, qui sert d'unité de base pour le parallélisme. Dans le cadre de l'analyse d'une table comportant plusieurs partitions, un emplacement donné travaille sur une partition unique de la table. Une ressource de réservation existe en tant que ressource enfant du projet et de l'emplacement d'administration, par exemple : projects/myproject/locations/US/reservations/reservationName.

Un engagement de capacité est une solution permettant d'acheter de la capacité de calcul pour des tâches BigQuery (sous la forme d'emplacements) avec une période d'engagement d'utilisation. Une ressource d'engagement de capacité existe en tant que ressource enfant du projet et de l'emplacement d'administration, par exemple : projects/myproject/locations/US/capacityCommitments/id

CreateAssignment

rpc CreateAssignment(CreateAssignmentRequest) returns (Assignment)

Crée un objet Assignment (attribution), qui permet au projet donné d'envoyer des tâches d'un certain type utilisant des emplacements de la réservation spécifiée.

Actuellement, une ressource (projet, dossier, organisation) ne peut avoir qu'une seule attribution par combinaison (job_type, emplacement), et cette réservation sera utilisée pour toutes les tâches du type correspondant.

Différentes attributions peuvent être créées à différents niveaux des projets, des dossiers ou de la hiérarchie de l'organisation. Pendant l'exécution de la requête, l'attribution est recherchée au niveau du projet, du dossier et de l'organisation dans cet ordre. La première attribution trouvée est appliquée à la requête.

Lors de la création d'attributions, peu importe si d'autres attributions existent à des niveaux supérieurs.

Exemple :

  • L'organisation organizationA contient deux projets, project1 et project2.
  • Les attributions des trois entités (organizationA, project1 et project2) peuvent toutes être créées et mappées sur des réservations identiques ou différentes.

Renvoie google.rpc.Code.PERMISSION_DENIED si l'utilisateur ne dispose pas des autorisations "bigquery.admin" sur le projet utilisant la réservation et sur le projet propriétaire de cette réservation.

Renvoie google.rpc.Code.INVALID_ARGUMENT lorsque l'emplacement de l'attribution ne correspond pas à celui de la réservation.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

CreateCapacityCommitment

rpc CreateCapacityCommitment(CreateCapacityCommitmentRequest) returns (CapacityCommitment)

Crée une ressource d'engagement de capacité.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

CreateReservation

rpc CreateReservation(CreateReservationRequest) returns (Reservation)

Crée une ressource de réservation.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

DeleteAssignment

rpc DeleteAssignment(DeleteAssignmentRequest) returns (Empty)

Supprime une attribution. Aucune expansion n'a lieu.

Exemple :

  • L'organisation organizationA contient deux projets, project1 et project2.
  • La réservation res1 existe et a été créée précédemment.
  • CreateAssignment a déjà été utilisé pour définir les associations suivantes entre entités et réservations : <organizationA, res1> et <project1, res1>.

Dans cet exemple, la suppression de l'attribution <organizationA, res1> n'aura pas d'incidence sur l'autre attribution <project1, res1>. Après cette suppression, les requêtes de project1 continueront d'utiliser res1, tandis que celles de project2 passeront en mode à la demande.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

DeleteCapacityCommitment

rpc DeleteCapacityCommitment(DeleteCapacityCommitmentRequest) returns (Empty)

Supprime un engagement de capacité. Toute tentative de suppression d'un engagement de capacité avant son heure de fin (engagement_end_time) échoue avec le code d'erreur google.rpc.Code.FAILED_PRECONDITION.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

DeleteReservation

rpc DeleteReservation(DeleteReservationRequest) returns (Empty)

Supprime une réservation. Renvoie google.rpc.Code.FAILED_PRECONDITION lorsque la réservation comporte des attributions.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

GetBiReservation

rpc GetBiReservation(GetBiReservationRequest) returns (BiReservation)

Récupère une réservation BI.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

GetCapacityCommitment

rpc GetCapacityCommitment(GetCapacityCommitmentRequest) returns (CapacityCommitment)

Renvoie les informations concernant l'engagement de capacité.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

GetReservation

rpc GetReservation(GetReservationRequest) returns (Reservation)

Renvoie les informations concernant la réservation.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

ListAssignments

rpc ListAssignments(ListAssignmentsRequest) returns (ListAssignmentsResponse)

Répertorie les attributions.

Seules les attributions créées explicitement sont renvoyées.

Exemple :

  • L'organisation organizationA contient deux projets, project1 et project2.
  • La réservation res1 existe et a été créée précédemment.
  • CreateAssignment a déjà été utilisé pour définir les associations suivantes entre entités et réservations : <organizationA, res1> et <project1, res1>.

Dans cet exemple, ListAssignments renverra alors uniquement les deux attributions créées pour la réservation res1, et aucune fusion ou expansion ne sera réalisée.

Le caractère générique "-" peut être utilisé pour les réservations dans la requête. Dans ce cas, la méthode répertorie toutes les attributions appartenant au projet et à l'emplacement spécifiés.

Remarque : "-" ne peut être utilisé ni pour les projets ni pour les emplacements.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

ListCapacityCommitments

rpc ListCapacityCommitments(ListCapacityCommitmentsRequest) returns (ListCapacityCommitmentsResponse)

Répertorie tous les engagements de capacité pour le projet d'administration.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

ListReservations

rpc ListReservations(ListReservationsRequest) returns (ListReservationsResponse)

Répertorie toutes les réservations associées au projet à l'emplacement spécifié.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

MergeCapacityCommitments

rpc MergeCapacityCommitments(MergeCapacityCommitmentsRequest) returns (CapacityCommitment)

Fusionne les engagements de capacité du même forfait en un seul engagement.

L'engagement de capacité qui en résulte possède le commitment_end_time out le plus élevé des engagements de capacité à fusionner.

Toute tentative de fusion des engagements de capacité d'un forfait différent échouera avec le code d'erreur google.rpc.Code.FAILED_PRECONDITION.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

MoveAssignment

rpc MoveAssignment(MoveAssignmentRequest) returns (Assignment)

Déplace une attribution vers une nouvelle réservation.

Cela diffère de la suppression d'une attribution existante et de la recréation d'une nouvelle attribution en fournissant une modification transactionnelle garantissant que le responsable dispose toujours d'une réservation associée.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

SearchAssignments

rpc SearchAssignments(SearchAssignmentsRequest) returns (SearchAssignmentsResponse)

Recherche les attributions d'une ressource spécifiée pour une région spécifique. Si la requête concerne un projet :

  1. Les attributions créées sur le projet seront renvoyées si elles existent.
  2. Sinon, la méthode renvoie les attributions créées pour l'ancêtre le plus proche,
  3. ainsi que toutes les attributions correspondant à différents types de tâches JobTypes.

La même logique s'applique si la requête concerne un dossier.

Si la requête concerne une organisation, la méthode renvoie les attributions créées au niveau de l'organisation (celle-ci ne possède pas d'ancêtre).

Par rapport à la méthode ListAssignments, il existe des différences de comportement :

  1. L'autorisation du détenteur de l'attribution sera validée dans cette API.
  2. La méthode effectue une recherche hiérarchique (projet -> dossier -> organisation).
  3. Ici, le parent est projects/*/locations/* au lieu de projects/*/locations/*reservations/*.

Remarque : "-" ne peut être utilisé ni pour les projets ni pour les emplacements.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

SplitCapacityCommitment

rpc SplitCapacityCommitment(SplitCapacityCommitmentRequest) returns (SplitCapacityCommitmentResponse)

Répartit l'engagement de capacité en deux engagements du même forfait ayant une valeur de propriété commitment_end_time identique.

Un cas d'utilisation courant consiste à rétrograder les engagements.

Par exemple, pour passer de 10 000 à 8 000 emplacements, répartissez 10 000 engagements de capacité en 2 000 et 8 000 engagements de capacité. Modifiez ensuite le forfait du premier en FLEX, puis supprimez-le.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

UpdateBiReservation

rpc UpdateBiReservation(UpdateBiReservationRequest) returns (BiReservation)

Met à jour une réservation BI.

Seuls les champs spécifiés dans field_mask sont mis à jour.

Une réservation BI unique possède toujours une taille de 0 par défaut. Pour réserver une capacité BI, vous devez lui attribuer une valeur supérieure à 0. Pour libérer la capacité BI, la taille de réservation doit être définie sur 0.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

UpdateCapacityCommitment

rpc UpdateCapacityCommitment(UpdateCapacityCommitmentRequest) returns (CapacityCommitment)

Met à jour un engagement de capacité existant.

Seuls les champs plan et renewal_plan peuvent être mis à jour.

Un forfait ne peut être remplacé que par un forfait avec une période d'engagement plus longue. Toute tentative de remplacement par un forfait avec une période d'engagement plus courte échoue avec le code d'erreur google.rpc.Code.FAILED_PRECONDITION.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

UpdateReservation

rpc UpdateReservation(UpdateReservationRequest) returns (Reservation)

Met à jour une ressource de réservation existante.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

Assignment

Un objet Assignment (attribution) permet à un projet d'envoyer des tâches d'un certain type utilisant des emplacements de la réservation spécifiée.

Champs
name

string

Uniquement en sortie. Nom de la ressource. Exemple : projects/myproject/locations/US/reservations/team1-prod/assignments/123

assignee

string

La ressource qui utilisera la réservation. Par exemple : projects/myproject, folders/123 ou organizations/456.

job_type

JobType

Type de tâche qui utilisera la réservation.

state

State

Uniquement en sortie. État de l'attribution.

JobType (Type de tâche)

Types de tâches, qui peuvent être spécifiés lors de l'utilisation de la réservation.

Enums
JOB_TYPE_UNSPECIFIED Type non valide. Les requêtes comportant cette valeur seront rejetées avec le code d'erreur google.rpc.Code.INVALID_ARGUMENT.
PIPELINE Des tâches de pipeline (chargement/exportation) du projet vont utiliser la réservation.
QUERY Des tâches de requêtes liées au projet vont utiliser la réservation.

État

L'attribution restera à l'état "PENDING" (EN ATTENTE) si aucun engagement de capacité actif n'est présent. Elle devient ACTIVE dès qu'un engagement de capacité devient actif.

Enums
STATE_UNSPECIFIED Valeur d'état non valide.
PENDING Les requêtes de la personne responsable sont exécutées à la demande, si l'attribution associée est en attente.
ACTIVE L'attribution est prête.

BiReservation

Représente une réservation BI.

Champs
name

string

Nom de ressource de la réservation BI unique. Les noms de réservation sont au format projects/{project_id}/locations/{location_id}/bireservation.

update_time

Timestamp

Uniquement en sortie. Horodatage de la dernière mise à jour d'une réservation.

size

int64

Taille d'une réservation, en octets.

CapacityCommitment

Un engagement de capacité est une solution permettant d'acheter de la capacité de calcul pour des tâches BigQuery (sous la forme d'emplacements) avec une période d'engagement d'utilisation. Les engagements annuels sont renouvelés par défaut. Les engagements peuvent être supprimés une fois leur heure de fin d'engagement dépassée.

Pour pouvoir annuler son engagement annuel, son forfait doit d'abord être modifié sur une base mensuelle ou flexible.

Une ressource d'engagement de capacité existe en tant que ressource enfant du projet d'administration.

Champs
name

string

Uniquement en sortie. Nom de ressource de l'engagement de capacité, par exemple : projects/myproject/locations/US/capacityCommitments/123

slot_count

int64

Nombre d'emplacements figurant dans cet engagement.

plan

CommitmentPlan

Forfait de l'engagement de capacité.

state

State

Uniquement en sortie. État de l'engagement.

commitment_end_time

Timestamp

Uniquement en sortie. Fin de la période d'engagement en cours. Elle ne s'applique qu'aux engagements de capacité actifs (état ACTIVE).

failure_status

Status

Uniquement en sortie. Indique le motif de l'échec pour un forfait d'engagement à l'état FAILED.

renewal_plan

CommitmentPlan

Forfait vers lequel cet engagement de capacité est converti une fois la propriété commitment_end_time transmise. Après modification du forfait, la période d'engagement est prolongée conformément à celui-ci. Ne s'applique qu'aux engagements annuels (ANNUAL) et d'essai (TRIAL).

CommitmentPlan

Le forfait définit la période d'engagement en cours. L'engagement de capacité ne peut pas être supprimé au cours de cette période.

Enums
COMMITMENT_PLAN_UNSPECIFIED Valeur de forfait non valide. Les requêtes comportant cette valeur seront rejetées avec le code d'erreur google.rpc.Code.INVALID_ARGUMENT.
FLEX Les engagements modulables ne peuvent pas être supprimés dans la minute suivant leur activation (état ACTIVE). Passé ce délai, ils ne sont plus soumis à une période d'engagement et peuvent être supprimés à tout moment.
TRIAL Les engagements d'essai ne peuvent pas être supprimés pendant 182 jours suivant leur activation (état ACTIVE). Ils sont ensuite convertis en un nouvel engagement basé sur le plan de renouvellement (valeur renewal_plan). Par défaut, la valeur renewal_plan de l'engagement d'essai est Flex, ce qui permet de la supprimer juste après la fin de la période d'engagement.
MONTHLY Les engagements mensuels ne peuvent pas être supprimés dans les 30 jours suivant leur activation (état ACTIVE). Passé ce délai, ils ne sont plus soumis à une période d'engagement et peuvent être supprimés à tout moment.
ANNUAL Les engagements annuels ne peuvent pas être supprimés dans les 365 jours suivant leur activation (état ACTIVE). Ils sont ensuite convertis en un nouvel engagement basé sur le plan de renouvellement (valeur renewal_plan).

État

L'engagement de capacité peut soit devenir immédiatement actif (état ACTIVE), soit passer de l'état PENDING (en attente) à ACTIVE (actif) ou FAILED (échec).

Enums
STATE_UNSPECIFIED Valeur d'état non valide.
PENDING L'engagement de capacité est en attente de provisionnement. Un engagement de capacité en attente n'est pas comptabilisé dans la capacité slot_capacity du parent.
ACTIVE Une fois les emplacements provisionnés, l'engagement de capacité devient actif. slot_count est alors ajouté à la capacité slot_capacity du parent.
FAILED L'engagement de capacité n'a pas pu être activé par le backend.

CreateAssignmentRequest

Requête pour ReservationService.CreateAssignment. Remarque : L'autorisation "bigquery.reservationAssignments.create" est requise sur le détenteur de l'attribution.

Champs
parent

string

Obligatoire. Nom de ressource parente de l'attribution (par exemple, projects/myproject/locations/US/reservations/team1-prod)

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • bigquery.reservationAssignments.create
assignment

Assignment

Ressource d'attribution à créer.

CreateCapacityCommitmentRequest

Requête pour ReservationService.CreateCapacityCommitment.

Champs
parent

string

Obligatoire. Nom de ressource de la réservation parente. Exemple : projects/myproject/locations/US

capacity_commitment

CapacityCommitment

Contenu de l'engagement de capacité à créer.

enforce_single_admin_project_per_org

bool

Si la valeur est définie sur "true", la requête échoue si un autre projet de l'organisation possède un engagement de capacité.

CreateReservationRequest

Requête pour ReservationService.CreateReservation.

Champs
parent

string

Obligatoire. Projet, emplacement. Exemple : projects/myproject/locations/US

reservation_id

string

ID de la réservation. Ce champ ne peut contenir que des caractères alphanumériques en minuscule ou des traits d'union. La longueur maximale est de 64 caractères.

reservation

Reservation

Définition de la réservation à créer.

DeleteAssignmentRequest

Requête pour ReservationService.DeleteAssignment. Remarque : L'autorisation "bigquery.reservationAssignments.delete" est requise sur l'objet de l'attribution.

Champs
name

string

Obligatoire. Nom de la ressource. Exemple : projects/myproject/locations/US/reservations/team1-prod/assignments/123

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • bigquery.reservationAssignments.delete

DeleteCapacityCommitmentRequest

Requête pour ReservationService.DeleteCapacityCommitment.

Champs
name

string

Obligatoire. Nom de ressource de l'engagement de capacité à supprimer. Exemple : projects/myproject/locations/US/capacityCommitments/123

DeleteReservationRequest

Requête pour ReservationService.DeleteReservation.

Champs
name

string

Obligatoire. Nom de ressource de la réservation à récupérer. Exemple : projects/myproject/locations/US/reservations/team1-prod

GetBiReservationRequest

Requête permettant d'obtenir une réservation BI unique.

Champs
name

string

Obligatoire. Nom de la réservation demandée, par exemple : projects/{project_id}/locations/{location_id}/bireservation

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • bigquery.bireservations.get

GetCapacityCommitmentRequest

Requête pour ReservationService.GetCapacityCommitment.

Champs
name

string

Obligatoire. Nom de ressource de l'engagement de capacité à récupérer. Exemple : projects/myproject/locations/US/capacityCommitments/123

GetReservationRequest

Requête pour ReservationService.GetReservation.

Champs
name

string

Obligatoire. Nom de ressource de la réservation à récupérer. Exemple : projects/myproject/locations/US/reservations/team1-prod

ListAssignmentsRequest

Requête pour ReservationService.ListAssignments.

Champs
parent

string

Obligatoire. Nom de la ressource parente, par exemple :

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

ou

projects/myproject/locations/US/reservations/-

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • bigquery.reservationAssignments.list
page_size

int32

Le nombre maximal d'éléments à renvoyer par page.

page_token

string

Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant.

ListAssignmentsResponse

Réponse pour ReservationService.ListAssignments.

Champs
assignments[]

Assignment

Liste des attributions visibles par l'utilisateur.

next_page_token

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

ListCapacityCommitmentsRequest

Requête pour ReservationService.ListCapacityCommitments.

Champs
parent

string

Obligatoire. Nom de ressource de la réservation parente. Exemple : projects/myproject/locations/US

page_size

int32

Nombre maximum d'éléments à renvoyer.

page_token

string

Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant.

ListCapacityCommitmentsResponse

Réponse pour ReservationService.ListCapacityCommitments.

Champs
capacity_commitments[]

CapacityCommitment

Liste des engagements de capacité visibles par l'utilisateur.

next_page_token

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

ListReservationsRequest

Requête pour ReservationService.ListReservations.

Champs
parent

string

Obligatoire. Nom de la ressource parente contenant le projet et l'emplacement, par exemple : projects/myproject/locations/US

page_size

int32

Le nombre maximal d'éléments à renvoyer par page.

page_token

string

Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant.

ListReservationsResponse

Réponse pour ReservationService.ListReservations.

Champs
reservations[]

Reservation

Liste des réservations visibles par l'utilisateur.

next_page_token

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

MergeCapacityCommitmentsRequest

Requête pour ReservationService.MergeCapacityCommitments.

Champs
parent

string

Nom de la ressource parente qui identifie l'administrateur du projet et son emplacement (par exemple, projects/myproject/locations/us)

capacity_commitment_ids[]

string

Identifiants des engagements de capacité à fusionner. Vous devez vous assurer que ces engagements de capacité existent pour l'administrateur et l'emplacement du projet spécifiés par la ressource parente.

MoveAssignmentRequest

Requête pour ReservationService.MoveAssignment.

Remarque : L'autorisation "bigquery.reservationAssignments.create" est requise sur destination_id.

Remarque : Les autorisations "bigquery.reservationAssignments.create" et "bigquery.reservationAssignments.delete" sont requises sur le détenteur de l'attribution.

Champs
name

string

Obligatoire. Nom de ressource de l'attribution. Exemple : projects/myproject/locations/US/reservations/team1-prod/assignments/123

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • bigquery.reservationAssignments.delete
destination_id

string

Nouvel identifiant de réservation. Exemple : projects/myotherproject/locations/US/reservations/team2-prod

Réservation

Une réservation est un mécanisme permettant de garantir des emplacements aux utilisateurs.

Champs
name

string

Nom de ressource de la réservation. Exemple : projects/*/locations/*/reservations/team1-prod

slot_capacity

int64

Nombre minimal d'emplacements disponibles pour cette réservation. Un emplacement est une unité de puissance de calcul dans BigQuery qui sert d'unité de base pour le parallélisme.

Les requêtes utilisant cette réservation peuvent utiliser davantage d'emplacements pendant l'exécution si ignore_idle_slots est défini sur "false".

Si la capacité d'emplacements de la nouvelle réservation dépasse la capacité d'emplacements du parent ou si la capacité totale de la nouvelle réservation et de ses réservations sœurs dépasse la capacité d'emplacements du parent, la requête échoue avec une erreur google.rpc.Code.RESOURCE_EXHAUSTED.

ignore_idle_slots

bool

Si la valeur est définie sur "false", toute requête utilisant cette réservation exploitera les emplacements vides associés aux autres réservations figurant dans le même projet d'administration. Si la valeur est définie sur "true", toute requête utilisant cette réservation s'exécutera avec la capacité d'emplacements maximale spécifiée ci-dessous.

SearchAssignmentsRequest

Requête pour ReservationService.SearchAssignments. Remarque : L'autorisation "bigquery.reservationAssignments.search" est requise sur le détenteur de l'attribution.

Champs
parent

string

Obligatoire. Nom de la ressource du projet d'administrateur (contenant le projet et l'emplacement), par exemple : "projects/myproject/locations/US".

query

string

Veuillez indiquer le nom de la ressource en tant que détenteur de l'attribution.

Exemples :

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

int32

Le nombre maximal d'éléments à renvoyer par page.

page_token

string

Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant.

SearchAssignmentsResponse

Réponse pour ReservationService.SearchAssignments.

Champs
assignments[]

Assignment

Liste des attributions visibles par l'utilisateur.

next_page_token

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

SplitCapacityCommitmentRequest

Requête pour ReservationService.SplitCapacityCommitment.

Champs
name

string

Obligatoire. Nom de la ressource, par exemple : projects/myproject/locations/US/capacityCommitments/123

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • bigquery.capacityCommitments.update
slot_count

int64

Nombre d'emplacements dans l'engagement de capacité après la scission.

SplitCapacityCommitmentResponse

Réponse de ReservationService.SplitCapacityCommitment.

Champs
first

CapacityCommitment

Premier engagement de capacité, résultat d'une scission.

second

CapacityCommitment

Deuxième engagement de capacité, résultat d'une scission.

UpdateBiReservationRequest

Une requête permettant de mettre à jour une réservation BI.

Champs
bi_reservation

BiReservation

Une réservation à mettre à jour.

L'autorisation IAM suivante est requise pour la ressource biReservation indiquée :

  • bigquery.bireservations.update
update_mask

FieldMask

Liste des champs à mettre à jour dans cette requête.

UpdateCapacityCommitmentRequest

Requête pour ReservationService.UpdateCapacityCommitment.

Champs
capacity_commitment

CapacityCommitment

Contenu de l'engagement de capacité à mettre à jour.

update_mask

FieldMask

Masque de champ standard pour l'ensemble des champs à mettre à jour.

UpdateReservationRequest

Requête pour ReservationService.UpdateReservation.

Champs
reservation

Reservation

Contenu de la réservation à mettre à jour.

update_mask

FieldMask

Masque de champ standard pour l'ensemble des champs à mettre à jour.