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
@@ -48,33 +48,27 @@ module Google
48
48
  @batch_path = 'batch'
49
49
  end
50
50
 
51
- # Creates a Folder in the resource hierarchy.
52
- # Returns an Operation which can be used to track the progress of the
53
- # folder creation workflow.
54
- # Upon success the Operation.response field will be populated with the
55
- # created Folder.
56
- # In order to succeed, the addition of this new Folder must not violate
57
- # the Folder naming, height or fanout constraints.
58
- # + The Folder's display_name must be distinct from all other Folder's that
59
- # share its parent.
60
- # + The addition of the Folder must not cause the active Folder hierarchy
61
- # to exceed a height of 4. Note, the full active + deleted Folder hierarchy
62
- # is allowed to reach a height of 8; this provides additional headroom when
63
- # moving folders that contain deleted folders.
64
- # + The addition of the Folder must not cause the total number of Folders
65
- # under its parent to exceed 100.
66
- # If the operation fails due to a folder constraint violation, some errors
67
- # may be returned by the CreateFolder request, with status code
68
- # FAILED_PRECONDITION and an error description. Other folder constraint
69
- # violations will be communicated in the Operation, with the specific
70
- # PreconditionFailure returned via the details list in the Operation.error
71
- # field.
51
+ # Creates a Folder in the resource hierarchy. Returns an Operation which can be
52
+ # used to track the progress of the folder creation workflow. Upon success the
53
+ # Operation.response field will be populated with the created Folder. In order
54
+ # to succeed, the addition of this new Folder must not violate the Folder naming,
55
+ # height or fanout constraints. + The Folder's display_name must be distinct
56
+ # from all other Folder's that share its parent. + The addition of the Folder
57
+ # must not cause the active Folder hierarchy to exceed a height of 4. Note, the
58
+ # full active + deleted Folder hierarchy is allowed to reach a height of 8; this
59
+ # provides additional headroom when moving folders that contain deleted folders.
60
+ # + The addition of the Folder must not cause the total number of Folders under
61
+ # its parent to exceed 100. If the operation fails due to a folder constraint
62
+ # violation, some errors may be returned by the CreateFolder request, with
63
+ # status code FAILED_PRECONDITION and an error description. Other folder
64
+ # constraint violations will be communicated in the Operation, with the specific
65
+ # PreconditionFailure returned via the details list in the Operation.error field.
72
66
  # The caller must have `resourcemanager.folders.create` permission on the
73
67
  # identified parent.
74
68
  # @param [Google::Apis::CloudresourcemanagerV2::Folder] folder_object
75
69
  # @param [String] parent
76
- # Required. The resource name of the new Folder's parent.
77
- # Must be of the form `folders/`folder_id`` or `organizations/`org_id``.
70
+ # Required. The resource name of the new Folder's parent. Must be of the form `
71
+ # folders/`folder_id`` or `organizations/`org_id``.
78
72
  # @param [String] fields
79
73
  # Selector specifying which fields to include in a partial response.
80
74
  # @param [String] quota_user
@@ -104,18 +98,14 @@ module Google
104
98
  execute_or_queue_command(command, &block)
105
99
  end
106
100
 
107
- # Requests deletion of a Folder. The Folder is moved into the
108
- # DELETE_REQUESTED state
109
- # immediately, and is deleted approximately 30 days later. This method may
110
- # only be called on an empty Folder in the
111
- # ACTIVE state, where a Folder is empty if
112
- # it doesn't contain any Folders or Projects in the
113
- # ACTIVE state.
114
- # The caller must have `resourcemanager.folders.delete` permission on the
115
- # identified folder.
101
+ # Requests deletion of a Folder. The Folder is moved into the DELETE_REQUESTED
102
+ # state immediately, and is deleted approximately 30 days later. This method may
103
+ # only be called on an empty Folder in the ACTIVE state, where a Folder is empty
104
+ # if it doesn't contain any Folders or Projects in the ACTIVE state. The caller
105
+ # must have `resourcemanager.folders.delete` permission on the identified folder.
116
106
  # @param [String] name
117
- # Required. the resource name of the Folder to be deleted.
118
- # Must be of the form `folders/`folder_id``.
107
+ # Required. the resource name of the Folder to be deleted. Must be of the form `
108
+ # folders/`folder_id``.
119
109
  # @param [String] fields
120
110
  # Selector specifying which fields to include in a partial response.
121
111
  # @param [String] quota_user
@@ -143,14 +133,13 @@ module Google
143
133
  execute_or_queue_command(command, &block)
144
134
  end
145
135
 
146
- # Retrieves a Folder identified by the supplied resource name.
147
- # Valid Folder resource names have the format `folders/`folder_id``
148
- # (for example, `folders/1234`).
149
- # The caller must have `resourcemanager.folders.get` permission on the
136
+ # Retrieves a Folder identified by the supplied resource name. Valid Folder
137
+ # resource names have the format `folders/`folder_id`` (for example, `folders/
138
+ # 1234`). The caller must have `resourcemanager.folders.get` permission on the
150
139
  # identified folder.
151
140
  # @param [String] name
152
- # Required. The resource name of the Folder to retrieve.
153
- # Must be of the form `folders/`folder_id``.
141
+ # Required. The resource name of the Folder to retrieve. Must be of the form `
142
+ # folders/`folder_id``.
154
143
  # @param [String] fields
155
144
  # Selector specifying which fields to include in a partial response.
156
145
  # @param [String] quota_user
@@ -178,14 +167,13 @@ module Google
178
167
  execute_or_queue_command(command, &block)
179
168
  end
180
169
 
181
- # Gets the access control policy for a Folder. The returned policy may be
182
- # empty if no such policy or resource exists. The `resource` field should
183
- # be the Folder's resource name, e.g. "folders/1234".
184
- # The caller must have `resourcemanager.folders.getIamPolicy` permission
185
- # on the identified folder.
170
+ # Gets the access control policy for a Folder. The returned policy may be empty
171
+ # if no such policy or resource exists. The `resource` field should be the
172
+ # Folder's resource name, e.g. "folders/1234". The caller must have `
173
+ # resourcemanager.folders.getIamPolicy` permission on the identified folder.
186
174
  # @param [String] resource
187
- # REQUIRED: The resource for which the policy is being requested.
188
- # See the operation documentation for the appropriate value for this field.
175
+ # REQUIRED: The resource for which the policy is being requested. See the
176
+ # operation documentation for the appropriate value for this field.
189
177
  # @param [Google::Apis::CloudresourcemanagerV2::GetIamPolicyRequest] get_iam_policy_request_object
190
178
  # @param [String] fields
191
179
  # Selector specifying which fields to include in a partial response.
@@ -217,12 +205,10 @@ module Google
217
205
  end
218
206
 
219
207
  # Lists the Folders that are direct descendants of supplied parent resource.
220
- # List provides a strongly consistent view of the Folders underneath
221
- # the specified parent resource.
222
- # List returns Folders sorted based upon the (ascending) lexical ordering
223
- # of their display_name.
224
- # The caller must have `resourcemanager.folders.list` permission on the
225
- # identified parent.
208
+ # List provides a strongly consistent view of the Folders underneath the
209
+ # specified parent resource. List returns Folders sorted based upon the (
210
+ # ascending) lexical ordering of their display_name. The caller must have `
211
+ # resourcemanager.folders.list` permission on the identified parent.
226
212
  # @param [Fixnum] page_size
227
213
  # Optional. The maximum number of Folders to return in the response.
228
214
  # @param [String] page_token
@@ -230,14 +216,12 @@ module Google
230
216
  # that indicates where this listing should continue from.
231
217
  # @param [String] parent
232
218
  # Required. The resource name of the Organization or Folder whose Folders are
233
- # being listed.
234
- # Must be of the form `folders/`folder_id`` or `organizations/`org_id``.
235
- # Access to this method is controlled by checking the
236
- # `resourcemanager.folders.list` permission on the `parent`.
219
+ # being listed. Must be of the form `folders/`folder_id`` or `organizations/`
220
+ # org_id``. Access to this method is controlled by checking the `resourcemanager.
221
+ # folders.list` permission on the `parent`.
237
222
  # @param [Boolean] show_deleted
238
- # Optional. Controls whether Folders in the
239
- # DELETE_REQUESTED
240
- # state should be returned. Defaults to false.
223
+ # Optional. Controls whether Folders in the DELETE_REQUESTED state should be
224
+ # returned. Defaults to false.
241
225
  # @param [String] fields
242
226
  # Selector specifying which fields to include in a partial response.
243
227
  # @param [String] quota_user
@@ -268,26 +252,21 @@ module Google
268
252
  execute_or_queue_command(command, &block)
269
253
  end
270
254
 
271
- # Moves a Folder under a new resource parent.
272
- # Returns an Operation which can be used to track the progress of the
273
- # folder move workflow.
274
- # Upon success the Operation.response field will be populated with the
275
- # moved Folder.
276
- # Upon failure, a FolderOperationError categorizing the failure cause will
277
- # be returned - if the failure occurs synchronously then the
278
- # FolderOperationError will be returned via the Status.details field
279
- # and if it occurs asynchronously then the FolderOperation will be returned
280
- # via the Operation.error field.
281
- # In addition, the Operation.metadata field will be populated with a
282
- # FolderOperation message as an aid to stateless clients.
283
- # Folder moves will be rejected if they violate either the naming, height
284
- # or fanout constraints described in the
285
- # CreateFolder documentation.
286
- # The caller must have `resourcemanager.folders.move` permission on the
287
- # folder's current and proposed new parent.
255
+ # Moves a Folder under a new resource parent. Returns an Operation which can be
256
+ # used to track the progress of the folder move workflow. Upon success the
257
+ # Operation.response field will be populated with the moved Folder. Upon failure,
258
+ # a FolderOperationError categorizing the failure cause will be returned - if
259
+ # the failure occurs synchronously then the FolderOperationError will be
260
+ # returned via the Status.details field and if it occurs asynchronously then the
261
+ # FolderOperation will be returned via the Operation.error field. In addition,
262
+ # the Operation.metadata field will be populated with a FolderOperation message
263
+ # as an aid to stateless clients. Folder moves will be rejected if they violate
264
+ # either the naming, height or fanout constraints described in the CreateFolder
265
+ # documentation. The caller must have `resourcemanager.folders.move` permission
266
+ # on the folder's current and proposed new parent.
288
267
  # @param [String] name
289
- # Required. The resource name of the Folder to move.
290
- # Must be of the form folders/`folder_id`
268
+ # Required. The resource name of the Folder to move. Must be of the form folders/
269
+ # `folder_id`
291
270
  # @param [Google::Apis::CloudresourcemanagerV2::MoveFolderRequest] move_folder_request_object
292
271
  # @param [String] fields
293
272
  # Selector specifying which fields to include in a partial response.
@@ -318,26 +297,22 @@ module Google
318
297
  execute_or_queue_command(command, &block)
319
298
  end
320
299
 
321
- # Updates a Folder, changing its display_name.
322
- # Changes to the folder display_name will be rejected if they violate either
323
- # the display_name formatting rules or naming constraints described in
324
- # the CreateFolder documentation.
325
- # The Folder's display name must start and end with a letter or digit,
326
- # may contain letters, digits, spaces, hyphens and underscores and can be
327
- # no longer than 30 characters. This is captured by the regular expression:
328
- # [\p`L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?.
329
- # The caller must have `resourcemanager.folders.update` permission on the
330
- # identified folder.
331
- # If the update fails due to the unique name constraint then a
332
- # PreconditionFailure explaining this violation will be returned
333
- # in the Status.details field.
300
+ # Updates a Folder, changing its display_name. Changes to the folder
301
+ # display_name will be rejected if they violate either the display_name
302
+ # formatting rules or naming constraints described in the CreateFolder
303
+ # documentation. The Folder's display name must start and end with a letter or
304
+ # digit, may contain letters, digits, spaces, hyphens and underscores and can be
305
+ # no longer than 30 characters. This is captured by the regular expression: [\p`
306
+ # L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?. The caller must have `
307
+ # resourcemanager.folders.update` permission on the identified folder. If the
308
+ # update fails due to the unique name constraint then a PreconditionFailure
309
+ # explaining this violation will be returned in the Status.details field.
334
310
  # @param [String] name
335
- # Output only. The resource name of the Folder.
336
- # Its format is `folders/`folder_id``, for example: "folders/1234".
311
+ # Output only. The resource name of the Folder. Its format is `folders/`
312
+ # folder_id``, for example: "folders/1234".
337
313
  # @param [Google::Apis::CloudresourcemanagerV2::Folder] folder_object
338
314
  # @param [String] update_mask
339
- # Required. Fields to be updated.
340
- # Only the `display_name` can be updated.
315
+ # Required. Fields to be updated. Only the `display_name` can be updated.
341
316
  # @param [String] fields
342
317
  # Selector specifying which fields to include in a partial response.
343
318
  # @param [String] quota_user
@@ -368,11 +343,10 @@ module Google
368
343
  execute_or_queue_command(command, &block)
369
344
  end
370
345
 
371
- # Search for folders that match specific filter criteria.
372
- # Search provides an eventually consistent view of the folders a user has
373
- # access to which meet the specified filter criteria.
374
- # This will only return folders on which the caller has the
375
- # permission `resourcemanager.folders.get`.
346
+ # Search for folders that match specific filter criteria. Search provides an
347
+ # eventually consistent view of the folders a user has access to which meet the
348
+ # specified filter criteria. This will only return folders on which the caller
349
+ # has the permission `resourcemanager.folders.get`.
376
350
  # @param [Google::Apis::CloudresourcemanagerV2::SearchFoldersRequest] search_folders_request_object
377
351
  # @param [String] fields
378
352
  # Selector specifying which fields to include in a partial response.
@@ -402,14 +376,13 @@ module Google
402
376
  execute_or_queue_command(command, &block)
403
377
  end
404
378
 
405
- # Sets the access control policy on a Folder, replacing any existing policy.
406
- # The `resource` field should be the Folder's resource name, e.g.
407
- # "folders/1234".
408
- # The caller must have `resourcemanager.folders.setIamPolicy` permission
409
- # on the identified folder.
379
+ # Sets the access control policy on a Folder, replacing any existing policy. The
380
+ # `resource` field should be the Folder's resource name, e.g. "folders/1234".
381
+ # The caller must have `resourcemanager.folders.setIamPolicy` permission on the
382
+ # identified folder.
410
383
  # @param [String] resource
411
- # REQUIRED: The resource for which the policy is being specified.
412
- # See the operation documentation for the appropriate value for this field.
384
+ # REQUIRED: The resource for which the policy is being specified. See the
385
+ # operation documentation for the appropriate value for this field.
413
386
  # @param [Google::Apis::CloudresourcemanagerV2::SetIamPolicyRequest] set_iam_policy_request_object
414
387
  # @param [String] fields
415
388
  # Selector specifying which fields to include in a partial response.
@@ -440,13 +413,12 @@ module Google
440
413
  execute_or_queue_command(command, &block)
441
414
  end
442
415
 
443
- # Returns permissions that a caller has on the specified Folder.
444
- # The `resource` field should be the Folder's resource name,
445
- # e.g. "folders/1234".
446
- # There are no permissions required for making this API call.
416
+ # Returns permissions that a caller has on the specified Folder. The `resource`
417
+ # field should be the Folder's resource name, e.g. "folders/1234". There are no
418
+ # permissions required for making this API call.
447
419
  # @param [String] resource
448
- # REQUIRED: The resource for which the policy detail is being requested.
449
- # See the operation documentation for the appropriate value for this field.
420
+ # REQUIRED: The resource for which the policy detail is being requested. See the
421
+ # operation documentation for the appropriate value for this field.
450
422
  # @param [Google::Apis::CloudresourcemanagerV2::TestIamPermissionsRequest] test_iam_permissions_request_object
451
423
  # @param [String] fields
452
424
  # Selector specifying which fields to include in a partial response.
@@ -477,19 +449,15 @@ module Google
477
449
  execute_or_queue_command(command, &block)
478
450
  end
479
451
 
480
- # Cancels the deletion request for a Folder. This method may only be
481
- # called on a Folder in the
482
- # DELETE_REQUESTED state.
483
- # In order to succeed, the Folder's parent must be in the
484
- # ACTIVE state.
485
- # In addition, reintroducing the folder into the tree must not violate
486
- # folder naming, height and fanout constraints described in the
487
- # CreateFolder documentation.
488
- # The caller must have `resourcemanager.folders.undelete` permission on the
489
- # identified folder.
452
+ # Cancels the deletion request for a Folder. This method may only be called on a
453
+ # Folder in the DELETE_REQUESTED state. In order to succeed, the Folder's parent
454
+ # must be in the ACTIVE state. In addition, reintroducing the folder into the
455
+ # tree must not violate folder naming, height and fanout constraints described
456
+ # in the CreateFolder documentation. The caller must have `resourcemanager.
457
+ # folders.undelete` permission on the identified folder.
490
458
  # @param [String] name
491
- # Required. The resource name of the Folder to undelete.
492
- # Must be of the form `folders/`folder_id``.
459
+ # Required. The resource name of the Folder to undelete. Must be of the form `
460
+ # folders/`folder_id``.
493
461
  # @param [Google::Apis::CloudresourcemanagerV2::UndeleteFolderRequest] undelete_folder_request_object
494
462
  # @param [String] fields
495
463
  # Selector specifying which fields to include in a partial response.
@@ -520,9 +488,8 @@ module Google
520
488
  execute_or_queue_command(command, &block)
521
489
  end
522
490
 
523
- # Gets the latest state of a long-running operation. Clients can use this
524
- # method to poll the operation result at intervals as recommended by the API
525
- # service.
491
+ # Gets the latest state of a long-running operation. Clients can use this method
492
+ # to poll the operation result at intervals as recommended by the API service.
526
493
  # @param [String] name
527
494
  # The name of the operation resource.
528
495
  # @param [String] fields
@@ -26,7 +26,7 @@ module Google
26
26
  # @see https://cloud.google.com/resource-manager
27
27
  module CloudresourcemanagerV2beta1
28
28
  VERSION = 'V2beta1'
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 CloudresourcemanagerV2beta1
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::CloudresourcemanagerV2beta1::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::CloudresourcemanagerV2beta1::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::CloudresourcemanagerV2beta1::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::CloudresourcemanagerV2beta1::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::CloudresourcemanagerV2beta1::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::CloudresourcemanagerV2beta1::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::CloudresourcemanagerV2beta1::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::CloudresourcemanagerV2beta1::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