Method: projects.locations.reservations.assignments.move

Moves an assignment under a new reservation.

This differs from removing an existing assignment and recreating a new one by providing a transactional change that ensures an assignee always has an associated reservation.

HTTP request

POST https://bigqueryreservation.googleapis.com/v1/{name=projects/*/locations/*/reservations/*/assignments/*}:move

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The resource name of the assignment, e.g. projects/myproject/locations/US/reservations/team1-prod/assignments/123

Authorization requires the following IAM permission on the specified resource name:

  • bigquery.reservationAssignments.delete

Request body

The request body contains data with the following structure:

JSON representation
{
  "destinationId": string,
  "assignmentId": string
}
Fields
destinationId

string

The new reservation ID, e.g.: projects/myotherproject/locations/US/reservations/team2-prod

assignmentId

string

The optional assignment ID. A new assignment name is generated if this field is empty.

This field can contain only lowercase alphanumeric characters or dashes. Max length is 64 characters.

Response body

If successful, the response body contains an instance of Assignment.

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the Authentication Overview.