snippet_metadata.google.cloud.bigquery.reservation.v1.json

{
  "clientLibrary": {
    "name": "cloud.google.com/go/bigquery/reservation/apiv1",
    "version": "1.55.0",
    "language": "GO",
    "apis": [
      {
        "id": "google.cloud.bigquery.reservation.v1",
        "version": "v1"
      }
    ]
  },
  "snippets": [
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_CreateAssignment_sync",
      "title": "bigqueryreservation CreateAssignment Sample",
      "description": "CreateAssignment creates an assignment object which allows the given project to submit jobs\nof a certain type using slots from the specified reservation.\n\nCurrently a\nresource (project, folder, organization) can only have one assignment per\neach (job_type, location) combination, and that reservation will be used\nfor all jobs of the matching type.\n\nDifferent assignments can be created on different levels of the\nprojects, folders or organization hierarchy.  During query execution,\nthe assignment is looked up at the project, folder and organization levels\nin that order. The first assignment found is applied to the query.\n\nWhen creating assignments, it does not matter if other assignments exist at\nhigher levels.\n\nExample: \n\n* The organization `organizationA` contains two projects, `project1`\nand `project2`.\n* Assignments for all three entities (`organizationA`, `project1`, and\n`project2`) could all be created and mapped to the same or different\nreservations.\n\n\"None\" assignments represent an absence of the assignment. Projects\nassigned to None use on-demand pricing. To create a \"None\" assignment, use\n\"none\" as a reservation_id in the parent. Example parent: \n`projects/myproject/locations/US/reservations/none`.\n\nReturns `google.rpc.Code.PERMISSION_DENIED` if user does not have\n'bigquery.admin' permissions on the project using the reservation\nand the project that owns this reservation.\n\nReturns `google.rpc.Code.INVALID_ARGUMENT` when location of the assignment\ndoes not match location of the reservation.",
      "file": "Client/CreateAssignment/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "CreateAssignment",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.CreateAssignment",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.CreateAssignmentRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.Assignment",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "CreateAssignment",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.CreateAssignment",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_CreateCapacityCommitment_sync",
      "title": "bigqueryreservation CreateCapacityCommitment Sample",
      "description": "CreateCapacityCommitment creates a new capacity commitment resource.",
      "file": "Client/CreateCapacityCommitment/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "CreateCapacityCommitment",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.CreateCapacityCommitment",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.CreateCapacityCommitmentRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.CapacityCommitment",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "CreateCapacityCommitment",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.CreateCapacityCommitment",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_CreateReservation_sync",
      "title": "bigqueryreservation CreateReservation Sample",
      "description": "CreateReservation creates a new reservation resource.",
      "file": "Client/CreateReservation/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "CreateReservation",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.CreateReservation",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.CreateReservationRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.Reservation",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "CreateReservation",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.CreateReservation",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_DeleteAssignment_sync",
      "title": "bigqueryreservation DeleteAssignment Sample",
      "description": "DeleteAssignment deletes a assignment. No expansion will happen.\n\nExample: \n\n* Organization `organizationA` contains two projects, `project1` and\n`project2`.\n* Reservation `res1` exists and was created previously.\n* CreateAssignment was used previously to define the following\nassociations between entities and reservations: `<organizationA, res1>`\nand `<project1, res1>`\n\nIn this example, deletion of the `<organizationA, res1>` assignment won't\naffect the other assignment `<project1, res1>`. After said deletion,\nqueries from `project1` will still use `res1` while queries from\n`project2` will switch to use on-demand mode.",
      "file": "Client/DeleteAssignment/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "DeleteAssignment",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.DeleteAssignment",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.DeleteAssignmentRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "DeleteAssignment",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.DeleteAssignment",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 51,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_DeleteCapacityCommitment_sync",
      "title": "bigqueryreservation DeleteCapacityCommitment Sample",
      "description": "DeleteCapacityCommitment deletes a capacity commitment. Attempting to delete capacity commitment\nbefore its commitment_end_time will fail with the error code\n`google.rpc.Code.FAILED_PRECONDITION`.",
      "file": "Client/DeleteCapacityCommitment/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "DeleteCapacityCommitment",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.DeleteCapacityCommitment",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.DeleteCapacityCommitmentRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "DeleteCapacityCommitment",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.DeleteCapacityCommitment",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 51,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_DeleteReservation_sync",
      "title": "bigqueryreservation DeleteReservation Sample",
      "description": "DeleteReservation deletes a reservation.\nReturns `google.rpc.Code.FAILED_PRECONDITION` when reservation has\nassignments.",
      "file": "Client/DeleteReservation/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "DeleteReservation",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.DeleteReservation",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.DeleteReservationRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "DeleteReservation",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.DeleteReservation",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 51,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_GetBiReservation_sync",
      "title": "bigqueryreservation GetBiReservation Sample",
      "description": "GetBiReservation retrieves a BI reservation.",
      "file": "Client/GetBiReservation/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "GetBiReservation",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.GetBiReservation",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.GetBiReservationRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.BiReservation",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "GetBiReservation",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.GetBiReservation",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_GetCapacityCommitment_sync",
      "title": "bigqueryreservation GetCapacityCommitment Sample",
      "description": "GetCapacityCommitment returns information about the capacity commitment.",
      "file": "Client/GetCapacityCommitment/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "GetCapacityCommitment",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.GetCapacityCommitment",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.GetCapacityCommitmentRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.CapacityCommitment",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "GetCapacityCommitment",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.GetCapacityCommitment",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_GetReservation_sync",
      "title": "bigqueryreservation GetReservation Sample",
      "description": "GetReservation returns information about the reservation.",
      "file": "Client/GetReservation/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "GetReservation",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.GetReservation",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.GetReservationRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.Reservation",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "GetReservation",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.GetReservation",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_ListAssignments_sync",
      "title": "bigqueryreservation ListAssignments Sample",
      "description": "ListAssignments lists assignments.\n\nOnly explicitly created assignments will be returned.\n\nExample: \n\n* Organization `organizationA` contains two projects, `project1` and\n`project2`.\n* Reservation `res1` exists and was created previously.\n* CreateAssignment was used previously to define the following\nassociations between entities and reservations: `<organizationA, res1>`\nand `<project1, res1>`\n\nIn this example, ListAssignments will just return the above two assignments\nfor reservation `res1`, and no expansion/merge will happen.\n\nThe wildcard \"-\" can be used for\nreservations in the request. In that case all assignments belongs to the\nspecified project and location will be listed.\n\n**Note** \"-\" cannot be used for projects nor locations.",
      "file": "Client/ListAssignments/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "ListAssignments",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.ListAssignments",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.ListAssignmentsRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "AssignmentIterator",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "ListAssignments",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.ListAssignments",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 60,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_ListCapacityCommitments_sync",
      "title": "bigqueryreservation ListCapacityCommitments Sample",
      "description": "ListCapacityCommitments lists all the capacity commitments for the admin project.",
      "file": "Client/ListCapacityCommitments/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "ListCapacityCommitments",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.ListCapacityCommitments",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.ListCapacityCommitmentsRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "CapacityCommitmentIterator",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "ListCapacityCommitments",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.ListCapacityCommitments",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 60,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_ListReservations_sync",
      "title": "bigqueryreservation ListReservations Sample",
      "description": "ListReservations lists all the reservations for the project in the specified location.",
      "file": "Client/ListReservations/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "ListReservations",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.ListReservations",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.ListReservationsRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "ReservationIterator",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "ListReservations",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.ListReservations",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 60,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_MergeCapacityCommitments_sync",
      "title": "bigqueryreservation MergeCapacityCommitments Sample",
      "description": "MergeCapacityCommitments merges capacity commitments of the same plan into a single commitment.\n\nThe resulting capacity commitment has the greater commitment_end_time\nout of the to-be-merged capacity commitments.\n\nAttempting to merge capacity commitments of different plan will fail\nwith the error code `google.rpc.Code.FAILED_PRECONDITION`.",
      "file": "Client/MergeCapacityCommitments/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "MergeCapacityCommitments",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.MergeCapacityCommitments",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.MergeCapacityCommitmentsRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.CapacityCommitment",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "MergeCapacityCommitments",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.MergeCapacityCommitments",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_MoveAssignment_sync",
      "title": "bigqueryreservation MoveAssignment Sample",
      "description": "MoveAssignment moves an assignment under a new reservation.\n\nThis differs from removing an existing assignment and recreating a new one\nby providing a transactional change that ensures an assignee always has an\nassociated reservation.",
      "file": "Client/MoveAssignment/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "MoveAssignment",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.MoveAssignment",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.MoveAssignmentRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.Assignment",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "MoveAssignment",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.MoveAssignment",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_SearchAllAssignments_sync",
      "title": "bigqueryreservation SearchAllAssignments Sample",
      "description": "SearchAllAssignments looks up assignments for a specified resource for a particular region.\nIf the request is about a project: \n\n1. Assignments created on the project will be returned if they exist.\n2. Otherwise assignments created on the closest ancestor will be\nreturned.\n3. Assignments for different JobTypes will all be returned.\n\nThe same logic applies if the request is about a folder.\n\nIf the request is about an organization, then assignments created on the\norganization will be returned (organization doesn't have ancestors).\n\nComparing to ListAssignments, there are some behavior\ndifferences: \n\n1. permission on the assignee will be verified in this API.\n2. Hierarchy lookup (project->folder->organization) happens in this API.\n3. Parent here is `projects/*/locations/*`, instead of\n`projects/*/locations/*reservations/*`.",
      "file": "Client/SearchAllAssignments/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "SearchAllAssignments",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.SearchAllAssignments",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.SearchAllAssignmentsRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "AssignmentIterator",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "SearchAllAssignments",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.SearchAllAssignments",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 60,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_SearchAssignments_sync",
      "title": "bigqueryreservation SearchAssignments Sample",
      "description": "SearchAssignments deprecated: Looks up assignments for a specified resource for a particular\nregion. If the request is about a project: \n\n1. Assignments created on the project will be returned if they exist.\n2. Otherwise assignments created on the closest ancestor will be\nreturned.\n3. Assignments for different JobTypes will all be returned.\n\nThe same logic applies if the request is about a folder.\n\nIf the request is about an organization, then assignments created on the\norganization will be returned (organization doesn't have ancestors).\n\nComparing to ListAssignments, there are some behavior\ndifferences: \n\n1. permission on the assignee will be verified in this API.\n2. Hierarchy lookup (project->folder->organization) happens in this API.\n3. Parent here is `projects/*/locations/*`, instead of\n`projects/*/locations/*reservations/*`.\n\n**Note** \"-\" cannot be used for projects\nnor locations.\n\n\nDeprecated: SearchAssignments may be removed in a future version.",
      "file": "Client/SearchAssignments/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "SearchAssignments",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.SearchAssignments",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.SearchAssignmentsRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "AssignmentIterator",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "SearchAssignments",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.SearchAssignments",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 60,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_SplitCapacityCommitment_sync",
      "title": "bigqueryreservation SplitCapacityCommitment Sample",
      "description": "SplitCapacityCommitment splits capacity commitment to two commitments of the same plan and\n`commitment_end_time`.\n\nA common use case is to enable downgrading commitments.\n\nFor example, in order to downgrade from 10000 slots to 8000, you might\nsplit a 10000 capacity commitment into commitments of 2000 and 8000. Then,\nyou delete the first one after the commitment end time passes.",
      "file": "Client/SplitCapacityCommitment/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "SplitCapacityCommitment",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.SplitCapacityCommitment",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.SplitCapacityCommitmentRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.SplitCapacityCommitmentResponse",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "SplitCapacityCommitment",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.SplitCapacityCommitment",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_UpdateAssignment_sync",
      "title": "bigqueryreservation UpdateAssignment Sample",
      "description": "UpdateAssignment updates an existing assignment.\n\nOnly the `priority` field can be updated.",
      "file": "Client/UpdateAssignment/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "UpdateAssignment",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.UpdateAssignment",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.UpdateAssignmentRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.Assignment",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "UpdateAssignment",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.UpdateAssignment",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_UpdateBiReservation_sync",
      "title": "bigqueryreservation UpdateBiReservation Sample",
      "description": "UpdateBiReservation updates a BI reservation.\n\nOnly fields specified in the `field_mask` are updated.\n\nA singleton BI reservation always exists with default size 0.\nIn order to reserve BI capacity it needs to be updated to an amount\ngreater than 0. In order to release BI capacity reservation size\nmust be set to 0.",
      "file": "Client/UpdateBiReservation/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "UpdateBiReservation",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.UpdateBiReservation",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.UpdateBiReservationRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.BiReservation",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "UpdateBiReservation",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.UpdateBiReservation",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_UpdateCapacityCommitment_sync",
      "title": "bigqueryreservation UpdateCapacityCommitment Sample",
      "description": "UpdateCapacityCommitment updates an existing capacity commitment.\n\nOnly `plan` and `renewal_plan` fields can be updated.\n\nPlan can only be changed to a plan of a longer commitment period.\nAttempting to change to a plan with shorter commitment period will fail\nwith the error code `google.rpc.Code.FAILED_PRECONDITION`.",
      "file": "Client/UpdateCapacityCommitment/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "UpdateCapacityCommitment",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.UpdateCapacityCommitment",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.UpdateCapacityCommitmentRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.CapacityCommitment",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "UpdateCapacityCommitment",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.UpdateCapacityCommitment",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "bigqueryreservation_v1_generated_ReservationService_UpdateReservation_sync",
      "title": "bigqueryreservation UpdateReservation Sample",
      "description": "UpdateReservation updates an existing reservation resource.",
      "file": "Client/UpdateReservation/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "UpdateReservation",
        "fullName": "google.cloud.bigquery.reservation.v1.Client.UpdateReservation",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "reservationpb.UpdateReservationRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*reservationpb.Reservation",
        "client": {
          "shortName": "Client",
          "fullName": "google.cloud.bigquery.reservation.v1.Client"
        },
        "method": {
          "shortName": "UpdateReservation",
          "fullName": "google.cloud.bigquery.reservation.v1.ReservationService.UpdateReservation",
          "service": {
            "shortName": "ReservationService",
            "fullName": "google.cloud.bigquery.reservation.v1.ReservationService"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    }
  ]
}