BigQuery Reservation v1 API - Class ReservationServiceClient (2.6.0)

public abstract class ReservationServiceClient

Reference documentation and code samples for the BigQuery Reservation v1 API class ReservationServiceClient.

ReservationService client wrapper, for convenient use.

Inheritance

object > ReservationServiceClient

Namespace

Google.Cloud.BigQuery.Reservation.V1

Assembly

Google.Cloud.BigQuery.Reservation.V1.dll

Remarks

This API allows users to manage their BigQuery reservations.

A reservation provides computational resource guarantees, in the form of slots, to users. A slot is a unit of computational power in BigQuery, and serves as the basic unit of parallelism. In a scan of a multi-partitioned table, a single slot operates on a single partition of the table. A reservation resource exists as a child resource of the admin project and location, e.g.: projects/myproject/locations/US/reservations/reservationName.

A capacity commitment is a way to purchase compute capacity for BigQuery jobs (in the form of slots) with some committed period of usage. A capacity commitment resource exists as a child resource of the admin project and location, e.g.: projects/myproject/locations/US/capacityCommitments/id.

Properties

DefaultEndpoint

public static string DefaultEndpoint { get; }

The default endpoint for the ReservationService service, which is a host of "bigqueryreservation.googleapis.com" and a port of 443.

Property Value
Type Description
string

DefaultScopes

public static IReadOnlyList<string> DefaultScopes { get; }

The default ReservationService scopes.

Property Value
Type Description
IReadOnlyListstring
Remarks

GrpcClient

public virtual ReservationService.ReservationServiceClient GrpcClient { get; }

The underlying gRPC ReservationService client

Property Value
Type Description
ReservationServiceReservationServiceClient

ServiceMetadata

public static ServiceMetadata ServiceMetadata { get; }

The service metadata associated with this client type.

Property Value
Type Description
ServiceMetadata

Methods

Create()

public static ReservationServiceClient Create()

Synchronously creates a ReservationServiceClient using the default credentials, endpoint and settings. To specify custom credentials or other settings, use ReservationServiceClientBuilder .

Returns
Type Description
ReservationServiceClient

The created ReservationServiceClient.

CreateAssignment(CreateAssignmentRequest, CallSettings)

public virtual Assignment CreateAssignment(CreateAssignmentRequest request, CallSettings callSettings = null)

Creates an assignment object which allows the given project to submit jobs of a certain type using slots from the specified reservation.

Currently a resource (project, folder, organization) can only have one assignment per each (job_type, location) combination, and that reservation will be used for all jobs of the matching type.

Different assignments can be created on different levels of the projects, folders or organization hierarchy. During query execution, the assignment is looked up at the project, folder and organization levels in that order. The first assignment found is applied to the query.

When creating assignments, it does not matter if other assignments exist at higher levels.

Example:

  • The organization organizationA contains two projects, project1 and project2.
  • Assignments for all three entities (organizationA, project1, and project2) could all be created and mapped to the same or different reservations.

"None" assignments represent an absence of the assignment. Projects assigned to None use on-demand pricing. To create a "None" assignment, use "none" as a reservation_id in the parent. Example parent: projects/myproject/locations/US/reservations/none.

Returns google.rpc.Code.PERMISSION_DENIED if user does not have 'bigquery.admin' permissions on the project using the reservation and the project that owns this reservation.

Returns google.rpc.Code.INVALID_ARGUMENT when location of the assignment does not match location of the reservation.

Parameters
Name Description
request CreateAssignmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Assignment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
CreateAssignmentRequest request = new CreateAssignmentRequest
{
    ParentAsReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
    Assignment = new Assignment(),
    AssignmentId = "",
};
// Make the request
Assignment response = reservationServiceClient.CreateAssignment(request);

CreateAssignment(ReservationName, Assignment, CallSettings)

public virtual Assignment CreateAssignment(ReservationName parent, Assignment assignment, CallSettings callSettings = null)

Creates an assignment object which allows the given project to submit jobs of a certain type using slots from the specified reservation.

Currently a resource (project, folder, organization) can only have one assignment per each (job_type, location) combination, and that reservation will be used for all jobs of the matching type.

Different assignments can be created on different levels of the projects, folders or organization hierarchy. During query execution, the assignment is looked up at the project, folder and organization levels in that order. The first assignment found is applied to the query.

When creating assignments, it does not matter if other assignments exist at higher levels.

Example:

  • The organization organizationA contains two projects, project1 and project2.
  • Assignments for all three entities (organizationA, project1, and project2) could all be created and mapped to the same or different reservations.

"None" assignments represent an absence of the assignment. Projects assigned to None use on-demand pricing. To create a "None" assignment, use "none" as a reservation_id in the parent. Example parent: projects/myproject/locations/US/reservations/none.

Returns google.rpc.Code.PERMISSION_DENIED if user does not have 'bigquery.admin' permissions on the project using the reservation and the project that owns this reservation.

Returns google.rpc.Code.INVALID_ARGUMENT when location of the assignment does not match location of the reservation.

Parameters
Name Description
parent ReservationName

Required. The parent resource name of the assignment E.g. projects/myproject/locations/US/reservations/team1-prod

assignment Assignment

Assignment resource to create.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Assignment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
ReservationName parent = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
Assignment assignment = new Assignment();
// Make the request
Assignment response = reservationServiceClient.CreateAssignment(parent, assignment);

CreateAssignment(string, Assignment, CallSettings)

public virtual Assignment CreateAssignment(string parent, Assignment assignment, CallSettings callSettings = null)

Creates an assignment object which allows the given project to submit jobs of a certain type using slots from the specified reservation.

Currently a resource (project, folder, organization) can only have one assignment per each (job_type, location) combination, and that reservation will be used for all jobs of the matching type.

Different assignments can be created on different levels of the projects, folders or organization hierarchy. During query execution, the assignment is looked up at the project, folder and organization levels in that order. The first assignment found is applied to the query.

When creating assignments, it does not matter if other assignments exist at higher levels.

Example:

  • The organization organizationA contains two projects, project1 and project2.
  • Assignments for all three entities (organizationA, project1, and project2) could all be created and mapped to the same or different reservations.

"None" assignments represent an absence of the assignment. Projects assigned to None use on-demand pricing. To create a "None" assignment, use "none" as a reservation_id in the parent. Example parent: projects/myproject/locations/US/reservations/none.

Returns google.rpc.Code.PERMISSION_DENIED if user does not have 'bigquery.admin' permissions on the project using the reservation and the project that owns this reservation.

Returns google.rpc.Code.INVALID_ARGUMENT when location of the assignment does not match location of the reservation.

Parameters
Name Description
parent string

Required. The parent resource name of the assignment E.g. projects/myproject/locations/US/reservations/team1-prod

assignment Assignment

Assignment resource to create.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Assignment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
Assignment assignment = new Assignment();
// Make the request
Assignment response = reservationServiceClient.CreateAssignment(parent, assignment);

CreateAssignmentAsync(CreateAssignmentRequest, CallSettings)

public virtual Task<Assignment> CreateAssignmentAsync(CreateAssignmentRequest request, CallSettings callSettings = null)

Creates an assignment object which allows the given project to submit jobs of a certain type using slots from the specified reservation.

Currently a resource (project, folder, organization) can only have one assignment per each (job_type, location) combination, and that reservation will be used for all jobs of the matching type.

Different assignments can be created on different levels of the projects, folders or organization hierarchy. During query execution, the assignment is looked up at the project, folder and organization levels in that order. The first assignment found is applied to the query.

When creating assignments, it does not matter if other assignments exist at higher levels.

Example:

  • The organization organizationA contains two projects, project1 and project2.
  • Assignments for all three entities (organizationA, project1, and project2) could all be created and mapped to the same or different reservations.

"None" assignments represent an absence of the assignment. Projects assigned to None use on-demand pricing. To create a "None" assignment, use "none" as a reservation_id in the parent. Example parent: projects/myproject/locations/US/reservations/none.

Returns google.rpc.Code.PERMISSION_DENIED if user does not have 'bigquery.admin' permissions on the project using the reservation and the project that owns this reservation.

Returns google.rpc.Code.INVALID_ARGUMENT when location of the assignment does not match location of the reservation.

Parameters
Name Description
request CreateAssignmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CreateAssignmentRequest request = new CreateAssignmentRequest
{
    ParentAsReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
    Assignment = new Assignment(),
    AssignmentId = "",
};
// Make the request
Assignment response = await reservationServiceClient.CreateAssignmentAsync(request);

CreateAssignmentAsync(CreateAssignmentRequest, CancellationToken)

public virtual Task<Assignment> CreateAssignmentAsync(CreateAssignmentRequest request, CancellationToken cancellationToken)

Creates an assignment object which allows the given project to submit jobs of a certain type using slots from the specified reservation.

Currently a resource (project, folder, organization) can only have one assignment per each (job_type, location) combination, and that reservation will be used for all jobs of the matching type.

Different assignments can be created on different levels of the projects, folders or organization hierarchy. During query execution, the assignment is looked up at the project, folder and organization levels in that order. The first assignment found is applied to the query.

When creating assignments, it does not matter if other assignments exist at higher levels.

Example:

  • The organization organizationA contains two projects, project1 and project2.
  • Assignments for all three entities (organizationA, project1, and project2) could all be created and mapped to the same or different reservations.

"None" assignments represent an absence of the assignment. Projects assigned to None use on-demand pricing. To create a "None" assignment, use "none" as a reservation_id in the parent. Example parent: projects/myproject/locations/US/reservations/none.

Returns google.rpc.Code.PERMISSION_DENIED if user does not have 'bigquery.admin' permissions on the project using the reservation and the project that owns this reservation.

Returns google.rpc.Code.INVALID_ARGUMENT when location of the assignment does not match location of the reservation.

Parameters
Name Description
request CreateAssignmentRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CreateAssignmentRequest request = new CreateAssignmentRequest
{
    ParentAsReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
    Assignment = new Assignment(),
    AssignmentId = "",
};
// Make the request
Assignment response = await reservationServiceClient.CreateAssignmentAsync(request);

CreateAssignmentAsync(ReservationName, Assignment, CallSettings)

public virtual Task<Assignment> CreateAssignmentAsync(ReservationName parent, Assignment assignment, CallSettings callSettings = null)

Creates an assignment object which allows the given project to submit jobs of a certain type using slots from the specified reservation.

Currently a resource (project, folder, organization) can only have one assignment per each (job_type, location) combination, and that reservation will be used for all jobs of the matching type.

Different assignments can be created on different levels of the projects, folders or organization hierarchy. During query execution, the assignment is looked up at the project, folder and organization levels in that order. The first assignment found is applied to the query.

When creating assignments, it does not matter if other assignments exist at higher levels.

Example:

  • The organization organizationA contains two projects, project1 and project2.
  • Assignments for all three entities (organizationA, project1, and project2) could all be created and mapped to the same or different reservations.

"None" assignments represent an absence of the assignment. Projects assigned to None use on-demand pricing. To create a "None" assignment, use "none" as a reservation_id in the parent. Example parent: projects/myproject/locations/US/reservations/none.

Returns google.rpc.Code.PERMISSION_DENIED if user does not have 'bigquery.admin' permissions on the project using the reservation and the project that owns this reservation.

Returns google.rpc.Code.INVALID_ARGUMENT when location of the assignment does not match location of the reservation.

Parameters
Name Description
parent ReservationName

Required. The parent resource name of the assignment E.g. projects/myproject/locations/US/reservations/team1-prod

assignment Assignment

Assignment resource to create.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
ReservationName parent = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
Assignment assignment = new Assignment();
// Make the request
Assignment response = await reservationServiceClient.CreateAssignmentAsync(parent, assignment);

CreateAssignmentAsync(ReservationName, Assignment, CancellationToken)

public virtual Task<Assignment> CreateAssignmentAsync(ReservationName parent, Assignment assignment, CancellationToken cancellationToken)

Creates an assignment object which allows the given project to submit jobs of a certain type using slots from the specified reservation.

Currently a resource (project, folder, organization) can only have one assignment per each (job_type, location) combination, and that reservation will be used for all jobs of the matching type.

Different assignments can be created on different levels of the projects, folders or organization hierarchy. During query execution, the assignment is looked up at the project, folder and organization levels in that order. The first assignment found is applied to the query.

When creating assignments, it does not matter if other assignments exist at higher levels.

Example:

  • The organization organizationA contains two projects, project1 and project2.
  • Assignments for all three entities (organizationA, project1, and project2) could all be created and mapped to the same or different reservations.

"None" assignments represent an absence of the assignment. Projects assigned to None use on-demand pricing. To create a "None" assignment, use "none" as a reservation_id in the parent. Example parent: projects/myproject/locations/US/reservations/none.

Returns google.rpc.Code.PERMISSION_DENIED if user does not have 'bigquery.admin' permissions on the project using the reservation and the project that owns this reservation.

Returns google.rpc.Code.INVALID_ARGUMENT when location of the assignment does not match location of the reservation.

Parameters
Name Description
parent ReservationName

Required. The parent resource name of the assignment E.g. projects/myproject/locations/US/reservations/team1-prod

assignment Assignment

Assignment resource to create.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
ReservationName parent = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
Assignment assignment = new Assignment();
// Make the request
Assignment response = await reservationServiceClient.CreateAssignmentAsync(parent, assignment);

CreateAssignmentAsync(string, Assignment, CallSettings)

public virtual Task<Assignment> CreateAssignmentAsync(string parent, Assignment assignment, CallSettings callSettings = null)

Creates an assignment object which allows the given project to submit jobs of a certain type using slots from the specified reservation.

Currently a resource (project, folder, organization) can only have one assignment per each (job_type, location) combination, and that reservation will be used for all jobs of the matching type.

Different assignments can be created on different levels of the projects, folders or organization hierarchy. During query execution, the assignment is looked up at the project, folder and organization levels in that order. The first assignment found is applied to the query.

When creating assignments, it does not matter if other assignments exist at higher levels.

Example:

  • The organization organizationA contains two projects, project1 and project2.
  • Assignments for all three entities (organizationA, project1, and project2) could all be created and mapped to the same or different reservations.

"None" assignments represent an absence of the assignment. Projects assigned to None use on-demand pricing. To create a "None" assignment, use "none" as a reservation_id in the parent. Example parent: projects/myproject/locations/US/reservations/none.

Returns google.rpc.Code.PERMISSION_DENIED if user does not have 'bigquery.admin' permissions on the project using the reservation and the project that owns this reservation.

Returns google.rpc.Code.INVALID_ARGUMENT when location of the assignment does not match location of the reservation.

Parameters
Name Description
parent string

Required. The parent resource name of the assignment E.g. projects/myproject/locations/US/reservations/team1-prod

assignment Assignment

Assignment resource to create.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
Assignment assignment = new Assignment();
// Make the request
Assignment response = await reservationServiceClient.CreateAssignmentAsync(parent, assignment);

CreateAssignmentAsync(string, Assignment, CancellationToken)

