google-apis-logging_v2 0.69.0 → 0.71.0

Sign up to get free protection for your applications and to get access to all the features.
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: []