google-apis-logging_v2 0.72.0 → 0.73.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 3e6bb8562dbf79c0af9817462de5db9d619a11d0b50b663f26ef6afc01a139b0
4
- data.tar.gz: 9a432fe43a927fcbe8cd3bdab1c58f450a5d434dff12dc9461324be8c71e2949
3
+ metadata.gz: a67ac8f2d1ef72b6e6d6a8dffbb9351be1e5ab133c575eff4b9507a5ca9548ad
4
+ data.tar.gz: 1ae1344772c1e1c9b961a85b973b7c1b04825eaf9b6a7db443df88ed3cd73a7f
5
5
  SHA512:
6
- metadata.gz: fae7e0a4afc4413981750895416e15fa4d1eae21b9e8b61fb27eddea04851e7a8416e81ba02619406aef31f9f18f3ac5c476bdf4c6002d0d041f8fc78aeddd54
7
- data.tar.gz: 5c64706c20475ec10eb18d63c7a2f004b4d6330e2c9ce155a5b5ba71681e9c0b37a9ed9c0f8d8f7860e87bdeda045c17c619ae126aa90e57fe7618b5419851f1
6
+ metadata.gz: e3b4d5f13ffb0ac4c1ccac6ec5da23a360bd21a79b78809fc789e0cbd4f41af27d10c76b55fa5d2a1ddb2404d6d71b4c20bc31286852ad0e6bbfd9592076968f
7
+ data.tar.gz: 6cf66a26096663eec20e16c61241acef01315da46024ba5291661499432ce79afdc7017541af483805c1ebe2cdbc830679a2d44437044ce7e1f0d0a458dbb08a
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release history for google-apis-logging_v2
2
2
 
3
+ ### v0.73.0 (2024-09-15)
4
+
5
+ * Regenerated from discovery document revision 20240908
6
+
3
7
  ### v0.72.0 (2024-08-04)
4
8
 
5
9
  * Regenerated from discovery document revision 20240726
@@ -1451,6 +1451,34 @@ module Google
1451
1451
  end
1452
1452
  end
1453
1453
 
1454
+ # The response from ListLogScopes. Every project has a _Default log scope that
1455
+ # cannot be modified or deleted.
1456
+ class ListLogScopesResponse
1457
+ include Google::Apis::Core::Hashable
1458
+
1459
+ # A list of log scopes.
1460
+ # Corresponds to the JSON property `logScopes`
1461
+ # @return [Array<Google::Apis::LoggingV2::LogScope>]
1462
+ attr_accessor :log_scopes
1463
+
1464
+ # If there might be more results than appear in this response, then
1465
+ # nextPageToken is included. To get the next set of results, call the same
1466
+ # method again using the value of nextPageToken as pageToken.
1467
+ # Corresponds to the JSON property `nextPageToken`
1468
+ # @return [String]
1469
+ attr_accessor :next_page_token
1470
+
1471
+ def initialize(**args)
1472
+ update!(**args)
1473
+ end
1474
+
1475
+ # Update properties of this object
1476
+ def update!(**args)
1477
+ @log_scopes = args[:log_scopes] if args.key?(:log_scopes)
1478
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1479
+ end
1480
+ end
1481
+
1454
1482
  # Result returned from ListLogs.
1455
1483
  class ListLogsResponse
1456
1484
  include Google::Apis::Core::Hashable
@@ -2413,6 +2441,54 @@ module Google
2413
2441
  end
2414
2442
  end
2415
2443
 
2444
+ # Describes a group of resources to read log entries from.
2445
+ class LogScope
2446
+ include Google::Apis::Core::Hashable
2447
+
2448
+ # Output only. The creation timestamp of the log scope.
2449
+ # Corresponds to the JSON property `createTime`
2450
+ # @return [String]
2451
+ attr_accessor :create_time
2452
+
2453
+ # Optional. Describes this log scope.The maximum length of the description is
2454
+ # 8000 characters.
2455
+ # Corresponds to the JSON property `description`
2456
+ # @return [String]
2457
+ attr_accessor :description
2458
+
2459
+ # Output only. The resource name of the log scope.For example:projects/my-
2460
+ # project/locations/global/logScopes/my-log-scope
2461
+ # Corresponds to the JSON property `name`
2462
+ # @return [String]
2463
+ attr_accessor :name
2464
+
2465
+ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May
2466
+ # alternatively be one or more views: projects/[PROJECT_ID]/locations/[
2467
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a
2468
+ # maximum of 50 projects and a maximum of 100 resources in total.
2469
+ # Corresponds to the JSON property `resourceNames`
2470
+ # @return [Array<String>]
2471
+ attr_accessor :resource_names
2472
+
2473
+ # Output only. The last update timestamp of the log scope.
2474
+ # Corresponds to the JSON property `updateTime`
2475
+ # @return [String]
2476
+ attr_accessor :update_time
2477
+
2478
+ def initialize(**args)
2479
+ update!(**args)
2480
+ end
2481
+
2482
+ # Update properties of this object
2483
+ def update!(**args)
2484
+ @create_time = args[:create_time] if args.key?(:create_time)
2485
+ @description = args[:description] if args.key?(:description)
2486
+ @name = args[:name] if args.key?(:name)
2487
+ @resource_names = args[:resource_names] if args.key?(:resource_names)
2488
+ @update_time = args[:update_time] if args.key?(:update_time)
2489
+ end
2490
+ end
2491
+
2416
2492
  # Describes a sink used to export log entries to one of the following
2417
2493
  # destinations: a Cloud Logging log bucket, a Cloud Storage bucket, a BigQuery
2418
2494
  # dataset, a Pub/Sub topic, a Cloud project.A logs filter controls which log
@@ -2862,6 +2938,11 @@ module Google
2862
2938
  # @return [String]
2863
2939
  attr_accessor :sample_period
2864
2940
 
2941
+ # The scope of the timeseries data of the metric.
2942
+ # Corresponds to the JSON property `timeSeriesResourceHierarchyLevel`
2943
+ # @return [Array<String>]
2944
+ attr_accessor :time_series_resource_hierarchy_level
2945
+
2865
2946
  def initialize(**args)
2866
2947
  update!(**args)
2867
2948
  end
@@ -2871,6 +2952,7 @@ module Google
2871
2952
  @ingest_delay = args[:ingest_delay] if args.key?(:ingest_delay)
2872
2953
  @launch_stage = args[:launch_stage] if args.key?(:launch_stage)
2873
2954
  @sample_period = args[:sample_period] if args.key?(:sample_period)
2955
+ @time_series_resource_hierarchy_level = args[:time_series_resource_hierarchy_level] if args.key?(:time_series_resource_hierarchy_level)
2874
2956
  end
2875
2957
  end
2876
2958
 
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module LoggingV2
18
18
  # Version of the google-apis-logging_v2 gem
19
- GEM_VERSION = "0.72.0"
19
+ GEM_VERSION = "0.73.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.15.1"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20240726"
25
+ REVISION = "20240908"
26
26
  end
27
27
  end
28
28
  end
@@ -232,6 +232,12 @@ module Google
232
232
  include Google::Apis::Core::JsonObjectSupport
233
233
  end
234
234
 
235
+ class ListLogScopesResponse
236
+ class Representation < Google::Apis::Core::JsonRepresentation; end
237
+
238
+ include Google::Apis::Core::JsonObjectSupport
239
+ end
240
+
235
241
  class ListLogsResponse
236
242
  class Representation < Google::Apis::Core::JsonRepresentation; end
237
243
 
@@ -334,6 +340,12 @@ module Google
334
340
  include Google::Apis::Core::JsonObjectSupport
335
341
  end
336
342
 
343
+ class LogScope
344
+ class Representation < Google::Apis::Core::JsonRepresentation; end
345
+
346
+ include Google::Apis::Core::JsonObjectSupport
347
+ end
348
+
337
349
  class LogSink
338
350
  class Representation < Google::Apis::Core::JsonRepresentation; end
339
351
 
@@ -853,6 +865,15 @@ module Google
853
865
  end
854
866
  end
855
867
 
868
+ class ListLogScopesResponse
869
+ # @private
870
+ class Representation < Google::Apis::Core::JsonRepresentation
871
+ collection :log_scopes, as: 'logScopes', class: Google::Apis::LoggingV2::LogScope, decorator: Google::Apis::LoggingV2::LogScope::Representation
872
+
873
+ property :next_page_token, as: 'nextPageToken'
874
+ end
875
+ end
876
+
856
877
  class ListLogsResponse
857
878
  # @private
858
879
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1056,6 +1077,17 @@ module Google
1056
1077
  end
1057
1078
  end
1058
1079
 
1080
+ class LogScope
1081
+ # @private
1082
+ class Representation < Google::Apis::Core::JsonRepresentation
1083
+ property :create_time, as: 'createTime'
1084
+ property :description, as: 'description'
1085
+ property :name, as: 'name'
1086
+ collection :resource_names, as: 'resourceNames'
1087
+ property :update_time, as: 'updateTime'
1088
+ end
1089
+ end
1090
+
1059
1091
  class LogSink
1060
1092
  # @private
1061
1093
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1134,6 +1166,7 @@ module Google
1134
1166
  property :ingest_delay, as: 'ingestDelay'
1135
1167
  property :launch_stage, as: 'launchStage'
1136
1168
  property :sample_period, as: 'samplePeriod'
1169
+ collection :time_series_resource_hierarchy_level, as: 'timeSeriesResourceHierarchyLevel'
1137
1170
  end
1138
1171
  end
1139
1172
 
@@ -3510,6 +3510,193 @@ module Google
3510
3510
  execute_or_queue_command(command, &block)
3511
3511
  end
3512
3512
 
3513
+ # Creates a log scope.
3514
+ # @param [String] parent
3515
+ # Required. The parent project in which to create the log scope "projects/[
3516
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
3517
+ # locations/global"
3518
+ # @param [Google::Apis::LoggingV2::LogScope] log_scope_object
3519
+ # @param [String] log_scope_id
3520
+ # Required. A client-assigned identifier such as "log-scope". Identifiers are
3521
+ # limited to 100 characters and can include only letters, digits, underscores,
3522
+ # hyphens, and periods. First character has to be alphanumeric.
3523
+ # @param [String] fields
3524
+ # Selector specifying which fields to include in a partial response.
3525
+ # @param [String] quota_user
3526
+ # Available to use for quota purposes for server-side applications. Can be any
3527
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3528
+ # @param [Google::Apis::RequestOptions] options
3529
+ # Request-specific options
3530
+ #
3531
+ # @yield [result, err] Result & error if block supplied
3532
+ # @yieldparam result [Google::Apis::LoggingV2::LogScope] parsed result object
3533
+ # @yieldparam err [StandardError] error object if request failed
3534
+ #
3535
+ # @return [Google::Apis::LoggingV2::LogScope]
3536
+ #
3537
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3538
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3539
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3540
+ def create_folder_location_log_scope(parent, log_scope_object = nil, log_scope_id: nil, fields: nil, quota_user: nil, options: nil, &block)
3541
+ command = make_simple_command(:post, 'v2/{+parent}/logScopes', options)
3542
+ command.request_representation = Google::Apis::LoggingV2::LogScope::Representation
3543
+ command.request_object = log_scope_object
3544
+ command.response_representation = Google::Apis::LoggingV2::LogScope::Representation
3545
+ command.response_class = Google::Apis::LoggingV2::LogScope
3546
+ command.params['parent'] = parent unless parent.nil?
3547
+ command.query['logScopeId'] = log_scope_id unless log_scope_id.nil?
3548
+ command.query['fields'] = fields unless fields.nil?
3549
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3550
+ execute_or_queue_command(command, &block)
3551
+ end
3552
+
3553
+ # Deletes a log scope.
3554
+ # @param [String] name
3555
+ # Required. The resource name of the log scope to delete: "projects/[PROJECT_ID]/
3556
+ # locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-
3557
+ # project/locations/global/logScopes/my-log-scope"
3558
+ # @param [String] fields
3559
+ # Selector specifying which fields to include in a partial response.
3560
+ # @param [String] quota_user
3561
+ # Available to use for quota purposes for server-side applications. Can be any
3562
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3563
+ # @param [Google::Apis::RequestOptions] options
3564
+ # Request-specific options
3565
+ #
3566
+ # @yield [result, err] Result & error if block supplied
3567
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
3568
+ # @yieldparam err [StandardError] error object if request failed
3569
+ #
3570
+ # @return [Google::Apis::LoggingV2::Empty]
3571
+ #
3572
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3573
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3574
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3575
+ def delete_folder_location_log_scope(name, fields: nil, quota_user: nil, options: nil, &block)
3576
+ command = make_simple_command(:delete, 'v2/{+name}', options)
3577
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
3578
+ command.response_class = Google::Apis::LoggingV2::Empty
3579
+ command.params['name'] = name unless name.nil?
3580
+ command.query['fields'] = fields unless fields.nil?
3581
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3582
+ execute_or_queue_command(command, &block)
3583
+ end
3584
+
3585
+ # Gets a log scope.
3586
+ # @param [String] name
3587
+ # Required. The resource name of the log scope: "projects/[PROJECT_ID]/locations/
3588
+ # [LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-project/
3589
+ # locations/global/logScopes/my-log-scope"
3590
+ # @param [String] fields
3591
+ # Selector specifying which fields to include in a partial response.
3592
+ # @param [String] quota_user
3593
+ # Available to use for quota purposes for server-side applications. Can be any
3594
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3595
+ # @param [Google::Apis::RequestOptions] options
3596
+ # Request-specific options
3597
+ #
3598
+ # @yield [result, err] Result & error if block supplied
3599
+ # @yieldparam result [Google::Apis::LoggingV2::LogScope] parsed result object
3600
+ # @yieldparam err [StandardError] error object if request failed
3601
+ #
3602
+ # @return [Google::Apis::LoggingV2::LogScope]
3603
+ #
3604
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3605
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3606
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3607
+ def get_folder_location_log_scope(name, fields: nil, quota_user: nil, options: nil, &block)
3608
+ command = make_simple_command(:get, 'v2/{+name}', options)
3609
+ command.response_representation = Google::Apis::LoggingV2::LogScope::Representation
3610
+ command.response_class = Google::Apis::LoggingV2::LogScope
3611
+ command.params['name'] = name unless name.nil?
3612
+ command.query['fields'] = fields unless fields.nil?
3613
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3614
+ execute_or_queue_command(command, &block)
3615
+ end
3616
+
3617
+ # Lists log scopes.
3618
+ # @param [String] parent
3619
+ # Required. The parent resource whose log scopes are to be listed: "projects/[
3620
+ # PROJECT_ID]/locations/[LOCATION_ID]"
3621
+ # @param [Fixnum] page_size
3622
+ # Optional. The maximum number of results to return from this request.Non-
3623
+ # positive values are ignored. The presence of nextPageToken in the response
3624
+ # indicates that more results might be available.
3625
+ # @param [String] page_token
3626
+ # Optional. If present, then retrieve the next batch of results from the
3627
+ # preceding call to this method. pageToken must be the value of nextPageToken
3628
+ # from the previous response. The values of other method parameters should be
3629
+ # identical to those in the previous call.
3630
+ # @param [String] fields
3631
+ # Selector specifying which fields to include in a partial response.
3632
+ # @param [String] quota_user
3633
+ # Available to use for quota purposes for server-side applications. Can be any
3634
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3635
+ # @param [Google::Apis::RequestOptions] options
3636
+ # Request-specific options
3637
+ #
3638
+ # @yield [result, err] Result & error if block supplied
3639
+ # @yieldparam result [Google::Apis::LoggingV2::ListLogScopesResponse] parsed result object
3640
+ # @yieldparam err [StandardError] error object if request failed
3641
+ #
3642
+ # @return [Google::Apis::LoggingV2::ListLogScopesResponse]
3643
+ #
3644
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3645
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3646
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3647
+ def list_folder_location_log_scopes(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3648
+ command = make_simple_command(:get, 'v2/{+parent}/logScopes', options)
3649
+ command.response_representation = Google::Apis::LoggingV2::ListLogScopesResponse::Representation
3650
+ command.response_class = Google::Apis::LoggingV2::ListLogScopesResponse
3651
+ command.params['parent'] = parent unless parent.nil?
3652
+ command.query['pageSize'] = page_size unless page_size.nil?
3653
+ command.query['pageToken'] = page_token unless page_token.nil?
3654
+ command.query['fields'] = fields unless fields.nil?
3655
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3656
+ execute_or_queue_command(command, &block)
3657
+ end
3658
+
3659
+ # Updates a log scope.
3660
+ # @param [String] name
3661
+ # Output only. The resource name of the log scope.For example:projects/my-
3662
+ # project/locations/global/logScopes/my-log-scope
3663
+ # @param [Google::Apis::LoggingV2::LogScope] log_scope_object
3664
+ # @param [String] update_mask
3665
+ # Optional. Field mask that specifies the fields in log_scope that need an
3666
+ # update. A field will be overwritten if, and only if, it is in the update mask.
3667
+ # name and output only fields cannot be updated.For a detailed FieldMask
3668
+ # definition, see https://developers.google.com/protocol-buffers/docs/reference/
3669
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=description
3670
+ # @param [String] fields
3671
+ # Selector specifying which fields to include in a partial response.
3672
+ # @param [String] quota_user
3673
+ # Available to use for quota purposes for server-side applications. Can be any
3674
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3675
+ # @param [Google::Apis::RequestOptions] options
3676
+ # Request-specific options
3677
+ #
3678
+ # @yield [result, err] Result & error if block supplied
3679
+ # @yieldparam result [Google::Apis::LoggingV2::LogScope] parsed result object
3680
+ # @yieldparam err [StandardError] error object if request failed
3681
+ #
3682
+ # @return [Google::Apis::LoggingV2::LogScope]
3683
+ #
3684
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3685
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3686
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3687
+ def patch_folder_location_log_scope(name, log_scope_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3688
+ command = make_simple_command(:patch, 'v2/{+name}', options)
3689
+ command.request_representation = Google::Apis::LoggingV2::LogScope::Representation
3690
+ command.request_object = log_scope_object
3691
+ command.response_representation = Google::Apis::LoggingV2::LogScope::Representation
3692
+ command.response_class = Google::Apis::LoggingV2::LogScope
3693
+ command.params['name'] = name unless name.nil?
3694
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3695
+ command.query['fields'] = fields unless fields.nil?
3696
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3697
+ execute_or_queue_command(command, &block)
3698
+ end
3699
+
3513
3700
  # Starts asynchronous cancellation on a long-running operation. The server makes
3514
3701
  # a best effort to cancel the operation, but success is not guaranteed. If the
3515
3702
  # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
@@ -6726,6 +6913,193 @@ module Google
6726
6913
  execute_or_queue_command(command, &block)
6727
6914
  end
6728
6915
 
6916
+ # Creates a log scope.
6917
+ # @param [String] parent
6918
+ # Required. The parent project in which to create the log scope "projects/[
6919
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
6920
+ # locations/global"
6921
+ # @param [Google::Apis::LoggingV2::LogScope] log_scope_object
6922
+ # @param [String] log_scope_id
6923
+ # Required. A client-assigned identifier such as "log-scope". Identifiers are
6924
+ # limited to 100 characters and can include only letters, digits, underscores,
6925
+ # hyphens, and periods. First character has to be alphanumeric.
6926
+ # @param [String] fields
6927
+ # Selector specifying which fields to include in a partial response.
6928
+ # @param [String] quota_user
6929
+ # Available to use for quota purposes for server-side applications. Can be any
6930
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6931
+ # @param [Google::Apis::RequestOptions] options
6932
+ # Request-specific options
6933
+ #
6934
+ # @yield [result, err] Result & error if block supplied
6935
+ # @yieldparam result [Google::Apis::LoggingV2::LogScope] parsed result object
6936
+ # @yieldparam err [StandardError] error object if request failed
6937
+ #
6938
+ # @return [Google::Apis::LoggingV2::LogScope]
6939
+ #
6940
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6941
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6942
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6943
+ def create_organization_location_log_scope(parent, log_scope_object = nil, log_scope_id: nil, fields: nil, quota_user: nil, options: nil, &block)
6944
+ command = make_simple_command(:post, 'v2/{+parent}/logScopes', options)
6945
+ command.request_representation = Google::Apis::LoggingV2::LogScope::Representation
6946
+ command.request_object = log_scope_object
6947
+ command.response_representation = Google::Apis::LoggingV2::LogScope::Representation
6948
+ command.response_class = Google::Apis::LoggingV2::LogScope
6949
+ command.params['parent'] = parent unless parent.nil?
6950
+ command.query['logScopeId'] = log_scope_id unless log_scope_id.nil?
6951
+ command.query['fields'] = fields unless fields.nil?
6952
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6953
+ execute_or_queue_command(command, &block)
6954
+ end
6955
+
6956
+ # Deletes a log scope.
6957
+ # @param [String] name
6958
+ # Required. The resource name of the log scope to delete: "projects/[PROJECT_ID]/
6959
+ # locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-
6960
+ # project/locations/global/logScopes/my-log-scope"
6961
+ # @param [String] fields
6962
+ # Selector specifying which fields to include in a partial response.
6963
+ # @param [String] quota_user
6964
+ # Available to use for quota purposes for server-side applications. Can be any
6965
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6966
+ # @param [Google::Apis::RequestOptions] options
6967
+ # Request-specific options
6968
+ #
6969
+ # @yield [result, err] Result & error if block supplied
6970
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
6971
+ # @yieldparam err [StandardError] error object if request failed
6972
+ #
6973
+ # @return [Google::Apis::LoggingV2::Empty]
6974
+ #
6975
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6976
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6977
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6978
+ def delete_organization_location_log_scope(name, fields: nil, quota_user: nil, options: nil, &block)
6979
+ command = make_simple_command(:delete, 'v2/{+name}', options)
6980
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
6981
+ command.response_class = Google::Apis::LoggingV2::Empty
6982
+ command.params['name'] = name unless name.nil?
6983
+ command.query['fields'] = fields unless fields.nil?
6984
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6985
+ execute_or_queue_command(command, &block)
6986
+ end
6987
+
6988
+ # Gets a log scope.
6989
+ # @param [String] name
6990
+ # Required. The resource name of the log scope: "projects/[PROJECT_ID]/locations/
6991
+ # [LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-project/
6992
+ # locations/global/logScopes/my-log-scope"
6993
+ # @param [String] fields
6994
+ # Selector specifying which fields to include in a partial response.
6995
+ # @param [String] quota_user
6996
+ # Available to use for quota purposes for server-side applications. Can be any
6997
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6998
+ # @param [Google::Apis::RequestOptions] options
6999
+ # Request-specific options
7000
+ #
7001
+ # @yield [result, err] Result & error if block supplied
7002
+ # @yieldparam result [Google::Apis::LoggingV2::LogScope] parsed result object
7003
+ # @yieldparam err [StandardError] error object if request failed
7004
+ #
7005
+ # @return [Google::Apis::LoggingV2::LogScope]
7006
+ #
7007
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7008
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7009
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7010
+ def get_organization_location_log_scope(name, fields: nil, quota_user: nil, options: nil, &block)
7011
+ command = make_simple_command(:get, 'v2/{+name}', options)
7012
+ command.response_representation = Google::Apis::LoggingV2::LogScope::Representation
7013
+ command.response_class = Google::Apis::LoggingV2::LogScope
7014
+ command.params['name'] = name unless name.nil?
7015
+ command.query['fields'] = fields unless fields.nil?
7016
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7017
+ execute_or_queue_command(command, &block)
7018
+ end
7019
+
7020
+ # Lists log scopes.
7021
+ # @param [String] parent
7022
+ # Required. The parent resource whose log scopes are to be listed: "projects/[
7023
+ # PROJECT_ID]/locations/[LOCATION_ID]"
7024
+ # @param [Fixnum] page_size
7025
+ # Optional. The maximum number of results to return from this request.Non-
7026
+ # positive values are ignored. The presence of nextPageToken in the response
7027
+ # indicates that more results might be available.
7028
+ # @param [String] page_token
7029
+ # Optional. If present, then retrieve the next batch of results from the
7030
+ # preceding call to this method. pageToken must be the value of nextPageToken
7031
+ # from the previous response. The values of other method parameters should be
7032
+ # identical to those in the previous call.
7033
+ # @param [String] fields
7034
+ # Selector specifying which fields to include in a partial response.
7035
+ # @param [String] quota_user
7036
+ # Available to use for quota purposes for server-side applications. Can be any
7037
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7038
+ # @param [Google::Apis::RequestOptions] options
7039
+ # Request-specific options
7040
+ #
7041
+ # @yield [result, err] Result & error if block supplied
7042
+ # @yieldparam result [Google::Apis::LoggingV2::ListLogScopesResponse] parsed result object
7043
+ # @yieldparam err [StandardError] error object if request failed
7044
+ #
7045
+ # @return [Google::Apis::LoggingV2::ListLogScopesResponse]
7046
+ #
7047
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7048
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7049
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7050
+ def list_organization_location_log_scopes(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
7051
+ command = make_simple_command(:get, 'v2/{+parent}/logScopes', options)
7052
+ command.response_representation = Google::Apis::LoggingV2::ListLogScopesResponse::Representation
7053
+ command.response_class = Google::Apis::LoggingV2::ListLogScopesResponse
7054
+ command.params['parent'] = parent unless parent.nil?
7055
+ command.query['pageSize'] = page_size unless page_size.nil?
7056
+ command.query['pageToken'] = page_token unless page_token.nil?
7057
+ command.query['fields'] = fields unless fields.nil?
7058
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7059
+ execute_or_queue_command(command, &block)
7060
+ end
7061
+
7062
+ # Updates a log scope.
7063
+ # @param [String] name
7064
+ # Output only. The resource name of the log scope.For example:projects/my-
7065
+ # project/locations/global/logScopes/my-log-scope
7066
+ # @param [Google::Apis::LoggingV2::LogScope] log_scope_object
7067
+ # @param [String] update_mask
7068
+ # Optional. Field mask that specifies the fields in log_scope that need an
7069
+ # update. A field will be overwritten if, and only if, it is in the update mask.
7070
+ # name and output only fields cannot be updated.For a detailed FieldMask
7071
+ # definition, see https://developers.google.com/protocol-buffers/docs/reference/
7072
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=description
7073
+ # @param [String] fields
7074
+ # Selector specifying which fields to include in a partial response.
7075
+ # @param [String] quota_user
7076
+ # Available to use for quota purposes for server-side applications. Can be any
7077
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7078
+ # @param [Google::Apis::RequestOptions] options
7079
+ # Request-specific options
7080
+ #
7081
+ # @yield [result, err] Result & error if block supplied
7082
+ # @yieldparam result [Google::Apis::LoggingV2::LogScope] parsed result object
7083
+ # @yieldparam err [StandardError] error object if request failed
7084
+ #
7085
+ # @return [Google::Apis::LoggingV2::LogScope]
7086
+ #
7087
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7088
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7089
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7090
+ def patch_organization_location_log_scope(name, log_scope_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
7091
+ command = make_simple_command(:patch, 'v2/{+name}', options)
7092
+ command.request_representation = Google::Apis::LoggingV2::LogScope::Representation
7093
+ command.request_object = log_scope_object
7094
+ command.response_representation = Google::Apis::LoggingV2::LogScope::Representation
7095
+ command.response_class = Google::Apis::LoggingV2::LogScope
7096
+ command.params['name'] = name unless name.nil?
7097
+ command.query['updateMask'] = update_mask unless update_mask.nil?
7098
+ command.query['fields'] = fields unless fields.nil?
7099
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7100
+ execute_or_queue_command(command, &block)
7101
+ end
7102
+
6729
7103
  # Starts asynchronous cancellation on a long-running operation. The server makes
6730
7104
  # a best effort to cancel the operation, but success is not guaranteed. If the
6731
7105
  # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
@@ -8724,6 +9098,193 @@ module Google
8724
9098
  execute_or_queue_command(command, &block)
8725
9099
  end
8726
9100
 
9101
+ # Creates a log scope.
9102
+ # @param [String] parent
9103
+ # Required. The parent project in which to create the log scope "projects/[
9104
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
9105
+ # locations/global"
9106
+ # @param [Google::Apis::LoggingV2::LogScope] log_scope_object
9107
+ # @param [String] log_scope_id
9108
+ # Required. A client-assigned identifier such as "log-scope". Identifiers are
9109
+ # limited to 100 characters and can include only letters, digits, underscores,
9110
+ # hyphens, and periods. First character has to be alphanumeric.
9111
+ # @param [String] fields
9112
+ # Selector specifying which fields to include in a partial response.
9113
+ # @param [String] quota_user
9114
+ # Available to use for quota purposes for server-side applications. Can be any
9115
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9116
+ # @param [Google::Apis::RequestOptions] options
9117
+ # Request-specific options
9118
+ #
9119
+ # @yield [result, err] Result & error if block supplied
9120
+ # @yieldparam result [Google::Apis::LoggingV2::LogScope] parsed result object
9121
+ # @yieldparam err [StandardError] error object if request failed
9122
+ #
9123
+ # @return [Google::Apis::LoggingV2::LogScope]
9124
+ #
9125
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9126
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9127
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9128
+ def create_project_location_log_scope(parent, log_scope_object = nil, log_scope_id: nil, fields: nil, quota_user: nil, options: nil, &block)
9129
+ command = make_simple_command(:post, 'v2/{+parent}/logScopes', options)
9130
+ command.request_representation = Google::Apis::LoggingV2::LogScope::Representation
9131
+ command.request_object = log_scope_object
9132
+ command.response_representation = Google::Apis::LoggingV2::LogScope::Representation
9133
+ command.response_class = Google::Apis::LoggingV2::LogScope
9134
+ command.params['parent'] = parent unless parent.nil?
9135
+ command.query['logScopeId'] = log_scope_id unless log_scope_id.nil?
9136
+ command.query['fields'] = fields unless fields.nil?
9137
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9138
+ execute_or_queue_command(command, &block)
9139
+ end
9140
+
9141
+ # Deletes a log scope.
9142
+ # @param [String] name
9143
+ # Required. The resource name of the log scope to delete: "projects/[PROJECT_ID]/
9144
+ # locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-
9145
+ # project/locations/global/logScopes/my-log-scope"
9146
+ # @param [String] fields
9147
+ # Selector specifying which fields to include in a partial response.
9148
+ # @param [String] quota_user
9149
+ # Available to use for quota purposes for server-side applications. Can be any
9150
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9151
+ # @param [Google::Apis::RequestOptions] options
9152
+ # Request-specific options
9153
+ #
9154
+ # @yield [result, err] Result & error if block supplied
9155
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
9156
+ # @yieldparam err [StandardError] error object if request failed
9157
+ #
9158
+ # @return [Google::Apis::LoggingV2::Empty]
9159
+ #
9160
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9161
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9162
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9163
+ def delete_project_location_log_scope(name, fields: nil, quota_user: nil, options: nil, &block)
9164
+ command = make_simple_command(:delete, 'v2/{+name}', options)
9165
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
9166
+ command.response_class = Google::Apis::LoggingV2::Empty
9167
+ command.params['name'] = name unless name.nil?
9168
+ command.query['fields'] = fields unless fields.nil?
9169
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9170
+ execute_or_queue_command(command, &block)
9171
+ end
9172
+
9173
+ # Gets a log scope.
9174
+ # @param [String] name
9175
+ # Required. The resource name of the log scope: "projects/[PROJECT_ID]/locations/
9176
+ # [LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-project/
9177
+ # locations/global/logScopes/my-log-scope"
9178
+ # @param [String] fields
9179
+ # Selector specifying which fields to include in a partial response.
9180
+ # @param [String] quota_user
9181
+ # Available to use for quota purposes for server-side applications. Can be any
9182
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9183
+ # @param [Google::Apis::RequestOptions] options
9184
+ # Request-specific options
9185
+ #
9186
+ # @yield [result, err] Result & error if block supplied
9187
+ # @yieldparam result [Google::Apis::LoggingV2::LogScope] parsed result object
9188
+ # @yieldparam err [StandardError] error object if request failed
9189
+ #
9190
+ # @return [Google::Apis::LoggingV2::LogScope]
9191
+ #
9192
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9193
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9194
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9195
+ def get_project_location_log_scope(name, fields: nil, quota_user: nil, options: nil, &block)
9196
+ command = make_simple_command(:get, 'v2/{+name}', options)
9197
+ command.response_representation = Google::Apis::LoggingV2::LogScope::Representation
9198
+ command.response_class = Google::Apis::LoggingV2::LogScope
9199
+ command.params['name'] = name unless name.nil?
9200
+ command.query['fields'] = fields unless fields.nil?
9201
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9202
+ execute_or_queue_command(command, &block)
9203
+ end
9204
+
9205
+ # Lists log scopes.
9206
+ # @param [String] parent
9207
+ # Required. The parent resource whose log scopes are to be listed: "projects/[
9208
+ # PROJECT_ID]/locations/[LOCATION_ID]"
9209
+ # @param [Fixnum] page_size
9210
+ # Optional. The maximum number of results to return from this request.Non-
9211
+ # positive values are ignored. The presence of nextPageToken in the response
9212
+ # indicates that more results might be available.
9213
+ # @param [String] page_token
9214
+ # Optional. If present, then retrieve the next batch of results from the
9215
+ # preceding call to this method. pageToken must be the value of nextPageToken
9216
+ # from the previous response. The values of other method parameters should be
9217
+ # identical to those in the previous call.
9218
+ # @param [String] fields
9219
+ # Selector specifying which fields to include in a partial response.
9220
+ # @param [String] quota_user
9221
+ # Available to use for quota purposes for server-side applications. Can be any
9222
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9223
+ # @param [Google::Apis::RequestOptions] options
9224
+ # Request-specific options
9225
+ #
9226
+ # @yield [result, err] Result & error if block supplied
9227
+ # @yieldparam result [Google::Apis::LoggingV2::ListLogScopesResponse] parsed result object
9228
+ # @yieldparam err [StandardError] error object if request failed
9229
+ #
9230
+ # @return [Google::Apis::LoggingV2::ListLogScopesResponse]
9231
+ #
9232
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9233
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9234
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9235
+ def list_project_location_log_scopes(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
9236
+ command = make_simple_command(:get, 'v2/{+parent}/logScopes', options)
9237
+ command.response_representation = Google::Apis::LoggingV2::ListLogScopesResponse::Representation
9238
+ command.response_class = Google::Apis::LoggingV2::ListLogScopesResponse
9239
+ command.params['parent'] = parent unless parent.nil?
9240
+ command.query['pageSize'] = page_size unless page_size.nil?
9241
+ command.query['pageToken'] = page_token unless page_token.nil?
9242
+ command.query['fields'] = fields unless fields.nil?
9243
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9244
+ execute_or_queue_command(command, &block)
9245
+ end
9246
+
9247
+ # Updates a log scope.
9248
+ # @param [String] name
9249
+ # Output only. The resource name of the log scope.For example:projects/my-
9250
+ # project/locations/global/logScopes/my-log-scope
9251
+ # @param [Google::Apis::LoggingV2::LogScope] log_scope_object
9252
+ # @param [String] update_mask
9253
+ # Optional. Field mask that specifies the fields in log_scope that need an
9254
+ # update. A field will be overwritten if, and only if, it is in the update mask.
9255
+ # name and output only fields cannot be updated.For a detailed FieldMask
9256
+ # definition, see https://developers.google.com/protocol-buffers/docs/reference/
9257
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=description
9258
+ # @param [String] fields
9259
+ # Selector specifying which fields to include in a partial response.
9260
+ # @param [String] quota_user
9261
+ # Available to use for quota purposes for server-side applications. Can be any
9262
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9263
+ # @param [Google::Apis::RequestOptions] options
9264
+ # Request-specific options
9265
+ #
9266
+ # @yield [result, err] Result & error if block supplied
9267
+ # @yieldparam result [Google::Apis::LoggingV2::LogScope] parsed result object
9268
+ # @yieldparam err [StandardError] error object if request failed
9269
+ #
9270
+ # @return [Google::Apis::LoggingV2::LogScope]
9271
+ #
9272
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9273
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9274
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9275
+ def patch_project_location_log_scope(name, log_scope_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
9276
+ command = make_simple_command(:patch, 'v2/{+name}', options)
9277
+ command.request_representation = Google::Apis::LoggingV2::LogScope::Representation
9278
+ command.request_object = log_scope_object
9279
+ command.response_representation = Google::Apis::LoggingV2::LogScope::Representation
9280
+ command.response_class = Google::Apis::LoggingV2::LogScope
9281
+ command.params['name'] = name unless name.nil?
9282
+ command.query['updateMask'] = update_mask unless update_mask.nil?
9283
+ command.query['fields'] = fields unless fields.nil?
9284
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9285
+ execute_or_queue_command(command, &block)
9286
+ end
9287
+
8727
9288
  # Starts asynchronous cancellation on a long-running operation. The server makes
8728
9289
  # a best effort to cancel the operation, but success is not guaranteed. If the
8729
9290
  # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-logging_v2
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.72.0
4
+ version: 0.73.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-08-04 00:00:00.000000000 Z
11
+ date: 2024-09-15 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-logging_v2/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-logging_v2/v0.72.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-logging_v2/v0.73.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-logging_v2
63
63
  post_install_message:
64
64
  rdoc_options: []