Paket "google.cloud.bigquery.reservation.v1beta1"

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)

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.

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: organizationA enthält project1 und project2. Reservierung res1 ist vorhanden. Zuvor wurde "CreateAssignment" aufgerufen, die folgenden Zuweisungen wurden explizit erstellt: <organizationA, res1> <project1, res1>. Das folgende Löschen von <organizationA, res1> wirkt sich nicht auf <project1, res1> aus. Nach dem Löschen von <organizationA, res1> wird in Abfragen von project1 weiter "res1" verwendet, während Abfragen von project2 den On-Demand-Modus verwenden.

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: organizationA enthält project1 und project2. Reservierung res1 ist vorhanden. Zuvor wurde "CreateAssignment" aufgerufen, die folgenden Zuweisungen wurden explizit erstellt: <organizationA, res1> <project1, res1>. Anschließend gibt diese API nur die obigen beiden Zuweisungen für Reservierung "res1" zurück. Es wird keine Expansion oder Zusammenführung ausgeführt. Für Reservierungen kann in der Anfrage der Platzhalter "-" verwendet werden. In diesem Fall gehören alle Zuweisungen zum angegebenen Projekt und der Standort wird aufgeführt. "-" 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 resultierende Kapazitätszusicherung hat von beiden das spätere Zusicherungsende (commitment_end_time). 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. Kunden können dazu die vorhandene Zuweisung löschen und anschließend unter der neuen Reservierung eine neue Zuweisung erstellen. Mit dieser Methode kann dieser Vorgang aber transaktional ausgeführt werden, damit dem Empfänger der Zuweisung immer eine Reservierung zugewiesen ist. Ohne diese Methode werden möglicherweise unerwartet einige On-Demand-Anfragen ausgeführt.

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 vorhanden. 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). Gegenüber ListAssignments gibt es einige Unterschiede im Verhalten: 1) Die Berechtigung des Empfängers der Zuweisung wird in dieser API überprüft. 2) In dieser API findet eine Hierarchiesuche (Projekt -> Ordner -> Organisation) statt. 3) Das übergeordnete Element ist hier projects/*/locations/* anstatt projects/*/locations/*reservations/*. "-" 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 hierfür ist ein Downgrade. Wenn Sie beispielsweise ein Downgrade von 10.000 Slots auf 8.000 ausführen möchten, können Sie die Kapazitätszusicherung von 10.000 auf 2.000 und 8.000 aufteilen, den Tarif der ersten Zusicherung in Flex-Slots ändern und diese Zusicherung dann löschen.

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 Felder, die in "field_mask" angegeben sind, werden aktualisiert. Die 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.

Es können nur die Felder "plan" und "renewal_plan" 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, 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 des Zusicherungszeitraums 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 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

Pflichtfeld. Der Name der übergeordneten Ressource der Zuweisung, z. B. projects/myproject/locations/US/sehen/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

Pflichtfeld. 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

Pflichtfeld. 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

Inhalt 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

Pflichtfeld. 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

Pflichtfeld. 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

Pflichtfeld. 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

Pflichtfeld. 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:

  • bi.reservations.get

GetCapacityCommitmentRequest

Die Anfrage für ReservationService.GetCapacityCommitment.

Felder
name

string

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

GetReservationRequest

Die Anfrage für ReservationService.GetReservation.

Felder
name

string

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

ListAssignmentsRequest

Die Anfrage für ReservationService.ListAssignments.

Felder
parent

string

Pflichtfeld. 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 der Elemente, die zurückzugeben sind.

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

Pflichtfeld. 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

Pflichtfeld. Der Name der übergeordneten Ressource, die das Projekt und den Standort beinhaltet, 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.

filter

string

Kann zum Filtern von Reservierungen basierend auf dem Namen, der Kapazität usw. verwendet werden, z. B.: filter="reservation.slot_capacity > 200" filter="reservation.nam = "*dev/*"". Erweiterte Filtersyntax finden Sie hier.

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

Pflichtfeld. 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

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

query

string

Bitte geben Sie den Ressourcennamen als Empfänger der Zuweisung in der Abfrage an, z. B.: "assignee=projects/myproject" "assignee=folders/123" "assignee=organizations/456".

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.

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

Pflichtfeld. 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
reservation

BiReservation

Eine Reservierung, die aktualisiert werden soll.

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

  • bi.reservations.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.