google-api-client 0.39.2 → 0.39.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (81) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +36 -0
  3. data/generated/google/apis/appengine_v1.rb +1 -1
  4. data/generated/google/apis/appengine_v1/classes.rb +7 -0
  5. data/generated/google/apis/appengine_v1/representations.rb +1 -0
  6. data/generated/google/apis/appengine_v1beta.rb +1 -1
  7. data/generated/google/apis/appengine_v1beta/classes.rb +7 -0
  8. data/generated/google/apis/appengine_v1beta/representations.rb +1 -0
  9. data/generated/google/apis/bigqueryreservation_v1.rb +1 -1
  10. data/generated/google/apis/bigqueryreservation_v1/classes.rb +19 -15
  11. data/generated/google/apis/bigqueryreservation_v1/service.rb +86 -73
  12. data/generated/google/apis/bigqueryreservation_v1alpha2.rb +1 -1
  13. data/generated/google/apis/bigqueryreservation_v1beta1.rb +1 -1
  14. data/generated/google/apis/bigqueryreservation_v1beta1/classes.rb +0 -47
  15. data/generated/google/apis/bigqueryreservation_v1beta1/representations.rb +0 -16
  16. data/generated/google/apis/cloudkms_v1.rb +1 -1
  17. data/generated/google/apis/cloudkms_v1/classes.rb +26 -14
  18. data/generated/google/apis/cloudkms_v1/service.rb +15 -6
  19. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  20. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +26 -10
  21. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  22. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +26 -10
  23. data/generated/google/apis/cloudresourcemanager_v2.rb +1 -1
  24. data/generated/google/apis/cloudresourcemanager_v2/classes.rb +26 -10
  25. data/generated/google/apis/cloudresourcemanager_v2beta1.rb +1 -1
  26. data/generated/google/apis/cloudresourcemanager_v2beta1/classes.rb +26 -10
  27. data/generated/google/apis/cloudshell_v1.rb +1 -1
  28. data/generated/google/apis/cloudshell_v1alpha1.rb +1 -1
  29. data/generated/google/apis/container_v1.rb +1 -1
  30. data/generated/google/apis/container_v1/classes.rb +3 -2
  31. data/generated/google/apis/container_v1beta1.rb +1 -1
  32. data/generated/google/apis/container_v1beta1/classes.rb +3 -2
  33. data/generated/google/apis/firebasehosting_v1beta1.rb +1 -1
  34. data/generated/google/apis/firebasehosting_v1beta1/classes.rb +4 -4
  35. data/generated/google/apis/games_management_v1management.rb +6 -4
  36. data/generated/google/apis/games_management_v1management/classes.rb +50 -90
  37. data/generated/google/apis/games_management_v1management/representations.rb +0 -17
  38. data/generated/google/apis/games_management_v1management/service.rb +115 -291
  39. data/generated/google/apis/gameservices_v1beta.rb +1 -1
  40. data/generated/google/apis/gameservices_v1beta/classes.rb +73 -60
  41. data/generated/google/apis/gameservices_v1beta/service.rb +60 -57
  42. data/generated/google/apis/gmail_v1.rb +2 -3
  43. data/generated/google/apis/gmail_v1/classes.rb +199 -258
  44. data/generated/google/apis/gmail_v1/service.rb +744 -552
  45. data/generated/google/apis/healthcare_v1.rb +1 -1
  46. data/generated/google/apis/healthcare_v1/classes.rb +34 -22
  47. data/generated/google/apis/healthcare_v1/service.rb +46 -111
  48. data/generated/google/apis/healthcare_v1beta1.rb +1 -1
  49. data/generated/google/apis/healthcare_v1beta1/classes.rb +34 -22
  50. data/generated/google/apis/healthcare_v1beta1/service.rb +63 -113
  51. data/generated/google/apis/iap_v1.rb +1 -1
  52. data/generated/google/apis/iap_v1/classes.rb +35 -12
  53. data/generated/google/apis/iap_v1/representations.rb +1 -0
  54. data/generated/google/apis/iap_v1/service.rb +1 -1
  55. data/generated/google/apis/iap_v1beta1.rb +1 -1
  56. data/generated/google/apis/iap_v1beta1/classes.rb +26 -10
  57. data/generated/google/apis/jobs_v3p1beta1.rb +1 -1
  58. data/generated/google/apis/osconfig_v1.rb +1 -1
  59. data/generated/google/apis/osconfig_v1/classes.rb +29 -27
  60. data/generated/google/apis/osconfig_v1beta.rb +1 -1
  61. data/generated/google/apis/osconfig_v1beta/classes.rb +17 -20
  62. data/generated/google/apis/run_v1.rb +1 -1
  63. data/generated/google/apis/run_v1/classes.rb +31 -49
  64. data/generated/google/apis/run_v1/representations.rb +1 -17
  65. data/generated/google/apis/run_v1/service.rb +3 -0
  66. data/generated/google/apis/run_v1alpha1.rb +1 -1
  67. data/generated/google/apis/run_v1alpha1/classes.rb +23 -10
  68. data/generated/google/apis/run_v1alpha1/service.rb +3 -0
  69. data/generated/google/apis/sheets_v4.rb +1 -1
  70. data/generated/google/apis/spanner_v1.rb +1 -1
  71. data/generated/google/apis/storage_v1.rb +1 -1
  72. data/generated/google/apis/storage_v1/classes.rb +18 -0
  73. data/generated/google/apis/storage_v1/representations.rb +3 -0
  74. data/generated/google/apis/testing_v1.rb +1 -1
  75. data/generated/google/apis/testing_v1/classes.rb +3 -2
  76. data/generated/google/apis/toolresults_v1beta3.rb +1 -1
  77. data/generated/google/apis/toolresults_v1beta3/classes.rb +141 -2
  78. data/generated/google/apis/toolresults_v1beta3/representations.rb +77 -0
  79. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  80. data/lib/google/apis/version.rb +1 -1
  81. metadata +3 -3
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d3d60c433e69f50a341659359203faa3235fb874c7d045d0b646e551651fc58e
4
- data.tar.gz: '0972492203a3a961c16459ce4201e63bbd326f41d803a26b25714e12a5d30af4'
3
+ metadata.gz: 42b889c9e7a55a1a1eaf758817371de44d8117c69b33c307d643640677ab0f92
4
+ data.tar.gz: 474ef3d7bf61918fa2fa8d7249cebc78181e942c94bf348dc5397d07a512c80a
5
5
  SHA512:
