google-api-client 0.42.1 → 0.42.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (201) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +76 -0
  3. data/generated/google/apis/admob_v1.rb +1 -1
  4. data/generated/google/apis/admob_v1/classes.rb +3 -1
  5. data/generated/google/apis/apigee_v1.rb +1 -1
  6. data/generated/google/apis/apigee_v1/classes.rb +6 -12
  7. data/generated/google/apis/apigee_v1/representations.rb +1 -2
  8. data/generated/google/apis/apigee_v1/service.rb +18 -5
  9. data/generated/google/apis/appengine_v1.rb +1 -1
  10. data/generated/google/apis/appengine_v1/service.rb +6 -3
  11. data/generated/google/apis/appengine_v1beta.rb +1 -1
  12. data/generated/google/apis/appengine_v1beta/service.rb +6 -2
  13. data/generated/google/apis/appsmarket_v2.rb +1 -1
  14. data/generated/google/apis/bigquery_v2.rb +1 -1
  15. data/generated/google/apis/bigquery_v2/classes.rb +198 -3
  16. data/generated/google/apis/bigquery_v2/representations.rb +70 -0
  17. data/generated/google/apis/bigtableadmin_v1.rb +1 -1
  18. data/generated/google/apis/bigtableadmin_v1/classes.rb +267 -0
  19. data/generated/google/apis/bigtableadmin_v1/representations.rb +100 -0
  20. data/generated/google/apis/bigtableadmin_v2.rb +1 -1
  21. data/generated/google/apis/bigtableadmin_v2/classes.rb +355 -0
  22. data/generated/google/apis/bigtableadmin_v2/representations.rb +146 -0
  23. data/generated/google/apis/bigtableadmin_v2/service.rb +298 -0
  24. data/generated/google/apis/books_v1.rb +1 -1
  25. data/generated/google/apis/books_v1/classes.rb +140 -159
  26. data/generated/google/apis/books_v1/service.rb +47 -49
  27. data/generated/google/apis/chat_v1.rb +1 -1
  28. data/generated/google/apis/chat_v1/classes.rb +19 -0
  29. data/generated/google/apis/chat_v1/representations.rb +13 -0
  30. data/generated/google/apis/chat_v1/service.rb +39 -0
  31. data/generated/google/apis/chromeuxreport_v1.rb +1 -1
  32. data/generated/google/apis/chromeuxreport_v1/classes.rb +22 -0
  33. data/generated/google/apis/chromeuxreport_v1/representations.rb +2 -0
  34. data/generated/google/apis/{cloudfunctions_v1beta2.rb → cloudasset_v1p5beta1.rb} +9 -9
  35. data/generated/google/apis/cloudasset_v1p5beta1/classes.rb +1537 -0
  36. data/generated/google/apis/cloudasset_v1p5beta1/representations.rb +399 -0
  37. data/generated/google/apis/cloudasset_v1p5beta1/service.rb +129 -0
  38. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  39. data/generated/google/apis/cloudbuild_v1alpha1.rb +1 -1
  40. data/generated/google/apis/cloudbuild_v1alpha2.rb +1 -1
  41. data/generated/google/apis/cloudfunctions_v1.rb +1 -1
  42. data/generated/google/apis/cloudfunctions_v1/classes.rb +0 -45
  43. data/generated/google/apis/cloudfunctions_v1/representations.rb +0 -17
  44. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  45. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +503 -754
  46. data/generated/google/apis/cloudresourcemanager_v1/service.rb +198 -249
  47. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  48. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +258 -429
  49. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +136 -178
  50. data/generated/google/apis/cloudresourcemanager_v2.rb +1 -1
  51. data/generated/google/apis/cloudresourcemanager_v2/classes.rb +258 -414
  52. data/generated/google/apis/cloudresourcemanager_v2/service.rb +96 -129
  53. data/generated/google/apis/cloudresourcemanager_v2beta1.rb +1 -1
  54. data/generated/google/apis/cloudresourcemanager_v2beta1/classes.rb +258 -414
  55. data/generated/google/apis/cloudresourcemanager_v2beta1/service.rb +96 -129
  56. data/generated/google/apis/cloudscheduler_v1.rb +1 -1
  57. data/generated/google/apis/cloudscheduler_v1/classes.rb +11 -0
  58. data/generated/google/apis/cloudscheduler_v1/representations.rb +1 -0
  59. data/generated/google/apis/cloudscheduler_v1beta1.rb +1 -1
  60. data/generated/google/apis/cloudscheduler_v1beta1/classes.rb +11 -0
  61. data/generated/google/apis/cloudscheduler_v1beta1/representations.rb +1 -0
  62. data/generated/google/apis/cloudshell_v1.rb +1 -1
  63. data/generated/google/apis/cloudshell_v1/classes.rb +2 -2
  64. data/generated/google/apis/cloudshell_v1alpha1.rb +1 -1
  65. data/generated/google/apis/cloudshell_v1alpha1/classes.rb +8 -5
  66. data/generated/google/apis/content_v2.rb +1 -1
  67. data/generated/google/apis/content_v2/classes.rb +6 -0
  68. data/generated/google/apis/content_v2/representations.rb +1 -0
  69. data/generated/google/apis/content_v2_1.rb +1 -1
  70. data/generated/google/apis/content_v2_1/classes.rb +6 -0
  71. data/generated/google/apis/content_v2_1/representations.rb +1 -0
  72. data/generated/google/apis/customsearch_v1.rb +1 -1
  73. data/generated/google/apis/customsearch_v1/classes.rb +14 -10
  74. data/generated/google/apis/customsearch_v1/service.rb +6 -6
  75. data/generated/google/apis/datacatalog_v1beta1.rb +1 -1
  76. data/generated/google/apis/datacatalog_v1beta1/classes.rb +380 -569
  77. data/generated/google/apis/datacatalog_v1beta1/service.rb +319 -440
  78. data/generated/google/apis/dataflow_v1b3.rb +1 -1
  79. data/generated/google/apis/dataflow_v1b3/classes.rb +2 -1
  80. data/generated/google/apis/deploymentmanager_v2.rb +1 -1
  81. data/generated/google/apis/dfareporting_v3_4.rb +1 -1
  82. data/generated/google/apis/dfareporting_v3_4/classes.rb +421 -0
  83. data/generated/google/apis/dfareporting_v3_4/representations.rb +182 -0
  84. data/generated/google/apis/dialogflow_v2.rb +1 -1
  85. data/generated/google/apis/dialogflow_v2/classes.rb +148 -35
  86. data/generated/google/apis/dialogflow_v2/representations.rb +15 -0
  87. data/generated/google/apis/dialogflow_v2/service.rb +4 -0
  88. data/generated/google/apis/dialogflow_v2beta1.rb +1 -1
  89. data/generated/google/apis/dialogflow_v2beta1/classes.rb +164 -36
  90. data/generated/google/apis/dialogflow_v2beta1/representations.rb +15 -0
  91. data/generated/google/apis/dialogflow_v2beta1/service.rb +8 -0
  92. data/generated/google/apis/displayvideo_v1.rb +7 -1
  93. data/generated/google/apis/displayvideo_v1/classes.rb +1666 -1726
  94. data/generated/google/apis/displayvideo_v1/representations.rb +264 -0
  95. data/generated/google/apis/displayvideo_v1/service.rb +1173 -926
  96. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  97. data/generated/google/apis/doubleclicksearch_v2/classes.rb +109 -126
  98. data/generated/google/apis/doubleclicksearch_v2/service.rb +3 -4
  99. data/generated/google/apis/fcm_v1.rb +1 -1
  100. data/generated/google/apis/fcm_v1/classes.rb +245 -393
  101. data/generated/google/apis/fcm_v1/service.rb +5 -6
  102. data/generated/google/apis/firebase_v1beta1.rb +1 -1
  103. data/generated/google/apis/firebase_v1beta1/classes.rb +10 -16
  104. data/generated/google/apis/firebaseml_v1beta2.rb +1 -1
  105. data/generated/google/apis/firebaseml_v1beta2/classes.rb +9 -0
  106. data/generated/google/apis/firebaseml_v1beta2/representations.rb +1 -0
  107. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  108. data/generated/google/apis/games_configuration_v1configuration/service.rb +2 -2
  109. data/generated/google/apis/games_management_v1management.rb +1 -1
  110. data/generated/google/apis/games_management_v1management/service.rb +2 -2
  111. data/generated/google/apis/games_v1.rb +1 -1
  112. data/generated/google/apis/games_v1/classes.rb +1 -1
  113. data/generated/google/apis/games_v1/service.rb +2 -2
  114. data/generated/google/apis/gmail_v1.rb +1 -1
  115. data/generated/google/apis/gmail_v1/classes.rb +2 -2
  116. data/generated/google/apis/gmail_v1/service.rb +2 -1
  117. data/generated/google/apis/gmailpostmastertools_v1beta1.rb +4 -1
  118. data/generated/google/apis/monitoring_v1.rb +1 -1
  119. data/generated/google/apis/monitoring_v1/classes.rb +2 -1
  120. data/generated/google/apis/monitoring_v3.rb +1 -1
  121. data/generated/google/apis/monitoring_v3/classes.rb +5 -4
  122. data/generated/google/apis/monitoring_v3/service.rb +5 -4
  123. data/generated/google/apis/osconfig_v1.rb +1 -1
  124. data/generated/google/apis/osconfig_v1/classes.rb +75 -0
  125. data/generated/google/apis/osconfig_v1/representations.rb +35 -0
  126. data/generated/google/apis/osconfig_v1beta.rb +1 -1
  127. data/generated/google/apis/osconfig_v1beta/classes.rb +75 -0
  128. data/generated/google/apis/osconfig_v1beta/representations.rb +35 -0
  129. data/generated/google/apis/pagespeedonline_v5.rb +1 -1
  130. data/generated/google/apis/people_v1.rb +1 -1
  131. data/generated/google/apis/people_v1/classes.rb +243 -397
  132. data/generated/google/apis/people_v1/service.rb +156 -384
  133. data/generated/google/apis/prod_tt_sasportal_v1alpha1.rb +1 -1
  134. data/generated/google/apis/prod_tt_sasportal_v1alpha1/classes.rb +0 -73
  135. data/generated/google/apis/prod_tt_sasportal_v1alpha1/representations.rb +0 -32
  136. data/generated/google/apis/prod_tt_sasportal_v1alpha1/service.rb +0 -477
  137. data/generated/google/apis/pubsub_v1.rb +1 -1
  138. data/generated/google/apis/pubsub_v1/classes.rb +21 -0
  139. data/generated/google/apis/pubsub_v1/representations.rb +2 -0
  140. data/generated/google/apis/realtimebidding_v1.rb +1 -1
  141. data/generated/google/apis/redis_v1.rb +1 -1
  142. data/generated/google/apis/redis_v1/classes.rb +397 -0
  143. data/generated/google/apis/redis_v1/representations.rb +139 -0
  144. data/generated/google/apis/redis_v1beta1.rb +1 -1
  145. data/generated/google/apis/redis_v1beta1/classes.rb +397 -0
  146. data/generated/google/apis/redis_v1beta1/representations.rb +139 -0
  147. data/generated/google/apis/remotebuildexecution_v1.rb +1 -1
  148. data/generated/google/apis/remotebuildexecution_v1alpha.rb +1 -1
  149. data/generated/google/apis/remotebuildexecution_v2.rb +1 -1
  150. data/generated/google/apis/run_v1.rb +1 -1
  151. data/generated/google/apis/run_v1/classes.rb +835 -1248
  152. data/generated/google/apis/run_v1/service.rb +195 -245
  153. data/generated/google/apis/run_v1alpha1.rb +1 -1
  154. data/generated/google/apis/run_v1alpha1/classes.rb +934 -1331
  155. data/generated/google/apis/run_v1alpha1/service.rb +321 -377
  156. data/generated/google/apis/run_v1beta1.rb +1 -1
  157. data/generated/google/apis/run_v1beta1/classes.rb +209 -276
  158. data/generated/google/apis/run_v1beta1/service.rb +16 -18
  159. data/generated/google/apis/sasportal_v1alpha1.rb +1 -1
  160. data/generated/google/apis/sasportal_v1alpha1/classes.rb +0 -73
  161. data/generated/google/apis/sasportal_v1alpha1/representations.rb +0 -32
  162. data/generated/google/apis/sasportal_v1alpha1/service.rb +0 -477
  163. data/generated/google/apis/serviceconsumermanagement_v1.rb +1 -1
  164. data/generated/google/apis/serviceconsumermanagement_v1/classes.rb +2 -2
  165. data/generated/google/apis/serviceconsumermanagement_v1/service.rb +7 -7
  166. data/generated/google/apis/serviceconsumermanagement_v1beta1.rb +1 -1
  167. data/generated/google/apis/serviceconsumermanagement_v1beta1/classes.rb +1 -1
  168. data/generated/google/apis/servicenetworking_v1.rb +1 -1
  169. data/generated/google/apis/servicenetworking_v1/classes.rb +1 -1
  170. data/generated/google/apis/servicenetworking_v1beta.rb +1 -1
  171. data/generated/google/apis/servicenetworking_v1beta/classes.rb +1 -1
  172. data/generated/google/apis/serviceusage_v1.rb +1 -1
  173. data/generated/google/apis/serviceusage_v1/classes.rb +1 -1
  174. data/generated/google/apis/serviceusage_v1beta1.rb +1 -1
  175. data/generated/google/apis/serviceusage_v1beta1/classes.rb +1 -1
  176. data/generated/google/apis/spanner_v1.rb +1 -1
  177. data/generated/google/apis/sql_v1beta4.rb +1 -1
  178. data/generated/google/apis/sql_v1beta4/classes.rb +207 -200
  179. data/generated/google/apis/sql_v1beta4/representations.rb +2 -1
  180. data/generated/google/apis/sql_v1beta4/service.rb +2 -2
  181. data/generated/google/apis/testing_v1.rb +1 -1
  182. data/generated/google/apis/testing_v1/classes.rb +63 -0
  183. data/generated/google/apis/testing_v1/representations.rb +32 -0
  184. data/generated/google/apis/toolresults_v1beta3.rb +1 -1
  185. data/generated/google/apis/toolresults_v1beta3/classes.rb +9 -0
  186. data/generated/google/apis/toolresults_v1beta3/representations.rb +1 -0
  187. data/generated/google/apis/toolresults_v1beta3/service.rb +498 -498
  188. data/generated/google/apis/webfonts_v1.rb +1 -1
  189. data/generated/google/apis/webfonts_v1/service.rb +2 -2
  190. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  191. data/generated/google/apis/youtube_partner_v1/classes.rb +637 -761
  192. data/generated/google/apis/youtube_partner_v1/service.rb +511 -651
  193. data/generated/google/apis/youtube_v3.rb +1 -1
  194. data/generated/google/apis/youtube_v3/classes.rb +6 -0
  195. data/generated/google/apis/youtube_v3/representations.rb +1 -0
  196. data/generated/google/apis/youtube_v3/service.rb +32 -32
  197. data/lib/google/apis/version.rb +1 -1
  198. metadata +7 -7
  199. data/generated/google/apis/cloudfunctions_v1beta2/classes.rb +0 -848
  200. data/generated/google/apis/cloudfunctions_v1beta2/representations.rb +0 -346
  201. data/generated/google/apis/cloudfunctions_v1beta2/service.rb +0 -486
