google-apis-logging_v2 0.15.0 → 0.19.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (9) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +17 -0
  3. data/OVERVIEW.md +2 -2
  4. data/lib/google/apis/logging_v2/classes.rb +39 -28
  5. data/lib/google/apis/logging_v2/gem_version.rb +2 -2
  6. data/lib/google/apis/logging_v2/representations.rb +2 -0
  7. data/lib/google/apis/logging_v2/service.rb +197 -71
  8. data/lib/google/apis/logging_v2.rb +1 -4
  9. metadata +5 -5
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 37365c3e8c66171c5d7050bdd6d511d07ec8cdc3d7c8765b20ce6eac527eebc8
4
- data.tar.gz: b33f7c4482ce007949d1d64a43087f1988173619c0d1aa61cfc81382cfef9b12
3
+ metadata.gz: 51755bf9cbb6bb9bc70a8bdc20350757ddfd1254c9e06266a32ff2da7cffd6dd
4
+ data.tar.gz: 45a4fed42b300490fae10709e348b3c1a865aec611288b617bd3b32ba00be40c
5
5
  SHA512:
6
- metadata.gz: 41a689179b7cfd3168c0708c4eeb438d08f905a364bd9467d09545073cb353365c53db2bedc8f48c735c23cb6d784861e11be93115ce9090e2258ad2eb20b6ee
7
- data.tar.gz: 0e0ba8afa35eb6fbab9eace685dcb352605548eee8f8d661ac300b9585433e2ca0906a4c195d6606c23fb76d7c9ecc44dc3f3b85c1126d59aa9a1be79ace8350
6
+ metadata.gz: ca1076b904c70908e10e06f6c89dde0fa1ccb04a183b6a686a8dcc2c810eb232511ed8a9ab5c64f9d61b5c0ef39377e2309b9c9f19039864cdd60bda1053ca38
7
+ data.tar.gz: 1a3b126aae826930abc5e2edc64d8dbdae819e20ef6e44dabce558f22cf14b37fc7c201d991efedf1b0401f7c1e32284670d955855aaa4efcc9ed821195035e9
data/CHANGELOG.md CHANGED
@@ -1,5 +1,22 @@
1
1
  # Release history for google-apis-logging_v2
2
2
 
3
+ ### v0.19.0 (2021-12-11)
4
+
5
+ * Regenerated from discovery document revision 20211130
6
+
7
+ ### v0.18.0 (2021-11-19)
8
+
9
+ * Regenerated from discovery document revision 20211108
10
+
11
+ ### v0.17.0 (2021-11-02)
12
+
13
+ * Regenerated from discovery document revision 20211019
14
+
15
+ ### v0.16.0 (2021-10-26)
16
+
17
+ * Regenerated from discovery document revision 20211015
18
+ * Unspecified changes
19
+
3
20
  ### v0.15.0 (2021-10-02)
4
21
 
5
22
  * Regenerated from discovery document revision 20210922
data/OVERVIEW.md CHANGED
@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
60
60
 
61
61
  More detailed descriptions of the Google simple REST clients are available in two documents.
62
62
 
63
- * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
64
- * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
63
+ * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
64
+ * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
65
65
 
66
66
  (Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Logging service in particular.)
67
67
 
data/lib/google/apis/logging_v2/classes.rb CHANGED
@@ -131,27 +131,27 @@ module Google
131
131
 
132
132
  # Describes the customer-managed encryption key (CMEK) settings associated with
133
133
  # a project, folder, organization, billing account, or flexible resource.Note:
134
- # CMEK for the Logs Router can currently only be configured for GCP
134
+ # CMEK for the Log Router can currently only be configured for Google Cloud
135
135
  # organizations. Once configured, it applies to all projects and folders in the
136
- # GCP organization.See Enabling CMEK for Logs Router (https://cloud.google.com/
137
- # logging/docs/routing/managed-encryption) for more information.
136
+ # Google Cloud organization.See Enabling CMEK for Log Router (https://cloud.
137
+ # google.com/logging/docs/routing/managed-encryption) for more information.
138
138
  class CmekSettings
139
139
  include Google::Apis::Core::Hashable
140
140
 
141
141
  # The resource name for the configured Cloud KMS key.KMS key name format: "
142
142
  # projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]"
143
143
  # For example:"projects/my-project/locations/us-central1/keyRings/my-ring/
