google-apis-auditmanager_v1 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,2065 @@
1
+ # Copyright 2020 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module AuditmanagerV1
23
+ # Audit Manager API
24
+ #
25
+ # The Audit Manager API allows customers to manage compliance audits.
26
+ #
27
+ # @example
28
+ # require 'google/apis/auditmanager_v1'
29
+ #
30
+ # Auditmanager = Google::Apis::AuditmanagerV1 # Alias the module
31
+ # service = Auditmanager::CloudAuditManagerService.new
32
+ #
33
+ # @see https://cloud.google.com/assured-workloads/docs/audit-manager
34
+ class CloudAuditManagerService < Google::Apis::Core::BaseService
35
+ DEFAULT_ENDPOINT_TEMPLATE = "https://auditmanager.$UNIVERSE_DOMAIN$/"
36
+
37
+ # @return [String]
38
+ # API key. Your API key identifies your project and provides you with API access,
39
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
40
+ attr_accessor :key
41
+
42
+ # @return [String]
43
+ # Available to use for quota purposes for server-side applications. Can be any
44
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
45
+ attr_accessor :quota_user
46
+
47
+ def initialize
48
+ super(DEFAULT_ENDPOINT_TEMPLATE, '',
49
+ client_name: 'google-apis-auditmanager_v1',
50
+ client_version: Google::Apis::AuditmanagerV1::GEM_VERSION)
51
+ @batch_path = 'batch'
52
+ end
53
+
54
+ # Adds your project, folder, or organization to Audit Manager. This method
55
+ # creates the Audit Manager service agent in your workload and grants required
56
+ # permissions to the service agent. If you make this request on a workload that'
57
+ # s already enrolled, then this method overrides the existing set of
58
+ # destinations.
59
+ # @param [String] scope
60
+ # Required. Organization, folder, or project to enroll in Audit Manager, in one
61
+ # of the following formats: * `projects/`project`/locations/`location`` * `
62
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
63
+ # locations/`location``
64
+ # @param [Google::Apis::AuditmanagerV1::EnrollResourceRequest] enroll_resource_request_object
65
+ # @param [String] fields
66
+ # Selector specifying which fields to include in a partial response.
67
+ # @param [String] quota_user
68
+ # Available to use for quota purposes for server-side applications. Can be any
69
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
70
+ # @param [Google::Apis::RequestOptions] options
71
+ # Request-specific options
72
+ #
73
+ # @yield [result, err] Result & error if block supplied
74
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Enrollment] parsed result object
75
+ # @yieldparam err [StandardError] error object if request failed
76
+ #
77
+ # @return [Google::Apis::AuditmanagerV1::Enrollment]
78
+ #
79
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
80
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
81
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
82
+ def enroll_folder_location_resource(scope, enroll_resource_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
83
+ command = make_simple_command(:post, 'v1/{+scope}:enrollResource', options)
84
+ command.request_representation = Google::Apis::AuditmanagerV1::EnrollResourceRequest::Representation
85
+ command.request_object = enroll_resource_request_object
86
+ command.response_representation = Google::Apis::AuditmanagerV1::Enrollment::Representation
87
+ command.response_class = Google::Apis::AuditmanagerV1::Enrollment
88
+ command.params['scope'] = scope unless scope.nil?
89
+ command.query['fields'] = fields unless fields.nil?
90
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
91
+ execute_or_queue_command(command, &block)
92
+ end
93
+
94
+ # Registers audit report generation requests. This method returns the operation
95
+ # identifier that you can use to track the report generation progress.
96
+ # @param [String] scope
97
+ # Required. Organization, folder, or project that the audit applies to, in one
98
+ # of the following formats: * `projects/`project`/locations/`location`` * `
99
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
100
+ # locations/`location``
101
+ # @param [Google::Apis::AuditmanagerV1::GenerateAuditReportRequest] generate_audit_report_request_object
102
+ # @param [String] fields
103
+ # Selector specifying which fields to include in a partial response.
104
+ # @param [String] quota_user
105
+ # Available to use for quota purposes for server-side applications. Can be any
106
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
107
+ # @param [Google::Apis::RequestOptions] options
108
+ # Request-specific options
109
+ #
110
+ # @yield [result, err] Result & error if block supplied
111
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Operation] parsed result object
112
+ # @yieldparam err [StandardError] error object if request failed
113
+ #
114
+ # @return [Google::Apis::AuditmanagerV1::Operation]
115
+ #
116
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
117
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
118
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
119
+ def generate_folder_location_audit_report(scope, generate_audit_report_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
120
+ command = make_simple_command(:post, 'v1/{+scope}/auditReports:generate', options)
121
+ command.request_representation = Google::Apis::AuditmanagerV1::GenerateAuditReportRequest::Representation
122
+ command.request_object = generate_audit_report_request_object
123
+ command.response_representation = Google::Apis::AuditmanagerV1::Operation::Representation
124
+ command.response_class = Google::Apis::AuditmanagerV1::Operation
125
+ command.params['scope'] = scope unless scope.nil?
126
+ command.query['fields'] = fields unless fields.nil?
127
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
128
+ execute_or_queue_command(command, &block)
129
+ end
130
+
131
+ # Gets the full metadata and findings for an audit report.
132
+ # @param [String] name
133
+ # Required. Name of the audit report, in one of the following formats: * `
134
+ # projects/`project`/locations/`location`/auditReports/`audit_report`` * `
135
+ # folders/`folder`/locations/`location`/auditReports/`audit_report`` * `
136
+ # organizations/`organization`/locations/`location`/auditReports/`audit_report``
137
+ # @param [String] fields
138
+ # Selector specifying which fields to include in a partial response.
139
+ # @param [String] quota_user
140
+ # Available to use for quota purposes for server-side applications. Can be any
141
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
142
+ # @param [Google::Apis::RequestOptions] options
143
+ # Request-specific options
144
+ #
145
+ # @yield [result, err] Result & error if block supplied
146
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditReport] parsed result object
147
+ # @yieldparam err [StandardError] error object if request failed
148
+ #
149
+ # @return [Google::Apis::AuditmanagerV1::AuditReport]
150
+ #
151
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
152
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
153
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
154
+ def get_folder_location_audit_report(name, fields: nil, quota_user: nil, options: nil, &block)
155
+ command = make_simple_command(:get, 'v1/{+name}', options)
156
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditReport::Representation
157
+ command.response_class = Google::Apis::AuditmanagerV1::AuditReport
158
+ command.params['name'] = name unless name.nil?
159
+ command.query['fields'] = fields unless fields.nil?
160
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
161
+ execute_or_queue_command(command, &block)
162
+ end
163
+
164
+ # Lists the audit reports for the organization, folder, or project that you
165
+ # specify as the parent scope.
166
+ # @param [String] parent
167
+ # Required. Parent organization, folder, or project to list reports for, in one
168
+ # of the following formats: * `projects/`project`/locations/`location`` * `
169
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
170
+ # locations/`location``
171
+ # @param [Fixnum] page_size
172
+ # Optional. Maximum number of items to return in a single page. The service
173
+ # might return fewer items than this value. If unspecified, the service picks an
174
+ # appropriate default. The maximum value is 100; values above 100 are reduced to
175
+ # 100.
176
+ # @param [String] page_token
177
+ # Optional. A page token, received from a previous call, to retrieve the next
178
+ # page of results.
179
+ # @param [String] fields
180
+ # Selector specifying which fields to include in a partial response.
181
+ # @param [String] quota_user
182
+ # Available to use for quota purposes for server-side applications. Can be any
183
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
184
+ # @param [Google::Apis::RequestOptions] options
185
+ # Request-specific options
186
+ #
187
+ # @yield [result, err] Result & error if block supplied
188
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListAuditReportsResponse] parsed result object
189
+ # @yieldparam err [StandardError] error object if request failed
190
+ #
191
+ # @return [Google::Apis::AuditmanagerV1::ListAuditReportsResponse]
192
+ #
193
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
194
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
195
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
196
+ def list_folder_location_audit_reports(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
197
+ command = make_simple_command(:get, 'v1/{+parent}/auditReports', options)
198
+ command.response_representation = Google::Apis::AuditmanagerV1::ListAuditReportsResponse::Representation
199
+ command.response_class = Google::Apis::AuditmanagerV1::ListAuditReportsResponse
200
+ command.params['parent'] = parent unless parent.nil?
201
+ command.query['pageSize'] = page_size unless page_size.nil?
202
+ command.query['pageToken'] = page_token unless page_token.nil?
203
+ command.query['fields'] = fields unless fields.nil?
204
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
205
+ execute_or_queue_command(command, &block)
206
+ end
207
+
208
+ # Creates a new audit schedule in a given project and location.
209
+ # @param [String] parent
210
+ # Required. Project or folder that this audit schedule is for, in one of the
211
+ # following formats: * `projects/`project`/locations/`location`` * `folders/`
212
+ # folder`/locations/`location``
213
+ # @param [Google::Apis::AuditmanagerV1::AuditSchedule] audit_schedule_object
214
+ # @param [String] audit_schedule_id
215
+ # Required. ID to use for the audit schedule, which becomes the final component
216
+ # of the audit schedule's resource name.
217
+ # @param [Boolean] validate_only
218
+ # Optional. If `true`, only validates the request and does not create the audit
219
+ # schedule. This executes standard request validation (such as schema, framework
220
+ # existence, scope, and IAM checks) and skips the apply phase. Use this field
221
+ # for the following purposes: * **Infrastructure as Code (IaC)**: Allow tools
222
+ # like Terraform to run dry-run mutations (e.g., `terraform plan`) without
223
+ # creating real resources or incurring costs. * **User Interface Validation**:
224
+ # Enable real-time form and permission validation in custom UIs before
225
+ # submitting requests. * **CI/CD & Automation**: Test your scripts, permissions,
226
+ # and parameters safely without consuming resource quotas.
227
+ # @param [String] fields
228
+ # Selector specifying which fields to include in a partial response.
229
+ # @param [String] quota_user
230
+ # Available to use for quota purposes for server-side applications. Can be any
231
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
232
+ # @param [Google::Apis::RequestOptions] options
233
+ # Request-specific options
234
+ #
235
+ # @yield [result, err] Result & error if block supplied
236
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditSchedule] parsed result object
237
+ # @yieldparam err [StandardError] error object if request failed
238
+ #
239
+ # @return [Google::Apis::AuditmanagerV1::AuditSchedule]
240
+ #
241
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
242
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
243
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
244
+ def create_folder_location_audit_schedule(parent, audit_schedule_object = nil, audit_schedule_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
245
+ command = make_simple_command(:post, 'v1/{+parent}/auditSchedules', options)
246
+ command.request_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
247
+ command.request_object = audit_schedule_object
248
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
249
+ command.response_class = Google::Apis::AuditmanagerV1::AuditSchedule
250
+ command.params['parent'] = parent unless parent.nil?
251
+ command.query['auditScheduleId'] = audit_schedule_id unless audit_schedule_id.nil?
252
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
253
+ command.query['fields'] = fields unless fields.nil?
254
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
255
+ execute_or_queue_command(command, &block)
256
+ end
257
+
258
+ # Gets details of a single audit schedule.
259
+ # @param [String] name
260
+ # Required. Name of the audit schedule to retrieve, in one of the following
261
+ # formats: * `projects/`project`/locations/`location`/auditSchedules/`
262
+ # audit_schedule`` * `folders/`folder`/locations/`location`/auditSchedules/`
263
+ # audit_schedule`` * `organizations/`organization`/locations/`location`/
264
+ # auditSchedules/`audit_schedule``
265
+ # @param [String] fields
266
+ # Selector specifying which fields to include in a partial response.
267
+ # @param [String] quota_user
268
+ # Available to use for quota purposes for server-side applications. Can be any
269
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
270
+ # @param [Google::Apis::RequestOptions] options
271
+ # Request-specific options
272
+ #
273
+ # @yield [result, err] Result & error if block supplied
274
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditSchedule] parsed result object
275
+ # @yieldparam err [StandardError] error object if request failed
276
+ #
277
+ # @return [Google::Apis::AuditmanagerV1::AuditSchedule]
278
+ #
279
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
280
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
281
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
282
+ def get_folder_location_audit_schedule(name, fields: nil, quota_user: nil, options: nil, &block)
283
+ command = make_simple_command(:get, 'v1/{+name}', options)
284
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
285
+ command.response_class = Google::Apis::AuditmanagerV1::AuditSchedule
286
+ command.params['name'] = name unless name.nil?
287
+ command.query['fields'] = fields unless fields.nil?
288
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
289
+ execute_or_queue_command(command, &block)
290
+ end
291
+
292
+ # Lists audit schedules in a given project and location.
293
+ # @param [String] parent
294
+ # Required. Parent for the audit schedule, in one of the following formats: * `
295
+ # projects/`project`/locations/`location`` * `folders/`folder`/locations/`
296
+ # location`` * `organizations/`organization`/locations/`location``
297
+ # @param [Fixnum] page_size
298
+ # Optional. Maximum number of items to return in a single page. The service
299
+ # might return fewer items than this value. If unspecified, the service picks an
300
+ # appropriate default. The maximum value is 100; values above 100 are reduced to
301
+ # 100.
302
+ # @param [String] page_token
303
+ # Optional. A page token, received from a previous call, to retrieve the next
304
+ # page of results.
305
+ # @param [String] fields
306
+ # Selector specifying which fields to include in a partial response.
307
+ # @param [String] quota_user
308
+ # Available to use for quota purposes for server-side applications. Can be any
309
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
310
+ # @param [Google::Apis::RequestOptions] options
311
+ # Request-specific options
312
+ #
313
+ # @yield [result, err] Result & error if block supplied
314
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse] parsed result object
315
+ # @yieldparam err [StandardError] error object if request failed
316
+ #
317
+ # @return [Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse]
318
+ #
319
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
320
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
321
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
322
+ def list_folder_location_audit_schedules(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
323
+ command = make_simple_command(:get, 'v1/{+parent}/auditSchedules', options)
324
+ command.response_representation = Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse::Representation
325
+ command.response_class = Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse
326
+ command.params['parent'] = parent unless parent.nil?
327
+ command.query['pageSize'] = page_size unless page_size.nil?
328
+ command.query['pageToken'] = page_token unless page_token.nil?
329
+ command.query['fields'] = fields unless fields.nil?
330
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
331
+ execute_or_queue_command(command, &block)
332
+ end
333
+
334
+ # Updates an existing audit schedule.
335
+ # @param [String] name
336
+ # Identifier. Unique identifier for the audit schedule. Format: projects/`
337
+ # project`/locations/`location`/auditSchedules/`audit_schedule` folders/`folder`/
338
+ # locations/`location`/auditSchedules/`audit_schedule` organizations/`
339
+ # organization`/locations/`location`/auditSchedules/`audit_schedule`
340
+ # @param [Google::Apis::AuditmanagerV1::AuditSchedule] audit_schedule_object
341
+ # @param [String] update_mask
342
+ # Optional. List of fields to update.
343
+ # @param [Boolean] validate_only
344
+ # Optional. If `true`, only validates the request and does not update the audit
345
+ # schedule. This executes standard request validation (such as schema, framework
346
+ # existence, scope, and IAM checks) and skips the apply phase. Use this field
347
+ # for the following purposes: * **Infrastructure as Code (IaC)**: Allow tools
348
+ # like Terraform to run dry-run mutations (e.g., `terraform plan`) without
349
+ # creating real resources or incurring costs. * **User Interface Validation**:
350
+ # Enable real-time form and permission validation in custom UIs before
351
+ # submitting requests. * **CI/CD & Automation**: Test your scripts, permissions,
352
+ # and parameters safely without consuming resource quotas.
353
+ # @param [String] fields
354
+ # Selector specifying which fields to include in a partial response.
355
+ # @param [String] quota_user
356
+ # Available to use for quota purposes for server-side applications. Can be any
357
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
358
+ # @param [Google::Apis::RequestOptions] options
359
+ # Request-specific options
360
+ #
361
+ # @yield [result, err] Result & error if block supplied
362
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditSchedule] parsed result object
363
+ # @yieldparam err [StandardError] error object if request failed
364
+ #
365
+ # @return [Google::Apis::AuditmanagerV1::AuditSchedule]
366
+ #
367
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
368
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
369
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
370
+ def patch_folder_location_audit_schedule(name, audit_schedule_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
371
+ command = make_simple_command(:patch, 'v1/{+name}', options)
372
+ command.request_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
373
+ command.request_object = audit_schedule_object
374
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
375
+ command.response_class = Google::Apis::AuditmanagerV1::AuditSchedule
376
+ command.params['name'] = name unless name.nil?
377
+ command.query['updateMask'] = update_mask unless update_mask.nil?
378
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
379
+ command.query['fields'] = fields unless fields.nil?
380
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
381
+ execute_or_queue_command(command, &block)
382
+ end
383
+
384
+ # Generates an audit scope report for the given standard. The report includes
385
+ # the following: * The technical attributes and constraints that Audit Manager
386
+ # uses to verify your compliance with a framework. * A list of Google Cloud
387
+ # services and resources that are within the scope of the framework.
388
+ # @param [String] scope
389
+ # Required. Project or folder that the audit scope report is generated for, in
390
+ # one of the following formats: * `projects/`project`/locations/`location`` * `
391
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
392
+ # locations/`location``
393
+ # @param [Google::Apis::AuditmanagerV1::GenerateAuditScopeReportRequest] generate_audit_scope_report_request_object
394
+ # @param [String] fields
395
+ # Selector specifying which fields to include in a partial response.
396
+ # @param [String] quota_user
397
+ # Available to use for quota purposes for server-side applications. Can be any
398
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
399
+ # @param [Google::Apis::RequestOptions] options
400
+ # Request-specific options
401
+ #
402
+ # @yield [result, err] Result & error if block supplied
403
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditScopeReport] parsed result object
404
+ # @yieldparam err [StandardError] error object if request failed
405
+ #
406
+ # @return [Google::Apis::AuditmanagerV1::AuditScopeReport]
407
+ #
408
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
409
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
410
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
411
+ def generate_folder_location_audit_scope_report(scope, generate_audit_scope_report_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
412
+ command = make_simple_command(:post, 'v1/{+scope}/auditScopeReports:generate', options)
413
+ command.request_representation = Google::Apis::AuditmanagerV1::GenerateAuditScopeReportRequest::Representation
414
+ command.request_object = generate_audit_scope_report_request_object
415
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditScopeReport::Representation
416
+ command.response_class = Google::Apis::AuditmanagerV1::AuditScopeReport
417
+ command.params['scope'] = scope unless scope.nil?
418
+ command.query['fields'] = fields unless fields.nil?
419
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
420
+ execute_or_queue_command(command, &block)
421
+ end
422
+
423
+ # Gets details about the long-running operation to generate audit reports.
424
+ # @param [String] name
425
+ # The name of the operation resource.
426
+ # @param [String] fields
427
+ # Selector specifying which fields to include in a partial response.
428
+ # @param [String] quota_user
429
+ # Available to use for quota purposes for server-side applications. Can be any
430
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
431
+ # @param [Google::Apis::RequestOptions] options
432
+ # Request-specific options
433
+ #
434
+ # @yield [result, err] Result & error if block supplied
435
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Operation] parsed result object
436
+ # @yieldparam err [StandardError] error object if request failed
437
+ #
438
+ # @return [Google::Apis::AuditmanagerV1::Operation]
439
+ #
440
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
441
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
442
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
443
+ def get_folder_location_operation_detail(name, fields: nil, quota_user: nil, options: nil, &block)
444
+ command = make_simple_command(:get, 'v1/{+name}', options)
445
+ command.response_representation = Google::Apis::AuditmanagerV1::Operation::Representation
446
+ command.response_class = Google::Apis::AuditmanagerV1::Operation
447
+ command.params['name'] = name unless name.nil?
448
+ command.query['fields'] = fields unless fields.nil?
449
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
450
+ execute_or_queue_command(command, &block)
451
+ end
452
+
453
+ # Gets details about the long-running operation to generate audit reports.
454
+ # @param [String] name
455
+ # The name of the operation resource.
456
+ # @param [String] fields
457
+ # Selector specifying which fields to include in a partial response.
458
+ # @param [String] quota_user
459
+ # Available to use for quota purposes for server-side applications. Can be any
460
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
461
+ # @param [Google::Apis::RequestOptions] options
462
+ # Request-specific options
463
+ #
464
+ # @yield [result, err] Result & error if block supplied
465
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Operation] parsed result object
466
+ # @yieldparam err [StandardError] error object if request failed
467
+ #
468
+ # @return [Google::Apis::AuditmanagerV1::Operation]
469
+ #
470
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
471
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
472
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
473
+ def get_folder_location_operation_id(name, fields: nil, quota_user: nil, options: nil, &block)
474
+ command = make_simple_command(:get, 'v1/{+name}', options)
475
+ command.response_representation = Google::Apis::AuditmanagerV1::Operation::Representation
476
+ command.response_class = Google::Apis::AuditmanagerV1::Operation
477
+ command.params['name'] = name unless name.nil?
478
+ command.query['fields'] = fields unless fields.nil?
479
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
480
+ execute_or_queue_command(command, &block)
481
+ end
482
+
483
+ # Gets a resource and its enrollment status.
484
+ # @param [String] name
485
+ # Required. Name of the resource enrollment status, in one of the following
486
+ # formats: * `folders/`folder`/locations/`location`/resourceEnrollmentStatuses/`
487
+ # resource_enrollment_status`` * `projects/`project`/locations/`location`/
488
+ # resourceEnrollmentStatuses/`resource_enrollment_status`` * `organizations/`
489
+ # organization`/locations/`location`/resourceEnrollmentStatuses/`
490
+ # resource_enrollment_status``
491
+ # @param [String] fields
492
+ # Selector specifying which fields to include in a partial response.
493
+ # @param [String] quota_user
494
+ # Available to use for quota purposes for server-side applications. Can be any
495
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
496
+ # @param [Google::Apis::RequestOptions] options
497
+ # Request-specific options
498
+ #
499
+ # @yield [result, err] Result & error if block supplied
500
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus] parsed result object
501
+ # @yieldparam err [StandardError] error object if request failed
502
+ #
503
+ # @return [Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus]
504
+ #
505
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
506
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
507
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
508
+ def get_folder_location_resource_enrollment_status(name, fields: nil, quota_user: nil, options: nil, &block)
509
+ command = make_simple_command(:get, 'v1/{+name}', options)
510
+ command.response_representation = Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus::Representation
511
+ command.response_class = Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus
512
+ command.params['name'] = name unless name.nil?
513
+ command.query['fields'] = fields unless fields.nil?
514
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
515
+ execute_or_queue_command(command, &block)
516
+ end
517
+
518
+ # Lists all the folders and projects in an organization or folder, along with
519
+ # their enrollments.
520
+ # @param [String] parent
521
+ # Required. Parent organization or folder to list enrollment statuses for, in
522
+ # one of the following formats: * `folders/`folder`/locations/`location`` * `
523
+ # organizations/`organization`/locations/`location``
524
+ # @param [Fixnum] page_size
525
+ # Optional. Maximum number of items to return in a single page. The service
526
+ # might return fewer items than this value. If unspecified, the service picks an
527
+ # appropriate default. The maximum value is 100; values above 100 are reduced to
528
+ # 100.
529
+ # @param [String] page_token
530
+ # Optional. A page token, received from a previous call, to retrieve the next
531
+ # page of results.
532
+ # @param [String] fields
533
+ # Selector specifying which fields to include in a partial response.
534
+ # @param [String] quota_user
535
+ # Available to use for quota purposes for server-side applications. Can be any
536
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
537
+ # @param [Google::Apis::RequestOptions] options
538
+ # Request-specific options
539
+ #
540
+ # @yield [result, err] Result & error if block supplied
541
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListResourceEnrollmentStatusesResponse] parsed result object
542
+ # @yieldparam err [StandardError] error object if request failed
543
+ #
544
+ # @return [Google::Apis::AuditmanagerV1::ListResourceEnrollmentStatusesResponse]
545
+ #
546
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
547
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
548
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
549
+ def list_folder_location_resource_enrollment_statuses(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
550
+ command = make_simple_command(:get, 'v1/{+parent}/resourceEnrollmentStatuses', options)
551
+ command.response_representation = Google::Apis::AuditmanagerV1::ListResourceEnrollmentStatusesResponse::Representation
552
+ command.response_class = Google::Apis::AuditmanagerV1::ListResourceEnrollmentStatusesResponse
553
+ command.params['parent'] = parent unless parent.nil?
554
+ command.query['pageSize'] = page_size unless page_size.nil?
555
+ command.query['pageToken'] = page_token unless page_token.nil?
556
+ command.query['fields'] = fields unless fields.nil?
557
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
558
+ execute_or_queue_command(command, &block)
559
+ end
560
+
561
+ # Lists the controls that you must implement to become compliant to a regulatory
562
+ # standard.
563
+ # @param [String] parent
564
+ # Required. Standard to list controls for, in one of the following formats: * `
565
+ # projects/`project`/locations/`location`/standards/`standard`` * `folders/`
566
+ # folder`/locations/`location`/standards/`standard`` * `organizations/`
567
+ # organization`/locations/`location`/standards/`standard``
568
+ # @param [Fixnum] page_size
569
+ # Optional. Maximum number of items to return in a single page. The service
570
+ # might return fewer items than this value. If unspecified, the service picks an
571
+ # appropriate default. The maximum value is 100; values above 100 are reduced to
572
+ # 100.
573
+ # @param [String] page_token
574
+ # Optional. A page token, received from a previous call, to retrieve the next
575
+ # page of results.
576
+ # @param [String] fields
577
+ # Selector specifying which fields to include in a partial response.
578
+ # @param [String] quota_user
579
+ # Available to use for quota purposes for server-side applications. Can be any
580
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
581
+ # @param [Google::Apis::RequestOptions] options
582
+ # Request-specific options
583
+ #
584
+ # @yield [result, err] Result & error if block supplied
585
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListControlsResponse] parsed result object
586
+ # @yieldparam err [StandardError] error object if request failed
587
+ #
588
+ # @return [Google::Apis::AuditmanagerV1::ListControlsResponse]
589
+ #
590
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
591
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
592
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
593
+ def list_folder_location_standard_controls(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
594
+ command = make_simple_command(:get, 'v1/{+parent}/controls', options)
595
+ command.response_representation = Google::Apis::AuditmanagerV1::ListControlsResponse::Representation
596
+ command.response_class = Google::Apis::AuditmanagerV1::ListControlsResponse
597
+ command.params['parent'] = parent unless parent.nil?
598
+ command.query['pageSize'] = page_size unless page_size.nil?
599
+ command.query['pageToken'] = page_token unless page_token.nil?
600
+ command.query['fields'] = fields unless fields.nil?
601
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
602
+ execute_or_queue_command(command, &block)
603
+ end
604
+
605
+ # Adds your project, folder, or organization to Audit Manager. This method
606
+ # creates the Audit Manager service agent in your workload and grants required
607
+ # permissions to the service agent. If you make this request on a workload that'
608
+ # s already enrolled, then this method overrides the existing set of
609
+ # destinations.
610
+ # @param [String] scope
611
+ # Required. Organization, folder, or project to enroll in Audit Manager, in one
612
+ # of the following formats: * `projects/`project`/locations/`location`` * `
613
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
614
+ # locations/`location``
615
+ # @param [Google::Apis::AuditmanagerV1::EnrollResourceRequest] enroll_resource_request_object
616
+ # @param [String] fields
617
+ # Selector specifying which fields to include in a partial response.
618
+ # @param [String] quota_user
619
+ # Available to use for quota purposes for server-side applications. Can be any
620
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
621
+ # @param [Google::Apis::RequestOptions] options
622
+ # Request-specific options
623
+ #
624
+ # @yield [result, err] Result & error if block supplied
625
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Enrollment] parsed result object
626
+ # @yieldparam err [StandardError] error object if request failed
627
+ #
628
+ # @return [Google::Apis::AuditmanagerV1::Enrollment]
629
+ #
630
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
631
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
632
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
633
+ def enroll_organization_location_resource(scope, enroll_resource_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
634
+ command = make_simple_command(:post, 'v1/{+scope}:enrollResource', options)
635
+ command.request_representation = Google::Apis::AuditmanagerV1::EnrollResourceRequest::Representation
636
+ command.request_object = enroll_resource_request_object
637
+ command.response_representation = Google::Apis::AuditmanagerV1::Enrollment::Representation
638
+ command.response_class = Google::Apis::AuditmanagerV1::Enrollment
639
+ command.params['scope'] = scope unless scope.nil?
640
+ command.query['fields'] = fields unless fields.nil?
641
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
642
+ execute_or_queue_command(command, &block)
643
+ end
644
+
645
+ # Registers audit report generation requests. This method returns the operation
646
+ # identifier that you can use to track the report generation progress.
647
+ # @param [String] scope
648
+ # Required. Organization, folder, or project that the audit applies to, in one
649
+ # of the following formats: * `projects/`project`/locations/`location`` * `
650
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
651
+ # locations/`location``
652
+ # @param [Google::Apis::AuditmanagerV1::GenerateAuditReportRequest] generate_audit_report_request_object
653
+ # @param [String] fields
654
+ # Selector specifying which fields to include in a partial response.
655
+ # @param [String] quota_user
656
+ # Available to use for quota purposes for server-side applications. Can be any
657
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
658
+ # @param [Google::Apis::RequestOptions] options
659
+ # Request-specific options
660
+ #
661
+ # @yield [result, err] Result & error if block supplied
662
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Operation] parsed result object
663
+ # @yieldparam err [StandardError] error object if request failed
664
+ #
665
+ # @return [Google::Apis::AuditmanagerV1::Operation]
666
+ #
667
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
668
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
669
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
670
+ def generate_organization_location_audit_report(scope, generate_audit_report_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
671
+ command = make_simple_command(:post, 'v1/{+scope}/auditReports:generate', options)
672
+ command.request_representation = Google::Apis::AuditmanagerV1::GenerateAuditReportRequest::Representation
673
+ command.request_object = generate_audit_report_request_object
674
+ command.response_representation = Google::Apis::AuditmanagerV1::Operation::Representation
675
+ command.response_class = Google::Apis::AuditmanagerV1::Operation
676
+ command.params['scope'] = scope unless scope.nil?
677
+ command.query['fields'] = fields unless fields.nil?
678
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
679
+ execute_or_queue_command(command, &block)
680
+ end
681
+
682
+ # Gets the full metadata and findings for an audit report.
683
+ # @param [String] name
684
+ # Required. Name of the audit report, in one of the following formats: * `
685
+ # projects/`project`/locations/`location`/auditReports/`audit_report`` * `
686
+ # folders/`folder`/locations/`location`/auditReports/`audit_report`` * `
687
+ # organizations/`organization`/locations/`location`/auditReports/`audit_report``
688
+ # @param [String] fields
689
+ # Selector specifying which fields to include in a partial response.
690
+ # @param [String] quota_user
691
+ # Available to use for quota purposes for server-side applications. Can be any
692
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
693
+ # @param [Google::Apis::RequestOptions] options
694
+ # Request-specific options
695
+ #
696
+ # @yield [result, err] Result & error if block supplied
697
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditReport] parsed result object
698
+ # @yieldparam err [StandardError] error object if request failed
699
+ #
700
+ # @return [Google::Apis::AuditmanagerV1::AuditReport]
701
+ #
702
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
703
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
704
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
705
+ def get_organization_location_audit_report(name, fields: nil, quota_user: nil, options: nil, &block)
706
+ command = make_simple_command(:get, 'v1/{+name}', options)
707
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditReport::Representation
708
+ command.response_class = Google::Apis::AuditmanagerV1::AuditReport
709
+ command.params['name'] = name unless name.nil?
710
+ command.query['fields'] = fields unless fields.nil?
711
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
712
+ execute_or_queue_command(command, &block)
713
+ end
714
+
715
+ # Lists the audit reports for the organization, folder, or project that you
716
+ # specify as the parent scope.
717
+ # @param [String] parent
718
+ # Required. Parent organization, folder, or project to list reports for, in one
719
+ # of the following formats: * `projects/`project`/locations/`location`` * `
720
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
721
+ # locations/`location``
722
+ # @param [Fixnum] page_size
723
+ # Optional. Maximum number of items to return in a single page. The service
724
+ # might return fewer items than this value. If unspecified, the service picks an
725
+ # appropriate default. The maximum value is 100; values above 100 are reduced to
726
+ # 100.
727
+ # @param [String] page_token
728
+ # Optional. A page token, received from a previous call, to retrieve the next
729
+ # page of results.
730
+ # @param [String] fields
731
+ # Selector specifying which fields to include in a partial response.
732
+ # @param [String] quota_user
733
+ # Available to use for quota purposes for server-side applications. Can be any
734
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
735
+ # @param [Google::Apis::RequestOptions] options
736
+ # Request-specific options
737
+ #
738
+ # @yield [result, err] Result & error if block supplied
739
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListAuditReportsResponse] parsed result object
740
+ # @yieldparam err [StandardError] error object if request failed
741
+ #
742
+ # @return [Google::Apis::AuditmanagerV1::ListAuditReportsResponse]
743
+ #
744
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
745
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
746
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
747
+ def list_organization_location_audit_reports(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
748
+ command = make_simple_command(:get, 'v1/{+parent}/auditReports', options)
749
+ command.response_representation = Google::Apis::AuditmanagerV1::ListAuditReportsResponse::Representation
750
+ command.response_class = Google::Apis::AuditmanagerV1::ListAuditReportsResponse
751
+ command.params['parent'] = parent unless parent.nil?
752
+ command.query['pageSize'] = page_size unless page_size.nil?
753
+ command.query['pageToken'] = page_token unless page_token.nil?
754
+ command.query['fields'] = fields unless fields.nil?
755
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
756
+ execute_or_queue_command(command, &block)
757
+ end
758
+
759
+ # Creates a new audit schedule in a given project and location.
760
+ # @param [String] parent
761
+ # Required. Project or folder that this audit schedule is for, in one of the
762
+ # following formats: * `projects/`project`/locations/`location`` * `folders/`
763
+ # folder`/locations/`location``
764
+ # @param [Google::Apis::AuditmanagerV1::AuditSchedule] audit_schedule_object
765
+ # @param [String] audit_schedule_id
766
+ # Required. ID to use for the audit schedule, which becomes the final component
767
+ # of the audit schedule's resource name.
768
+ # @param [Boolean] validate_only
769
+ # Optional. If `true`, only validates the request and does not create the audit
770
+ # schedule. This executes standard request validation (such as schema, framework
771
+ # existence, scope, and IAM checks) and skips the apply phase. Use this field
772
+ # for the following purposes: * **Infrastructure as Code (IaC)**: Allow tools
773
+ # like Terraform to run dry-run mutations (e.g., `terraform plan`) without
774
+ # creating real resources or incurring costs. * **User Interface Validation**:
775
+ # Enable real-time form and permission validation in custom UIs before
776
+ # submitting requests. * **CI/CD & Automation**: Test your scripts, permissions,
777
+ # and parameters safely without consuming resource quotas.
778
+ # @param [String] fields
779
+ # Selector specifying which fields to include in a partial response.
780
+ # @param [String] quota_user
781
+ # Available to use for quota purposes for server-side applications. Can be any
782
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
783
+ # @param [Google::Apis::RequestOptions] options
784
+ # Request-specific options
785
+ #
786
+ # @yield [result, err] Result & error if block supplied
787
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditSchedule] parsed result object
788
+ # @yieldparam err [StandardError] error object if request failed
789
+ #
790
+ # @return [Google::Apis::AuditmanagerV1::AuditSchedule]
791
+ #
792
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
793
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
794
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
795
+ def create_organization_location_audit_schedule(parent, audit_schedule_object = nil, audit_schedule_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
796
+ command = make_simple_command(:post, 'v1/{+parent}/auditSchedules', options)
797
+ command.request_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
798
+ command.request_object = audit_schedule_object
799
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
800
+ command.response_class = Google::Apis::AuditmanagerV1::AuditSchedule
801
+ command.params['parent'] = parent unless parent.nil?
802
+ command.query['auditScheduleId'] = audit_schedule_id unless audit_schedule_id.nil?
803
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
804
+ command.query['fields'] = fields unless fields.nil?
805
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
806
+ execute_or_queue_command(command, &block)
807
+ end
808
+
809
+ # Gets details of a single audit schedule.
810
+ # @param [String] name
811
+ # Required. Name of the audit schedule to retrieve, in one of the following
812
+ # formats: * `projects/`project`/locations/`location`/auditSchedules/`
813
+ # audit_schedule`` * `folders/`folder`/locations/`location`/auditSchedules/`
814
+ # audit_schedule`` * `organizations/`organization`/locations/`location`/
815
+ # auditSchedules/`audit_schedule``
816
+ # @param [String] fields
817
+ # Selector specifying which fields to include in a partial response.
818
+ # @param [String] quota_user
819
+ # Available to use for quota purposes for server-side applications. Can be any
820
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
821
+ # @param [Google::Apis::RequestOptions] options
822
+ # Request-specific options
823
+ #
824
+ # @yield [result, err] Result & error if block supplied
825
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditSchedule] parsed result object
826
+ # @yieldparam err [StandardError] error object if request failed
827
+ #
828
+ # @return [Google::Apis::AuditmanagerV1::AuditSchedule]
829
+ #
830
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
831
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
832
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
833
+ def get_organization_location_audit_schedule(name, fields: nil, quota_user: nil, options: nil, &block)
834
+ command = make_simple_command(:get, 'v1/{+name}', options)
835
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
836
+ command.response_class = Google::Apis::AuditmanagerV1::AuditSchedule
837
+ command.params['name'] = name unless name.nil?
838
+ command.query['fields'] = fields unless fields.nil?
839
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
840
+ execute_or_queue_command(command, &block)
841
+ end
842
+
843
+ # Lists audit schedules in a given project and location.
844
+ # @param [String] parent
845
+ # Required. Parent for the audit schedule, in one of the following formats: * `
846
+ # projects/`project`/locations/`location`` * `folders/`folder`/locations/`
847
+ # location`` * `organizations/`organization`/locations/`location``
848
+ # @param [Fixnum] page_size
849
+ # Optional. Maximum number of items to return in a single page. The service
850
+ # might return fewer items than this value. If unspecified, the service picks an
851
+ # appropriate default. The maximum value is 100; values above 100 are reduced to
852
+ # 100.
853
+ # @param [String] page_token
854
+ # Optional. A page token, received from a previous call, to retrieve the next
855
+ # page of results.
856
+ # @param [String] fields
857
+ # Selector specifying which fields to include in a partial response.
858
+ # @param [String] quota_user
859
+ # Available to use for quota purposes for server-side applications. Can be any
860
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
861
+ # @param [Google::Apis::RequestOptions] options
862
+ # Request-specific options
863
+ #
864
+ # @yield [result, err] Result & error if block supplied
865
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse] parsed result object
866
+ # @yieldparam err [StandardError] error object if request failed
867
+ #
868
+ # @return [Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse]
869
+ #
870
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
871
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
872
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
873
+ def list_organization_location_audit_schedules(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
874
+ command = make_simple_command(:get, 'v1/{+parent}/auditSchedules', options)
875
+ command.response_representation = Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse::Representation
876
+ command.response_class = Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse
877
+ command.params['parent'] = parent unless parent.nil?
878
+ command.query['pageSize'] = page_size unless page_size.nil?
879
+ command.query['pageToken'] = page_token unless page_token.nil?
880
+ command.query['fields'] = fields unless fields.nil?
881
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
882
+ execute_or_queue_command(command, &block)
883
+ end
884
+
885
+ # Updates an existing audit schedule.
886
+ # @param [String] name
887
+ # Identifier. Unique identifier for the audit schedule. Format: projects/`
888
+ # project`/locations/`location`/auditSchedules/`audit_schedule` folders/`folder`/
889
+ # locations/`location`/auditSchedules/`audit_schedule` organizations/`
890
+ # organization`/locations/`location`/auditSchedules/`audit_schedule`
891
+ # @param [Google::Apis::AuditmanagerV1::AuditSchedule] audit_schedule_object
892
+ # @param [String] update_mask
893
+ # Optional. List of fields to update.
894
+ # @param [Boolean] validate_only
895
+ # Optional. If `true`, only validates the request and does not update the audit
896
+ # schedule. This executes standard request validation (such as schema, framework
897
+ # existence, scope, and IAM checks) and skips the apply phase. Use this field
898
+ # for the following purposes: * **Infrastructure as Code (IaC)**: Allow tools
899
+ # like Terraform to run dry-run mutations (e.g., `terraform plan`) without
900
+ # creating real resources or incurring costs. * **User Interface Validation**:
901
+ # Enable real-time form and permission validation in custom UIs before
902
+ # submitting requests. * **CI/CD & Automation**: Test your scripts, permissions,
903
+ # and parameters safely without consuming resource quotas.
904
+ # @param [String] fields
905
+ # Selector specifying which fields to include in a partial response.
906
+ # @param [String] quota_user
907
+ # Available to use for quota purposes for server-side applications. Can be any
908
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
909
+ # @param [Google::Apis::RequestOptions] options
910
+ # Request-specific options
911
+ #
912
+ # @yield [result, err] Result & error if block supplied
913
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditSchedule] parsed result object
914
+ # @yieldparam err [StandardError] error object if request failed
915
+ #
916
+ # @return [Google::Apis::AuditmanagerV1::AuditSchedule]
917
+ #
918
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
919
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
920
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
921
+ def patch_organization_location_audit_schedule(name, audit_schedule_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
922
+ command = make_simple_command(:patch, 'v1/{+name}', options)
923
+ command.request_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
924
+ command.request_object = audit_schedule_object
925
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
926
+ command.response_class = Google::Apis::AuditmanagerV1::AuditSchedule
927
+ command.params['name'] = name unless name.nil?
928
+ command.query['updateMask'] = update_mask unless update_mask.nil?
929
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
930
+ command.query['fields'] = fields unless fields.nil?
931
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
932
+ execute_or_queue_command(command, &block)
933
+ end
934
+
935
+ # Generates an audit scope report for the given standard. The report includes
936
+ # the following: * The technical attributes and constraints that Audit Manager
937
+ # uses to verify your compliance with a framework. * A list of Google Cloud
938
+ # services and resources that are within the scope of the framework.
939
+ # @param [String] scope
940
+ # Required. Project or folder that the audit scope report is generated for, in
941
+ # one of the following formats: * `projects/`project`/locations/`location`` * `
942
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
943
+ # locations/`location``
944
+ # @param [Google::Apis::AuditmanagerV1::GenerateAuditScopeReportRequest] generate_audit_scope_report_request_object
945
+ # @param [String] fields
946
+ # Selector specifying which fields to include in a partial response.
947
+ # @param [String] quota_user
948
+ # Available to use for quota purposes for server-side applications. Can be any
949
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
950
+ # @param [Google::Apis::RequestOptions] options
951
+ # Request-specific options
952
+ #
953
+ # @yield [result, err] Result & error if block supplied
954
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditScopeReport] parsed result object
955
+ # @yieldparam err [StandardError] error object if request failed
956
+ #
957
+ # @return [Google::Apis::AuditmanagerV1::AuditScopeReport]
958
+ #
959
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
960
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
961
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
962
+ def generate_organization_location_audit_scope_report(scope, generate_audit_scope_report_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
963
+ command = make_simple_command(:post, 'v1/{+scope}/auditScopeReports:generate', options)
964
+ command.request_representation = Google::Apis::AuditmanagerV1::GenerateAuditScopeReportRequest::Representation
965
+ command.request_object = generate_audit_scope_report_request_object
966
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditScopeReport::Representation
967
+ command.response_class = Google::Apis::AuditmanagerV1::AuditScopeReport
968
+ command.params['scope'] = scope unless scope.nil?
969
+ command.query['fields'] = fields unless fields.nil?
970
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
971
+ execute_or_queue_command(command, &block)
972
+ end
973
+
974
+ # Gets details about the long-running operation to generate audit reports.
975
+ # @param [String] name
976
+ # The name of the operation resource.
977
+ # @param [String] fields
978
+ # Selector specifying which fields to include in a partial response.
979
+ # @param [String] quota_user
980
+ # Available to use for quota purposes for server-side applications. Can be any
981
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
982
+ # @param [Google::Apis::RequestOptions] options
983
+ # Request-specific options
984
+ #
985
+ # @yield [result, err] Result & error if block supplied
986
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Operation] parsed result object
987
+ # @yieldparam err [StandardError] error object if request failed
988
+ #
989
+ # @return [Google::Apis::AuditmanagerV1::Operation]
990
+ #
991
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
992
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
993
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
994
+ def get_organization_location_operation_detail(name, fields: nil, quota_user: nil, options: nil, &block)
995
+ command = make_simple_command(:get, 'v1/{+name}', options)
996
+ command.response_representation = Google::Apis::AuditmanagerV1::Operation::Representation
997
+ command.response_class = Google::Apis::AuditmanagerV1::Operation
998
+ command.params['name'] = name unless name.nil?
999
+ command.query['fields'] = fields unless fields.nil?
1000
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1001
+ execute_or_queue_command(command, &block)
1002
+ end
1003
+
1004
+ # Gets details about the long-running operation to generate audit reports.
1005
+ # @param [String] name
1006
+ # The name of the operation resource.
1007
+ # @param [String] fields
1008
+ # Selector specifying which fields to include in a partial response.
1009
+ # @param [String] quota_user
1010
+ # Available to use for quota purposes for server-side applications. Can be any
1011
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1012
+ # @param [Google::Apis::RequestOptions] options
1013
+ # Request-specific options
1014
+ #
1015
+ # @yield [result, err] Result & error if block supplied
1016
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Operation] parsed result object
1017
+ # @yieldparam err [StandardError] error object if request failed
1018
+ #
1019
+ # @return [Google::Apis::AuditmanagerV1::Operation]
1020
+ #
1021
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1022
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1023
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1024
+ def get_organization_location_operation_id(name, fields: nil, quota_user: nil, options: nil, &block)
1025
+ command = make_simple_command(:get, 'v1/{+name}', options)
1026
+ command.response_representation = Google::Apis::AuditmanagerV1::Operation::Representation
1027
+ command.response_class = Google::Apis::AuditmanagerV1::Operation
1028
+ command.params['name'] = name unless name.nil?
1029
+ command.query['fields'] = fields unless fields.nil?
1030
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1031
+ execute_or_queue_command(command, &block)
1032
+ end
1033
+
1034
+ # Starts asynchronous cancellation on a long-running operation. The server makes
1035
+ # a best effort to cancel the operation, but success is not guaranteed. If the
1036
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
1037
+ # Clients can use Operations.GetOperation or other methods to check whether the
1038
+ # cancellation succeeded or whether the operation completed despite cancellation.
1039
+ # On successful cancellation, the operation is not deleted; instead, it becomes
1040
+ # an operation with an Operation.error value with a google.rpc.Status.code of `1`
1041
+ # , corresponding to `Code.CANCELLED`.
1042
+ # @param [String] name
1043
+ # The name of the operation resource to be cancelled.
1044
+ # @param [Google::Apis::AuditmanagerV1::CancelOperationRequest] cancel_operation_request_object
1045
+ # @param [String] fields
1046
+ # Selector specifying which fields to include in a partial response.
1047
+ # @param [String] quota_user
1048
+ # Available to use for quota purposes for server-side applications. Can be any
1049
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1050
+ # @param [Google::Apis::RequestOptions] options
1051
+ # Request-specific options
1052
+ #
1053
+ # @yield [result, err] Result & error if block supplied
1054
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Empty] parsed result object
1055
+ # @yieldparam err [StandardError] error object if request failed
1056
+ #
1057
+ # @return [Google::Apis::AuditmanagerV1::Empty]
1058
+ #
1059
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1060
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1061
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1062
+ def cancel_organization_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1063
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
1064
+ command.request_representation = Google::Apis::AuditmanagerV1::CancelOperationRequest::Representation
1065
+ command.request_object = cancel_operation_request_object
1066
+ command.response_representation = Google::Apis::AuditmanagerV1::Empty::Representation
1067
+ command.response_class = Google::Apis::AuditmanagerV1::Empty
1068
+ command.params['name'] = name unless name.nil?
1069
+ command.query['fields'] = fields unless fields.nil?
1070
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1071
+ execute_or_queue_command(command, &block)
1072
+ end
1073
+
1074
+ # Deletes a long-running operation. This method indicates that the client is no
1075
+ # longer interested in the operation result. It does not cancel the operation.
1076
+ # If the server doesn't support this method, it returns `google.rpc.Code.
1077
+ # UNIMPLEMENTED`.
1078
+ # @param [String] name
1079
+ # The name of the operation resource to be deleted.
1080
+ # @param [String] fields
1081
+ # Selector specifying which fields to include in a partial response.
1082
+ # @param [String] quota_user
1083
+ # Available to use for quota purposes for server-side applications. Can be any
1084
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1085
+ # @param [Google::Apis::RequestOptions] options
1086
+ # Request-specific options
1087
+ #
1088
+ # @yield [result, err] Result & error if block supplied
1089
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Empty] parsed result object
1090
+ # @yieldparam err [StandardError] error object if request failed
1091
+ #
1092
+ # @return [Google::Apis::AuditmanagerV1::Empty]
1093
+ #
1094
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1095
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1096
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1097
+ def delete_organization_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1098
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1099
+ command.response_representation = Google::Apis::AuditmanagerV1::Empty::Representation
1100
+ command.response_class = Google::Apis::AuditmanagerV1::Empty
1101
+ command.params['name'] = name unless name.nil?
1102
+ command.query['fields'] = fields unless fields.nil?
1103
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1104
+ execute_or_queue_command(command, &block)
1105
+ end
1106
+
1107
+ # Gets the latest state of a long-running operation. Clients can use this method
1108
+ # to poll the operation result at intervals as recommended by the API service.
1109
+ # @param [String] name
1110
+ # The name of the operation resource.
1111
+ # @param [String] fields
1112
+ # Selector specifying which fields to include in a partial response.
1113
+ # @param [String] quota_user
1114
+ # Available to use for quota purposes for server-side applications. Can be any
1115
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1116
+ # @param [Google::Apis::RequestOptions] options
1117
+ # Request-specific options
1118
+ #
1119
+ # @yield [result, err] Result & error if block supplied
1120
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Operation] parsed result object
1121
+ # @yieldparam err [StandardError] error object if request failed
1122
+ #
1123
+ # @return [Google::Apis::AuditmanagerV1::Operation]
1124
+ #
1125
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1126
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1127
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1128
+ def get_organization_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1129
+ command = make_simple_command(:get, 'v1/{+name}', options)
1130
+ command.response_representation = Google::Apis::AuditmanagerV1::Operation::Representation
1131
+ command.response_class = Google::Apis::AuditmanagerV1::Operation
1132
+ command.params['name'] = name unless name.nil?
1133
+ command.query['fields'] = fields unless fields.nil?
1134
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1135
+ execute_or_queue_command(command, &block)
1136
+ end
1137
+
1138
+ # Lists operations that match the specified filter in the request. If the server
1139
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
1140
+ # @param [String] name
1141
+ # The name of the operation's parent resource.
1142
+ # @param [String] filter
1143
+ # The standard list filter.
1144
+ # @param [Fixnum] page_size
1145
+ # The standard list page size.
1146
+ # @param [String] page_token
1147
+ # The standard list page token.
1148
+ # @param [Boolean] return_partial_success
1149
+ # When set to `true`, operations that are reachable are returned as normal, and
1150
+ # those that are unreachable are returned in the ListOperationsResponse.
1151
+ # unreachable field. This can only be `true` when reading across collections.
1152
+ # For example, when `parent` is set to `"projects/example/locations/-"`. This
1153
+ # field is not supported by default and will result in an `UNIMPLEMENTED` error
1154
+ # if set unless explicitly documented otherwise in service or product specific
1155
+ # documentation.
1156
+ # @param [String] fields
1157
+ # Selector specifying which fields to include in a partial response.
1158
+ # @param [String] quota_user
1159
+ # Available to use for quota purposes for server-side applications. Can be any
1160
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1161
+ # @param [Google::Apis::RequestOptions] options
1162
+ # Request-specific options
1163
+ #
1164
+ # @yield [result, err] Result & error if block supplied
1165
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListOperationsResponse] parsed result object
1166
+ # @yieldparam err [StandardError] error object if request failed
1167
+ #
1168
+ # @return [Google::Apis::AuditmanagerV1::ListOperationsResponse]
1169
+ #
1170
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1171
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1172
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1173
+ def list_organization_location_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
1174
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
1175
+ command.response_representation = Google::Apis::AuditmanagerV1::ListOperationsResponse::Representation
1176
+ command.response_class = Google::Apis::AuditmanagerV1::ListOperationsResponse
1177
+ command.params['name'] = name unless name.nil?
1178
+ command.query['filter'] = filter unless filter.nil?
1179
+ command.query['pageSize'] = page_size unless page_size.nil?
1180
+ command.query['pageToken'] = page_token unless page_token.nil?
1181
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
1182
+ command.query['fields'] = fields unless fields.nil?
1183
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1184
+ execute_or_queue_command(command, &block)
1185
+ end
1186
+
1187
+ # Gets a resource and its enrollment status.
1188
+ # @param [String] name
1189
+ # Required. Name of the resource enrollment status, in one of the following
1190
+ # formats: * `folders/`folder`/locations/`location`/resourceEnrollmentStatuses/`
1191
+ # resource_enrollment_status`` * `projects/`project`/locations/`location`/
1192
+ # resourceEnrollmentStatuses/`resource_enrollment_status`` * `organizations/`
1193
+ # organization`/locations/`location`/resourceEnrollmentStatuses/`
1194
+ # resource_enrollment_status``
1195
+ # @param [String] fields
1196
+ # Selector specifying which fields to include in a partial response.
1197
+ # @param [String] quota_user
1198
+ # Available to use for quota purposes for server-side applications. Can be any
1199
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1200
+ # @param [Google::Apis::RequestOptions] options
1201
+ # Request-specific options
1202
+ #
1203
+ # @yield [result, err] Result & error if block supplied
1204
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus] parsed result object
1205
+ # @yieldparam err [StandardError] error object if request failed
1206
+ #
1207
+ # @return [Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus]
1208
+ #
1209
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1210
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1211
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1212
+ def get_organization_location_resource_enrollment_status(name, fields: nil, quota_user: nil, options: nil, &block)
1213
+ command = make_simple_command(:get, 'v1/{+name}', options)
1214
+ command.response_representation = Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus::Representation
1215
+ command.response_class = Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus
1216
+ command.params['name'] = name unless name.nil?
1217
+ command.query['fields'] = fields unless fields.nil?
1218
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1219
+ execute_or_queue_command(command, &block)
1220
+ end
1221
+
1222
+ # Lists all the folders and projects in an organization or folder, along with
1223
+ # their enrollments.
1224
+ # @param [String] parent
1225
+ # Required. Parent organization or folder to list enrollment statuses for, in
1226
+ # one of the following formats: * `folders/`folder`/locations/`location`` * `
1227
+ # organizations/`organization`/locations/`location``
1228
+ # @param [Fixnum] page_size
1229
+ # Optional. Maximum number of items to return in a single page. The service
1230
+ # might return fewer items than this value. If unspecified, the service picks an
1231
+ # appropriate default. The maximum value is 100; values above 100 are reduced to
1232
+ # 100.
1233
+ # @param [String] page_token
1234
+ # Optional. A page token, received from a previous call, to retrieve the next
1235
+ # page of results.
1236
+ # @param [String] fields
1237
+ # Selector specifying which fields to include in a partial response.
1238
+ # @param [String] quota_user
1239
+ # Available to use for quota purposes for server-side applications. Can be any
1240
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1241
+ # @param [Google::Apis::RequestOptions] options
1242
+ # Request-specific options
1243
+ #
1244
+ # @yield [result, err] Result & error if block supplied
1245
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListResourceEnrollmentStatusesResponse] parsed result object
1246
+ # @yieldparam err [StandardError] error object if request failed
1247
+ #
1248
+ # @return [Google::Apis::AuditmanagerV1::ListResourceEnrollmentStatusesResponse]
1249
+ #
1250
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1251
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1252
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1253
+ def list_organization_location_resource_enrollment_statuses(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1254
+ command = make_simple_command(:get, 'v1/{+parent}/resourceEnrollmentStatuses', options)
1255
+ command.response_representation = Google::Apis::AuditmanagerV1::ListResourceEnrollmentStatusesResponse::Representation
1256
+ command.response_class = Google::Apis::AuditmanagerV1::ListResourceEnrollmentStatusesResponse
1257
+ command.params['parent'] = parent unless parent.nil?
1258
+ command.query['pageSize'] = page_size unless page_size.nil?
1259
+ command.query['pageToken'] = page_token unless page_token.nil?
1260
+ command.query['fields'] = fields unless fields.nil?
1261
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1262
+ execute_or_queue_command(command, &block)
1263
+ end
1264
+
1265
+ # Lists the controls that you must implement to become compliant to a regulatory
1266
+ # standard.
1267
+ # @param [String] parent
1268
+ # Required. Standard to list controls for, in one of the following formats: * `
1269
+ # projects/`project`/locations/`location`/standards/`standard`` * `folders/`
1270
+ # folder`/locations/`location`/standards/`standard`` * `organizations/`
1271
+ # organization`/locations/`location`/standards/`standard``
1272
+ # @param [Fixnum] page_size
1273
+ # Optional. Maximum number of items to return in a single page. The service
1274
+ # might return fewer items than this value. If unspecified, the service picks an
1275
+ # appropriate default. The maximum value is 100; values above 100 are reduced to
1276
+ # 100.
1277
+ # @param [String] page_token
1278
+ # Optional. A page token, received from a previous call, to retrieve the next
1279
+ # page of results.
1280
+ # @param [String] fields
1281
+ # Selector specifying which fields to include in a partial response.
1282
+ # @param [String] quota_user
1283
+ # Available to use for quota purposes for server-side applications. Can be any
1284
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1285
+ # @param [Google::Apis::RequestOptions] options
1286
+ # Request-specific options
1287
+ #
1288
+ # @yield [result, err] Result & error if block supplied
1289
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListControlsResponse] parsed result object
1290
+ # @yieldparam err [StandardError] error object if request failed
1291
+ #
1292
+ # @return [Google::Apis::AuditmanagerV1::ListControlsResponse]
1293
+ #
1294
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1295
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1296
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1297
+ def list_organization_location_standard_controls(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1298
+ command = make_simple_command(:get, 'v1/{+parent}/controls', options)
1299
+ command.response_representation = Google::Apis::AuditmanagerV1::ListControlsResponse::Representation
1300
+ command.response_class = Google::Apis::AuditmanagerV1::ListControlsResponse
1301
+ command.params['parent'] = parent unless parent.nil?
1302
+ command.query['pageSize'] = page_size unless page_size.nil?
1303
+ command.query['pageToken'] = page_token unless page_token.nil?
1304
+ command.query['fields'] = fields unless fields.nil?
1305
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1306
+ execute_or_queue_command(command, &block)
1307
+ end
1308
+
1309
+ # Adds your project, folder, or organization to Audit Manager. This method
1310
+ # creates the Audit Manager service agent in your workload and grants required
1311
+ # permissions to the service agent. If you make this request on a workload that'
1312
+ # s already enrolled, then this method overrides the existing set of
1313
+ # destinations.
1314
+ # @param [String] scope
1315
+ # Required. Organization, folder, or project to enroll in Audit Manager, in one
1316
+ # of the following formats: * `projects/`project`/locations/`location`` * `
1317
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
1318
+ # locations/`location``
1319
+ # @param [Google::Apis::AuditmanagerV1::EnrollResourceRequest] enroll_resource_request_object
1320
+ # @param [String] fields
1321
+ # Selector specifying which fields to include in a partial response.
1322
+ # @param [String] quota_user
1323
+ # Available to use for quota purposes for server-side applications. Can be any
1324
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1325
+ # @param [Google::Apis::RequestOptions] options
1326
+ # Request-specific options
1327
+ #
1328
+ # @yield [result, err] Result & error if block supplied
1329
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Enrollment] parsed result object
1330
+ # @yieldparam err [StandardError] error object if request failed
1331
+ #
1332
+ # @return [Google::Apis::AuditmanagerV1::Enrollment]
1333
+ #
1334
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1335
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1336
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1337
+ def enroll_project_location_resource(scope, enroll_resource_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1338
+ command = make_simple_command(:post, 'v1/{+scope}:enrollResource', options)
1339
+ command.request_representation = Google::Apis::AuditmanagerV1::EnrollResourceRequest::Representation
1340
+ command.request_object = enroll_resource_request_object
1341
+ command.response_representation = Google::Apis::AuditmanagerV1::Enrollment::Representation
1342
+ command.response_class = Google::Apis::AuditmanagerV1::Enrollment
1343
+ command.params['scope'] = scope unless scope.nil?
1344
+ command.query['fields'] = fields unless fields.nil?
1345
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1346
+ execute_or_queue_command(command, &block)
1347
+ end
1348
+
1349
+ # Gets information about a location.
1350
+ # @param [String] name
1351
+ # Resource name for the location.
1352
+ # @param [String] fields
1353
+ # Selector specifying which fields to include in a partial response.
1354
+ # @param [String] quota_user
1355
+ # Available to use for quota purposes for server-side applications. Can be any
1356
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1357
+ # @param [Google::Apis::RequestOptions] options
1358
+ # Request-specific options
1359
+ #
1360
+ # @yield [result, err] Result & error if block supplied
1361
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Location] parsed result object
1362
+ # @yieldparam err [StandardError] error object if request failed
1363
+ #
1364
+ # @return [Google::Apis::AuditmanagerV1::Location]
1365
+ #
1366
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1367
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1368
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1369
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
1370
+ command = make_simple_command(:get, 'v1/{+name}', options)
1371
+ command.response_representation = Google::Apis::AuditmanagerV1::Location::Representation
1372
+ command.response_class = Google::Apis::AuditmanagerV1::Location
1373
+ command.params['name'] = name unless name.nil?
1374
+ command.query['fields'] = fields unless fields.nil?
1375
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1376
+ execute_or_queue_command(command, &block)
1377
+ end
1378
+
1379
+ # Lists information about the supported locations for this service. This method
1380
+ # lists locations based on the resource scope provided in the
1381
+ # ListLocationsRequest.name field: * **Global locations**: If `name` is empty,
1382
+ # the method lists the public locations available to all projects. * **Project-
1383
+ # specific locations**: If `name` follows the format `projects/`project``, the
1384
+ # method lists locations visible to that specific project. This includes public,
1385
+ # private, or other project-specific locations enabled for the project. For gRPC
1386
+ # and client library implementations, the resource name is passed as the `name`
1387
+ # field. For direct service calls, the resource name is incorporated into the
1388
+ # request path based on the specific service implementation and version.
1389
+ # @param [String] name
1390
+ # The resource that owns the locations collection, if applicable.
1391
+ # @param [Array<String>, String] extra_location_types
1392
+ # Optional. Do not use this field unless explicitly documented otherwise. This
1393
+ # is primarily for internal usage.
1394
+ # @param [String] filter
1395
+ # A filter to narrow down results to a preferred subset. The filtering language
1396
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
1397
+ # in [AIP-160](https://google.aip.dev/160).
1398
+ # @param [Fixnum] page_size
1399
+ # The maximum number of results to return. If not set, the service selects a
1400
+ # default.
1401
+ # @param [String] page_token
1402
+ # A page token received from the `next_page_token` field in the response. Send
1403
+ # that page token to receive the subsequent page.
1404
+ # @param [String] fields
1405
+ # Selector specifying which fields to include in a partial response.
1406
+ # @param [String] quota_user
1407
+ # Available to use for quota purposes for server-side applications. Can be any
1408
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1409
+ # @param [Google::Apis::RequestOptions] options
1410
+ # Request-specific options
1411
+ #
1412
+ # @yield [result, err] Result & error if block supplied
1413
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListLocationsResponse] parsed result object
1414
+ # @yieldparam err [StandardError] error object if request failed
1415
+ #
1416
+ # @return [Google::Apis::AuditmanagerV1::ListLocationsResponse]
1417
+ #
1418
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1419
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1420
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1421
+ def list_project_locations(name, extra_location_types: nil, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1422
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
1423
+ command.response_representation = Google::Apis::AuditmanagerV1::ListLocationsResponse::Representation
1424
+ command.response_class = Google::Apis::AuditmanagerV1::ListLocationsResponse
1425
+ command.params['name'] = name unless name.nil?
1426
+ command.query['extraLocationTypes'] = extra_location_types unless extra_location_types.nil?
1427
+ command.query['filter'] = filter unless filter.nil?
1428
+ command.query['pageSize'] = page_size unless page_size.nil?
1429
+ command.query['pageToken'] = page_token unless page_token.nil?
1430
+ command.query['fields'] = fields unless fields.nil?
1431
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1432
+ execute_or_queue_command(command, &block)
1433
+ end
1434
+
1435
+ # Registers audit report generation requests. This method returns the operation
1436
+ # identifier that you can use to track the report generation progress.
1437
+ # @param [String] scope
1438
+ # Required. Organization, folder, or project that the audit applies to, in one
1439
+ # of the following formats: * `projects/`project`/locations/`location`` * `
1440
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
1441
+ # locations/`location``
1442
+ # @param [Google::Apis::AuditmanagerV1::GenerateAuditReportRequest] generate_audit_report_request_object
1443
+ # @param [String] fields
1444
+ # Selector specifying which fields to include in a partial response.
1445
+ # @param [String] quota_user
1446
+ # Available to use for quota purposes for server-side applications. Can be any
1447
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1448
+ # @param [Google::Apis::RequestOptions] options
1449
+ # Request-specific options
1450
+ #
1451
+ # @yield [result, err] Result & error if block supplied
1452
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Operation] parsed result object
1453
+ # @yieldparam err [StandardError] error object if request failed
1454
+ #
1455
+ # @return [Google::Apis::AuditmanagerV1::Operation]
1456
+ #
1457
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1458
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1459
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1460
+ def generate_project_location_audit_report(scope, generate_audit_report_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1461
+ command = make_simple_command(:post, 'v1/{+scope}/auditReports:generate', options)
1462
+ command.request_representation = Google::Apis::AuditmanagerV1::GenerateAuditReportRequest::Representation
1463
+ command.request_object = generate_audit_report_request_object
1464
+ command.response_representation = Google::Apis::AuditmanagerV1::Operation::Representation
1465
+ command.response_class = Google::Apis::AuditmanagerV1::Operation
1466
+ command.params['scope'] = scope unless scope.nil?
1467
+ command.query['fields'] = fields unless fields.nil?
1468
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1469
+ execute_or_queue_command(command, &block)
1470
+ end
1471
+
1472
+ # Gets the full metadata and findings for an audit report.
1473
+ # @param [String] name
1474
+ # Required. Name of the audit report, in one of the following formats: * `
1475
+ # projects/`project`/locations/`location`/auditReports/`audit_report`` * `
1476
+ # folders/`folder`/locations/`location`/auditReports/`audit_report`` * `
1477
+ # organizations/`organization`/locations/`location`/auditReports/`audit_report``
1478
+ # @param [String] fields
1479
+ # Selector specifying which fields to include in a partial response.
1480
+ # @param [String] quota_user
1481
+ # Available to use for quota purposes for server-side applications. Can be any
1482
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1483
+ # @param [Google::Apis::RequestOptions] options
1484
+ # Request-specific options
1485
+ #
1486
+ # @yield [result, err] Result & error if block supplied
1487
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditReport] parsed result object
1488
+ # @yieldparam err [StandardError] error object if request failed
1489
+ #
1490
+ # @return [Google::Apis::AuditmanagerV1::AuditReport]
1491
+ #
1492
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1493
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1494
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1495
+ def get_project_location_audit_report(name, fields: nil, quota_user: nil, options: nil, &block)
1496
+ command = make_simple_command(:get, 'v1/{+name}', options)
1497
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditReport::Representation
1498
+ command.response_class = Google::Apis::AuditmanagerV1::AuditReport
1499
+ command.params['name'] = name unless name.nil?
1500
+ command.query['fields'] = fields unless fields.nil?
1501
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1502
+ execute_or_queue_command(command, &block)
1503
+ end
1504
+
1505
+ # Lists the audit reports for the organization, folder, or project that you
1506
+ # specify as the parent scope.
1507
+ # @param [String] parent
1508
+ # Required. Parent organization, folder, or project to list reports for, in one
1509
+ # of the following formats: * `projects/`project`/locations/`location`` * `
1510
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
1511
+ # locations/`location``
1512
+ # @param [Fixnum] page_size
1513
+ # Optional. Maximum number of items to return in a single page. The service
1514
+ # might return fewer items than this value. If unspecified, the service picks an
1515
+ # appropriate default. The maximum value is 100; values above 100 are reduced to
1516
+ # 100.
1517
+ # @param [String] page_token
1518
+ # Optional. A page token, received from a previous call, to retrieve the next
1519
+ # page of results.
1520
+ # @param [String] fields
1521
+ # Selector specifying which fields to include in a partial response.
1522
+ # @param [String] quota_user
1523
+ # Available to use for quota purposes for server-side applications. Can be any
1524
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1525
+ # @param [Google::Apis::RequestOptions] options
1526
+ # Request-specific options
1527
+ #
1528
+ # @yield [result, err] Result & error if block supplied
1529
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListAuditReportsResponse] parsed result object
1530
+ # @yieldparam err [StandardError] error object if request failed
1531
+ #
1532
+ # @return [Google::Apis::AuditmanagerV1::ListAuditReportsResponse]
1533
+ #
1534
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1535
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1536
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1537
+ def list_project_location_audit_reports(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1538
+ command = make_simple_command(:get, 'v1/{+parent}/auditReports', options)
1539
+ command.response_representation = Google::Apis::AuditmanagerV1::ListAuditReportsResponse::Representation
1540
+ command.response_class = Google::Apis::AuditmanagerV1::ListAuditReportsResponse
1541
+ command.params['parent'] = parent unless parent.nil?
1542
+ command.query['pageSize'] = page_size unless page_size.nil?
1543
+ command.query['pageToken'] = page_token unless page_token.nil?
1544
+ command.query['fields'] = fields unless fields.nil?
1545
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1546
+ execute_or_queue_command(command, &block)
1547
+ end
1548
+
1549
+ # Creates a new audit schedule in a given project and location.
1550
+ # @param [String] parent
1551
+ # Required. Project or folder that this audit schedule is for, in one of the
1552
+ # following formats: * `projects/`project`/locations/`location`` * `folders/`
1553
+ # folder`/locations/`location``
1554
+ # @param [Google::Apis::AuditmanagerV1::AuditSchedule] audit_schedule_object
1555
+ # @param [String] audit_schedule_id
1556
+ # Required. ID to use for the audit schedule, which becomes the final component
1557
+ # of the audit schedule's resource name.
1558
+ # @param [Boolean] validate_only
1559
+ # Optional. If `true`, only validates the request and does not create the audit
1560
+ # schedule. This executes standard request validation (such as schema, framework
1561
+ # existence, scope, and IAM checks) and skips the apply phase. Use this field
1562
+ # for the following purposes: * **Infrastructure as Code (IaC)**: Allow tools
1563
+ # like Terraform to run dry-run mutations (e.g., `terraform plan`) without
1564
+ # creating real resources or incurring costs. * **User Interface Validation**:
1565
+ # Enable real-time form and permission validation in custom UIs before
1566
+ # submitting requests. * **CI/CD & Automation**: Test your scripts, permissions,
1567
+ # and parameters safely without consuming resource quotas.
1568
+ # @param [String] fields
1569
+ # Selector specifying which fields to include in a partial response.
1570
+ # @param [String] quota_user
1571
+ # Available to use for quota purposes for server-side applications. Can be any
1572
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1573
+ # @param [Google::Apis::RequestOptions] options
1574
+ # Request-specific options
1575
+ #
1576
+ # @yield [result, err] Result & error if block supplied
1577
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditSchedule] parsed result object
1578
+ # @yieldparam err [StandardError] error object if request failed
1579
+ #
1580
+ # @return [Google::Apis::AuditmanagerV1::AuditSchedule]
1581
+ #
1582
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1583
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1584
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1585
+ def create_project_location_audit_schedule(parent, audit_schedule_object = nil, audit_schedule_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1586
+ command = make_simple_command(:post, 'v1/{+parent}/auditSchedules', options)
1587
+ command.request_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
1588
+ command.request_object = audit_schedule_object
1589
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
1590
+ command.response_class = Google::Apis::AuditmanagerV1::AuditSchedule
1591
+ command.params['parent'] = parent unless parent.nil?
1592
+ command.query['auditScheduleId'] = audit_schedule_id unless audit_schedule_id.nil?
1593
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1594
+ command.query['fields'] = fields unless fields.nil?
1595
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1596
+ execute_or_queue_command(command, &block)
1597
+ end
1598
+
1599
+ # Gets details of a single audit schedule.
1600
+ # @param [String] name
1601
+ # Required. Name of the audit schedule to retrieve, in one of the following
1602
+ # formats: * `projects/`project`/locations/`location`/auditSchedules/`
1603
+ # audit_schedule`` * `folders/`folder`/locations/`location`/auditSchedules/`
1604
+ # audit_schedule`` * `organizations/`organization`/locations/`location`/
1605
+ # auditSchedules/`audit_schedule``
1606
+ # @param [String] fields
1607
+ # Selector specifying which fields to include in a partial response.
1608
+ # @param [String] quota_user
1609
+ # Available to use for quota purposes for server-side applications. Can be any
1610
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1611
+ # @param [Google::Apis::RequestOptions] options
1612
+ # Request-specific options
1613
+ #
1614
+ # @yield [result, err] Result & error if block supplied
1615
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditSchedule] parsed result object
1616
+ # @yieldparam err [StandardError] error object if request failed
1617
+ #
1618
+ # @return [Google::Apis::AuditmanagerV1::AuditSchedule]
1619
+ #
1620
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1621
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1622
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1623
+ def get_project_location_audit_schedule(name, fields: nil, quota_user: nil, options: nil, &block)
1624
+ command = make_simple_command(:get, 'v1/{+name}', options)
1625
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
1626
+ command.response_class = Google::Apis::AuditmanagerV1::AuditSchedule
1627
+ command.params['name'] = name unless name.nil?
1628
+ command.query['fields'] = fields unless fields.nil?
1629
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1630
+ execute_or_queue_command(command, &block)
1631
+ end
1632
+
1633
+ # Lists audit schedules in a given project and location.
1634
+ # @param [String] parent
1635
+ # Required. Parent for the audit schedule, in one of the following formats: * `
1636
+ # projects/`project`/locations/`location`` * `folders/`folder`/locations/`
1637
+ # location`` * `organizations/`organization`/locations/`location``
1638
+ # @param [Fixnum] page_size
1639
+ # Optional. Maximum number of items to return in a single page. The service
1640
+ # might return fewer items than this value. If unspecified, the service picks an
1641
+ # appropriate default. The maximum value is 100; values above 100 are reduced to
1642
+ # 100.
1643
+ # @param [String] page_token
1644
+ # Optional. A page token, received from a previous call, to retrieve the next
1645
+ # page of results.
1646
+ # @param [String] fields
1647
+ # Selector specifying which fields to include in a partial response.
1648
+ # @param [String] quota_user
1649
+ # Available to use for quota purposes for server-side applications. Can be any
1650
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1651
+ # @param [Google::Apis::RequestOptions] options
1652
+ # Request-specific options
1653
+ #
1654
+ # @yield [result, err] Result & error if block supplied
1655
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse] parsed result object
1656
+ # @yieldparam err [StandardError] error object if request failed
1657
+ #
1658
+ # @return [Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse]
1659
+ #
1660
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1661
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1662
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1663
+ def list_project_location_audit_schedules(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1664
+ command = make_simple_command(:get, 'v1/{+parent}/auditSchedules', options)
1665
+ command.response_representation = Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse::Representation
1666
+ command.response_class = Google::Apis::AuditmanagerV1::ListAuditSchedulesResponse
1667
+ command.params['parent'] = parent unless parent.nil?
1668
+ command.query['pageSize'] = page_size unless page_size.nil?
1669
+ command.query['pageToken'] = page_token unless page_token.nil?
1670
+ command.query['fields'] = fields unless fields.nil?
1671
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1672
+ execute_or_queue_command(command, &block)
1673
+ end
1674
+
1675
+ # Updates an existing audit schedule.
1676
+ # @param [String] name
1677
+ # Identifier. Unique identifier for the audit schedule. Format: projects/`
1678
+ # project`/locations/`location`/auditSchedules/`audit_schedule` folders/`folder`/
1679
+ # locations/`location`/auditSchedules/`audit_schedule` organizations/`
1680
+ # organization`/locations/`location`/auditSchedules/`audit_schedule`
1681
+ # @param [Google::Apis::AuditmanagerV1::AuditSchedule] audit_schedule_object
1682
+ # @param [String] update_mask
1683
+ # Optional. List of fields to update.
1684
+ # @param [Boolean] validate_only
1685
+ # Optional. If `true`, only validates the request and does not update the audit
1686
+ # schedule. This executes standard request validation (such as schema, framework
1687
+ # existence, scope, and IAM checks) and skips the apply phase. Use this field
1688
+ # for the following purposes: * **Infrastructure as Code (IaC)**: Allow tools
1689
+ # like Terraform to run dry-run mutations (e.g., `terraform plan`) without
1690
+ # creating real resources or incurring costs. * **User Interface Validation**:
1691
+ # Enable real-time form and permission validation in custom UIs before
1692
+ # submitting requests. * **CI/CD & Automation**: Test your scripts, permissions,
1693
+ # and parameters safely without consuming resource quotas.
1694
+ # @param [String] fields
1695
+ # Selector specifying which fields to include in a partial response.
1696
+ # @param [String] quota_user
1697
+ # Available to use for quota purposes for server-side applications. Can be any
1698
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1699
+ # @param [Google::Apis::RequestOptions] options
1700
+ # Request-specific options
1701
+ #
1702
+ # @yield [result, err] Result & error if block supplied
1703
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditSchedule] parsed result object
1704
+ # @yieldparam err [StandardError] error object if request failed
1705
+ #
1706
+ # @return [Google::Apis::AuditmanagerV1::AuditSchedule]
1707
+ #
1708
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1709
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1710
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1711
+ def patch_project_location_audit_schedule(name, audit_schedule_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1712
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1713
+ command.request_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
1714
+ command.request_object = audit_schedule_object
1715
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditSchedule::Representation
1716
+ command.response_class = Google::Apis::AuditmanagerV1::AuditSchedule
1717
+ command.params['name'] = name unless name.nil?
1718
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1719
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1720
+ command.query['fields'] = fields unless fields.nil?
1721
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1722
+ execute_or_queue_command(command, &block)
1723
+ end
1724
+
1725
+ # Generates an audit scope report for the given standard. The report includes
1726
+ # the following: * The technical attributes and constraints that Audit Manager
1727
+ # uses to verify your compliance with a framework. * A list of Google Cloud
1728
+ # services and resources that are within the scope of the framework.
1729
+ # @param [String] scope
1730
+ # Required. Project or folder that the audit scope report is generated for, in
1731
+ # one of the following formats: * `projects/`project`/locations/`location`` * `
1732
+ # folders/`folder`/locations/`location`` * `organizations/`organization`/
1733
+ # locations/`location``
1734
+ # @param [Google::Apis::AuditmanagerV1::GenerateAuditScopeReportRequest] generate_audit_scope_report_request_object
1735
+ # @param [String] fields
1736
+ # Selector specifying which fields to include in a partial response.
1737
+ # @param [String] quota_user
1738
+ # Available to use for quota purposes for server-side applications. Can be any
1739
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1740
+ # @param [Google::Apis::RequestOptions] options
1741
+ # Request-specific options
1742
+ #
1743
+ # @yield [result, err] Result & error if block supplied
1744
+ # @yieldparam result [Google::Apis::AuditmanagerV1::AuditScopeReport] parsed result object
1745
+ # @yieldparam err [StandardError] error object if request failed
1746
+ #
1747
+ # @return [Google::Apis::AuditmanagerV1::AuditScopeReport]
1748
+ #
1749
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1750
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1751
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1752
+ def generate_project_location_audit_scope_report(scope, generate_audit_scope_report_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1753
+ command = make_simple_command(:post, 'v1/{+scope}/auditScopeReports:generate', options)
1754
+ command.request_representation = Google::Apis::AuditmanagerV1::GenerateAuditScopeReportRequest::Representation
1755
+ command.request_object = generate_audit_scope_report_request_object
1756
+ command.response_representation = Google::Apis::AuditmanagerV1::AuditScopeReport::Representation
1757
+ command.response_class = Google::Apis::AuditmanagerV1::AuditScopeReport
1758
+ command.params['scope'] = scope unless scope.nil?
1759
+ command.query['fields'] = fields unless fields.nil?
1760
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1761
+ execute_or_queue_command(command, &block)
1762
+ end
1763
+
1764
+ # Gets details about the long-running operation to generate audit reports.
1765
+ # @param [String] name
1766
+ # The name of the operation resource.
1767
+ # @param [String] fields
1768
+ # Selector specifying which fields to include in a partial response.
1769
+ # @param [String] quota_user
1770
+ # Available to use for quota purposes for server-side applications. Can be any
1771
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1772
+ # @param [Google::Apis::RequestOptions] options
1773
+ # Request-specific options
1774
+ #
1775
+ # @yield [result, err] Result & error if block supplied
1776
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Operation] parsed result object
1777
+ # @yieldparam err [StandardError] error object if request failed
1778
+ #
1779
+ # @return [Google::Apis::AuditmanagerV1::Operation]
1780
+ #
1781
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1782
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1783
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1784
+ def get_project_location_operation_detail(name, fields: nil, quota_user: nil, options: nil, &block)
1785
+ command = make_simple_command(:get, 'v1/{+name}', options)
1786
+ command.response_representation = Google::Apis::AuditmanagerV1::Operation::Representation
1787
+ command.response_class = Google::Apis::AuditmanagerV1::Operation
1788
+ command.params['name'] = name unless name.nil?
1789
+ command.query['fields'] = fields unless fields.nil?
1790
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1791
+ execute_or_queue_command(command, &block)
1792
+ end
1793
+
1794
+ # Gets details about the long-running operation to generate audit reports.
1795
+ # @param [String] name
1796
+ # The name of the operation resource.
1797
+ # @param [String] fields
1798
+ # Selector specifying which fields to include in a partial response.
1799
+ # @param [String] quota_user
1800
+ # Available to use for quota purposes for server-side applications. Can be any
1801
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1802
+ # @param [Google::Apis::RequestOptions] options
1803
+ # Request-specific options
1804
+ #
1805
+ # @yield [result, err] Result & error if block supplied
1806
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Operation] parsed result object
1807
+ # @yieldparam err [StandardError] error object if request failed
1808
+ #
1809
+ # @return [Google::Apis::AuditmanagerV1::Operation]
1810
+ #
1811
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1812
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1813
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1814
+ def get_project_location_operation_id(name, fields: nil, quota_user: nil, options: nil, &block)
1815
+ command = make_simple_command(:get, 'v1/{+name}', options)
1816
+ command.response_representation = Google::Apis::AuditmanagerV1::Operation::Representation
1817
+ command.response_class = Google::Apis::AuditmanagerV1::Operation
1818
+ command.params['name'] = name unless name.nil?
1819
+ command.query['fields'] = fields unless fields.nil?
1820
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1821
+ execute_or_queue_command(command, &block)
1822
+ end
1823
+
1824
+ # Starts asynchronous cancellation on a long-running operation. The server makes
1825
+ # a best effort to cancel the operation, but success is not guaranteed. If the
1826
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
1827
+ # Clients can use Operations.GetOperation or other methods to check whether the
1828
+ # cancellation succeeded or whether the operation completed despite cancellation.
1829
+ # On successful cancellation, the operation is not deleted; instead, it becomes
1830
+ # an operation with an Operation.error value with a google.rpc.Status.code of `1`
1831
+ # , corresponding to `Code.CANCELLED`.
1832
+ # @param [String] name
1833
+ # The name of the operation resource to be cancelled.
1834
+ # @param [Google::Apis::AuditmanagerV1::CancelOperationRequest] cancel_operation_request_object
1835
+ # @param [String] fields
1836
+ # Selector specifying which fields to include in a partial response.
1837
+ # @param [String] quota_user
1838
+ # Available to use for quota purposes for server-side applications. Can be any
1839
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1840
+ # @param [Google::Apis::RequestOptions] options
1841
+ # Request-specific options
1842
+ #
1843
+ # @yield [result, err] Result & error if block supplied
1844
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Empty] parsed result object
1845
+ # @yieldparam err [StandardError] error object if request failed
1846
+ #
1847
+ # @return [Google::Apis::AuditmanagerV1::Empty]
1848
+ #
1849
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1850
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1851
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1852
+ def cancel_project_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1853
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
1854
+ command.request_representation = Google::Apis::AuditmanagerV1::CancelOperationRequest::Representation
1855
+ command.request_object = cancel_operation_request_object
1856
+ command.response_representation = Google::Apis::AuditmanagerV1::Empty::Representation
1857
+ command.response_class = Google::Apis::AuditmanagerV1::Empty
1858
+ command.params['name'] = name unless name.nil?
1859
+ command.query['fields'] = fields unless fields.nil?
1860
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1861
+ execute_or_queue_command(command, &block)
1862
+ end
1863
+
1864
+ # Deletes a long-running operation. This method indicates that the client is no
1865
+ # longer interested in the operation result. It does not cancel the operation.
1866
+ # If the server doesn't support this method, it returns `google.rpc.Code.
1867
+ # UNIMPLEMENTED`.
1868
+ # @param [String] name
1869
+ # The name of the operation resource to be deleted.
1870
+ # @param [String] fields
1871
+ # Selector specifying which fields to include in a partial response.
1872
+ # @param [String] quota_user
1873
+ # Available to use for quota purposes for server-side applications. Can be any
1874
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1875
+ # @param [Google::Apis::RequestOptions] options
1876
+ # Request-specific options
1877
+ #
1878
+ # @yield [result, err] Result & error if block supplied
1879
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Empty] parsed result object
1880
+ # @yieldparam err [StandardError] error object if request failed
1881
+ #
1882
+ # @return [Google::Apis::AuditmanagerV1::Empty]
1883
+ #
1884
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1885
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1886
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1887
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1888
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1889
+ command.response_representation = Google::Apis::AuditmanagerV1::Empty::Representation
1890
+ command.response_class = Google::Apis::AuditmanagerV1::Empty
1891
+ command.params['name'] = name unless name.nil?
1892
+ command.query['fields'] = fields unless fields.nil?
1893
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1894
+ execute_or_queue_command(command, &block)
1895
+ end
1896
+
1897
+ # Gets the latest state of a long-running operation. Clients can use this method
1898
+ # to poll the operation result at intervals as recommended by the API service.
1899
+ # @param [String] name
1900
+ # The name of the operation resource.
1901
+ # @param [String] fields
1902
+ # Selector specifying which fields to include in a partial response.
1903
+ # @param [String] quota_user
1904
+ # Available to use for quota purposes for server-side applications. Can be any
1905
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1906
+ # @param [Google::Apis::RequestOptions] options
1907
+ # Request-specific options
1908
+ #
1909
+ # @yield [result, err] Result & error if block supplied
1910
+ # @yieldparam result [Google::Apis::AuditmanagerV1::Operation] parsed result object
1911
+ # @yieldparam err [StandardError] error object if request failed
1912
+ #
1913
+ # @return [Google::Apis::AuditmanagerV1::Operation]
1914
+ #
1915
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1916
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1917
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1918
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1919
+ command = make_simple_command(:get, 'v1/{+name}', options)
1920
+ command.response_representation = Google::Apis::AuditmanagerV1::Operation::Representation
1921
+ command.response_class = Google::Apis::AuditmanagerV1::Operation
1922
+ command.params['name'] = name unless name.nil?
1923
+ command.query['fields'] = fields unless fields.nil?
1924
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1925
+ execute_or_queue_command(command, &block)
1926
+ end
1927
+
1928
+ # Lists operations that match the specified filter in the request. If the server
1929
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
1930
+ # @param [String] name
1931
+ # The name of the operation's parent resource.
1932
+ # @param [String] filter
1933
+ # The standard list filter.
1934
+ # @param [Fixnum] page_size
1935
+ # The standard list page size.
1936
+ # @param [String] page_token
1937
+ # The standard list page token.
1938
+ # @param [Boolean] return_partial_success
1939
+ # When set to `true`, operations that are reachable are returned as normal, and
1940
+ # those that are unreachable are returned in the ListOperationsResponse.
1941
+ # unreachable field. This can only be `true` when reading across collections.
1942
+ # For example, when `parent` is set to `"projects/example/locations/-"`. This
1943
+ # field is not supported by default and will result in an `UNIMPLEMENTED` error
1944
+ # if set unless explicitly documented otherwise in service or product specific
1945
+ # documentation.
1946
+ # @param [String] fields
1947
+ # Selector specifying which fields to include in a partial response.
1948
+ # @param [String] quota_user
1949
+ # Available to use for quota purposes for server-side applications. Can be any
1950
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1951
+ # @param [Google::Apis::RequestOptions] options
1952
+ # Request-specific options
1953
+ #
1954
+ # @yield [result, err] Result & error if block supplied
1955
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListOperationsResponse] parsed result object
1956
+ # @yieldparam err [StandardError] error object if request failed
1957
+ #
1958
+ # @return [Google::Apis::AuditmanagerV1::ListOperationsResponse]
1959
+ #
1960
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1961
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1962
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1963
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
1964
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
1965
+ command.response_representation = Google::Apis::AuditmanagerV1::ListOperationsResponse::Representation
1966
+ command.response_class = Google::Apis::AuditmanagerV1::ListOperationsResponse
1967
+ command.params['name'] = name unless name.nil?
1968
+ command.query['filter'] = filter unless filter.nil?
1969
+ command.query['pageSize'] = page_size unless page_size.nil?
1970
+ command.query['pageToken'] = page_token unless page_token.nil?
1971
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
1972
+ command.query['fields'] = fields unless fields.nil?
1973
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1974
+ execute_or_queue_command(command, &block)
1975
+ end
1976
+
1977
+ # Gets a resource and its enrollment status.
1978
+ # @param [String] name
1979
+ # Required. Name of the resource enrollment status, in one of the following
1980
+ # formats: * `folders/`folder`/locations/`location`/resourceEnrollmentStatuses/`
1981
+ # resource_enrollment_status`` * `projects/`project`/locations/`location`/
1982
+ # resourceEnrollmentStatuses/`resource_enrollment_status`` * `organizations/`
1983
+ # organization`/locations/`location`/resourceEnrollmentStatuses/`
1984
+ # resource_enrollment_status``
1985
+ # @param [String] fields
1986
+ # Selector specifying which fields to include in a partial response.
1987
+ # @param [String] quota_user
1988
+ # Available to use for quota purposes for server-side applications. Can be any
1989
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1990
+ # @param [Google::Apis::RequestOptions] options
1991
+ # Request-specific options
1992
+ #
1993
+ # @yield [result, err] Result & error if block supplied
1994
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus] parsed result object
1995
+ # @yieldparam err [StandardError] error object if request failed
1996
+ #
1997
+ # @return [Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus]
1998
+ #
1999
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2000
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2001
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2002
+ def get_project_location_resource_enrollment_status(name, fields: nil, quota_user: nil, options: nil, &block)
2003
+ command = make_simple_command(:get, 'v1/{+name}', options)
2004
+ command.response_representation = Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus::Representation
2005
+ command.response_class = Google::Apis::AuditmanagerV1::ResourceEnrollmentStatus
2006
+ command.params['name'] = name unless name.nil?
2007
+ command.query['fields'] = fields unless fields.nil?
2008
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2009
+ execute_or_queue_command(command, &block)
2010
+ end
2011
+
2012
+ # Lists the controls that you must implement to become compliant to a regulatory
2013
+ # standard.
2014
+ # @param [String] parent
2015
+ # Required. Standard to list controls for, in one of the following formats: * `
2016
+ # projects/`project`/locations/`location`/standards/`standard`` * `folders/`
2017
+ # folder`/locations/`location`/standards/`standard`` * `organizations/`
2018
+ # organization`/locations/`location`/standards/`standard``
2019
+ # @param [Fixnum] page_size
2020
+ # Optional. Maximum number of items to return in a single page. The service
2021
+ # might return fewer items than this value. If unspecified, the service picks an
2022
+ # appropriate default. The maximum value is 100; values above 100 are reduced to
2023
+ # 100.
2024
+ # @param [String] page_token
2025
+ # Optional. A page token, received from a previous call, to retrieve the next
2026
+ # page of results.
2027
+ # @param [String] fields
2028
+ # Selector specifying which fields to include in a partial response.
2029
+ # @param [String] quota_user
2030
+ # Available to use for quota purposes for server-side applications. Can be any
2031
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2032
+ # @param [Google::Apis::RequestOptions] options
2033
+ # Request-specific options
2034
+ #
2035
+ # @yield [result, err] Result & error if block supplied
2036
+ # @yieldparam result [Google::Apis::AuditmanagerV1::ListControlsResponse] parsed result object
2037
+ # @yieldparam err [StandardError] error object if request failed
2038
+ #
2039
+ # @return [Google::Apis::AuditmanagerV1::ListControlsResponse]
2040
+ #
2041
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2042
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2043
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2044
+ def list_project_location_standard_controls(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2045
+ command = make_simple_command(:get, 'v1/{+parent}/controls', options)
2046
+ command.response_representation = Google::Apis::AuditmanagerV1::ListControlsResponse::Representation
2047
+ command.response_class = Google::Apis::AuditmanagerV1::ListControlsResponse
2048
+ command.params['parent'] = parent unless parent.nil?
2049
+ command.query['pageSize'] = page_size unless page_size.nil?
2050
+ command.query['pageToken'] = page_token unless page_token.nil?
2051
+ command.query['fields'] = fields unless fields.nil?
2052
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2053
+ execute_or_queue_command(command, &block)
2054
+ end
2055
+
2056
+ protected
2057
+
2058
+ def apply_command_defaults(command)
2059
+ command.query['key'] = key unless key.nil?
2060
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2061
+ end
2062
+ end
2063
+ end
2064
+ end
2065
+ end