google-cloud-logging 1.9.5 → 1.10.0

data/lib/google/cloud/logging/v2/config_service_v2_client_config.json

@@ -4,14 +4,9 @@
       "retry_codes": {
         "idempotent": [
           "DEADLINE_EXCEEDED",
-          "INTERNAL",
           "UNAVAILABLE"
         ],
-        "non_idempotent": [],
-        "idempotent2": [
-          "DEADLINE_EXCEEDED",
-          "UNAVAILABLE"
-        ]
+        "non_idempotent": []
       },
       "retry_params": {
         "default": {
@@ -22,18 +17,24 @@
           "rpc_timeout_multiplier": 1.0,
           "max_rpc_timeout_millis": 20000,
           "total_timeout_millis": 600000
-        },
-        "write_sink": {
-          "initial_retry_delay_millis": 100,
-          "retry_delay_multiplier": 1.3,
-          "max_retry_delay_millis": 60000,
-          "initial_rpc_timeout_millis": 20000,
-          "rpc_timeout_multiplier": 1.0,
-          "max_rpc_timeout_millis": 20000,
-          "total_timeout_millis": 600000
         }
       },
       "methods": {
+        "ListBuckets": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "GetBucket": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "UpdateBucket": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
         "ListSinks": {
           "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
@@ -45,18 +46,18 @@
           "retry_params_name": "default"
         },
         "CreateSink": {
-          "timeout_millis": 120000,
+          "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
         "UpdateSink": {
-          "timeout_millis": 120000,
-          "retry_codes_name": "idempotent",
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
         "DeleteSink": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
+          "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
         "ListExclusions": {
@@ -81,12 +82,12 @@
         },
         "DeleteExclusion": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
+          "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
         "GetCmekSettings": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent2",
+          "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
         "UpdateCmekSettings": {

data/lib/google/cloud/logging/v2/doc/google/api/monitored_resource.rb

@@ -81,28 +81,5 @@ module Google
     #     resource descriptor. For example, Compute Engine VM instances use the
     #     labels `"project_id"`, `"instance_id"`, and `"zone"`.
     class MonitoredResource; end
-
-    # Auxiliary metadata for a {Google::Api::MonitoredResource MonitoredResource} object.
-    # {Google::Api::MonitoredResource MonitoredResource} objects contain the minimum set of information to
-    # uniquely identify a monitored resource instance. There is some other useful
-    # auxiliary metadata. Monitoring and Logging use an ingestion
-    # pipeline to extract metadata for cloud resources of all types, and store
-    # the metadata in this message.
-    # @!attribute [rw] system_labels
-    #   @return [Google::Protobuf::Struct]
-    #     Output only. Values for predefined system metadata labels.
-    #     System labels are a kind of metadata extracted by Google, including
-    #     "machine_image", "vpc", "subnet_id",
-    #     "security_group", "name", etc.
-    #     System label values can be only strings, Boolean values, or a list of
-    #     strings. For example:
-    #
-    #         { "name": "my-test-instance",
-    #           "security_group": ["a", "b", "c"],
-    #           "spot_instance": false }
-    # @!attribute [rw] user_labels
-    #   @return [Hash{String => String}]
-    #     Output only. A map of user-defined metadata labels.
-    class MonitoredResourceMetadata; end
   end
 end

data/lib/google/cloud/logging/v2/doc/google/logging/v2/log_entry.rb

@@ -26,9 +26,9 @@ module Google
       #         "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.
+      #     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"`.
@@ -67,12 +67,11 @@ module Google
       #     expressed as a JSON object.
       # @!attribute [rw] timestamp
       #   @return [Google::Protobuf::Timestamp]
-      #     Optional. The time the event described by the log entry occurred.  This
-      #     time is used to compute the log entry's age and to enforce the logs
-      #     retention period. 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.
+      #     Optional. The time the event described by the log entry occurred. This time is used
+      #     to compute the log entry's age and to enforce the logs retention period.
+      #     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](/logging/quotas) in the past, and no more than 24 hours
@@ -84,12 +83,11 @@ module Google
       #     Output only. The time the log entry was received by Logging.
       # @!attribute [rw] severity
       #   @return [Google::Logging::Type::LogSeverity]
-      #     Optional. The severity of the log entry. The default value is
-      #     `LogSeverity.DEFAULT`.
+      #     Optional. The severity of the log entry. The default value is `LogSeverity.DEFAULT`.
       # @!attribute [rw] insert_id
       #   @return [String]
-      #     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
+      #     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 are
       #     removed in a single query result. However, there are no guarantees of
       #     de-duplication in the export of logs.
@@ -101,32 +99,21 @@ module Google
       #     the same `log_name` and `timestamp` values.
       # @!attribute [rw] http_request
       #   @return [Google::Logging::Type::HttpRequest]
-      #     Optional. Information about the HTTP request associated with this log
-      #     entry, if applicable.
+      #     Optional. Information about the HTTP request associated with this log entry, if
+      #     applicable.
       # @!attribute [rw] labels
       #   @return [Hash{String => String}]
       #     Optional. A set of user-defined (key, value) data that provides additional
       #     information about the log entry.
-      # @!attribute [rw] metadata
-      #   @return [Google::Api::MonitoredResourceMetadata]
-      #     Deprecated. Output only. Additional metadata about the monitored resource.
-      #
-      #     Only `k8s_container`, `k8s_pod`, and `k8s_node` MonitoredResources have
-      #     this field populated for GKE versions older than 1.12.6. For GKE versions
-      #     1.12.6 and above, the `metadata` field has been deprecated. The Kubernetes
-      #     pod labels that used to be in `metadata.userLabels` will now be present in
-      #     the `labels` field with a key prefix of `k8s-pod/`. The Stackdriver system
-      #     labels that were present in the `metadata.systemLabels` field will no
-      #     longer be available in the LogEntry.
       # @!attribute [rw] operation
       #   @return [Google::Logging::V2::LogEntryOperation]
       #     Optional. Information about an operation associated with the log entry, if
       #     applicable.
       # @!attribute [rw] trace
       #   @return [String]
-      #     Optional. Resource name of the trace associated with the log entry, if any.
-      #     If it contains a relative resource name, the name is assumed to be relative
-      #     to `//tracing.googleapis.com`. Example:
+      #     Optional. Resource name of the trace associated with the log entry, if any. If it
+      #     contains a relative resource name, the name is assumed to be relative to
+      #     `//tracing.googleapis.com`. Example:
       #     `projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824`
       # @!attribute [rw] span_id
       #   @return [String]
@@ -134,7 +121,7 @@ module Google
       #
       #     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>.
+      #     `000000000000004a`.
       # @!attribute [rw] trace_sampled
       #   @return [true, false]
       #     Optional. The sampling decision of the trace associated with the log entry.
@@ -146,8 +133,7 @@ module Google
       #     request correlation identifier. The default is False.
       # @!attribute [rw] source_location
       #   @return [Google::Logging::V2::LogEntrySourceLocation]
-      #     Optional. Source code location information associated with the log entry,
-      #     if any.
+      #     Optional. Source code location information associated with the log entry, if any.
       class LogEntry; end
 
       # Additional information about a potentially long-running operation with which

data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging.rb

@@ -49,10 +49,10 @@ module Google
       #         "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.
       # @!attribute [rw] resource
       #   @return [Google::Api::MonitoredResource]
       #     Optional. A default monitored resource object that is assigned to all log
@@ -109,15 +109,9 @@ module Google
       class WriteLogEntriesRequest; end
 
       # Result returned from WriteLogEntries.
-      # empty
       class WriteLogEntriesResponse; end
 
       # The parameters to `ListLogEntries`.
-      # @!attribute [rw] project_ids
-      #   @return [Array<String>]
-      #     Deprecated. Use `resource_names` instead.  One or more project identifiers
-      #     or project numbers from which to retrieve log entries.  Example:
-      #     `"my-project-1A"`.
       # @!attribute [rw] resource_names
       #   @return [Array<String>]
       #     Required. Names of one or more parent resources from which to

data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging_config.rb

@@ -16,6 +16,40 @@
 module Google
   module Logging
     module V2
+      # Describes a repository of logs (Beta).
+      # @!attribute [rw] name
+      #   @return [String]
+      #     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.
+      # @!attribute [rw] description
+      #   @return [String]
+      #     Describes this bucket.
+      # @!attribute [rw] create_time
+      #   @return [Google::Protobuf::Timestamp]
+      #     Output only. The creation timestamp of the bucket. This is not set for any of the
+      #     default buckets.
+      # @!attribute [rw] update_time
+      #   @return [Google::Protobuf::Timestamp]
+      #     Output only. The last update timestamp of the bucket.
+      # @!attribute [rw] retention_days
+      #   @return [Integer]
+      #     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.
+      # @!attribute [rw] lifecycle_state
+      #   @return [Google::Logging::V2::LifecycleState]
+      #     Output only. The bucket lifecycle state.
+      class LogBucket; 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, or a
       # Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
@@ -23,11 +57,11 @@ module Google
       # folder.
       # @!attribute [rw] name
       #   @return [String]
-      #     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. First character has to be alphanumeric.
+      #     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.
+      #     First character has to be alphanumeric.
       # @!attribute [rw] destination
       #   @return [String]
       #     Required. The export destination:
@@ -61,13 +95,11 @@ module Google
       #     entries. The v2 format is used by default and cannot be changed.
       # @!attribute [rw] writer_identity
       #   @return [String]
-      #     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
-      #     {Google::Logging::V2::ConfigServiceV2#create_sink}
-      #     and
-      #     {Google::Logging::V2::ConfigServiceV2#update_sink}
-      #     based on the value of `unique_writer_identity` in those methods.
+      #     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 {Google::Logging::V2::ConfigServiceV2#create_sink} and
+      #     {Google::Logging::V2::ConfigServiceV2#update_sink} 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,
@@ -103,12 +135,6 @@ module Google
       #     Output only. The last update timestamp of the sink.
       #
       #     This field may not be present for older sinks.
-      # @!attribute [rw] start_time
-      #   @return [Google::Protobuf::Timestamp]
-      #     Do not use. This field is ignored.
-      # @!attribute [rw] end_time
-      #   @return [Google::Protobuf::Timestamp]
-      #     Do not use. This field is ignored.
       class LogSink
         # Available log entry formats. Log entries can be written to
         # Logging in either format and can be exported in either format.
@@ -145,6 +171,86 @@ module Google
       #     this field set to false.
       class BigQueryOptions; end
 
+      # The parameters to `ListBuckets` (Beta).
+      # @!attribute [rw] parent
+      #   @return [String]
+      #     Required. The parent resource whose buckets are to be listed:
+      #
+      #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]"
+      #         "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]"
+      #         "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]"
+      #         "folders/[FOLDER_ID]/locations/[LOCATION_ID]"
+      #
+      #     Note: The locations portion of the resource must be specified, but
+      #     supplying the character `-` in place of [LOCATION_ID] will return all
+      #     buckets.
+      # @!attribute [rw] page_token
+      #   @return [String]
+      #     Optional. If present, then retrieve the next batch of results from the
+      #     preceding call to this method. `pageToken` must be the value of
+      #     `nextPageToken` from the previous response. The values of other method
+      #     parameters should be identical to those in the previous call.
+      # @!attribute [rw] page_size
+      #   @return [Integer]
+      #     Optional. The maximum number of results to return from this request.
+      #     Non-positive values are ignored. The presence of `nextPageToken` in the
+      #     response indicates that more results might be available.
+      class ListBucketsRequest; end
+
+      # The response from ListBuckets (Beta).
+      # @!attribute [rw] buckets
+      #   @return [Array<Google::Logging::V2::LogBucket>]
+      #     A list of buckets.
+      # @!attribute [rw] next_page_token
+      #   @return [String]
+      #     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`.
+      class ListBucketsResponse; end
+
+      # The parameters to `UpdateBucket` (Beta).
+      # @!attribute [rw] name
+      #   @return [String]
+      #     Required. The full resource name of the bucket to update.
+      #
+      #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+      #         "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+      #         "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+      #         "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+      #
+      #     Example:
+      #     `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`. Also
+      #     requires permission "resourcemanager.projects.updateLiens" to set the
+      #     locked property
+      # @!attribute [rw] bucket
+      #   @return [Google::Logging::V2::LogBucket]
+      #     Required. The updated bucket.
+      # @!attribute [rw] update_mask
+      #   @return [Google::Protobuf::FieldMask]
+      #     Required. Field mask that specifies the fields in `bucket` that need an update. A
+      #     bucket field will be overwritten if, and only if, it is in the update
+      #     mask. `name` and output only fields cannot be updated.
+      #
+      #     For a detailed `FieldMask` definition, see
+      #     https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
+      #
+      #     Example: `updateMask=retention_days`.
+      class UpdateBucketRequest; end
+
+      # The parameters to `GetBucket` (Beta).
+      # @!attribute [rw] name
+      #   @return [String]
+      #     Required. The resource name of the bucket:
+      #
+      #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+      #         "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+      #         "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+      #         "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+      #
+      #     Example:
+      #     `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
+      class GetBucketRequest; end
+
       # The parameters to `ListSinks`.
       # @!attribute [rw] parent
       #   @return [String]
@@ -224,8 +330,8 @@ module Google
       # The parameters to `UpdateSink`.
       # @!attribute [rw] sink_name
       #   @return [String]
-      #     Required. The full resource name of the sink to update, including the
-      #     parent resource and the sink identifier:
+      #     Required. The full resource name of the sink to update, including the parent
+      #     resource and the sink identifier:
       #
       #         "projects/[PROJECT_ID]/sinks/[SINK_ID]"
       #         "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
@@ -235,8 +341,8 @@ module Google
       #     Example: `"projects/my-project-id/sinks/my-sink-id"`.
       # @!attribute [rw] sink
       #   @return [Google::Logging::V2::LogSink]
-      #     Required. The updated sink, whose name is the same identifier that appears
-      #     as part of `sink_name`.
+      #     Required. The updated sink, whose name is the same identifier that appears as part
+      #     of `sink_name`.
       # @!attribute [rw] unique_writer_identity
       #   @return [true, false]
       #     Optional. See {Google::Logging::V2::ConfigServiceV2#create_sink}
@@ -271,8 +377,8 @@ module Google
       # The parameters to `DeleteSink`.
       # @!attribute [rw] sink_name
       #   @return [String]
-      #     Required. The full resource name of the sink to delete, including the
-      #     parent resource and the sink identifier:
+      #     Required. The full resource name of the sink to delete, including the parent
+      #     resource and the sink identifier:
       #
       #         "projects/[PROJECT_ID]/sinks/[SINK_ID]"
       #         "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
@@ -290,10 +396,10 @@ module Google
       # apply to child resources, and that you can't exclude audit log entries.
       # @!attribute [rw] name
       #   @return [String]
-      #     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.
-      #     First character has to be alphanumeric.
+      #     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. First character has to be
+      #     alphanumeric.
       # @!attribute [rw] description
       #   @return [String]
       #     Optional. A description of this exclusion.
@@ -401,12 +507,12 @@ module Google
       #     Example: `"projects/my-project-id/exclusions/my-exclusion-id"`.
       # @!attribute [rw] exclusion
       #   @return [Google::Logging::V2::LogExclusion]
-      #     Required. New values for the existing exclusion. Only the fields specified
-      #     in `update_mask` are relevant.
+      #     Required. New values for the existing exclusion. Only the fields specified in
+      #     `update_mask` are relevant.
       # @!attribute [rw] update_mask
       #   @return [Google::Protobuf::FieldMask]
-      #     Required. A non-empty list of fields to change in the existing exclusion.
-      #     New values for the fields are taken from the corresponding fields in the
+      #     Required. A non-empty list of fields to change in the existing exclusion. New values
+      #     for the fields are taken from the corresponding fields in the
       #     {Google::Logging::V2::LogExclusion LogExclusion} included in this request. Fields not mentioned in
       #     `update_mask` are not changed and are ignored in the request.
       #
@@ -495,7 +601,7 @@ module Google
       # for more information.
       # @!attribute [rw] name
       #   @return [String]
-      #     Output Only. The resource name of the CMEK settings.
+      #     Output only. The resource name of the CMEK settings.
       # @!attribute [rw] kms_key_name
       #   @return [String]
       #     The resource name for the configured Cloud KMS key.
@@ -524,8 +630,8 @@ module Google
       #     Router](/logging/docs/routing/managed-encryption) for more information.
       # @!attribute [rw] service_account_id
       #   @return [String]
-      #     Output Only. The service account that will be used by the Logs Router to
-      #     access your Cloud KMS key.
+      #     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
@@ -536,6 +642,19 @@ module Google
       #     See [Enabling CMEK for Logs
       #     Router](/logging/docs/routing/managed-encryption) for more information.
       class CmekSettings; end
+
+      # LogBucket lifecycle states (Beta).
+      module LifecycleState
+        # Unspecified state.  This is only used/useful for distinguishing
+        # unset values.
+        LIFECYCLE_STATE_UNSPECIFIED = 0
+
+        # The normal and active state.
+        ACTIVE = 1
+
+        # The bucket has been marked for deletion by the user.
+        DELETE_REQUESTED = 2
+      end
     end
   end
 end