144
- # cryptoKeys/my-key"To enable CMEK for the Logs Router, set this field to a
145
- # valid kms_key_name for which the associated service account has the required
146
- # roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key.The Cloud
147
- # KMS key used by the Log Router can be updated by changing the kms_key_name to
148
- # a new valid key name. Encryption operations that are in progress will be
149
- # completed with the key that was in use when they started. Decryption
150
- # operations will be completed using the key that was used at the time of
151
- # encryption unless access to that key has been revoked.To disable CMEK for the
152
- # Logs Router, set this field to an empty string.See Enabling CMEK for Logs
153
- # Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for
154
- # more information.
144
+ # cryptoKeys/my-key"To enable CMEK for the Log Router, set this field to a valid
145
+ # kms_key_name for which the associated service account has the required
146
+ # cloudkms.cryptoKeyEncrypterDecrypter roles assigned for the key.The Cloud KMS
147
+ # key used by the Log Router can be updated by changing the kms_key_name to a
148
+ # new valid key name or disabled by setting the key name to an empty string.
149
+ # Encryption operations that are in progress will be completed with the key that
150
+ # was in use when they started. Decryption operations will be completed using
151
+ # the key that was used at the time of encryption unless access to that key has
152
+ # been revoked.To disable CMEK for the Log Router, set this field to an empty
153
+ # string.See Enabling CMEK for Log Router (https://cloud.google.com/logging/docs/
154
+ # routing/managed-encryption) for more information.
155
155
  # Corresponds to the JSON property `kmsKeyName`
156
156
  # @return [String]
157
157
  attr_accessor :kms_key_name
@@ -161,13 +161,12 @@ module Google
161
161
  # @return [String]
162
162
  attr_accessor :name
163
163
 
164
- # Output only. The service account that will be used by the Logs Router to
165
- # access your Cloud KMS key.Before enabling CMEK for Logs Router, you must first
166
- # assign the role roles/cloudkms.cryptoKeyEncrypterDecrypter to the service
167
- # account that the Logs Router will use to access your Cloud KMS key. Use
168
- # GetCmekSettings to obtain the service account ID.See Enabling CMEK for Logs
169
- # Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for
170
- # more information.
164
+ # Output only. The service account that will be used by the Log Router to access
165
+ # your Cloud KMS key.Before enabling CMEK for Log Router, you must first assign
166
+ # the cloudkms.cryptoKeyEncrypterDecrypter role to the service account that the
167
+ # Log Router will use to access your Cloud KMS key. Use GetCmekSettings to
168
+ # obtain the service account ID.See Enabling CMEK for Log Router (https://cloud.
169
+ # google.com/logging/docs/routing/managed-encryption) for more information.
171
170
  # Corresponds to the JSON property `serviceAccountId`
172
171
  # @return [String]
173
172
  attr_accessor :service_account_id
@@ -959,6 +958,16 @@ module Google
959
958
  class LogBucket
960
959
  include Google::Apis::Core::Hashable
961
960
 
961
+ # Describes the customer-managed encryption key (CMEK) settings associated with
962
+ # a project, folder, organization, billing account, or flexible resource.Note:
963
+ # CMEK for the Log Router can currently only be configured for Google Cloud
964
+ # organizations. Once configured, it applies to all projects and folders in the
965
+ # Google Cloud organization.See Enabling CMEK for Log Router (https://cloud.
966
+ # google.com/logging/docs/routing/managed-encryption) for more information.
967
+ # Corresponds to the JSON property `cmekSettings`
968
+ # @return [Google::Apis::LoggingV2::CmekSettings]
969
+ attr_accessor :cmek_settings
970
+
962
971
  # Output only. The creation timestamp of the bucket. This is not set for any of
963
972
  # the default buckets.
964
973
  # Corresponds to the JSON property `createTime`
@@ -1019,6 +1028,7 @@ module Google
1019
1028
 
1020
1029
  # Update properties of this object
1021
1030
  def update!(**args)
1031
+ @cmek_settings = args[:cmek_settings] if args.key?(:cmek_settings)
1022
1032
  @create_time = args[:create_time] if args.key?(:create_time)
1023
1033
  @description = args[:description] if args.key?(:description)
1024
1034
  @lifecycle_state = args[:lifecycle_state] if args.key?(:lifecycle_state)
@@ -1296,12 +1306,11 @@ module Google
1296
1306
  end
1297
1307
  end
1298
1308
 
1299
- # Specifies a set of log entries that are not to be stored in Cloud Logging. If
1300
- # your GCP resource receives a large volume of log entries, you can use
1301
- # exclusions to reduce your chargeable logs. Exclusions are processed after log
1302
- # sinks, so you can export log entries before they are excluded. Note that
1303
- # organization-level and folder-level exclusions don't apply to child resources,
1304
- # and that you can't exclude audit log entries.
1309
+ # Specifies a set of log entries that are filtered out by a sink. If your Google
1310
+ # Cloud resource receives a large volume of log entries, you can use exclusions
1311
+ # to reduce your chargeable logs. Note that exclusions on organization-level and
1312
+ # folder-level sinks don't apply to child resources. Note also that you cannot
1313
+ # modify the _Required sink or exclude logs from it.
1305
1314
  class LogExclusion
1306
1315
  include Google::Apis::Core::Hashable
1307
1316
 
@@ -1638,7 +1647,9 @@ module Google
1638
1647
  # iam/docs/granting-roles-to-service-accounts#
1639
1648
  # granting_access_to_a_service_account_for_a_resource). Consult the destination
1640
1649
  # service's documentation to determine the appropriate IAM roles to assign to
1641
- # the identity.
1650
+ # the identity.Sinks that have a destination that is a log bucket in the same
1651
+ # project as the sink do not have a writer_identity and no additional
1652
+ # permissions are required.
1642
1653
  # Corresponds to the JSON property `writerIdentity`
1643
1654
  # @return [String]
1644
1655
  attr_accessor :writer_identity
data/lib/google/apis/logging_v2/gem_version.rb CHANGED
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module LoggingV2
18
18
  # Version of the google-apis-logging_v2 gem
19
- GEM_VERSION = "0.15.0"
19
+ GEM_VERSION = "0.19.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.4.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20210922"
25
+ REVISION = "20211130"
26
26
  end
27
27
  end
28
28
  end
data/lib/google/apis/logging_v2/representations.rb CHANGED
@@ -563,6 +563,8 @@ module Google
563
563
  class LogBucket
564
564
  # @private
565
565
  class Representation < Google::Apis::Core::JsonRepresentation
566
+ property :cmek_settings, as: 'cmekSettings', class: Google::Apis::LoggingV2::CmekSettings, decorator: Google::Apis::LoggingV2::CmekSettings::Representation
567
+
566
568
  property :create_time, as: 'createTime'
567
569
  property :description, as: 'description'
568
570
  property :lifecycle_state, as: 'lifecycleState'
data/lib/google/apis/logging_v2/service.rb CHANGED
@@ -22,10 +22,7 @@ module Google
22
22
  module LoggingV2
23
23
  # Cloud Logging API
24
24
  #
25
- # Writes log entries and manages your Cloud Logging configuration. The table
26
- # entries below are presented in alphabetical order, not in order of common use.
27
- # For explanations of the concepts found in the table entries, read the
28
- # documentation at https://cloud.google.com/logging/docs.
25
+ # Writes log entries and manages your Cloud Logging configuration.
29
26
  #
30
27
  # @example
31
28
  # require 'google/apis/logging_v2'
@@ -52,6 +49,47 @@ module Google
52
49
  @batch_path = 'batch'
53
50
  end
54
51
 
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
55
+ # projects and folders in the Google Cloud organization.See Enabling CMEK for
56
+ # Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption)
57
+ # for more information.
58
+ # @param [String] name
59
+ # Required. The resource for which to retrieve CMEK settings. "projects/[
60
+ # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
61
+ # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
62
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
63
+ # Log Router can be configured for Google Cloud projects, folders, organizations
64
+ # and billing accounts. Once configured for an organization, it applies to all
65
+ # projects and folders in the Google Cloud organization.
66
+ # @param [String] fields
67
+ # Selector specifying which fields to include in a partial response.
68
+ # @param [String] quota_user
69
+ # Available to use for quota purposes for server-side applications. Can be any
70
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
71
+ # @param [Google::Apis::RequestOptions] options
72
+ # Request-specific options
73
+ #
74
+ # @yield [result, err] Result & error if block supplied
75
+ # @yieldparam result [Google::Apis::LoggingV2::CmekSettings] parsed result object
76
+ # @yieldparam err [StandardError] error object if request failed
77
+ #
78
+ # @return [Google::Apis::LoggingV2::CmekSettings]
79
+ #
80
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
81
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
82
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
83
+ def get_billing_account_cmek_settings(name, fields: nil, quota_user: nil, options: nil, &block)
84
+ command = make_simple_command(:get, 'v2/{+name}/cmekSettings', options)
85
+ command.response_representation = Google::Apis::LoggingV2::CmekSettings::Representation
86
+ command.response_class = Google::Apis::LoggingV2::CmekSettings
87
+ command.params['name'] = name unless name.nil?
88
+ command.query['fields'] = fields unless fields.nil?
89
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
90
+ execute_or_queue_command(command, &block)
91
+ end
92
+
55
93
  # Gets a log bucket.
56
94
  # @param [String] name
57
95
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
@@ -119,9 +157,9 @@ module Google
119
157
  execute_or_queue_command(command, &block)
120
158
  end
121
159
 
122
- # Creates a new exclusion in a specified parent resource. Only log entries
123
- # belonging to that resource can be excluded. You can have up to 10 exclusions
124
- # in a resource.
160
+ # Creates a new exclusion in the _Default sink in a specified parent resource.
161
+ # Only log entries belonging to that resource can be excluded. You can have up
162
+ # to 10 exclusions in a resource.
125
163
  # @param [String] parent
126
164
  # Required. The parent resource in which to create the exclusion: "projects/[
127
165
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -157,7 +195,7 @@ module Google
157
195
  execute_or_queue_command(command, &block)
158
196
  end
159
197
 
160
- # Deletes an exclusion.
198
+ # Deletes an exclusion in the _Default sink.
161
199
  # @param [String] name
162
200
  # Required. The resource name of an existing exclusion to delete: "projects/[
163
201
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -191,7 +229,7 @@ module Google
191
229
  execute_or_queue_command(command, &block)
192
230
  end
193
231
 
194
- # Gets the description of an exclusion.
232
+ # Gets the description of an exclusion in the _Default sink.
195
233
  # @param [String] name
196
234
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
197
235
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
@@ -225,7 +263,7 @@ module Google
225
263
  execute_or_queue_command(command, &block)
226
264
  end
227
265
 
228
- # Lists all the exclusions in a parent resource.
266
+ # Lists all the exclusions on the _Default sink in a parent resource.
229
267
  # @param [String] parent
230
268
  # Required. The parent resource whose exclusions are to be listed. "projects/[
231
269
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -268,7 +306,7 @@ module Google
268
306
  execute_or_queue_command(command, &block)
269
307
  end
270
308
 
271
- # Changes one or more properties of an existing exclusion.
309
+ # Changes one or more properties of an existing exclusion in the _Default sink.
272
310
  # @param [String] name
273
311
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
274
312
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
@@ -1377,9 +1415,9 @@ module Google
1377
1415
  execute_or_queue_command(command, &block)
1378
1416
  end
1379
1417
 
1380
- # Creates a new exclusion in a specified parent resource. Only log entries
1381
- # belonging to that resource can be excluded. You can have up to 10 exclusions
1382
- # in a resource.
1418
+ # Creates a new exclusion in the _Default sink in a specified parent resource.
1419
+ # Only log entries belonging to that resource can be excluded. You can have up
1420
+ # to 10 exclusions in a resource.
1383
1421
  # @param [String] parent
1384
1422
  # Required. The parent resource in which to create the exclusion: "projects/[
1385
1423
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -1415,7 +1453,7 @@ module Google
1415
1453
  execute_or_queue_command(command, &block)
1416
1454
  end
1417
1455
 
1418
- # Deletes an exclusion.
1456
+ # Deletes an exclusion in the _Default sink.
1419
1457
  # @param [String] name
1420
1458
  # Required. The resource name of an existing exclusion to delete: "projects/[
1421
1459
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -1449,7 +1487,7 @@ module Google
1449
1487
  execute_or_queue_command(command, &block)
1450
1488
  end
1451
1489
 
1452
- # Gets the description of an exclusion.
1490
+ # Gets the description of an exclusion in the _Default sink.
1453
1491
  # @param [String] name
1454
1492
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
1455
1493
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
@@ -1483,7 +1521,7 @@ module Google
1483
1521
  execute_or_queue_command(command, &block)
1484
1522
  end
1485
1523
 
1486
- # Lists all the exclusions in a parent resource.
1524
+ # Lists all the exclusions on the _Default sink in a parent resource.
1487
1525
  # @param [String] parent
1488
1526
  # Required. The parent resource whose exclusions are to be listed. "projects/[
1489
1527
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -1526,7 +1564,7 @@ module Google
1526
1564
  execute_or_queue_command(command, &block)
1527
1565
  end
1528
1566
 
1529
- # Changes one or more properties of an existing exclusion.
1567
+ # Changes one or more properties of an existing exclusion in the _Default sink.
1530
1568
  # @param [String] name
1531
1569
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
1532
1570
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
@@ -1571,9 +1609,50 @@ module Google
1571
1609
  execute_or_queue_command(command, &block)
1572
1610
  end
1573
1611
 
1574
- # Creates a new exclusion in a specified parent resource. Only log entries
1575
- # belonging to that resource can be excluded. You can have up to 10 exclusions
1576
- # in a resource.
1612
+ # Gets the Logging CMEK settings for the given resource.Note: CMEK for the Log
1613
+ # Router can be configured for Google Cloud projects, folders, organizations and
1614
+ # billing accounts. Once configured for an organization, it applies to all
1615
+ # projects and folders in the Google Cloud organization.See Enabling CMEK for
1616
+ # Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption)
1617
+ # for more information.
1618
+ # @param [String] name
1619
+ # Required. The resource for which to retrieve CMEK settings. "projects/[
1620
+ # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
1621
+ # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
1622
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
1623
+ # Log Router can be configured for Google Cloud projects, folders, organizations
1624
+ # and billing accounts. Once configured for an organization, it applies to all
1625
+ # projects and folders in the Google Cloud organization.
1626
+ # @param [String] fields
1627
+ # Selector specifying which fields to include in a partial response.
1628
+ # @param [String] quota_user
1629
+ # Available to use for quota purposes for server-side applications. Can be any
1630
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1631
+ # @param [Google::Apis::RequestOptions] options
1632
+ # Request-specific options
1633
+ #
1634
+ # @yield [result, err] Result & error if block supplied
1635
+ # @yieldparam result [Google::Apis::LoggingV2::CmekSettings] parsed result object
1636
+ # @yieldparam err [StandardError] error object if request failed
1637
+ #
1638
+ # @return [Google::Apis::LoggingV2::CmekSettings]
1639
+ #
1640
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1641
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1642
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1643
+ def get_folder_cmek_settings(name, fields: nil, quota_user: nil, options: nil, &block)
1644
+ command = make_simple_command(:get, 'v2/{+name}/cmekSettings', options)
1645
+ command.response_representation = Google::Apis::LoggingV2::CmekSettings::Representation
1646
+ command.response_class = Google::Apis::LoggingV2::CmekSettings
1647
+ command.params['name'] = name unless name.nil?
1648
+ command.query['fields'] = fields unless fields.nil?
1649
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1650
+ execute_or_queue_command(command, &block)
1651
+ end
1652
+
1653
+ # Creates a new exclusion in the _Default sink in a specified parent resource.
1654
+ # Only log entries belonging to that resource can be excluded. You can have up
1655
+ # to 10 exclusions in a resource.
1577
1656
  # @param [String] parent
1578
1657
  # Required. The parent resource in which to create the exclusion: "projects/[
1579
1658
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -1609,7 +1688,7 @@ module Google
1609
1688
  execute_or_queue_command(command, &block)
1610
1689
  end
1611
1690
 
1612
- # Deletes an exclusion.
1691
+ # Deletes an exclusion in the _Default sink.
1613
1692
  # @param [String] name
1614
1693
  # Required. The resource name of an existing exclusion to delete: "projects/[
1615
1694
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -1643,7 +1722,7 @@ module Google
1643
1722
  execute_or_queue_command(command, &block)
1644
1723
  end
1645
1724
 
1646
- # Gets the description of an exclusion.
1725
+ # Gets the description of an exclusion in the _Default sink.
1647
1726
  # @param [String] name
1648
1727
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
1649
1728
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
@@ -1677,7 +1756,7 @@ module Google
1677
1756
  execute_or_queue_command(command, &block)
1678
1757
  end
1679
1758
 
1680
- # Lists all the exclusions in a parent resource.
1759
+ # Lists all the exclusions on the _Default sink in a parent resource.
1681
1760
  # @param [String] parent
1682
1761
  # Required. The parent resource whose exclusions are to be listed. "projects/[
1683
1762
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -1720,7 +1799,7 @@ module Google
1720
1799
  execute_or_queue_command(command, &block)
1721
1800
  end
1722
1801
 
1723
- # Changes one or more properties of an existing exclusion.
1802
+ # Changes one or more properties of an existing exclusion in the _Default sink.
1724
1803
  # @param [String] name
1725
1804
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
1726
1805
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
@@ -3530,18 +3609,20 @@ module Google
3530
3609
  execute_or_queue_command(command, &block)
3531
3610
  end
3532
3611
 
3533
- # Gets the Logs Router CMEK settings for the given resource.Note: CMEK for the
3534
- # Logs Router can currently only be configured for GCP organizations. Once
3535
- # configured, it applies to all projects and folders in the GCP organization.See
3536
- # Enabling CMEK for Logs Router (https://cloud.google.com/logging/docs/routing/
3537
- # managed-encryption) for more information.
3612
+ # Gets the Logging CMEK settings for the given resource.Note: CMEK for the Log
3613
+ # Router can be configured for Google Cloud projects, folders, organizations and
3614
+ # billing accounts. Once configured for an organization, it applies to all
3615
+ # projects and folders in the Google Cloud organization.See Enabling CMEK for
3616
+ # Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption)
3617
+ # for more information.
3538
3618
  # @param [String] name