6
- metadata.gz: 9465328995f961d76c4180d25102611bd43c8ac7557e5c2ff57e5c11473e6d9db6b0b2a54777513c3ee26f6e29deee2fefaedf3c865686a2948cdb17d69e3d51
7
- data.tar.gz: 85fa3c38d71832f14cfa9ec8e0d47034eb0488ed7f05c7688e7465326680b8c82449e4407d7b973c66d7e9c0e5d5c71c842fa3dbe4b07dcc0d35d61f3b49e6d4
6
+ metadata.gz: '088d72313c9ed747d64d3df52c60438e06f655c9b125d6ae6d37beb21d15bf5637eee7252982cd2902295925dd5d62f44e384d68b438eeb39046e58417e3e599'
7
+ data.tar.gz: 3d8cc0f60c1fac73c21ea4651e9c5dcacab716b88e5b60845d7bfd3f89cc23c8085ef7e63dec40e9789d33ab6ccce2188ac34d0f717474b28c7f4c0eefaae3c4
@@ -1,3 +1,39 @@
1
+ # 0.39.3
2
+ * Backwards compatible changes:
3
+ * Updated `appengine_v1`
4
+ * Updated `appengine_v1beta`
5
+ * Updated `bigqueryreservation_v1`
6
+ * Updated `bigqueryreservation_v1alpha2`
7
+ * Updated `bigqueryreservation_v1beta1`
8
+ * Updated `cloudkms_v1`
9
+ * Updated `cloudresourcemanager_v1`
10
+ * Updated `cloudresourcemanager_v1beta1`
11
+ * Updated `cloudresourcemanager_v2`
12
+ * Updated `cloudresourcemanager_v2beta1`
13
+ * Updated `cloudshell_v1`
14
+ * Updated `cloudshell_v1alpha1`
15
+ * Updated `container_v1`
16
+ * Updated `container_v1beta1`
17
+ * Updated `firebasehosting_v1beta1`
18
+ * Updated `games_management_v1management`
19
+ * Updated `gameservices_v1beta`
20
+ * Updated `gmail_v1`
21
+ * Updated `healthcare_v1`
22
+ * Updated `healthcare_v1beta1`
23
+ * Updated `iap_v1`
24
+ * Updated `iap_v1beta1`
25
+ * Updated `jobs_v3p1beta1`
26
+ * Updated `osconfig_v1`
27
+ * Updated `osconfig_v1beta`
28
+ * Updated `run_v1`
29
+ * Updated `run_v1alpha1`
30
+ * Updated `sheets_v4`
31
+ * Updated `spanner_v1`
32
+ * Updated `storage_v1`
33
+ * Updated `testing_v1`
34
+ * Updated `toolresults_v1beta3`
35
+ * Updated `youtube_partner_v1`
36
+
1
37
  # 0.39.2
