* $bigqueryreservationService = new Google\Service\BigQueryReservation(...); * $reservations = $bigqueryreservationService->projects_locations_reservations; * */ class ProjectsLocationsReservations extends \Google\Service\Resource { /** * Creates a new reservation resource. (reservations.create) * * @param string $parent Required. Project, location. E.g., * `projects/myproject/locations/US` * @param Reservation $postBody * @param array $optParams Optional parameters. * * @opt_param string reservationId The reservation ID. It must only contain * lower case alphanumeric characters or dashes. It must start with a letter and * must not end with a dash. Its maximum length is 64 characters. * @return Reservation * @throws \Google\Service\Exception */ public function create($parent, Reservation $postBody, $optParams = []) { $params = ['parent' => $parent, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('create', [$params], Reservation::class); } /** * Deletes a reservation. Returns `google.rpc.Code.FAILED_PRECONDITION` when * reservation has assignments. (reservations.delete) * * @param string $name Required. Resource name of the reservation to retrieve. * E.g., `projects/myproject/locations/US/reservations/team1-prod` * @param array $optParams Optional parameters. * @return BigqueryreservationEmpty * @throws \Google\Service\Exception */ public function delete($name, $optParams = []) { $params = ['name' => $name]; $params = array_merge($params, $optParams); return $this->call('delete', [$params], BigqueryreservationEmpty::class); } /** * Fail over a reservation to the secondary location. The operation should be * done in the current secondary location, which will be promoted to the new * primary location for the reservation. Attempting to failover a reservation in * the current primary location will fail with the error code * `google.rpc.Code.FAILED_PRECONDITION`. (reservations.failoverReservation) * * @param string $name Required. Resource name of the reservation to failover. * E.g., `projects/myproject/locations/US/reservations/team1-prod` * @param FailoverReservationRequest $postBody * @param array $optParams Optional parameters. * @return Reservation * @throws \Google\Service\Exception */ public function failoverReservation($name, FailoverReservationRequest $postBody, $optParams = []) { $params = ['name' => $name, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('failoverReservation', [$params], Reservation::class); } /** * Returns information about the reservation. (reservations.get) * * @param string $name Required. Resource name of the reservation to retrieve. * E.g., `projects/myproject/locations/US/reservations/team1-prod` * @param array $optParams Optional parameters. * @return Reservation * @throws \Google\Service\Exception */ public function get($name, $optParams = []) { $params = ['name' => $name]; $params = array_merge($params, $optParams); return $this->call('get', [$params], Reservation::class); } /** * Lists all the reservations for the project in the specified location. * (reservations.listProjectsLocationsReservations) * * @param string $parent Required. The parent resource name containing project * and location, e.g.: `projects/myproject/locations/US` * @param array $optParams Optional parameters. * * @opt_param int pageSize The maximum number of items to return per page. * @opt_param string pageToken The next_page_token value returned from a * previous List request, if any. * @return ListReservationsResponse * @throws \Google\Service\Exception */ public function listProjectsLocationsReservations($parent, $optParams = []) { $params = ['parent' => $parent]; $params = array_merge($params, $optParams); return $this->call('list', [$params], ListReservationsResponse::class); } /** * Updates an existing reservation resource. (reservations.patch) * * @param string $name The resource name of the reservation, e.g., * `projects/locations/reservations/team1-prod`. The reservation_id must only * contain lower case alphanumeric characters or dashes. It must start with a * letter and must not end with a dash. Its maximum length is 64 characters. * @param Reservation $postBody * @param array $optParams Optional parameters. * * @opt_param string updateMask Standard field mask for the set of fields to be * updated. * @return Reservation * @throws \Google\Service\Exception */ public function patch($name, Reservation $postBody, $optParams = []) { $params = ['name' => $name, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('patch', [$params], Reservation::class); } } // Adding a class alias for backwards compatibility with the previous class name. class_alias(ProjectsLocationsReservations::class, 'Google_Service_BigQueryReservation_Resource_ProjectsLocationsReservations');