@@ -51,11 +51,11 @@ module Google
51
51
  # Fetches an Organization resource identified by the specified resource name.
52
52
  # @param [String] name
53
53
  # The resource name of the Organization to fetch. This is the organization's
54
- # relative path in the API, formatted as "organizations/[organizationId]".
55
- # For example, "organizations/1234".
54
+ # relative path in the API, formatted as "organizations/[organizationId]". For
55
+ # example, "organizations/1234".
56
56
  # @param [String] organization_id
57
- # The id of the Organization resource to fetch.
58
- # This field is deprecated and will be removed in v1. Use name instead.
57
+ # The id of the Organization resource to fetch. This field is deprecated and
58
+ # will be removed in v1. Use name instead.
59
59
  # @param [String] fields
60
60
  # Selector specifying which fields to include in a partial response.
61
61
  # @param [String] quota_user
@@ -84,12 +84,12 @@ module Google
84
84
  execute_or_queue_command(command, &block)
85
85
  end
86
86
 
87
- # Gets the access control policy for an Organization resource. May be empty
88
- # if no such policy or resource exists. The `resource` field should be the
87
+ # Gets the access control policy for an Organization resource. May be empty if
88
+ # no such policy or resource exists. The `resource` field should be the
89
89
  # organization's resource name, e.g. "organizations/123".
90
90
  # @param [String] resource
91
- # REQUIRED: The resource for which the policy is being requested.
92
- # See the operation documentation for the appropriate value for this field.
91
+ # REQUIRED: The resource for which the policy is being requested. See the
92
+ # operation documentation for the appropriate value for this field.
93
93
  # @param [Google::Apis::CloudresourcemanagerV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
94
94
  # @param [String] fields
95
95
  # Selector specifying which fields to include in a partial response.
@@ -120,26 +120,23 @@ module Google
120
120
  execute_or_queue_command(command, &block)
121
121
  end
122
122
 
123
- # Lists Organization resources that are visible to the user and satisfy
124
- # the specified filter. This method returns Organizations in an unspecified
125
- # order. New Organizations do not necessarily appear at the end of the list.
123
+ # Lists Organization resources that are visible to the user and satisfy the
124
+ # specified filter. This method returns Organizations in an unspecified order.
125
+ # New Organizations do not necessarily appear at the end of the list.
126
126
  # @param [String] filter
127
- # An optional query string used to filter the Organizations to return in
128
- # the response. Filter rules are case-insensitive.
129
- # Organizations may be filtered by `owner.directoryCustomerId` or by
130
- # `domain`, where the domain is a G Suite domain, for example:
131
- # * Filter `owner.directorycustomerid:123456789` returns Organization
132
- # resources with `owner.directory_customer_id` equal to `123456789`.
133
- # * Filter `domain:google.com` returns Organization resources corresponding
134
- # to the domain `google.com`.
135
- # This field is optional.
127
+ # An optional query string used to filter the Organizations to return in the
128
+ # response. Filter rules are case-insensitive. Organizations may be filtered by `
129
+ # owner.directoryCustomerId` or by `domain`, where the domain is a G Suite
130
+ # domain, for example: * Filter `owner.directorycustomerid:123456789` returns
131
+ # Organization resources with `owner.directory_customer_id` equal to `123456789`.
132
+ # * Filter `domain:google.com` returns Organization resources corresponding to
133
+ # the domain `google.com`. This field is optional.
136
134
  # @param [Fixnum] page_size
137
- # The maximum number of Organizations to return in the response.
138
- # This field is optional.
135
+ # The maximum number of Organizations to return in the response. This field is
136
+ # optional.
139
137
  # @param [String] page_token
140
- # A pagination token returned from a previous call to `ListOrganizations`
141
- # that indicates from where listing should continue.
142
- # This field is optional.
138
+ # A pagination token returned from a previous call to `ListOrganizations` that
139
+ # indicates from where listing should continue. This field is optional.
143
140
  # @param [String] fields
144
141
  # Selector specifying which fields to include in a partial response.
145
142
  # @param [String] quota_user
@@ -173,8 +170,8 @@ module Google
173
170
  # existing policy. The `resource` field should be the organization's resource
174
171
  # name, e.g. "organizations/123".
175
172
  # @param [String] resource
176
- # REQUIRED: The resource for which the policy is being specified.
177
- # See the operation documentation for the appropriate value for this field.
173
+ # REQUIRED: The resource for which the policy is being specified. See the
174
+ # operation documentation for the appropriate value for this field.
178
175
  # @param [Google::Apis::CloudresourcemanagerV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
179
176
  # @param [String] fields
180
177
  # Selector specifying which fields to include in a partial response.
@@ -205,12 +202,12 @@ module Google
205
202
  execute_or_queue_command(command, &block)
206
203
  end
207
204
 
208
- # Returns permissions that a caller has on the specified Organization.
209
- # The `resource` field should be the organization's resource name,
210
- # e.g. "organizations/123".
205
+ # Returns permissions that a caller has on the specified Organization. The `
206
+ # resource` field should be the organization's resource name, e.g. "
207
+ # organizations/123".
211
208
  # @param [String] resource
212
- # REQUIRED: The resource for which the policy detail is being requested.
213
- # See the operation documentation for the appropriate value for this field.
209
+ # REQUIRED: The resource for which the policy detail is being requested. See the
210
+ # operation documentation for the appropriate value for this field.
214
211
  # @param [Google::Apis::CloudresourcemanagerV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
