google-apis-securitycenter_v1 0.14.0 → 0.18.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.
@@ -247,6 +247,227 @@ module Google
247
247
  execute_or_queue_command(command, &block)
248
248
  end
249
249
 
250
+ # Kicks off an LRO to bulk mute findings for a parent based on a filter. The
251
+ # parent can be either an organization, folder or project. The findings matched
252
+ # by the filter will be muted after the LRO is done.
253
+ # @param [String] parent
254
+ # Required. The parent, at which bulk action needs to be applied. Its format is "
255
+ # organizations/[organization_id]", "folders/[folder_id]", "projects/[project_id]
256
+ # ".
257
+ # @param [Google::Apis::SecuritycenterV1::BulkMuteFindingsRequest] bulk_mute_findings_request_object
258
+ # @param [String] fields
259
+ # Selector specifying which fields to include in a partial response.
260
+ # @param [String] quota_user
261
+ # Available to use for quota purposes for server-side applications. Can be any
262
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
263
+ # @param [Google::Apis::RequestOptions] options
264
+ # Request-specific options
265
+ #
266
+ # @yield [result, err] Result & error if block supplied
267
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Operation] parsed result object
268
+ # @yieldparam err [StandardError] error object if request failed
269
+ #
270
+ # @return [Google::Apis::SecuritycenterV1::Operation]
271
+ #
272
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
273
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
274
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
275
+ def bulk_folder_finding_mute(parent, bulk_mute_findings_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
276
+ command = make_simple_command(:post, 'v1/{+parent}/findings:bulkMute', options)
277
+ command.request_representation = Google::Apis::SecuritycenterV1::BulkMuteFindingsRequest::Representation
278
+ command.request_object = bulk_mute_findings_request_object
279
+ command.response_representation = Google::Apis::SecuritycenterV1::Operation::Representation
280
+ command.response_class = Google::Apis::SecuritycenterV1::Operation
281
+ command.params['parent'] = parent unless parent.nil?
282
+ command.query['fields'] = fields unless fields.nil?
283
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
284
+ execute_or_queue_command(command, &block)
285
+ end
286
+
287
+ # Creates a mute config.
288
+ # @param [String] parent
289
+ # Required. Resource name of the new mute configs's parent. Its format is "
290
+ # organizations/[organization_id]", "folders/[folder_id]", or "projects/[
291
+ # project_id]".
292
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] google_cloud_securitycenter_v1_mute_config_object
293
+ # @param [String] mute_config_id
294
+ # Required. Unique identifier provided by the client within the parent scope. It
295
+ # must consist of lower case letters, numbers, and hyphen, with the first
296
+ # character a letter, the last a letter or a number, and a 63 character maximum.
297
+ # @param [String] fields
298
+ # Selector specifying which fields to include in a partial response.
299
+ # @param [String] quota_user
300
+ # Available to use for quota purposes for server-side applications. Can be any
301
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
302
+ # @param [Google::Apis::RequestOptions] options
303
+ # Request-specific options
304
+ #
305
+ # @yield [result, err] Result & error if block supplied
306
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] parsed result object
307
+ # @yieldparam err [StandardError] error object if request failed
308
+ #
309
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig]
310
+ #
311
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
312
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
313
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
314
+ def create_folder_mute_config(parent, google_cloud_securitycenter_v1_mute_config_object = nil, mute_config_id: nil, fields: nil, quota_user: nil, options: nil, &block)
315
+ command = make_simple_command(:post, 'v1/{+parent}/muteConfigs', options)
316
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
317
+ command.request_object = google_cloud_securitycenter_v1_mute_config_object
318
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
319
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig
320
+ command.params['parent'] = parent unless parent.nil?
321
+ command.query['muteConfigId'] = mute_config_id unless mute_config_id.nil?
322
+ command.query['fields'] = fields unless fields.nil?
323
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
324
+ execute_or_queue_command(command, &block)
325
+ end
326
+
327
+ # Deletes an existing mute config.
328
+ # @param [String] name
329
+ # Required. Name of the mute config to delete. Its format is organizations/`
330
+ # organization`/muteConfigs/`config_id`, folders/`folder`/muteConfigs/`config_id`
331
+ # , or projects/`project`/muteConfigs/`config_id`
332
+ # @param [String] fields
333
+ # Selector specifying which fields to include in a partial response.
334
+ # @param [String] quota_user
335
+ # Available to use for quota purposes for server-side applications. Can be any
336
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
337
+ # @param [Google::Apis::RequestOptions] options
338
+ # Request-specific options
339
+ #
340
+ # @yield [result, err] Result & error if block supplied
341
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
342
+ # @yieldparam err [StandardError] error object if request failed
343
+ #
344
+ # @return [Google::Apis::SecuritycenterV1::Empty]
345
+ #
346
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
347
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
348
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
349
+ def delete_folder_mute_config(name, fields: nil, quota_user: nil, options: nil, &block)
350
+ command = make_simple_command(:delete, 'v1/{+name}', options)
351
+ command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
352
+ command.response_class = Google::Apis::SecuritycenterV1::Empty
353
+ command.params['name'] = name unless name.nil?
354
+ command.query['fields'] = fields unless fields.nil?
355
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
356
+ execute_or_queue_command(command, &block)
357
+ end
358
+
359
+ # Gets a mute config.
360
+ # @param [String] name
361
+ # Required. Name of the mute config to retrieve. Its format is organizations/`
362
+ # organization`/muteConfigs/`config_id`, folders/`folder`/muteConfigs/`config_id`
363
+ # , or projects/`project`/muteConfigs/`config_id`
364
+ # @param [String] fields
365
+ # Selector specifying which fields to include in a partial response.
366
+ # @param [String] quota_user
367
+ # Available to use for quota purposes for server-side applications. Can be any
368
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
369
+ # @param [Google::Apis::RequestOptions] options
370
+ # Request-specific options
371
+ #
372
+ # @yield [result, err] Result & error if block supplied
373
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] parsed result object
374
+ # @yieldparam err [StandardError] error object if request failed
375
+ #
376
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig]
377
+ #
378
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
379
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
380
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
381
+ def get_folder_mute_config(name, fields: nil, quota_user: nil, options: nil, &block)
382
+ command = make_simple_command(:get, 'v1/{+name}', options)
383
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
384
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig
385
+ command.params['name'] = name unless name.nil?
386
+ command.query['fields'] = fields unless fields.nil?
387
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
388
+ execute_or_queue_command(command, &block)
389
+ end
390
+
391
+ # Lists mute configs.
392
+ # @param [String] parent
393
+ # Required. The parent, which owns the collection of mute configs. Its format is
394
+ # "organizations/[organization_id]", "folders/[folder_id]", "projects/[
395
+ # project_id]".
396
+ # @param [Fixnum] page_size
397
+ # The maximum number of configs to return. The service may return fewer than
398
+ # this value. If unspecified, at most 10 configs will be returned. The maximum
399
+ # value is 1000; values above 1000 will be coerced to 1000.
400
+ # @param [String] page_token
401
+ # A page token, received from a previous `ListMuteConfigs` call. Provide this to
402
+ # retrieve the subsequent page. When paginating, all other parameters provided
403
+ # to `ListMuteConfigs` must match the call that provided the page token.
404
+ # @param [String] fields
405
+ # Selector specifying which fields to include in a partial response.
406
+ # @param [String] quota_user
407
+ # Available to use for quota purposes for server-side applications. Can be any
408
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
409
+ # @param [Google::Apis::RequestOptions] options
410
+ # Request-specific options
411
+ #
412
+ # @yield [result, err] Result & error if block supplied
413
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListMuteConfigsResponse] parsed result object
414
+ # @yieldparam err [StandardError] error object if request failed
415
+ #
416
+ # @return [Google::Apis::SecuritycenterV1::ListMuteConfigsResponse]
417
+ #
418
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
419
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
420
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
421
+ def list_folder_mute_configs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
422
+ command = make_simple_command(:get, 'v1/{+parent}/muteConfigs', options)
423
+ command.response_representation = Google::Apis::SecuritycenterV1::ListMuteConfigsResponse::Representation
424
+ command.response_class = Google::Apis::SecuritycenterV1::ListMuteConfigsResponse
425
+ command.params['parent'] = parent unless parent.nil?
426
+ command.query['pageSize'] = page_size unless page_size.nil?
427
+ command.query['pageToken'] = page_token unless page_token.nil?
428
+ command.query['fields'] = fields unless fields.nil?
429
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
430
+ execute_or_queue_command(command, &block)
431
+ end
432
+
433
+ # Updates a mute config.
434
+ # @param [String] name
435
+ # This field will be ignored if provided on config creation. Format "
436
+ # organizations/`organization`/muteConfigs/`mute_config`" "folders/`folder`/
437
+ # muteConfigs/`mute_config`" "projects/`project`/muteConfigs/`mute_config`"
438
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] google_cloud_securitycenter_v1_mute_config_object
439
+ # @param [String] update_mask
440
+ # The list of fields to be updated. If empty all mutable fields will be updated.
441
+ # @param [String] fields
442
+ # Selector specifying which fields to include in a partial response.
443
+ # @param [String] quota_user
444
+ # Available to use for quota purposes for server-side applications. Can be any
445
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
446
+ # @param [Google::Apis::RequestOptions] options
447
+ # Request-specific options
448
+ #
449
+ # @yield [result, err] Result & error if block supplied
450
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] parsed result object
451
+ # @yieldparam err [StandardError] error object if request failed
452
+ #
453
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig]
454
+ #
455
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
456
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
457
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
458
+ def patch_folder_mute_config(name, google_cloud_securitycenter_v1_mute_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
459
+ command = make_simple_command(:patch, 'v1/{+name}', options)
460
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
461
+ command.request_object = google_cloud_securitycenter_v1_mute_config_object
462
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
463
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig
464
+ command.params['name'] = name unless name.nil?
465
+ command.query['updateMask'] = update_mask unless update_mask.nil?
466
+ command.query['fields'] = fields unless fields.nil?
467
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
468
+ execute_or_queue_command(command, &block)
469
+ end
470
+
250
471
  # Lists all sources belonging to an organization.
251
472
  # @param [String] parent
252
473
  # Required. Resource name of the parent of sources to list. Its format should be
@@ -486,6 +707,43 @@ module Google
486
707
  execute_or_queue_command(command, &block)
487
708
  end
488
709
 
710
+ # Updates the mute state of a finding.
711
+ # @param [String] name
712
+ # Required. The relative resource name of the finding. See: https://cloud.google.
713
+ # com/apis/design/resource_names#relative_resource_name Example: "organizations/`
714
+ # organization_id`/sources/`source_id`/finding/`finding_id`", "folders/`
715
+ # folder_id`/sources/`source_id`/finding/`finding_id`", "projects/`project_id`/
716
+ # sources/`source_id`/finding/`finding_id`".
717
+ # @param [Google::Apis::SecuritycenterV1::SetMuteRequest] set_mute_request_object
718
+ # @param [String] fields
719
+ # Selector specifying which fields to include in a partial response.
720
+ # @param [String] quota_user
721
+ # Available to use for quota purposes for server-side applications. Can be any
722
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
723
+ # @param [Google::Apis::RequestOptions] options
724
+ # Request-specific options
725
+ #
726
+ # @yield [result, err] Result & error if block supplied
727
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Finding] parsed result object
728
+ # @yieldparam err [StandardError] error object if request failed
729
+ #
730
+ # @return [Google::Apis::SecuritycenterV1::Finding]
731
+ #
732
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
733
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
734
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
735
+ def set_folder_source_finding_mute(name, set_mute_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
736
+ command = make_simple_command(:post, 'v1/{+name}:setMute', options)
737
+ command.request_representation = Google::Apis::SecuritycenterV1::SetMuteRequest::Representation
738
+ command.request_object = set_mute_request_object
739
+ command.response_representation = Google::Apis::SecuritycenterV1::Finding::Representation
740
+ command.response_class = Google::Apis::SecuritycenterV1::Finding
741
+ command.params['name'] = name unless name.nil?
742
+ command.query['fields'] = fields unless fields.nil?
743
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
744
+ execute_or_queue_command(command, &block)
745
+ end
746
+
489
747
  # Updates the state of a finding.
490
748
  # @param [String] name
491
749
  # Required. The relative resource name of the finding. See: https://cloud.google.
@@ -567,6 +825,46 @@ module Google
567
825
  execute_or_queue_command(command, &block)
568
826
  end
569
827
 
828
+ # Updates external system. This is for a given finding.
829
+ # @param [String] name
830
+ # External System Name e.g. jira, demisto, etc. e.g.: organizations/1234/sources/
831
+ # 5678/findings/123456/externalSystems/jira folders/1234/sources/5678/findings/
832
+ # 123456/externalSystems/jira projects/1234/sources/5678/findings/123456/
833
+ # externalSystems/jira
834
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem] google_cloud_securitycenter_v1_external_system_object
835
+ # @param [String] update_mask
836
+ # The FieldMask to use when updating the external system resource. If empty all
837
+ # mutable fields will be updated.
838
+ # @param [String] fields
839
+ # Selector specifying which fields to include in a partial response.
840
+ # @param [String] quota_user
841
+ # Available to use for quota purposes for server-side applications. Can be any
842
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
843
+ # @param [Google::Apis::RequestOptions] options
844
+ # Request-specific options
845
+ #
846
+ # @yield [result, err] Result & error if block supplied
847
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem] parsed result object
848
+ # @yieldparam err [StandardError] error object if request failed
849
+ #
850
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem]
851
+ #
852
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
853
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
854
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
855
+ def patch_folder_source_finding_external_system(name, google_cloud_securitycenter_v1_external_system_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
856
+ command = make_simple_command(:patch, 'v1/{+name}', options)
857
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem::Representation
858
+ command.request_object = google_cloud_securitycenter_v1_external_system_object
859
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem::Representation
860
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem
861
+ command.params['name'] = name unless name.nil?
862
+ command.query['updateMask'] = update_mask unless update_mask.nil?
863
+ command.query['fields'] = fields unless fields.nil?
864
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
865
+ execute_or_queue_command(command, &block)
866
+ end
867
+
570
868
  # Gets the settings for an organization.
571
869
  # @param [String] name
572
870
  # Required. Name of the organization to get organization settings for. Its
@@ -870,15 +1168,14 @@ module Google
870
1168
  execute_or_queue_command(command, &block)
871
1169
  end
872
1170
 
873
- # Creates a notification config.
1171
+ # Kicks off an LRO to bulk mute findings for a parent based on a filter. The
1172
+ # parent can be either an organization, folder or project. The findings matched
1173
+ # by the filter will be muted after the LRO is done.
874
1174
  # @param [String] parent
875
- # Required. Resource name of the new notification config's parent. Its format is
876
- # "organizations/[organization_id]".
877
- # @param [Google::Apis::SecuritycenterV1::NotificationConfig] notification_config_object
878
- # @param [String] config_id
879
- # Required. Unique identifier provided by the client within the parent scope. It
880
- # must be between 1 and 128 characters, and contains alphanumeric characters,
881
- # underscores or hyphens only.
1175
+ # Required. The parent, at which bulk action needs to be applied. Its format is "
1176
+ # organizations/[organization_id]", "folders/[folder_id]", "projects/[project_id]
1177
+ # ".
1178
+ # @param [Google::Apis::SecuritycenterV1::BulkMuteFindingsRequest] bulk_mute_findings_request_object
882
1179
  # @param [String] fields
883
1180
  # Selector specifying which fields to include in a partial response.
884
1181
  # @param [String] quota_user
@@ -888,31 +1185,36 @@ module Google
888
1185
  # Request-specific options
889
1186
  #
890
1187
  # @yield [result, err] Result & error if block supplied
891
- # @yieldparam result [Google::Apis::SecuritycenterV1::NotificationConfig] parsed result object
1188
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Operation] parsed result object
892
1189
  # @yieldparam err [StandardError] error object if request failed
