google-apis-securitycenter_v1 0.12.0 → 0.16.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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
@@ -387,7 +608,7 @@ module Google
387
608
  # my_property : ""` * resource: * resource.name: `=`, `:` * resource.parent_name:
388
609
  # `=`, `:` * resource.parent_display_name: `=`, `:` * resource.project_name: `=`
389
610
  # , `:` * resource.project_display_name: `=`, `:` * resource.type: `=`, `:` *
390
- # resource.folders.resource_folder: `=`, `:`
611
+ # resource.folders.resource_folder: `=`, `:` * resource.display_name: `=`, `:`
391
612
  # @param [String] order_by
392
613
  # Expression that defines what fields and order to use for sorting. The string
393
614
  # value should follow SQL syntax: comma separated list of fields. For example: "
@@ -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]".
@@ -1584,7 +2103,7 @@ module Google
1584
2103
  # my_property : ""` * resource: * resource.name: `=`, `:` * resource.parent_name:
1585
2104
  # `=`, `:` * resource.parent_display_name: `=`, `:` * resource.project_name: `=`
1586
2105
  # , `:` * resource.project_display_name: `=`, `:` * resource.type: `=`, `:` *
1587
- # resource.folders.resource_folder: `=`, `:`
2106
+ # resource.folders.resource_folder: `=`, `:` * resource.display_name: `=`, `:`
1588
2107
  # @param [String] order_by
1589
2108
  # Expression that defines what fields and order to use for sorting. The string
1590
2109
  # value should follow SQL syntax: comma separated list of fields. For example: "
@@ -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
@@ -2101,7 +2918,7 @@ module Google
2101
2918
  # my_property : ""` * resource: * resource.name: `=`, `:` * resource.parent_name:
2102
2919
  # `=`, `:` * resource.parent_display_name: `=`, `:` * resource.project_name: `=`
2103
2920
  # , `:` * resource.project_display_name: `=`, `:` * resource.type: `=`, `:` *
2104
- # resource.folders.resource_folder: `=`, `:`
2921
+ # resource.folders.resource_folder: `=`, `:` * resource.display_name: `=`, `:`
2105
2922
  # @param [String] order_by
2106
2923
  # Expression that defines what fields and order to use for sorting. The string
2107
2924
  # value should follow SQL syntax: comma separated list of fields. For example: "
@@ -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