2
38
  * Backwards compatible changes:
3
39
  * Updated `apigee_v1`
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://cloud.google.com/appengine/docs/admin-api/
26
26
  module AppengineV1
27
27
  VERSION = 'V1'
28
- REVISION = '20200329'
28
+ REVISION = '20200507'
29
29
 
30
30
  # View and manage your applications deployed on Google App Engine
31
31
  AUTH_APPENGINE_ADMIN = 'https://www.googleapis.com/auth/appengine.admin'
@@ -104,6 +104,12 @@ module Google
104
104
  # @return [String]
105
105
  attr_accessor :code_bucket
106
106
 
107
+ # The type of the Cloud Firestore or Cloud Datastore database associated with
108
+ # this application.
109
+ # Corresponds to the JSON property `databaseType`
110
+ # @return [String]
111
+ attr_accessor :database_type
112
+
107
113
  # Google Cloud Storage bucket that can be used by this application to store
108
114
  # content.@OutputOnly
109
115
  # Corresponds to the JSON property `defaultBucket`
@@ -178,6 +184,7 @@ module Google
178
184
  def update!(**args)
179
185
  @auth_domain = args[:auth_domain] if args.key?(:auth_domain)
180
186
  @code_bucket = args[:code_bucket] if args.key?(:code_bucket)
187
+ @database_type = args[:database_type] if args.key?(:database_type)
181
188
  @default_bucket = args[:default_bucket] if args.key?(:default_bucket)
182
189
  @default_cookie_expiration = args[:default_cookie_expiration] if args.key?(:default_cookie_expiration)
183
190
  @default_hostname = args[:default_hostname] if args.key?(:default_hostname)
@@ -459,6 +459,7 @@ module Google
459
459
  class Representation < Google::Apis::Core::JsonRepresentation
460
460
  property :auth_domain, as: 'authDomain'
461
461
  property :code_bucket, as: 'codeBucket'
462
+ property :database_type, as: 'databaseType'
462
463
  property :default_bucket, as: 'defaultBucket'
463
464
  property :default_cookie_expiration, as: 'defaultCookieExpiration'
464
465
  property :default_hostname, as: 'defaultHostname'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://cloud.google.com/appengine/docs/admin-api/
26
26
  module AppengineV1beta
27
27
  VERSION = 'V1beta'
28
- REVISION = '20200329'
28
+ REVISION = '20200507'
29
29
 
30
30
  # View and manage your applications deployed on Google App Engine
31
31
  AUTH_APPENGINE_ADMIN = 'https://www.googleapis.com/auth/appengine.admin'
@@ -104,6 +104,12 @@ module Google
104
104
  # @return [String]
105
105
  attr_accessor :code_bucket
106
106
 
107
+ # The type of the Cloud Firestore or Cloud Datastore database associated with
108
+ # this application.
109
+ # Corresponds to the JSON property `databaseType`
110
+ # @return [String]
111
+ attr_accessor :database_type
112
+
107
113
  # Google Cloud Storage bucket that can be used by this application to store
108
114
  # content.@OutputOnly
109
115
  # Corresponds to the JSON property `defaultBucket`
@@ -178,6 +184,7 @@ module Google
178
184
  def update!(**args)
179
185
  @auth_domain = args[:auth_domain] if args.key?(:auth_domain)
180
186
  @code_bucket = args[:code_bucket] if args.key?(:code_bucket)
187
+ @database_type = args[:database_type] if args.key?(:database_type)
181
188
  @default_bucket = args[:default_bucket] if args.key?(:default_bucket)