public virtual Task<Assignment> CreateAssignmentAsync(string parent, Assignment assignment, CancellationToken cancellationToken)

Creates an assignment object which allows the given project to submit jobs of a certain type using slots from the specified reservation.

Currently a resource (project, folder, organization) can only have one assignment per each (job_type, location) combination, and that reservation will be used for all jobs of the matching type.

Different assignments can be created on different levels of the projects, folders or organization hierarchy. During query execution, the assignment is looked up at the project, folder and organization levels in that order. The first assignment found is applied to the query.

When creating assignments, it does not matter if other assignments exist at higher levels.

Example:

  • The organization organizationA contains two projects, project1 and project2.
  • Assignments for all three entities (organizationA, project1, and project2) could all be created and mapped to the same or different reservations.

"None" assignments represent an absence of the assignment. Projects assigned to None use on-demand pricing. To create a "None" assignment, use "none" as a reservation_id in the parent. Example parent: projects/myproject/locations/US/reservations/none.

Returns google.rpc.Code.PERMISSION_DENIED if user does not have 'bigquery.admin' permissions on the project using the reservation and the project that owns this reservation.

Returns google.rpc.Code.INVALID_ARGUMENT when location of the assignment does not match location of the reservation.

Parameters
Name Description
parent string

Required. The parent resource name of the assignment E.g. projects/myproject/locations/US/reservations/team1-prod

assignment Assignment

Assignment resource to create.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
Assignment assignment = new Assignment();
// Make the request
Assignment response = await reservationServiceClient.CreateAssignmentAsync(parent, assignment);

CreateAsync(CancellationToken)

public static Task<ReservationServiceClient> CreateAsync(CancellationToken cancellationToken = default)

Asynchronously creates a ReservationServiceClient using the default credentials, endpoint and settings. To specify custom credentials or other settings, use ReservationServiceClientBuilder .

Parameter
Name Description
cancellationToken CancellationToken

The CancellationToken to use while creating the client.

Returns
Type Description
TaskReservationServiceClient

The task representing the created ReservationServiceClient.

CreateCapacityCommitment(LocationName, CapacityCommitment, CallSettings)

public virtual CapacityCommitment CreateCapacityCommitment(LocationName parent, CapacityCommitment capacityCommitment, CallSettings callSettings = null)

Creates a new capacity commitment resource.

Parameters
Name Description
parent LocationName

Required. Resource name of the parent reservation. E.g., projects/myproject/locations/US

capacityCommitment CapacityCommitment

Content of the capacity commitment to create.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
CapacityCommitment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
CapacityCommitment capacityCommitment = new CapacityCommitment();
// Make the request
CapacityCommitment response = reservationServiceClient.CreateCapacityCommitment(parent, capacityCommitment);

CreateCapacityCommitment(CreateCapacityCommitmentRequest, CallSettings)

public virtual CapacityCommitment CreateCapacityCommitment(CreateCapacityCommitmentRequest request, CallSettings callSettings = null)

Creates a new capacity commitment resource.

Parameters
Name Description
request CreateCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
CapacityCommitment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
CreateCapacityCommitmentRequest request = new CreateCapacityCommitmentRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    CapacityCommitment = new CapacityCommitment(),
    EnforceSingleAdminProjectPerOrg = false,
    CapacityCommitmentId = "",
};
// Make the request
CapacityCommitment response = reservationServiceClient.CreateCapacityCommitment(request);

CreateCapacityCommitment(string, CapacityCommitment, CallSettings)

public virtual CapacityCommitment CreateCapacityCommitment(string parent, CapacityCommitment capacityCommitment, CallSettings callSettings = null)

Creates a new capacity commitment resource.

Parameters
Name Description
parent string

Required. Resource name of the parent reservation. E.g., projects/myproject/locations/US

capacityCommitment CapacityCommitment

Content of the capacity commitment to create.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
CapacityCommitment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
CapacityCommitment capacityCommitment = new CapacityCommitment();
// Make the request
CapacityCommitment response = reservationServiceClient.CreateCapacityCommitment(parent, capacityCommitment);

CreateCapacityCommitmentAsync(LocationName, CapacityCommitment, CallSettings)

public virtual Task<CapacityCommitment> CreateCapacityCommitmentAsync(LocationName parent, CapacityCommitment capacityCommitment, CallSettings callSettings = null)

Creates a new capacity commitment resource.

Parameters
Name Description
parent LocationName

Required. Resource name of the parent reservation. E.g., projects/myproject/locations/US

capacityCommitment CapacityCommitment

Content of the capacity commitment to create.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
CapacityCommitment capacityCommitment = new CapacityCommitment();
// Make the request
CapacityCommitment response = await reservationServiceClient.CreateCapacityCommitmentAsync(parent, capacityCommitment);

CreateCapacityCommitmentAsync(LocationName, CapacityCommitment, CancellationToken)

public virtual Task<CapacityCommitment> CreateCapacityCommitmentAsync(LocationName parent, CapacityCommitment capacityCommitment, CancellationToken cancellationToken)

Creates a new capacity commitment resource.

Parameters
Name Description
parent LocationName

Required. Resource name of the parent reservation. E.g., projects/myproject/locations/US

capacityCommitment CapacityCommitment

Content of the capacity commitment to create.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
CapacityCommitment capacityCommitment = new CapacityCommitment();
// Make the request
CapacityCommitment response = await reservationServiceClient.CreateCapacityCommitmentAsync(parent, capacityCommitment);

CreateCapacityCommitmentAsync(CreateCapacityCommitmentRequest, CallSettings)

public virtual Task<CapacityCommitment> CreateCapacityCommitmentAsync(CreateCapacityCommitmentRequest request, CallSettings callSettings = null)

Creates a new capacity commitment resource.

Parameters
Name Description
request CreateCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CreateCapacityCommitmentRequest request = new CreateCapacityCommitmentRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    CapacityCommitment = new CapacityCommitment(),
    EnforceSingleAdminProjectPerOrg = false,
    CapacityCommitmentId = "",
};
// Make the request
CapacityCommitment response = await reservationServiceClient.CreateCapacityCommitmentAsync(request);

CreateCapacityCommitmentAsync(CreateCapacityCommitmentRequest, CancellationToken)

public virtual Task<CapacityCommitment> CreateCapacityCommitmentAsync(CreateCapacityCommitmentRequest request, CancellationToken cancellationToken)

Creates a new capacity commitment resource.

Parameters
Name Description
request CreateCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CreateCapacityCommitmentRequest request = new CreateCapacityCommitmentRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    CapacityCommitment = new CapacityCommitment(),
    EnforceSingleAdminProjectPerOrg = false,
    CapacityCommitmentId = "",
};
// Make the request
CapacityCommitment response = await reservationServiceClient.CreateCapacityCommitmentAsync(request);

CreateCapacityCommitmentAsync(string, CapacityCommitment, CallSettings)

public virtual Task<CapacityCommitment> CreateCapacityCommitmentAsync(string parent, CapacityCommitment capacityCommitment, CallSettings callSettings = null)

Creates a new capacity commitment resource.

Parameters
Name Description
parent string

Required. Resource name of the parent reservation. E.g., projects/myproject/locations/US

capacityCommitment CapacityCommitment

Content of the capacity commitment to create.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
CapacityCommitment capacityCommitment = new CapacityCommitment();
// Make the request
CapacityCommitment response = await reservationServiceClient.CreateCapacityCommitmentAsync(parent, capacityCommitment);

CreateCapacityCommitmentAsync(string, CapacityCommitment, CancellationToken)

public virtual Task<CapacityCommitment> CreateCapacityCommitmentAsync(string parent, CapacityCommitment capacityCommitment, CancellationToken cancellationToken)

Creates a new capacity commitment resource.

Parameters
Name Description
parent string

Required. Resource name of the parent reservation. E.g., projects/myproject/locations/US

capacityCommitment CapacityCommitment

Content of the capacity commitment to create.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
CapacityCommitment capacityCommitment = new CapacityCommitment();
// Make the request
CapacityCommitment response = await reservationServiceClient.CreateCapacityCommitmentAsync(parent, capacityCommitment);

CreateReservation(LocationName, Reservation, string, CallSettings)

public virtual Reservation CreateReservation(LocationName parent, Reservation reservation, string reservationId, CallSettings callSettings = null)

Creates a new reservation resource.

Parameters
Name Description
parent LocationName

Required. Project, location. E.g., projects/myproject/locations/US

reservation Reservation

Definition of the new reservation to create.

reservationId string

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.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Reservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
Reservation reservation = new Reservation();
string reservationId = "";
// Make the request
Reservation response = reservationServiceClient.CreateReservation(parent, reservation, reservationId);

CreateReservation(CreateReservationRequest, CallSettings)

public virtual Reservation CreateReservation(CreateReservationRequest request, CallSettings callSettings = null)

Creates a new reservation resource.

Parameters
Name Description
request CreateReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Reservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
CreateReservationRequest request = new CreateReservationRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    ReservationId = "",
    Reservation = new Reservation(),
};
// Make the request
Reservation response = reservationServiceClient.CreateReservation(request);

CreateReservation(string, Reservation, string, CallSettings)

public virtual Reservation CreateReservation(string parent, Reservation reservation, string reservationId, CallSettings callSettings = null)

Creates a new reservation resource.

Parameters
Name Description
parent string

Required. Project, location. E.g., projects/myproject/locations/US

reservation Reservation

Definition of the new reservation to create.

reservationId string

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.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Reservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
Reservation reservation = new Reservation();
string reservationId = "";
// Make the request
Reservation response = reservationServiceClient.CreateReservation(parent, reservation, reservationId);

CreateReservationAsync(LocationName, Reservation, string, CallSettings)

public virtual Task<Reservation> CreateReservationAsync(LocationName parent, Reservation reservation, string reservationId, CallSettings callSettings = null)

Creates a new reservation resource.

Parameters
Name Description
parent LocationName

Required. Project, location. E.g., projects/myproject/locations/US

reservation Reservation

Definition of the new reservation to create.

reservationId string

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.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
Reservation reservation = new Reservation();
string reservationId = "";
// Make the request
Reservation response = await reservationServiceClient.CreateReservationAsync(parent, reservation, reservationId);

CreateReservationAsync(LocationName, Reservation, string, CancellationToken)

public virtual Task<Reservation> CreateReservationAsync(LocationName parent, Reservation reservation, string reservationId, CancellationToken cancellationToken)

Creates a new reservation resource.

Parameters
Name Description
parent LocationName

Required. Project, location. E.g., projects/myproject/locations/US

reservation Reservation

Definition of the new reservation to create.

reservationId string

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.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
Reservation reservation = new Reservation();
string reservationId = "";
// Make the request
Reservation response = await reservationServiceClient.CreateReservationAsync(parent, reservation, reservationId);

CreateReservationAsync(CreateReservationRequest, CallSettings)

public virtual Task<Reservation> CreateReservationAsync(CreateReservationRequest request, CallSettings callSettings = null)

Creates a new reservation resource.

Parameters
Name Description
request CreateReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CreateReservationRequest request = new CreateReservationRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    ReservationId = "",
    Reservation = new Reservation(),
};
// Make the request
Reservation response = await reservationServiceClient.CreateReservationAsync(request);

CreateReservationAsync(CreateReservationRequest, CancellationToken)

public virtual Task<Reservation> CreateReservationAsync(CreateReservationRequest request, CancellationToken cancellationToken)

Creates a new reservation resource.

Parameters
Name Description
request CreateReservationRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CreateReservationRequest request = new CreateReservationRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    ReservationId = "",
    Reservation = new Reservation(),
};
// Make the request
Reservation response = await reservationServiceClient.CreateReservationAsync(request);

CreateReservationAsync(string, Reservation, string, CallSettings)

public virtual Task<Reservation> CreateReservationAsync(string parent, Reservation reservation, string reservationId, CallSettings callSettings = null)

Creates a new reservation resource.

Parameters
Name Description
parent string

Required. Project, location. E.g., projects/myproject/locations/US

reservation Reservation

Definition of the new reservation to create.

reservationId string

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.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
Reservation reservation = new Reservation();
string reservationId = "";
// Make the request
Reservation response = await reservationServiceClient.CreateReservationAsync(parent, reservation, reservationId);

CreateReservationAsync(string, Reservation, string, CancellationToken)

public virtual Task<Reservation> CreateReservationAsync(string parent, Reservation reservation, string reservationId, CancellationToken cancellationToken)

Creates a new reservation resource.

Parameters
Name Description
parent string

Required. Project, location. E.g., projects/myproject/locations/US

reservation Reservation

Definition of the new reservation to create.

reservationId string

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.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
Reservation reservation = new Reservation();
string reservationId = "";
// Make the request
Reservation response = await reservationServiceClient.CreateReservationAsync(parent, reservation, reservationId);

DeleteAssignment(AssignmentName, CallSettings)

public virtual void DeleteAssignment(AssignmentName name, CallSettings callSettings = null)

Deletes a assignment. No expansion will happen.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, deletion of the <organizationA, res1> assignment won't affect the other assignment <project1, res1>. After said deletion, queries from project1 will still use res1 while queries from project2 will switch to use on-demand mode.

Parameters
Name Description
name AssignmentName

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

callSettings CallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
AssignmentName name = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]");
// Make the request
reservationServiceClient.DeleteAssignment(name);

DeleteAssignment(DeleteAssignmentRequest, CallSettings)

public virtual void DeleteAssignment(DeleteAssignmentRequest request, CallSettings callSettings = null)

Deletes a assignment. No expansion will happen.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, deletion of the <organizationA, res1> assignment won't affect the other assignment <project1, res1>. After said deletion, queries from project1 will still use res1 while queries from project2 will switch to use on-demand mode.

Parameters
Name Description
request DeleteAssignmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
DeleteAssignmentRequest request = new DeleteAssignmentRequest
{
    AssignmentName = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]"),
};
// Make the request
reservationServiceClient.DeleteAssignment(request);

DeleteAssignment(string, CallSettings)

public virtual void DeleteAssignment(string name, CallSettings callSettings = null)

Deletes a assignment. No expansion will happen.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, deletion of the <organizationA, res1> assignment won't affect the other assignment <project1, res1>. After said deletion, queries from project1 will still use res1 while queries from project2 will switch to use on-demand mode.

Parameters
Name Description
name string

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

callSettings CallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]/assignments/[ASSIGNMENT]";
// Make the request
reservationServiceClient.DeleteAssignment(name);

DeleteAssignmentAsync(AssignmentName, CallSettings)

public virtual Task DeleteAssignmentAsync(AssignmentName name, CallSettings callSettings = null)

Deletes a assignment. No expansion will happen.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, deletion of the <organizationA, res1> assignment won't affect the other assignment <project1, res1>. After said deletion, queries from project1 will still use res1 while queries from project2 will switch to use on-demand mode.

Parameters
Name Description
name AssignmentName

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

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
AssignmentName name = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]");
// Make the request
await reservationServiceClient.DeleteAssignmentAsync(name);

