google-api-client 0.32.1 → 0.40.0

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

@@ -26,16 +26,27 @@ module Google
       class BigQueryOptions
         include Google::Apis::Core::Hashable
       
-        # Optional. Whether to use BigQuery's partition 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 has to be used instead. In both cases, tables are
-        # sharded based on UTC timezone.
+        # 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.
         # 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
+        # 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.
+        # Corresponds to the JSON property `usesTimestampColumnPartitioning`
+        # @return [Boolean]
+        attr_accessor :uses_timestamp_column_partitioning
+        alias_method :uses_timestamp_column_partitioning?, :uses_timestamp_column_partitioning
+      
         def initialize(**args)
            update!(**args)
         end
@@ -43,6 +54,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @use_partitioned_tables = args[:use_partitioned_tables] if args.key?(:use_partitioned_tables)
+          @uses_timestamp_column_partitioning = args[:uses_timestamp_column_partitioning] if args.key?(:uses_timestamp_column_partitioning)
         end
       end
       
@@ -104,6 +116,61 @@ module Google
         end
       end
       
+      # 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
+      # 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.
+      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
+        # 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.
+        # Corresponds to the JSON property `kmsKeyName`
+        # @return [String]
+        attr_accessor :kms_key_name
+      
+        # Output only. The resource name of the CMEK settings.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # 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
+        # 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.
+        # Corresponds to the JSON property `serviceAccountId`
+        # @return [String]
+        attr_accessor :service_account_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
+          @name = args[:name] if args.key?(:name)
+          @service_account_id = args[:service_account_id] if args.key?(:service_account_id)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance:
@@ -369,6 +436,33 @@ module Google
         end
       end
       
+      # The response from ListBuckets (Beta).
+      class ListBucketsResponse
+        include Google::Apis::Core::Hashable
+      
+        # A list of buckets.
+        # Corresponds to the JSON property `buckets`
+        # @return [Array<Google::Apis::LoggingV2::LogBucket>]
+        attr_accessor :buckets
+      
+        # If there might be more results than appear in this response, then
+        # nextPageToken is included. To get the next set of results, call the same
+        # method again using the value of nextPageToken as pageToken.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @buckets = args[:buckets] if args.key?(:buckets)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Result returned from ListExclusions.
       class ListExclusionsResponse
         include Google::Apis::Core::Hashable
@@ -401,10 +495,11 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. A filter that chooses which log entries to return. See Advanced Logs
-        # Queries. Only log entries that match the filter are returned. An empty filter
-        # matches all log entries in the resources listed in resource_names. Referencing
-        # a parent resource that is not listed in resource_names will cause the filter
-        # to return no results. The maximum length of the filter is 20000 characters.
+        # Queries (https://cloud.google.com/logging/docs/view/advanced-queries). Only
+        # log entries that match the filter are returned. An empty filter matches all
+        # log entries in the resources listed in resource_names. Referencing a parent
+        # resource that is not listed in resource_names will cause the filter to return
+        # no results. The maximum length of the filter is 20000 characters.
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -434,8 +529,9 @@ module Google
         # @return [String]
         attr_accessor :page_token
       
-        # Deprecated. Use resource_names instead. One or more project identifiers or
-        # project numbers from which to retrieve log entries. Example: "my-project-1A".
+        # Optional. Deprecated. Use resource_names instead. One or more project
+        # identifiers or project numbers from which to retrieve log entries. Example: "
+        # my-project-1A".
         # Corresponds to the JSON property `projectIds`
         # @return [Array<String>]
         attr_accessor :project_ids
@@ -610,6 +706,63 @@ module Google
         end
       end
       