182
189
  @default_cookie_expiration = args[:default_cookie_expiration] if args.key?(:default_cookie_expiration)
183
190
  @default_hostname = args[:default_hostname] if args.key?(:default_hostname)
@@ -471,6 +471,7 @@ module Google
471
471
  class Representation < Google::Apis::Core::JsonRepresentation
472
472
  property :auth_domain, as: 'authDomain'
473
473
  property :code_bucket, as: 'codeBucket'
474
+ property :database_type, as: 'databaseType'
474
475
  property :default_bucket, as: 'defaultBucket'
475
476
  property :default_cookie_expiration, as: 'defaultCookieExpiration'
476
477
  property :default_hostname, as: 'defaultHostname'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://cloud.google.com/bigquery/
26
26
  module BigqueryreservationV1
27
27
  VERSION = 'V1'
28
- REVISION = '20200410'
28
+ REVISION = '20200509'
29
29
 
30
30
  # View and manage your data in Google BigQuery
31
31
  AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'
@@ -28,7 +28,7 @@ module Google
28
28
  include Google::Apis::Core::Hashable
29
29
 
30
30
  # The resource which will use the reservation. E.g.
31
- # projects/myproject, folders/123, organizations/456.
31
+ # `projects/myproject`, `folders/123`, or `organizations/456`.
32
32
  # Corresponds to the JSON property `assignee`
33
33
  # @return [String]
34
34
  attr_accessor :assignee
@@ -39,7 +39,7 @@ module Google
39
39
  attr_accessor :job_type
40
40
 
41
41
  # Output only. Name of the resource. E.g.:
42
- # projects/myproject/locations/US/reservations/team1-prod/assignments/123.
42
+ # `projects/myproject/locations/US/reservations/team1-prod/assignments/123`.
43
43
  # Corresponds to the JSON property `name`
44
44
  # @return [String]
45
45
  attr_accessor :name
@@ -98,8 +98,9 @@ module Google
98
98
  # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
99
99
  # (in the form of slots) with some committed period of usage. Annual
100
100
  # commitments renew by default. Commitments can be removed after their
101
- # commitment end time passes. In order to remove annual commitment, its plan
102
- # needs to be changed to monthly or flex first.
101
+ # commitment end time passes.
102
+ # In order to remove annual commitment, its plan needs to be changed
103
+ # to monthly or flex first.
103
104
  # A capacity commitment resource exists as a child resource of the admin
104
105
  # project.
105
106
  class CapacityCommitment
@@ -123,7 +124,7 @@ module Google
123
124
  attr_accessor :failure_status
124
125
 
125
126
  # Output only. The resource name of the capacity commitment, e.g.,
126
- # projects/myproject/locations/US/capacityCommitments/123
127
+ # `projects/myproject/locations/US/capacityCommitments/123`
127
128
  # Corresponds to the JSON property `name`
128
129
  # @return [String]
129
130
  attr_accessor :name
@@ -135,7 +136,7 @@ module Google
135
136
 
136
137
  # The plan this capacity commitment is converted to after commitment_end_time
137
138
  # passes. Once the plan is changed, committed period is extended according to
138
- # commitment plan. Only applicable for ANNUAL commitments.
139
+ # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
139
140
  # Corresponds to the JSON property `renewalPlan`
140
141
  # @return [String]
141
142
  attr_accessor :renewal_plan
@@ -332,15 +333,16 @@ module Google
332
333
 
333
334
  # The request for
334
335
  # ReservationService.MoveAssignment.
335
- # Note: "bigquery.reservationAssignments.create" permission is required on the
336
- # destination_id. Note: "bigquery.reservationAssignments.create" and
337
- # "bigquery.reservationAssignments.delete" permission is required on the
336
+ # **Note**: "bigquery.reservationAssignments.create" permission is required on
337
+ # the destination_id.
338
+ # **Note**: "bigquery.reservationAssignments.create" and
339
+ # "bigquery.reservationAssignments.delete" permission are required on the
338
340
  # related assignee.
339
341
  class MoveAssignmentRequest
340
342
  include Google::Apis::Core::Hashable
341
343
 
342
344
  # The new reservation ID, e.g.:
343
- # projects/myotherproject/locations/US/reservations/team2-prod
345
+ # `projects/myotherproject/locations/US/reservations/team2-prod`
344
346
  # Corresponds to the JSON property `destinationId`