DeleteAssignmentAsync(AssignmentName, CancellationToken)

public virtual Task DeleteAssignmentAsync(AssignmentName name, CancellationToken cancellationToken)

Deletes a assignment. No expansion will happen.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, deletion of the <organizationA, res1> assignment won't affect the other assignment <project1, res1>. After said deletion, queries from project1 will still use res1 while queries from project2 will switch to use on-demand mode.

Parameters
Name Description
name AssignmentName

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

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
AssignmentName name = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]");
// Make the request
await reservationServiceClient.DeleteAssignmentAsync(name);

DeleteAssignmentAsync(DeleteAssignmentRequest, CallSettings)

public virtual Task DeleteAssignmentAsync(DeleteAssignmentRequest request, CallSettings callSettings = null)

Deletes a assignment. No expansion will happen.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, deletion of the <organizationA, res1> assignment won't affect the other assignment <project1, res1>. After said deletion, queries from project1 will still use res1 while queries from project2 will switch to use on-demand mode.

Parameters
Name Description
request DeleteAssignmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
DeleteAssignmentRequest request = new DeleteAssignmentRequest
{
    AssignmentName = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]"),
};
// Make the request
await reservationServiceClient.DeleteAssignmentAsync(request);

DeleteAssignmentAsync(DeleteAssignmentRequest, CancellationToken)

public virtual Task DeleteAssignmentAsync(DeleteAssignmentRequest request, CancellationToken cancellationToken)

Deletes a assignment. No expansion will happen.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, deletion of the <organizationA, res1> assignment won't affect the other assignment <project1, res1>. After said deletion, queries from project1 will still use res1 while queries from project2 will switch to use on-demand mode.

Parameters
Name Description
request DeleteAssignmentRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
DeleteAssignmentRequest request = new DeleteAssignmentRequest
{
    AssignmentName = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]"),
};
// Make the request
await reservationServiceClient.DeleteAssignmentAsync(request);

DeleteAssignmentAsync(string, CallSettings)

public virtual Task DeleteAssignmentAsync(string name, CallSettings callSettings = null)

Deletes a assignment. No expansion will happen.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, deletion of the <organizationA, res1> assignment won't affect the other assignment <project1, res1>. After said deletion, queries from project1 will still use res1 while queries from project2 will switch to use on-demand mode.

Parameters
Name Description
name string

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

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]/assignments/[ASSIGNMENT]";
// Make the request
await reservationServiceClient.DeleteAssignmentAsync(name);

DeleteAssignmentAsync(string, CancellationToken)

public virtual Task DeleteAssignmentAsync(string name, CancellationToken cancellationToken)

Deletes a assignment. No expansion will happen.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, deletion of the <organizationA, res1> assignment won't affect the other assignment <project1, res1>. After said deletion, queries from project1 will still use res1 while queries from project2 will switch to use on-demand mode.

Parameters
Name Description
name string

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

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]/assignments/[ASSIGNMENT]";
// Make the request
await reservationServiceClient.DeleteAssignmentAsync(name);

DeleteCapacityCommitment(CapacityCommitmentName, CallSettings)

public virtual void DeleteCapacityCommitment(CapacityCommitmentName name, CallSettings callSettings = null)

Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
name CapacityCommitmentName

Required. Resource name of the capacity commitment to delete. E.g., projects/myproject/locations/US/capacityCommitments/123

callSettings CallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
CapacityCommitmentName name = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]");
// Make the request
reservationServiceClient.DeleteCapacityCommitment(name);

DeleteCapacityCommitment(DeleteCapacityCommitmentRequest, CallSettings)

public virtual void DeleteCapacityCommitment(DeleteCapacityCommitmentRequest request, CallSettings callSettings = null)

Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
request DeleteCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
DeleteCapacityCommitmentRequest request = new DeleteCapacityCommitmentRequest
{
    CapacityCommitmentName = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]"),
    Force = false,
};
// Make the request
reservationServiceClient.DeleteCapacityCommitment(request);

DeleteCapacityCommitment(string, CallSettings)

public virtual void DeleteCapacityCommitment(string name, CallSettings callSettings = null)

Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
name string

Required. Resource name of the capacity commitment to delete. E.g., projects/myproject/locations/US/capacityCommitments/123

callSettings CallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/capacityCommitments/[CAPACITY_COMMITMENT]";
// Make the request
reservationServiceClient.DeleteCapacityCommitment(name);

DeleteCapacityCommitmentAsync(CapacityCommitmentName, CallSettings)

public virtual Task DeleteCapacityCommitmentAsync(CapacityCommitmentName name, CallSettings callSettings = null)

Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
name CapacityCommitmentName

Required. Resource name of the capacity commitment to delete. E.g., projects/myproject/locations/US/capacityCommitments/123

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CapacityCommitmentName name = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]");
// Make the request
await reservationServiceClient.DeleteCapacityCommitmentAsync(name);

DeleteCapacityCommitmentAsync(CapacityCommitmentName, CancellationToken)

public virtual Task DeleteCapacityCommitmentAsync(CapacityCommitmentName name, CancellationToken cancellationToken)

Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
name CapacityCommitmentName

Required. Resource name of the capacity commitment to delete. E.g., projects/myproject/locations/US/capacityCommitments/123

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CapacityCommitmentName name = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]");
// Make the request
await reservationServiceClient.DeleteCapacityCommitmentAsync(name);

DeleteCapacityCommitmentAsync(DeleteCapacityCommitmentRequest, CallSettings)

public virtual Task DeleteCapacityCommitmentAsync(DeleteCapacityCommitmentRequest request, CallSettings callSettings = null)

Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
request DeleteCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
DeleteCapacityCommitmentRequest request = new DeleteCapacityCommitmentRequest
{
    CapacityCommitmentName = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]"),
    Force = false,
};
// Make the request
await reservationServiceClient.DeleteCapacityCommitmentAsync(request);

DeleteCapacityCommitmentAsync(DeleteCapacityCommitmentRequest, CancellationToken)

public virtual Task DeleteCapacityCommitmentAsync(DeleteCapacityCommitmentRequest request, CancellationToken cancellationToken)

Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
request DeleteCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
DeleteCapacityCommitmentRequest request = new DeleteCapacityCommitmentRequest
{
    CapacityCommitmentName = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]"),
    Force = false,
};
// Make the request
await reservationServiceClient.DeleteCapacityCommitmentAsync(request);

DeleteCapacityCommitmentAsync(string, CallSettings)

public virtual Task DeleteCapacityCommitmentAsync(string name, CallSettings callSettings = null)

Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
name string

Required. Resource name of the capacity commitment to delete. E.g., projects/myproject/locations/US/capacityCommitments/123

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/capacityCommitments/[CAPACITY_COMMITMENT]";
// Make the request
await reservationServiceClient.DeleteCapacityCommitmentAsync(name);

DeleteCapacityCommitmentAsync(string, CancellationToken)

public virtual Task DeleteCapacityCommitmentAsync(string name, CancellationToken cancellationToken)

Deletes a capacity commitment. Attempting to delete capacity commitment before its commitment_end_time will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
name string

Required. Resource name of the capacity commitment to delete. E.g., projects/myproject/locations/US/capacityCommitments/123

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/capacityCommitments/[CAPACITY_COMMITMENT]";
// Make the request
await reservationServiceClient.DeleteCapacityCommitmentAsync(name);

DeleteReservation(DeleteReservationRequest, CallSettings)

public virtual void DeleteReservation(DeleteReservationRequest request, CallSettings callSettings = null)

Deletes a reservation. Returns google.rpc.Code.FAILED_PRECONDITION when reservation has assignments.

Parameters
Name Description
request DeleteReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
DeleteReservationRequest request = new DeleteReservationRequest
{
    ReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
};
// Make the request
reservationServiceClient.DeleteReservation(request);

DeleteReservation(ReservationName, CallSettings)

public virtual void DeleteReservation(ReservationName name, CallSettings callSettings = null)

Deletes a reservation. Returns google.rpc.Code.FAILED_PRECONDITION when reservation has assignments.

Parameters
Name Description
name ReservationName

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

callSettings CallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
ReservationName name = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
// Make the request
reservationServiceClient.DeleteReservation(name);

DeleteReservation(string, CallSettings)

public virtual void DeleteReservation(string name, CallSettings callSettings = null)

Deletes a reservation. Returns google.rpc.Code.FAILED_PRECONDITION when reservation has assignments.

Parameters
Name Description
name string

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

callSettings CallSettings

If not null, applies overrides to this RPC call.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
// Make the request
reservationServiceClient.DeleteReservation(name);

DeleteReservationAsync(DeleteReservationRequest, CallSettings)

public virtual Task DeleteReservationAsync(DeleteReservationRequest request, CallSettings callSettings = null)

Deletes a reservation. Returns google.rpc.Code.FAILED_PRECONDITION when reservation has assignments.

Parameters
Name Description
request DeleteReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
DeleteReservationRequest request = new DeleteReservationRequest
{
    ReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
};
// Make the request
await reservationServiceClient.DeleteReservationAsync(request);

DeleteReservationAsync(DeleteReservationRequest, CancellationToken)

public virtual Task DeleteReservationAsync(DeleteReservationRequest request, CancellationToken cancellationToken)

Deletes a reservation. Returns google.rpc.Code.FAILED_PRECONDITION when reservation has assignments.

Parameters
Name Description
request DeleteReservationRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
DeleteReservationRequest request = new DeleteReservationRequest
{
    ReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
};
// Make the request
await reservationServiceClient.DeleteReservationAsync(request);

DeleteReservationAsync(ReservationName, CallSettings)

public virtual Task DeleteReservationAsync(ReservationName name, CallSettings callSettings = null)

Deletes a reservation. Returns google.rpc.Code.FAILED_PRECONDITION when reservation has assignments.

Parameters
Name Description
name ReservationName

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
ReservationName name = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
// Make the request
await reservationServiceClient.DeleteReservationAsync(name);

DeleteReservationAsync(ReservationName, CancellationToken)

public virtual Task DeleteReservationAsync(ReservationName name, CancellationToken cancellationToken)

Deletes a reservation. Returns google.rpc.Code.FAILED_PRECONDITION when reservation has assignments.

Parameters
Name Description
name ReservationName

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
ReservationName name = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
// Make the request
await reservationServiceClient.DeleteReservationAsync(name);

DeleteReservationAsync(string, CallSettings)

public virtual Task DeleteReservationAsync(string name, CallSettings callSettings = null)

Deletes a reservation. Returns google.rpc.Code.FAILED_PRECONDITION when reservation has assignments.

Parameters
Name Description
name string

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
// Make the request
await reservationServiceClient.DeleteReservationAsync(name);

DeleteReservationAsync(string, CancellationToken)

public virtual Task DeleteReservationAsync(string name, CancellationToken cancellationToken)

Deletes a reservation. Returns google.rpc.Code.FAILED_PRECONDITION when reservation has assignments.

Parameters
Name Description
name string

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
Task

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
// Make the request
await reservationServiceClient.DeleteReservationAsync(name);

FailoverReservation(FailoverReservationRequest, CallSettings)

public virtual Reservation FailoverReservation(FailoverReservationRequest request, CallSettings callSettings = null)

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.

Parameters
Name Description
request FailoverReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Reservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
FailoverReservationRequest request = new FailoverReservationRequest
{
    ReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
};
// Make the request
Reservation response = reservationServiceClient.FailoverReservation(request);

FailoverReservationAsync(FailoverReservationRequest, CallSettings)

public virtual Task<Reservation> FailoverReservationAsync(FailoverReservationRequest request, CallSettings callSettings = null)

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.

Parameters
Name Description
request FailoverReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
FailoverReservationRequest request = new FailoverReservationRequest
{
    ReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
};
// Make the request
Reservation response = await reservationServiceClient.FailoverReservationAsync(request);

FailoverReservationAsync(FailoverReservationRequest, CancellationToken)

public virtual Task<Reservation> FailoverReservationAsync(FailoverReservationRequest request, CancellationToken cancellationToken)

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.

Parameters
Name Description
request FailoverReservationRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
FailoverReservationRequest request = new FailoverReservationRequest
{
    ReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
};
// Make the request
Reservation response = await reservationServiceClient.FailoverReservationAsync(request);

GetBiReservation(BiReservationName, CallSettings)

public virtual BiReservation GetBiReservation(BiReservationName name, CallSettings callSettings = null)

Retrieves a BI reservation.

Parameters
Name Description
name BiReservationName

Required. Name of the requested reservation, for example: projects/{project_id}/locations/{location_id}/biReservation

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
BiReservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
BiReservationName name = BiReservationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
BiReservation response = reservationServiceClient.GetBiReservation(name);

GetBiReservation(GetBiReservationRequest, CallSettings)

public virtual BiReservation GetBiReservation(GetBiReservationRequest request, CallSettings callSettings = null)

Retrieves a BI reservation.

Parameters
Name Description
request GetBiReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
BiReservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
GetBiReservationRequest request = new GetBiReservationRequest
{
    BiReservationName = BiReservationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
};
// Make the request
BiReservation response = reservationServiceClient.GetBiReservation(request);

GetBiReservation(string, CallSettings)

public virtual BiReservation GetBiReservation(string name, CallSettings callSettings = null)

Retrieves a BI reservation.

Parameters
Name Description
name string

Required. Name of the requested reservation, for example: projects/{project_id}/locations/{location_id}/biReservation

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
BiReservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/biReservation";
// Make the request
BiReservation response = reservationServiceClient.GetBiReservation(name);

GetBiReservationAsync(BiReservationName, CallSettings)

public virtual Task<BiReservation> GetBiReservationAsync(BiReservationName name, CallSettings callSettings = null)

Retrieves a BI reservation.

Parameters
Name Description
name BiReservationName

Required. Name of the requested reservation, for example: projects/{project_id}/locations/{location_id}/biReservation

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskBiReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
BiReservationName name = BiReservationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
BiReservation response = await reservationServiceClient.GetBiReservationAsync(name);

GetBiReservationAsync(BiReservationName, CancellationToken)

public virtual Task<BiReservation> GetBiReservationAsync(BiReservationName name, CancellationToken cancellationToken)

Retrieves a BI reservation.

Parameters
Name Description
name BiReservationName

Required. Name of the requested reservation, for example: projects/{project_id}/locations/{location_id}/biReservation

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskBiReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
BiReservationName name = BiReservationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
BiReservation response = await reservationServiceClient.GetBiReservationAsync(name);

GetBiReservationAsync(GetBiReservationRequest, CallSettings)

public virtual Task<BiReservation> GetBiReservationAsync(GetBiReservationRequest request, CallSettings callSettings = null)

Retrieves a BI reservation.

Parameters
Name Description
request GetBiReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskBiReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
GetBiReservationRequest request = new GetBiReservationRequest
{
    BiReservationName = BiReservationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
};
// Make the request
BiReservation response = await reservationServiceClient.GetBiReservationAsync(request);