+      # Describes a repository of logs (Beta).
+      class LogBucket
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The creation timestamp of the bucket. This is not set for any of
+        # the default buckets.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Describes this bucket.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Output only. The bucket lifecycle state.
+        # Corresponds to the JSON property `lifecycleState`
+        # @return [String]
+        attr_accessor :lifecycle_state
+      
+        # 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"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.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Logs will be retained by default for this amount of time, after which they
+        # will automatically be deleted. The minimum retention period is 1 day. If this
+        # value is set to zero at bucket creation time, the default time of 30 days will
+        # be used.
+        # Corresponds to the JSON property `retentionDays`
+        # @return [Fixnum]
+        attr_accessor :retention_days
+      
+        # Output only. The last update timestamp of the bucket.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @description = args[:description] if args.key?(:description)
+          @lifecycle_state = args[:lifecycle_state] if args.key?(:lifecycle_state)
+          @name = args[:name] if args.key?(:name)
+          @retention_days = args[:retention_days] if args.key?(:retention_days)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
       # An individual entry in a log.
       class LogEntry
         include Google::Apis::Core::Hashable
@@ -623,10 +776,12 @@ module Google
       
         # Optional. A unique identifier for the log entry. If you provide a value, then
         # Logging considers other log entries in the same project, with the same
-        # timestamp, and with the same insert_id to be duplicates which can be removed.
-        # If omitted in new log entries, then Logging assigns its own unique identifier.
-        # The insert_id is also used to order log entries that have the same timestamp
-        # value.
+        # timestamp, and with the same insert_id to be duplicates which are removed in a
+        # single query result. However, there are no guarantees of de-duplication in the
+        # export of logs.If the insert_id is omitted when writing a log entry, the
+        # Logging API  assigns its own unique identifier in this field.In queries, the
+        # insert_id is also used to order log entries that have the same log_name and
+        # timestamp values.
         # Corresponds to the JSON property `insertId`
         # @return [String]
         attr_accessor :insert_id
@@ -648,17 +803,17 @@ module Google
         # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
         # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
         # "folders/[FOLDER_ID]/logs/[LOG_ID]"
-        # A project number may optionally be used in place of PROJECT_ID. The project
-        # number is translated to its corresponding PROJECT_ID internally and the
-        # log_name field will contain PROJECT_ID in queries and exports.[LOG_ID] must be
-        # URL-encoded within log_name. Example: "organizations/1234567890/logs/
-        # cloudresourcemanager.googleapis.com%2Factivity". [LOG_ID] must be less than
-        # 512 characters long and can only include the following characters: upper and
-        # lower case alphanumeric characters, forward-slash, underscore, hyphen, and
-        # period.For backward compatibility, if log_name begins with a forward-slash,
-        # such as /projects/..., then the log entry is ingested as usual but the forward-
-        # slash is removed. Listing the log entry will not show the leading slash and
-        # filtering for a log name with a leading slash will never return any results.
+        # A project number may be used in place of PROJECT_ID. The project number is
+        # translated to its corresponding PROJECT_ID internally and the log_name field
+        # will contain PROJECT_ID in queries and exports.[LOG_ID] must be URL-encoded
+        # within log_name. Example: "organizations/1234567890/logs/cloudresourcemanager.
+        # googleapis.com%2Factivity". [LOG_ID] must be less than 512 characters long and
+        # can only include the following characters: upper and lower case alphanumeric
+        # characters, forward-slash, underscore, hyphen, and period.For backward
+        # compatibility, if log_name begins with a forward-slash, such as /projects/...,
+        # then the log entry is ingested as usual but the forward-slash is removed.
+        # Listing the log entry will not show the leading slash and filtering for a log
+        # name with a leading slash will never return any results.
         # Corresponds to the JSON property `logName`
         # @return [String]
         attr_accessor :log_name
@@ -722,8 +877,7 @@ module Google
       
         # Optional. The span ID within the trace associated with the log entry.For Trace
         # spans, this is the same format that the Trace API v2 uses: a 16-character
-        # hexadecimal encoding of an 8-byte array, such as <code>"000000000000004a"</
-        # code>.
+        # hexadecimal encoding of an 8-byte array, such as 000000000000004a.
         # Corresponds to the JSON property `spanId`
         # @return [String]
         attr_accessor :span_id
@@ -738,10 +892,10 @@ module Google
         # If this field is omitted in a new log entry, then Logging assigns it the
         # current time. Timestamps have nanosecond accuracy, but trailing zeros in the
         # fractional seconds might be omitted when the timestamp is displayed.Incoming
-        # log entries should have timestamps that are no more than the logs retention
-        # period in the past, and no more than 24 hours in the future. Log entries
-        # outside those time boundaries will not be available when calling entries.list,
-        # but those log entries can still be exported with LogSinks.
+        # log entries must have timestamps that don't exceed the logs retention period (
+        # https://cloud.google.com/logging/quotas#logs_retention_periods) in the past,
+        # and that don't exceed 24 hours in the future. Log entries outside those time
+        # boundaries aren't ingested by Logging.
         # Corresponds to the JSON property `timestamp`
         # @return [String]
         attr_accessor :timestamp
@@ -900,18 +1054,20 @@ module Google
         attr_accessor :disabled
         alias_method :disabled?, :disabled
       
-        # Required. An advanced logs filter that matches the log entries to be excluded.
-        # By using the sample function, 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)"
+        # 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
+        # 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)"
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
       
         # Required. A client-assigned identifier, such as "load-balancer-exclusion".
         # Identifiers are limited to 100 characters and can include only letters, digits,
-        # underscores, hyphens, and periods.
+        # underscores, hyphens, and periods. First character has to be alphanumeric.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1012,7 +1168,8 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # Required. An advanced logs filter which is used to match log entries. Example:
+        # Required. An advanced logs filter (https://cloud.google.com/logging/docs/view/
+        # advanced_filters) which is used to match log entries. Example:
         # "resource.type=gae_app AND severity>=ERROR"
         # The maximum length of the filter is 20000 characters.
         # Corresponds to the JSON property `filter`
@@ -1120,20 +1277,34 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
+        # Optional. A description of this sink. The maximum length of the description is
+        # 8000 characters.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
         # Required. The export destination:
         # "storage.googleapis.com/[GCS_BUCKET]"
         # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
         # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
         # The sink's writer_identity, set when the sink is created, must have permission
         # to write to the destination or else the log entries are not exported. For more
-        # information, see Exporting Logs with Sinks.
+        # information, see Exporting Logs with Sinks (https://cloud.google.com/logging/
+        # docs/api/tasks/exporting-logs).
         # Corresponds to the JSON property `destination`
         # @return [String]
         attr_accessor :destination
       
-        # Optional. An advanced logs filter. The only exported log entries are those
-        # that are in the resource owning the sink and that match the filter. For
-        # example:
+        # 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. 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="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
         # Corresponds to the JSON property `filter`
         # @return [String]
@@ -1159,13 +1330,13 @@ module Google
         # Required. The client-assigned sink identifier, unique within the project.
         # 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.
+        # alphanumeric characters, underscores, hyphens, and periods. First character
+        # has to be alphanumeric.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Deprecated. The log entry format to use for this sink's exported log entries.
-        # The v2 format is used by default and cannot be changed.
+        # Deprecated. This field is unused.
         # Corresponds to the JSON property `outputVersionFormat`
         # @return [String]
         attr_accessor :output_version_format
@@ -1181,7 +1352,9 @@ module Google
         # 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. Consult the destination
+        # 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`
@@ -1196,7 +1369,9 @@ module Google
         def update!(**args)
           @bigquery_options = args[:bigquery_options] if args.key?(:bigquery_options)
           @create_time = args[:create_time] if args.key?(:create_time)
+          @description = args[:description] if args.key?(:description)
           @destination = args[:destination] if args.key?(:destination)
+          @disabled = args[:disabled] if args.key?(:disabled)
           @filter = args[:filter] if args.key?(:filter)
           @include_children = args[:include_children] if args.key?(:include_children)
           @name = args[:name] if args.key?(:name)
@@ -1274,39 +1449,54 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # The unit in which the metric value is reported. It is only applicable if the
-        # value_type is INT64, DOUBLE, or DISTRIBUTION. The supported units are a subset
-        # of The Unified Code for Units of Measure (http://unitsofmeasure.org/ucum.html)
-        # standard:Basic units (UNIT)
+        # The units in which the metric value is reported. It is only applicable if the
+        # value_type is INT64, DOUBLE, or DISTRIBUTION. The unit defines the
+        # representation of the stored metric values.Different systems may scale the
+        # values to be more easily displayed (so a value of 0.02KBy might be displayed
+        # as 20By, and a value of 3523KBy might be displayed as 3.5MBy). However, if the
+        # unit is KBy, then the value of the metric is always in thousands of bytes, no
+        # matter how it may be displayed..If you want a custom metric to record the
+        # exact number of CPU-seconds used by a job, you can create an INT64 CUMULATIVE
+        # metric whose unit is s`CPU` (or equivalently 1s`CPU` or just s). If the job
+        # uses 12,005 CPU-seconds, then the value is written as 12005.Alternatively, if
+        # you want a custom metric to record data in a more granular way, you can create
+        # a DOUBLE CUMULATIVE metric whose unit is ks`CPU`, and then write the value 12.
+        # 005 (which is 12005/1000), or use Kis`CPU` and write 11.723 (which is 12005/
+        # 1024).The supported units are a subset of The Unified Code for Units of
+        # Measure (http://unitsofmeasure.org/ucum.html) standard:Basic units (UNIT)
         # bit bit
         # By byte
         # s second
         # min minute
         # h hour
         # d dayPrefixes (PREFIX)
-        # k kilo (10**3)
-        # M mega (10**6)
-        # G giga (10**9)
-        # T tera (10**12)
-        # P peta (10**15)
-        # E exa (10**18)
-        # Z zetta (10**21)
-        # Y yotta (10**24)
-        # m milli (10**-3)
-        # u micro (10**-6)
-        # n nano (10**-9)
-        # p pico (10**-12)
-        # f femto (10**-15)
-        # a atto (10**-18)
-        # z zepto (10**-21)
-        # y yocto (10**-24)
-        # Ki kibi (2**10)
-        # Mi mebi (2**20)
-        # Gi gibi (2**30)
-        # Ti tebi (2**40)GrammarThe grammar also includes these connectors:
-        # / division (as an infix operator, e.g. 1/s).
-        # . multiplication (as an infix operator, e.g. GBy.d)The grammar for a unit is
-        # as follows:
+        # k kilo (10^3)
+        # M mega (10^6)
+        # G giga (10^9)
+        # T tera (10^12)
+        # P peta (10^15)
+        # E exa (10^18)
+        # Z zetta (10^21)
+        # Y yotta (10^24)
+        # m milli (10^-3)
+        # u micro (10^-6)
+        # n nano (10^-9)
+        # p pico (10^-12)
+        # f femto (10^-15)
+        # a atto (10^-18)
+        # z zepto (10^-21)
+        # y yocto (10^-24)
+        # Ki kibi (2^10)
+        # Mi mebi (2^20)
+        # Gi gibi (2^30)
+        # Ti tebi (2^40)
+        # Pi pebi (2^50)GrammarThe grammar also includes these connectors:
+        # / division or ratio (as an infix operator). For examples,  kBy/`email` or MiBy/
+        # 10ms (although you should almost never  have /s in a metric unit; rates should
+        # always be computed at  query time from the underlying cumulative or delta
+        # value).
+        # . multiplication or composition (as an infix operator). For  examples, GBy.d
+        # or k`watt`.h.The grammar for a unit is as follows:
         # Expression = Component ` "." Component ` ` "/" Component ` ;
         # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
         # | Annotation
@@ -1314,14 +1504,24 @@ module Google
         # ;
         # Annotation = "`" NAME "`" ;
         # Notes:
-        # Annotation is just a comment if it follows a UNIT and is  equivalent to 1 if
-        # it is used alone. For examples,  `requests`/s == 1/s, By`transmitted`/s == By/
-        # s.
-        # NAME is a sequence of non-blank printable ASCII characters not  containing '`'
-        # or '`'.
-        # 1 represents dimensionless value 1, such as in 1/s.
-        # % represents dimensionless value 1/100, and annotates values giving  a
-        # percentage.
+        # Annotation is just a comment if it follows a UNIT. If the annotation  is used
+        # alone, then the unit is equivalent to 1. For examples,  `request`/s == 1/s, By`
+        # transmitted`/s == By/s.
+        # NAME is a sequence of non-blank printable ASCII characters not  containing `
+        # or `.
+        # 1 represents a unitary dimensionless  unit (https://en.wikipedia.org/wiki/
+        # Dimensionless_quantity) of 1, such  as in 1/s. It is typically used when none
+        # of the basic units are  appropriate. For example, "new users per day" can be
+        # represented as  1/d or `new-users`/d (and a metric value 5 would mean "5 new
+        # users). Alternatively, "thousands of page views per day" would be  represented
+        # as 1000/d or k1/d or k`page_views`/d (and a metric  value of 5.3 would mean "
+        # 5300 page views per day").
+        # % represents dimensionless value of 1/100, and annotates values giving  a
+        # percentage (so the metric values are typically in the range of 0..100,  and a
+        # metric value 3 means "3 percent").
+        # 10^2.% indicates a metric contains a ratio, typically in the range  0..1, that
+        # will be multiplied by 100 and displayed as a percentage  (so a metric value 0.
+        # 03 means "3 percent").
         # Corresponds to the JSON property `unit`
         # @return [String]
         attr_accessor :unit
@@ -1846,10 +2046,12 @@ module Google
         # respectively. The supplied values are chosen so that, among the log entries
         # that did not supply their own values, the entries earlier in the list will
         # sort before the entries later in the list. See the entries.list method.Log
-        # entries with timestamps that are more than the logs retention period in the
-        # past or more than 24 hours in the future will not be available when calling
-        # entries.list. However, those log entries can still be exported with LogSinks.
-        # To improve throughput and to avoid exceeding the quota limit for calls to
+        # entries with timestamps that are more than the logs retention period (https://
+        # cloud.google.com/logging/quota-policy) in the past or more than 24 hours in
+        # the future will not be available when calling entries.list. However, those log
+        # entries can still be exported with LogSinks (https://cloud.google.com/logging/
+        # docs/api/tasks/exporting-logs).To improve throughput and to avoid exceeding
+        # the quota limit (https://cloud.google.com/logging/quota-policy) for calls to
         # entries.write, you should try to include several log entries in this list,
         # rather than calling this method for each individual log entry.
         # Corresponds to the JSON property `entries`
@@ -1872,10 +2074,9 @@ module Google
         # [LOG_ID] must be URL-encoded. For example:
         # "projects/my-project-id/logs/syslog"
         # "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
-        # The permission <code>logging.logEntries.create</code> is needed on each
-        # project, organization, billing account, or folder that is receiving new log
-        # entries, whether the resource is specified in <code>logName</code> or in an
-        # individual log entry.
+        # The permission logging.logEntries.create is needed on each project,
+        # organization, billing account, or folder that is receiving new log entries,
+        # whether the resource is specified in logName or in an individual log entry.
         # Corresponds to the JSON property `logName`
         # @return [String]
         attr_accessor :log_name
@@ -1921,7 +2122,7 @@ module Google
         end
       end
       
-      # Result returned from WriteLogEntries. empty
+      # Result returned from WriteLogEntries.
       class WriteLogEntriesResponse
         include Google::Apis::Core::Hashable