google-apis-logging_v2 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df9f8ca0a53cee762ccb82941421bfa6c510b70e600fa05d49b9d29ac32333b5
-  data.tar.gz: b9fc3a0b5418248ee4b23ec144cc4c1f0267bb5f832087254938f4bb58c03dfe
+  metadata.gz: 99eb340cae719bbee3780f6a462bf20d66ca05543f9efd8112f5efe7cdd04b3b
+  data.tar.gz: a0afc97148ecb57488187fdedf506ff8a10e426a886c4eb44b6126ca016f24cd
 SHA512:
-  metadata.gz: e1dcd65c66e1e16df10af24c2dc3abb12aef52b2229f44e360c08e4aa117a356f4fd3713923dc2a89772e05cae5a9adc1f260c0c0142a9afd8cc600a6d7b0a2c
-  data.tar.gz: fd7512b3ac18a50e5596a1d28b2805b9eb5fb1a2e64b9a2d5c04d0665b89032a9c2cdec609e93ba85bf49add50ebaff31a49a6cf71325cba9ebf173c6bb94f8f
+  metadata.gz: f4d044d31bcf3a0913b784f06453bf2ef9709528cebe9da1dbcdfeaa2fc68e5c70f080995ce572b58066b5dae64d61d78c0dd1244b888c0ea484a1ce7fc4105a
+  data.tar.gz: f41e88bc83750a7c9f1f8ad6ceb236b93caa6225f97156049d8c23d1fc39862a912875cc40f61a16de5a32521a68d63cdc5da07265b11f8c69ac7a66dc195ad4

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-logging_v2
 
+### 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/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.
@@ -138,9 +139,9 @@ module Google
         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
@@ -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,12 @@ 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 not to be stored in Cloud Logging. If
+      # your GCP resource receives a large volume of log entries, 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.
       class LogExclusion
         include Google::Apis::Core::Hashable
       
@@ -1326,10 +1327,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 +1536,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 +1554,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 +1571,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 +1595,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 +1629,16 @@ 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.
         # Corresponds to the JSON property `writerIdentity`
         # @return [String]
         attr_accessor :writer_identity
@@ -1662,7 +1664,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,19 +1680,24 @@ 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
       
+        # Schema of a table containing logs.
+        # Corresponds to the JSON property `schema`
+        # @return [Google::Apis::LoggingV2::TableSchema]
+        attr_accessor :schema
+      
         # Output only. The last update timestamp of the view.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
@@ -1706,6 +1713,7 @@ module Google
           @description = args[:description] if args.key?(:description)
           @filter = args[:filter] if args.key?(:filter)
           @name = args[:name] if args.key?(:name)
+          @schema = args[:schema] if args.key?(:schema)
           @update_time = args[:update_time] if args.key?(:update_time)
         end
       end
@@ -1970,7 +1978,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
@@ -2444,6 +2455,74 @@ module Google
         end
       end
       
+      # A field in TableSchema. The fields describe the static fields in the LogEntry.
+      # Any dynamic fields generated by the customer in fields like labels and
+      # jsonPayload are not listed in the schema as they use a native JSON type field.
+      class TableFieldSchema
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The field description.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Optional. Describes the nested schema fields if the type property is set to
+        # RECORD.
+        # Corresponds to the JSON property `fields`
+        # @return [Array<Google::Apis::LoggingV2::TableFieldSchema>]
+        attr_accessor :fields
+      
+        # Optional. The field mode. Possible values include NULLABLE, REQUIRED and
+        # REPEATED. The default value is NULLABLE.
+        # Corresponds to the JSON property `mode`
+        # @return [String]
+        attr_accessor :mode
+      
+        # Required. The field name corresponding to fields in the LogEntry.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Required. The field data type. Possible values include: STRING INTEGER (or
+        # INT64) FLOAT (or FLOAT64) BOOLEAN (or BOOL) TIMESTAMP RECORD (or STRUCT)Use of
+        # RECORD/STRUT indicates that the field contains a nested schema.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @description = args[:description] if args.key?(:description)
+          @fields = args[:fields] if args.key?(:fields)
+          @mode = args[:mode] if args.key?(:mode)
+          @name = args[:name] if args.key?(:name)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # Schema of a table containing logs.
+      class TableSchema
+        include Google::Apis::Core::Hashable
+      
+        # Describes the fields in a table.
+        # Corresponds to the JSON property `fields`
+        # @return [Array<Google::Apis::LoggingV2::TableFieldSchema>]
+        attr_accessor :fields
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @fields = args[:fields] if args.key?(:fields)
+        end
+      end
+      
       # The parameters to TailLogEntries.
       class TailLogEntriesRequest
         include Google::Apis::Core::Hashable

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.14.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 = "20210817"
     end
   end
 end

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

@@ -292,6 +292,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TableFieldSchema
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class TableSchema
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class TailLogEntriesRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -690,6 +702,8 @@ module Google
           property :description, as: 'description'
           property :filter, as: 'filter'
           property :name, as: 'name'
+          property :schema, as: 'schema', class: Google::Apis::LoggingV2::TableSchema, decorator: Google::Apis::LoggingV2::TableSchema::Representation
+      
           property :update_time, as: 'updateTime'
         end
       end
@@ -838,6 +852,26 @@ module Google
         end
       end
       
+      class TableFieldSchema
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
+          collection :fields, as: 'fields', class: Google::Apis::LoggingV2::TableFieldSchema, decorator: Google::Apis::LoggingV2::TableFieldSchema::Representation
+      
+          property :mode, as: 'mode'
+          property :name, as: 'name'
+          property :type, as: 'type'
+        end
+      end
+      
+      class TableSchema
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :fields, as: 'fields', class: Google::Apis::LoggingV2::TableFieldSchema, decorator: Google::Apis::LoggingV2::TableFieldSchema::Representation
+      
+        end
+      end
+      
       class TailLogEntriesRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation