google-apis-logging_v2 0.57.0 → 0.59.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.
@@ -50,8 +50,8 @@ module Google
50
50
  end
51
51
 
52
52
  # Gets the Logging CMEK settings for the given resource.Note: CMEK for the Log
53
- # Router can be configured for Google Cloud projects, folders, organizations and
54
- # billing accounts. Once configured for an organization, it applies to all
53
+ # Router can be configured for Google Cloud projects, folders, organizations,
54
+ # and billing accounts. Once configured for an organization, it applies to all
55
55
  # projects and folders in the Google Cloud organization.See Enabling CMEK for
56
56
  # Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption)
57
57
  # for more information.
@@ -60,7 +60,7 @@ module Google
60
60
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
61
61
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
62
62
  # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
63
- # Log Router can be configured for Google Cloud projects, folders, organizations
63
+ # Log Router can be configured for Google Cloud projects, folders, organizations,
64
64
  # and billing accounts. Once configured for an organization, it applies to all
65
65
  # projects and folders in the Google Cloud organization.
66
66
  # @param [String] fields
@@ -90,21 +90,16 @@ module Google
90
90
  execute_or_queue_command(command, &block)
91
91
  end
92
92
 
93
- # Gets the Log Router settings for the given resource.Note: Settings for the Log
94
- # Router can be get for Google Cloud projects, folders, organizations and
95
- # billing accounts. Currently it can only be configured for organizations. Once
96
- # configured for an organization, it applies to all projects and folders in the
97
- # Google Cloud organization.See Enabling CMEK for Log Router (https://cloud.
98
- # google.com/logging/docs/routing/managed-encryption) for more information.
93
+ # Gets the settings for the given resource.Note: Settings can be retrieved for
94
+ # Google Cloud projects, folders, organizations, and billing accounts.See View
95
+ # default resource settings for Logging (https://cloud.google.com/logging/docs/
96
+ # default-settings#view-org-settings) for more information.
99
97
  # @param [String] name
100
98
  # Required. The resource for which to retrieve settings. "projects/[PROJECT_ID]/
101
99
  # settings" "organizations/[ORGANIZATION_ID]/settings" "billingAccounts/[
102
100
  # BILLING_ACCOUNT_ID]/settings" "folders/[FOLDER_ID]/settings" For example:"
103
- # organizations/12345/settings"Note: Settings for the Log Router can be get for
104
- # Google Cloud projects, folders, organizations and billing accounts. Currently
105
- # it can only be configured for organizations. Once configured for an
106
- # organization, it applies to all projects and folders in the Google Cloud
107
- # organization.
101
+ # organizations/12345/settings"Note: Settings can be retrieved for Google Cloud
102
+ # projects, folders, organizations, and billing accounts.
108
103
  # @param [String] fields
109
104
  # Selector specifying which fields to include in a partial response.
110
105
  # @param [String] quota_user
@@ -1251,6 +1246,183 @@ module Google
1251
1246
  execute_or_queue_command(command, &block)
1252
1247
  end
1253
1248
 
1249
+ # Lists the RecentQueries that were created by the user making the request.
1250
+ # @param [String] parent
1251
+ # Required. The resource to which the listed queries belong. "projects/[
1252
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
1253
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
1254
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example:
1255
+ # projects/my-project/locations/us-central1Note: The location portion of the
1256
+ # resource must be specified, but supplying the character - in place of
1257
+ # LOCATION_ID will return all recent queries.
1258
+ # @param [Fixnum] page_size
1259
+ # Optional. The maximum number of results to return from this request. Non-
1260
+ # positive values are ignored. The presence of nextPageToken in the response
1261
+ # indicates that more results might be available.
1262
+ # @param [String] page_token
1263
+ # Optional. If present, then retrieve the next batch of results from the
1264
+ # preceding call to this method. pageToken must be the value of nextPageToken
1265
+ # from the previous response. The values of other method parameters should be
1266
+ # identical to those in the previous call.
1267
+ # @param [String] fields
1268
+ # Selector specifying which fields to include in a partial response.
1269
+ # @param [String] quota_user
1270
+ # Available to use for quota purposes for server-side applications. Can be any
1271
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1272
+ # @param [Google::Apis::RequestOptions] options
1273
+ # Request-specific options
1274
+ #
1275
+ # @yield [result, err] Result & error if block supplied
1276
+ # @yieldparam result [Google::Apis::LoggingV2::ListRecentQueriesResponse] parsed result object
1277
+ # @yieldparam err [StandardError] error object if request failed
1278
+ #
1279
+ # @return [Google::Apis::LoggingV2::ListRecentQueriesResponse]
1280
+ #
1281
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1282
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1283
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1284
+ def list_billing_account_location_recent_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1285
+ command = make_simple_command(:get, 'v2/{+parent}/recentQueries', options)
1286
+ command.response_representation = Google::Apis::LoggingV2::ListRecentQueriesResponse::Representation
1287
+ command.response_class = Google::Apis::LoggingV2::ListRecentQueriesResponse
1288
+ command.params['parent'] = parent unless parent.nil?
1289
+ command.query['pageSize'] = page_size unless page_size.nil?
1290
+ command.query['pageToken'] = page_token unless page_token.nil?
1291
+ command.query['fields'] = fields unless fields.nil?
1292
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1293
+ execute_or_queue_command(command, &block)
1294
+ end
1295
+
1296
+ # Creates a new SavedQuery for the user making the request.
1297
+ # @param [String] parent
1298
+ # Required. The parent resource in which to create the saved query: "projects/[
1299
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
1300
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
1301
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: "
1302
+ # projects/my-project/locations/global" "organizations/123456789/locations/us-
1303
+ # central1"
1304
+ # @param [Google::Apis::LoggingV2::SavedQuery] saved_query_object
1305
+ # @param [String] saved_query_id
1306
+ # Optional. The ID to use for the saved query, which will become the final
1307
+ # component of the saved query's resource name.If the saved_query_id is not
1308
+ # provided, the system will generate an alphanumeric ID.The saved_query_id is
1309
+ # limited to 100 characters and can include only the following characters: upper
1310
+ # and lower-case alphanumeric characters, underscores, hyphens, and periods.
1311
+ # First character has to be alphanumeric.
1312
+ # @param [String] fields
1313
+ # Selector specifying which fields to include in a partial response.
1314
+ # @param [String] quota_user
1315
+ # Available to use for quota purposes for server-side applications. Can be any
1316
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1317
+ # @param [Google::Apis::RequestOptions] options
1318
+ # Request-specific options
1319
+ #
1320
+ # @yield [result, err] Result & error if block supplied
1321
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
1322
+ # @yieldparam err [StandardError] error object if request failed
1323
+ #
1324
+ # @return [Google::Apis::LoggingV2::SavedQuery]
1325
+ #
1326
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1327
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1328
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1329
+ def create_billing_account_location_saved_query(parent, saved_query_object = nil, saved_query_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1330
+ command = make_simple_command(:post, 'v2/{+parent}/savedQueries', options)
1331
+ command.request_representation = Google::Apis::LoggingV2::SavedQuery::Representation
1332
+ command.request_object = saved_query_object
1333
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
1334
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
1335
+ command.params['parent'] = parent unless parent.nil?
1336
+ command.query['savedQueryId'] = saved_query_id unless saved_query_id.nil?
1337
+ command.query['fields'] = fields unless fields.nil?
1338
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1339
+ execute_or_queue_command(command, &block)
1340
+ end
1341
+
1342
+ # Deletes an existing SavedQuery that was created by the user making the request.
1343
+ # @param [String] name
1344
+ # Required. The full resource name of the saved query to delete. "projects/[
1345
+ # PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[
1346
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "
1347
+ # billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[
1348
+ # QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]
1349
+ # " For example: "projects/my-project/locations/global/savedQueries/my-saved-
1350
+ # query"
1351
+ # @param [String] fields
1352
+ # Selector specifying which fields to include in a partial response.
1353
+ # @param [String] quota_user
1354
+ # Available to use for quota purposes for server-side applications. Can be any
1355
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1356
+ # @param [Google::Apis::RequestOptions] options
1357
+ # Request-specific options
1358
+ #
1359
+ # @yield [result, err] Result & error if block supplied
1360
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
1361
+ # @yieldparam err [StandardError] error object if request failed
1362
+ #
1363
+ # @return [Google::Apis::LoggingV2::Empty]
1364
+ #
1365
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1366
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1367
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1368
+ def delete_billing_account_location_saved_query(name, fields: nil, quota_user: nil, options: nil, &block)
1369
+ command = make_simple_command(:delete, 'v2/{+name}', options)
1370
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
1371
+ command.response_class = Google::Apis::LoggingV2::Empty
1372
+ command.params['name'] = name unless name.nil?
1373
+ command.query['fields'] = fields unless fields.nil?
1374
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1375
+ execute_or_queue_command(command, &block)
1376
+ end
1377
+
1378
+ # Lists the SavedQueries that were created by the user making the request.
1379
+ # @param [String] parent
1380
+ # Required. The resource to which the listed queries belong. "projects/[
1381
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
1382
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
1383
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: "
1384
+ # projects/my-project/locations/us-central1" Note: The locations portion of the
1385
+ # resource must be specified. To get a list of all saved queries, a wildcard
1386
+ # character - can be used for LOCATION_ID, for example: "projects/my-project/
1387
+ # locations/-"
1388
+ # @param [Fixnum] page_size
1389
+ # Optional. The maximum number of results to return from this request.Non-
1390
+ # positive values are ignored. The presence of nextPageToken in the response
1391
+ # indicates that more results might be available.
1392
+ # @param [String] page_token
1393
+ # Optional. If present, then retrieve the next batch of results from the
1394
+ # preceding call to this method. pageToken must be the value of nextPageToken
1395
+ # from the previous response. The values of other method parameters should be
1396
+ # identical to those in the previous call.
1397
+ # @param [String] fields
1398
+ # Selector specifying which fields to include in a partial response.
1399
+ # @param [String] quota_user
1400
+ # Available to use for quota purposes for server-side applications. Can be any
1401
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1402
+ # @param [Google::Apis::RequestOptions] options
1403
+ # Request-specific options
1404
+ #
1405
+ # @yield [result, err] Result & error if block supplied
1406
+ # @yieldparam result [Google::Apis::LoggingV2::ListSavedQueriesResponse] parsed result object
1407
+ # @yieldparam err [StandardError] error object if request failed
1408
+ #
1409
+ # @return [Google::Apis::LoggingV2::ListSavedQueriesResponse]
1410
+ #
1411
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1412
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1413
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1414
+ def list_billing_account_location_saved_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1415
+ command = make_simple_command(:get, 'v2/{+parent}/savedQueries', options)
1416
+ command.response_representation = Google::Apis::LoggingV2::ListSavedQueriesResponse::Representation
1417
+ command.response_class = Google::Apis::LoggingV2::ListSavedQueriesResponse
1418
+ command.params['parent'] = parent unless parent.nil?
1419
+ command.query['pageSize'] = page_size unless page_size.nil?
1420
+ command.query['pageToken'] = page_token unless page_token.nil?
1421
+ command.query['fields'] = fields unless fields.nil?
1422
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1423
+ execute_or_queue_command(command, &block)
1424
+ end
1425
+
1254
1426
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
1255
1427
  # reappears if it receives new entries. Log entries written shortly before the
1256
1428
  # delete operation might not be deleted. Entries received after the delete
@@ -1972,8 +2144,8 @@ module Google
1972
2144
  end
1973
2145
 
1974
2146
  # Gets the Logging CMEK settings for the given resource.Note: CMEK for the Log
1975
- # Router can be configured for Google Cloud projects, folders, organizations and
1976
- # billing accounts. Once configured for an organization, it applies to all
2147
+ # Router can be configured for Google Cloud projects, folders, organizations,
2148
+ # and billing accounts. Once configured for an organization, it applies to all
1977
2149
  # projects and folders in the Google Cloud organization.See Enabling CMEK for
1978
2150
  # Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption)
1979
2151
  # for more information.
@@ -1982,7 +2154,7 @@ module Google
1982
2154
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
1983
2155
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
1984
2156
  # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
1985
- # Log Router can be configured for Google Cloud projects, folders, organizations
2157
+ # Log Router can be configured for Google Cloud projects, folders, organizations,
1986
2158
  # and billing accounts. Once configured for an organization, it applies to all
1987
2159
  # projects and folders in the Google Cloud organization.
1988
2160
  # @param [String] fields
@@ -2012,21 +2184,16 @@ module Google
2012
2184
  execute_or_queue_command(command, &block)
2013
2185
  end
2014
2186
 
2015
- # Gets the Log Router settings for the given resource.Note: Settings for the Log
2016
- # Router can be get for Google Cloud projects, folders, organizations and
2017
- # billing accounts. Currently it can only be configured for organizations. Once
2018
- # configured for an organization, it applies to all projects and folders in the
2019
- # Google Cloud organization.See Enabling CMEK for Log Router (https://cloud.
2020
- # google.com/logging/docs/routing/managed-encryption) for more information.
2187
+ # Gets the settings for the given resource.Note: Settings can be retrieved for
2188
+ # Google Cloud projects, folders, organizations, and billing accounts.See View
2189
+ # default resource settings for Logging (https://cloud.google.com/logging/docs/
2190
+ # default-settings#view-org-settings) for more information.
2021
2191
  # @param [String] name
2022
2192
  # Required. The resource for which to retrieve settings. "projects/[PROJECT_ID]/
2023
2193
  # settings" "organizations/[ORGANIZATION_ID]/settings" "billingAccounts/[
2024
2194
  # BILLING_ACCOUNT_ID]/settings" "folders/[FOLDER_ID]/settings" For example:"
2025
- # organizations/12345/settings"Note: Settings for the Log Router can be get for
2026
- # Google Cloud projects, folders, organizations and billing accounts. Currently
2027
- # it can only be configured for organizations. Once configured for an
2028
- # organization, it applies to all projects and folders in the Google Cloud
2029
- # organization.
2195
+ # organizations/12345/settings"Note: Settings can be retrieved for Google Cloud
2196
+ # projects, folders, organizations, and billing accounts.
2030
2197
  # @param [String] fields
2031
2198
  # Selector specifying which fields to include in a partial response.
2032
2199
  # @param [String] quota_user
@@ -2054,21 +2221,18 @@ module Google
2054
2221
  execute_or_queue_command(command, &block)
2055
2222
  end
2056
2223
 
2057
- # Updates the Log Router settings for the given resource.Note: Settings for the
2058
- # Log Router can currently only be configured for Google Cloud organizations.
2059
- # Once configured, it applies to all projects and folders in the Google Cloud
2060
- # organization.UpdateSettings will fail if 1) kms_key_name is invalid, or 2) the
2061
- # associated service account does not have the required roles/cloudkms.
2062
- # cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key
2063
- # is disabled. 4) location_id is not supported by Logging. 5) location_id
2064
- # violate OrgPolicy.See Enabling CMEK for Log Router (https://cloud.google.com/
2065
- # logging/docs/routing/managed-encryption) for more information.
2224
+ # Updates the settings for the given resource. This method applies to all
2225
+ # feature configurations for organization and folders.UpdateSettings will fail
2226
+ # if 1) kms_key_name is invalid, 2) the associated service account does not have
2227
+ # the required roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the
2228
+ # key, 3) access to the key is disabled, 4) storage_location is not supported by
2229
+ # Logging, 5) storage_location violates the location OrgPolicy, or 6)
2230
+ # default_sink_config is set but has an unspecified filter write mode.See
2231
+ # Configure default settings for organizations and folders (https://cloud.google.
2232
+ # com/logging/docs/default-settings) for more information.
2066
2233
  # @param [String] name
2067
2234
  # Required. The resource name for the settings to update. "organizations/[
2068
- # ORGANIZATION_ID]/settings" For example:"organizations/12345/settings"Note:
2069
- # Settings for the Log Router can currently only be configured for Google Cloud
2070
- # organizations. Once configured, it applies to all projects and folders in the
2071
- # Google Cloud organization.
2235
+ # ORGANIZATION_ID]/settings" For example:"organizations/12345/settings"
2072
2236
  # @param [Google::Apis::LoggingV2::Settings] settings_object
2073
2237
  # @param [String] update_mask
2074
2238
  # Optional. Field mask identifying which fields from settings should be updated.
@@ -3224,6 +3388,183 @@ module Google
3224
3388
  execute_or_queue_command(command, &block)
3225
3389
  end
3226
3390
 
3391
+ # Lists the RecentQueries that were created by the user making the request.
3392
+ # @param [String] parent
3393
+ # Required. The resource to which the listed queries belong. "projects/[
3394
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
3395
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
3396
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example:
3397
+ # projects/my-project/locations/us-central1Note: The location portion of the
3398
+ # resource must be specified, but supplying the character - in place of
3399
+ # LOCATION_ID will return all recent queries.
3400
+ # @param [Fixnum] page_size
3401
+ # Optional. The maximum number of results to return from this request. Non-
3402
+ # positive values are ignored. The presence of nextPageToken in the response
3403
+ # indicates that more results might be available.
3404
+ # @param [String] page_token
3405
+ # Optional. If present, then retrieve the next batch of results from the
3406
+ # preceding call to this method. pageToken must be the value of nextPageToken
3407
+ # from the previous response. The values of other method parameters should be
3408
+ # identical to those in the previous call.
3409
+ # @param [String] fields
3410
+ # Selector specifying which fields to include in a partial response.
3411
+ # @param [String] quota_user
3412
+ # Available to use for quota purposes for server-side applications. Can be any
3413
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3414
+ # @param [Google::Apis::RequestOptions] options
3415
+ # Request-specific options
3416
+ #
3417
+ # @yield [result, err] Result & error if block supplied
3418
+ # @yieldparam result [Google::Apis::LoggingV2::ListRecentQueriesResponse] parsed result object
3419
+ # @yieldparam err [StandardError] error object if request failed
3420
+ #
3421
+ # @return [Google::Apis::LoggingV2::ListRecentQueriesResponse]
3422
+ #
3423
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3424
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3425
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3426
+ def list_folder_location_recent_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3427
+ command = make_simple_command(:get, 'v2/{+parent}/recentQueries', options)
3428
+ command.response_representation = Google::Apis::LoggingV2::ListRecentQueriesResponse::Representation
3429
+ command.response_class = Google::Apis::LoggingV2::ListRecentQueriesResponse
3430
+ command.params['parent'] = parent unless parent.nil?
3431
+ command.query['pageSize'] = page_size unless page_size.nil?
3432
+ command.query['pageToken'] = page_token unless page_token.nil?
3433
+ command.query['fields'] = fields unless fields.nil?
3434
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3435
+ execute_or_queue_command(command, &block)
3436
+ end
3437
+
3438
+ # Creates a new SavedQuery for the user making the request.
3439
+ # @param [String] parent
3440
+ # Required. The parent resource in which to create the saved query: "projects/[
3441
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
3442
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
3443
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: "
3444
+ # projects/my-project/locations/global" "organizations/123456789/locations/us-
3445
+ # central1"
3446
+ # @param [Google::Apis::LoggingV2::SavedQuery] saved_query_object
3447
+ # @param [String] saved_query_id
3448
+ # Optional. The ID to use for the saved query, which will become the final
3449
+ # component of the saved query's resource name.If the saved_query_id is not
3450
+ # provided, the system will generate an alphanumeric ID.The saved_query_id is
3451
+ # limited to 100 characters and can include only the following characters: upper
3452
+ # and lower-case alphanumeric characters, underscores, hyphens, and periods.
3453
+ # First character has to be alphanumeric.
3454
+ # @param [String] fields
3455
+ # Selector specifying which fields to include in a partial response.
3456
+ # @param [String] quota_user
3457
+ # Available to use for quota purposes for server-side applications. Can be any
3458
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3459
+ # @param [Google::Apis::RequestOptions] options
3460
+ # Request-specific options
3461
+ #
3462
+ # @yield [result, err] Result & error if block supplied
3463
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
3464
+ # @yieldparam err [StandardError] error object if request failed
3465
+ #
3466
+ # @return [Google::Apis::LoggingV2::SavedQuery]
3467
+ #
3468
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3469
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3470
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3471
+ def create_folder_location_saved_query(parent, saved_query_object = nil, saved_query_id: nil, fields: nil, quota_user: nil, options: nil, &block)
3472
+ command = make_simple_command(:post, 'v2/{+parent}/savedQueries', options)
3473
+ command.request_representation = Google::Apis::LoggingV2::SavedQuery::Representation
3474
+ command.request_object = saved_query_object
3475
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
3476
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
3477
+ command.params['parent'] = parent unless parent.nil?
3478
+ command.query['savedQueryId'] = saved_query_id unless saved_query_id.nil?
3479
+ command.query['fields'] = fields unless fields.nil?
3480
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3481
+ execute_or_queue_command(command, &block)
3482
+ end
3483
+
3484
+ # Deletes an existing SavedQuery that was created by the user making the request.
3485
+ # @param [String] name
3486
+ # Required. The full resource name of the saved query to delete. "projects/[
3487
+ # PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[
3488
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "
3489
+ # billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[
3490
+ # QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]
3491
+ # " For example: "projects/my-project/locations/global/savedQueries/my-saved-
3492
+ # query"
3493
+ # @param [String] fields
3494
+ # Selector specifying which fields to include in a partial response.
3495
+ # @param [String] quota_user
3496
+ # Available to use for quota purposes for server-side applications. Can be any
3497
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3498
+ # @param [Google::Apis::RequestOptions] options
3499
+ # Request-specific options
3500
+ #
3501
+ # @yield [result, err] Result & error if block supplied
3502
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
3503
+ # @yieldparam err [StandardError] error object if request failed
3504
+ #
3505
+ # @return [Google::Apis::LoggingV2::Empty]
3506
+ #
3507
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3508
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3509
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3510
+ def delete_folder_location_saved_query(name, fields: nil, quota_user: nil, options: nil, &block)
3511
+ command = make_simple_command(:delete, 'v2/{+name}', options)
3512
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
3513
+ command.response_class = Google::Apis::LoggingV2::Empty
3514
+ command.params['name'] = name unless name.nil?
3515
+ command.query['fields'] = fields unless fields.nil?
3516
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3517
+ execute_or_queue_command(command, &block)
3518
+ end
3519
+
3520
+ # Lists the SavedQueries that were created by the user making the request.
3521
+ # @param [String] parent
3522
+ # Required. The resource to which the listed queries belong. "projects/[
3523
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
3524
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
3525
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: "
3526
+ # projects/my-project/locations/us-central1" Note: The locations portion of the
3527
+ # resource must be specified. To get a list of all saved queries, a wildcard
3528
+ # character - can be used for LOCATION_ID, for example: "projects/my-project/
3529
+ # locations/-"
3530
+ # @param [Fixnum] page_size
3531
+ # Optional. The maximum number of results to return from this request.Non-
3532
+ # positive values are ignored. The presence of nextPageToken in the response
3533
+ # indicates that more results might be available.
3534
+ # @param [String] page_token
3535
+ # Optional. If present, then retrieve the next batch of results from the
3536
+ # preceding call to this method. pageToken must be the value of nextPageToken
3537
+ # from the previous response. The values of other method parameters should be
3538
+ # identical to those in the previous call.
3539
+ # @param [String] fields
3540
+ # Selector specifying which fields to include in a partial response.
3541
+ # @param [String] quota_user
3542
+ # Available to use for quota purposes for server-side applications. Can be any
3543
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3544
+ # @param [Google::Apis::RequestOptions] options
3545
+ # Request-specific options
3546
+ #
3547
+ # @yield [result, err] Result & error if block supplied
3548
+ # @yieldparam result [Google::Apis::LoggingV2::ListSavedQueriesResponse] parsed result object
3549
+ # @yieldparam err [StandardError] error object if request failed
3550
+ #
3551
+ # @return [Google::Apis::LoggingV2::ListSavedQueriesResponse]
3552
+ #
3553
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3554
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3555
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3556
+ def list_folder_location_saved_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3557
+ command = make_simple_command(:get, 'v2/{+parent}/savedQueries', options)
3558
+ command.response_representation = Google::Apis::LoggingV2::ListSavedQueriesResponse::Representation
3559
+ command.response_class = Google::Apis::LoggingV2::ListSavedQueriesResponse
3560
+ command.params['parent'] = parent unless parent.nil?
3561
+ command.query['pageSize'] = page_size unless page_size.nil?
3562
+ command.query['pageToken'] = page_token unless page_token.nil?
3563
+ command.query['fields'] = fields unless fields.nil?
3564
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3565
+ execute_or_queue_command(command, &block)
3566
+ end
3567
+
3227
3568
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
3228
3569
  # reappears if it receives new entries. Log entries written shortly before the
3229
3570
  # delete operation might not be deleted. Entries received after the delete
@@ -4624,8 +4965,8 @@ module Google
4624
4965
  end
4625
4966
 
4626
4967
  # Gets the Logging CMEK settings for the given resource.Note: CMEK for the Log
4627
- # Router can be configured for Google Cloud projects, folders, organizations and
4628
- # billing accounts. Once configured for an organization, it applies to all
4968
+ # Router can be configured for Google Cloud projects, folders, organizations,
4969
+ # and billing accounts. Once configured for an organization, it applies to all
4629
4970
  # projects and folders in the Google Cloud organization.See Enabling CMEK for
4630
4971
  # Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption)
4631
4972
  # for more information.
@@ -4634,7 +4975,7 @@ module Google
4634
4975
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
4635
4976
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
4636
4977
  # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
4637
- # Log Router can be configured for Google Cloud projects, folders, organizations
4978
+ # Log Router can be configured for Google Cloud projects, folders, organizations,
4638
4979
  # and billing accounts. Once configured for an organization, it applies to all
4639
4980
  # projects and folders in the Google Cloud organization.
4640
4981
  # @param [String] fields
@@ -4664,21 +5005,16 @@ module Google
4664
5005
  execute_or_queue_command(command, &block)
4665
5006
  end
4666
5007
 
4667
- # Gets the Log Router settings for the given resource.Note: Settings for the Log
4668
- # Router can be get for Google Cloud projects, folders, organizations and
4669
- # billing accounts. Currently it can only be configured for organizations. Once
4670
- # configured for an organization, it applies to all projects and folders in the
4671
- # Google Cloud organization.See Enabling CMEK for Log Router (https://cloud.
4672
- # google.com/logging/docs/routing/managed-encryption) for more information.
5008
+ # Gets the settings for the given resource.Note: Settings can be retrieved for
5009
+ # Google Cloud projects, folders, organizations, and billing accounts.See View
5010
+ # default resource settings for Logging (https://cloud.google.com/logging/docs/
5011
+ # default-settings#view-org-settings) for more information.
4673
5012
  # @param [String] name
4674
5013
  # Required. The resource for which to retrieve settings. "projects/[PROJECT_ID]/
4675
5014
  # settings" "organizations/[ORGANIZATION_ID]/settings" "billingAccounts/[
4676
5015
  # BILLING_ACCOUNT_ID]/settings" "folders/[FOLDER_ID]/settings" For example:"
4677
- # organizations/12345/settings"Note: Settings for the Log Router can be get for
4678
- # Google Cloud projects, folders, organizations and billing accounts. Currently
4679
- # it can only be configured for organizations. Once configured for an
4680
- # organization, it applies to all projects and folders in the Google Cloud
4681
- # organization.
5016
+ # organizations/12345/settings"Note: Settings can be retrieved for Google Cloud
5017
+ # projects, folders, organizations, and billing accounts.
4682
5018
  # @param [String] fields
4683
5019
  # Selector specifying which fields to include in a partial response.
4684
5020
  # @param [String] quota_user
@@ -4758,21 +5094,18 @@ module Google
4758
5094
  execute_or_queue_command(command, &block)
4759
5095
  end
4760
5096
 
4761
- # Updates the Log Router settings for the given resource.Note: Settings for the
4762
- # Log Router can currently only be configured for Google Cloud organizations.
4763
- # Once configured, it applies to all projects and folders in the Google Cloud
4764
- # organization.UpdateSettings will fail if 1) kms_key_name is invalid, or 2) the
4765
- # associated service account does not have the required roles/cloudkms.
4766
- # cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key
4767
- # is disabled. 4) location_id is not supported by Logging. 5) location_id
4768
- # violate OrgPolicy.See Enabling CMEK for Log Router (https://cloud.google.com/
4769
- # logging/docs/routing/managed-encryption) for more information.
5097
+ # Updates the settings for the given resource. This method applies to all
5098
+ # feature configurations for organization and folders.UpdateSettings will fail
5099
+ # if 1) kms_key_name is invalid, 2) the associated service account does not have
5100
+ # the required roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the
5101
+ # key, 3) access to the key is disabled, 4) storage_location is not supported by
5102
+ # Logging, 5) storage_location violates the location OrgPolicy, or 6)
5103
+ # default_sink_config is set but has an unspecified filter write mode.See
5104
+ # Configure default settings for organizations and folders (https://cloud.google.
5105
+ # com/logging/docs/default-settings) for more information.
4770
5106
  # @param [String] name
4771
5107
  # Required. The resource name for the settings to update. "organizations/[
4772
- # ORGANIZATION_ID]/settings" For example:"organizations/12345/settings"Note:
4773
- # Settings for the Log Router can currently only be configured for Google Cloud
4774
- # organizations. Once configured, it applies to all projects and folders in the
4775
- # Google Cloud organization.
5108
+ # ORGANIZATION_ID]/settings" For example:"organizations/12345/settings"
4776
5109
  # @param [Google::Apis::LoggingV2::Settings] settings_object
4777
5110
  # @param [String] update_mask
4778
5111
  # Optional. Field mask identifying which fields from settings should be updated.
@@ -5928,6 +6261,183 @@ module Google
5928
6261
  execute_or_queue_command(command, &block)
5929
6262
  end
5930
6263
 
6264
+ # Lists the RecentQueries that were created by the user making the request.
6265
+ # @param [String] parent
6266
+ # Required. The resource to which the listed queries belong. "projects/[
6267
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
6268
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
6269
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example:
6270
+ # projects/my-project/locations/us-central1Note: The location portion of the
6271
+ # resource must be specified, but supplying the character - in place of
6272
+ # LOCATION_ID will return all recent queries.
6273
+ # @param [Fixnum] page_size
6274
+ # Optional. The maximum number of results to return from this request. Non-
6275
+ # positive values are ignored. The presence of nextPageToken in the response
6276
+ # indicates that more results might be available.
6277
+ # @param [String] page_token
6278
+ # Optional. If present, then retrieve the next batch of results from the
6279
+ # preceding call to this method. pageToken must be the value of nextPageToken
6280
+ # from the previous response. The values of other method parameters should be
6281
+ # identical to those in the previous call.
6282
+ # @param [String] fields
6283
+ # Selector specifying which fields to include in a partial response.
6284
+ # @param [String] quota_user
6285
+ # Available to use for quota purposes for server-side applications. Can be any
6286
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6287
+ # @param [Google::Apis::RequestOptions] options
6288
+ # Request-specific options
6289
+ #
6290
+ # @yield [result, err] Result & error if block supplied
6291
+ # @yieldparam result [Google::Apis::LoggingV2::ListRecentQueriesResponse] parsed result object
6292
+ # @yieldparam err [StandardError] error object if request failed
6293
+ #
6294
+ # @return [Google::Apis::LoggingV2::ListRecentQueriesResponse]
6295
+ #
6296
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6297
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6298
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6299
+ def list_organization_location_recent_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
6300
+ command = make_simple_command(:get, 'v2/{+parent}/recentQueries', options)
6301
+ command.response_representation = Google::Apis::LoggingV2::ListRecentQueriesResponse::Representation
6302
+ command.response_class = Google::Apis::LoggingV2::ListRecentQueriesResponse
6303
+ command.params['parent'] = parent unless parent.nil?
6304
+ command.query['pageSize'] = page_size unless page_size.nil?
6305
+ command.query['pageToken'] = page_token unless page_token.nil?
6306
+ command.query['fields'] = fields unless fields.nil?
6307
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6308
+ execute_or_queue_command(command, &block)
6309
+ end
6310
+
6311
+ # Creates a new SavedQuery for the user making the request.
6312
+ # @param [String] parent
6313
+ # Required. The parent resource in which to create the saved query: "projects/[
6314
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
6315
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
6316
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: "
6317
+ # projects/my-project/locations/global" "organizations/123456789/locations/us-
6318
+ # central1"
6319
+ # @param [Google::Apis::LoggingV2::SavedQuery] saved_query_object
6320
+ # @param [String] saved_query_id
6321
+ # Optional. The ID to use for the saved query, which will become the final
6322
+ # component of the saved query's resource name.If the saved_query_id is not
6323
+ # provided, the system will generate an alphanumeric ID.The saved_query_id is
6324
+ # limited to 100 characters and can include only the following characters: upper
6325
+ # and lower-case alphanumeric characters, underscores, hyphens, and periods.
6326
+ # First character has to be alphanumeric.
6327
+ # @param [String] fields
6328
+ # Selector specifying which fields to include in a partial response.
6329
+ # @param [String] quota_user
6330
+ # Available to use for quota purposes for server-side applications. Can be any
6331
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6332
+ # @param [Google::Apis::RequestOptions] options
6333
+ # Request-specific options
6334
+ #
6335
+ # @yield [result, err] Result & error if block supplied
6336
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
6337
+ # @yieldparam err [StandardError] error object if request failed
6338
+ #
6339
+ # @return [Google::Apis::LoggingV2::SavedQuery]
6340
+ #
6341
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6342
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6343
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6344
+ def create_organization_location_saved_query(parent, saved_query_object = nil, saved_query_id: nil, fields: nil, quota_user: nil, options: nil, &block)
6345
+ command = make_simple_command(:post, 'v2/{+parent}/savedQueries', options)
6346
+ command.request_representation = Google::Apis::LoggingV2::SavedQuery::Representation
6347
+ command.request_object = saved_query_object
6348
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
6349
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
6350
+ command.params['parent'] = parent unless parent.nil?
6351
+ command.query['savedQueryId'] = saved_query_id unless saved_query_id.nil?
6352
+ command.query['fields'] = fields unless fields.nil?
6353
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6354
+ execute_or_queue_command(command, &block)
6355
+ end
6356
+
6357
+ # Deletes an existing SavedQuery that was created by the user making the request.
6358
+ # @param [String] name
6359
+ # Required. The full resource name of the saved query to delete. "projects/[
6360
+ # PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[
6361
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "
6362
+ # billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[
6363
+ # QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]
6364
+ # " For example: "projects/my-project/locations/global/savedQueries/my-saved-
6365
+ # query"
6366
+ # @param [String] fields
6367
+ # Selector specifying which fields to include in a partial response.
6368
+ # @param [String] quota_user
6369
+ # Available to use for quota purposes for server-side applications. Can be any
6370
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6371
+ # @param [Google::Apis::RequestOptions] options
6372
+ # Request-specific options
6373
+ #
6374
+ # @yield [result, err] Result & error if block supplied
6375
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
6376
+ # @yieldparam err [StandardError] error object if request failed
6377
+ #
6378
+ # @return [Google::Apis::LoggingV2::Empty]
6379
+ #
6380
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6381
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6382
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6383
+ def delete_organization_location_saved_query(name, fields: nil, quota_user: nil, options: nil, &block)
6384
+ command = make_simple_command(:delete, 'v2/{+name}', options)
6385
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
6386
+ command.response_class = Google::Apis::LoggingV2::Empty
6387
+ command.params['name'] = name unless name.nil?
6388
+ command.query['fields'] = fields unless fields.nil?
6389
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6390
+ execute_or_queue_command(command, &block)
6391
+ end
6392
+
6393
+ # Lists the SavedQueries that were created by the user making the request.
6394
+ # @param [String] parent
6395
+ # Required. The resource to which the listed queries belong. "projects/[
6396
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
6397
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
6398
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: "
6399
+ # projects/my-project/locations/us-central1" Note: The locations portion of the
6400
+ # resource must be specified. To get a list of all saved queries, a wildcard
6401
+ # character - can be used for LOCATION_ID, for example: "projects/my-project/
6402
+ # locations/-"
6403
+ # @param [Fixnum] page_size
6404
+ # Optional. The maximum number of results to return from this request.Non-
6405
+ # positive values are ignored. The presence of nextPageToken in the response
6406
+ # indicates that more results might be available.
6407
+ # @param [String] page_token
6408
+ # Optional. If present, then retrieve the next batch of results from the
6409
+ # preceding call to this method. pageToken must be the value of nextPageToken
6410
+ # from the previous response. The values of other method parameters should be
6411
+ # identical to those in the previous call.
6412
+ # @param [String] fields
6413
+ # Selector specifying which fields to include in a partial response.
6414
+ # @param [String] quota_user
6415
+ # Available to use for quota purposes for server-side applications. Can be any
6416
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6417
+ # @param [Google::Apis::RequestOptions] options
6418
+ # Request-specific options
6419
+ #
6420
+ # @yield [result, err] Result & error if block supplied
6421
+ # @yieldparam result [Google::Apis::LoggingV2::ListSavedQueriesResponse] parsed result object
6422
+ # @yieldparam err [StandardError] error object if request failed
6423
+ #
6424
+ # @return [Google::Apis::LoggingV2::ListSavedQueriesResponse]
6425
+ #
6426
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6427
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6428
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6429
+ def list_organization_location_saved_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
6430
+ command = make_simple_command(:get, 'v2/{+parent}/savedQueries', options)
6431
+ command.response_representation = Google::Apis::LoggingV2::ListSavedQueriesResponse::Representation
6432
+ command.response_class = Google::Apis::LoggingV2::ListSavedQueriesResponse
6433
+ command.params['parent'] = parent unless parent.nil?
6434
+ command.query['pageSize'] = page_size unless page_size.nil?
6435
+ command.query['pageToken'] = page_token unless page_token.nil?
6436
+ command.query['fields'] = fields unless fields.nil?
6437
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6438
+ execute_or_queue_command(command, &block)
6439
+ end
6440
+
5931
6441
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
5932
6442
  # reappears if it receives new entries. Log entries written shortly before the
5933
6443
  # delete operation might not be deleted. Entries received after the delete
@@ -6327,8 +6837,8 @@ module Google
6327
6837
  end
6328
6838
 
6329
6839
  # Gets the Logging CMEK settings for the given resource.Note: CMEK for the Log
6330
- # Router can be configured for Google Cloud projects, folders, organizations and
6331
- # billing accounts. Once configured for an organization, it applies to all
6840
+ # Router can be configured for Google Cloud projects, folders, organizations,
6841
+ # and billing accounts. Once configured for an organization, it applies to all
6332
6842
  # projects and folders in the Google Cloud organization.See Enabling CMEK for
6333
6843
  # Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption)
6334
6844
  # for more information.
@@ -6337,7 +6847,7 @@ module Google
6337
6847
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
6338
6848
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
6339
6849
  # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
6340
- # Log Router can be configured for Google Cloud projects, folders, organizations
6850
+ # Log Router can be configured for Google Cloud projects, folders, organizations,
6341
6851
  # and billing accounts. Once configured for an organization, it applies to all
6342
6852
  # projects and folders in the Google Cloud organization.
6343
6853
  # @param [String] fields
@@ -6367,21 +6877,16 @@ module Google
6367
6877
  execute_or_queue_command(command, &block)
6368
6878
  end
6369
6879
 
6370
- # Gets the Log Router settings for the given resource.Note: Settings for the Log
6371
- # Router can be get for Google Cloud projects, folders, organizations and
6372
- # billing accounts. Currently it can only be configured for organizations. Once
6373
- # configured for an organization, it applies to all projects and folders in the
6374
- # Google Cloud organization.See Enabling CMEK for Log Router (https://cloud.
6375
- # google.com/logging/docs/routing/managed-encryption) for more information.
6880
+ # Gets the settings for the given resource.Note: Settings can be retrieved for
6881
+ # Google Cloud projects, folders, organizations, and billing accounts.See View
6882
+ # default resource settings for Logging (https://cloud.google.com/logging/docs/
6883
+ # default-settings#view-org-settings) for more information.
6376
6884
  # @param [String] name
6377
6885
  # Required. The resource for which to retrieve settings. "projects/[PROJECT_ID]/
6378
6886
  # settings" "organizations/[ORGANIZATION_ID]/settings" "billingAccounts/[
6379
6887
  # BILLING_ACCOUNT_ID]/settings" "folders/[FOLDER_ID]/settings" For example:"
6380
- # organizations/12345/settings"Note: Settings for the Log Router can be get for
6381
- # Google Cloud projects, folders, organizations and billing accounts. Currently
6382
- # it can only be configured for organizations. Once configured for an
6383
- # organization, it applies to all projects and folders in the Google Cloud
6384
- # organization.
6888
+ # organizations/12345/settings"Note: Settings can be retrieved for Google Cloud
6889
+ # projects, folders, organizations, and billing accounts.
6385
6890
  # @param [String] fields
6386
6891
  # Selector specifying which fields to include in a partial response.
6387
6892
  # @param [String] quota_user
@@ -7528,6 +8033,183 @@ module Google
7528
8033
  execute_or_queue_command(command, &block)
7529
8034
  end
7530
8035
 
8036
+ # Lists the RecentQueries that were created by the user making the request.
8037
+ # @param [String] parent
8038
+ # Required. The resource to which the listed queries belong. "projects/[
8039
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
8040
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
8041
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example:
8042
+ # projects/my-project/locations/us-central1Note: The location portion of the
8043
+ # resource must be specified, but supplying the character - in place of
8044
+ # LOCATION_ID will return all recent queries.
8045
+ # @param [Fixnum] page_size
8046
+ # Optional. The maximum number of results to return from this request. Non-
8047
+ # positive values are ignored. The presence of nextPageToken in the response
8048
+ # indicates that more results might be available.
8049
+ # @param [String] page_token
8050
+ # Optional. If present, then retrieve the next batch of results from the
8051
+ # preceding call to this method. pageToken must be the value of nextPageToken
8052
+ # from the previous response. The values of other method parameters should be
8053
+ # identical to those in the previous call.
8054
+ # @param [String] fields
8055
+ # Selector specifying which fields to include in a partial response.
8056
+ # @param [String] quota_user
8057
+ # Available to use for quota purposes for server-side applications. Can be any
8058
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8059
+ # @param [Google::Apis::RequestOptions] options
8060
+ # Request-specific options
8061
+ #
8062
+ # @yield [result, err] Result & error if block supplied
8063
+ # @yieldparam result [Google::Apis::LoggingV2::ListRecentQueriesResponse] parsed result object
8064
+ # @yieldparam err [StandardError] error object if request failed
8065
+ #
8066
+ # @return [Google::Apis::LoggingV2::ListRecentQueriesResponse]
8067
+ #
8068
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8069
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8070
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8071
+ def list_project_location_recent_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
8072
+ command = make_simple_command(:get, 'v2/{+parent}/recentQueries', options)
8073
+ command.response_representation = Google::Apis::LoggingV2::ListRecentQueriesResponse::Representation
8074
+ command.response_class = Google::Apis::LoggingV2::ListRecentQueriesResponse
8075
+ command.params['parent'] = parent unless parent.nil?
8076
+ command.query['pageSize'] = page_size unless page_size.nil?
8077
+ command.query['pageToken'] = page_token unless page_token.nil?
8078
+ command.query['fields'] = fields unless fields.nil?
8079
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8080
+ execute_or_queue_command(command, &block)
8081
+ end
8082
+
8083
+ # Creates a new SavedQuery for the user making the request.
8084
+ # @param [String] parent
8085
+ # Required. The parent resource in which to create the saved query: "projects/[
8086
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
8087
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
8088
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: "
8089
+ # projects/my-project/locations/global" "organizations/123456789/locations/us-
8090
+ # central1"
8091
+ # @param [Google::Apis::LoggingV2::SavedQuery] saved_query_object
8092
+ # @param [String] saved_query_id
8093
+ # Optional. The ID to use for the saved query, which will become the final
8094
+ # component of the saved query's resource name.If the saved_query_id is not
8095
+ # provided, the system will generate an alphanumeric ID.The saved_query_id is
8096
+ # limited to 100 characters and can include only the following characters: upper
8097
+ # and lower-case alphanumeric characters, underscores, hyphens, and periods.
8098
+ # First character has to be alphanumeric.
8099
+ # @param [String] fields
8100
+ # Selector specifying which fields to include in a partial response.
8101
+ # @param [String] quota_user
8102
+ # Available to use for quota purposes for server-side applications. Can be any
8103
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8104
+ # @param [Google::Apis::RequestOptions] options
8105
+ # Request-specific options
8106
+ #
8107
+ # @yield [result, err] Result & error if block supplied
8108
+ # @yieldparam result [Google::Apis::LoggingV2::SavedQuery] parsed result object
8109
+ # @yieldparam err [StandardError] error object if request failed
8110
+ #
8111
+ # @return [Google::Apis::LoggingV2::SavedQuery]
8112
+ #
8113
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8114
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8115
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8116
+ def create_project_location_saved_query(parent, saved_query_object = nil, saved_query_id: nil, fields: nil, quota_user: nil, options: nil, &block)
8117
+ command = make_simple_command(:post, 'v2/{+parent}/savedQueries', options)
8118
+ command.request_representation = Google::Apis::LoggingV2::SavedQuery::Representation
8119
+ command.request_object = saved_query_object
8120
+ command.response_representation = Google::Apis::LoggingV2::SavedQuery::Representation
8121
+ command.response_class = Google::Apis::LoggingV2::SavedQuery
8122
+ command.params['parent'] = parent unless parent.nil?
8123
+ command.query['savedQueryId'] = saved_query_id unless saved_query_id.nil?
8124
+ command.query['fields'] = fields unless fields.nil?
8125
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8126
+ execute_or_queue_command(command, &block)
8127
+ end
8128
+
8129
+ # Deletes an existing SavedQuery that was created by the user making the request.
8130
+ # @param [String] name
8131
+ # Required. The full resource name of the saved query to delete. "projects/[
8132
+ # PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "organizations/[
8133
+ # ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "
8134
+ # billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[
8135
+ # QUERY_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]
8136
+ # " For example: "projects/my-project/locations/global/savedQueries/my-saved-
8137
+ # query"
8138
+ # @param [String] fields
8139
+ # Selector specifying which fields to include in a partial response.
8140
+ # @param [String] quota_user
8141
+ # Available to use for quota purposes for server-side applications. Can be any
8142
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8143
+ # @param [Google::Apis::RequestOptions] options
8144
+ # Request-specific options
8145
+ #
8146
+ # @yield [result, err] Result & error if block supplied
8147
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
8148
+ # @yieldparam err [StandardError] error object if request failed
8149
+ #
8150
+ # @return [Google::Apis::LoggingV2::Empty]
8151
+ #
8152
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8153
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8154
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8155
+ def delete_project_location_saved_query(name, fields: nil, quota_user: nil, options: nil, &block)
8156
+ command = make_simple_command(:delete, 'v2/{+name}', options)
8157
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
8158
+ command.response_class = Google::Apis::LoggingV2::Empty
8159
+ command.params['name'] = name unless name.nil?
8160
+ command.query['fields'] = fields unless fields.nil?
8161
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8162
+ execute_or_queue_command(command, &block)
8163
+ end
8164
+
8165
+ # Lists the SavedQueries that were created by the user making the request.
8166
+ # @param [String] parent
8167
+ # Required. The resource to which the listed queries belong. "projects/[
8168
+ # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
8169
+ # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
8170
+ # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: "
8171
+ # projects/my-project/locations/us-central1" Note: The locations portion of the
8172
+ # resource must be specified. To get a list of all saved queries, a wildcard
8173
+ # character - can be used for LOCATION_ID, for example: "projects/my-project/
8174
+ # locations/-"
8175
+ # @param [Fixnum] page_size
8176
+ # Optional. The maximum number of results to return from this request.Non-
8177
+ # positive values are ignored. The presence of nextPageToken in the response
8178
+ # indicates that more results might be available.
8179
+ # @param [String] page_token
8180
+ # Optional. If present, then retrieve the next batch of results from the
8181
+ # preceding call to this method. pageToken must be the value of nextPageToken
8182
+ # from the previous response. The values of other method parameters should be
8183
+ # identical to those in the previous call.
8184
+ # @param [String] fields
8185
+ # Selector specifying which fields to include in a partial response.
8186
+ # @param [String] quota_user
8187
+ # Available to use for quota purposes for server-side applications. Can be any
8188
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
8189
+ # @param [Google::Apis::RequestOptions] options
8190
+ # Request-specific options
8191
+ #
8192
+ # @yield [result, err] Result & error if block supplied
8193
+ # @yieldparam result [Google::Apis::LoggingV2::ListSavedQueriesResponse] parsed result object
8194
+ # @yieldparam err [StandardError] error object if request failed
8195
+ #
8196
+ # @return [Google::Apis::LoggingV2::ListSavedQueriesResponse]
8197
+ #
8198
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
8199
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8200
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8201
+ def list_project_location_saved_queries(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
8202
+ command = make_simple_command(:get, 'v2/{+parent}/savedQueries', options)
8203
+ command.response_representation = Google::Apis::LoggingV2::ListSavedQueriesResponse::Representation
8204
+ command.response_class = Google::Apis::LoggingV2::ListSavedQueriesResponse
8205
+ command.params['parent'] = parent unless parent.nil?
8206
+ command.query['pageSize'] = page_size unless page_size.nil?
8207
+ command.query['pageToken'] = page_token unless page_token.nil?
8208
+ command.query['fields'] = fields unless fields.nil?
8209
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8210
+ execute_or_queue_command(command, &block)
8211
+ end
8212
+
7531
8213
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
7532
8214
  # reappears if it receives new entries. Log entries written shortly before the
7533
8215
  # delete operation might not be deleted. Entries received after the delete
@@ -8338,8 +9020,8 @@ module Google
8338
9020
  end
8339
9021
 
8340
9022
  # Gets the Logging CMEK settings for the given resource.Note: CMEK for the Log
8341
- # Router can be configured for Google Cloud projects, folders, organizations and
8342
- # billing accounts. Once configured for an organization, it applies to all
9023
+ # Router can be configured for Google Cloud projects, folders, organizations,
9024
+ # and billing accounts. Once configured for an organization, it applies to all
8343
9025
  # projects and folders in the Google Cloud organization.See Enabling CMEK for
8344
9026
  # Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption)
8345
9027
  # for more information.
@@ -8348,7 +9030,7 @@ module Google
8348
9030
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
8349
9031
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
8350
9032
  # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
8351
- # Log Router can be configured for Google Cloud projects, folders, organizations
9033
+ # Log Router can be configured for Google Cloud projects, folders, organizations,
8352
9034
  # and billing accounts. Once configured for an organization, it applies to all
8353
9035
  # projects and folders in the Google Cloud organization.
8354
9036
  # @param [String] fields
@@ -8378,21 +9060,16 @@ module Google
8378
9060
  execute_or_queue_command(command, &block)
8379
9061
  end
8380
9062
 
8381
- # Gets the Log Router settings for the given resource.Note: Settings for the Log
8382
- # Router can be get for Google Cloud projects, folders, organizations and
8383
- # billing accounts. Currently it can only be configured for organizations. Once
8384
- # configured for an organization, it applies to all projects and folders in the
8385
- # Google Cloud organization.See Enabling CMEK for Log Router (https://cloud.
8386
- # google.com/logging/docs/routing/managed-encryption) for more information.
9063
+ # Gets the settings for the given resource.Note: Settings can be retrieved for
9064
+ # Google Cloud projects, folders, organizations, and billing accounts.See View
9065
+ # default resource settings for Logging (https://cloud.google.com/logging/docs/
9066
+ # default-settings#view-org-settings) for more information.
8387
9067
  # @param [String] name
8388
9068
  # Required. The resource for which to retrieve settings. "projects/[PROJECT_ID]/
8389
9069
  # settings" "organizations/[ORGANIZATION_ID]/settings" "billingAccounts/[
8390
9070
  # BILLING_ACCOUNT_ID]/settings" "folders/[FOLDER_ID]/settings" For example:"
8391
- # organizations/12345/settings"Note: Settings for the Log Router can be get for
8392
- # Google Cloud projects, folders, organizations and billing accounts. Currently
8393
- # it can only be configured for organizations. Once configured for an
8394
- # organization, it applies to all projects and folders in the Google Cloud
8395
- # organization.
9071
+ # organizations/12345/settings"Note: Settings can be retrieved for Google Cloud
9072
+ # projects, folders, organizations, and billing accounts.
8396
9073
  # @param [String] fields
8397
9074
  # Selector specifying which fields to include in a partial response.
8398
9075
  # @param [String] quota_user
@@ -8472,21 +9149,18 @@ module Google
8472
9149
  execute_or_queue_command(command, &block)
8473
9150
  end
8474
9151
 
8475
- # Updates the Log Router settings for the given resource.Note: Settings for the
8476
- # Log Router can currently only be configured for Google Cloud organizations.
8477
- # Once configured, it applies to all projects and folders in the Google Cloud
8478
- # organization.UpdateSettings will fail if 1) kms_key_name is invalid, or 2) the
8479
- # associated service account does not have the required roles/cloudkms.
8480
- # cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key
8481
- # is disabled. 4) location_id is not supported by Logging. 5) location_id
8482
- # violate OrgPolicy.See Enabling CMEK for Log Router (https://cloud.google.com/
8483
- # logging/docs/routing/managed-encryption) for more information.
9152
+ # Updates the settings for the given resource. This method applies to all
9153
+ # feature configurations for organization and folders.UpdateSettings will fail
9154
+ # if 1) kms_key_name is invalid, 2) the associated service account does not have
9155
+ # the required roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the
9156
+ # key, 3) access to the key is disabled, 4) storage_location is not supported by
9157
+ # Logging, 5) storage_location violates the location OrgPolicy, or 6)
9158
+ # default_sink_config is set but has an unspecified filter write mode.See
9159
+ # Configure default settings for organizations and folders (https://cloud.google.
9160
+ # com/logging/docs/default-settings) for more information.
8484
9161
  # @param [String] name
8485
9162
  # Required. The resource name for the settings to update. "organizations/[
8486
- # ORGANIZATION_ID]/settings" For example:"organizations/12345/settings"Note:
8487
- # Settings for the Log Router can currently only be configured for Google Cloud
8488
- # organizations. Once configured, it applies to all projects and folders in the
8489
- # Google Cloud organization.
9163
+ # ORGANIZATION_ID]/settings" For example:"organizations/12345/settings"
8490
9164
  # @param [Google::Apis::LoggingV2::Settings] settings_object
8491
9165
  # @param [String] update_mask
8492
9166
  # Optional. Field mask identifying which fields from settings should be updated.