3539
3619
  # Required. The resource for which to retrieve CMEK settings. "projects/[
3540
3620
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
3541
3621
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
3542
3622
  # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
3543
- # Logs Router can currently only be configured for GCP organizations. Once
3544
- # configured, it applies to all projects and folders in the GCP organization.
3623
+ # Log Router can be configured for Google Cloud projects, folders, organizations
3624
+ # and billing accounts. Once configured for an organization, it applies to all
3625
+ # projects and folders in the Google Cloud organization.
3545
3626
  # @param [String] fields
3546
3627
  # Selector specifying which fields to include in a partial response.
3547
3628
  # @param [String] quota_user
@@ -3569,21 +3650,22 @@ module Google
3569
3650
  execute_or_queue_command(command, &block)
3570
3651
  end
3571
3652
 
3572
- # Updates the Logs Router CMEK settings for the given resource.Note: CMEK for
3573
- # the Logs Router can currently only be configured for GCP organizations. Once
3574
- # configured, it applies to all projects and folders in the GCP organization.
3575
- # UpdateCmekSettings will fail if 1) kms_key_name is invalid, or 2) the
3576
- # associated service account does not have the required roles/cloudkms.
3653
+ # Updates the Log Router CMEK settings for the given resource.Note: CMEK for the
3654
+ # Log Router can currently only be configured for Google Cloud organizations.
3655
+ # Once configured, it applies to all projects and folders in the Google Cloud
3656
+ # organization.UpdateCmekSettings will fail if 1) kms_key_name is invalid, or 2)
3657
+ # the associated service account does not have the required roles/cloudkms.
3577
3658
  # cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key
3578
- # is disabled.See Enabling CMEK for Logs Router (https://cloud.google.com/
3579
- # logging/docs/routing/managed-encryption) for more information.
3659
+ # is disabled.See Enabling CMEK for Log Router (https://cloud.google.com/logging/
3660
+ # docs/routing/managed-encryption) for more information.
3580
3661
  # @param [String] name
3581
3662
  # Required. The resource name for the CMEK settings to update. "projects/[
3582
3663
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
3583
3664
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
3584
3665
  # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
3585
- # Logs Router can currently only be configured for GCP organizations. Once
3586
- # configured, it applies to all projects and folders in the GCP organization.
3666
+ # Log Router can currently only be configured for Google Cloud organizations.
3667
+ # Once configured, it applies to all projects and folders in the Google Cloud
3668
+ # organization.
3587
3669
  # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
3588
3670
  # @param [String] update_mask
3589
3671
  # Optional. Field mask identifying which fields from cmek_settings should be
@@ -3620,9 +3702,9 @@ module Google
3620
3702
  execute_or_queue_command(command, &block)
3621
3703
  end
3622
3704
 
3623
- # Creates a new exclusion in a specified parent resource. Only log entries
3624
- # belonging to that resource can be excluded. You can have up to 10 exclusions
3625
- # in a resource.
3705
+ # Creates a new exclusion in the _Default sink in a specified parent resource.
3706
+ # Only log entries belonging to that resource can be excluded. You can have up
3707
+ # to 10 exclusions in a resource.
3626
3708
  # @param [String] parent
3627
3709
  # Required. The parent resource in which to create the exclusion: "projects/[
3628
3710
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -3658,7 +3740,7 @@ module Google
3658
3740
  execute_or_queue_command(command, &block)
3659
3741
  end
3660
3742
 
3661
- # Deletes an exclusion.
3743
+ # Deletes an exclusion in the _Default sink.
3662
3744
  # @param [String] name
3663
3745
  # Required. The resource name of an existing exclusion to delete: "projects/[
3664
3746
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -3692,7 +3774,7 @@ module Google
3692
3774
  execute_or_queue_command(command, &block)
3693
3775
  end
3694
3776
 
3695
- # Gets the description of an exclusion.
3777
+ # Gets the description of an exclusion in the _Default sink.
3696
3778
  # @param [String] name
3697
3779
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
3698
3780
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
@@ -3726,7 +3808,7 @@ module Google
3726
3808
  execute_or_queue_command(command, &block)
3727
3809
  end
3728
3810
 
3729
- # Lists all the exclusions in a parent resource.
3811
+ # Lists all the exclusions on the _Default sink in a parent resource.
3730
3812
  # @param [String] parent
3731
3813
  # Required. The parent resource whose exclusions are to be listed. "projects/[
3732
3814
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -3769,7 +3851,7 @@ module Google
3769
3851
  execute_or_queue_command(command, &block)
