google-api-client 0.39.2 → 0.39.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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.