215
212
  # @param [String] fields
216
213
  # Selector specifying which fields to include in a partial response.
@@ -243,9 +240,9 @@ module Google
243
240
 
244
241
  # Updates an Organization resource identified by the specified resource name.
245
242
  # @param [String] name
246
- # Output only. The resource name of the organization. This is the
247
- # organization's relative path in the API. Its format is
248
- # "organizations/[organization_id]". For example, "organizations/1234".
243
+ # Output only. The resource name of the organization. This is the organization's
244
+ # relative path in the API. Its format is "organizations/[organization_id]". For
245
+ # example, "organizations/1234".
249
246
  # @param [Google::Apis::CloudresourcemanagerV1beta1::Organization] organization_object
250
247
  # @param [String] fields
251
248
  # Selector specifying which fields to include in a partial response.
@@ -276,18 +273,15 @@ module Google
276
273
  execute_or_queue_command(command, &block)
277
274
  end
278
275
 
279
- # Creates a Project resource.
280
- # Initially, the Project resource is owned by its creator exclusively.
281
- # The creator can later grant permission to others to read or update the
282
- # Project.
283
- # Several APIs are activated automatically for the Project, including
284
- # Google Cloud Storage. The parent is identified by a specified
285
- # ResourceId, which must include both an ID and a type, such as
286
- # project, folder, or organization.
287
- # This method does not associate the new project with a billing account.
288
- # You can set or update the billing account associated with a project using
289
- # the [`projects.updateBillingInfo`]
290
- # (/billing/reference/rest/v1/projects/updateBillingInfo) method.
276
+ # Creates a Project resource. Initially, the Project resource is owned by its
277
+ # creator exclusively. The creator can later grant permission to others to read
278
+ # or update the Project. Several APIs are activated automatically for the
279
+ # Project, including Google Cloud Storage. The parent is identified by a
280
+ # specified ResourceId, which must include both an ID and a type, such as
281
+ # project, folder, or organization. This method does not associate the new
282
+ # project with a billing account. You can set or update the billing account
283
+ # associated with a project using the [`projects.updateBillingInfo`] (/billing/
284
+ # reference/rest/v1/projects/updateBillingInfo) method.
291
285
  # @param [Google::Apis::CloudresourcemanagerV1beta1::Project] project_object
292
286
  # @param [Boolean] use_legacy_stack
293
287
  # A now unused experiment opt-out option.
@@ -320,27 +314,18 @@ module Google
320
314
  execute_or_queue_command(command, &block)
321
315
  end
322
316
 
323
- # Marks the Project identified by the specified
324
- # `project_id` (for example, `my-project-123`) for deletion.
325
- # This method will only affect the Project if it has a lifecycle state of
326
- # ACTIVE.
327
- # This method changes the Project's lifecycle state from
328
- # ACTIVE
329
- # to DELETE_REQUESTED.
330
- # The deletion starts at an unspecified time, at which point the project is
331
- # no longer accessible.
332
- # Until the deletion completes, you can check the lifecycle state
333
- # checked by retrieving the Project with GetProject,
334
- # and the Project remains visible to ListProjects.
335
- # However, you cannot update the project.
336
- # After the deletion completes, the Project is not retrievable by
337
- # the GetProject
338
- # and ListProjects
339
- # methods.
340
- # The caller must have modify permissions for this Project.
317
+ # Marks the Project identified by the specified `project_id` (for example, `my-
318
+ # project-123`) for deletion. This method will only affect the Project if it has
319
+ # a lifecycle state of ACTIVE. This method changes the Project's lifecycle state
320
+ # from ACTIVE to DELETE_REQUESTED. The deletion starts at an unspecified time,
321
+ # at which point the project is no longer accessible. Until the deletion
322
+ # completes, you can check the lifecycle state checked by retrieving the Project
323
+ # with GetProject, and the Project remains visible to ListProjects. However, you
324
+ # cannot update the project. After the deletion completes, the Project is not
325
+ # retrievable by the GetProject and ListProjects methods. The caller must have
326
+ # modify permissions for this Project.
341
327
  # @param [String] project_id
342
- # The Project ID (for example, `foo-bar-123`).
343
- # Required.
328
+ # The Project ID (for example, `foo-bar-123`). Required.
344
329
  # @param [String] fields
345
330
  # Selector specifying which fields to include in a partial response.
346
331
  # @param [String] quota_user
@@ -368,12 +353,10 @@ module Google
368
353
  execute_or_queue_command(command, &block)
369
354
  end
370
355
 
371
- # Retrieves the Project identified by the specified
372
- # `project_id` (for example, `my-project-123`).
373
- # The caller must have read permissions for this Project.
356
+ # Retrieves the Project identified by the specified `project_id` (for example, `
357
+ # my-project-123`). The caller must have read permissions for this Project.
374
358
  # @param [String] project_id
375
- # The Project ID (for example, `my-project-123`).
376
- # Required.
359
+ # The Project ID (for example, `my-project-123`). Required.
377
360
  # @param [String] fields
378
361
  # Selector specifying which fields to include in a partial response.
379
362
  # @param [String] quota_user
@@ -401,12 +384,11 @@ module Google
401
384
  execute_or_queue_command(command, &block)
402
385
  end
403
386
 
404
- # Gets a list of ancestors in the resource hierarchy for the Project
405
- # identified by the specified `project_id` (for example, `my-project-123`).
406
- # The caller must have read permissions for this Project.
387
+ # Gets a list of ancestors in the resource hierarchy for the Project identified
388
+ # by the specified `project_id` (for example, `my-project-123`). The caller must
389
+ # have read permissions for this Project.
407
390
  # @param [String] project_id
408
- # The Project ID (for example, `my-project-123`).
409
- # Required.
391
+ # The Project ID (for example, `my-project-123`). Required.
410
392
  # @param [Google::Apis::CloudresourcemanagerV1beta1::GetAncestryRequest] get_ancestry_request_object
411
393
  # @param [String] fields
412
394
  # Selector specifying which fields to include in a partial response.
@@ -437,13 +419,13 @@ module Google
437
419
  execute_or_queue_command(command, &block)
438
420
  end
439
421
 
440
- # Returns the IAM access control policy for the specified Project.
441
- # Permission is denied if the policy or the resource does not exist.
442
- # For additional information about resource structure and identification,
443
- # see [Resource Names](/apis/design/resource_names).
422
+ # Returns the IAM access control policy for the specified Project. Permission is
423
+ # denied if the policy or the resource does not exist. For additional
424
+ # information about resource structure and identification, see [Resource Names](/
425
+ # apis/design/resource_names).
444
426
  # @param [String] resource
445
- # REQUIRED: The resource for which the policy is being requested.
446
- # See the operation documentation for the appropriate value for this field.
427
+ # REQUIRED: The resource for which the policy is being requested. See the
428
+ # operation documentation for the appropriate value for this field.
447
429
  # @param [Google::Apis::CloudresourcemanagerV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
448
430
  # @param [String] fields
449
431
  # Selector specifying which fields to include in a partial response.
@@ -475,56 +457,42 @@ module Google
475
457
  end
476
458
 
477
459
  # Lists Projects that the caller has the `resourcemanager.projects.get`
478
- # permission on and satisfy the specified filter.
479
- # This method returns Projects in an unspecified order.
480
- # This method is eventually consistent with project mutations; this means
481
- # that a newly created project may not appear in the results or recent
482
- # updates to an existing project may not be reflected in the results. To
483
- # retrieve the latest state of a project, use the
484
- # GetProject method.
485
- # NOTE: If the request filter contains a `parent.type` and `parent.id` and
486
- # the caller has the `resourcemanager.projects.list` permission on the
487
- # parent, the results will be drawn from an alternate index which provides
488
- # more consistent results. In future versions of this API, this List method
489
- # will be split into List and Search to properly capture the behavorial
490
- # difference.
460
+ # permission on and satisfy the specified filter. This method returns Projects
461
+ # in an unspecified order. This method is eventually consistent with project
462
+ # mutations; this means that a newly created project may not appear in the
463
+ # results or recent updates to an existing project may not be reflected in the
464
+ # results. To retrieve the latest state of a project, use the GetProject method.
465
+ # NOTE: If the request filter contains a `parent.type` and `parent.id` and the
466
+ # caller has the `resourcemanager.projects.list` permission on the parent, the
467
+ # results will be drawn from an alternate index which provides more consistent
468
+ # results. In future versions of this API, this List method will be split into
469
+ # List and Search to properly capture the behavorial difference.
491
470
  # @param [String] filter
492
- # An expression for filtering the results of the request. Filter rules are
493
- # case insensitive. The fields eligible for filtering are:
494
- # + `name`
495
- # + `id`
496
- # + `labels.<key>` (where *key* is the name of a label)
497
- # + `parent.type`
498
- # + `parent.id`
499
- # Some examples of using labels as filters:
500
- # | Filter | Description |
501
- # |------------------|-----------------------------------------------------|
502
- # | name:how* | The project's name starts with "how". |
503
- # | name:Howl | The project's name is `Howl` or `howl`. |
504
- # | name:HOWL | Equivalent to above. |
505
- # | NAME:howl | Equivalent to above. |
506
- # | labels.color:* | The project has the label `color`. |
507
- # | labels.color:red | The project's label `color` has the value `red`. |
508
- # | labels.color:red&nbsp;labels.size:big |The project's label `color` has
509
- # the value `red` and its label `size` has the value `big`. |
510
- # If no filter is specified, the call will return projects for which the user
511
- # has the `resourcemanager.projects.get` permission.
512
- # NOTE: To perform a by-parent query (eg., what projects are directly in a
513
- # Folder), the caller must have the `resourcemanager.projects.list`
514
- # permission on the parent and the filter must contain both a `parent.type`
515
- # and a `parent.id` restriction
516
- # (example: "parent.type:folder parent.id:123"). In this case an alternate
517
- # search index is used which provides more consistent results.
518
- # Optional.
471
+ # An expression for filtering the results of the request. Filter rules are case
472
+ # insensitive. The fields eligible for filtering are: + `name` + `id` + `labels.`
473
+ # (where *key* is the name of a label) + `parent.type` + `parent.id` Some
474
+ # examples of using labels as filters: | Filter | Description | |----------------
475
+ # --|-----------------------------------------------------| | name:how* | The
476
+ # project's name starts with "how". | | name:Howl | The project's name is `Howl`
477
+ # or `howl`. | | name:HOWL | Equivalent to above. | | NAME:howl | Equivalent to
478
+ # above. | | labels.color:* | The project has the label `color`. | | labels.
479
+ # color:red | The project's label `color` has the value `red`. | | labels.color:
480
+ # red labels.size:big |The project's label `color` has the value `red` and its
481
+ # label `size` has the value `big`. | If no filter is specified, the call will
482
+ # return projects for which the user has the `resourcemanager.projects.get`
483
+ # permission. NOTE: To perform a by-parent query (eg., what projects are
484
+ # directly in a Folder), the caller must have the `resourcemanager.projects.list`
485
+ # permission on the parent and the filter must contain both a `parent.type` and
486
+ # a `parent.id` restriction (example: "parent.type:folder parent.id:123"). In
487
+ # this case an alternate search index is used which provides more consistent
488
+ # results. Optional.
519
489
  # @param [Fixnum] page_size
