Paket google.cloud.bigquery.reservation.v1

Index

ReservationService

Mit der API können Nutzer ihre BigQuery-Pauschalreservierungen verwalten.

Mit einer Reservierung werden Rechenressourcen in Form von Slots garantiert. Ein Slot ist in BigQuery eine Einheit der Rechenleistung, die Basiseinheit der Parallelverarbeitung. Bei einem Scan einer mehrfach partitionierten Tabelle wird ein einzelner Slot auf eine einzelne Partition der Tabelle angewandt. Eine Reservierungsressource liegt als untergeordnete Ressource des Admin-Projekts und des Standorts vor, z. B.: projects/myproject/locations/US/reservations/reservationName.

Eine Kapazitätszusicherung bietet die Möglichkeit, Rechenkapazität für BigQuery-Jobs in Form von Slots über einen verbindlichen Nutzungszeitraum zu erwerben. Eine Ressource zur Kapazitätszusicherung liegt als untergeordnete Ressource des Admin-Projekts und des Standorts vor, z. B.: projects/myproject/locations/US/capacityCommitments/id

CreateAssignment

rpc CreateAssignment(CreateAssignmentRequest) returns (Assignment)

Erstellt ein Zuweisungsobjekt, das es dem angegebenen Projekt ermöglicht, Jobs eines bestimmten Typs mithilfe von Slots aus der angegebenen Reservierung zu senden.

Derzeit kann eine Ressource (Projekt, Ordner, Organisation) nur eine Zuweisung pro Kombination aus Jobtyp und Standort haben. Diese Reservierung wird für alle Jobs des entsprechenden Typs verwendet.

Verschiedene Zuweisungen können auf verschiedenen Ebenen der Projekte, Ordner oder Organisationshierarchie erstellt werden. Während der Abfrageausführung wird die Zuweisung auf Projekt-, Ordner- und Organisationsebene in dieser Reihenfolge gesucht. Die erste gefundene Zuweisung wird auf die Abfrage angewendet.

Beim Erstellen von Zuweisungen spielt es keine Rolle, ob andere Zuweisungen auf höheren Ebenen vorhanden sind.

Beispiel:

  • Die Organisation organizationA enthält zwei Projekte, project1 und project2.
  • Zuweisungen für alle drei Entitäten (organizationA, project1 und project2) können alle erstellt und derselben oder unterschiedlichen Reservierungen zugeordnet werden.

Gibt google.rpc.Code.PERMISSION_DENIED zurück, wenn der Nutzer nicht über "bigquery.admin"-Berechtigungen für das Projekt, das die Reservierung nutzt, und das Projekt, das die Reservierung besitzt, verfügt.

Gibt google.rpc.Code.INVALID_ARGUMENT zurück, wenn der Standort der Zuweisung nicht mit dem Standort der Reservierung übereinstimmt.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
CreateCapacityCommitment

rpc CreateCapacityCommitment(CreateCapacityCommitmentRequest) returns (CapacityCommitment)

Erstellt eine neue Ressource zur Kapazitätszusicherung.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
CreateReservation

rpc CreateReservation(CreateReservationRequest) returns (Reservation)

Erstellt eine neue Reservierungsressource.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
DeleteAssignment

rpc DeleteAssignment(DeleteAssignmentRequest) returns (Empty)

Löscht eine Zuweisung. Es findet keine Expansion statt.

Beispiel:

  • Die Organisation organizationA enthält die beiden Projekte project1 und project2.
  • Die Reservierung res1 ist vorhanden und wurde bereits erstellt.
  • CreateAssignment wurde zuvor verwendet, um die folgenden Verknüpfungen zwischen Entitäten und Reservierungen zu definieren: <organizationA, res1> und <project1, res1>

In diesem Beispiel hat das Löschen der Zuweisung <organizationA, res1> keine Auswirkungen auf die andere Zuweisung <project1, res1>. Nach diesem Löschvorgang verwenden Abfragen von project1 weiterhin res1, während Abfragen von project2 in den On-Demand-Modus wechseln.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
DeleteCapacityCommitment