893
1190
  #
894
- # @return [Google::Apis::SecuritycenterV1::NotificationConfig]
1191
+ # @return [Google::Apis::SecuritycenterV1::Operation]
895
1192
  #
896
1193
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
897
1194
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
898
1195
  # @raise [Google::Apis::AuthorizationError] Authorization is required
899
- def create_organization_notification_config(parent, notification_config_object = nil, config_id: nil, fields: nil, quota_user: nil, options: nil, &block)
900
- command = make_simple_command(:post, 'v1/{+parent}/notificationConfigs', options)
901
- command.request_representation = Google::Apis::SecuritycenterV1::NotificationConfig::Representation
902
- command.request_object = notification_config_object
903
- command.response_representation = Google::Apis::SecuritycenterV1::NotificationConfig::Representation
904
- command.response_class = Google::Apis::SecuritycenterV1::NotificationConfig
1196
+ def bulk_organization_finding_mute(parent, bulk_mute_findings_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1197
+ command = make_simple_command(:post, 'v1/{+parent}/findings:bulkMute', options)
1198
+ command.request_representation = Google::Apis::SecuritycenterV1::BulkMuteFindingsRequest::Representation
1199
+ command.request_object = bulk_mute_findings_request_object
1200
+ command.response_representation = Google::Apis::SecuritycenterV1::Operation::Representation
1201
+ command.response_class = Google::Apis::SecuritycenterV1::Operation
905
1202
  command.params['parent'] = parent unless parent.nil?
906
- command.query['configId'] = config_id unless config_id.nil?
907
1203
  command.query['fields'] = fields unless fields.nil?
908
1204
  command.query['quotaUser'] = quota_user unless quota_user.nil?
909
1205
  execute_or_queue_command(command, &block)
910
1206
  end
911
1207
 
912
- # Deletes a notification config.
913
- # @param [String] name
914
- # Required. Name of the notification config to delete. Its format is "
915
- # organizations/[organization_id]/notificationConfigs/[config_id]".
1208
+ # Creates a mute config.
1209
+ # @param [String] parent
1210
+ # Required. Resource name of the new mute configs's parent. Its format is "
1211
+ # organizations/[organization_id]", "folders/[folder_id]", or "projects/[
1212
+ # project_id]".
1213
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] google_cloud_securitycenter_v1_mute_config_object
1214
+ # @param [String] mute_config_id
1215
+ # Required. Unique identifier provided by the client within the parent scope. It
1216
+ # must consist of lower case letters, numbers, and hyphen, with the first
1217
+ # character a letter, the last a letter or a number, and a 63 character maximum.
916
1218
  # @param [String] fields