3770
3852
  end
3771
3853
 
3772
- # Changes one or more properties of an existing exclusion.
3854
+ # Changes one or more properties of an existing exclusion in the _Default sink.
3773
3855
  # @param [String] name
3774
3856
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
3775
3857
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
@@ -4818,9 +4900,50 @@ module Google
4818
4900
  execute_or_queue_command(command, &block)
4819
4901
  end
4820
4902
 
4821
- # Creates a new exclusion in a specified parent resource. Only log entries
4822
- # belonging to that resource can be excluded. You can have up to 10 exclusions
4823
- # in a resource.
4903
+ # Gets the Logging CMEK settings for the given resource.Note: CMEK for the Log
4904
+ # Router can be configured for Google Cloud projects, folders, organizations and
4905
+ # billing accounts. Once configured for an organization, it applies to all
4906
+ # projects and folders in the Google Cloud organization.See Enabling CMEK for
4907
+ # Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption)
4908
+ # for more information.
4909
+ # @param [String] name
4910
+ # Required. The resource for which to retrieve CMEK settings. "projects/[
4911
+ # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
4912
+ # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
4913
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
4914
+ # Log Router can be configured for Google Cloud projects, folders, organizations
4915
+ # and billing accounts. Once configured for an organization, it applies to all
4916
+ # projects and folders in the Google Cloud organization.
4917
+ # @param [String] fields
4918
+ # Selector specifying which fields to include in a partial response.
4919
+ # @param [String] quota_user
4920
+ # Available to use for quota purposes for server-side applications. Can be any
4921
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4922
+ # @param [Google::Apis::RequestOptions] options
4923
+ # Request-specific options
4924
+ #
4925
+ # @yield [result, err] Result & error if block supplied
4926
+ # @yieldparam result [Google::Apis::LoggingV2::CmekSettings] parsed result object
4927
+ # @yieldparam err [StandardError] error object if request failed
4928
+ #
4929
+ # @return [Google::Apis::LoggingV2::CmekSettings]
4930
+ #
4931
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4932
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4933
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4934
+ def get_project_cmek_settings(name, fields: nil, quota_user: nil, options: nil, &block)
4935
+ command = make_simple_command(:get, 'v2/{+name}/cmekSettings', options)
4936
+ command.response_representation = Google::Apis::LoggingV2::CmekSettings::Representation
4937
+ command.response_class = Google::Apis::LoggingV2::CmekSettings
4938
+ command.params['name'] = name unless name.nil?
4939
+ command.query['fields'] = fields unless fields.nil?
4940
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4941
+ execute_or_queue_command(command, &block)
4942
+ end
4943
+
4944
+ # Creates a new exclusion in the _Default sink in a specified parent resource.
4945
+ # Only log entries belonging to that resource can be excluded. You can have up
4946
+ # to 10 exclusions in a resource.
4824
4947
  # @param [String] parent
4825
4948
  # Required. The parent resource in which to create the exclusion: "projects/[
4826
4949
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -4856,7 +4979,7 @@ module Google
4856
4979
  execute_or_queue_command(command, &block)
4857
4980
  end
4858
4981
 
4859
- # Deletes an exclusion.
4982
+ # Deletes an exclusion in the _Default sink.
4860
4983
  # @param [String] name
4861
4984
  # Required. The resource name of an existing exclusion to delete: "projects/[
4862
4985
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -4890,7 +5013,7 @@ module Google
4890
5013
  execute_or_queue_command(command, &block)
4891
5014
  end
4892
5015
 
4893
- # Gets the description of an exclusion.
5016
+ # Gets the description of an exclusion in the _Default sink.
4894
5017
  # @param [String] name
4895
5018
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
4896
5019
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
@@ -4924,7 +5047,7 @@ module Google
4924
5047
  execute_or_queue_command(command, &block)
4925
5048
  end
4926
5049
 
4927
- # Lists all the exclusions in a parent resource.
5050
+ # Lists all the exclusions on the _Default sink in a parent resource.
4928
5051
  # @param [String] parent
4929
5052
  # Required. The parent resource whose exclusions are to be listed. "projects/[
4930
5053
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -4967,7 +5090,7 @@ module Google
4967
5090
  execute_or_queue_command(command, &block)
4968
5091
  end
4969
5092
 
4970
- # Changes one or more properties of an existing exclusion.
5093
+ # Changes one or more properties of an existing exclusion in the _Default sink.
4971
5094
  # @param [String] name
4972
5095
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
4973
5096
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
@@ -6411,18 +6534,20 @@ module Google
6411
6534
  execute_or_queue_command(command, &block)