rpc DeleteCapacityCommitment(DeleteCapacityCommitmentRequest) returns (Empty)

Löscht eine Kapazitätszusicherung. Der Versuch, die Kapazitätszusicherung vor der "commitment_end_time" zu löschen, hat einen Fehler mit dem Fehlercode google.rpc.Code.FAILED_PRECONDITION zur Folge.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
DeleteReservation

rpc DeleteReservation(DeleteReservationRequest) returns (Empty)

Löscht eine Reservierung. Gibt google.rpc.Code.FAILED_PRECONDITION zurück, wenn die Reservierung Zuweisungen enthält.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
GetBiReservation

rpc GetBiReservation(GetBiReservationRequest) returns (BiReservation)

Ruft eine BI-Reservierung ab.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
GetCapacityCommitment

rpc GetCapacityCommitment(GetCapacityCommitmentRequest) returns (CapacityCommitment)

Gibt Informationen zur Kapazitätszusicherung zurück.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
GetReservation

rpc GetReservation(GetReservationRequest) returns (Reservation)

Gibt Informationen zur Reservierung zurück.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
ListAssignments

rpc ListAssignments(ListAssignmentsRequest) returns (ListAssignmentsResponse)

Listet Zuweisungen auf.

Es werden nur explizit erstellte Zuweisungen zurückgegeben.

Beispiel:

  • Die Organisation organizationA enthält die beiden Projekte project1 und project2.
  • Die Reservierung res1 ist vorhanden und wurde bereits erstellt.
  • CreateAssignment wurde zuvor verwendet, um die folgenden Verknüpfungen zwischen Entitäten und Reservierungen zu definieren: <organizationA, res1> und <project1, res1>

In diesem Beispiel gibt ListAssignments einfach die beiden obigen Zuweisungen für die Reservierung res1 zurück und es findet keine Erweiterung oder Zusammenführung statt.

Der Platzhalter "-" kann für Reservierungen in der Anfrage verwendet werden. In diesem Fall gehören alle Zuweisungen zum angegebenen Projekt und der Standort wird aufgeführt.

Hinweis: "-" kann weder für Projekte noch für Standorte verwendet werden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
ListCapacityCommitments

rpc ListCapacityCommitments(ListCapacityCommitmentsRequest) returns (ListCapacityCommitmentsResponse)

Listet alle Kapazitätszusicherungen für das Administrationsprojekt auf.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
ListReservations

rpc ListReservations(ListReservationsRequest) returns (ListReservationsResponse)

Listet alle Reservierungen für das Projekt am angegebenen Ort auf.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
MergeCapacityCommitments

rpc MergeCapacityCommitments(MergeCapacityCommitmentsRequest) returns (CapacityCommitment)

Führt Kapazitätszusicherungen desselben Tarifs zusammen.

Die sich daraus ergebende Kapazitätszusicherung hat das spätere Zusicherungsende (commitment_end_time out) von den zu verschmelzenden Kapazitätszusicherungen.

Wenn Sie versuchen, Kapazitätszusicherungen unterschiedlicher Tarife zusammenzuführen, schlägt der Vorgang mit dem Fehlercode google.rpc.Code.FAILED_PRECONDITION fehl.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
MoveAssignment

rpc MoveAssignment(MoveAssignmentRequest) returns (Assignment)

Verschiebt eine Zuweisung unter eine neue Reservierung.

Dies unterscheidet sich vom Entfernen einer vorhandenen Zuweisung und dem Erstellen einer neuen Zuweisung durch eine Transaktionsänderung, die sicherstellt, dass einem Zuweisenden immer eine Reservierung zugewiesen ist.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
SearchAssignments

rpc SearchAssignments(SearchAssignmentsRequest) returns (SearchAssignmentsResponse)

Sucht nach Zuweisungen für eine angegebene Ressource in einer bestimmten Region. Wenn sich die Anfrage auf ein Projekt bezieht:

  1. Zuweisungen, die für das Projekt erstellt wurden, werden zurückgegeben, sofern sie vorhanden sind.
  2. Andernfalls werden Zuweisungen zurückgegeben, die für den nächstliegenden Ancestor erstellt wurden.
  3. Alle Zuweisungen für verschiedene "JobTypes" werden zurückgegeben.

Das Gleiche gilt, wenn es sich bei der Anfrage um einen Ordner handelt.

Wenn sich die Anfrage auf eine Organisation bezieht, werden Zuweisungen, die für die Organisation erstellt wurden, zurückgegeben (Organisationen haben keine Ancestors).

Im Vergleich zu ListAssignments gibt es einige Unterschiede:

  1. Die Berechtigung für die zuständige Person wird in dieser API geprüft.
  2. In dieser API findet eine Hierarchiesuche (Projekt -> Ordner -> Organisation) statt.
  3. Das übergeordnete Element ist hier projects/*/locations/* anstelle von projects/*/locations/*reservations/*.

Hinweis: "-" kann weder für Projekte noch für Standorte verwendet werden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
SplitCapacityCommitment

rpc SplitCapacityCommitment(SplitCapacityCommitmentRequest) returns (SplitCapacityCommitmentResponse)

Teilt die Kapazitätszusicherung auf zwei Zusicherungen desselben Tarifs und mit demselben Zusicherungsende (commitment_end_time) auf.

Ein häufiger Anwendungsfall ist das Downgrade von Zusicherungen.

Wenn Sie beispielsweise ein Downgrade von 10.000 auf 8.000 Slots ausführen möchten, können Sie eine Kapazitätszusicherung von 10.000 auf 2.000 und 8.000 aufteilen. Dann ändern Sie den Plan des ersten auf FLEX und löschen ihn dann.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
UpdateBiReservation

rpc UpdateBiReservation(UpdateBiReservationRequest) returns (BiReservation)

Aktualisiert eine BI-Reservierung.

Nur die in der field_mask angegebenen Felder werden aktualisiert.

Eine Singleton BI-Reservierung ist immer mit der Standardgröße 0 vorhanden. Zum Reservieren von BI-Kapazität muss sie auf einen Wert größer 0 aktualisiert werden. Zum Freigeben der BI-Kapazität muss die Reservierungsgröße auf 0 gesetzt werden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
UpdateCapacityCommitment

rpc UpdateCapacityCommitment(UpdateCapacityCommitmentRequest) returns (CapacityCommitment)

Aktualisiert eine vorhandene Kapazitätszusicherung.

Nur die Felder plan und renewal_plan können aktualisiert werden.

Das Feld "plan" kann nur in einen Tarif mit einem längeren Zusicherungszeitraum geändert werden. Wenn Sie auf einen Tarif mit einem kürzeren Zusicherungszeitraum umstellen, schlägt der Vorgang mit dem Fehlercode google.rpc.Code.FAILED_PRECONDITION fehl.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.
UpdateReservation

rpc UpdateReservation(UpdateReservationRequest) returns (Reservation)

Aktualisiert eine vorhandene Reservierungsressource.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentifizierung.

Zuweisung

Eine Zuweisung ermöglicht einem Projekt mithilfe von Slots der angegebenen Reservierung das Senden von Jobs eines bestimmten Typs.

Felder
name

string

Nur Ausgabe Der Name der Ressource, z. B.: projects/myproject/locations/US/reservations/team1-prod/assignments/123
assignee

string

Die Ressource, die die Reservierung nutzt, z. B.: projects/myproject, folders/123 oder organizations/456.
job_type

JobType

Die Arten der von der Reservierung genutzten Jobs.
state

State

Nur Ausgabe Status der Zuweisung.

JobType

Arten von Jobs, die bei Verwendung der Reservierung angegeben werden können.

Enums
JOB_TYPE_UNSPECIFIED Ungültiger Typ. Anfragen mit diesem Wert werden mit dem Fehlercode google.rpc.Code.INVALID_ARGUMENT abgelehnt.
PIPELINE Die Reservierung wird von Pipelinejobs (Laden/Exportieren) aus dem Projekt verwendet.
QUERY Die Reservierung wird von Abfragejobs aus dem Projekt verwendet.

Status

Die Zuweisung bleibt im Status PENDING, wenn keine aktive Kapazitätszusicherung vorhanden ist. Ihr Status wechselt zu ACTIVE, wenn eine Kapazitätszusicherung aktiviert wird.

Enums
STATE_UNSPECIFIED Ungültiger Statuswert.
PENDING Abfragen von Empfängern von Zuweisungen werden auf On-Demand-Basis ausgeführt, wenn die zugehörige Zuweisung aussteht.
ACTIVE Die Zuweisung ist einsatzbereit.

BiReservation

Stellt eine BI-Reservierung dar.

Felder
name

string

Der Ressourcenname der Singleton-BI-Reservierung. Reservierungsnamen haben das Format projects/{project_id}/locations/{location_id}/bireservation.
update_time

Timestamp

Nur Ausgabe Der Zeitstempel der letzten Aktualisierung einer Reservierung.
size

int64

Größe einer Reservierung in Byte.

CapacityCommitment

Eine Kapazitätszusicherung bietet die Möglichkeit, für einen verbindlichen Nutzungszeitraum für BigQuery-Jobs Rechenkapazität in Form von Slots zu erwerben. Jährliche Zusicherungen werden standardmäßig verlängert. Zusicherungen können nach Ablauf der Zusicherung entfernt werden.

Um die jährliche Zusicherung zu entfernen, muss der Tarif zuerst in monatlich oder Flex geändert werden.

Eine Ressource zur Kapazitätszusicherung liegt als untergeordnete Ressource des Admin-Projekts vor.

Felder
name

string

Nur Ausgabe Der Ressourcenname der Kapazitätszusicherung, z. B. projects/myproject/locations/US/capacityCommitments/123
slot_count

int64

Die Anzahl an Slots in dieser Zusicherung.
plan

CommitmentPlan

Tarif mit Zusicherung für die Kapazitätszusicherung.
state

State

Nur Ausgabe Status der Zusicherung.
commitment_end_time

Timestamp

Nur Ausgabe Das Ende des aktuellen Zusicherungszeitraums. Gilt nur für Kapazitätszusicherungen mit dem Status ACTIVE.
failure_status

Status

Nur Ausgabe Bei einem Zusicherungstarif mit dem Status FAILED wird die Fehlerursache angegeben.
renewal_plan

CommitmentPlan

Der Tarif, in den diese Kapazitätszusicherung konvertiert wird, nachdem das Zusicherungsende (commitment_end_time) verstrichen ist. Sobald der Tarif geändert wurde, wird der Zusicherungszeitraum gemäß dem Zusicherungstarif verlängert. Gilt nur für JÄHRLICHE und TEST-Zusicherungen.

CommitmentPlan

Der aktuelle Zusicherungszeitraum wird vom Zusicherungstarif bestimmt. Die Kapazitätszusicherung kann während des Zusicherungszeitraums nicht gelöscht werden.

Enums
COMMITMENT_PLAN_UNSPECIFIED Ungültiger Tarifwert. Anfragen mit diesem Wert werden mit dem Fehlercode google.rpc.Code.INVALID_ARGUMENT abgelehnt.
FLEX Für Flex-Zusicherungen gilt ein Zusicherungszeitraum von einer Minute nach der AKTIVIERUNG. Danach befinden sie sich nicht mehr in einem Zusicherungszeitraum und können jederzeit entfernt werden.
TRIAL Testzusicherungen haben einen Zusicherungszeitraum von 182 Tagen nach ihrer AKTIVIERUNG. Danach werden sie anhand des Verlängerungstarifs in eine neue Zusicherung umgewandelt. Der standardmäßige Verlängerungtarif für die Testzusicherung ist Flex, sodass sie direkt nach Ablauf des Zusicherungszeitraums gelöscht werden kann.
MONTHLY Monatliche Zusicherungen haben einen Zusicherungszeitraum von 30 Tagen nach ihrer AKTIVIERUNG. Danach befinden sie sich nicht mehr in einem Zusicherungszeitraum und können jederzeit entfernt werden.
ANNUAL Jährliche Zusicherungen haben einen Zusicherungszeitraum von 365 Tagen nach ihrer AKTIVIERUNG. Danach werden sie anhand des Verlängerungstarifs in eine neue Zusicherung umgewandelt.

Status

Kapazitätszusicherungen können entweder sofort in den Status ACTIVE übergehen oder ihr Status wechselt von PENDING zu ACTIVE oder FAILED.

Enums
STATE_UNSPECIFIED Ungültiger Statuswert.
PENDING Die Bereitstellung der Kapazitätszusicherung steht aus. Eine ausstehende Kapazitätszusicherung trägt nicht zur "slot_capacity" des übergeordneten Elements bei.
ACTIVE Sobald die Slots bereitgestellt sind, wird die Kapazitätszusicherung aktiviert. Der "slot_count" wird zur "slot_capacity" des übergeordneten Elements hinzugefügt.
FAILED Die Kapazitätszusicherung konnte vom Back-End nicht aktiviert werden.

CreateAssignmentRequest

Die Anfrage für ReservationService.CreateAssignment. Hinweis: Für den betreffenden Empfänger der Zuweisung ist die Berechtigung "bigquery.reservationAssignments.create" erforderlich.

Felder
parent

string

Erforderlich Der Name der übergeordneten Ressource der Zuweisung, z. B. projects/myproject/locations/US/reservations/team1-prod

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • bigquery.reservationAssignments.create
assignment

Assignment

Zu erstellende Zuweisungsressource.

CreateCapacityCommitmentRequest

Die Anfrage für ReservationService.CreateCapacityCommitment.

Felder
parent

string

Erforderlich Ressourcenname der übergeordneten Reservierung, z. B. projects/myproject/locations/US
capacity_commitment

CapacityCommitment

Inhalt der zu erstellenden Kapazitätszusicherung.
enforce_single_admin_project_per_org

bool

Bei "true" schlägt die Anfrage fehl, wenn ein anderes Projekt in der Organisation eine Kapazitätszusicherung enthält.

CreateReservationRequest

Die Anfrage für ReservationService.CreateReservation.

Felder
parent

string

Erforderlich Projekt, Speicherort, z. B. projects/myproject/locations/US
reservation_id

string

Die Reservierungs-ID. Dieses Feld darf nur alphanumerische Kleinbuchstaben oder einen Bindestrich enthalten. Darf maximal 64 Zeichen lang sein.
reservation

Reservation

Definition der neu zu erstellenden Reservierung.

DeleteAssignmentRequest

Die Anfrage für ReservationService.DeleteAssignment. Hinweis: Für den betreffenden Empfänger der Zuweisung ist die Berechtigung "bigquery.reservationAssignments.delete" erforderlich.

Felder
name

string

Erforderlich Name der Ressource, z. B. projects/myproject/locations/US/reservations/team1-prod/assignments/123

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • bigquery.reservationAssignments.delete

DeleteCapacityCommitmentRequest

Die Anfrage für ReservationService.DeleteCapacityCommitment.

Felder
name

string

Erforderlich Ressourcenname der zu löschenden Kapazitätszusicherung, z. B. projects/myproject/locations/US/capacityCommitments/123

DeleteReservationRequest

Die Anfrage für ReservationService.DeleteReservation.

Felder
name

string

Erforderlich Ressourcenname der abzurufenden Reservierung, z. B. projects/myproject/locations/US/reservations/team1-prod

GetBiReservationRequest

Eine Anfrage zum Abrufen einer Singleton-BI-Reservierung.

Felder
name

string

Erforderlich Name der angeforderten Reservierung, z. B. projects/{project_id}/locations/{location_id}/bireservation.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • bigquery.bireservations.get

GetCapacityCommitmentRequest

Die Anfrage für ReservationService.GetCapacityCommitment.

Felder
name

string

Erforderlich Ressourcenname der abzurufenden Kapazitätszusicherung, z. B. projects/myproject/locations/US/capacityCommitments/123

GetReservationRequest

Die Anfrage für ReservationService.GetReservation.

Felder
name

string

Erforderlich Ressourcenname der abzurufenden Reservierung, z. B. projects/myproject/locations/US/reservations/team1-prod

ListAssignmentsRequest

Die Anfrage für ReservationService.ListAssignments.

Felder
parent

string

Erforderlich Der Name der übergeordneten Ressource, z. B.:

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

oder:

projects/myproject/locations/US/reservations/-

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • bigquery.reservationAssignments.list
page_size

int32

Die maximale Anzahl von Elementen, die pro Seite zurückgegeben werden sollen.
page_token

string

Der Wert next_page_token wurde gegebenenfalls von einer vorherigen Listenanfrage zurückgegeben.

ListAssignmentsResponse

Die Antwort für ReservationService.ListAssignments.

Felder
assignments[]

Assignment

Liste der Zuweisungen, die für den Nutzer sichtbar sind.
next_page_token

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.

ListCapacityCommitmentsRequest

Die Anfrage für ReservationService.ListCapacityCommitments.

Felder
parent

string

Erforderlich Ressourcenname der übergeordneten Reservierung, z. B. projects/myproject/locations/US
page_size

int32

Die maximale Anzahl der Elemente, die zurückzugeben sind.
page_token

string

Der Wert next_page_token wurde gegebenenfalls von einer vorherigen Listenanfrage zurückgegeben.

ListCapacityCommitmentsResponse

Die Antwort für ReservationService.ListCapacityCommitments.

Felder
capacity_commitments[]

CapacityCommitment

Liste der für den Nutzer sichtbaren Kapazitätszusicherungen.
next_page_token

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.

ListReservationsRequest

Die Anfrage für ReservationService.ListReservations.

Felder
parent

string

Erforderlich Der Name der übergeordneten Ressource, die das Projekt und den Standort beinhaltet, z. B.: "projects/myproject/locations/US"
page_size

int32

Die maximale Anzahl von Elementen, die pro Seite zurückgegeben werden sollen.
page_token

string

Der Wert next_page_token wurde gegebenenfalls von einer vorherigen Listenanfrage zurückgegeben.

ListReservationsResponse

Die Antwort für ReservationService.ListReservations.

Felder
reservations[]

Reservation

Liste der Reservierungen, die für den Nutzer sichtbar sind.
next_page_token

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.

MergeCapacityCommitmentsRequest

Die Anfrage für ReservationService.MergeCapacityCommitments.

Felder
parent

string

Übergeordnete Ressource, die das Administrationsprojekt und den Standort identifiziert, z. B. projects/myproject/locations/us.
capacity_commitment_ids[]

string

IDs der zusammenzuführenden Kapazitätszusicherungen. Diese Kapazitätszusicherungen müssen unter dem in der übergeordneten Ressource angegebenen Administrationsprojekt und Standort vorhanden sein.

MoveAssignmentRequest

Die Anfrage für ReservationService.MoveAssignment.

Hinweis: Für die "destination_id" ist die Berechtigung "bigquery.reservationAssignments.create" erforderlich.

Hinweis: Für den betreffenden Empfänger der Zuweisung sind die Berechtigungen "bigquery.reservationAssignments.create" und "bigquery.reservationAssignments.delete" erforderlich.

Felder
name

string

Erforderlich Der Ressourcenname der Zuweisung, z. B. projects/myproject/locations/US/reservations/team1-prod/assignments/123

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • bigquery.reservationAssignments.delete
destination_id

string

Die neue Reservierungs-ID, z. B.: projects/myotherproject/locations/US/reservations/team2-prod

Reservierung

Eine Reservierung ist ein Mechanismus, mit dessen Hilfe Nutzern Slots garantiert werden.

Felder
name

string

Der Ressourcenname der Reservierung, z. B.: projects/*/locations/*/reservations/team1-prod
slot_capacity

int64

Die Mindestanzahl der Slots, die dieser Reservierung zur Verfügung stehen. Ein Slot ist in BigQuery eine Einheit der Rechenleistung, insbesondere der Parallelverarbeitung.

Abfragen, in denen diese Reservierung verwendet wird, belegen während der Laufzeit möglicherweise mehr Slots, wenn "ignore_idle_slots" auf "false" gesetzt ist.

Wenn die Slotkapazität der neuen Reservierung die Slotkapazität der übergeordneten Reservierung übersteigt oder die gesamte Slotkapazität der neuen und allen gleichgeordneten Reservierungen die Slotkapazität der übergeordneten Reservierung übersteigt, wird für die Anfrage der Fehler google.rpc.Code.RESOURCE_EXHAUSTED ausgegeben.
ignore_idle_slots

bool

Bei "false" belegt jede Abfrage, die diese Reservierung verwendet, inaktive Slots aus anderen Reservierungen innerhalb desselben Administrationsprojekts. Bei "true" wird eine Abfrage, die diese Reservierung verwendet, höchstens mit der oben angegebenen Slotkapazität ausgeführt.

SearchAssignmentsRequest

Die Anfrage für ReservationService.SearchAssignments. Hinweis: Für den betreffenden Empfänger der Zuweisung ist die Berechtigung "bigquery.reservationAssignments.search" erforderlich.

Felder
parent

string

Erforderlich Der Ressourcenname des Admin-Projekts (mit Projekt und Standort), z. B. "projects/myproject/locations/US".
query

string

Geben Sie den Ressourcennamen als zuständige Person in der Abfrage an.

Beispiele:

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

int32

Die maximale Anzahl von Elementen, die pro Seite zurückgegeben werden sollen.
page_token

string

Der Wert next_page_token wurde gegebenenfalls von einer vorherigen Listenanfrage zurückgegeben.

SearchAssignmentsResponse

Die Antwort für ReservationService.SearchAssignments.

Felder
assignments[]

Assignment

Liste der Zuweisungen, die für den Nutzer sichtbar sind.
next_page_token

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.

SplitCapacityCommitmentRequest

Die Anfrage für ReservationService.SplitCapacityCommitment.

Felder
name

string

Erforderlich Der Ressourcenname, z. B.: projects/myproject/locations/US/capacityCommitments/123

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • bigquery.capacityCommitments.update
slot_count

int64

Anzahl der Slots in der Kapazitätszusicherung nach der Aufteilung.

SplitCapacityCommitmentResponse

Die Antwort für ReservationService.SplitCapacityCommitment.

Felder
first

CapacityCommitment

Erste Kapazitätszusicherung, Ergebnis einer Aufteilung.
second

CapacityCommitment

Zweite Kapazitätszusicherung, Ergebnis einer Aufteilung.

UpdateBiReservationRequest

Eine Anfrage zum Aktualisieren einer BI-Reservierung.

Felder
bi_reservation

BiReservation

Eine Reservierung, die aktualisiert werden soll.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource biReservation erforderlich:

  • bigquery.bireservations.update
update_mask

FieldMask

Eine Liste der Felder, die in dieser Anfrage aktualisiert werden sollen.

UpdateCapacityCommitmentRequest

Die Anfrage für ReservationService.UpdateCapacityCommitment.

Felder
capacity_commitment

CapacityCommitment

Inhalt der zu aktualisierenden Kapazitätszusicherung.
update_mask

FieldMask

Standardfeldmaske für den Feldsatz, der aktualisiert werden soll.

UpdateReservationRequest

Die Anfrage für ReservationService.UpdateReservation.

Felder
reservation

Reservation

Inhalt der zu aktualisierenden Reservierung.
update_mask

FieldMask

Standardfeldmaske für den Feldsatz, der aktualisiert werden soll.