520
- # The maximum number of Projects to return in the response.
521
- # The server can return fewer Projects than requested.
522
- # If unspecified, server picks an appropriate default.
523
- # Optional.
490
+ # The maximum number of Projects to return in the response. The server can
491
+ # return fewer Projects than requested. If unspecified, server picks an
492
+ # appropriate default. Optional.
524
493
  # @param [String] page_token
525
- # A pagination token returned from a previous call to ListProjects
526
- # that indicates from where listing should continue.
527
- # Optional.
494
+ # A pagination token returned from a previous call to ListProjects that
495
+ # indicates from where listing should continue. Optional.
528
496
  # @param [String] fields
529
497
  # Selector specifying which fields to include in a partial response.
530
498
  # @param [String] quota_user
@@ -554,42 +522,36 @@ module Google
554
522
  execute_or_queue_command(command, &block)
555
523
  end
556
524
 
557
- # Sets the IAM access control policy for the specified Project.
558
- # CAUTION: This method will replace the existing policy, and cannot be used
559
- # to append additional IAM settings.
560
- # NOTE: Removing service accounts from policies or changing their roles can
561
- # render services completely inoperable. It is important to understand how
562
- # the service account is being used before removing or updating its roles.
563
- # The following constraints apply when using `setIamPolicy()`:
564
- # + Project does not support `allUsers` and `allAuthenticatedUsers` as
565
- # `members` in a `Binding` of a `Policy`.
566
- # + The owner role can be granted to a `user`, `serviceAccount`, or a group
567
- # that is part of an organization. For example,
568
- # group@myownpersonaldomain.com could be added as an owner to a project in
569
- # the myownpersonaldomain.com organization, but not the examplepetstore.com
570
- # organization.
571
- # + Service accounts can be made owners of a project directly
572
- # without any restrictions. However, to be added as an owner, a user must be
573
- # invited via Cloud Platform console and must accept the invitation.
525
+ # Sets the IAM access control policy for the specified Project. CAUTION: This
526
+ # method will replace the existing policy, and cannot be used to append
527
+ # additional IAM settings. NOTE: Removing service accounts from policies or
528
+ # changing their roles can render services completely inoperable. It is
529
+ # important to understand how the service account is being used before removing
530
+ # or updating its roles. The following constraints apply when using `
531
+ # setIamPolicy()`: + Project does not support `allUsers` and `
532
+ # allAuthenticatedUsers` as `members` in a `Binding` of a `Policy`. + The owner
533
+ # role can be granted to a `user`, `serviceAccount`, or a group that is part of
534
+ # an organization. For example, group@myownpersonaldomain.com could be added as
535
+ # an owner to a project in the myownpersonaldomain.com organization, but not the
536
+ # examplepetstore.com organization. + Service accounts can be made owners of a
537
+ # project directly without any restrictions. However, to be added as an owner, a
538
+ # user must be invited via Cloud Platform console and must accept the invitation.
574
539
  # + A user cannot be granted the owner role using `setIamPolicy()`. The user
575
540
  # must be granted the owner role using the Cloud Platform Console and must
576
- # explicitly accept the invitation.
577
- # + Invitations to grant the owner role cannot be sent using
578
- # `setIamPolicy()`; they must be sent only using the Cloud Platform Console.
579
- # + Membership changes that leave the project without any owners that have
580
- # accepted the Terms of Service (ToS) will be rejected.
581
- # + If the project is not part of an organization, there must be at least
582
- # one owner who has accepted the Terms of Service (ToS) agreement in the
583
- # policy. Calling `setIamPolicy()` to remove the last ToS-accepted owner
584
- # from the policy will fail. This restriction also applies to legacy
585
- # projects that no longer have owners who have accepted the ToS. Edits to
586
- # IAM policies will be rejected until the lack of a ToS-accepting owner is
587
- # rectified.
588
- # Authorization requires the Google IAM permission
589
- # `resourcemanager.projects.setIamPolicy` on the project
541
+ # explicitly accept the invitation. + Invitations to grant the owner role cannot
542
+ # be sent using `setIamPolicy()`; they must be sent only using the Cloud
543
+ # Platform Console. + Membership changes that leave the project without any
544
+ # owners that have accepted the Terms of Service (ToS) will be rejected. + If
545
+ # the project is not part of an organization, there must be at least one owner
546
+ # who has accepted the Terms of Service (ToS) agreement in the policy. Calling `
547
+ # setIamPolicy()` to remove the last ToS-accepted owner from the policy will
548
+ # fail. This restriction also applies to legacy projects that no longer have
549
+ # owners who have accepted the ToS. Edits to IAM policies will be rejected until
550
+ # the lack of a ToS-accepting owner is rectified. Authorization requires the
551
+ # Google IAM permission `resourcemanager.projects.setIamPolicy` on the project
590
552
  # @param [String] resource
591
- # REQUIRED: The resource for which the policy is being specified.
592
- # See the operation documentation for the appropriate value for this field.
553
+ # REQUIRED: The resource for which the policy is being specified. See the
554
+ # operation documentation for the appropriate value for this field.
593
555
  # @param [Google::Apis::CloudresourcemanagerV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
594
556
  # @param [String] fields
595
557
  # Selector specifying which fields to include in a partial response.
@@ -622,8 +584,8 @@ module Google
622
584
 
623
585
  # Returns permissions that a caller has on the specified Project.
624
586
  # @param [String] resource
625
- # REQUIRED: The resource for which the policy detail is being requested.
626
- # See the operation documentation for the appropriate value for this field.
587
+ # REQUIRED: The resource for which the policy detail is being requested. See the
588
+ # operation documentation for the appropriate value for this field.
627
589
  # @param [Google::Apis::CloudresourcemanagerV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
628
590
  # @param [String] fields
629
591
  # Selector specifying which fields to include in a partial response.
@@ -654,15 +616,12 @@ module Google
654
616
  execute_or_queue_command(command, &block)
655
617
  end
656
618
 
657
- # Restores the Project identified by the specified
658
- # `project_id` (for example, `my-project-123`).
659
- # You can only use this method for a Project that has a lifecycle state of
660
- # DELETE_REQUESTED.
661
- # After deletion starts, the Project cannot be restored.
662
- # The caller must have modify permissions for this Project.
619
+ # Restores the Project identified by the specified `project_id` (for example, `
620
+ # my-project-123`). You can only use this method for a Project that has a
621
+ # lifecycle state of DELETE_REQUESTED. After deletion starts, the Project cannot
622
+ # be restored. The caller must have modify permissions for this Project.
663
623
  # @param [String] project_id
664
- # The project ID (for example, `foo-bar-123`).
665
- # Required.
624
+ # The project ID (for example, `foo-bar-123`). Required.
666
625
  # @param [Google::Apis::CloudresourcemanagerV1beta1::UndeleteProjectRequest] undelete_project_request_object
667
626
  # @param [String] fields
668
627
  # Selector specifying which fields to include in a partial response.
@@ -693,12 +652,11 @@ module Google
693
652
  execute_or_queue_command(command, &block)
694
653
  end
695
654
 
696
- # Updates the attributes of the Project identified by the specified
697
- # `project_id` (for example, `my-project-123`).
698
- # The caller must have modify permissions for this Project.
655
+ # Updates the attributes of the Project identified by the specified `project_id`
656
+ # (for example, `my-project-123`). The caller must have modify permissions for
657
+ # this Project.
699
658
  # @param [String] project_id
700
- # The project ID (for example, `my-project-123`).
701
- # Required.
659
+ # The project ID (for example, `my-project-123`). Required.
702
660
  # @param [Google::Apis::CloudresourcemanagerV1beta1::Project] project_object
703
661
  # @param [String] fields
704
662
  # Selector specifying which fields to include in a partial response.
@@ -26,7 +26,7 @@ module Google
26
26
  # @see https://cloud.google.com/resource-manager
27
27
  module CloudresourcemanagerV2
28
28
  VERSION = 'V2'
29
- REVISION = '20200617'
29
+ REVISION = '20200720'
30
30
 
31
31
  # View and manage your data across Google Cloud Platform services
32
32
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -22,53 +22,21 @@ module Google
22
22
  module Apis
23
23
  module CloudresourcemanagerV2
24
24
 
25
- # Specifies the audit configuration for a service.
26
- # The configuration determines which permission types are logged, and what
27
- # identities, if any, are exempted from logging.
28
- # An AuditConfig must have one or more AuditLogConfigs.
29
- # If there are AuditConfigs for both `allServices` and a specific service,
30
- # the union of the two AuditConfigs is used for that service: the log_types
31
- # specified in each AuditConfig are enabled, and the exempted_members in each
32
- # AuditLogConfig are exempted.
33
- # Example Policy with multiple AuditConfigs:
34
- # `
35
- # "audit_configs": [
36
- # `
37
- # "service": "allServices",
38
- # "audit_log_configs": [
39
- # `
40
- # "log_type": "DATA_READ",
41
- # "exempted_members": [
42
- # "user:jose@example.com"
43
- # ]
44
- # `,
45
- # `
46
- # "log_type": "DATA_WRITE"
47
- # `,
48
- # `
49
- # "log_type": "ADMIN_READ"
50
- # `
51
- # ]
52
- # `,
53
- # `
54
- # "service": "sampleservice.googleapis.com",
55
- # "audit_log_configs": [
56
- # `
57
- # "log_type": "DATA_READ"
58
- # `,
59
- # `
60
- # "log_type": "DATA_WRITE",
61
- # "exempted_members": [
62
- # "user:aliya@example.com"
63
- # ]
64
- # `
65
- # ]
66
- # `
67
- # ]
68
- # `
69
- # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
70
- # logging. It also exempts jose@example.com from DATA_READ logging, and
71
- # aliya@example.com from DATA_WRITE logging.
25
+ # Specifies the audit configuration for a service. The configuration determines
26
+ # which permission types are logged, and what identities, if any, are exempted
27
+ # from logging. An AuditConfig must have one or more AuditLogConfigs. If there
28
+ # are AuditConfigs for both `allServices` and a specific service, the union of
29
+ # the two AuditConfigs is used for that service: the log_types specified in each
30
+ # AuditConfig are enabled, and the exempted_members in each AuditLogConfig are
31
+ # exempted. Example Policy with multiple AuditConfigs: ` "audit_configs": [ ` "
32
+ # service": "allServices", "audit_log_configs": [ ` "log_type": "DATA_READ", "
33
+ # exempted_members": [ "user:jose@example.com" ] `, ` "log_type": "DATA_WRITE" `,
34
+ # ` "log_type": "ADMIN_READ" ` ] `, ` "service": "sampleservice.googleapis.com",
35
+ # "audit_log_configs": [ ` "log_type": "DATA_READ" `, ` "log_type": "DATA_WRITE"
36
+ # , "exempted_members": [ "user:aliya@example.com" ] ` ] ` ] ` For sampleservice,
37
+ # this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also
38
+ # exempts jose@example.com from DATA_READ logging, and aliya@example.com from
39
+ # DATA_WRITE logging.
72
40
  class AuditConfig
73
41
  include Google::Apis::Core::Hashable
74
42
 
@@ -77,9 +45,9 @@ module Google
77
45
  # @return [Array<Google::Apis::CloudresourcemanagerV2::AuditLogConfig>]
78
46
  attr_accessor :audit_log_configs
79
47
 
80
- # Specifies a service that will be enabled for audit logging.
81
- # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
82
- # `allServices` is a special value that covers all services.
48
+ # Specifies a service that will be enabled for audit logging. For example, `
49
+ # storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special
50
+ # value that covers all services.
83
51
  # Corresponds to the JSON property `service`
84
52
  # @return [String]
85
53
  attr_accessor :service
@@ -95,28 +63,15 @@ module Google
95
63
  end
96
64
  end
97
65
 
98
- # Provides the configuration for logging a type of permissions.
99
- # Example:
100
- # `
101
- # "audit_log_configs": [
102
- # `
103
- # "log_type": "DATA_READ",
104
- # "exempted_members": [
105
- # "user:jose@example.com"
106
- # ]
107
- # `,
108
- # `
109
- # "log_type": "DATA_WRITE"
110
- # `
111
- # ]
112
- # `
113
- # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
114
- # jose@example.com from DATA_READ logging.
66
+ # Provides the configuration for logging a type of permissions. Example: ` "
67
+ # audit_log_configs": [ ` "log_type": "DATA_READ", "exempted_members": [ "user:
68
+ # jose@example.com" ] `, ` "log_type": "DATA_WRITE" ` ] ` This enables '
69
+ # DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from
70
+ # DATA_READ logging.
115
71
  class AuditLogConfig
116
72
  include Google::Apis::Core::Hashable
117
73
 
118
- # Specifies the identities that do not cause logging for this type of
119
- # permission.
74
+ # Specifies the identities that do not cause logging for this type of permission.
120
75
  # Follows the same format of Binding.members.
121
76
  # Corresponds to the JSON property `exemptedMembers`
122
77
  # @return [Array<String>]
@@ -142,69 +97,57 @@ module Google
142
97
  class Binding
143
98
  include Google::Apis::Core::Hashable
144
99
 
145
- # Represents a textual expression in the Common Expression Language (CEL)
146
- # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
147
- # are documented at https://github.com/google/cel-spec.
148
- # Example (Comparison):
149
- # title: "Summary size limit"
150
- # description: "Determines if a summary is less than 100 chars"
151
- # expression: "document.summary.size() < 100"
152
- # Example (Equality):
153
- # title: "Requestor is owner"
154
- # description: "Determines if requestor is the document owner"
155
- # expression: "document.owner == request.auth.claims.email"
156
- # Example (Logic):
157
- # title: "Public documents"
158
- # description: "Determine whether the document should be publicly visible"
159
- # expression: "document.type != 'private' && document.type != 'internal'"
160
- # Example (Data Manipulation):
161
- # title: "Notification string"
162
- # description: "Create a notification string with a timestamp."
163
- # expression: "'New message received at ' + string(document.create_time)"
164
- # The exact variables and functions that may be referenced within an expression
165
- # are determined by the service that evaluates it. See the service
166
- # documentation for additional information.
100
+ # Represents a textual expression in the Common Expression Language (CEL) syntax.
101
+ # CEL is a C-like expression language. The syntax and semantics of CEL are
102
+ # documented at https://github.com/google/cel-spec. Example (Comparison): title:
103
+ # "Summary size limit" description: "Determines if a summary is less than 100
104
+ # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
105
+ # Requestor is owner" description: "Determines if requestor is the document
106
+ # owner" expression: "document.owner == request.auth.claims.email" Example (
107
+ # Logic): title: "Public documents" description: "Determine whether the document
108
+ # should be publicly visible" expression: "document.type != 'private' &&
109
+ # document.type != 'internal'" Example (Data Manipulation): title: "Notification
110
+ # string" description: "Create a notification string with a timestamp."
111
+ # expression: "'New message received at ' + string(document.create_time)" The
112
+ # exact variables and functions that may be referenced within an expression are
113
+ # determined by the service that evaluates it. See the service documentation for
114
+ # additional information.
167
115
  # Corresponds to the JSON property `condition`
168
116
  # @return [Google::Apis::CloudresourcemanagerV2::Expr]
169
117
  attr_accessor :condition
170
118
 
171
- # Specifies the identities requesting access for a Cloud Platform resource.
172
- # `members` can have the following values:
173
- # * `allUsers`: A special identifier that represents anyone who is
174
- # on the internet; with or without a Google account.
175
- # * `allAuthenticatedUsers`: A special identifier that represents anyone
176
- # who is authenticated with a Google account or a service account.
177
- # * `user:`emailid``: An email address that represents a specific Google
178
- # account. For example, `alice@example.com` .
179
- # * `serviceAccount:`emailid``: An email address that represents a service
180
- # account. For example, `my-other-app@appspot.gserviceaccount.com`.
181
- # * `group:`emailid``: An email address that represents a Google group.
182
- # For example, `admins@example.com`.
183
- # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
184
- # identifier) representing a user that has been recently deleted. For
185
- # example, `alice@example.com?uid=123456789012345678901`. If the user is
186
- # recovered, this value reverts to `user:`emailid`` and the recovered user
187
- # retains the role in the binding.
188
- # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
189
- # unique identifier) representing a service account that has been recently
190
- # deleted. For example,
191
- # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
192
- # If the service account is undeleted, this value reverts to
193
- # `serviceAccount:`emailid`` and the undeleted service account retains the
194
- # role in the binding.
195
- # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
196
- # identifier) representing a Google group that has been recently
197
- # deleted. For example, `admins@example.com?uid=123456789012345678901`. If
198
- # the group is recovered, this value reverts to `group:`emailid`` and the
199
- # recovered group retains the role in the binding.
200
- # * `domain:`domain``: The G Suite domain (primary) that represents all the
201
- # users of that domain. For example, `google.com` or `example.com`.
119
+ # Specifies the identities requesting access for a Cloud Platform resource. `
120
+ # members` can have the following values: * `allUsers`: A special identifier
121
+ # that represents anyone who is on the internet; with or without a Google
122
+ # account. * `allAuthenticatedUsers`: A special identifier that represents
123
+ # anyone who is authenticated with a Google account or a service account. * `
124
+ # user:`emailid``: An email address that represents a specific Google account.
125
+ # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
126
+ # address that represents a service account. For example, `my-other-app@appspot.
127
+ # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
128
+ # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid=
129
+ # `uniqueid``: An email address (plus unique identifier) representing a user
130
+ # that has been recently deleted. For example, `alice@example.com?uid=
131
+ # 123456789012345678901`. If the user is recovered, this value reverts to `user:`
132
+ # emailid`` and the recovered user retains the role in the binding. * `deleted:
133
+ # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique
134
+ # identifier) representing a service account that has been recently deleted. For
135
+ # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
136
+ # If the service account is undeleted, this value reverts to `serviceAccount:`
137
+ # emailid`` and the undeleted service account retains the role in the binding. *
138
+ # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
139
+ # identifier) representing a Google group that has been recently deleted. For
140
+ # example, `admins@example.com?uid=123456789012345678901`. If the group is
141
+ # recovered, this value reverts to `group:`emailid`` and the recovered group
142
+ # retains the role in the binding. * `domain:`domain``: The G Suite domain (
143
+ # primary) that represents all the users of that domain. For example, `google.
144
+ # com` or `example.com`.
202
145
  # Corresponds to the JSON property `members`
203
146
  # @return [Array<String>]
204
147
  attr_accessor :members
205
148
 
206
- # Role that is assigned to `members`.
207
- # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
149
+ # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
150
+ # , or `roles/owner`.
208
151
  # Corresponds to the JSON property `role`
209
152
  # @return [String]
210
153
  attr_accessor :role
@@ -221,52 +164,43 @@ module Google
221
164
  end
222
165
  end
223
166
 
224
- # Represents a textual expression in the Common Expression Language (CEL)
225
- # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
226
- # are documented at https://github.com/google/cel-spec.
227
- # Example (Comparison):
228
- # title: "Summary size limit"
229
- # description: "Determines if a summary is less than 100 chars"
230
- # expression: "document.summary.size() < 100"
231
- # Example (Equality):
232
- # title: "Requestor is owner"
233
- # description: "Determines if requestor is the document owner"
234
- # expression: "document.owner == request.auth.claims.email"
235
- # Example (Logic):
236
- # title: "Public documents"
237
- # description: "Determine whether the document should be publicly visible"
238
- # expression: "document.type != 'private' && document.type != 'internal'"
239
- # Example (Data Manipulation):
240
- # title: "Notification string"
241
- # description: "Create a notification string with a timestamp."
242
- # expression: "'New message received at ' + string(document.create_time)"
243
- # The exact variables and functions that may be referenced within an expression
244
- # are determined by the service that evaluates it. See the service
245
- # documentation for additional information.
167
+ # Represents a textual expression in the Common Expression Language (CEL) syntax.
168
+ # CEL is a C-like expression language. The syntax and semantics of CEL are
169
+ # documented at https://github.com/google/cel-spec. Example (Comparison): title:
170
+ # "Summary size limit" description: "Determines if a summary is less than 100
171
+ # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
172
+ # Requestor is owner" description: "Determines if requestor is the document
173
+ # owner" expression: "document.owner == request.auth.claims.email" Example (
174
+ # Logic): title: "Public documents" description: "Determine whether the document
175
+ # should be publicly visible" expression: "document.type != 'private' &&
176
+ # document.type != 'internal'" Example (Data Manipulation): title: "Notification
177
+ # string" description: "Create a notification string with a timestamp."
178
+ # expression: "'New message received at ' + string(document.create_time)" The
179
+ # exact variables and functions that may be referenced within an expression are
180
+ # determined by the service that evaluates it. See the service documentation for
181
+ # additional information.
246
182
  class Expr
247
183
  include Google::Apis::Core::Hashable
248
184
 
249
- # Optional. Description of the expression. This is a longer text which
250
- # describes the expression, e.g. when hovered over it in a UI.
185
+ # Optional. Description of the expression. This is a longer text which describes
186
+ # the expression, e.g. when hovered over it in a UI.
251
187
  # Corresponds to the JSON property `description`
252
188
  # @return [String]
253
189
  attr_accessor :description
254
190
 
255
- # Textual representation of an expression in Common Expression Language
256
- # syntax.
191
+ # Textual representation of an expression in Common Expression Language syntax.
257
192
  # Corresponds to the JSON property `expression`
258
193
  # @return [String]
259
194
  attr_accessor :expression
260
195
 
261
- # Optional. String indicating the location of the expression for error
262
- # reporting, e.g. a file name and a position in the file.
196
+ # Optional. String indicating the location of the expression for error reporting,
197
+ # e.g. a file name and a position in the file.
263
198
  # Corresponds to the JSON property `location`
264
199
  # @return [String]
265
200
  attr_accessor :location
266
201
 
267
- # Optional. Title for the expression, i.e. a short string describing
268
- # its purpose. This can be used e.g. in UIs which allow to enter the
269
- # expression.
202
+ # Optional. Title for the expression, i.e. a short string describing its purpose.
203
+ # This can be used e.g. in UIs which allow to enter the expression.
270
204
  # Corresponds to the JSON property `title`
271
205
  # @return [String]
272
206
  attr_accessor :title
@@ -284,8 +218,8 @@ module Google
284
218
  end
285
219
  end
286
220
 
287
- # A Folder in an Organization's resource hierarchy, used to
288
- # organize that Organization's resources.
221
+ # A Folder in an Organization's resource hierarchy, used to organize that
222
+ # Organization's resources.
289
223
  class Folder
290
224
  include Google::Apis::Core::Hashable
291
225
 
@@ -294,34 +228,30 @@ module Google
294
228
  # @return [String]
295
229
  attr_accessor :create_time
296
230
 
297
- # The folder’s display name.
298
- # A folder’s display name must be unique amongst its siblings, e.g.
299
- # no two folders with the same parent can share the same display name.
300
- # The display name must start and end with a letter or digit, may contain
301
- # letters, digits, spaces, hyphens and underscores and can be no longer
302
- # than 30 characters. This is captured by the regular expression:
303
- # [\p`L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?.
231
+ # The folder’s display name. A folder’s display name must be unique amongst its
232
+ # siblings, e.g. no two folders with the same parent can share the same display
233
+ # name. The display name must start and end with a letter or digit, may contain
234
+ # letters, digits, spaces, hyphens and underscores and can be no longer than 30
235
+ # characters. This is captured by the regular expression: [\p`L`\p`N`]([\p`L`\p`
236
+ # N`_- ]`0,28`[\p`L`\p`N`])?.
304
237
  # Corresponds to the JSON property `displayName`
305
238
  # @return [String]
306
239
  attr_accessor :display_name
307
240
 
308
- # Output only. The lifecycle state of the folder.
309
- # Updates to the lifecycle_state must be performed via
310
- # DeleteFolder and
311
- # UndeleteFolder.
241
+ # Output only. The lifecycle state of the folder. Updates to the lifecycle_state
242
+ # must be performed via DeleteFolder and UndeleteFolder.
312
243
  # Corresponds to the JSON property `lifecycleState`
313
244
  # @return [String]
314
245
  attr_accessor :lifecycle_state
315
246
 
316
- # Output only. The resource name of the Folder.
317
- # Its format is `folders/`folder_id``, for example: "folders/1234".
247
+ # Output only. The resource name of the Folder. Its format is `folders/`
248
+ # folder_id``, for example: "folders/1234".
318
249
  # Corresponds to the JSON property `name`
319
250
  # @return [String]
320
251
  attr_accessor :name
321
252
 
322
- # Required. The Folder’s parent's resource name.
323
- # Updates to the folder's parent must be performed via
324
- # MoveFolder.
253
+ # Required. The Folder’s parent's resource name. Updates to the folder's parent
254
+ # must be performed via MoveFolder.
325
255
  # Corresponds to the JSON property `parent`
326
256
  # @return [String]
327
257
  attr_accessor :parent
@@ -344,8 +274,8 @@ module Google
344
274
  class FolderOperation
345
275
  include Google::Apis::Core::Hashable
346
276
 
347
- # The resource name of the folder or organization we are either creating
348
- # the folder under or moving the folder to.
277
+ # The resource name of the folder or organization we are either creating the
278
+ # folder under or moving the folder to.
349
279
  # Corresponds to the JSON property `destinationParent`
350
280
  # @return [String]
351
281
  attr_accessor :destination_parent
@@ -360,8 +290,8 @@ module Google
360
290
  # @return [String]
361
291
  attr_accessor :operation_type
362
292
 
363
- # The resource name of the folder's parent.
364
- # Only applicable when the operation_type is MOVE.
293
+ # The resource name of the folder's parent. Only applicable when the
294
+ # operation_type is MOVE.
365
295
  # Corresponds to the JSON property `sourceParent`
366
296
  # @return [String]
367
297
  attr_accessor :source_parent
@@ -421,15 +351,13 @@ module Google
421
351
  class GetPolicyOptions
422
352
  include Google::Apis::Core::Hashable
423
353
 
424
- # Optional. The policy format version to be returned.
425
- # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
426
- # rejected.
427
- # Requests for policies with any conditional bindings must specify version 3.
428
- # Policies without any conditional bindings may specify any valid value or
429
- # leave the field unset.
430
- # To learn which resources support conditions in their IAM policies, see the
431
- # [IAM
432
- # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
354
+ # Optional. The policy format version to be returned. Valid values are 0, 1, and
355
+ # 3. Requests specifying an invalid value will be rejected. Requests for
356
+ # policies with any conditional bindings must specify version 3. Policies
357
+ # without any conditional bindings may specify any valid value or leave the
358
+ # field unset. To learn which resources support conditions in their IAM policies,
359
+ # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
360
+ # resource-policies).
433
361
  # Corresponds to the JSON property `requestedPolicyVersion`
434
362
  # @return [Fixnum]
435
363
  attr_accessor :requested_policy_version
@@ -448,14 +376,14 @@ module Google
448
376
  class ListFoldersResponse
449
377
  include Google::Apis::Core::Hashable
450
378
 
451
- # A possibly paginated list of Folders that are direct descendants of
452
- # the specified parent resource.
379
+ # A possibly paginated list of Folders that are direct descendants of the
380
+ # specified parent resource.
453
381
  # Corresponds to the JSON property `folders`
454
382
  # @return [Array<Google::Apis::CloudresourcemanagerV2::Folder>]
455
383
  attr_accessor :folders
456
384
 
457
- # A pagination token returned from a previous call to `ListFolders`
458
- # that indicates from where listing should continue.
385
+ # A pagination token returned from a previous call to `ListFolders` that
386
+ # indicates from where listing should continue.
459
387
  # Corresponds to the JSON property `nextPageToken`
460
388
  # @return [String]
461
389
  attr_accessor :next_page_token
@@ -475,9 +403,9 @@ module Google
475
403
  class MoveFolderRequest
476
404
  include Google::Apis::Core::Hashable
477
405
 
478
- # Required. The resource name of the Folder or Organization to reparent
479
- # the folder under.
480
- # Must be of the form `folders/`folder_id`` or `organizations/`org_id``.
406
+ # Required. The resource name of the Folder or Organization to reparent the
407
+ # folder under. Must be of the form `folders/`folder_id`` or `organizations/`
408
+ # org_id``.
481
409
  # Corresponds to the JSON property `destinationParent`
482
410
  # @return [String]
483
411
  attr_accessor :destination_parent
@@ -497,47 +425,45 @@ module Google
497
425
  class Operation
498
426
  include Google::Apis::Core::Hashable
499
427
 
500
- # If the value is `false`, it means the operation is still in progress.
501
- # If `true`, the operation is completed, and either `error` or `response` is
502
- # available.
428
+ # If the value is `false`, it means the operation is still in progress. If `true`
429
+ # , the operation is completed, and either `error` or `response` is available.
503
430
  # Corresponds to the JSON property `done`
504
431
  # @return [Boolean]
505
432
  attr_accessor :done
506
433
  alias_method :done?, :done
507
434
 
508
- # The `Status` type defines a logical error model that is suitable for
509
- # different programming environments, including REST APIs and RPC APIs. It is
510
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
511
- # three pieces of data: error code, error message, and error details.
512
- # You can find out more about this error model and how to work with it in the
513
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
435
+ # The `Status` type defines a logical error model that is suitable for different
436
+ # programming environments, including REST APIs and RPC APIs. It is used by [
437
+ # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
438
+ # data: error code, error message, and error details. You can find out more
439
+ # about this error model and how to work with it in the [API Design Guide](https:
440
+ # //cloud.google.com/apis/design/errors).
514
441
  # Corresponds to the JSON property `error`
515
442
  # @return [Google::Apis::CloudresourcemanagerV2::Status]
516
443
  attr_accessor :error
517
444
 
518
- # Service-specific metadata associated with the operation. It typically
519
- # contains progress information and common metadata such as create time.
520
- # Some services might not provide such metadata. Any method that returns a
521
- # long-running operation should document the metadata type, if any.
445
+ # Service-specific metadata associated with the operation. It typically contains
446
+ # progress information and common metadata such as create time. Some services
447
+ # might not provide such metadata. Any method that returns a long-running
448
+ # operation should document the metadata type, if any.
522
449
  # Corresponds to the JSON property `metadata`
523
450
  # @return [Hash<String,Object>]
524
451
  attr_accessor :metadata
525
452
 
526
453
  # The server-assigned name, which is only unique within the same service that
527
- # originally returns it. If you use the default HTTP mapping, the
528
- # `name` should be a resource name ending with `operations/`unique_id``.
454
+ # originally returns it. If you use the default HTTP mapping, the `name` should
455
+ # be a resource name ending with `operations/`unique_id``.
529
456
  # Corresponds to the JSON property `name`
530
457
  # @return [String]
531
458
  attr_accessor :name
532
459
 
533
- # The normal response of the operation in case of success. If the original
534
- # method returns no data on success, such as `Delete`, the response is
535
- # `google.protobuf.Empty`. If the original method is standard
536
- # `Get`/`Create`/`Update`, the response should be the resource. For other
537
- # methods, the response should have the type `XxxResponse`, where `Xxx`
538
- # is the original method name. For example, if the original method name
539
- # is `TakeSnapshot()`, the inferred response type is
540
- # `TakeSnapshotResponse`.
460
+ # The normal response of the operation in case of success. If the original
461
+ # method returns no data on success, such as `Delete`, the response is `google.
462
+ # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
463
+ # the response should be the resource. For other methods, the response should
464
+ # have the type `XxxResponse`, where `Xxx` is the original method name. For
465
+ # example, if the original method name is `TakeSnapshot()`, the inferred
466
+ # response type is `TakeSnapshotResponse`.
541
467
  # Corresponds to the JSON property `response`
542
468
  # @return [Hash<String,Object>]
543
469
  attr_accessor :response
@@ -557,66 +483,32 @@ module Google
557
483
  end
558
484
 
559
485
  # An Identity and Access Management (IAM) policy, which specifies access
560
- # controls for Google Cloud resources.
561
- # A `Policy` is a collection of `bindings`. A `binding` binds one or more
562
- # `members` to a single `role`. Members can be user accounts, service accounts,
563
- # Google groups, and domains (such as G Suite). A `role` is a named list of
564
- # permissions; each `role` can be an IAM predefined role or a user-created
565
- # custom role.
566
- # For some types of Google Cloud resources, a `binding` can also specify a
567
- # `condition`, which is a logical expression that allows access to a resource
568
- # only if the expression evaluates to `true`. A condition can add constraints
569
- # based on attributes of the request, the resource, or both. To learn which
570
- # resources support conditions in their IAM policies, see the
571
- # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
572
- # policies).
573
- # **JSON example:**
574
- # `
575
- # "bindings": [
576
- # `
577
- # "role": "roles/resourcemanager.organizationAdmin",
578
- # "members": [
579
- # "user:mike@example.com",
580
- # "group:admins@example.com",
581
- # "domain:google.com",
582
- # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
583
- # ]
584
- # `,
585
- # `
586
- # "role": "roles/resourcemanager.organizationViewer",
587
- # "members": [
588
- # "user:eve@example.com"
589
- # ],
590
- # "condition": `
591
- # "title": "expirable access",
592
- # "description": "Does not grant access after Sep 2020",
593
- # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
594
- # ",
595
- # `
596
- # `
597
- # ],
598
- # "etag": "BwWWja0YfJA=",
599
- # "version": 3
600
- # `
601
- # **YAML example:**
602
- # bindings:
603
- # - members:
604
- # - user:mike@example.com
605
- # - group:admins@example.com
606
- # - domain:google.com
607
- # - serviceAccount:my-project-id@appspot.gserviceaccount.com
608
- # role: roles/resourcemanager.organizationAdmin
609
- # - members:
610
- # - user:eve@example.com
611
- # role: roles/resourcemanager.organizationViewer
612
- # condition:
613
- # title: expirable access
614
- # description: Does not grant access after Sep 2020
615
- # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
616
- # - etag: BwWWja0YfJA=
617
- # - version: 3
618
- # For a description of IAM and its features, see the
619
- # [IAM documentation](https://cloud.google.com/iam/docs/).
486
+ # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
487
+ # A `binding` binds one or more `members` to a single `role`. Members can be
488
+ # user accounts, service accounts, Google groups, and domains (such as G Suite).
489
+ # A `role` is a named list of permissions; each `role` can be an IAM predefined
490
+ # role or a user-created custom role. For some types of Google Cloud resources,
491
+ # a `binding` can also specify a `condition`, which is a logical expression that
492
+ # allows access to a resource only if the expression evaluates to `true`. A
493
+ # condition can add constraints based on attributes of the request, the resource,
494
+ # or both. To learn which resources support conditions in their IAM policies,
495
+ # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
496
+ # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
497
+ # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
498
+ # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
499
+ # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
500
+ # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
501
+ # title": "expirable access", "description": "Does not grant access after Sep
502
+ # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
503
+ # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
504
+ # members: - user:mike@example.com - group:admins@example.com - domain:google.
505
+ # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
506
+ # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
507
+ # roles/resourcemanager.organizationViewer condition: title: expirable access
508
+ # description: Does not grant access after Sep 2020 expression: request.time <
509
+ # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
510
+ # description of IAM and its features, see the [IAM documentation](https://cloud.
511
+ # google.com/iam/docs/).
620
512
  class Policy
621
513
  include Google::Apis::Core::Hashable
622
514
 
@@ -625,48 +517,44 @@ module Google
625
517
  # @return [Array<Google::Apis::CloudresourcemanagerV2::AuditConfig>]
626
518
  attr_accessor :audit_configs
627
519
 
628
- # Associates a list of `members` to a `role`. Optionally, may specify a
629
- # `condition` that determines how and when the `bindings` are applied. Each
630
- # of the `bindings` must contain at least one member.
520
+ # Associates a list of `members` to a `role`. Optionally, may specify a `
521
+ # condition` that determines how and when the `bindings` are applied. Each of
522
+ # the `bindings` must contain at least one member.
631
523
  # Corresponds to the JSON property `bindings`
632
524
  # @return [Array<Google::Apis::CloudresourcemanagerV2::Binding>]
633
525
  attr_accessor :bindings
634
526
 
635
- # `etag` is used for optimistic concurrency control as a way to help
636
- # prevent simultaneous updates of a policy from overwriting each other.
637
- # It is strongly suggested that systems make use of the `etag` in the
638
- # read-modify-write cycle to perform policy updates in order to avoid race
639
- # conditions: An `etag` is returned in the response to `getIamPolicy`, and
640
- # systems are expected to put that etag in the request to `setIamPolicy` to
641
- # ensure that their change will be applied to the same version of the policy.
642
- # **Important:** If you use IAM Conditions, you must include the `etag` field
643
- # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
644
- # you to overwrite a version `3` policy with a version `1` policy, and all of
645
- # the conditions in the version `3` policy are lost.
527
+ # `etag` is used for optimistic concurrency control as a way to help prevent
528
+ # simultaneous updates of a policy from overwriting each other. It is strongly
529
+ # suggested that systems make use of the `etag` in the read-modify-write cycle
530
+ # to perform policy updates in order to avoid race conditions: An `etag` is
531
+ # returned in the response to `getIamPolicy`, and systems are expected to put
532
+ # that etag in the request to `setIamPolicy` to ensure that their change will be
533
+ # applied to the same version of the policy. **Important:** If you use IAM
534
+ # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
535
+ # If you omit this field, then IAM allows you to overwrite a version `3` policy
536
+ # with a version `1` policy, and all of the conditions in the version `3` policy
537
+ # are lost.
646
538
  # Corresponds to the JSON property `etag`
647
539
  # NOTE: Values are automatically base64 encoded/decoded in the client library.
648
540
  # @return [String]
649
541
  attr_accessor :etag
650
542
 
651
- # Specifies the format of the policy.
652
- # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
653
- # are rejected.
654
- # Any operation that affects conditional role bindings must specify version
655
- # `3`. This requirement applies to the following operations:
656
- # * Getting a policy that includes a conditional role binding
657
- # * Adding a conditional role binding to a policy
658
- # * Changing a conditional role binding in a policy
659
- # * Removing any role binding, with or without a condition, from a policy
660
- # that includes conditions
661
- # **Important:** If you use IAM Conditions, you must include the `etag` field
662
- # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
663
- # you to overwrite a version `3` policy with a version `1` policy, and all of
664
- # the conditions in the version `3` policy are lost.
665
- # If a policy does not include any conditions, operations on that policy may
666
- # specify any valid version or leave the field unset.
667
- # To learn which resources support conditions in their IAM policies, see the
668
- # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
669
- # policies).
543
+ # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
544
+ # Requests that specify an invalid value are rejected. Any operation that
545
+ # affects conditional role bindings must specify version `3`. This requirement
546
+ # applies to the following operations: * Getting a policy that includes a
547
+ # conditional role binding * Adding a conditional role binding to a policy *
548
+ # Changing a conditional role binding in a policy * Removing any role binding,
549
+ # with or without a condition, from a policy that includes conditions **
550
+ # Important:** If you use IAM Conditions, you must include the `etag` field
551
+ # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
552
+ # to overwrite a version `3` policy with a version `1` policy, and all of the
553
+ # conditions in the version `3` policy are lost. If a policy does not include
554
+ # any conditions, operations on that policy may specify any valid version or
555
+ # leave the field unset. To learn which resources support conditions in their
556
+ # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/
557
+ # conditions/resource-policies).
670
558
  # Corresponds to the JSON property `version`
671
559
  # @return [Fixnum]
672
560
  attr_accessor :version
@@ -695,9 +583,8 @@ module Google
695
583
  # @return [String]
696
584
  attr_accessor :create_time
697
585
 
698
- # True if the project can be retrieved using GetProject. No other operations
699
- # on the project are guaranteed to work until the project creation is
700
- # complete.
586
+ # True if the project can be retrieved using GetProject. No other operations on
587
+ # the project are guaranteed to work until the project creation is complete.
701
588
  # Corresponds to the JSON property `gettable`
702
589
  # @return [Boolean]
703
590
  attr_accessor :gettable
@@ -736,25 +623,20 @@ module Google
736
623
  # @return [String]
737
624
  attr_accessor :page_token
738
625
 
739
- # Search criteria used to select the Folders to return.
740
- # If no search criteria is specified then all accessible folders will be
741
- # returned.
742
- # Query expressions can be used to restrict results based upon displayName,
743
- # lifecycleState and parent, where the operators `=`, `NOT`, `AND` and `OR`
744
- # can be used along with the suffix wildcard symbol `*`.
745
- # The displayName field in a query expression should use escaped quotes
746
- # for values that include whitespace to prevent unexpected behavior.
747
- # Some example queries are:
748
- # * Query `displayName=Test*` returns Folder resources whose display name
749
- # starts with "Test".
750
- # * Query `lifecycleState=ACTIVE` returns Folder resources with
751
- # `lifecycleState` set to `ACTIVE`.
752
- # * Query `parent=folders/123` returns Folder resources that have
753
- # `folders/123` as a parent resource.
754
- # * Query `parent=folders/123 AND lifecycleState=ACTIVE` returns active
755
- # Folder resources that have `folders/123` as a parent resource.
756
- # * Query `displayName=\\"Test String\\"` returns Folder resources with
757
- # display names that include both "Test" and "String".
626
+ # Search criteria used to select the Folders to return. If no search criteria is
627
+ # specified then all accessible folders will be returned. Query expressions can
628
+ # be used to restrict results based upon displayName, lifecycleState and parent,
629
+ # where the operators `=`, `NOT`, `AND` and `OR` can be used along with the
630
+ # suffix wildcard symbol `*`. The displayName field in a query expression should
631
+ # use escaped quotes for values that include whitespace to prevent unexpected
632
+ # behavior. Some example queries are: * Query `displayName=Test*` returns Folder
633
+ # resources whose display name starts with "Test". * Query `lifecycleState=
634
+ # ACTIVE` returns Folder resources with `lifecycleState` set to `ACTIVE`. *
635
+ # Query `parent=folders/123` returns Folder resources that have `folders/123` as
636
+ # a parent resource. * Query `parent=folders/123 AND lifecycleState=ACTIVE`
637
+ # returns active Folder resources that have `folders/123` as a parent resource. *
638
+ # Query `displayName=\\"Test String\\"` returns Folder resources with display
639
+ # names that include both "Test" and "String".
758
640
  # Corresponds to the JSON property `query`
759
641
  # @return [String]
760
642
  attr_accessor :query
@@ -775,14 +657,13 @@ module Google
775
657
  class SearchFoldersResponse
776
658
  include Google::Apis::Core::Hashable
777
659
 
778
- # A possibly paginated folder search results.
779
- # the specified parent resource.
660
+ # A possibly paginated folder search results. the specified parent resource.
780
661
  # Corresponds to the JSON property `folders`
781
662
  # @return [Array<Google::Apis::CloudresourcemanagerV2::Folder>]
782
663
  attr_accessor :folders
783
664
 
784
- # A pagination token returned from a previous call to `SearchFolders`
785
- # that indicates from where searching should continue.
665
+ # A pagination token returned from a previous call to `SearchFolders` that
666
+ # indicates from where searching should continue.
786
667
  # Corresponds to the JSON property `nextPageToken`
787
668
  # @return [String]
788
669
  attr_accessor :next_page_token
@@ -803,74 +684,39 @@ module Google
803
684
  include Google::Apis::Core::Hashable
804
685
 
805
686
  # An Identity and Access Management (IAM) policy, which specifies access
806
- # controls for Google Cloud resources.
807
- # A `Policy` is a collection of `bindings`. A `binding` binds one or more
808
- # `members` to a single `role`. Members can be user accounts, service accounts,
809
- # Google groups, and domains (such as G Suite). A `role` is a named list of
810
- # permissions; each `role` can be an IAM predefined role or a user-created
811
- # custom role.
812
- # For some types of Google Cloud resources, a `binding` can also specify a
813
- # `condition`, which is a logical expression that allows access to a resource
814
- # only if the expression evaluates to `true`. A condition can add constraints
815
- # based on attributes of the request, the resource, or both. To learn which
816
- # resources support conditions in their IAM policies, see the
817
- # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
818
- # policies).
819
- # **JSON example:**
820
- # `
821
- # "bindings": [
822
- # `
823
- # "role": "roles/resourcemanager.organizationAdmin",
824
- # "members": [
825
- # "user:mike@example.com",
826
- # "group:admins@example.com",
827
- # "domain:google.com",
828
- # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
829
- # ]
830
- # `,
831
- # `
832
- # "role": "roles/resourcemanager.organizationViewer",
833
- # "members": [
834
- # "user:eve@example.com"
835
- # ],
836
- # "condition": `
837
- # "title": "expirable access",
838
- # "description": "Does not grant access after Sep 2020",
839
- # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
840
- # ",
841
- # `
842
- # `
843
- # ],
844
- # "etag": "BwWWja0YfJA=",
845
- # "version": 3
846
- # `
847
- # **YAML example:**
848
- # bindings:
849
- # - members:
850
- # - user:mike@example.com
851
- # - group:admins@example.com
852
- # - domain:google.com
853
- # - serviceAccount:my-project-id@appspot.gserviceaccount.com
854
- # role: roles/resourcemanager.organizationAdmin
855
- # - members:
856
- # - user:eve@example.com
857
- # role: roles/resourcemanager.organizationViewer
858
- # condition:
859
- # title: expirable access
860
- # description: Does not grant access after Sep 2020
861
- # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
862
- # - etag: BwWWja0YfJA=
863
- # - version: 3
864
- # For a description of IAM and its features, see the
865
- # [IAM documentation](https://cloud.google.com/iam/docs/).
687
+ # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
688
+ # A `binding` binds one or more `members` to a single `role`. Members can be
689
+ # user accounts, service accounts, Google groups, and domains (such as G Suite).
690
+ # A `role` is a named list of permissions; each `role` can be an IAM predefined
691
+ # role or a user-created custom role. For some types of Google Cloud resources,
692
+ # a `binding` can also specify a `condition`, which is a logical expression that
693
+ # allows access to a resource only if the expression evaluates to `true`. A
694
+ # condition can add constraints based on attributes of the request, the resource,
695
+ # or both. To learn which resources support conditions in their IAM policies,
696
+ # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
697
+ # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
698
+ # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
699
+ # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
700
+ # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
701
+ # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
702
+ # title": "expirable access", "description": "Does not grant access after Sep
703
+ # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
704
+ # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
705
+ # members: - user:mike@example.com - group:admins@example.com - domain:google.
706
+ # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
707
+ # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
708
+ # roles/resourcemanager.organizationViewer condition: title: expirable access
709
+ # description: Does not grant access after Sep 2020 expression: request.time <
710
+ # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
711
+ # description of IAM and its features, see the [IAM documentation](https://cloud.
712
+ # google.com/iam/docs/).
866
713
  # Corresponds to the JSON property `policy`
867
714
  # @return [Google::Apis::CloudresourcemanagerV2::Policy]
868
715
  attr_accessor :policy
869
716
 
870
717
  # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
871
- # the fields in the mask will be modified. If no mask is provided, the
872
- # following default mask is used:
873
- # `paths: "bindings, etag"`
718
+ # the fields in the mask will be modified. If no mask is provided, the following
719
+ # default mask is used: `paths: "bindings, etag"`
874
720
  # Corresponds to the JSON property `updateMask`
875
721
  # @return [String]
876
722
  attr_accessor :update_mask
@@ -886,12 +732,12 @@ module Google
886
732
  end
887
733
  end
888
734
 
889
- # The `Status` type defines a logical error model that is suitable for
890
- # different programming environments, including REST APIs and RPC APIs. It is
891
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
892
- # three pieces of data: error code, error message, and error details.
893
- # You can find out more about this error model and how to work with it in the
894
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
735
+ # The `Status` type defines a logical error model that is suitable for different
736
+ # programming environments, including REST APIs and RPC APIs. It is used by [
737
+ # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
738
+ # data: error code, error message, and error details. You can find out more
739
+ # about this error model and how to work with it in the [API Design Guide](https:
740
+ # //cloud.google.com/apis/design/errors).
895
741
  class Status
896
742
  include Google::Apis::Core::Hashable
897
743
 
@@ -900,15 +746,15 @@ module Google
900
746
  # @return [Fixnum]
901
747
  attr_accessor :code
902
748
 
903
- # A list of messages that carry the error details. There is a common set of
749
+ # A list of messages that carry the error details. There is a common set of
904
750
  # message types for APIs to use.
905
751
  # Corresponds to the JSON property `details`
906
752
  # @return [Array<Hash<String,Object>>]
907
753
  attr_accessor :details
908
754
 
909
- # A developer-facing error message, which should be in English. Any
910
- # user-facing error message should be localized and sent in the
911
- # google.rpc.Status.details field, or localized by the client.
755
+ # A developer-facing error message, which should be in English. Any user-facing
756
+ # error message should be localized and sent in the google.rpc.Status.details
757
+ # field, or localized by the client.
912
758
  # Corresponds to the JSON property `message`
913
759
  # @return [String]
914
760
  attr_accessor :message
@@ -929,10 +775,9 @@ module Google
929
775
  class TestIamPermissionsRequest
930
776
  include Google::Apis::Core::Hashable
931
777
 
932
- # The set of permissions to check for the `resource`. Permissions with
933
- # wildcards (such as '*' or 'storage.*') are not allowed. For more
934
- # information see
935
- # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
778
+ # The set of permissions to check for the `resource`. Permissions with wildcards
779
+ # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
780
+ # Overview](https://cloud.google.com/iam/docs/overview#permissions).
936
781
  # Corresponds to the JSON property `permissions`
937
782
  # @return [Array<String>]
938
783
  attr_accessor :permissions
@@ -951,8 +796,7 @@ module Google
951
796
  class TestIamPermissionsResponse
952
797
  include Google::Apis::Core::Hashable
953
798
 
954
- # A subset of `TestPermissionsRequest.permissions` that the caller is
955
- # allowed.
799
+ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
956
800
  # Corresponds to the JSON property `permissions`
957
801
  # @return [Array<String>]
958
802
  attr_accessor :permissions