6412
6535
  end
6413
6536
 
6414
- # Gets the Logs Router CMEK settings for the given resource.Note: CMEK for the
6415
- # Logs Router can currently only be configured for GCP organizations. Once
6416
- # configured, it applies to all projects and folders in the GCP organization.See
6417
- # Enabling CMEK for Logs Router (https://cloud.google.com/logging/docs/routing/
6418
- # managed-encryption) for more information.
6537
+ # Gets the Logging CMEK settings for the given resource.Note: CMEK for the Log
6538
+ # Router can be configured for Google Cloud projects, folders, organizations and
6539
+ # billing accounts. Once configured for an organization, it applies to all
6540
+ # projects and folders in the Google Cloud organization.See Enabling CMEK for
6541
+ # Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption)
6542
+ # for more information.
6419
6543
  # @param [String] name
6420
6544
  # Required. The resource for which to retrieve CMEK settings. "projects/[
6421
6545
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
6422
6546
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
6423
6547
  # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
6424
- # Logs Router can currently only be configured for GCP organizations. Once
6425
- # configured, it applies to all projects and folders in the GCP organization.
6548
+ # Log Router can be configured for Google Cloud projects, folders, organizations
6549
+ # and billing accounts. Once configured for an organization, it applies to all
6550
+ # projects and folders in the Google Cloud organization.
6426
6551
  # @param [String] fields
6427
6552
  # Selector specifying which fields to include in a partial response.
6428
6553
  # @param [String] quota_user
@@ -6450,21 +6575,22 @@ module Google
6450
6575
  execute_or_queue_command(command, &block)
6451
6576
  end
6452
6577
 
6453
- # Updates the Logs Router CMEK settings for the given resource.Note: CMEK for
6454
- # the Logs Router can currently only be configured for GCP organizations. Once
6455
- # configured, it applies to all projects and folders in the GCP organization.
6456
- # UpdateCmekSettings will fail if 1) kms_key_name is invalid, or 2) the
6457
- # associated service account does not have the required roles/cloudkms.
6578
+ # Updates the Log Router CMEK settings for the given resource.Note: CMEK for the
6579
+ # Log Router can currently only be configured for Google Cloud organizations.
6580
+ # Once configured, it applies to all projects and folders in the Google Cloud
6581
+ # organization.UpdateCmekSettings will fail if 1) kms_key_name is invalid, or 2)
6582
+ # the associated service account does not have the required roles/cloudkms.
6458
6583
  # cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key
6459
- # is disabled.See Enabling CMEK for Logs Router (https://cloud.google.com/
6460
- # logging/docs/routing/managed-encryption) for more information.
6584
+ # is disabled.See Enabling CMEK for Log Router (https://cloud.google.com/logging/
6585
+ # docs/routing/managed-encryption) for more information.
6461
6586
  # @param [String] name
6462
6587
  # Required. The resource name for the CMEK settings to update. "projects/[
6463
6588
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
6464
6589
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
6465
6590
  # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
6466
- # Logs Router can currently only be configured for GCP organizations. Once
6467
- # configured, it applies to all projects and folders in the GCP organization.
6591
+ # Log Router can currently only be configured for Google Cloud organizations.
6592
+ # Once configured, it applies to all projects and folders in the Google Cloud
6593
+ # organization.
6468
6594
  # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
6469
6595
  # @param [String] update_mask
6470
6596
  # Optional. Field mask identifying which fields from cmek_settings should be
data/lib/google/apis/logging_v2.rb CHANGED
@@ -21,10 +21,7 @@ module Google
21
21
  module Apis
22
22
  # Cloud Logging API
23
23
  #
24
- # Writes log entries and manages your Cloud Logging configuration. The table
25
- # entries below are presented in alphabetical order, not in order of common use.
26
- # For explanations of the concepts found in the table entries, read the
27
- # documentation at https://cloud.google.com/logging/docs.
24
+ # Writes log entries and manages your Cloud Logging configuration.
28
25
  #
29
26
  # @see https://cloud.google.com/logging/docs/
30
27
  module LoggingV2
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-logging_v2
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.15.0
4
+ version: 0.19.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-10-04 00:00:00.000000000 Z
11
+ date: 2021-12-13 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -57,9 +57,9 @@ licenses:
57
57
  - Apache-2.0
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
- changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-logging_v2/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-logging_v2/v0.15.0
62
- source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-logging_v2
60
+ changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-logging_v2/CHANGELOG.md
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-logging_v2/v0.19.0
62
+ source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-logging_v2
63
63
  post_install_message:
64
64
  rdoc_options: []
65
65
  require_paths: