google-apis-logging_v2 0.13.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df9f8ca0a53cee762ccb82941421bfa6c510b70e600fa05d49b9d29ac32333b5
-  data.tar.gz: b9fc3a0b5418248ee4b23ec144cc4c1f0267bb5f832087254938f4bb58c03dfe
+  metadata.gz: 2454c651ce51159190a0c3450909bc39c02469aece9a6c8ed1d82ef898a9d8d1
+  data.tar.gz: e03a7292f079132b2bc01c1d7262097079793a8e9c9ba10ff59ac96d9b20fbcc
 SHA512:
-  metadata.gz: e1dcd65c66e1e16df10af24c2dc3abb12aef52b2229f44e360c08e4aa117a356f4fd3713923dc2a89772e05cae5a9adc1f260c0c0142a9afd8cc600a6d7b0a2c
-  data.tar.gz: fd7512b3ac18a50e5596a1d28b2805b9eb5fb1a2e64b9a2d5c04d0665b89032a9c2cdec609e93ba85bf49add50ebaff31a49a6cf71325cba9ebf173c6bb94f8f
+  metadata.gz: 3eeef64377ec68b5fe7243cf60dad887f8b976f882e71815a86e85a9125def62db51572cff43e4429ba7f7d178340a6f7f06ae0c944409539c6776fc4241bed0
+  data.tar.gz: 9883c27385dcb3a4f717c67db5c8238399261a7c3ce8595941ae064d51a06e2373194037bb99878f4f4272c44bfa54dfbf2bbfc5a70d8bf6102f8adf02ae76f3

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Release history for google-apis-logging_v2
 
+### v0.17.0 (2021-11-02)
+
+* Regenerated from discovery document revision 20211019
+
+### v0.16.0 (2021-10-26)
+
+* Regenerated from discovery document revision 20211015
+* Unspecified changes
+
+### v0.15.0 (2021-10-02)
+
+* Regenerated from discovery document revision 20210922
+
+### v0.14.0 (2021-09-01)
+
+* Regenerated from discovery document revision 20210817
+
 ### v0.13.0 (2021-07-16)
 
 * Regenerated from discovery document revision 20210709

data/OVERVIEW.md

@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
 
 More detailed descriptions of the Google simple REST clients are available in two documents.
 
- *  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.
- *  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.
+ *  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.
+ *  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.
 
 (Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Logging service in particular.)
 

data/lib/google/apis/logging_v2/classes.rb

@@ -27,18 +27,19 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. Whether to use BigQuery's partition tables (https://cloud.google.com/
-        # bigquery/docs/partitioned-tables). By default, Logging creates dated tables
-        # based on the log entries' timestamps, e.g. syslog_20170523. With partitioned
-        # tables the date suffix is no longer present and special query syntax (https://
-        # cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used
-        # instead. In both cases, tables are sharded based on UTC timezone.
+        # bigquery/docs/partitioned-tables). By default, Cloud Logging creates dated
+        # tables based on the log entries' timestamps, e.g. syslog_20170523. With
+        # partitioned tables the date suffix is no longer present and special query
+        # syntax (https://cloud.google.com/bigquery/docs/querying-partitioned-tables)
+        # has to be used instead. In both cases, tables are sharded based on UTC
+        # timezone.
         # Corresponds to the JSON property `usePartitionedTables`
         # @return [Boolean]
         attr_accessor :use_partitioned_tables
         alias_method :use_partitioned_tables?, :use_partitioned_tables
       
         # Output only. True if new timestamp column based partitioning is in use, false
-        # if legacy ingestion-time partitioning is in use. All new sinks will have this
+        # if legacy ingestion-time partitioning is in use.All new sinks will have this
         # field set true and will use timestamp column based partitioning. If
         # use_partitioned_tables is false, this value has no meaning and will be false.
         # Legacy sinks using partitioned tables will have this field set to false.
@@ -130,27 +131,27 @@ module Google
       
       # Describes the customer-managed encryption key (CMEK) settings associated with
       # a project, folder, organization, billing account, or flexible resource.Note:
-      # CMEK for the Logs Router can currently only be configured for GCP
+      # CMEK for the Logs Router can currently only be configured for Google Cloud
       # organizations. Once configured, it applies to all projects and folders in the
-      # GCP organization.See Enabling CMEK for Logs Router (https://cloud.google.com/
-      # logging/docs/routing/managed-encryption) for more information.
+      # Google Cloud organization.See Enabling CMEK for Logs Router (https://cloud.
+      # google.com/logging/docs/routing/managed-encryption) for more information.
       class CmekSettings
         include Google::Apis::Core::Hashable
       
         # The resource name for the configured Cloud KMS key.KMS key name format: "
