google-apis-logging_v2 0.69.0 → 0.71.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: 0315ec62d8e34c880fa8720388054967b3b19dcfefa848a2aee1408ab4ca0c66
4
- data.tar.gz: 8d6b0882f7193ceb7d5216cc07048351017d3fa8e695f71434b1007af937fd97
3
+ metadata.gz: 5153535fc5069949d432ab2c358ea0b10e38350bba08111c31caa7085b8298ee
4
+ data.tar.gz: 05e107a62c9924927a957c0700cf5ea8f869a9680c16c1b81909bfbf78b18328
5
5
  SHA512:
6
- metadata.gz: 272990564feb2cb5ad4195606e0087a0628a6636ac680e3dfc69603788789d8819babaa17835fb5a1cdd03fde90e811c0d149f2e3e31174b358a01e489559c09
7
- data.tar.gz: d39c66c3a9c2b7ab5bb8c662b131df5e5f19dd5dbe6721ac3dd089409e208ccdca199f5148a4cfec17bbd608ca95a9e9c25532505324235f651b28eb1af2f0d4
6
+ metadata.gz: b65ed85238d6134cfdea3bbbfc474e223610457fd156547fe7ed863a03dcfa74a3ef3366febdce8a1b0f7e842dd800f16725b8042a16b746842b6d939276d0e0
7
+ data.tar.gz: 6d15440ea4f99a6855747306976b00ec1999fa0869e06b3b396c374957d6256d808f67907862d04abfd0e418f39f05381a34a36f944c45d5645ac286d01f77aa
data/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Release history for google-apis-logging_v2
2
2
 
3
+ ### v0.71.0 (2024-07-25)
4
+
5
+ * Regenerated from discovery document revision 20240705
6
+
7
+ ### v0.70.0 (2024-06-26)
8
+
9
+ * Regenerated from discovery document revision 20240620
10
+
3
11
  ### v0.69.0 (2024-05-19)
4
12
 
5
13
  * Regenerated from discovery document revision 20240503
@@ -911,12 +911,13 @@ module Google
911
911
  alias_method :cache_validated_with_origin_server?, :cache_validated_with_origin_server
912
912
 
913
913
  # The request processing latency on the server, from the time the request was
914
- # received until the response was sent.
914
+ # received until the response was sent. For WebSocket connections, this field
915
+ # refers to the entire time duration of the connection.
915
916
  # Corresponds to the JSON property `latency`
916
917
  # @return [String]
917
918
  attr_accessor :latency
918
919
 
919
- # Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2", "websocket"
920
+ # Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2"
920
921
  # Corresponds to the JSON property `protocol`
921
922
  # @return [String]
922
923
  attr_accessor :protocol
@@ -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.69.0"
19
+ GEM_VERSION = "0.71.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.15.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20240503"
25
+ REVISION = "20240705"
26
26
  end
27
27
  end
28
28
  end
@@ -1260,6 +1260,11 @@ module Google
1260
1260
  # projects/my-project/locations/us-central1Note: The location portion of the
1261
1261
  # resource must be specified, but supplying the character - in place of
1262
1262
  # LOCATION_ID will return all recent queries.
1263
+ # @param [String] filter
1264
+ # Optional. Specifies the type ("Logging" or "OpsAnalytics") of the recent
1265
+ # queries to list. The only valid value for this field is one of the two
1266
+ # allowable type function calls, which are the following: type("Logging") type("
1267
+ # OpsAnalytics")
1263
1268
  # @param [Fixnum] page_size
1264
1269
  # Optional. The maximum number of results to return from this request. Non-
1265
1270
  # positive values are ignored. The presence of nextPageToken in the response
@@ -1286,11 +1291,12 @@ module Google
1286
1291
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1287
1292
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1288
1293
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1289
- def list_billing_account_location_recent_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1294
+ def list_billing_account_location_recent_queries(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1290
1295
  command = make_simple_command(:get, 'v2/{+parent}/recentQueries', options)
1291
1296
  command.response_representation = Google::Apis::LoggingV2::ListRecentQueriesResponse::Representation
1292
1297
  command.response_class = Google::Apis::LoggingV2::ListRecentQueriesResponse
1293
1298
  command.params['parent'] = parent unless parent.nil?
1299
+ command.query['filter'] = filter unless filter.nil?
1294
1300
  command.query['pageSize'] = page_size unless page_size.nil?
1295
1301
  command.query['pageToken'] = page_token unless page_token.nil?
1296
1302
  command.query['fields'] = fields unless fields.nil?
@@ -1380,6 +1386,42 @@ module Google
1380
1386
  execute_or_queue_command(command, &block)
1381
1387
  end
1382
1388
 
1389
+ # Returns all data associated with the requested query.
1390
+ # @param [String] name
1391
+ # Required. The resource name of the saved query. "projects/[PROJECT_ID]/
1392
+ # locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[
1393
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "
1394
+ # billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[
1395
+ # QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]
1396
+ # " For example: "projects/my-project/locations/global/savedQueries/my-saved-
1397
+ # query"
1398
+ # @param [String] fields
1399
+ # Selector specifying which fields to include in a partial response.
1400
+ # @param [String] quota_user
1401
+ # Available to use for quota purposes for server-side applications. Can be any
1402
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1403
+ # @param [Google::Apis::RequestOptions] options
1404
+ # Request-specific options
1405
+ #
1406
+ # @yield [result, err] Result & error if block supplied
1407
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
1408
+ # @yieldparam err [StandardError] error object if request failed
1409
+ #
1410
+ # @return [Google::Apis::LoggingV2::SavedQuery]
1411
+ #
1412
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1413
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1414
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1415
+ def get_billing_account_location_saved_query(name, fields: nil, quota_user: nil, options: nil, &block)
1416
+ command = make_simple_command(:get, 'v2/{+name}', options)
1417
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
1418
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
1419
+ command.params['name'] = name unless name.nil?
1420
+ command.query['fields'] = fields unless fields.nil?
1421
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1422
+ execute_or_queue_command(command, &block)
1423
+ end
1424
+
1383
1425
  # Lists the SavedQueries that were created by the user making the request.
1384
1426
  # @param [String] parent
1385
1427
  # Required. The resource to which the listed queries belong. "projects/[
@@ -1390,6 +1432,16 @@ module Google
1390
1432
  # resource must be specified. To get a list of all saved queries, a wildcard
1391
1433
  # character - can be used for LOCATION_ID, for example: "projects/my-project/
1392
1434
  # locations/-"
1435
+ # @param [String] filter
1436
+ # Optional. Specifies the type ("Logging" or "OpsAnalytics") and the visibility (
1437
+ # PRIVATE or SHARED) of the saved queries to list. If provided, the filter must
1438
+ # contain either the type function or a visibility token, or both. If both are
1439
+ # chosen, they can be placed in any order, but they must be joined by the AND
1440
+ # operator or the empty character.The two supported type function calls are:
1441
+ # type("Logging") type("OpsAnalytics")The two supported visibility tokens are:
1442
+ # visibility = PRIVATE visibility = SHAREDFor example:type("Logging") AND
1443
+ # visibility = PRIVATE visibility=SHARED type("OpsAnalytics") type("OpsAnalytics)
1444
+ # " visibility = PRIVATE visibility = SHARED
1393
1445
  # @param [Fixnum] page_size
1394
1446
  # Optional. The maximum number of results to return from this request.Non-
1395
1447
  # positive values are ignored. The presence of nextPageToken in the response
@@ -1416,11 +1468,12 @@ module Google
1416
1468
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1417
1469
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1418
1470
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1419
- def list_billing_account_location_saved_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1471
+ def list_billing_account_location_saved_queries(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1420
1472
  command = make_simple_command(:get, 'v2/{+parent}/savedQueries', options)
1421
1473
  command.response_representation = Google::Apis::LoggingV2::ListSavedQueriesResponse::Representation
1422
1474
  command.response_class = Google::Apis::LoggingV2::ListSavedQueriesResponse
1423
1475
  command.params['parent'] = parent unless parent.nil?
1476
+ command.query['filter'] = filter unless filter.nil?
1424
1477
  command.query['pageSize'] = page_size unless page_size.nil?
1425
1478
  command.query['pageToken'] = page_token unless page_token.nil?
1426
1479
  command.query['fields'] = fields unless fields.nil?
@@ -1428,6 +1481,53 @@ module Google
1428
1481
  execute_or_queue_command(command, &block)
1429
1482
  end
1430
1483
 
1484
+ # Updates an existing SavedQuery.
1485
+ # @param [String] name
1486
+ # Output only. Resource name of the saved query.In the format: "projects/[
1487
+ # PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of
1488
+ # supported locations, see Supported Regions (https://cloud.google.com/logging/
1489
+ # docs/region-support#bucket-regions)After the saved query is created, the
1490
+ # location cannot be changed.If the user doesn't provide a QUERY_ID, the system
1491
+ # will generate an alphanumeric ID.
1492
+ # @param [Google::Apis::LoggingV2::SavedQuery] saved_query_object
1493
+ # @param [String] update_mask
1494
+ # Required. A non-empty list of fields to change in the existing saved query.
1495
+ # Fields are relative to the saved_query and new values for the fields are taken
1496
+ # from the corresponding fields in the SavedQuery included in this request.
1497
+ # Fields not mentioned in update_mask are not changed and are ignored in the
1498
+ # request.To update all mutable fields, specify an update_mask of *.For example,
1499
+ # to change the description and query filter text of a saved query, specify an
1500
+ # update_mask of "description, query.filter".
1501
+ # @param [String] fields
1502
+ # Selector specifying which fields to include in a partial response.
1503
+ # @param [String] quota_user
1504
+ # Available to use for quota purposes for server-side applications. Can be any
1505
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1506
+ # @param [Google::Apis::RequestOptions] options
1507
+ # Request-specific options
1508
+ #
1509
+ # @yield [result, err] Result & error if block supplied
1510
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
1511
+ # @yieldparam err [StandardError] error object if request failed
1512
+ #
1513
+ # @return [Google::Apis::LoggingV2::SavedQuery]
1514
+ #
1515
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1516
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1517
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1518
+ def patch_billing_account_location_saved_query(name, saved_query_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1519
+ command = make_simple_command(:patch, 'v2/{+name}', options)
1520
+ command.request_representation = Google::Apis::LoggingV2::SavedQuery::Representation
1521
+ command.request_object = saved_query_object
1522
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
1523
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
1524
+ command.params['name'] = name unless name.nil?
1525
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1526
+ command.query['fields'] = fields unless fields.nil?
1527
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1528
+ execute_or_queue_command(command, &block)
1529
+ end
1530
+
1431
1531
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
1432
1532
  # reappears if it receives new entries. Log entries written shortly before the
1433
1533
  # delete operation might not be deleted. Entries received after the delete
@@ -1532,11 +1632,11 @@ module Google
1532
1632
  # 123456789"
1533
1633
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1534
1634
  # @param [String] custom_writer_identity
1535
- # Optional. A service account provided by the caller that will be used to write
1536
- # the log entries. The format must be serviceAccount:some@email. This field can
1537
- # only be specified if you are routing logs to a destination outside this sink's
1538
- # project. If not specified, a Logging service account will automatically be
1539
- # generated.
1635
+ # Optional. The service account provided by the caller that will be used to
1636
+ # write the log entries. The format must be serviceAccount:some@email. This
1637
+ # field can only be specified when you are routing logs to a log bucket that is
1638
+ # in a different project than the sink. When not specified, a Logging service
1639
+ # account will automatically be generated.
1540
1640
  # @param [Boolean] unique_writer_identity
1541
1641
  # Optional. Determines the kind of IAM identity returned as writer_identity in
1542
1642
  # the new sink. If this value is omitted or set to false, and if the sink's
@@ -1711,11 +1811,11 @@ module Google
1711
1811
  # example:"projects/my-project/sinks/my-sink"
1712
1812
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1713
1813
  # @param [String] custom_writer_identity
1714
- # Optional. A service account provided by the caller that will be used to write
1715
- # the log entries. The format must be serviceAccount:some@email. This field can
1716
- # only be specified if you are routing logs to a destination outside this sink's
1717
- # project. If not specified, a Logging service account will automatically be
1718
- # generated.
1814
+ # Optional. The service account provided by the caller that will be used to
1815
+ # write the log entries. The format must be serviceAccount:some@email. This
1816
+ # field can only be specified when you are routing logs to a log bucket that is
1817
+ # in a different project than the sink. When not specified, a Logging service
1818
+ # account will automatically be generated.
1719
1819
  # @param [Boolean] unique_writer_identity
1720
1820
  # Optional. See sinks.create for a description of this field. When updating a
1721
1821
  # sink, the effect of this field on the value of writer_identity in the updated
@@ -1780,11 +1880,11 @@ module Google
1780
1880
  # example:"projects/my-project/sinks/my-sink"
1781
1881
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1782
1882
  # @param [String] custom_writer_identity
1783
- # Optional. A service account provided by the caller that will be used to write
1784
- # the log entries. The format must be serviceAccount:some@email. This field can
1785
- # only be specified if you are routing logs to a destination outside this sink's
1786
- # project. If not specified, a Logging service account will automatically be
1787
- # generated.
1883
+ # Optional. The service account provided by the caller that will be used to
1884
+ # write the log entries. The format must be serviceAccount:some@email. This
1885
+ # field can only be specified when you are routing logs to a log bucket that is
1886
+ # in a different project than the sink. When not specified, a Logging service
1887
+ # account will automatically be generated.
1788
1888
  # @param [Boolean] unique_writer_identity
1789
1889
  # Optional. See sinks.create for a description of this field. When updating a
1790
1890
  # sink, the effect of this field on the value of writer_identity in the updated
@@ -2249,7 +2349,8 @@ module Google
2249
2349
  # settings) for more information.
2250
2350
  # @param [String] name
2251
2351
  # Required. The resource name for the settings to update. "organizations/[
2252
- # ORGANIZATION_ID]/settings" For example:"organizations/12345/settings"
2352
+ # ORGANIZATION_ID]/settings" "folders/[FOLDER_ID]/settings" For example:"
2353
+ # organizations/12345/settings"
2253
2354
  # @param [Google::Apis::LoggingV2::Settings] settings_object
2254
2355
  # @param [String] update_mask
2255
2356
  # Optional. Field mask identifying which fields from settings should be updated.
@@ -3529,6 +3630,11 @@ module Google
3529
3630
  # projects/my-project/locations/us-central1Note: The location portion of the
3530
3631
  # resource must be specified, but supplying the character - in place of
3531
3632
  # LOCATION_ID will return all recent queries.
3633
+ # @param [String] filter
3634
+ # Optional. Specifies the type ("Logging" or "OpsAnalytics") of the recent
3635
+ # queries to list. The only valid value for this field is one of the two
3636
+ # allowable type function calls, which are the following: type("Logging") type("
3637
+ # OpsAnalytics")
3532
3638
  # @param [Fixnum] page_size
3533
3639
  # Optional. The maximum number of results to return from this request. Non-
3534
3640
  # positive values are ignored. The presence of nextPageToken in the response
@@ -3555,11 +3661,12 @@ module Google
3555
3661
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3556
3662
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3557
3663
  # @raise [Google::Apis::AuthorizationError] Authorization is required
3558
- def list_folder_location_recent_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3664
+ def list_folder_location_recent_queries(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3559
3665
  command = make_simple_command(:get, 'v2/{+parent}/recentQueries', options)
3560
3666
  command.response_representation = Google::Apis::LoggingV2::ListRecentQueriesResponse::Representation
3561
3667
  command.response_class = Google::Apis::LoggingV2::ListRecentQueriesResponse
3562
3668
  command.params['parent'] = parent unless parent.nil?
3669
+ command.query['filter'] = filter unless filter.nil?
3563
3670
  command.query['pageSize'] = page_size unless page_size.nil?
3564
3671
  command.query['pageToken'] = page_token unless page_token.nil?
3565
3672
  command.query['fields'] = fields unless fields.nil?
@@ -3649,6 +3756,42 @@ module Google
3649
3756
  execute_or_queue_command(command, &block)
3650
3757
  end
3651
3758
 
3759
+ # Returns all data associated with the requested query.
3760
+ # @param [String] name
3761
+ # Required. The resource name of the saved query. "projects/[PROJECT_ID]/
3762
+ # locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[
3763
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "
3764
+ # billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[
3765
+ # QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]
3766
+ # " For example: "projects/my-project/locations/global/savedQueries/my-saved-
3767
+ # query"
3768
+ # @param [String] fields
3769
+ # Selector specifying which fields to include in a partial response.
3770
+ # @param [String] quota_user
3771
+ # Available to use for quota purposes for server-side applications. Can be any
3772
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3773
+ # @param [Google::Apis::RequestOptions] options
3774
+ # Request-specific options
3775
+ #
3776
+ # @yield [result, err] Result & error if block supplied
3777
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
3778
+ # @yieldparam err [StandardError] error object if request failed
3779
+ #
3780
+ # @return [Google::Apis::LoggingV2::SavedQuery]
3781
+ #
3782
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3783
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3784
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3785
+ def get_folder_location_saved_query(name, fields: nil, quota_user: nil, options: nil, &block)
3786
+ command = make_simple_command(:get, 'v2/{+name}', options)
3787
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
3788
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
3789
+ command.params['name'] = name unless name.nil?
3790
+ command.query['fields'] = fields unless fields.nil?
3791
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3792
+ execute_or_queue_command(command, &block)
3793
+ end
3794
+
3652
3795
  # Lists the SavedQueries that were created by the user making the request.
3653
3796
  # @param [String] parent
3654
3797
  # Required. The resource to which the listed queries belong. "projects/[
@@ -3659,6 +3802,16 @@ module Google
3659
3802
  # resource must be specified. To get a list of all saved queries, a wildcard
3660
3803
  # character - can be used for LOCATION_ID, for example: "projects/my-project/
3661
3804
  # locations/-"
3805
+ # @param [String] filter
3806
+ # Optional. Specifies the type ("Logging" or "OpsAnalytics") and the visibility (
3807
+ # PRIVATE or SHARED) of the saved queries to list. If provided, the filter must
3808
+ # contain either the type function or a visibility token, or both. If both are
3809
+ # chosen, they can be placed in any order, but they must be joined by the AND
3810
+ # operator or the empty character.The two supported type function calls are:
3811
+ # type("Logging") type("OpsAnalytics")The two supported visibility tokens are:
3812
+ # visibility = PRIVATE visibility = SHAREDFor example:type("Logging") AND
3813
+ # visibility = PRIVATE visibility=SHARED type("OpsAnalytics") type("OpsAnalytics)
3814
+ # " visibility = PRIVATE visibility = SHARED
3662
3815
  # @param [Fixnum] page_size
3663
3816
  # Optional. The maximum number of results to return from this request.Non-
3664
3817
  # positive values are ignored. The presence of nextPageToken in the response
@@ -3685,11 +3838,12 @@ module Google
3685
3838
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3686
3839
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3687
3840
  # @raise [Google::Apis::AuthorizationError] Authorization is required
3688
- def list_folder_location_saved_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3841
+ def list_folder_location_saved_queries(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3689
3842
  command = make_simple_command(:get, 'v2/{+parent}/savedQueries', options)
3690
3843
  command.response_representation = Google::Apis::LoggingV2::ListSavedQueriesResponse::Representation
3691
3844
  command.response_class = Google::Apis::LoggingV2::ListSavedQueriesResponse
3692
3845
  command.params['parent'] = parent unless parent.nil?
3846
+ command.query['filter'] = filter unless filter.nil?
3693
3847
  command.query['pageSize'] = page_size unless page_size.nil?
3694
3848
  command.query['pageToken'] = page_token unless page_token.nil?
3695
3849
  command.query['fields'] = fields unless fields.nil?
@@ -3697,6 +3851,53 @@ module Google
3697
3851
  execute_or_queue_command(command, &block)
3698
3852
  end
3699
3853
 
3854
+ # Updates an existing SavedQuery.
3855
+ # @param [String] name
3856
+ # Output only. Resource name of the saved query.In the format: "projects/[
3857
+ # PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of
3858
+ # supported locations, see Supported Regions (https://cloud.google.com/logging/
3859
+ # docs/region-support#bucket-regions)After the saved query is created, the
3860
+ # location cannot be changed.If the user doesn't provide a QUERY_ID, the system
3861
+ # will generate an alphanumeric ID.
3862
+ # @param [Google::Apis::LoggingV2::SavedQuery] saved_query_object
3863
+ # @param [String] update_mask
3864
+ # Required. A non-empty list of fields to change in the existing saved query.
3865
+ # Fields are relative to the saved_query and new values for the fields are taken
3866
+ # from the corresponding fields in the SavedQuery included in this request.
3867
+ # Fields not mentioned in update_mask are not changed and are ignored in the
3868
+ # request.To update all mutable fields, specify an update_mask of *.For example,
3869
+ # to change the description and query filter text of a saved query, specify an
3870
+ # update_mask of "description, query.filter".
3871
+ # @param [String] fields
3872
+ # Selector specifying which fields to include in a partial response.
3873
+ # @param [String] quota_user
3874
+ # Available to use for quota purposes for server-side applications. Can be any
3875
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3876
+ # @param [Google::Apis::RequestOptions] options
3877
+ # Request-specific options
3878
+ #
3879
+ # @yield [result, err] Result & error if block supplied
3880
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
3881
+ # @yieldparam err [StandardError] error object if request failed
3882
+ #
3883
+ # @return [Google::Apis::LoggingV2::SavedQuery]
3884
+ #
3885
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3886
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3887
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3888
+ def patch_folder_location_saved_query(name, saved_query_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3889
+ command = make_simple_command(:patch, 'v2/{+name}', options)
3890
+ command.request_representation = Google::Apis::LoggingV2::SavedQuery::Representation
3891
+ command.request_object = saved_query_object
3892
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
3893
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
3894
+ command.params['name'] = name unless name.nil?
3895
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3896
+ command.query['fields'] = fields unless fields.nil?
3897
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3898
+ execute_or_queue_command(command, &block)
3899
+ end
3900
+
3700
3901
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
3701
3902
  # reappears if it receives new entries. Log entries written shortly before the
3702
3903
  # delete operation might not be deleted. Entries received after the delete
@@ -3801,11 +4002,11 @@ module Google
3801
4002
  # 123456789"
3802
4003
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
3803
4004
  # @param [String] custom_writer_identity
3804
- # Optional. A service account provided by the caller that will be used to write
3805
- # the log entries. The format must be serviceAccount:some@email. This field can
3806
- # only be specified if you are routing logs to a destination outside this sink's
3807
- # project. If not specified, a Logging service account will automatically be
3808
- # generated.
4005
+ # Optional. The service account provided by the caller that will be used to
4006
+ # write the log entries. The format must be serviceAccount:some@email. This
4007
+ # field can only be specified when you are routing logs to a log bucket that is
4008
+ # in a different project than the sink. When not specified, a Logging service
4009
+ # account will automatically be generated.
3809
4010
  # @param [Boolean] unique_writer_identity
3810
4011
  # Optional. Determines the kind of IAM identity returned as writer_identity in
3811
4012
  # the new sink. If this value is omitted or set to false, and if the sink's
@@ -3980,11 +4181,11 @@ module Google
3980
4181
  # example:"projects/my-project/sinks/my-sink"
3981
4182
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
3982
4183
  # @param [String] custom_writer_identity
3983
- # Optional. A service account provided by the caller that will be used to write
3984
- # the log entries. The format must be serviceAccount:some@email. This field can
3985
- # only be specified if you are routing logs to a destination outside this sink's
3986
- # project. If not specified, a Logging service account will automatically be
3987
- # generated.
4184
+ # Optional. The service account provided by the caller that will be used to
4185
+ # write the log entries. The format must be serviceAccount:some@email. This
4186
+ # field can only be specified when you are routing logs to a log bucket that is
4187
+ # in a different project than the sink. When not specified, a Logging service
4188
+ # account will automatically be generated.
3988
4189
  # @param [Boolean] unique_writer_identity
3989
4190
  # Optional. See sinks.create for a description of this field. When updating a
3990
4191
  # sink, the effect of this field on the value of writer_identity in the updated
@@ -4049,11 +4250,11 @@ module Google
4049
4250
  # example:"projects/my-project/sinks/my-sink"
4050
4251
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4051
4252
  # @param [String] custom_writer_identity
4052
- # Optional. A service account provided by the caller that will be used to write
4053
- # the log entries. The format must be serviceAccount:some@email. This field can
4054
- # only be specified if you are routing logs to a destination outside this sink's
4055
- # project. If not specified, a Logging service account will automatically be
4056
- # generated.
4253
+ # Optional. The service account provided by the caller that will be used to
4254
+ # write the log entries. The format must be serviceAccount:some@email. This
4255
+ # field can only be specified when you are routing logs to a log bucket that is
4256
+ # in a different project than the sink. When not specified, a Logging service
4257
+ # account will automatically be generated.
4057
4258
  # @param [Boolean] unique_writer_identity
4058
4259
  # Optional. See sinks.create for a description of this field. When updating a
4059
4260
  # sink, the effect of this field on the value of writer_identity in the updated
@@ -5364,7 +5565,8 @@ module Google
5364
5565
  # settings) for more information.
5365
5566
  # @param [String] name
5366
5567
  # Required. The resource name for the settings to update. "organizations/[
5367
- # ORGANIZATION_ID]/settings" For example:"organizations/12345/settings"
5568
+ # ORGANIZATION_ID]/settings" "folders/[FOLDER_ID]/settings" For example:"
5569
+ # organizations/12345/settings"
5368
5570
  # @param [Google::Apis::LoggingV2::Settings] settings_object
5369
5571
  # @param [String] update_mask
5370
5572
  # Optional. Field mask identifying which fields from settings should be updated.
@@ -6644,6 +6846,11 @@ module Google
6644
6846
  # projects/my-project/locations/us-central1Note: The location portion of the
6645
6847
  # resource must be specified, but supplying the character - in place of
6646
6848
  # LOCATION_ID will return all recent queries.
6849
+ # @param [String] filter
6850
+ # Optional. Specifies the type ("Logging" or "OpsAnalytics") of the recent
6851
+ # queries to list. The only valid value for this field is one of the two
6852
+ # allowable type function calls, which are the following: type("Logging") type("
6853
+ # OpsAnalytics")
6647
6854
  # @param [Fixnum] page_size
6648
6855
  # Optional. The maximum number of results to return from this request. Non-
6649
6856
  # positive values are ignored. The presence of nextPageToken in the response
@@ -6670,11 +6877,12 @@ module Google
6670
6877
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6671
6878
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6672
6879
  # @raise [Google::Apis::AuthorizationError] Authorization is required
6673
- def list_organization_location_recent_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
6880
+ def list_organization_location_recent_queries(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
6674
6881
  command = make_simple_command(:get, 'v2/{+parent}/recentQueries', options)
6675
6882
  command.response_representation = Google::Apis::LoggingV2::ListRecentQueriesResponse::Representation
6676
6883
  command.response_class = Google::Apis::LoggingV2::ListRecentQueriesResponse
6677
6884
  command.params['parent'] = parent unless parent.nil?
6885
+ command.query['filter'] = filter unless filter.nil?
6678
6886
  command.query['pageSize'] = page_size unless page_size.nil?
6679
6887
  command.query['pageToken'] = page_token unless page_token.nil?
6680
6888
  command.query['fields'] = fields unless fields.nil?
@@ -6764,6 +6972,42 @@ module Google
6764
6972
  execute_or_queue_command(command, &block)
6765
6973
  end
6766
6974
 
6975
+ # Returns all data associated with the requested query.
6976
+ # @param [String] name
6977
+ # Required. The resource name of the saved query. "projects/[PROJECT_ID]/
6978
+ # locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[
6979
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "
6980
+ # billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[
6981
+ # QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]
6982
+ # " For example: "projects/my-project/locations/global/savedQueries/my-saved-
6983
+ # query"
6984
+ # @param [String] fields
6985
+ # Selector specifying which fields to include in a partial response.
6986
+ # @param [String] quota_user
6987
+ # Available to use for quota purposes for server-side applications. Can be any
6988
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6989
+ # @param [Google::Apis::RequestOptions] options
6990
+ # Request-specific options
6991
+ #
6992
+ # @yield [result, err] Result & error if block supplied
6993
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
6994
+ # @yieldparam err [StandardError] error object if request failed
6995
+ #
6996
+ # @return [Google::Apis::LoggingV2::SavedQuery]
6997
+ #
6998
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6999
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7000
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7001
+ def get_organization_location_saved_query(name, fields: nil, quota_user: nil, options: nil, &block)
7002
+ command = make_simple_command(:get, 'v2/{+name}', options)
7003
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
7004
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
7005
+ command.params['name'] = name unless name.nil?
7006
+ command.query['fields'] = fields unless fields.nil?
7007
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7008
+ execute_or_queue_command(command, &block)
7009
+ end
7010
+
6767
7011
  # Lists the SavedQueries that were created by the user making the request.
6768
7012
  # @param [String] parent
6769
7013
  # Required. The resource to which the listed queries belong. "projects/[
@@ -6774,6 +7018,16 @@ module Google
6774
7018
  # resource must be specified. To get a list of all saved queries, a wildcard
6775
7019
  # character - can be used for LOCATION_ID, for example: "projects/my-project/
6776
7020
  # locations/-"
7021
+ # @param [String] filter
7022
+ # Optional. Specifies the type ("Logging" or "OpsAnalytics") and the visibility (
7023
+ # PRIVATE or SHARED) of the saved queries to list. If provided, the filter must
7024
+ # contain either the type function or a visibility token, or both. If both are
7025
+ # chosen, they can be placed in any order, but they must be joined by the AND
7026
+ # operator or the empty character.The two supported type function calls are:
7027
+ # type("Logging") type("OpsAnalytics")The two supported visibility tokens are:
7028
+ # visibility = PRIVATE visibility = SHAREDFor example:type("Logging") AND
7029
+ # visibility = PRIVATE visibility=SHARED type("OpsAnalytics") type("OpsAnalytics)
7030
+ # " visibility = PRIVATE visibility = SHARED
6777
7031
  # @param [Fixnum] page_size
6778
7032
  # Optional. The maximum number of results to return from this request.Non-
6779
7033
  # positive values are ignored. The presence of nextPageToken in the response
@@ -6800,11 +7054,12 @@ module Google
6800
7054
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6801
7055
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6802
7056
  # @raise [Google::Apis::AuthorizationError] Authorization is required
6803
- def list_organization_location_saved_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
7057
+ def list_organization_location_saved_queries(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
6804
7058
  command = make_simple_command(:get, 'v2/{+parent}/savedQueries', options)
6805
7059
  command.response_representation = Google::Apis::LoggingV2::ListSavedQueriesResponse::Representation
6806
7060
  command.response_class = Google::Apis::LoggingV2::ListSavedQueriesResponse
6807
7061
  command.params['parent'] = parent unless parent.nil?
7062
+ command.query['filter'] = filter unless filter.nil?
6808
7063
  command.query['pageSize'] = page_size unless page_size.nil?
6809
7064
  command.query['pageToken'] = page_token unless page_token.nil?
6810
7065
  command.query['fields'] = fields unless fields.nil?
@@ -6812,6 +7067,53 @@ module Google
6812
7067
  execute_or_queue_command(command, &block)
6813
7068
  end
6814
7069
 
7070
+ # Updates an existing SavedQuery.
7071
+ # @param [String] name
7072
+ # Output only. Resource name of the saved query.In the format: "projects/[
7073
+ # PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of
7074
+ # supported locations, see Supported Regions (https://cloud.google.com/logging/
7075
+ # docs/region-support#bucket-regions)After the saved query is created, the
7076
+ # location cannot be changed.If the user doesn't provide a QUERY_ID, the system
7077
+ # will generate an alphanumeric ID.
7078
+ # @param [Google::Apis::LoggingV2::SavedQuery] saved_query_object
7079
+ # @param [String] update_mask
7080
+ # Required. A non-empty list of fields to change in the existing saved query.
7081
+ # Fields are relative to the saved_query and new values for the fields are taken
7082
+ # from the corresponding fields in the SavedQuery included in this request.
7083
+ # Fields not mentioned in update_mask are not changed and are ignored in the
7084
+ # request.To update all mutable fields, specify an update_mask of *.For example,
7085
+ # to change the description and query filter text of a saved query, specify an
7086
+ # update_mask of "description, query.filter".
7087
+ # @param [String] fields
7088
+ # Selector specifying which fields to include in a partial response.
7089
+ # @param [String] quota_user
7090
+ # Available to use for quota purposes for server-side applications. Can be any
7091
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7092
+ # @param [Google::Apis::RequestOptions] options
7093
+ # Request-specific options
7094
+ #
7095
+ # @yield [result, err] Result & error if block supplied
7096
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
7097
+ # @yieldparam err [StandardError] error object if request failed
7098
+ #
7099
+ # @return [Google::Apis::LoggingV2::SavedQuery]
7100
+ #
7101
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7102
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7103
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7104
+ def patch_organization_location_saved_query(name, saved_query_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
7105
+ command = make_simple_command(:patch, 'v2/{+name}', options)
7106
+ command.request_representation = Google::Apis::LoggingV2::SavedQuery::Representation
7107
+ command.request_object = saved_query_object
7108
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
7109
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
7110
+ command.params['name'] = name unless name.nil?
7111
+ command.query['updateMask'] = update_mask unless update_mask.nil?
7112
+ command.query['fields'] = fields unless fields.nil?
7113
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7114
+ execute_or_queue_command(command, &block)
7115
+ end
7116
+
6815
7117
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
6816
7118
  # reappears if it receives new entries. Log entries written shortly before the
6817
7119
  # delete operation might not be deleted. Entries received after the delete
@@ -6916,11 +7218,11 @@ module Google
6916
7218
  # 123456789"
6917
7219
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
6918
7220
  # @param [String] custom_writer_identity
6919
- # Optional. A service account provided by the caller that will be used to write
6920
- # the log entries. The format must be serviceAccount:some@email. This field can
6921
- # only be specified if you are routing logs to a destination outside this sink's
6922
- # project. If not specified, a Logging service account will automatically be
6923
- # generated.
7221
+ # Optional. The service account provided by the caller that will be used to
7222
+ # write the log entries. The format must be serviceAccount:some@email. This
7223
+ # field can only be specified when you are routing logs to a log bucket that is
7224
+ # in a different project than the sink. When not specified, a Logging service
7225
+ # account will automatically be generated.
6924
7226
  # @param [Boolean] unique_writer_identity
6925
7227
  # Optional. Determines the kind of IAM identity returned as writer_identity in
6926
7228
  # the new sink. If this value is omitted or set to false, and if the sink's
@@ -7095,11 +7397,11 @@ module Google
7095
7397
  # example:"projects/my-project/sinks/my-sink"
7096
7398
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
7097
7399
  # @param [String] custom_writer_identity
7098
- # Optional. A service account provided by the caller that will be used to write
7099
- # the log entries. The format must be serviceAccount:some@email. This field can
7100
- # only be specified if you are routing logs to a destination outside this sink's
7101
- # project. If not specified, a Logging service account will automatically be
7102
- # generated.
7400
+ # Optional. The service account provided by the caller that will be used to
7401
+ # write the log entries. The format must be serviceAccount:some@email. This
7402
+ # field can only be specified when you are routing logs to a log bucket that is
7403
+ # in a different project than the sink. When not specified, a Logging service
7404
+ # account will automatically be generated.
7103
7405
  # @param [Boolean] unique_writer_identity
7104
7406
  # Optional. See sinks.create for a description of this field. When updating a
7105
7407
  # sink, the effect of this field on the value of writer_identity in the updated
@@ -7164,11 +7466,11 @@ module Google
7164
7466
  # example:"projects/my-project/sinks/my-sink"
7165
7467
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
7166
7468
  # @param [String] custom_writer_identity
7167
- # Optional. A service account provided by the caller that will be used to write
7168
- # the log entries. The format must be serviceAccount:some@email. This field can
7169
- # only be specified if you are routing logs to a destination outside this sink's
7170
- # project. If not specified, a Logging service account will automatically be
7171
- # generated.
7469
+ # Optional. The service account provided by the caller that will be used to
7470
+ # write the log entries. The format must be serviceAccount:some@email. This
7471
+ # field can only be specified when you are routing logs to a log bucket that is
7472
+ # in a different project than the sink. When not specified, a Logging service
7473
+ # account will automatically be generated.
7172
7474
  # @param [Boolean] unique_writer_identity
7173
7475
  # Optional. See sinks.create for a description of this field. When updating a
7174
7476
  # sink, the effect of this field on the value of writer_identity in the updated
@@ -8542,6 +8844,11 @@ module Google
8542
8844
  # projects/my-project/locations/us-central1Note: The location portion of the
8543
8845
  # resource must be specified, but supplying the character - in place of
8544
8846
  # LOCATION_ID will return all recent queries.
8847
+ # @param [String] filter
8848
+ # Optional. Specifies the type ("Logging" or "OpsAnalytics") of the recent
8849
+ # queries to list. The only valid value for this field is one of the two
8850
+ # allowable type function calls, which are the following: type("Logging") type("
8851
+ # OpsAnalytics")
8545
8852
  # @param [Fixnum] page_size
8546
8853
  # Optional. The maximum number of results to return from this request. Non-
8547
8854
  # positive values are ignored. The presence of nextPageToken in the response
@@ -8568,11 +8875,12 @@ module Google
8568
8875
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8569
8876
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8570
8877
  # @raise [Google::Apis::AuthorizationError] Authorization is required
8571
- def list_project_location_recent_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
8878
+ def list_project_location_recent_queries(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
8572
8879
  command = make_simple_command(:get, 'v2/{+parent}/recentQueries', options)
8573
8880
  command.response_representation = Google::Apis::LoggingV2::ListRecentQueriesResponse::Representation
8574
8881
  command.response_class = Google::Apis::LoggingV2::ListRecentQueriesResponse
8575
8882
  command.params['parent'] = parent unless parent.nil?
8883
+ command.query['filter'] = filter unless filter.nil?
8576
8884
  command.query['pageSize'] = page_size unless page_size.nil?
8577
8885
  command.query['pageToken'] = page_token unless page_token.nil?
8578
8886
  command.query['fields'] = fields unless fields.nil?
@@ -8662,6 +8970,42 @@ module Google
8662
8970
  execute_or_queue_command(command, &block)
8663
8971
  end
8664
8972
 
8973
+ # Returns all data associated with the requested query.
8974
+ # @param [String] name
8975
+ # Required. The resource name of the saved query. "projects/[PROJECT_ID]/
8976
+ # locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[
8977
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "
8978
+ # billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[
8979
+ # QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]
8980
+ # " For example: "projects/my-project/locations/global/savedQueries/my-saved-
8981
+ # query"
8982
+ # @param [String] fields
8983
+ # Selector specifying which fields to include in a partial response.
8984
+ # @param [String] quota_user
8985
+ # Available to use for quota purposes for server-side applications. Can be any
8986
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8987
+ # @param [Google::Apis::RequestOptions] options
8988
+ # Request-specific options
8989
+ #
8990
+ # @yield [result, err] Result & error if block supplied
8991
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
8992
+ # @yieldparam err [StandardError] error object if request failed
8993
+ #
8994
+ # @return [Google::Apis::LoggingV2::SavedQuery]
8995
+ #
8996
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8997
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8998
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8999
+ def get_project_location_saved_query(name, fields: nil, quota_user: nil, options: nil, &block)
9000
+ command = make_simple_command(:get, 'v2/{+name}', options)
9001
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
9002
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
9003
+ command.params['name'] = name unless name.nil?
9004
+ command.query['fields'] = fields unless fields.nil?
9005
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9006
+ execute_or_queue_command(command, &block)
9007
+ end
9008
+
8665
9009
  # Lists the SavedQueries that were created by the user making the request.
8666
9010
  # @param [String] parent
8667
9011
  # Required. The resource to which the listed queries belong. "projects/[
@@ -8672,6 +9016,16 @@ module Google
8672
9016
  # resource must be specified. To get a list of all saved queries, a wildcard
8673
9017
  # character - can be used for LOCATION_ID, for example: "projects/my-project/
8674
9018
  # locations/-"
9019
+ # @param [String] filter
9020
+ # Optional. Specifies the type ("Logging" or "OpsAnalytics") and the visibility (
9021
+ # PRIVATE or SHARED) of the saved queries to list. If provided, the filter must
9022
+ # contain either the type function or a visibility token, or both. If both are
9023
+ # chosen, they can be placed in any order, but they must be joined by the AND
9024
+ # operator or the empty character.The two supported type function calls are:
9025
+ # type("Logging") type("OpsAnalytics")The two supported visibility tokens are:
9026
+ # visibility = PRIVATE visibility = SHAREDFor example:type("Logging") AND
9027
+ # visibility = PRIVATE visibility=SHARED type("OpsAnalytics") type("OpsAnalytics)
9028
+ # " visibility = PRIVATE visibility = SHARED
8675
9029
  # @param [Fixnum] page_size
8676
9030
  # Optional. The maximum number of results to return from this request.Non-
8677
9031
  # positive values are ignored. The presence of nextPageToken in the response
@@ -8698,11 +9052,12 @@ module Google
8698
9052
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8699
9053
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8700
9054
  # @raise [Google::Apis::AuthorizationError] Authorization is required
8701
- def list_project_location_saved_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
9055
+ def list_project_location_saved_queries(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
8702
9056
  command = make_simple_command(:get, 'v2/{+parent}/savedQueries', options)
8703
9057
  command.response_representation = Google::Apis::LoggingV2::ListSavedQueriesResponse::Representation
8704
9058
  command.response_class = Google::Apis::LoggingV2::ListSavedQueriesResponse
8705
9059
  command.params['parent'] = parent unless parent.nil?
9060
+ command.query['filter'] = filter unless filter.nil?
8706
9061
  command.query['pageSize'] = page_size unless page_size.nil?
8707
9062
  command.query['pageToken'] = page_token unless page_token.nil?
8708
9063
  command.query['fields'] = fields unless fields.nil?
@@ -8710,6 +9065,53 @@ module Google
8710
9065
  execute_or_queue_command(command, &block)
8711
9066
  end
8712
9067
 
9068
+ # Updates an existing SavedQuery.
9069
+ # @param [String] name
9070
+ # Output only. Resource name of the saved query.In the format: "projects/[
9071
+ # PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of
9072
+ # supported locations, see Supported Regions (https://cloud.google.com/logging/
9073
+ # docs/region-support#bucket-regions)After the saved query is created, the
9074
+ # location cannot be changed.If the user doesn't provide a QUERY_ID, the system
9075
+ # will generate an alphanumeric ID.
9076
+ # @param [Google::Apis::LoggingV2::SavedQuery] saved_query_object
9077
+ # @param [String] update_mask
9078
+ # Required. A non-empty list of fields to change in the existing saved query.
9079
+ # Fields are relative to the saved_query and new values for the fields are taken
9080
+ # from the corresponding fields in the SavedQuery included in this request.
9081
+ # Fields not mentioned in update_mask are not changed and are ignored in the
9082
+ # request.To update all mutable fields, specify an update_mask of *.For example,
9083
+ # to change the description and query filter text of a saved query, specify an
9084
+ # update_mask of "description, query.filter".
9085
+ # @param [String] fields
9086
+ # Selector specifying which fields to include in a partial response.
9087
+ # @param [String] quota_user
9088
+ # Available to use for quota purposes for server-side applications. Can be any
9089
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9090
+ # @param [Google::Apis::RequestOptions] options
9091
+ # Request-specific options
9092
+ #
9093
+ # @yield [result, err] Result & error if block supplied
9094
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
9095
+ # @yieldparam err [StandardError] error object if request failed
9096
+ #
9097
+ # @return [Google::Apis::LoggingV2::SavedQuery]
9098
+ #
9099
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9100
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9101
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9102
+ def patch_project_location_saved_query(name, saved_query_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
9103
+ command = make_simple_command(:patch, 'v2/{+name}', options)
9104
+ command.request_representation = Google::Apis::LoggingV2::SavedQuery::Representation
9105
+ command.request_object = saved_query_object
9106
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
9107
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
9108
+ command.params['name'] = name unless name.nil?
9109
+ command.query['updateMask'] = update_mask unless update_mask.nil?
9110
+ command.query['fields'] = fields unless fields.nil?
9111
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9112
+ execute_or_queue_command(command, &block)
9113
+ end
9114
+
8713
9115
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
8714
9116
  # reappears if it receives new entries. Log entries written shortly before the
8715
9117
  # delete operation might not be deleted. Entries received after the delete
@@ -8988,11 +9390,11 @@ module Google
8988
9390
  # 123456789"
8989
9391
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
8990
9392
  # @param [String] custom_writer_identity
8991
- # Optional. A service account provided by the caller that will be used to write
8992
- # the log entries. The format must be serviceAccount:some@email. This field can
8993
- # only be specified if you are routing logs to a destination outside this sink's
8994
- # project. If not specified, a Logging service account will automatically be
8995
- # generated.
9393
+ # Optional. The service account provided by the caller that will be used to
9394
+ # write the log entries. The format must be serviceAccount:some@email. This
9395
+ # field can only be specified when you are routing logs to a log bucket that is
9396
+ # in a different project than the sink. When not specified, a Logging service
9397
+ # account will automatically be generated.
8996
9398
  # @param [Boolean] unique_writer_identity
8997
9399
  # Optional. Determines the kind of IAM identity returned as writer_identity in
8998
9400
  # the new sink. If this value is omitted or set to false, and if the sink's
@@ -9167,11 +9569,11 @@ module Google
9167
9569
  # example:"projects/my-project/sinks/my-sink"
9168
9570
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
9169
9571
  # @param [String] custom_writer_identity
9170
- # Optional. A service account provided by the caller that will be used to write
9171
- # the log entries. The format must be serviceAccount:some@email. This field can
9172
- # only be specified if you are routing logs to a destination outside this sink's
9173
- # project. If not specified, a Logging service account will automatically be
9174
- # generated.
9572
+ # Optional. The service account provided by the caller that will be used to
9573
+ # write the log entries. The format must be serviceAccount:some@email. This
9574
+ # field can only be specified when you are routing logs to a log bucket that is
9575
+ # in a different project than the sink. When not specified, a Logging service
9576
+ # account will automatically be generated.
9175
9577
  # @param [Boolean] unique_writer_identity
9176
9578
  # Optional. See sinks.create for a description of this field. When updating a
9177
9579
  # sink, the effect of this field on the value of writer_identity in the updated
@@ -9236,11 +9638,11 @@ module Google
9236
9638
  # example:"projects/my-project/sinks/my-sink"
9237
9639
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
9238
9640
  # @param [String] custom_writer_identity
9239
- # Optional. A service account provided by the caller that will be used to write
9240
- # the log entries. The format must be serviceAccount:some@email. This field can
9241
- # only be specified if you are routing logs to a destination outside this sink's
9242
- # project. If not specified, a Logging service account will automatically be
9243
- # generated.
9641
+ # Optional. The service account provided by the caller that will be used to
9642
+ # write the log entries. The format must be serviceAccount:some@email. This
9643
+ # field can only be specified when you are routing logs to a log bucket that is
9644
+ # in a different project than the sink. When not specified, a Logging service
9645
+ # account will automatically be generated.
9244
9646
  # @param [Boolean] unique_writer_identity
9245
9647
  # Optional. See sinks.create for a description of this field. When updating a
9246
9648
  # sink, the effect of this field on the value of writer_identity in the updated
@@ -9304,11 +9706,11 @@ module Google
9304
9706
  # 123456789"
9305
9707
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
9306
9708
  # @param [String] custom_writer_identity
9307
- # Optional. A service account provided by the caller that will be used to write
9308
- # the log entries. The format must be serviceAccount:some@email. This field can
9309
- # only be specified if you are routing logs to a destination outside this sink's
9310
- # project. If not specified, a Logging service account will automatically be
9311
- # generated.
9709
+ # Optional. The service account provided by the caller that will be used to
9710
+ # write the log entries. The format must be serviceAccount:some@email. This
9711
+ # field can only be specified when you are routing logs to a log bucket that is
9712
+ # in a different project than the sink. When not specified, a Logging service
9713
+ # account will automatically be generated.
9312
9714
  # @param [Boolean] unique_writer_identity
9313
9715
  # Optional. Determines the kind of IAM identity returned as writer_identity in
9314
9716
  # the new sink. If this value is omitted or set to false, and if the sink's
@@ -9483,11 +9885,11 @@ module Google
9483
9885
  # example:"projects/my-project/sinks/my-sink"
9484
9886
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
9485
9887
  # @param [String] custom_writer_identity
9486
- # Optional. A service account provided by the caller that will be used to write
9487
- # the log entries. The format must be serviceAccount:some@email. This field can
9488
- # only be specified if you are routing logs to a destination outside this sink's
9489
- # project. If not specified, a Logging service account will automatically be
9490
- # generated.
9888
+ # Optional. The service account provided by the caller that will be used to
9889
+ # write the log entries. The format must be serviceAccount:some@email. This
9890
+ # field can only be specified when you are routing logs to a log bucket that is
9891
+ # in a different project than the sink. When not specified, a Logging service
9892
+ # account will automatically be generated.
9491
9893
  # @param [Boolean] unique_writer_identity
9492
9894
  # Optional. See sinks.create for a description of this field. When updating a
9493
9895
  # sink, the effect of this field on the value of writer_identity in the updated
@@ -9682,7 +10084,8 @@ module Google
9682
10084
  # settings) for more information.
9683
10085
  # @param [String] name
9684
10086
  # Required. The resource name for the settings to update. "organizations/[
9685
- # ORGANIZATION_ID]/settings" For example:"organizations/12345/settings"
10087
+ # ORGANIZATION_ID]/settings" "folders/[FOLDER_ID]/settings" For example:"
10088
+ # organizations/12345/settings"
9686
10089
  # @param [Google::Apis::LoggingV2::Settings] settings_object
9687
10090
  # @param [String] update_mask
9688
10091
  # Optional. Field mask identifying which fields from settings should be updated.
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.69.0
4
+ version: 0.71.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-05-26 00:00:00.000000000 Z
11
+ date: 2024-07-25 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.69.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-logging_v2/v0.71.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: []