GetBiReservationAsync(GetBiReservationRequest, CancellationToken)

public virtual Task<BiReservation> GetBiReservationAsync(GetBiReservationRequest request, CancellationToken cancellationToken)

Retrieves a BI reservation.

Parameters
Name Description
request GetBiReservationRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskBiReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
GetBiReservationRequest request = new GetBiReservationRequest
{
    BiReservationName = BiReservationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
};
// Make the request
BiReservation response = await reservationServiceClient.GetBiReservationAsync(request);

GetBiReservationAsync(string, CallSettings)

public virtual Task<BiReservation> GetBiReservationAsync(string name, CallSettings callSettings = null)

Retrieves a BI reservation.

Parameters
Name Description
name string

Required. Name of the requested reservation, for example: projects/{project_id}/locations/{location_id}/biReservation

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskBiReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/biReservation";
// Make the request
BiReservation response = await reservationServiceClient.GetBiReservationAsync(name);

GetBiReservationAsync(string, CancellationToken)

public virtual Task<BiReservation> GetBiReservationAsync(string name, CancellationToken cancellationToken)

Retrieves a BI reservation.

Parameters
Name Description
name string

Required. Name of the requested reservation, for example: projects/{project_id}/locations/{location_id}/biReservation

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskBiReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/biReservation";
// Make the request
BiReservation response = await reservationServiceClient.GetBiReservationAsync(name);

GetCapacityCommitment(CapacityCommitmentName, CallSettings)

public virtual CapacityCommitment GetCapacityCommitment(CapacityCommitmentName name, CallSettings callSettings = null)

Returns information about the capacity commitment.

Parameters
Name Description
name CapacityCommitmentName

Required. Resource name of the capacity commitment to retrieve. E.g., projects/myproject/locations/US/capacityCommitments/123

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
CapacityCommitment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
CapacityCommitmentName name = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]");
// Make the request
CapacityCommitment response = reservationServiceClient.GetCapacityCommitment(name);

GetCapacityCommitment(GetCapacityCommitmentRequest, CallSettings)

public virtual CapacityCommitment GetCapacityCommitment(GetCapacityCommitmentRequest request, CallSettings callSettings = null)

Returns information about the capacity commitment.

Parameters
Name Description
request GetCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
CapacityCommitment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
GetCapacityCommitmentRequest request = new GetCapacityCommitmentRequest
{
    CapacityCommitmentName = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]"),
};
// Make the request
CapacityCommitment response = reservationServiceClient.GetCapacityCommitment(request);

GetCapacityCommitment(string, CallSettings)

public virtual CapacityCommitment GetCapacityCommitment(string name, CallSettings callSettings = null)

Returns information about the capacity commitment.

Parameters
Name Description
name string

Required. Resource name of the capacity commitment to retrieve. E.g., projects/myproject/locations/US/capacityCommitments/123

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
CapacityCommitment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/capacityCommitments/[CAPACITY_COMMITMENT]";
// Make the request
CapacityCommitment response = reservationServiceClient.GetCapacityCommitment(name);

GetCapacityCommitmentAsync(CapacityCommitmentName, CallSettings)

public virtual Task<CapacityCommitment> GetCapacityCommitmentAsync(CapacityCommitmentName name, CallSettings callSettings = null)

Returns information about the capacity commitment.

Parameters
Name Description
name CapacityCommitmentName

Required. Resource name of the capacity commitment to retrieve. E.g., projects/myproject/locations/US/capacityCommitments/123

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CapacityCommitmentName name = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]");
// Make the request
CapacityCommitment response = await reservationServiceClient.GetCapacityCommitmentAsync(name);

GetCapacityCommitmentAsync(CapacityCommitmentName, CancellationToken)

public virtual Task<CapacityCommitment> GetCapacityCommitmentAsync(CapacityCommitmentName name, CancellationToken cancellationToken)

Returns information about the capacity commitment.

Parameters
Name Description
name CapacityCommitmentName

Required. Resource name of the capacity commitment to retrieve. E.g., projects/myproject/locations/US/capacityCommitments/123

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CapacityCommitmentName name = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]");
// Make the request
CapacityCommitment response = await reservationServiceClient.GetCapacityCommitmentAsync(name);

GetCapacityCommitmentAsync(GetCapacityCommitmentRequest, CallSettings)

public virtual Task<CapacityCommitment> GetCapacityCommitmentAsync(GetCapacityCommitmentRequest request, CallSettings callSettings = null)

Returns information about the capacity commitment.

Parameters
Name Description
request GetCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
GetCapacityCommitmentRequest request = new GetCapacityCommitmentRequest
{
    CapacityCommitmentName = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]"),
};
// Make the request
CapacityCommitment response = await reservationServiceClient.GetCapacityCommitmentAsync(request);

GetCapacityCommitmentAsync(GetCapacityCommitmentRequest, CancellationToken)

public virtual Task<CapacityCommitment> GetCapacityCommitmentAsync(GetCapacityCommitmentRequest request, CancellationToken cancellationToken)

Returns information about the capacity commitment.

Parameters
Name Description
request GetCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
GetCapacityCommitmentRequest request = new GetCapacityCommitmentRequest
{
    CapacityCommitmentName = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]"),
};
// Make the request
CapacityCommitment response = await reservationServiceClient.GetCapacityCommitmentAsync(request);

GetCapacityCommitmentAsync(string, CallSettings)

public virtual Task<CapacityCommitment> GetCapacityCommitmentAsync(string name, CallSettings callSettings = null)

Returns information about the capacity commitment.

Parameters
Name Description
name string

Required. Resource name of the capacity commitment to retrieve. E.g., projects/myproject/locations/US/capacityCommitments/123

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/capacityCommitments/[CAPACITY_COMMITMENT]";
// Make the request
CapacityCommitment response = await reservationServiceClient.GetCapacityCommitmentAsync(name);

GetCapacityCommitmentAsync(string, CancellationToken)

public virtual Task<CapacityCommitment> GetCapacityCommitmentAsync(string name, CancellationToken cancellationToken)

Returns information about the capacity commitment.

Parameters
Name Description
name string

Required. Resource name of the capacity commitment to retrieve. E.g., projects/myproject/locations/US/capacityCommitments/123

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/capacityCommitments/[CAPACITY_COMMITMENT]";
// Make the request
CapacityCommitment response = await reservationServiceClient.GetCapacityCommitmentAsync(name);

GetReservation(GetReservationRequest, CallSettings)

public virtual Reservation GetReservation(GetReservationRequest request, CallSettings callSettings = null)

Returns information about the reservation.

Parameters
Name Description
request GetReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Reservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
GetReservationRequest request = new GetReservationRequest
{
    ReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
};
// Make the request
Reservation response = reservationServiceClient.GetReservation(request);

GetReservation(ReservationName, CallSettings)

public virtual Reservation GetReservation(ReservationName name, CallSettings callSettings = null)

Returns information about the reservation.

Parameters
Name Description
name ReservationName

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Reservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
ReservationName name = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
// Make the request
Reservation response = reservationServiceClient.GetReservation(name);

GetReservation(string, CallSettings)

public virtual Reservation GetReservation(string name, CallSettings callSettings = null)

Returns information about the reservation.

Parameters
Name Description
name string

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Reservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
// Make the request
Reservation response = reservationServiceClient.GetReservation(name);

GetReservationAsync(GetReservationRequest, CallSettings)

public virtual Task<Reservation> GetReservationAsync(GetReservationRequest request, CallSettings callSettings = null)

Returns information about the reservation.

Parameters
Name Description
request GetReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
GetReservationRequest request = new GetReservationRequest
{
    ReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
};
// Make the request
Reservation response = await reservationServiceClient.GetReservationAsync(request);

GetReservationAsync(GetReservationRequest, CancellationToken)

public virtual Task<Reservation> GetReservationAsync(GetReservationRequest request, CancellationToken cancellationToken)

Returns information about the reservation.

Parameters
Name Description
request GetReservationRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
GetReservationRequest request = new GetReservationRequest
{
    ReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
};
// Make the request
Reservation response = await reservationServiceClient.GetReservationAsync(request);

GetReservationAsync(ReservationName, CallSettings)

public virtual Task<Reservation> GetReservationAsync(ReservationName name, CallSettings callSettings = null)

Returns information about the reservation.

Parameters
Name Description
name ReservationName

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
ReservationName name = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
// Make the request
Reservation response = await reservationServiceClient.GetReservationAsync(name);

GetReservationAsync(ReservationName, CancellationToken)

public virtual Task<Reservation> GetReservationAsync(ReservationName name, CancellationToken cancellationToken)

Returns information about the reservation.

Parameters
Name Description
name ReservationName

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
ReservationName name = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
// Make the request
Reservation response = await reservationServiceClient.GetReservationAsync(name);

GetReservationAsync(string, CallSettings)

public virtual Task<Reservation> GetReservationAsync(string name, CallSettings callSettings = null)

Returns information about the reservation.

Parameters
Name Description
name string

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
// Make the request
Reservation response = await reservationServiceClient.GetReservationAsync(name);

GetReservationAsync(string, CancellationToken)

public virtual Task<Reservation> GetReservationAsync(string name, CancellationToken cancellationToken)

Returns information about the reservation.

Parameters
Name Description
name string

Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
// Make the request
Reservation response = await reservationServiceClient.GetReservationAsync(name);

ListAssignments(ListAssignmentsRequest, CallSettings)

public virtual PagedEnumerable<ListAssignmentsResponse, Assignment> ListAssignments(ListAssignmentsRequest request, CallSettings callSettings = null)

Lists assignments.

Only explicitly created assignments will be returned.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, ListAssignments will just return the above two assignments for reservation res1, and no expansion/merge will happen.

The wildcard "-" can be used for reservations in the request. In that case all assignments belongs to the specified project and location will be listed.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
request ListAssignmentsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableListAssignmentsResponseAssignment

A pageable sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
ListAssignmentsRequest request = new ListAssignmentsRequest
{
    ParentAsReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
};
// Make the request
PagedEnumerable<ListAssignmentsResponse, Assignment> response = reservationServiceClient.ListAssignments(request);

// Iterate over all response items, lazily performing RPCs as required
foreach (Assignment item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListAssignmentsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListAssignments(ReservationName, string, int?, CallSettings)

public virtual PagedEnumerable<ListAssignmentsResponse, Assignment> ListAssignments(ReservationName parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists assignments.

Only explicitly created assignments will be returned.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, ListAssignments will just return the above two assignments for reservation res1, and no expansion/merge will happen.

The wildcard "-" can be used for reservations in the request. In that case all assignments belongs to the specified project and location will be listed.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
parent ReservationName

Required. The parent resource name e.g.:

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

Or:

projects/myproject/locations/US/reservations/-

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableListAssignmentsResponseAssignment

A pageable sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
ReservationName parent = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
// Make the request
PagedEnumerable<ListAssignmentsResponse, Assignment> response = reservationServiceClient.ListAssignments(parent);

// Iterate over all response items, lazily performing RPCs as required
foreach (Assignment item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListAssignmentsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListAssignments(string, string, int?, CallSettings)

public virtual PagedEnumerable<ListAssignmentsResponse, Assignment> ListAssignments(string parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists assignments.

Only explicitly created assignments will be returned.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, ListAssignments will just return the above two assignments for reservation res1, and no expansion/merge will happen.

The wildcard "-" can be used for reservations in the request. In that case all assignments belongs to the specified project and location will be listed.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
parent string

Required. The parent resource name e.g.:

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

Or:

projects/myproject/locations/US/reservations/-

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableListAssignmentsResponseAssignment

A pageable sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
// Make the request
PagedEnumerable<ListAssignmentsResponse, Assignment> response = reservationServiceClient.ListAssignments(parent);

// Iterate over all response items, lazily performing RPCs as required
foreach (Assignment item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListAssignmentsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListAssignmentsAsync(ListAssignmentsRequest, CallSettings)

public virtual PagedAsyncEnumerable<ListAssignmentsResponse, Assignment> ListAssignmentsAsync(ListAssignmentsRequest request, CallSettings callSettings = null)

Lists assignments.

Only explicitly created assignments will be returned.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, ListAssignments will just return the above two assignments for reservation res1, and no expansion/merge will happen.

The wildcard "-" can be used for reservations in the request. In that case all assignments belongs to the specified project and location will be listed.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
request ListAssignmentsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableListAssignmentsResponseAssignment

A pageable asynchronous sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
ListAssignmentsRequest request = new ListAssignmentsRequest
{
    ParentAsReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
};
// Make the request
PagedAsyncEnumerable<ListAssignmentsResponse, Assignment> response = reservationServiceClient.ListAssignmentsAsync(request);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Assignment item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListAssignmentsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListAssignmentsAsync(ReservationName, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<ListAssignmentsResponse, Assignment> ListAssignmentsAsync(ReservationName parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists assignments.

Only explicitly created assignments will be returned.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, ListAssignments will just return the above two assignments for reservation res1, and no expansion/merge will happen.

The wildcard "-" can be used for reservations in the request. In that case all assignments belongs to the specified project and location will be listed.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
parent ReservationName

Required. The parent resource name e.g.:

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

Or:

projects/myproject/locations/US/reservations/-

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableListAssignmentsResponseAssignment

A pageable asynchronous sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
ReservationName parent = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
// Make the request
PagedAsyncEnumerable<ListAssignmentsResponse, Assignment> response = reservationServiceClient.ListAssignmentsAsync(parent);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Assignment item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListAssignmentsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListAssignmentsAsync(string, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<ListAssignmentsResponse, Assignment> ListAssignmentsAsync(string parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists assignments.

Only explicitly created assignments will be returned.

Example:

  • Organization organizationA contains two projects, project1 and project2.
  • Reservation res1 exists and was created previously.
  • CreateAssignment was used previously to define the following associations between entities and reservations: <organizationA, res1> and <project1, res1>

In this example, ListAssignments will just return the above two assignments for reservation res1, and no expansion/merge will happen.

The wildcard "-" can be used for reservations in the request. In that case all assignments belongs to the specified project and location will be listed.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
parent string

Required. The parent resource name e.g.:

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

Or:

projects/myproject/locations/US/reservations/-

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableListAssignmentsResponseAssignment

A pageable asynchronous sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
// Make the request
PagedAsyncEnumerable<ListAssignmentsResponse, Assignment> response = reservationServiceClient.ListAssignmentsAsync(parent);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Assignment item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListAssignmentsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListCapacityCommitments(LocationName, string, int?, CallSettings)

public virtual PagedEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> ListCapacityCommitments(LocationName parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the capacity commitments for the admin project.

Parameters
Name Description
parent LocationName

Required. Resource name of the parent reservation. E.g., projects/myproject/locations/US

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableListCapacityCommitmentsResponseCapacityCommitment

A pageable sequence of CapacityCommitment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
PagedEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> response = reservationServiceClient.ListCapacityCommitments(parent);

// Iterate over all response items, lazily performing RPCs as required
foreach (CapacityCommitment item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListCapacityCommitmentsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (CapacityCommitment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<CapacityCommitment> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (CapacityCommitment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListCapacityCommitments(ListCapacityCommitmentsRequest, CallSettings)

public virtual PagedEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> ListCapacityCommitments(ListCapacityCommitmentsRequest request, CallSettings callSettings = null)

Lists all the capacity commitments for the admin project.

Parameters
Name Description
request ListCapacityCommitmentsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableListCapacityCommitmentsResponseCapacityCommitment

A pageable sequence of CapacityCommitment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
ListCapacityCommitmentsRequest request = new ListCapacityCommitmentsRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
};
// Make the request
PagedEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> response = reservationServiceClient.ListCapacityCommitments(request);

// Iterate over all response items, lazily performing RPCs as required
foreach (CapacityCommitment item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListCapacityCommitmentsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (CapacityCommitment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<CapacityCommitment> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (CapacityCommitment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListCapacityCommitments(string, string, int?, CallSettings)

public virtual PagedEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> ListCapacityCommitments(string parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the capacity commitments for the admin project.

Parameters
Name Description
parent string

Required. Resource name of the parent reservation. E.g., projects/myproject/locations/US

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableListCapacityCommitmentsResponseCapacityCommitment

A pageable sequence of CapacityCommitment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
// Make the request
PagedEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> response = reservationServiceClient.ListCapacityCommitments(parent);

// Iterate over all response items, lazily performing RPCs as required
foreach (CapacityCommitment item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListCapacityCommitmentsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (CapacityCommitment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<CapacityCommitment> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (CapacityCommitment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListCapacityCommitmentsAsync(LocationName, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> ListCapacityCommitmentsAsync(LocationName parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the capacity commitments for the admin project.

Parameters
Name Description
parent LocationName

Required. Resource name of the parent reservation. E.g., projects/myproject/locations/US

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableListCapacityCommitmentsResponseCapacityCommitment

A pageable asynchronous sequence of CapacityCommitment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
PagedAsyncEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> response = reservationServiceClient.ListCapacityCommitmentsAsync(parent);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((CapacityCommitment item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListCapacityCommitmentsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (CapacityCommitment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<CapacityCommitment> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (CapacityCommitment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListCapacityCommitmentsAsync(ListCapacityCommitmentsRequest, CallSettings)

public virtual PagedAsyncEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> ListCapacityCommitmentsAsync(ListCapacityCommitmentsRequest request, CallSettings callSettings = null)

Lists all the capacity commitments for the admin project.

Parameters
Name Description
request ListCapacityCommitmentsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableListCapacityCommitmentsResponseCapacityCommitment

A pageable asynchronous sequence of CapacityCommitment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
ListCapacityCommitmentsRequest request = new ListCapacityCommitmentsRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
};
// Make the request
PagedAsyncEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> response = reservationServiceClient.ListCapacityCommitmentsAsync(request);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((CapacityCommitment item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListCapacityCommitmentsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (CapacityCommitment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<CapacityCommitment> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (CapacityCommitment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListCapacityCommitmentsAsync(string, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> ListCapacityCommitmentsAsync(string parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the capacity commitments for the admin project.

Parameters
Name Description
parent string

Required. Resource name of the parent reservation. E.g., projects/myproject/locations/US

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableListCapacityCommitmentsResponseCapacityCommitment

A pageable asynchronous sequence of CapacityCommitment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
// Make the request
PagedAsyncEnumerable<ListCapacityCommitmentsResponse, CapacityCommitment> response = reservationServiceClient.ListCapacityCommitmentsAsync(parent);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((CapacityCommitment item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListCapacityCommitmentsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (CapacityCommitment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<CapacityCommitment> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (CapacityCommitment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListReservations(LocationName, string, int?, CallSettings)

public virtual PagedEnumerable<ListReservationsResponse, Reservation> ListReservations(LocationName parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the reservations for the project in the specified location.

Parameters
Name Description
parent LocationName

Required. The parent resource name containing project and location, e.g.: projects/myproject/locations/US

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableListReservationsResponseReservation

A pageable sequence of Reservation resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
PagedEnumerable<ListReservationsResponse, Reservation> response = reservationServiceClient.ListReservations(parent);

// Iterate over all response items, lazily performing RPCs as required
foreach (Reservation item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListReservationsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Reservation item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Reservation> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Reservation item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListReservations(ListReservationsRequest, CallSettings)

public virtual PagedEnumerable<ListReservationsResponse, Reservation> ListReservations(ListReservationsRequest request, CallSettings callSettings = null)

Lists all the reservations for the project in the specified location.

Parameters
Name Description
request ListReservationsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableListReservationsResponseReservation

A pageable sequence of Reservation resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
ListReservationsRequest request = new ListReservationsRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
};
// Make the request
PagedEnumerable<ListReservationsResponse, Reservation> response = reservationServiceClient.ListReservations(request);

// Iterate over all response items, lazily performing RPCs as required
foreach (Reservation item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListReservationsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Reservation item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Reservation> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Reservation item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListReservations(string, string, int?, CallSettings)

public virtual PagedEnumerable<ListReservationsResponse, Reservation> ListReservations(string parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the reservations for the project in the specified location.

Parameters
Name Description
parent string

Required. The parent resource name containing project and location, e.g.: projects/myproject/locations/US

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableListReservationsResponseReservation

A pageable sequence of Reservation resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
// Make the request
PagedEnumerable<ListReservationsResponse, Reservation> response = reservationServiceClient.ListReservations(parent);

// Iterate over all response items, lazily performing RPCs as required
foreach (Reservation item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListReservationsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Reservation item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Reservation> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Reservation item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListReservationsAsync(LocationName, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<ListReservationsResponse, Reservation> ListReservationsAsync(LocationName parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the reservations for the project in the specified location.

Parameters
Name Description
parent LocationName

Required. The parent resource name containing project and location, e.g.: projects/myproject/locations/US

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableListReservationsResponseReservation

A pageable asynchronous sequence of Reservation resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
PagedAsyncEnumerable<ListReservationsResponse, Reservation> response = reservationServiceClient.ListReservationsAsync(parent);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Reservation item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListReservationsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Reservation item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Reservation> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Reservation item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListReservationsAsync(ListReservationsRequest, CallSettings)

public virtual PagedAsyncEnumerable<ListReservationsResponse, Reservation> ListReservationsAsync(ListReservationsRequest request, CallSettings callSettings = null)

Lists all the reservations for the project in the specified location.

Parameters
Name Description
request ListReservationsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableListReservationsResponseReservation

A pageable asynchronous sequence of Reservation resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
ListReservationsRequest request = new ListReservationsRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
};
// Make the request
PagedAsyncEnumerable<ListReservationsResponse, Reservation> response = reservationServiceClient.ListReservationsAsync(request);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Reservation item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListReservationsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Reservation item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Reservation> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Reservation item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

ListReservationsAsync(string, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<ListReservationsResponse, Reservation> ListReservationsAsync(string parent, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Lists all the reservations for the project in the specified location.

Parameters
Name Description
parent string

Required. The parent resource name containing project and location, e.g.: projects/myproject/locations/US

pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableListReservationsResponseReservation

A pageable asynchronous sequence of Reservation resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
// Make the request
PagedAsyncEnumerable<ListReservationsResponse, Reservation> response = reservationServiceClient.ListReservationsAsync(parent);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Reservation item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListReservationsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Reservation item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Reservation> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Reservation item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

MergeCapacityCommitments(LocationName, IEnumerable<string>, CallSettings)

public virtual CapacityCommitment MergeCapacityCommitments(LocationName parent, IEnumerable<string> capacityCommitmentIds, CallSettings callSettings = null)

Merges capacity commitments of the same plan into a single commitment.

The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments.

Attempting to merge capacity commitments of different plan will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
parent LocationName

Parent resource that identifies admin project and location e.g., projects/myproject/locations/us

capacityCommitmentIds IEnumerablestring

Ids of capacity commitments to merge. These capacity commitments must exist under admin project and location specified in the parent. ID is the last portion of capacity commitment name e.g., 'abc' for projects/myproject/locations/US/capacityCommitments/abc

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
CapacityCommitment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
IEnumerable<string> capacityCommitmentIds = new string[] { "", };
// Make the request
CapacityCommitment response = reservationServiceClient.MergeCapacityCommitments(parent, capacityCommitmentIds);

MergeCapacityCommitments(MergeCapacityCommitmentsRequest, CallSettings)

public virtual CapacityCommitment MergeCapacityCommitments(MergeCapacityCommitmentsRequest request, CallSettings callSettings = null)

Merges capacity commitments of the same plan into a single commitment.

The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments.

Attempting to merge capacity commitments of different plan will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
request MergeCapacityCommitmentsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
CapacityCommitment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
MergeCapacityCommitmentsRequest request = new MergeCapacityCommitmentsRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    CapacityCommitmentIds = { "", },
};
// Make the request
CapacityCommitment response = reservationServiceClient.MergeCapacityCommitments(request);

MergeCapacityCommitments(string, IEnumerable<string>, CallSettings)

public virtual CapacityCommitment MergeCapacityCommitments(string parent, IEnumerable<string> capacityCommitmentIds, CallSettings callSettings = null)

Merges capacity commitments of the same plan into a single commitment.

The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments.

Attempting to merge capacity commitments of different plan will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
parent string

Parent resource that identifies admin project and location e.g., projects/myproject/locations/us

capacityCommitmentIds IEnumerablestring

Ids of capacity commitments to merge. These capacity commitments must exist under admin project and location specified in the parent. ID is the last portion of capacity commitment name e.g., 'abc' for projects/myproject/locations/US/capacityCommitments/abc

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
CapacityCommitment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
IEnumerable<string> capacityCommitmentIds = new string[] { "", };
// Make the request
CapacityCommitment response = reservationServiceClient.MergeCapacityCommitments(parent, capacityCommitmentIds);

MergeCapacityCommitmentsAsync(LocationName, IEnumerable<string>, CallSettings)

public virtual Task<CapacityCommitment> MergeCapacityCommitmentsAsync(LocationName parent, IEnumerable<string> capacityCommitmentIds, CallSettings callSettings = null)

Merges capacity commitments of the same plan into a single commitment.

The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments.

Attempting to merge capacity commitments of different plan will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
parent LocationName

Parent resource that identifies admin project and location e.g., projects/myproject/locations/us

capacityCommitmentIds IEnumerablestring

Ids of capacity commitments to merge. These capacity commitments must exist under admin project and location specified in the parent. ID is the last portion of capacity commitment name e.g., 'abc' for projects/myproject/locations/US/capacityCommitments/abc

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
IEnumerable<string> capacityCommitmentIds = new string[] { "", };
// Make the request
CapacityCommitment response = await reservationServiceClient.MergeCapacityCommitmentsAsync(parent, capacityCommitmentIds);

MergeCapacityCommitmentsAsync(LocationName, IEnumerable<string>, CancellationToken)

public virtual Task<CapacityCommitment> MergeCapacityCommitmentsAsync(LocationName parent, IEnumerable<string> capacityCommitmentIds, CancellationToken cancellationToken)

Merges capacity commitments of the same plan into a single commitment.

The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments.

Attempting to merge capacity commitments of different plan will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
parent LocationName

Parent resource that identifies admin project and location e.g., projects/myproject/locations/us

capacityCommitmentIds IEnumerablestring

Ids of capacity commitments to merge. These capacity commitments must exist under admin project and location specified in the parent. ID is the last portion of capacity commitment name e.g., 'abc' for projects/myproject/locations/US/capacityCommitments/abc

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
IEnumerable<string> capacityCommitmentIds = new string[] { "", };
// Make the request
CapacityCommitment response = await reservationServiceClient.MergeCapacityCommitmentsAsync(parent, capacityCommitmentIds);

MergeCapacityCommitmentsAsync(MergeCapacityCommitmentsRequest, CallSettings)

public virtual Task<CapacityCommitment> MergeCapacityCommitmentsAsync(MergeCapacityCommitmentsRequest request, CallSettings callSettings = null)

Merges capacity commitments of the same plan into a single commitment.

The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments.

Attempting to merge capacity commitments of different plan will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
request MergeCapacityCommitmentsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
MergeCapacityCommitmentsRequest request = new MergeCapacityCommitmentsRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    CapacityCommitmentIds = { "", },
};
// Make the request
CapacityCommitment response = await reservationServiceClient.MergeCapacityCommitmentsAsync(request);

MergeCapacityCommitmentsAsync(MergeCapacityCommitmentsRequest, CancellationToken)

public virtual Task<CapacityCommitment> MergeCapacityCommitmentsAsync(MergeCapacityCommitmentsRequest request, CancellationToken cancellationToken)

Merges capacity commitments of the same plan into a single commitment.

The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments.

Attempting to merge capacity commitments of different plan will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
request MergeCapacityCommitmentsRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
MergeCapacityCommitmentsRequest request = new MergeCapacityCommitmentsRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    CapacityCommitmentIds = { "", },
};
// Make the request
CapacityCommitment response = await reservationServiceClient.MergeCapacityCommitmentsAsync(request);

MergeCapacityCommitmentsAsync(string, IEnumerable<string>, CallSettings)

public virtual Task<CapacityCommitment> MergeCapacityCommitmentsAsync(string parent, IEnumerable<string> capacityCommitmentIds, CallSettings callSettings = null)

Merges capacity commitments of the same plan into a single commitment.

The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments.

Attempting to merge capacity commitments of different plan will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
parent string

Parent resource that identifies admin project and location e.g., projects/myproject/locations/us

capacityCommitmentIds IEnumerablestring

Ids of capacity commitments to merge. These capacity commitments must exist under admin project and location specified in the parent. ID is the last portion of capacity commitment name e.g., 'abc' for projects/myproject/locations/US/capacityCommitments/abc

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
IEnumerable<string> capacityCommitmentIds = new string[] { "", };
// Make the request
CapacityCommitment response = await reservationServiceClient.MergeCapacityCommitmentsAsync(parent, capacityCommitmentIds);

MergeCapacityCommitmentsAsync(string, IEnumerable<string>, CancellationToken)

public virtual Task<CapacityCommitment> MergeCapacityCommitmentsAsync(string parent, IEnumerable<string> capacityCommitmentIds, CancellationToken cancellationToken)

Merges capacity commitments of the same plan into a single commitment.

The resulting capacity commitment has the greater commitment_end_time out of the to-be-merged capacity commitments.

Attempting to merge capacity commitments of different plan will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
parent string

Parent resource that identifies admin project and location e.g., projects/myproject/locations/us

capacityCommitmentIds IEnumerablestring

Ids of capacity commitments to merge. These capacity commitments must exist under admin project and location specified in the parent. ID is the last portion of capacity commitment name e.g., 'abc' for projects/myproject/locations/US/capacityCommitments/abc

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
IEnumerable<string> capacityCommitmentIds = new string[] { "", };
// Make the request
CapacityCommitment response = await reservationServiceClient.MergeCapacityCommitmentsAsync(parent, capacityCommitmentIds);

MoveAssignment(AssignmentName, ReservationName, CallSettings)

public virtual Assignment MoveAssignment(AssignmentName name, ReservationName destinationId, CallSettings callSettings = null)

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.

Parameters
Name Description
name AssignmentName

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

destinationId ReservationName

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

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Assignment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
AssignmentName name = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]");
ReservationName destinationId = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
// Make the request
Assignment response = reservationServiceClient.MoveAssignment(name, destinationId);

MoveAssignment(MoveAssignmentRequest, CallSettings)

public virtual Assignment MoveAssignment(MoveAssignmentRequest request, CallSettings callSettings = null)

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.

Parameters
Name Description
request MoveAssignmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Assignment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
MoveAssignmentRequest request = new MoveAssignmentRequest
{
    AssignmentName = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]"),
    DestinationIdAsReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
    AssignmentId = "",
};
// Make the request
Assignment response = reservationServiceClient.MoveAssignment(request);

MoveAssignment(string, string, CallSettings)

public virtual Assignment MoveAssignment(string name, string destinationId, CallSettings callSettings = null)

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.

Parameters
Name Description
name string

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

destinationId string

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

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Assignment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]/assignments/[ASSIGNMENT]";
string destinationId = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
// Make the request
Assignment response = reservationServiceClient.MoveAssignment(name, destinationId);

MoveAssignmentAsync(AssignmentName, ReservationName, CallSettings)

public virtual Task<Assignment> MoveAssignmentAsync(AssignmentName name, ReservationName destinationId, CallSettings callSettings = null)

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.

Parameters
Name Description
name AssignmentName

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

destinationId ReservationName

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

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
AssignmentName name = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]");
ReservationName destinationId = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
// Make the request
Assignment response = await reservationServiceClient.MoveAssignmentAsync(name, destinationId);

MoveAssignmentAsync(AssignmentName, ReservationName, CancellationToken)

public virtual Task<Assignment> MoveAssignmentAsync(AssignmentName name, ReservationName destinationId, CancellationToken cancellationToken)

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.

Parameters
Name Description
name AssignmentName

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

destinationId ReservationName

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

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
AssignmentName name = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]");
ReservationName destinationId = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]");
// Make the request
Assignment response = await reservationServiceClient.MoveAssignmentAsync(name, destinationId);

MoveAssignmentAsync(MoveAssignmentRequest, CallSettings)

public virtual Task<Assignment> MoveAssignmentAsync(MoveAssignmentRequest request, CallSettings callSettings = null)

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.

Parameters
Name Description
request MoveAssignmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
MoveAssignmentRequest request = new MoveAssignmentRequest
{
    AssignmentName = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]"),
    DestinationIdAsReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
    AssignmentId = "",
};
// Make the request
Assignment response = await reservationServiceClient.MoveAssignmentAsync(request);

MoveAssignmentAsync(MoveAssignmentRequest, CancellationToken)

public virtual Task<Assignment> MoveAssignmentAsync(MoveAssignmentRequest request, CancellationToken cancellationToken)

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.

Parameters
Name Description
request MoveAssignmentRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
MoveAssignmentRequest request = new MoveAssignmentRequest
{
    AssignmentName = AssignmentName.FromProjectLocationReservationAssignment("[PROJECT]", "[LOCATION]", "[RESERVATION]", "[ASSIGNMENT]"),
    DestinationIdAsReservationName = ReservationName.FromProjectLocationReservation("[PROJECT]", "[LOCATION]", "[RESERVATION]"),
    AssignmentId = "",
};
// Make the request
Assignment response = await reservationServiceClient.MoveAssignmentAsync(request);

MoveAssignmentAsync(string, string, CallSettings)

public virtual Task<Assignment> MoveAssignmentAsync(string name, string destinationId, CallSettings callSettings = null)

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.

Parameters
Name Description
name string

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

destinationId string

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

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]/assignments/[ASSIGNMENT]";
string destinationId = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
// Make the request
Assignment response = await reservationServiceClient.MoveAssignmentAsync(name, destinationId);

MoveAssignmentAsync(string, string, CancellationToken)

public virtual Task<Assignment> MoveAssignmentAsync(string name, string destinationId, CancellationToken cancellationToken)

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.

Parameters
Name Description
name string

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

destinationId string

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

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]/assignments/[ASSIGNMENT]";
string destinationId = "projects/[PROJECT]/locations/[LOCATION]/reservations/[RESERVATION]";
// Make the request
Assignment response = await reservationServiceClient.MoveAssignmentAsync(name, destinationId);

SearchAllAssignments(LocationName, string, string, int?, CallSettings)

public virtual PagedEnumerable<SearchAllAssignmentsResponse, Assignment> SearchAllAssignments(LocationName parent, string query, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.
Parameters
Name Description
parent LocationName

Required. The resource name with location (project name could be the wildcard '-'), e.g.: projects/-/locations/US.

query string

Please specify resource name as assignee in the query.

Examples:

  • assignee=projects/myproject
  • assignee=folders/123
  • assignee=organizations/456
pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableSearchAllAssignmentsResponseAssignment

A pageable sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
string query = "";
// Make the request
PagedEnumerable<SearchAllAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAllAssignments(parent, query);

// Iterate over all response items, lazily performing RPCs as required
foreach (Assignment item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (SearchAllAssignmentsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

SearchAllAssignments(SearchAllAssignmentsRequest, CallSettings)

public virtual PagedEnumerable<SearchAllAssignmentsResponse, Assignment> SearchAllAssignments(SearchAllAssignmentsRequest request, CallSettings callSettings = null)

Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.
Parameters
Name Description
request SearchAllAssignmentsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableSearchAllAssignmentsResponseAssignment

A pageable sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
SearchAllAssignmentsRequest request = new SearchAllAssignmentsRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    Query = "",
};
// Make the request
PagedEnumerable<SearchAllAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAllAssignments(request);

// Iterate over all response items, lazily performing RPCs as required
foreach (Assignment item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (SearchAllAssignmentsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

SearchAllAssignments(string, string, string, int?, CallSettings)

public virtual PagedEnumerable<SearchAllAssignmentsResponse, Assignment> SearchAllAssignments(string parent, string query, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.
Parameters
Name Description
parent string

Required. The resource name with location (project name could be the wildcard '-'), e.g.: projects/-/locations/US.

query string

Please specify resource name as assignee in the query.

Examples:

  • assignee=projects/myproject
  • assignee=folders/123
  • assignee=organizations/456
pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableSearchAllAssignmentsResponseAssignment

A pageable sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
string query = "";
// Make the request
PagedEnumerable<SearchAllAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAllAssignments(parent, query);

// Iterate over all response items, lazily performing RPCs as required
foreach (Assignment item in response)
{
    // Do something with each item
    Console.WriteLine(item);
}

// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (SearchAllAssignmentsResponse page in response.AsRawResponses())
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
}

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

SearchAllAssignmentsAsync(LocationName, string, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<SearchAllAssignmentsResponse, Assignment> SearchAllAssignmentsAsync(LocationName parent, string query, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.
Parameters
Name Description
parent LocationName

Required. The resource name with location (project name could be the wildcard '-'), e.g.: projects/-/locations/US.

query string

Please specify resource name as assignee in the query.

Examples:

  • assignee=projects/myproject
  • assignee=folders/123
  • assignee=organizations/456
pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableSearchAllAssignmentsResponseAssignment

A pageable asynchronous sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
string query = "";
// Make the request
PagedAsyncEnumerable<SearchAllAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAllAssignmentsAsync(parent, query);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Assignment item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((SearchAllAssignmentsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

SearchAllAssignmentsAsync(SearchAllAssignmentsRequest, CallSettings)

public virtual PagedAsyncEnumerable<SearchAllAssignmentsResponse, Assignment> SearchAllAssignmentsAsync(SearchAllAssignmentsRequest request, CallSettings callSettings = null)

Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.
Parameters
Name Description
request SearchAllAssignmentsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableSearchAllAssignmentsResponseAssignment

A pageable asynchronous sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
SearchAllAssignmentsRequest request = new SearchAllAssignmentsRequest
{
    ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
    Query = "",
};
// Make the request
PagedAsyncEnumerable<SearchAllAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAllAssignmentsAsync(request);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Assignment item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((SearchAllAssignmentsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

SearchAllAssignmentsAsync(string, string, string, int?, CallSettings)

public virtual PagedAsyncEnumerable<SearchAllAssignmentsResponse, Assignment> SearchAllAssignmentsAsync(string parent, string query, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.
Parameters
Name Description
parent string

Required. The resource name with location (project name could be the wildcard '-'), e.g.: projects/-/locations/US.

query string

Please specify resource name as assignee in the query.

Examples:

  • assignee=projects/myproject
  • assignee=folders/123
  • assignee=organizations/456
pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableSearchAllAssignmentsResponseAssignment

A pageable asynchronous sequence of Assignment resources.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
string query = "";
// Make the request
PagedAsyncEnumerable<SearchAllAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAllAssignmentsAsync(parent, query);

// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Assignment item) =>
{
    // Do something with each item
    Console.WriteLine(item);
});

// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((SearchAllAssignmentsResponse page) =>
{
    // Do something with each page of items
    Console.WriteLine("A page of results:");
    foreach (Assignment item in page)
    {
        // Do something with each item
        Console.WriteLine(item);
    }
});

// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page<Assignment> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Assignment item in singlePage)
{
    // Do something with each item
    Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;

SearchAssignments(LocationName, string, string, int?, CallSettings)

[Obsolete]
public virtual PagedEnumerable<SearchAssignmentsResponse, Assignment> SearchAssignments(LocationName parent, string query, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Deprecated: Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
parent LocationName

Required. The resource name of the admin project(containing project and location), e.g.: projects/myproject/locations/US.

query string

Please specify resource name as assignee in the query.

Examples:

  • assignee=projects/myproject
  • assignee=folders/123
  • assignee=organizations/456
pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableSearchAssignmentsResponseAssignment

A pageable sequence of Assignment resources.

Example
            // Create client
            ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
            // Initialize request argument(s)
            LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
            string query = "";
            // Make the request
#pragma warning disable CS0612
            PagedEnumerable<SearchAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAssignments(parent, query);
#pragma warning restore CS0612

            // Iterate over all response items, lazily performing RPCs as required
            foreach (Assignment item in response)
            {
                // Do something with each item
                Console.WriteLine(item);
            }

            // Or iterate over pages (of server-defined size), performing one RPC per page
            foreach (SearchAssignmentsResponse page in response.AsRawResponses())
            {
                // Do something with each page of items
                Console.WriteLine("A page of results:");
                foreach (Assignment item in page)
                {
                    // Do something with each item
                    Console.WriteLine(item);
                }
            }

            // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
            int pageSize = 10;
            Page<Assignment> singlePage = response.ReadPage(pageSize);
            // Do something with the page of items
            Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
            foreach (Assignment item in singlePage)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
            // Store the pageToken, for when the next page is required.
            string nextPageToken = singlePage.NextPageToken;

SearchAssignments(SearchAssignmentsRequest, CallSettings)

[Obsolete]
public virtual PagedEnumerable<SearchAssignmentsResponse, Assignment> SearchAssignments(SearchAssignmentsRequest request, CallSettings callSettings = null)

Deprecated: Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
request SearchAssignmentsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableSearchAssignmentsResponseAssignment

A pageable sequence of Assignment resources.

Example
            // Create client
            ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
            // Initialize request argument(s)
            SearchAssignmentsRequest request = new SearchAssignmentsRequest
            {
                ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
                Query = "",
            };
            // Make the request
#pragma warning disable CS0612
            PagedEnumerable<SearchAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAssignments(request);
#pragma warning restore CS0612

            // Iterate over all response items, lazily performing RPCs as required
            foreach (Assignment item in response)
            {
                // Do something with each item
                Console.WriteLine(item);
            }

            // Or iterate over pages (of server-defined size), performing one RPC per page
            foreach (SearchAssignmentsResponse page in response.AsRawResponses())
            {
                // Do something with each page of items
                Console.WriteLine("A page of results:");
                foreach (Assignment item in page)
                {
                    // Do something with each item
                    Console.WriteLine(item);
                }
            }

            // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
            int pageSize = 10;
            Page<Assignment> singlePage = response.ReadPage(pageSize);
            // Do something with the page of items
            Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
            foreach (Assignment item in singlePage)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
            // Store the pageToken, for when the next page is required.
            string nextPageToken = singlePage.NextPageToken;

SearchAssignments(string, string, string, int?, CallSettings)

[Obsolete]
public virtual PagedEnumerable<SearchAssignmentsResponse, Assignment> SearchAssignments(string parent, string query, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Deprecated: Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
parent string

Required. The resource name of the admin project(containing project and location), e.g.: projects/myproject/locations/US.

query string

Please specify resource name as assignee in the query.

Examples:

  • assignee=projects/myproject
  • assignee=folders/123
  • assignee=organizations/456
pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableSearchAssignmentsResponseAssignment

A pageable sequence of Assignment resources.

Example
            // Create client
            ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
            // Initialize request argument(s)
            string parent = "projects/[PROJECT]/locations/[LOCATION]";
            string query = "";
            // Make the request
#pragma warning disable CS0612
            PagedEnumerable<SearchAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAssignments(parent, query);
#pragma warning restore CS0612

            // Iterate over all response items, lazily performing RPCs as required
            foreach (Assignment item in response)
            {
                // Do something with each item
                Console.WriteLine(item);
            }

            // Or iterate over pages (of server-defined size), performing one RPC per page
            foreach (SearchAssignmentsResponse page in response.AsRawResponses())
            {
                // Do something with each page of items
                Console.WriteLine("A page of results:");
                foreach (Assignment item in page)
                {
                    // Do something with each item
                    Console.WriteLine(item);
                }
            }

            // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
            int pageSize = 10;
            Page<Assignment> singlePage = response.ReadPage(pageSize);
            // Do something with the page of items
            Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
            foreach (Assignment item in singlePage)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
            // Store the pageToken, for when the next page is required.
            string nextPageToken = singlePage.NextPageToken;

SearchAssignmentsAsync(LocationName, string, string, int?, CallSettings)

[Obsolete]
public virtual PagedAsyncEnumerable<SearchAssignmentsResponse, Assignment> SearchAssignmentsAsync(LocationName parent, string query, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Deprecated: Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
parent LocationName

Required. The resource name of the admin project(containing project and location), e.g.: projects/myproject/locations/US.

query string

Please specify resource name as assignee in the query.

Examples:

  • assignee=projects/myproject
  • assignee=folders/123
  • assignee=organizations/456
pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableSearchAssignmentsResponseAssignment

A pageable asynchronous sequence of Assignment resources.

Example
            // Create client
            ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
            // Initialize request argument(s)
            LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
            string query = "";
            // Make the request
#pragma warning disable CS0612
            PagedAsyncEnumerable<SearchAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAssignmentsAsync(parent, query);
#pragma warning restore CS0612

            // Iterate over all response items, lazily performing RPCs as required
            await response.ForEachAsync((Assignment item) =>
            {
                // Do something with each item
                Console.WriteLine(item);
            });

            // Or iterate over pages (of server-defined size), performing one RPC per page
            await response.AsRawResponses().ForEachAsync((SearchAssignmentsResponse page) =>
            {
                // Do something with each page of items
                Console.WriteLine("A page of results:");
                foreach (Assignment item in page)
                {
                    // Do something with each item
                    Console.WriteLine(item);
                }
            });

            // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
            int pageSize = 10;
            Page<Assignment> singlePage = await response.ReadPageAsync(pageSize);
            // Do something with the page of items
            Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
            foreach (Assignment item in singlePage)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
            // Store the pageToken, for when the next page is required.
            string nextPageToken = singlePage.NextPageToken;

SearchAssignmentsAsync(SearchAssignmentsRequest, CallSettings)

[Obsolete]
public virtual PagedAsyncEnumerable<SearchAssignmentsResponse, Assignment> SearchAssignmentsAsync(SearchAssignmentsRequest request, CallSettings callSettings = null)

Deprecated: Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
request SearchAssignmentsRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableSearchAssignmentsResponseAssignment

A pageable asynchronous sequence of Assignment resources.

Example
            // Create client
            ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
            // Initialize request argument(s)
            SearchAssignmentsRequest request = new SearchAssignmentsRequest
            {
                ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
                Query = "",
            };
            // Make the request
#pragma warning disable CS0612
            PagedAsyncEnumerable<SearchAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAssignmentsAsync(request);
#pragma warning restore CS0612

            // Iterate over all response items, lazily performing RPCs as required
            await response.ForEachAsync((Assignment item) =>
            {
                // Do something with each item
                Console.WriteLine(item);
            });

            // Or iterate over pages (of server-defined size), performing one RPC per page
            await response.AsRawResponses().ForEachAsync((SearchAssignmentsResponse page) =>
            {
                // Do something with each page of items
                Console.WriteLine("A page of results:");
                foreach (Assignment item in page)
                {
                    // Do something with each item
                    Console.WriteLine(item);
                }
            });

            // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
            int pageSize = 10;
            Page<Assignment> singlePage = await response.ReadPageAsync(pageSize);
            // Do something with the page of items
            Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
            foreach (Assignment item in singlePage)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
            // Store the pageToken, for when the next page is required.
            string nextPageToken = singlePage.NextPageToken;

SearchAssignmentsAsync(string, string, string, int?, CallSettings)

[Obsolete]
public virtual PagedAsyncEnumerable<SearchAssignmentsResponse, Assignment> SearchAssignmentsAsync(string parent, string query, string pageToken = null, int? pageSize = null, CallSettings callSettings = null)

Deprecated: Looks up assignments for a specified resource for a particular region. If the request is about a project:

  1. Assignments created on the project will be returned if they exist.
  2. Otherwise assignments created on the closest ancestor will be returned.
  3. Assignments for different JobTypes will all be returned.

The same logic applies if the request is about a folder.

If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors).

Comparing to ListAssignments, there are some behavior differences:

  1. permission on the assignee will be verified in this API.
  2. Hierarchy lookup (project->folder->organization) happens in this API.
  3. Parent here is projects/*/locations/*, instead of projects/*/locations/*reservations/*.

Note "-" cannot be used for projects nor locations.

Parameters
Name Description
parent string

Required. The resource name of the admin project(containing project and location), e.g.: projects/myproject/locations/US.

query string

Please specify resource name as assignee in the query.

Examples:

  • assignee=projects/myproject
  • assignee=folders/123
  • assignee=organizations/456
pageToken string

The token returned from the previous request. A value of null or an empty string retrieves the first page.

pageSize int

The size of page to request. The response will not be larger than this, but may be smaller. A value of null or 0 uses a server-defined page size.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableSearchAssignmentsResponseAssignment

A pageable asynchronous sequence of Assignment resources.

Example
            // Create client
            ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
            // Initialize request argument(s)
            string parent = "projects/[PROJECT]/locations/[LOCATION]";
            string query = "";
            // Make the request
#pragma warning disable CS0612
            PagedAsyncEnumerable<SearchAssignmentsResponse, Assignment> response = reservationServiceClient.SearchAssignmentsAsync(parent, query);
#pragma warning restore CS0612

            // Iterate over all response items, lazily performing RPCs as required
            await response.ForEachAsync((Assignment item) =>
            {
                // Do something with each item
                Console.WriteLine(item);
            });

            // Or iterate over pages (of server-defined size), performing one RPC per page
            await response.AsRawResponses().ForEachAsync((SearchAssignmentsResponse page) =>
            {
                // Do something with each page of items
                Console.WriteLine("A page of results:");
                foreach (Assignment item in page)
                {
                    // Do something with each item
                    Console.WriteLine(item);
                }
            });

            // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
            int pageSize = 10;
            Page<Assignment> singlePage = await response.ReadPageAsync(pageSize);
            // Do something with the page of items
            Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
            foreach (Assignment item in singlePage)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
            // Store the pageToken, for when the next page is required.
            string nextPageToken = singlePage.NextPageToken;

ShutdownDefaultChannelsAsync()

public static Task ShutdownDefaultChannelsAsync()

Shuts down any channels automatically created by Create() and CreateAsync(CancellationToken). Channels which weren't automatically created are not affected.

Returns
Type Description
Task

A task representing the asynchronous shutdown operation.

Remarks

After calling this method, further calls to Create() and CreateAsync(CancellationToken) will create new channels, which could in turn be shut down by another call to this method.

SplitCapacityCommitment(CapacityCommitmentName, long, CallSettings)

public virtual SplitCapacityCommitmentResponse SplitCapacityCommitment(CapacityCommitmentName name, long slotCount, CallSettings callSettings = null)

Splits capacity commitment to two commitments of the same plan and commitment_end_time.

A common use case is to enable downgrading commitments.

For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you delete the first one after the commitment end time passes.

Parameters
Name Description
name CapacityCommitmentName

Required. The resource name e.g.,: projects/myproject/locations/US/capacityCommitments/123

slotCount long

Number of slots in the capacity commitment after the split.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
SplitCapacityCommitmentResponse

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
CapacityCommitmentName name = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]");
long slotCount = 0L;
// Make the request
SplitCapacityCommitmentResponse response = reservationServiceClient.SplitCapacityCommitment(name, slotCount);

SplitCapacityCommitment(SplitCapacityCommitmentRequest, CallSettings)

public virtual SplitCapacityCommitmentResponse SplitCapacityCommitment(SplitCapacityCommitmentRequest request, CallSettings callSettings = null)

Splits capacity commitment to two commitments of the same plan and commitment_end_time.

A common use case is to enable downgrading commitments.

For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you delete the first one after the commitment end time passes.

Parameters
Name Description
request SplitCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
SplitCapacityCommitmentResponse

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
SplitCapacityCommitmentRequest request = new SplitCapacityCommitmentRequest
{
    CapacityCommitmentName = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]"),
    SlotCount = 0L,
};
// Make the request
SplitCapacityCommitmentResponse response = reservationServiceClient.SplitCapacityCommitment(request);

SplitCapacityCommitment(string, long, CallSettings)

public virtual SplitCapacityCommitmentResponse SplitCapacityCommitment(string name, long slotCount, CallSettings callSettings = null)

Splits capacity commitment to two commitments of the same plan and commitment_end_time.

A common use case is to enable downgrading commitments.

For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you delete the first one after the commitment end time passes.

Parameters
Name Description
name string

Required. The resource name e.g.,: projects/myproject/locations/US/capacityCommitments/123

slotCount long

Number of slots in the capacity commitment after the split.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
SplitCapacityCommitmentResponse

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/capacityCommitments/[CAPACITY_COMMITMENT]";
long slotCount = 0L;
// Make the request
SplitCapacityCommitmentResponse response = reservationServiceClient.SplitCapacityCommitment(name, slotCount);

SplitCapacityCommitmentAsync(CapacityCommitmentName, long, CallSettings)

public virtual Task<SplitCapacityCommitmentResponse> SplitCapacityCommitmentAsync(CapacityCommitmentName name, long slotCount, CallSettings callSettings = null)

Splits capacity commitment to two commitments of the same plan and commitment_end_time.

A common use case is to enable downgrading commitments.

For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you delete the first one after the commitment end time passes.

Parameters
Name Description
name CapacityCommitmentName

Required. The resource name e.g.,: projects/myproject/locations/US/capacityCommitments/123

slotCount long

Number of slots in the capacity commitment after the split.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskSplitCapacityCommitmentResponse

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CapacityCommitmentName name = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]");
long slotCount = 0L;
// Make the request
SplitCapacityCommitmentResponse response = await reservationServiceClient.SplitCapacityCommitmentAsync(name, slotCount);

SplitCapacityCommitmentAsync(CapacityCommitmentName, long, CancellationToken)

public virtual Task<SplitCapacityCommitmentResponse> SplitCapacityCommitmentAsync(CapacityCommitmentName name, long slotCount, CancellationToken cancellationToken)

Splits capacity commitment to two commitments of the same plan and commitment_end_time.

A common use case is to enable downgrading commitments.

For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you delete the first one after the commitment end time passes.

Parameters
Name Description
name CapacityCommitmentName

Required. The resource name e.g.,: projects/myproject/locations/US/capacityCommitments/123

slotCount long

Number of slots in the capacity commitment after the split.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskSplitCapacityCommitmentResponse

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CapacityCommitmentName name = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]");
long slotCount = 0L;
// Make the request
SplitCapacityCommitmentResponse response = await reservationServiceClient.SplitCapacityCommitmentAsync(name, slotCount);

SplitCapacityCommitmentAsync(SplitCapacityCommitmentRequest, CallSettings)

public virtual Task<SplitCapacityCommitmentResponse> SplitCapacityCommitmentAsync(SplitCapacityCommitmentRequest request, CallSettings callSettings = null)

Splits capacity commitment to two commitments of the same plan and commitment_end_time.

A common use case is to enable downgrading commitments.

For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you delete the first one after the commitment end time passes.

Parameters
Name Description
request SplitCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskSplitCapacityCommitmentResponse

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
SplitCapacityCommitmentRequest request = new SplitCapacityCommitmentRequest
{
    CapacityCommitmentName = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]"),
    SlotCount = 0L,
};
// Make the request
SplitCapacityCommitmentResponse response = await reservationServiceClient.SplitCapacityCommitmentAsync(request);

SplitCapacityCommitmentAsync(SplitCapacityCommitmentRequest, CancellationToken)

public virtual Task<SplitCapacityCommitmentResponse> SplitCapacityCommitmentAsync(SplitCapacityCommitmentRequest request, CancellationToken cancellationToken)

Splits capacity commitment to two commitments of the same plan and commitment_end_time.

A common use case is to enable downgrading commitments.

For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you delete the first one after the commitment end time passes.

Parameters
Name Description
request SplitCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskSplitCapacityCommitmentResponse

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
SplitCapacityCommitmentRequest request = new SplitCapacityCommitmentRequest
{
    CapacityCommitmentName = CapacityCommitmentName.FromProjectLocationCapacityCommitment("[PROJECT]", "[LOCATION]", "[CAPACITY_COMMITMENT]"),
    SlotCount = 0L,
};
// Make the request
SplitCapacityCommitmentResponse response = await reservationServiceClient.SplitCapacityCommitmentAsync(request);

SplitCapacityCommitmentAsync(string, long, CallSettings)

public virtual Task<SplitCapacityCommitmentResponse> SplitCapacityCommitmentAsync(string name, long slotCount, CallSettings callSettings = null)

Splits capacity commitment to two commitments of the same plan and commitment_end_time.

A common use case is to enable downgrading commitments.

For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you delete the first one after the commitment end time passes.

Parameters
Name Description
name string

Required. The resource name e.g.,: projects/myproject/locations/US/capacityCommitments/123

slotCount long

Number of slots in the capacity commitment after the split.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskSplitCapacityCommitmentResponse

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/capacityCommitments/[CAPACITY_COMMITMENT]";
long slotCount = 0L;
// Make the request
SplitCapacityCommitmentResponse response = await reservationServiceClient.SplitCapacityCommitmentAsync(name, slotCount);

SplitCapacityCommitmentAsync(string, long, CancellationToken)

public virtual Task<SplitCapacityCommitmentResponse> SplitCapacityCommitmentAsync(string name, long slotCount, CancellationToken cancellationToken)

Splits capacity commitment to two commitments of the same plan and commitment_end_time.

A common use case is to enable downgrading commitments.

For example, in order to downgrade from 10000 slots to 8000, you might split a 10000 capacity commitment into commitments of 2000 and 8000. Then, you delete the first one after the commitment end time passes.

Parameters
Name Description
name string

Required. The resource name e.g.,: projects/myproject/locations/US/capacityCommitments/123

slotCount long

Number of slots in the capacity commitment after the split.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskSplitCapacityCommitmentResponse

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
string name = "projects/[PROJECT]/locations/[LOCATION]/capacityCommitments/[CAPACITY_COMMITMENT]";
long slotCount = 0L;
// Make the request
SplitCapacityCommitmentResponse response = await reservationServiceClient.SplitCapacityCommitmentAsync(name, slotCount);

UpdateAssignment(Assignment, FieldMask, CallSettings)

public virtual Assignment UpdateAssignment(Assignment assignment, FieldMask updateMask, CallSettings callSettings = null)

Updates an existing assignment.

Only the priority field can be updated.

Parameters
Name Description
assignment Assignment

Content of the assignment to update.

updateMask FieldMask

Standard field mask for the set of fields to be updated.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Assignment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
Assignment assignment = new Assignment();
FieldMask updateMask = new FieldMask();
// Make the request
Assignment response = reservationServiceClient.UpdateAssignment(assignment, updateMask);

UpdateAssignment(UpdateAssignmentRequest, CallSettings)

public virtual Assignment UpdateAssignment(UpdateAssignmentRequest request, CallSettings callSettings = null)

Updates an existing assignment.

Only the priority field can be updated.

Parameters
Name Description
request UpdateAssignmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Assignment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
UpdateAssignmentRequest request = new UpdateAssignmentRequest
{
    Assignment = new Assignment(),
    UpdateMask = new FieldMask(),
};
// Make the request
Assignment response = reservationServiceClient.UpdateAssignment(request);

UpdateAssignmentAsync(Assignment, FieldMask, CallSettings)

public virtual Task<Assignment> UpdateAssignmentAsync(Assignment assignment, FieldMask updateMask, CallSettings callSettings = null)

Updates an existing assignment.

Only the priority field can be updated.

Parameters
Name Description
assignment Assignment

Content of the assignment to update.

updateMask FieldMask

Standard field mask for the set of fields to be updated.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
Assignment assignment = new Assignment();
FieldMask updateMask = new FieldMask();
// Make the request
Assignment response = await reservationServiceClient.UpdateAssignmentAsync(assignment, updateMask);

UpdateAssignmentAsync(Assignment, FieldMask, CancellationToken)

public virtual Task<Assignment> UpdateAssignmentAsync(Assignment assignment, FieldMask updateMask, CancellationToken cancellationToken)

Updates an existing assignment.

Only the priority field can be updated.

Parameters
Name Description
assignment Assignment

Content of the assignment to update.

updateMask FieldMask

Standard field mask for the set of fields to be updated.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
Assignment assignment = new Assignment();
FieldMask updateMask = new FieldMask();
// Make the request
Assignment response = await reservationServiceClient.UpdateAssignmentAsync(assignment, updateMask);

UpdateAssignmentAsync(UpdateAssignmentRequest, CallSettings)

public virtual Task<Assignment> UpdateAssignmentAsync(UpdateAssignmentRequest request, CallSettings callSettings = null)

Updates an existing assignment.

Only the priority field can be updated.

Parameters
Name Description
request UpdateAssignmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
UpdateAssignmentRequest request = new UpdateAssignmentRequest
{
    Assignment = new Assignment(),
    UpdateMask = new FieldMask(),
};
// Make the request
Assignment response = await reservationServiceClient.UpdateAssignmentAsync(request);

UpdateAssignmentAsync(UpdateAssignmentRequest, CancellationToken)

public virtual Task<Assignment> UpdateAssignmentAsync(UpdateAssignmentRequest request, CancellationToken cancellationToken)

Updates an existing assignment.

Only the priority field can be updated.

Parameters
Name Description
request UpdateAssignmentRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskAssignment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
UpdateAssignmentRequest request = new UpdateAssignmentRequest
{
    Assignment = new Assignment(),
    UpdateMask = new FieldMask(),
};
// Make the request
Assignment response = await reservationServiceClient.UpdateAssignmentAsync(request);

UpdateBiReservation(BiReservation, FieldMask, CallSettings)

public virtual BiReservation UpdateBiReservation(BiReservation biReservation, FieldMask updateMask, CallSettings callSettings = null)

Updates a BI reservation.

Only fields specified in the field_mask are updated.

A singleton BI reservation always exists with default size 0. In order to reserve BI capacity it needs to be updated to an amount greater than 0. In order to release BI capacity reservation size must be set to 0.

Parameters
Name Description
biReservation BiReservation

A reservation to update.

updateMask FieldMask

A list of fields to be updated in this request.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
BiReservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
BiReservation biReservation = new BiReservation();
FieldMask updateMask = new FieldMask();
// Make the request
BiReservation response = reservationServiceClient.UpdateBiReservation(biReservation, updateMask);

UpdateBiReservation(UpdateBiReservationRequest, CallSettings)

public virtual BiReservation UpdateBiReservation(UpdateBiReservationRequest request, CallSettings callSettings = null)

Updates a BI reservation.

Only fields specified in the field_mask are updated.

A singleton BI reservation always exists with default size 0. In order to reserve BI capacity it needs to be updated to an amount greater than 0. In order to release BI capacity reservation size must be set to 0.

Parameters
Name Description
request UpdateBiReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
BiReservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
UpdateBiReservationRequest request = new UpdateBiReservationRequest
{
    BiReservation = new BiReservation(),
    UpdateMask = new FieldMask(),
};
// Make the request
BiReservation response = reservationServiceClient.UpdateBiReservation(request);

UpdateBiReservationAsync(BiReservation, FieldMask, CallSettings)

public virtual Task<BiReservation> UpdateBiReservationAsync(BiReservation biReservation, FieldMask updateMask, CallSettings callSettings = null)

Updates a BI reservation.

Only fields specified in the field_mask are updated.

A singleton BI reservation always exists with default size 0. In order to reserve BI capacity it needs to be updated to an amount greater than 0. In order to release BI capacity reservation size must be set to 0.

Parameters
Name Description
biReservation BiReservation

A reservation to update.

updateMask FieldMask

A list of fields to be updated in this request.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskBiReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
BiReservation biReservation = new BiReservation();
FieldMask updateMask = new FieldMask();
// Make the request
BiReservation response = await reservationServiceClient.UpdateBiReservationAsync(biReservation, updateMask);

UpdateBiReservationAsync(BiReservation, FieldMask, CancellationToken)

public virtual Task<BiReservation> UpdateBiReservationAsync(BiReservation biReservation, FieldMask updateMask, CancellationToken cancellationToken)

Updates a BI reservation.

Only fields specified in the field_mask are updated.

A singleton BI reservation always exists with default size 0. In order to reserve BI capacity it needs to be updated to an amount greater than 0. In order to release BI capacity reservation size must be set to 0.

Parameters
Name Description
biReservation BiReservation

A reservation to update.

updateMask FieldMask

A list of fields to be updated in this request.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskBiReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
BiReservation biReservation = new BiReservation();
FieldMask updateMask = new FieldMask();
// Make the request
BiReservation response = await reservationServiceClient.UpdateBiReservationAsync(biReservation, updateMask);

UpdateBiReservationAsync(UpdateBiReservationRequest, CallSettings)

public virtual Task<BiReservation> UpdateBiReservationAsync(UpdateBiReservationRequest request, CallSettings callSettings = null)

Updates a BI reservation.

Only fields specified in the field_mask are updated.

A singleton BI reservation always exists with default size 0. In order to reserve BI capacity it needs to be updated to an amount greater than 0. In order to release BI capacity reservation size must be set to 0.

Parameters
Name Description
request UpdateBiReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskBiReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
UpdateBiReservationRequest request = new UpdateBiReservationRequest
{
    BiReservation = new BiReservation(),
    UpdateMask = new FieldMask(),
};
// Make the request
BiReservation response = await reservationServiceClient.UpdateBiReservationAsync(request);

UpdateBiReservationAsync(UpdateBiReservationRequest, CancellationToken)

public virtual Task<BiReservation> UpdateBiReservationAsync(UpdateBiReservationRequest request, CancellationToken cancellationToken)

Updates a BI reservation.

Only fields specified in the field_mask are updated.

A singleton BI reservation always exists with default size 0. In order to reserve BI capacity it needs to be updated to an amount greater than 0. In order to release BI capacity reservation size must be set to 0.

Parameters
Name Description
request UpdateBiReservationRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskBiReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
UpdateBiReservationRequest request = new UpdateBiReservationRequest
{
    BiReservation = new BiReservation(),
    UpdateMask = new FieldMask(),
};
// Make the request
BiReservation response = await reservationServiceClient.UpdateBiReservationAsync(request);

UpdateCapacityCommitment(CapacityCommitment, FieldMask, CallSettings)

public virtual CapacityCommitment UpdateCapacityCommitment(CapacityCommitment capacityCommitment, FieldMask updateMask, CallSettings callSettings = null)

Updates an existing capacity commitment.

Only plan and renewal_plan fields can be updated.

Plan can only be changed to a plan of a longer commitment period. Attempting to change to a plan with shorter commitment period will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
capacityCommitment CapacityCommitment

Content of the capacity commitment to update.

updateMask FieldMask

Standard field mask for the set of fields to be updated.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
CapacityCommitment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
CapacityCommitment capacityCommitment = new CapacityCommitment();
FieldMask updateMask = new FieldMask();
// Make the request
CapacityCommitment response = reservationServiceClient.UpdateCapacityCommitment(capacityCommitment, updateMask);

UpdateCapacityCommitment(UpdateCapacityCommitmentRequest, CallSettings)

public virtual CapacityCommitment UpdateCapacityCommitment(UpdateCapacityCommitmentRequest request, CallSettings callSettings = null)

Updates an existing capacity commitment.

Only plan and renewal_plan fields can be updated.

Plan can only be changed to a plan of a longer commitment period. Attempting to change to a plan with shorter commitment period will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
request UpdateCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
CapacityCommitment

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
UpdateCapacityCommitmentRequest request = new UpdateCapacityCommitmentRequest
{
    CapacityCommitment = new CapacityCommitment(),
    UpdateMask = new FieldMask(),
};
// Make the request
CapacityCommitment response = reservationServiceClient.UpdateCapacityCommitment(request);

UpdateCapacityCommitmentAsync(CapacityCommitment, FieldMask, CallSettings)

public virtual Task<CapacityCommitment> UpdateCapacityCommitmentAsync(CapacityCommitment capacityCommitment, FieldMask updateMask, CallSettings callSettings = null)

Updates an existing capacity commitment.

Only plan and renewal_plan fields can be updated.

Plan can only be changed to a plan of a longer commitment period. Attempting to change to a plan with shorter commitment period will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
capacityCommitment CapacityCommitment

Content of the capacity commitment to update.

updateMask FieldMask

Standard field mask for the set of fields to be updated.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CapacityCommitment capacityCommitment = new CapacityCommitment();
FieldMask updateMask = new FieldMask();
// Make the request
CapacityCommitment response = await reservationServiceClient.UpdateCapacityCommitmentAsync(capacityCommitment, updateMask);

UpdateCapacityCommitmentAsync(CapacityCommitment, FieldMask, CancellationToken)

public virtual Task<CapacityCommitment> UpdateCapacityCommitmentAsync(CapacityCommitment capacityCommitment, FieldMask updateMask, CancellationToken cancellationToken)

Updates an existing capacity commitment.

Only plan and renewal_plan fields can be updated.

Plan can only be changed to a plan of a longer commitment period. Attempting to change to a plan with shorter commitment period will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
capacityCommitment CapacityCommitment

Content of the capacity commitment to update.

updateMask FieldMask

Standard field mask for the set of fields to be updated.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
CapacityCommitment capacityCommitment = new CapacityCommitment();
FieldMask updateMask = new FieldMask();
// Make the request
CapacityCommitment response = await reservationServiceClient.UpdateCapacityCommitmentAsync(capacityCommitment, updateMask);

UpdateCapacityCommitmentAsync(UpdateCapacityCommitmentRequest, CallSettings)

public virtual Task<CapacityCommitment> UpdateCapacityCommitmentAsync(UpdateCapacityCommitmentRequest request, CallSettings callSettings = null)

Updates an existing capacity commitment.

Only plan and renewal_plan fields can be updated.

Plan can only be changed to a plan of a longer commitment period. Attempting to change to a plan with shorter commitment period will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
request UpdateCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
UpdateCapacityCommitmentRequest request = new UpdateCapacityCommitmentRequest
{
    CapacityCommitment = new CapacityCommitment(),
    UpdateMask = new FieldMask(),
};
// Make the request
CapacityCommitment response = await reservationServiceClient.UpdateCapacityCommitmentAsync(request);

UpdateCapacityCommitmentAsync(UpdateCapacityCommitmentRequest, CancellationToken)

public virtual Task<CapacityCommitment> UpdateCapacityCommitmentAsync(UpdateCapacityCommitmentRequest request, CancellationToken cancellationToken)

Updates an existing capacity commitment.

Only plan and renewal_plan fields can be updated.

Plan can only be changed to a plan of a longer commitment period. Attempting to change to a plan with shorter commitment period will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

Parameters
Name Description
request UpdateCapacityCommitmentRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskCapacityCommitment

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
UpdateCapacityCommitmentRequest request = new UpdateCapacityCommitmentRequest
{
    CapacityCommitment = new CapacityCommitment(),
    UpdateMask = new FieldMask(),
};
// Make the request
CapacityCommitment response = await reservationServiceClient.UpdateCapacityCommitmentAsync(request);

UpdateReservation(Reservation, FieldMask, CallSettings)

public virtual Reservation UpdateReservation(Reservation reservation, FieldMask updateMask, CallSettings callSettings = null)

Updates an existing reservation resource.

Parameters
Name Description
reservation Reservation

Content of the reservation to update.

updateMask FieldMask

Standard field mask for the set of fields to be updated.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Reservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
Reservation reservation = new Reservation();
FieldMask updateMask = new FieldMask();
// Make the request
Reservation response = reservationServiceClient.UpdateReservation(reservation, updateMask);

UpdateReservation(UpdateReservationRequest, CallSettings)

public virtual Reservation UpdateReservation(UpdateReservationRequest request, CallSettings callSettings = null)

Updates an existing reservation resource.

Parameters
Name Description
request UpdateReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Reservation

The RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = ReservationServiceClient.Create();
// Initialize request argument(s)
UpdateReservationRequest request = new UpdateReservationRequest
{
    Reservation = new Reservation(),
    UpdateMask = new FieldMask(),
};
// Make the request
Reservation response = reservationServiceClient.UpdateReservation(request);

UpdateReservationAsync(Reservation, FieldMask, CallSettings)

public virtual Task<Reservation> UpdateReservationAsync(Reservation reservation, FieldMask updateMask, CallSettings callSettings = null)

Updates an existing reservation resource.

Parameters
Name Description
reservation Reservation

Content of the reservation to update.

updateMask FieldMask

Standard field mask for the set of fields to be updated.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
Reservation reservation = new Reservation();
FieldMask updateMask = new FieldMask();
// Make the request
Reservation response = await reservationServiceClient.UpdateReservationAsync(reservation, updateMask);

UpdateReservationAsync(Reservation, FieldMask, CancellationToken)

public virtual Task<Reservation> UpdateReservationAsync(Reservation reservation, FieldMask updateMask, CancellationToken cancellationToken)

Updates an existing reservation resource.

Parameters
Name Description
reservation Reservation

Content of the reservation to update.

updateMask FieldMask

Standard field mask for the set of fields to be updated.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
Reservation reservation = new Reservation();
FieldMask updateMask = new FieldMask();
// Make the request
Reservation response = await reservationServiceClient.UpdateReservationAsync(reservation, updateMask);

UpdateReservationAsync(UpdateReservationRequest, CallSettings)

public virtual Task<Reservation> UpdateReservationAsync(UpdateReservationRequest request, CallSettings callSettings = null)

Updates an existing reservation resource.

Parameters
Name Description
request UpdateReservationRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
UpdateReservationRequest request = new UpdateReservationRequest
{
    Reservation = new Reservation(),
    UpdateMask = new FieldMask(),
};
// Make the request
Reservation response = await reservationServiceClient.UpdateReservationAsync(request);

UpdateReservationAsync(UpdateReservationRequest, CancellationToken)

public virtual Task<Reservation> UpdateReservationAsync(UpdateReservationRequest request, CancellationToken cancellationToken)

Updates an existing reservation resource.

Parameters
Name Description
request UpdateReservationRequest

The request object containing all of the parameters for the API call.

cancellationToken CancellationToken

A CancellationToken to use for this RPC.

Returns
Type Description
TaskReservation

A Task containing the RPC response.

Example
// Create client
ReservationServiceClient reservationServiceClient = await ReservationServiceClient.CreateAsync();
// Initialize request argument(s)
UpdateReservationRequest request = new UpdateReservationRequest
{
    Reservation = new Reservation(),
    UpdateMask = new FieldMask(),
};
// Make the request
Reservation response = await reservationServiceClient.UpdateReservationAsync(request);