google-apis-logging_v2 0.57.0 → 0.59.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (7) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +8 -0
  3. data/lib/google/apis/logging_v2/classes.rb +344 -21
  4. data/lib/google/apis/logging_v2/gem_version.rb +2 -2
  5. data/lib/google/apis/logging_v2/representations.rb +132 -0
  6. data/lib/google/apis/logging_v2/service.rb +783 -109
  7. metadata +3 -3
data/lib/google/apis/logging_v2/service.rb CHANGED
@@ -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.