-        # projects/PROJECT_ID/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY"For
-        # example: "projects/my-project-id/locations/my-region/keyRings/key-ring-name/
-        # cryptoKeys/key-name"To enable CMEK for the Logs Router, set this field to a
+        # projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]"
+        # For example:"projects/my-project/locations/us-central1/keyRings/my-ring/
+        # cryptoKeys/my-key"To enable CMEK for the Logs Router, set this field to a
         # valid kms_key_name for which the associated service account has the required
-        # roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key.The Cloud
-        # KMS key used by the Log Router can be updated by changing the kms_key_name to
-        # a new valid key name. Encryption operations that are in progress will be
-        # completed with the key that was in use when they started. Decryption
-        # operations will be completed using the key that was used at the time of
-        # encryption unless access to that key has been revoked.To disable CMEK for the
-        # Logs Router, set this field to an empty string.See Enabling CMEK for Logs
-        # Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for
-        # more information.
+        # cloudkms.cryptoKeyEncrypterDecrypter roles assigned for the key.The Cloud KMS
+        # key used by the Log Router can be updated by changing the kms_key_name to a
+        # new valid key name or disabled by setting the key name to an empty string.
+        # Encryption operations that are in progress will be completed with the key that
+        # was in use when they started. Decryption operations will be completed using
+        # the key that was used at the time of encryption unless access to that key has
+        # been revoked.To disable CMEK for the Logs Router, set this field to an empty
+        # string.See Enabling CMEK for Logs Router (https://cloud.google.com/logging/
+        # docs/routing/managed-encryption) for more information.
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
         attr_accessor :kms_key_name
@@ -162,8 +163,8 @@ module Google
       
         # Output only. The service account that will be used by the Logs Router to
         # access your Cloud KMS key.Before enabling CMEK for Logs Router, you must first
-        # assign the role roles/cloudkms.cryptoKeyEncrypterDecrypter to the service
-        # account that the Logs Router will use to access your Cloud KMS key. Use
+        # assign the cloudkms.cryptoKeyEncrypterDecrypter role to the service account
+        # that the Logs Router will use to access your Cloud KMS key. Use
         # GetCmekSettings to obtain the service account ID.See Enabling CMEK for Logs
         # Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for
         # more information.
@@ -219,8 +220,8 @@ module Google
         attr_accessor :state
       
         # The IAM identity of a service account that must be granted access to the
-        # destination. If the service account is not granted permission to the
-        # destination within an hour, the operation will be cancelled. Example: "
+        # destination.If the service account is not granted permission to the
+        # destination within an hour, the operation will be cancelled.For example: "
         # serviceAccount:foo@bar.com"
         # Corresponds to the JSON property `writerIdentity`
         # @return [String]
@@ -246,7 +247,7 @@ module Google
       class CopyLogEntriesRequest
         include Google::Apis::Core::Hashable
       
-        # Required. Destination to which to copy logs.
+        # Required. Destination to which to copy log entries.
         # Corresponds to the JSON property `destination`
         # @return [String]
         attr_accessor :destination
@@ -257,8 +258,8 @@ module Google
         # @return [String]
         attr_accessor :filter
       
-        # Required. Bucket from which to copy logs. e.g. "projects/my-project/locations/
-        # my-location/buckets/my-source-bucket
+        # Required. Log bucket from which to copy log entries.For example:"projects/my-
+        # project/locations/global/buckets/my-source-bucket"
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -954,7 +955,7 @@ module Google
         end
       end
       
-      # Describes a repository of logs.
+      # Describes a repository in which log entries are stored.
       class LogBucket
         include Google::Apis::Core::Hashable
       
@@ -974,27 +975,27 @@ module Google
         # @return [String]
         attr_accessor :lifecycle_state
       
-        # Whether the bucket has been locked. The retention period on a locked bucket
-        # may not be changed. Locked buckets may only be deleted if they are empty.
+        # Whether the bucket is locked.The retention period on a locked bucket cannot be
+        # changed. Locked buckets may only be deleted if they are empty.
         # Corresponds to the JSON property `locked`
         # @return [Boolean]
         attr_accessor :locked
         alias_method :locked?, :locked
       
-        # Output only. The resource name of the bucket. For example: "projects/my-
-        # project-id/locations/my-location/buckets/my-bucket-id" The supported locations
-        # are: global, us-central1, us-east1, us-west1, asia-east1, europe-west1.For the
-        # location of global it is unspecified where logs are actually stored. Once a
-        # bucket has been created, the location can not be changed.
+        # Output only. The resource name of the bucket.For example:projects/my-project/
+        # locations/global/buckets/my-bucketFor a list of supported locations, see
+        # Supported Regions (https://cloud.google.com/logging/docs/region-support)For
+        # the location of global it is unspecified where log entries are actually stored.
+        # After a bucket has been created, the location cannot be changed.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Log entry field paths that are denied access in this bucket. The following
+        # Log entry field paths that are denied access in this bucket.The following
         # fields and their children are eligible: textPayload, jsonPayload, protoPayload,
-        # httpRequest, labels, sourceLocation. Restricting a repeated field will
-        # restrict all values. Adding a parent will block all child fields e.g. foo.bar
-        # will block foo.bar.baz.
+        # httpRequest, labels, sourceLocation.Restricting a repeated field will
+        # restrict all values. Adding a parent will block all child fields. (e.g. foo.
+        # bar will block foo.bar.baz)
         # Corresponds to the JSON property `restrictedFields`
         # @return [Array<String>]
         attr_accessor :restricted_fields
@@ -1295,12 +1296,11 @@ module Google
         end
       end
       
-      # Specifies a set of log entries that are not to be stored in Logging. If your
-      # GCP resource receives a large volume of logs, you can use exclusions to reduce
-      # your chargeable logs. Exclusions are processed after log sinks, so you can
-      # export log entries before they are excluded. Note that organization-level and
-      # folder-level exclusions don't apply to child resources, and that you can't
-      # exclude audit log entries.
+      # Specifies a set of log entries that are filtered out by a sink. If your Google
+      # Cloud resource receives a large volume of log entries, you can use exclusions
+      # to reduce your chargeable logs. Note that exclusions on organization-level and
+      # folder-level sinks don't apply to child resources. Note also that you cannot
+      # modify the _Required sink or exclude logs from it.
       class LogExclusion
         include Google::Apis::Core::Hashable
       
@@ -1326,10 +1326,10 @@ module Google
         # Required. An advanced logs filter (https://cloud.google.com/logging/docs/view/
         # advanced-queries) that matches the log entries to be excluded. By using the
         # sample function (https://cloud.google.com/logging/docs/view/advanced-queries#
-        # sample), you can exclude less than 100% of the matching log entries. For
+        # sample), you can exclude less than 100% of the matching log entries.For
         # example, the following query matches 99% of low-severity log entries from
-        # Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(
-        # insertId, 0.99)"
+        # Google Cloud Storage buckets:resource.type=gcs_bucket severity<ERROR sample(
+        # insertId, 0.99)
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -1535,10 +1535,10 @@ module Google
       end
       
       # Describes a sink used to export log entries to one of the following
-      # destinations in any project: a Cloud Storage bucket, a BigQuery dataset, a
-      # Cloud Pub/Sub topic or a Cloud Logging Bucket. A logs filter controls which
-      # log entries are exported. The sink must be created within a project,
-      # organization, billing account, or folder.
+      # destinations in any project: a Cloud Storage bucket, a BigQuery dataset, a Pub/
+      # Sub topic or a Cloud Logging log bucket. A logs filter controls which log
+      # entries are exported. The sink must be created within a project, organization,
+      # billing account, or folder.
       class LogSink
         include Google::Apis::Core::Hashable
       
@@ -1553,7 +1553,7 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # Optional. A description of this sink. The maximum length of the description is
+        # Optional. A description of this sink.The maximum length of the description is
         # 8000 characters.
         # Corresponds to the JSON property `description`
         # @return [String]
@@ -1570,23 +1570,23 @@ module Google
         # @return [String]
         attr_accessor :destination
       
-        # Optional. If set to True, then this sink is disabled and it does not export
+        # Optional. If set to true, then this sink is disabled and it does not export
         # any log entries.
         # Corresponds to the JSON property `disabled`
         # @return [Boolean]
         attr_accessor :disabled
         alias_method :disabled?, :disabled
       
-        # Optional. Log entries that match any of the exclusion filters will not be
-        # exported. If a log entry is matched by both filter and one of
-        # exclusion_filters it will not be exported.
+        # Optional. Log entries that match any of these exclusion filters will not be
+        # exported.If a log entry is matched by both filter and one of exclusion_filters
+        # it will not be exported.
         # Corresponds to the JSON property `exclusions`
         # @return [Array<Google::Apis::LoggingV2::LogExclusion>]
         attr_accessor :exclusions
       
         # Optional. An advanced logs filter (https://cloud.google.com/logging/docs/view/
         # advanced-queries). The only exported log entries are those that are in the
-        # resource owning the sink and that match the filter. For example: logName="
+        # resource owning the sink and that match the filter.For example:logName="
         # projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
         # Corresponds to the JSON property `filter`
         # @return [String]
@@ -1594,22 +1594,22 @@ module Google
       
         # Optional. This field applies only to sinks owned by organizations and folders.
         # If the field is false, the default, only the logs owned by the sink's parent
-        # resource are available for export. If the field is true, then logs from all
-        # the projects, folders, and billing accounts contained in the sink's parent
+        # resource are available for export. If the field is true, then log entries from
+        # all the projects, folders, and billing accounts contained in the sink's parent
         # resource are also available for export. Whether a particular log entry from
-        # the children is exported depends on the sink's filter expression. For example,
+        # the children is exported depends on the sink's filter expression.For example,
         # if this field is true, then the filter resource.type=gce_instance would export
         # all Compute Engine VM instance log entries from all projects in the sink's
-        # parent. To only export entries from certain child projects, filter on the
-        # project part of the log name: logName:("projects/test-project1/" OR "projects/
+        # parent.To only export entries from certain child projects, filter on the
+        # project part of the log name:logName:("projects/test-project1/" OR "projects/
         # test-project2/") AND resource.type=gce_instance
         # Corresponds to the JSON property `includeChildren`
         # @return [Boolean]
         attr_accessor :include_children
         alias_method :include_children?, :include_children
       
-        # Required. The client-assigned sink identifier, unique within the project.
-        # Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100
+        # Required. The client-assigned sink identifier, unique within the project.For
+        # example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100
         # characters and can include only the following characters: upper and lower-case
         # alphanumeric characters, underscores, hyphens, and periods. First character
         # has to be alphanumeric.
@@ -1628,15 +1628,18 @@ module Google
         # @return [String]
         attr_accessor :update_time
       
-        # Output only. An IAM identity—a service account or group—under which Logging
-        # writes the exported log entries to the sink's destination. This field is set
-        # by sinks.create and sinks.update based on the value of unique_writer_identity
-        # in those methods.Until you grant this identity write-access to the destination,
-        # log entry exports from this sink will fail. For more information, see
-        # Granting Access for a Resource (https://cloud.google.com/iam/docs/granting-
-        # roles-to-service-accounts#granting_access_to_a_service_account_for_a_resource).
-        # Consult the destination service's documentation to determine the appropriate
-        # IAM roles to assign to the identity.
+        # Output only. An IAM identity—a service account or group—under which Cloud
+        # Logging writes the exported log entries to the sink's destination. This field
+        # is set by sinks.create and sinks.update based on the value of
+        # unique_writer_identity in those methods.Until you grant this identity write-
+        # access to the destination, log entry exports from this sink will fail. For
+        # more information, see Granting Access for a Resource (https://cloud.google.com/
+        # iam/docs/granting-roles-to-service-accounts#
+        # granting_access_to_a_service_account_for_a_resource). Consult the destination
+        # service's documentation to determine the appropriate IAM roles to assign to
+        # the identity.Sinks that have a destination that is a log bucket in the same
+        # project as the sink do not have a writer_identity and no additional
+        # permissions are required.
         # Corresponds to the JSON property `writerIdentity`
         # @return [String]
         attr_accessor :writer_identity
@@ -1662,7 +1665,7 @@ module Google
         end
       end
       
-      # Describes a view over logs in a bucket.
+      # Describes a view over log entries in a bucket.
       class LogView
         include Google::Apis::Core::Hashable
       
@@ -1678,15 +1681,15 @@ module Google
       
         # Filter that restricts which log entries in a bucket are visible in this view.
         # Filters are restricted to be a logical AND of ==/!= of any of the following:
-        # originating project/folder/organization/billing account. resource type log id
-        # Example: SOURCE("projects/myproject") AND resource.type = "gce_instance" AND
-        # LOG_ID("stdout")
+        # originating project/folder/organization/billing account. resource type log
+        # idFor example:SOURCE("projects/myproject") AND resource.type = "gce_instance"
+        # AND LOG_ID("stdout")
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
       
-        # The resource name of the view. For example "projects/my-project-id/locations/
-        # my-location/buckets/my-bucket-id/views/my-view
+        # The resource name of the view.For example:projects/my-project/locations/global/
+        # buckets/my-bucket/views/my-view
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1970,7 +1973,10 @@ module Google
         attr_accessor :name
       
         # Required. The monitored resource type. For example, the type "
-        # cloudsql_database" represents databases in Google Cloud SQL.
+        # cloudsql_database" represents databases in Google Cloud SQL. For a list of
+        # types, see Monitoring resource types (https://cloud.google.com/monitoring/api/
+        # resources) and Logging resource types (https://cloud.google.com/logging/docs/
+        # api/v2/resource-list).
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type

data/lib/google/apis/logging_v2/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module LoggingV2
       # Version of the google-apis-logging_v2 gem
-      GEM_VERSION = "0.13.0"
+      GEM_VERSION = "0.17.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210709"
+      REVISION = "20211019"
     end
   end
 end