345
347
  # @return [String]
346
348
  attr_accessor :destination_id
@@ -432,7 +434,7 @@ module Google
432
434
  alias_method :ignore_idle_slots?, :ignore_idle_slots
433
435
 
434
436
  # The resource name of the reservation, e.g.,
435
- # "projects/*/locations/*/reservations/team1-prod".
437
+ # `projects/*/locations/*/reservations/team1-prod`.
436
438
  # Corresponds to the JSON property `name`
437
439
  # @return [String]
438
440
  attr_accessor :name
@@ -513,8 +515,9 @@ module Google
513
515
  # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
514
516
  # (in the form of slots) with some committed period of usage. Annual
515
517
  # commitments renew by default. Commitments can be removed after their
516
- # commitment end time passes. In order to remove annual commitment, its plan
517
- # needs to be changed to monthly or flex first.
518
+ # commitment end time passes.
519
+ # In order to remove annual commitment, its plan needs to be changed
520
+ # to monthly or flex first.
518
521
  # A capacity commitment resource exists as a child resource of the admin
519
522
  # project.
520
523
  # Corresponds to the JSON property `first`
@@ -524,8 +527,9 @@ module Google
524
527
  # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
525
528
  # (in the form of slots) with some committed period of usage. Annual
526
529
  # commitments renew by default. Commitments can be removed after their
527
- # commitment end time passes. In order to remove annual commitment, its plan
528
- # needs to be changed to monthly or flex first.
530
+ # commitment end time passes.
531
+ # In order to remove annual commitment, its plan needs to be changed
532
+ # to monthly or flex first.
529
533
  # A capacity commitment resource exists as a child resource of the admin
530
534
  # project.
531
535
  # Corresponds to the JSON property `second`
@@ -160,19 +160,20 @@ module Google
160
160
 
161
161
  # Looks up assignments for a specified resource for a particular region.
162
162
  # If the request is about a project:
163
- # 1) Assignments created on the project will be returned if they exist.
164
- # 2) Otherwise assignments created on the closest ancestor will be
165
- # returned. 3) Assignments for different JobTypes will all be returned.
166
- # Same logic applies if the request is about a folder.
163
+ # 1. Assignments created on the project will be returned if they exist.
164
+ # 2. Otherwise assignments created on the closest ancestor will be
165
+ # returned.
166
+ # 3. Assignments for different JobTypes will all be returned.
167
+ # The same logic applies if the request is about a folder.
167
168
  # If the request is about an organization, then assignments created on the
168
169
  # organization will be returned (organization doesn't have ancestors).
169
170
  # Comparing to ListAssignments, there are some behavior
170
171
  # differences:
171
- # 1) permission on the assignee will be verified in this API.
172
- # 2) Hierarchy lookup (project->folder->organization) happens in this API.
173
- # 3) Parent here is projects/*/locations/*, instead of
174
- # projects/*/locations/*reservations/*.
175
- # Note "-" cannot be used for projects
172
+ # 1. permission on the assignee will be verified in this API.
173
+ # 2. Hierarchy lookup (project->folder->organization) happens in this API.
174
+ # 3. Parent here is `projects/*/locations/*`, instead of
175
+ # `projects/*/locations/*reservations/*`.
176
+ # **Note** "-" cannot be used for projects
176
177
  # nor locations.
177
178
  # @param [String] parent
178
179
  # Required. The resource name of the admin project(containing project and
@@ -180,14 +181,15 @@ module Google
180
181
  # e.g.:
181
182
  # "projects/myproject/locations/US".
182
183
  # @param [Fixnum] page_size
183
- # The maximum number of items to return.
184
+ # The maximum number of items to return per page.
184
185
  # @param [String] page_token
185
186
  # The next_page_token value returned from a previous List request, if any.
186
187
  # @param [String] query
187
188
  # Please specify resource name as assignee in the query.
188
- # e.g., "assignee=projects/myproject"
189
- # "assignee=folders/123"
190
- # "assignee=organizations/456"
189
+ # Examples:
190
+ # * `assignee=projects/myproject`
191
+ # * `assignee=folders/123`
192
+ # * `assignee=organizations/456`
191
193
  # @param [String] fields