917
1219
  # Selector specifying which fields to include in a partial response.
918
1220
  # @param [String] quota_user
@@ -922,28 +1224,32 @@ module Google
922
1224
  # Request-specific options
923
1225
  #
924
1226
  # @yield [result, err] Result & error if block supplied
925
- # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
1227
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] parsed result object
926
1228
  # @yieldparam err [StandardError] error object if request failed
927
1229
  #
928
- # @return [Google::Apis::SecuritycenterV1::Empty]
1230
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig]
929
1231
  #
930
1232
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
931
1233
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
932
1234
  # @raise [Google::Apis::AuthorizationError] Authorization is required
933
- def delete_organization_notification_config(name, fields: nil, quota_user: nil, options: nil, &block)
934
- command = make_simple_command(:delete, 'v1/{+name}', options)
935
- command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
936
- command.response_class = Google::Apis::SecuritycenterV1::Empty
937
- command.params['name'] = name unless name.nil?
1235
+ def create_organization_mute_config(parent, google_cloud_securitycenter_v1_mute_config_object = nil, mute_config_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1236
+ command = make_simple_command(:post, 'v1/{+parent}/muteConfigs', options)
1237
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
1238
+ command.request_object = google_cloud_securitycenter_v1_mute_config_object
1239
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
1240
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig
1241
+ command.params['parent'] = parent unless parent.nil?
1242
+ command.query['muteConfigId'] = mute_config_id unless mute_config_id.nil?
938
1243
  command.query['fields'] = fields unless fields.nil?
939
1244
  command.query['quotaUser'] = quota_user unless quota_user.nil?
940
1245
  execute_or_queue_command(command, &block)
941
1246
  end
942
1247
 
943
- # Gets a notification config.
1248
+ # Deletes an existing mute config.
944
1249
  # @param [String] name
945
- # Required. Name of the notification config to get. Its format is "organizations/
946
- # [organization_id]/notificationConfigs/[config_id]".
1250
+ # Required. Name of the mute config to delete. Its format is organizations/`
1251
+ # organization`/muteConfigs/`config_id`, folders/`folder`/muteConfigs/`config_id`
1252
+ # , or projects/`project`/muteConfigs/`config_id`
947
1253
  # @param [String] fields
948
1254
  # Selector specifying which fields to include in a partial response.
949
1255
  # @param [String] quota_user
@@ -953,25 +1259,238 @@ module Google
953
1259
  # Request-specific options
954
1260
  #
955
1261
  # @yield [result, err] Result & error if block supplied
956
- # @yieldparam result [Google::Apis::SecuritycenterV1::NotificationConfig] parsed result object
1262
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
957
1263
  # @yieldparam err [StandardError] error object if request failed
958
1264
  #
959
- # @return [Google::Apis::SecuritycenterV1::NotificationConfig]
1265
+ # @return [Google::Apis::SecuritycenterV1::Empty]
960
1266
  #
961
1267
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
962
1268
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
963
1269
  # @raise [Google::Apis::AuthorizationError] Authorization is required
964
- def get_organization_notification_config(name, fields: nil, quota_user: nil, options: nil, &block)
965
- command = make_simple_command(:get, 'v1/{+name}', options)
966
- command.response_representation = Google::Apis::SecuritycenterV1::NotificationConfig::Representation
967
- command.response_class = Google::Apis::SecuritycenterV1::NotificationConfig
1270
+ def delete_organization_mute_config(name, fields: nil, quota_user: nil, options: nil, &block)
1271
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1272
+ command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
1273
+ command.response_class = Google::Apis::SecuritycenterV1::Empty
968
1274
  command.params['name'] = name unless name.nil?
969
1275
  command.query['fields'] = fields unless fields.nil?
970
1276
  command.query['quotaUser'] = quota_user unless quota_user.nil?
971
1277
  execute_or_queue_command(command, &block)
972
1278
  end
973
1279
 
974
- # Lists notification configs.
1280
+ # Gets a mute config.
1281
+ # @param [String] name
1282
+ # Required. Name of the mute config to retrieve. Its format is organizations/`
1283
+ # organization`/muteConfigs/`config_id`, folders/`folder`/muteConfigs/`config_id`
1284
+ # , or projects/`project`/muteConfigs/`config_id`
1285
+ # @param [String] fields
1286
+ # Selector specifying which fields to include in a partial response.
1287
+ # @param [String] quota_user
1288
+ # Available to use for quota purposes for server-side applications. Can be any
1289
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1290
+ # @param [Google::Apis::RequestOptions] options
1291
+ # Request-specific options
1292
+ #
1293
+ # @yield [result, err] Result & error if block supplied
1294
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] parsed result object
1295
+ # @yieldparam err [StandardError] error object if request failed
1296
+ #
1297
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig]
1298
+ #
1299
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1300
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1301
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1302
+ def get_organization_mute_config(name, fields: nil, quota_user: nil, options: nil, &block)
1303
+ command = make_simple_command(:get, 'v1/{+name}', options)
1304
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
1305
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig
1306
+ command.params['name'] = name unless name.nil?
1307
+ command.query['fields'] = fields unless fields.nil?
1308
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1309
+ execute_or_queue_command(command, &block)
1310
+ end
1311
+
1312
+ # Lists mute configs.
1313
+ # @param [String] parent
1314
+ # Required. The parent, which owns the collection of mute configs. Its format is
1315
+ # "organizations/[organization_id]", "folders/[folder_id]", "projects/[
1316
+ # project_id]".
1317
+ # @param [Fixnum] page_size
1318
+ # The maximum number of configs to return. The service may return fewer than
1319
+ # this value. If unspecified, at most 10 configs will be returned. The maximum
1320
+ # value is 1000; values above 1000 will be coerced to 1000.
1321
+ # @param [String] page_token
1322
+ # A page token, received from a previous `ListMuteConfigs` call. Provide this to
1323
+ # retrieve the subsequent page. When paginating, all other parameters provided
1324
+ # to `ListMuteConfigs` must match the call that provided the page token.
1325
+ # @param [String] fields
1326
+ # Selector specifying which fields to include in a partial response.
1327
+ # @param [String] quota_user
1328
+ # Available to use for quota purposes for server-side applications. Can be any
1329
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1330
+ # @param [Google::Apis::RequestOptions] options
1331
+ # Request-specific options
1332
+ #
1333
+ # @yield [result, err] Result & error if block supplied
1334
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListMuteConfigsResponse] parsed result object
1335
+ # @yieldparam err [StandardError] error object if request failed
1336
+ #
1337
+ # @return [Google::Apis::SecuritycenterV1::ListMuteConfigsResponse]
1338
+ #
1339
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1340
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1341
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1342
+ def list_organization_mute_configs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1343
+ command = make_simple_command(:get, 'v1/{+parent}/muteConfigs', options)
1344
+ command.response_representation = Google::Apis::SecuritycenterV1::ListMuteConfigsResponse::Representation
1345
+ command.response_class = Google::Apis::SecuritycenterV1::ListMuteConfigsResponse
1346
+ command.params['parent'] = parent unless parent.nil?
1347
+ command.query['pageSize'] = page_size unless page_size.nil?
1348
+ command.query['pageToken'] = page_token unless page_token.nil?
1349
+ command.query['fields'] = fields unless fields.nil?
1350
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1351
+ execute_or_queue_command(command, &block)
1352
+ end
1353
+
1354
+ # Updates a mute config.
1355
+ # @param [String] name
1356
+ # This field will be ignored if provided on config creation. Format "
1357
+ # organizations/`organization`/muteConfigs/`mute_config`" "folders/`folder`/
1358
+ # muteConfigs/`mute_config`" "projects/`project`/muteConfigs/`mute_config`"
1359
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] google_cloud_securitycenter_v1_mute_config_object
1360
+ # @param [String] update_mask
1361
+ # The list of fields to be updated. If empty all mutable fields will be updated.
1362
+ # @param [String] fields
1363
+ # Selector specifying which fields to include in a partial response.
1364
+ # @param [String] quota_user
1365
+ # Available to use for quota purposes for server-side applications. Can be any
1366
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1367
+ # @param [Google::Apis::RequestOptions] options
1368
+ # Request-specific options
1369
+ #
1370
+ # @yield [result, err] Result & error if block supplied
1371
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] parsed result object
1372
+ # @yieldparam err [StandardError] error object if request failed
1373
+ #
1374
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig]
1375
+ #
1376
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1377
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1378
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1379
+ def patch_organization_mute_config(name, google_cloud_securitycenter_v1_mute_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1380
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1381
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
1382
+ command.request_object = google_cloud_securitycenter_v1_mute_config_object
1383
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
1384
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig
1385
+ command.params['name'] = name unless name.nil?
1386
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1387
+ command.query['fields'] = fields unless fields.nil?
1388
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1389
+ execute_or_queue_command(command, &block)
1390
+ end
1391
+
1392
+ # Creates a notification config.
1393
+ # @param [String] parent
1394
+ # Required. Resource name of the new notification config's parent. Its format is
1395
+ # "organizations/[organization_id]".
1396
+ # @param [Google::Apis::SecuritycenterV1::NotificationConfig] notification_config_object
1397
+ # @param [String] config_id
1398
+ # Required. Unique identifier provided by the client within the parent scope. It
1399
+ # must be between 1 and 128 characters, and contains alphanumeric characters,
1400
+ # underscores or hyphens only.
1401
+ # @param [String] fields
1402
+ # Selector specifying which fields to include in a partial response.
1403
+ # @param [String] quota_user
1404
+ # Available to use for quota purposes for server-side applications. Can be any
1405
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1406
+ # @param [Google::Apis::RequestOptions] options
1407
+ # Request-specific options
1408
+ #
1409
+ # @yield [result, err] Result & error if block supplied
1410
+ # @yieldparam result [Google::Apis::SecuritycenterV1::NotificationConfig] parsed result object
1411
+ # @yieldparam err [StandardError] error object if request failed
1412
+ #
1413
+ # @return [Google::Apis::SecuritycenterV1::NotificationConfig]
1414
+ #
1415
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1416
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1417
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1418
+ def create_organization_notification_config(parent, notification_config_object = nil, config_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1419
+ command = make_simple_command(:post, 'v1/{+parent}/notificationConfigs', options)
1420
+ command.request_representation = Google::Apis::SecuritycenterV1::NotificationConfig::Representation
1421
+ command.request_object = notification_config_object
1422
+ command.response_representation = Google::Apis::SecuritycenterV1::NotificationConfig::Representation
1423
+ command.response_class = Google::Apis::SecuritycenterV1::NotificationConfig
1424
+ command.params['parent'] = parent unless parent.nil?
1425
+ command.query['configId'] = config_id unless config_id.nil?
1426
+ command.query['fields'] = fields unless fields.nil?
1427
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1428
+ execute_or_queue_command(command, &block)
1429
+ end
1430
+
1431
+ # Deletes a notification config.
1432
+ # @param [String] name
1433
+ # Required. Name of the notification config to delete. Its format is "
1434
+ # organizations/[organization_id]/notificationConfigs/[config_id]".
1435
+ # @param [String] fields
1436
+ # Selector specifying which fields to include in a partial response.
1437
+ # @param [String] quota_user
1438
+ # Available to use for quota purposes for server-side applications. Can be any
1439
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1440
+ # @param [Google::Apis::RequestOptions] options
1441
+ # Request-specific options
1442
+ #
1443
+ # @yield [result, err] Result & error if block supplied
1444
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
1445
+ # @yieldparam err [StandardError] error object if request failed
1446
+ #
1447
+ # @return [Google::Apis::SecuritycenterV1::Empty]
1448
+ #
1449
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1450
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1451
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1452
+ def delete_organization_notification_config(name, fields: nil, quota_user: nil, options: nil, &block)
1453
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1454
+ command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
1455
+ command.response_class = Google::Apis::SecuritycenterV1::Empty
1456
+ command.params['name'] = name unless name.nil?
1457
+ command.query['fields'] = fields unless fields.nil?
1458
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1459
+ execute_or_queue_command(command, &block)
1460
+ end
1461
+
1462
+ # Gets a notification config.
1463
+ # @param [String] name
1464
+ # Required. Name of the notification config to get. Its format is "organizations/
1465
+ # [organization_id]/notificationConfigs/[config_id]".
1466
+ # @param [String] fields
1467
+ # Selector specifying which fields to include in a partial response.
1468
+ # @param [String] quota_user
1469
+ # Available to use for quota purposes for server-side applications. Can be any
1470
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1471
+ # @param [Google::Apis::RequestOptions] options
1472
+ # Request-specific options
1473
+ #
1474
+ # @yield [result, err] Result & error if block supplied
1475
+ # @yieldparam result [Google::Apis::SecuritycenterV1::NotificationConfig] parsed result object
1476
+ # @yieldparam err [StandardError] error object if request failed
1477
+ #
1478
+ # @return [Google::Apis::SecuritycenterV1::NotificationConfig]
1479
+ #
1480
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1481
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1482
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1483
+ def get_organization_notification_config(name, fields: nil, quota_user: nil, options: nil, &block)
1484
+ command = make_simple_command(:get, 'v1/{+name}', options)
1485
+ command.response_representation = Google::Apis::SecuritycenterV1::NotificationConfig::Representation
1486
+ command.response_class = Google::Apis::SecuritycenterV1::NotificationConfig
1487
+ command.params['name'] = name unless name.nil?
1488
+ command.query['fields'] = fields unless fields.nil?
1489
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1490
+ execute_or_queue_command(command, &block)
1491
+ end
1492
+
1493
+ # Lists notification configs.
975
1494
  # @param [String] parent
976
1495
  # Required. Name of the organization to list notification configs. Its format is
977
1496
  # "organizations/[organization_id]".
@@ -1683,6 +2202,43 @@ module Google
1683
2202
  execute_or_queue_command(command, &block)
1684
2203
  end
1685
2204
 
2205
+ # Updates the mute state of a finding.
2206
+ # @param [String] name
2207
+ # Required. The relative resource name of the finding. See: https://cloud.google.
2208
+ # com/apis/design/resource_names#relative_resource_name Example: "organizations/`
2209
+ # organization_id`/sources/`source_id`/finding/`finding_id`", "folders/`
2210
+ # folder_id`/sources/`source_id`/finding/`finding_id`", "projects/`project_id`/
2211
+ # sources/`source_id`/finding/`finding_id`".
2212
+ # @param [Google::Apis::SecuritycenterV1::SetMuteRequest] set_mute_request_object
2213
+ # @param [String] fields
2214
+ # Selector specifying which fields to include in a partial response.
2215
+ # @param [String] quota_user
2216
+ # Available to use for quota purposes for server-side applications. Can be any
2217
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2218
+ # @param [Google::Apis::RequestOptions] options
2219
+ # Request-specific options
2220
+ #
2221
+ # @yield [result, err] Result & error if block supplied
2222
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Finding] parsed result object
2223
+ # @yieldparam err [StandardError] error object if request failed
2224
+ #
2225
+ # @return [Google::Apis::SecuritycenterV1::Finding]
2226
+ #
2227
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2228
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2229
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2230
+ def set_organization_source_finding_mute(name, set_mute_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2231
+ command = make_simple_command(:post, 'v1/{+name}:setMute', options)
2232
+ command.request_representation = Google::Apis::SecuritycenterV1::SetMuteRequest::Representation
2233
+ command.request_object = set_mute_request_object
2234
+ command.response_representation = Google::Apis::SecuritycenterV1::Finding::Representation
2235
+ command.response_class = Google::Apis::SecuritycenterV1::Finding
2236
+ command.params['name'] = name unless name.nil?
2237
+ command.query['fields'] = fields unless fields.nil?
2238
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2239
+ execute_or_queue_command(command, &block)
2240
+ end
2241
+
1686
2242
  # Updates the state of a finding.
1687
2243
  # @param [String] name
1688
2244
  # Required. The relative resource name of the finding. See: https://cloud.google.
@@ -1764,6 +2320,46 @@ module Google
1764
2320
  execute_or_queue_command(command, &block)
1765
2321
  end
1766
2322
 
2323
+ # Updates external system. This is for a given finding.
2324
+ # @param [String] name
2325
+ # External System Name e.g. jira, demisto, etc. e.g.: organizations/1234/sources/
2326
+ # 5678/findings/123456/externalSystems/jira folders/1234/sources/5678/findings/
2327
+ # 123456/externalSystems/jira projects/1234/sources/5678/findings/123456/
2328
+ # externalSystems/jira
2329
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem] google_cloud_securitycenter_v1_external_system_object
2330
+ # @param [String] update_mask
2331
+ # The FieldMask to use when updating the external system resource. If empty all
2332
+ # mutable fields will be updated.
2333
+ # @param [String] fields
2334
+ # Selector specifying which fields to include in a partial response.
2335
+ # @param [String] quota_user
2336
+ # Available to use for quota purposes for server-side applications. Can be any
2337
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2338
+ # @param [Google::Apis::RequestOptions] options
2339
+ # Request-specific options
2340
+ #
2341
+ # @yield [result, err] Result & error if block supplied
2342
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem] parsed result object
2343
+ # @yieldparam err [StandardError] error object if request failed
2344
+ #
2345
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem]
2346
+ #
2347
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2348
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2349
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2350
+ def patch_organization_source_finding_external_system(name, google_cloud_securitycenter_v1_external_system_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2351
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2352
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem::Representation
2353
+ command.request_object = google_cloud_securitycenter_v1_external_system_object
2354
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem::Representation
2355
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem
2356
+ command.params['name'] = name unless name.nil?
2357
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2358
+ command.query['fields'] = fields unless fields.nil?
2359
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2360
+ execute_or_queue_command(command, &block)
2361
+ end
2362
+
1767
2363
  # Filters an organization's assets and groups them by their specified properties.
1768
2364
  # @param [String] parent
1769
2365
  # Required. Name of the organization to groupBy. Its format is "organizations/[
@@ -1961,6 +2557,227 @@ module Google
1961
2557
  execute_or_queue_command(command, &block)
1962
2558
  end
1963
2559
 
2560
+ # Kicks off an LRO to bulk mute findings for a parent based on a filter. The
2561
+ # parent can be either an organization, folder or project. The findings matched
2562
+ # by the filter will be muted after the LRO is done.
2563
+ # @param [String] parent
2564
+ # Required. The parent, at which bulk action needs to be applied. Its format is "
2565
+ # organizations/[organization_id]", "folders/[folder_id]", "projects/[project_id]
2566
+ # ".
2567
+ # @param [Google::Apis::SecuritycenterV1::BulkMuteFindingsRequest] bulk_mute_findings_request_object
2568
+ # @param [String] fields
2569
+ # Selector specifying which fields to include in a partial response.
2570
+ # @param [String] quota_user
2571
+ # Available to use for quota purposes for server-side applications. Can be any
2572
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2573
+ # @param [Google::Apis::RequestOptions] options
2574
+ # Request-specific options
2575
+ #
2576
+ # @yield [result, err] Result & error if block supplied
2577
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Operation] parsed result object
2578
+ # @yieldparam err [StandardError] error object if request failed
2579
+ #
2580
+ # @return [Google::Apis::SecuritycenterV1::Operation]
2581
+ #
2582
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2583
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2584
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2585
+ def bulk_project_finding_mute(parent, bulk_mute_findings_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2586
+ command = make_simple_command(:post, 'v1/{+parent}/findings:bulkMute', options)
2587
+ command.request_representation = Google::Apis::SecuritycenterV1::BulkMuteFindingsRequest::Representation
2588
+ command.request_object = bulk_mute_findings_request_object
2589
+ command.response_representation = Google::Apis::SecuritycenterV1::Operation::Representation
2590
+ command.response_class = Google::Apis::SecuritycenterV1::Operation
2591
+ command.params['parent'] = parent unless parent.nil?
2592
+ command.query['fields'] = fields unless fields.nil?
2593
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2594
+ execute_or_queue_command(command, &block)
2595
+ end
2596
+
2597
+ # Creates a mute config.
2598
+ # @param [String] parent
2599
+ # Required. Resource name of the new mute configs's parent. Its format is "
2600
+ # organizations/[organization_id]", "folders/[folder_id]", or "projects/[
2601
+ # project_id]".
2602
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] google_cloud_securitycenter_v1_mute_config_object
2603
+ # @param [String] mute_config_id
2604
+ # Required. Unique identifier provided by the client within the parent scope. It
2605
+ # must consist of lower case letters, numbers, and hyphen, with the first
2606
+ # character a letter, the last a letter or a number, and a 63 character maximum.
2607
+ # @param [String] fields
2608
+ # Selector specifying which fields to include in a partial response.
2609
+ # @param [String] quota_user
2610
+ # Available to use for quota purposes for server-side applications. Can be any
2611
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2612
+ # @param [Google::Apis::RequestOptions] options
2613
+ # Request-specific options
2614
+ #
2615
+ # @yield [result, err] Result & error if block supplied
2616
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] parsed result object
2617
+ # @yieldparam err [StandardError] error object if request failed
2618
+ #
2619
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig]
2620
+ #
2621
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2622
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2623
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2624
+ def create_project_mute_config(parent, google_cloud_securitycenter_v1_mute_config_object = nil, mute_config_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2625
+ command = make_simple_command(:post, 'v1/{+parent}/muteConfigs', options)
2626
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
2627
+ command.request_object = google_cloud_securitycenter_v1_mute_config_object
2628
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
2629
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig
2630
+ command.params['parent'] = parent unless parent.nil?
2631
+ command.query['muteConfigId'] = mute_config_id unless mute_config_id.nil?
2632
+ command.query['fields'] = fields unless fields.nil?
2633
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2634
+ execute_or_queue_command(command, &block)
2635
+ end
2636
+
2637
+ # Deletes an existing mute config.
2638
+ # @param [String] name
2639
+ # Required. Name of the mute config to delete. Its format is organizations/`
2640
+ # organization`/muteConfigs/`config_id`, folders/`folder`/muteConfigs/`config_id`
2641
+ # , or projects/`project`/muteConfigs/`config_id`
2642
+ # @param [String] fields
2643
+ # Selector specifying which fields to include in a partial response.
2644
+ # @param [String] quota_user
2645
+ # Available to use for quota purposes for server-side applications. Can be any
2646
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2647
+ # @param [Google::Apis::RequestOptions] options
2648
+ # Request-specific options
2649
+ #
2650
+ # @yield [result, err] Result & error if block supplied
2651
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
2652
+ # @yieldparam err [StandardError] error object if request failed
2653
+ #
2654
+ # @return [Google::Apis::SecuritycenterV1::Empty]
2655
+ #
2656
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2657
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2658
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2659
+ def delete_project_mute_config(name, fields: nil, quota_user: nil, options: nil, &block)
2660
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2661
+ command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
2662
+ command.response_class = Google::Apis::SecuritycenterV1::Empty
2663
+ command.params['name'] = name unless name.nil?
2664
+ command.query['fields'] = fields unless fields.nil?
2665
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2666
+ execute_or_queue_command(command, &block)
2667
+ end
2668
+
2669
+ # Gets a mute config.
2670
+ # @param [String] name
2671
+ # Required. Name of the mute config to retrieve. Its format is organizations/`
2672
+ # organization`/muteConfigs/`config_id`, folders/`folder`/muteConfigs/`config_id`
2673
+ # , or projects/`project`/muteConfigs/`config_id`
2674
+ # @param [String] fields
2675
+ # Selector specifying which fields to include in a partial response.
2676
+ # @param [String] quota_user
2677
+ # Available to use for quota purposes for server-side applications. Can be any
2678
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2679
+ # @param [Google::Apis::RequestOptions] options
2680
+ # Request-specific options
2681
+ #
2682
+ # @yield [result, err] Result & error if block supplied
2683
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] parsed result object
2684
+ # @yieldparam err [StandardError] error object if request failed
2685
+ #
2686
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig]
2687
+ #
2688
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2689
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2690
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2691
+ def get_project_mute_config(name, fields: nil, quota_user: nil, options: nil, &block)
2692
+ command = make_simple_command(:get, 'v1/{+name}', options)
2693
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
2694
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig
2695
+ command.params['name'] = name unless name.nil?
2696
+ command.query['fields'] = fields unless fields.nil?
2697
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2698
+ execute_or_queue_command(command, &block)
2699
+ end
2700
+
2701
+ # Lists mute configs.
2702
+ # @param [String] parent
2703
+ # Required. The parent, which owns the collection of mute configs. Its format is
2704
+ # "organizations/[organization_id]", "folders/[folder_id]", "projects/[
2705
+ # project_id]".
2706
+ # @param [Fixnum] page_size
2707
+ # The maximum number of configs to return. The service may return fewer than
2708
+ # this value. If unspecified, at most 10 configs will be returned. The maximum
2709
+ # value is 1000; values above 1000 will be coerced to 1000.
2710
+ # @param [String] page_token
2711
+ # A page token, received from a previous `ListMuteConfigs` call. Provide this to
2712
+ # retrieve the subsequent page. When paginating, all other parameters provided
2713
+ # to `ListMuteConfigs` must match the call that provided the page token.
2714
+ # @param [String] fields
2715
+ # Selector specifying which fields to include in a partial response.
2716
+ # @param [String] quota_user
2717
+ # Available to use for quota purposes for server-side applications. Can be any
2718
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2719
+ # @param [Google::Apis::RequestOptions] options
2720
+ # Request-specific options
2721
+ #
2722
+ # @yield [result, err] Result & error if block supplied
2723
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListMuteConfigsResponse] parsed result object
2724
+ # @yieldparam err [StandardError] error object if request failed
2725
+ #
2726
+ # @return [Google::Apis::SecuritycenterV1::ListMuteConfigsResponse]
2727
+ #
2728
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2729
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2730
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2731
+ def list_project_mute_configs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2732
+ command = make_simple_command(:get, 'v1/{+parent}/muteConfigs', options)
2733
+ command.response_representation = Google::Apis::SecuritycenterV1::ListMuteConfigsResponse::Representation
2734
+ command.response_class = Google::Apis::SecuritycenterV1::ListMuteConfigsResponse
2735
+ command.params['parent'] = parent unless parent.nil?
2736
+ command.query['pageSize'] = page_size unless page_size.nil?
2737
+ command.query['pageToken'] = page_token unless page_token.nil?
2738
+ command.query['fields'] = fields unless fields.nil?
2739
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2740
+ execute_or_queue_command(command, &block)
2741
+ end
2742
+
2743
+ # Updates a mute config.
2744
+ # @param [String] name
2745
+ # This field will be ignored if provided on config creation. Format "
2746
+ # organizations/`organization`/muteConfigs/`mute_config`" "folders/`folder`/
2747
+ # muteConfigs/`mute_config`" "projects/`project`/muteConfigs/`mute_config`"
2748
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] google_cloud_securitycenter_v1_mute_config_object
2749
+ # @param [String] update_mask
2750
+ # The list of fields to be updated. If empty all mutable fields will be updated.
2751
+ # @param [String] fields
2752
+ # Selector specifying which fields to include in a partial response.
2753
+ # @param [String] quota_user
2754
+ # Available to use for quota purposes for server-side applications. Can be any
2755
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2756
+ # @param [Google::Apis::RequestOptions] options
2757
+ # Request-specific options
2758
+ #
2759
+ # @yield [result, err] Result & error if block supplied
2760
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig] parsed result object
2761
+ # @yieldparam err [StandardError] error object if request failed
2762
+ #
2763
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig]
2764
+ #
2765
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2766
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2767
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2768
+ def patch_project_mute_config(name, google_cloud_securitycenter_v1_mute_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2769
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2770
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
2771
+ command.request_object = google_cloud_securitycenter_v1_mute_config_object
2772
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig::Representation
2773
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1MuteConfig
2774
+ command.params['name'] = name unless name.nil?
2775
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2776
+ command.query['fields'] = fields unless fields.nil?
2777
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2778
+ execute_or_queue_command(command, &block)
2779
+ end
2780
+
1964
2781
  # Lists all sources belonging to an organization.
1965
2782
  # @param [String] parent
1966
2783
  # Required. Resource name of the parent of sources to list. Its format should be
@@ -2200,6 +3017,43 @@ module Google
2200
3017
  execute_or_queue_command(command, &block)
2201
3018
  end
2202
3019
 
3020
+ # Updates the mute state of a finding.
3021
+ # @param [String] name
3022
+ # Required. The relative resource name of the finding. See: https://cloud.google.
3023
+ # com/apis/design/resource_names#relative_resource_name Example: "organizations/`
3024
+ # organization_id`/sources/`source_id`/finding/`finding_id`", "folders/`
3025
+ # folder_id`/sources/`source_id`/finding/`finding_id`", "projects/`project_id`/
3026
+ # sources/`source_id`/finding/`finding_id`".
3027
+ # @param [Google::Apis::SecuritycenterV1::SetMuteRequest] set_mute_request_object
3028
+ # @param [String] fields
3029
+ # Selector specifying which fields to include in a partial response.
3030
+ # @param [String] quota_user
3031
+ # Available to use for quota purposes for server-side applications. Can be any
3032
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3033
+ # @param [Google::Apis::RequestOptions] options
3034
+ # Request-specific options
3035
+ #
3036
+ # @yield [result, err] Result & error if block supplied
3037
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Finding] parsed result object
3038
+ # @yieldparam err [StandardError] error object if request failed
3039
+ #
3040
+ # @return [Google::Apis::SecuritycenterV1::Finding]
3041
+ #
3042
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3043
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3044
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3045
+ def set_project_source_finding_mute(name, set_mute_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3046
+ command = make_simple_command(:post, 'v1/{+name}:setMute', options)
3047
+ command.request_representation = Google::Apis::SecuritycenterV1::SetMuteRequest::Representation
3048
+ command.request_object = set_mute_request_object
3049
+ command.response_representation = Google::Apis::SecuritycenterV1::Finding::Representation
3050
+ command.response_class = Google::Apis::SecuritycenterV1::Finding
3051
+ command.params['name'] = name unless name.nil?
3052
+ command.query['fields'] = fields unless fields.nil?
3053
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3054
+ execute_or_queue_command(command, &block)
3055
+ end
3056
+
2203
3057
  # Updates the state of a finding.
2204
3058
  # @param [String] name
2205
3059
  # Required. The relative resource name of the finding. See: https://cloud.google.
@@ -2280,6 +3134,46 @@ module Google
2280
3134
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2281
3135
  execute_or_queue_command(command, &block)
2282
3136
  end
3137
+
3138
+ # Updates external system. This is for a given finding.
3139
+ # @param [String] name
3140
+ # External System Name e.g. jira, demisto, etc. e.g.: organizations/1234/sources/
3141
+ # 5678/findings/123456/externalSystems/jira folders/1234/sources/5678/findings/
3142
+ # 123456/externalSystems/jira projects/1234/sources/5678/findings/123456/
3143
+ # externalSystems/jira
3144
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem] google_cloud_securitycenter_v1_external_system_object
3145
+ # @param [String] update_mask
3146
+ # The FieldMask to use when updating the external system resource. If empty all
3147
+ # mutable fields will be updated.
3148
+ # @param [String] fields
3149
+ # Selector specifying which fields to include in a partial response.
3150
+ # @param [String] quota_user
3151
+ # Available to use for quota purposes for server-side applications. Can be any
3152
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3153
+ # @param [Google::Apis::RequestOptions] options
3154
+ # Request-specific options
3155
+ #
3156
+ # @yield [result, err] Result & error if block supplied
3157
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem] parsed result object
3158
+ # @yieldparam err [StandardError] error object if request failed
3159
+ #
3160
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem]
3161
+ #
3162
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3163
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3164
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3165
+ def patch_project_source_finding_external_system(name, google_cloud_securitycenter_v1_external_system_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3166
+ command = make_simple_command(:patch, 'v1/{+name}', options)
3167
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem::Representation
3168
+ command.request_object = google_cloud_securitycenter_v1_external_system_object
3169
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem::Representation
3170
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ExternalSystem
3171
+ command.params['name'] = name unless name.nil?
3172
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3173
+ command.query['fields'] = fields unless fields.nil?
3174
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3175
+ execute_or_queue_command(command, &block)
3176
+ end
2283
3177
 
2284
3178
  protected
2285
3179