192
194
  # Selector specifying which fields to include in a partial response.
193
195
  # @param [String] quota_user
@@ -219,8 +221,8 @@ module Google
219
221
  end
220
222
 
221
223
  # Updates a BI reservation.
222
- # Only fields specified in the field_mask are updated.
223
- # Singleton BI reservation always exists with default size 0.
224
+ # Only fields specified in the `field_mask` are updated.
225
+ # A singleton BI reservation always exists with default size 0.
224
226
  # In order to reserve BI capacity it needs to be updated to an amount
225
227
  # greater than 0. In order to release BI capacity reservation size
226
228
  # must be set to 0.
@@ -400,10 +402,11 @@ module Google
400
402
  execute_or_queue_command(command, &block)
401
403
  end
402
404
 
403
- # Merges capacity commitments of the same plan into one. Resulting capacity
404
- # commitment has the longer commitment_end_time out of the two. Attempting to
405
- # merge capacity commitments of different plan will fail with the error code
406
- # `google.rpc.Code.FAILED_PRECONDITION`.
405
+ # Merges capacity commitments of the same plan into a single commitment.
406
+ # The resulting capacity commitment has the greater commitment_end_time
407
+ # out of the to-be-merged capacity commitments.
408
+ # Attempting to merge capacity commitments of different plan will fail
409
+ # with the error code `google.rpc.Code.FAILED_PRECONDITION`.
407
410
  # @param [String] parent
408
411
  # Parent resource that identifies admin project and location e.g.,
409
412
  # projects/myproject/locations/us
@@ -438,13 +441,13 @@ module Google
438
441
  end
439
442
 
440
443
  # Updates an existing capacity commitment.
441
- # Only plan and renewal_plan fields can be updated.
444
+ # Only `plan` and `renewal_plan` fields can be updated.
442
445
  # Plan can only be changed to a plan of a longer commitment period.
443
446
  # Attempting to change to a plan with shorter commitment period will fail
444
447
  # with the error code `google.rpc.Code.FAILED_PRECONDITION`.
445
448
  # @param [String] name
446
449
  # Output only. The resource name of the capacity commitment, e.g.,
447
- # projects/myproject/locations/US/capacityCommitments/123
450
+ # `projects/myproject/locations/US/capacityCommitments/123`
448
451
  # @param [Google::Apis::BigqueryreservationV1::CapacityCommitment] capacity_commitment_object
449
452
  # @param [String] update_mask
450
453
  # Standard field mask for the set of fields to be updated.
@@ -479,10 +482,11 @@ module Google
479
482
  end
480
483
 
481
484
  # Splits capacity commitment to two commitments of the same plan and
482
- # commitment_end_time. A common use case to do that is to perform a downgrade
483
- # e.g., in order to downgrade from 10000 slots to 8000, one might split 10000
484
- # capacity commitment to 2000 and 8000, change the plan of the first one to
485
- # flex and then delete it.
485
+ # `commitment_end_time`.
486
+ # A common use case is to enable downgrading commitments.
487
+ # For example, in order to downgrade from 10000 slots to 8000, you might
488
+ # split a 10000 capacity commitment into commitments of 2000 and 8000. Then,
489
+ # you would change the plan of the first one to `FLEX` and then delete it.
486
490
  # @param [String] name
487
491
  # Required. The resource name e.g.,:
488
492
  # projects/myproject/locations/US/capacityCommitments/123
@@ -519,7 +523,7 @@ module Google
519
523
  # Creates a new reservation resource.
520
524
  # @param [String] parent
521
525
  # Required. Project, location. E.g.,
522
- # projects/myproject/locations/US
526
+ # `projects/myproject/locations/US`
523
527
  # @param [Google::Apis::BigqueryreservationV1::Reservation] reservation_object
524
528
  # @param [String] reservation_id
525
529
  # The reservation ID. This field must only contain lower case alphanumeric
@@ -559,7 +563,7 @@ module Google
559
563
  # assignments.
560
564
  # @param [String] name
561
565
  # Required. Resource name of the reservation to retrieve. E.g.,
562
- # projects/myproject/locations/US/reservations/team1-prod
566
+ # `projects/myproject/locations/US/reservations/team1-prod`
563
567
  # @param [String] fields
564
568
  # Selector specifying which fields to include in a partial response.
565
569
  # @param [String] quota_user
@@ -590,7 +594,7 @@ module Google
590
594
  # Returns information about the reservation.
591
595
  # @param [String] name
592
596
  # Required. Resource name of the reservation to retrieve. E.g.,
593
- # projects/myproject/locations/US/reservations/team1-prod
597
+ # `projects/myproject/locations/US/reservations/team1-prod`
594
598
  # @param [String] fields
595
599
  # Selector specifying which fields to include in a partial response.
596
600
  # @param [String] quota_user
@@ -623,7 +627,7 @@ module Google
623
627
  # Required. The parent resource name containing project and location, e.g.:
624
628
  # "projects/myproject/locations/US"
625
629
  # @param [Fixnum] page_size
626
- # The maximum number of items to return.
630
+ # The maximum number of items to return per page.
627
631
  # @param [String] page_token
628
632
  # The next_page_token value returned from a previous List request, if any.
629
633
  # @param [String] fields
@@ -658,7 +662,7 @@ module Google
658
662
  # Updates an existing reservation resource.
659
663
  # @param [String] name
660
664
  # The resource name of the reservation, e.g.,
661
- # "projects/*/locations/*/reservations/team1-prod".
665
+ # `projects/*/locations/*/reservations/team1-prod`.
662
666
  # @param [Google::Apis::BigqueryreservationV1::Reservation] reservation_object
663
667
  # @param [String] update_mask
664
668
  # Standard field mask for the set of fields to be updated.
@@ -692,18 +696,24 @@ module Google
692
696
  execute_or_queue_command(command, &block)
693
697
  end
694
698
 
695
- # Creates an object which allows the given project to submit jobs
696
- # of a certain type using slots from the specified reservation. Currently a
699
+ # Creates an assignment object which allows the given project to submit jobs
700
+ # of a certain type using slots from the specified reservation.
701
+ # Currently a
697
702
  # resource (project, folder, organization) can only have one assignment per
698
- # `job_type, location`, and that reservation will be used for all jobs of the
699
- # matching type. Within the organization, different assignments can be
700
- # created on projects, folders or organization level. During query execution,
703
+ # each (job_type, location) combination, and that reservation will be used
704
+ # for all jobs of the matching type.
705
+ # Different assignments can be created on different levels of the
706
+ # projects, folders or organization hierarchy. During query execution,
701
707
  # the assignment is looked up at the project, folder and organization levels
702
- # in that order. The first assignment found is applied to the query. When
703
- # creating assignments, it does not matter if other assignments exist at
704
- # higher levels. E.g: organizationA contains project1, project2. Assignments
705
- # for organizationA, project1 and project2 could all be created, mapping to
706
- # the same or different reservations.
708
+ # in that order. The first assignment found is applied to the query.
709
+ # When creating assignments, it does not matter if other assignments exist at
710
+ # higher levels.
711
+ # Example:
712
+ # * The organization `organizationA` contains two projects, `project1`
713
+ # and `project2`.
714
+ # * Assignments for all three entities (`organizationA`, `project1`, and
715
+ # `project2`) could all be created and mapped to the same or different
716
+ # reservations.
707
717
  # Returns `google.rpc.Code.PERMISSION_DENIED` if user does not have
708
718
  # 'bigquery.admin' permissions on the project using the reservation
709
719
  # and the project that owns this reservation.
@@ -711,7 +721,7 @@ module Google
711
721
  # does not match location of the reservation.
712
722
  # @param [String] parent
713
723
  # Required. The parent resource name of the assignment
714
- # E.g.: projects/myproject/locations/US/reservations/team1-prod
724
+ # E.g. `projects/myproject/locations/US/reservations/team1-prod`
715
725
  # @param [Google::Apis::BigqueryreservationV1::Assignment] assignment_object
716
726
  # @param [String] fields
717
727
  # Selector specifying which fields to include in a partial response.
@@ -743,18 +753,20 @@ module Google
743
753
  end
744
754
 
745
755
  # Deletes a assignment. No expansion will happen.
746
- # E.g:
747
- # organizationA contains project1 and project2. Reservation res1 exists.
748
- # CreateAssignment was invoked previously and following assignments were
749
- # created explicitly:
750
- # <organizationA, res1>
751
- # <project1, res1>
752
- # Then deletion of <organizationA, res1> won't affect <project1, res1>. After
753
- # deletion of <organizationA, res1>, queries from project1 will still use
754
- # res1, while queries from project2 will use on-demand mode.
756
+ # Example:
757
+ # * Organization `organizationA` contains two projects, `project1` and
758
+ # `project2`.
759
+ # * Reservation `res1` exists and was created previously.
760
+ # * CreateAssignment was used previously to define the following
761
+ # associations between entities and reservations: `<organizationA, res1>`
762
+ # and `<project1, res1>`
763
+ # In this example, deletion of the `<organizationA, res1>` assignment won't
764
+ # affect the other assignment `<project1, res1>`. After said deletion,
765
+ # queries from `project1` will still use `res1` while queries from
766
+ # `project2` will switch to use on-demand mode.
755
767
  # @param [String] name
756
- # Required. Name of the resource, e.g.:
757
- # projects/myproject/locations/US/reservations/team1-prod/assignments/123
768
+ # Required. Name of the resource, e.g.
769
+ # `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
758
770
  # @param [String] fields
759
771
  # Selector specifying which fields to include in a partial response.
760
772
  # @param [String] quota_user
@@ -783,24 +795,27 @@ module Google
783
795
  end
784
796
 
785
797
  # Lists assignments.
786
- # Only explicitly created assignments will be returned. E.g:
787
- # organizationA contains project1 and project2. Reservation res1 exists.
788
- # CreateAssignment was invoked previously and following assignments were
789
- # created explicitly:
790
- # <organizationA, res1>
791
- # <project1, res1>
792
- # Then this API will just return the above two assignments for reservation
793
- # res1, and no expansion/merge will happen. Wildcard "-" can be used for
798
+ # Only explicitly created assignments will be returned.
799
+ # Example:
800
+ # * Organization `organizationA` contains two projects, `project1` and
801
+ # `project2`.
802
+ # * Reservation `res1` exists and was created previously.
803
+ # * CreateAssignment was used previously to define the following
804
+ # associations between entities and reservations: `<organizationA, res1>`
805
+ # and `<project1, res1>`
806
+ # In this example, ListAssignments will just return the above two assignments
807
+ # for reservation `res1`, and no expansion/merge will happen.
808
+ # The wildcard "-" can be used for
794
809
  # reservations in the request. In that case all assignments belongs to the
795
- # specified project and location will be listed. Note
796
- # "-" cannot be used for projects nor locations.
810
+ # specified project and location will be listed.
811
+ # **Note** "-" cannot be used for projects nor locations.
797
812
  # @param [String] parent
798
813
  # Required. The parent resource name e.g.:
799
- # projects/myproject/locations/US/reservations/team1-prod
814
+ # `projects/myproject/locations/US/reservations/team1-prod`
800
815
  # Or:
801
- # projects/myproject/locations/US/reservations/-
816
+ # `projects/myproject/locations/US/reservations/-`
802
817
  # @param [Fixnum] page_size
803
- # The maximum number of items to return.
818
+ # The maximum number of items to return per page.
804
819
  # @param [String] page_token
805
820
  # The next_page_token value returned from a previous List request, if any.
806
821
  # @param [String] fields
@@ -832,16 +847,14 @@ module Google
832
847
  execute_or_queue_command(command, &block)
833
848
  end
834
849
 
835
- # Moves a assignment under a new reservation. Customers can do this by
836
- # deleting the existing assignment followed by creating another assignment
837
- # under the new reservation, but this method provides a transactional way to
838
- # do so, to make sure the assignee always has an associated reservation.
839
- # Without the method customers might see some queries run on-demand which
840
- # might be unexpected.
850
+ # Moves an assignment under a new reservation.
851
+ # This differs from removing an existing assignment and recreating a new one
852
+ # by providing a transactional change that ensures an assignee always has an
853
+ # associated reservation.
841
854
  # @param [String] name
842
855
  # Required. The resource name of the assignment,
843
- # e.g.:
844
- # projects/myproject/locations/US/reservations/team1-prod/assignments/123
856
+ # e.g.
857
+ # `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
845
858
  # @param [Google::Apis::BigqueryreservationV1::MoveAssignmentRequest] move_assignment_request_object
846
859
  # @param [String] fields
847
860
  # Selector specifying which fields to include in a partial response.