google-cloud-logging-v2 0.1.2 → 0.4.0

data/lib/google/logging/v2/logging_metrics_services_pb.rb

@@ -34,15 +34,15 @@ module Google
             self.service_name = 'google.logging.v2.MetricsServiceV2'
 
             # Lists logs-based metrics.
-            rpc :ListLogMetrics, Google::Cloud::Logging::V2::ListLogMetricsRequest, Google::Cloud::Logging::V2::ListLogMetricsResponse
+            rpc :ListLogMetrics, ::Google::Cloud::Logging::V2::ListLogMetricsRequest, ::Google::Cloud::Logging::V2::ListLogMetricsResponse
             # Gets a logs-based metric.
-            rpc :GetLogMetric, Google::Cloud::Logging::V2::GetLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
+            rpc :GetLogMetric, ::Google::Cloud::Logging::V2::GetLogMetricRequest, ::Google::Cloud::Logging::V2::LogMetric
             # Creates a logs-based metric.
-            rpc :CreateLogMetric, Google::Cloud::Logging::V2::CreateLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
+            rpc :CreateLogMetric, ::Google::Cloud::Logging::V2::CreateLogMetricRequest, ::Google::Cloud::Logging::V2::LogMetric
             # Creates or updates a logs-based metric.
-            rpc :UpdateLogMetric, Google::Cloud::Logging::V2::UpdateLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
+            rpc :UpdateLogMetric, ::Google::Cloud::Logging::V2::UpdateLogMetricRequest, ::Google::Cloud::Logging::V2::LogMetric
             # Deletes a logs-based metric.
-            rpc :DeleteLogMetric, Google::Cloud::Logging::V2::DeleteLogMetricRequest, Google::Protobuf::Empty
+            rpc :DeleteLogMetric, ::Google::Cloud::Logging::V2::DeleteLogMetricRequest, ::Google::Protobuf::Empty
           end
 
           Stub = Service.rpc_stub_class

data/lib/google/logging/v2/logging_pb.rb

@@ -56,11 +56,30 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :parent, :string, 1
       optional :page_size, :int32, 2
       optional :page_token, :string, 3
+      repeated :resource_names, :string, 8
     end
     add_message "google.logging.v2.ListLogsResponse" do
       repeated :log_names, :string, 3
       optional :next_page_token, :string, 2
     end
+    add_message "google.logging.v2.TailLogEntriesRequest" do
+      repeated :resource_names, :string, 1
+      optional :filter, :string, 2
+      optional :buffer_window, :message, 3, "google.protobuf.Duration"
+    end
+    add_message "google.logging.v2.TailLogEntriesResponse" do
+      repeated :entries, :message, 1, "google.logging.v2.LogEntry"
+      repeated :suppression_info, :message, 2, "google.logging.v2.TailLogEntriesResponse.SuppressionInfo"
+    end
+    add_message "google.logging.v2.TailLogEntriesResponse.SuppressionInfo" do
+      optional :reason, :enum, 1, "google.logging.v2.TailLogEntriesResponse.SuppressionInfo.Reason"
+      optional :suppressed_count, :int32, 2
+    end
+    add_enum "google.logging.v2.TailLogEntriesResponse.SuppressionInfo.Reason" do
+      value :REASON_UNSPECIFIED, 0
+      value :RATE_LIMIT, 1
+      value :NOT_CONSUMED, 2
+    end
   end
 end
 
@@ -78,6 +97,10 @@ module Google
         ListMonitoredResourceDescriptorsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListMonitoredResourceDescriptorsResponse").msgclass
         ListLogsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogsRequest").msgclass
         ListLogsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogsResponse").msgclass
+        TailLogEntriesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesRequest").msgclass
+        TailLogEntriesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesResponse").msgclass
+        TailLogEntriesResponse::SuppressionInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesResponse.SuppressionInfo").msgclass
+        TailLogEntriesResponse::SuppressionInfo::Reason = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesResponse.SuppressionInfo.Reason").enummodule
       end
     end
   end

data/lib/google/logging/v2/logging_services_pb.rb

@@ -37,7 +37,7 @@ module Google
             # entries. Log entries written shortly before the delete operation might not
             # be deleted. Entries received after the delete operation with a timestamp
             # before the operation will be deleted.
-            rpc :DeleteLog, Google::Cloud::Logging::V2::DeleteLogRequest, Google::Protobuf::Empty
+            rpc :DeleteLog, ::Google::Cloud::Logging::V2::DeleteLogRequest, ::Google::Protobuf::Empty
             # Writes log entries to Logging. This API method is the
             # only way to send log entries to Logging. This method
             # is used, directly or indirectly, by the Logging agent
@@ -45,17 +45,20 @@ module Google
             # A single request may contain log entries for a maximum of 1000
             # different resources (projects, organizations, billing accounts or
             # folders)
-            rpc :WriteLogEntries, Google::Cloud::Logging::V2::WriteLogEntriesRequest, Google::Cloud::Logging::V2::WriteLogEntriesResponse
+            rpc :WriteLogEntries, ::Google::Cloud::Logging::V2::WriteLogEntriesRequest, ::Google::Cloud::Logging::V2::WriteLogEntriesResponse
             # Lists log entries.  Use this method to retrieve log entries that originated
             # from a project/folder/organization/billing account.  For ways to export log
             # entries, see [Exporting
             # Logs](https://cloud.google.com/logging/docs/export).
-            rpc :ListLogEntries, Google::Cloud::Logging::V2::ListLogEntriesRequest, Google::Cloud::Logging::V2::ListLogEntriesResponse
+            rpc :ListLogEntries, ::Google::Cloud::Logging::V2::ListLogEntriesRequest, ::Google::Cloud::Logging::V2::ListLogEntriesResponse
             # Lists the descriptors for monitored resource types used by Logging.
-            rpc :ListMonitoredResourceDescriptors, Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsRequest, Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsResponse
+            rpc :ListMonitoredResourceDescriptors, ::Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsRequest, ::Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsResponse
             # Lists the logs in projects, organizations, folders, or billing accounts.
             # Only logs that have entries are listed.
-            rpc :ListLogs, Google::Cloud::Logging::V2::ListLogsRequest, Google::Cloud::Logging::V2::ListLogsResponse
+            rpc :ListLogs, ::Google::Cloud::Logging::V2::ListLogsRequest, ::Google::Cloud::Logging::V2::ListLogsResponse
+            # Streaming read of log entries as they are ingested. Until the stream is
+            # terminated, it will continue reading logs.
+            rpc :TailLogEntries, stream(::Google::Cloud::Logging::V2::TailLogEntriesRequest), stream(::Google::Cloud::Logging::V2::TailLogEntriesResponse)
           end
 
           Stub = Service.rpc_stub_class

data/proto_docs/google/api/field_behavior.rb

@@ -54,6 +54,12 @@ module Google
       # This indicates that the field may be set once in a request to create a
       # resource, but may not be changed thereafter.
       IMMUTABLE = 5
+
+      # Denotes that a (repeated) field is an unordered list.
+      # This indicates that the service may provide the elements of the list
+      # in any arbitrary order, rather than the order the user originally
+      # provided. Additionally, the list's order may or may not be stable.
+      UNORDERED_LIST = 6
     end
   end
 end

data/proto_docs/google/api/resource.rb

@@ -43,12 +43,12 @@ module Google
     #
     # The ResourceDescriptor Yaml config will look like:
     #
-    #    resources:
-    #    - type: "pubsub.googleapis.com/Topic"
-    #      name_descriptor:
-    #        - pattern: "projects/\\{project}/topics/\\{topic}"
-    #          parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #          parent_name_extractor: "projects/\\{project}"
+    #     resources:
+    #     - type: "pubsub.googleapis.com/Topic"
+    #       name_descriptor:
+    #         - pattern: "projects/{project}/topics/{topic}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -183,15 +183,24 @@ module Google
     #         }
     # @!attribute [rw] plural
     #   @return [::String]
-    #     The plural name used in the resource name, such as 'projects' for
-    #     the name of 'projects/\\{project}'. It is the same concept of the `plural`
-    #     field in k8s CRD spec
+    #     The plural name used in the resource name and permission names, such as
+    #     'projects' for the resource name of 'projects/\\{project}' and the permission
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
+    #     concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
+    #
+    #     Note: The plural form is required even for singleton resources. See
+    #     https://aip.dev/156
     # @!attribute [rw] singular
     #   @return [::String]
     #     The same concept of the `singular` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #     Such as "project" for the `resourcemanager.googleapis.com/Project` type.
+    # @!attribute [rw] style
+    #   @return [::Array<::Google::Api::ResourceDescriptor::Style>]
+    #     Style flag(s) for this resource.
+    #     These indicate that a resource is expected to conform to a given
+    #     style. See the specific style flags for additional information.
     class ResourceDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
         # that from being necessary once there are multiple patterns.)
         FUTURE_MULTI_PATTERN = 2
       end
+
+      # A flag representing a specific style that a resource claims to conform to.
+      module Style
+        # The unspecified value. Do not use.
+        STYLE_UNSPECIFIED = 0
+
+        # This resource is intended to be "declarative-friendly".
+        #
+        # Declarative-friendly resources must be more strictly consistent, and
+        # setting this to true communicates to tools that this resource should
+        # adhere to declarative-friendly expectations.
+        #
+        # Note: This is used by the API linter (linter.aip.dev) to enable
+        # additional checks.
+        DECLARATIVE_FRIENDLY = 1
+      end
     end
 
     # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
     #             type: "pubsub.googleapis.com/Topic"
     #           }];
     #         }
+    #
+    #     Occasionally, a field may reference an arbitrary resource. In this case,
+    #     APIs use the special value * in their resource reference.
+    #
+    #     Example:
+    #
+    #         message GetIamPolicyRequest {
+    #           string resource = 2 [(google.api.resource_reference) = {
+    #             type: "*"
+    #           }];
+    #         }
     # @!attribute [rw] child_type
     #   @return [::String]
     #     The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
     #
     #     Example:
     #
-    #       message ListLogEntriesRequest {
-    #         string parent = 1 [(google.api.resource_reference) = {
-    #           child_type: "logging.googleapis.com/LogEntry"
-    #         };
-    #       }
+    #         message ListLogEntriesRequest {
+    #           string parent = 1 [(google.api.resource_reference) = {
+    #             child_type: "logging.googleapis.com/LogEntry"
+    #           };
+    #         }
     class ResourceReference
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/logging/type/http_request.rb

@@ -52,11 +52,13 @@ module Google
         # @!attribute [rw] remote_ip
         #   @return [::String]
         #     The IP address (IPv4 or IPv6) of the client that issued the HTTP
-        #     request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
+        #     request. This field can include port information. Examples:
+        #     `"192.168.1.1"`, `"10.0.0.1:80"`, `"FE80::0202:B3FF:FE1E:8329"`.
         # @!attribute [rw] server_ip
         #   @return [::String]
         #     The IP address (IPv4 or IPv6) of the origin server that the request was
-        #     sent to.
+        #     sent to. This field can include port information. Examples:
+        #     `"192.168.1.1"`, `"10.0.0.1:80"`, `"FE80::0202:B3FF:FE1E:8329"`.
         # @!attribute [rw] referer
         #   @return [::String]
         #     The referer URL of the request, as defined in

data/proto_docs/google/logging/v2/logging.rb

@@ -169,6 +169,11 @@ module Google
         #         "billingAccounts/[BILLING_ACCOUNT_ID]"
         #         "folders/[FOLDER_ID]"
         #
+        #     May alternatively be one or more views
+        #       projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
+        #       organization/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
+        #       billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
+        #       folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
         #
         #     Projects listed in the `project_ids` field are added to this list.
         # @!attribute [rw] filter
@@ -279,6 +284,19 @@ module Google
         #     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] resource_names
+        #   @return [::Array<::String>]
+        #     Optional. The resource name that owns the logs:
+        #       projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
+        #       organization/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
+        #       billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
+        #       folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
+        #
+        #     To support legacy queries, it could also be:
+        #         "projects/[PROJECT_ID]"
+        #         "organizations/[ORGANIZATION_ID]"
+        #         "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #         "folders/[FOLDER_ID]"
         class ListLogsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -299,6 +317,87 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # The parameters to `TailLogEntries`.
+        # @!attribute [rw] resource_names
+        #   @return [::Array<::String>]
+        #     Required. Name of a parent resource from which to retrieve log entries:
+        #
+        #         "projects/[PROJECT_ID]"
+        #         "organizations/[ORGANIZATION_ID]"
+        #         "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #         "folders/[FOLDER_ID]"
+        #
+        #     May alternatively be one or more views:
+        #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
+        #         "organization/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
+        #         "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
+        #         "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. A filter that chooses which log entries to return.  See [Advanced
+        #     Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
+        #     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 in `resource_names` will cause
+        #     the filter to return no results. The maximum length of the filter is 20000
+        #     characters.
+        # @!attribute [rw] buffer_window
+        #   @return [::Google::Protobuf::Duration]
+        #     Optional. The amount of time to buffer log entries at the server before
+        #     being returned to prevent out of order results due to late arriving log
+        #     entries. Valid values are between 0-60000 milliseconds. Defaults to 2000
+        #     milliseconds.
+        class TailLogEntriesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Result returned from `TailLogEntries`.
+        # @!attribute [rw] entries
+        #   @return [::Array<::Google::Cloud::Logging::V2::LogEntry>]
+        #     A list of log entries. Each response in the stream will order entries with
+        #     increasing values of `LogEntry.timestamp`. Ordering is not guaranteed
+        #     between separate responses.
+        # @!attribute [rw] suppression_info
+        #   @return [::Array<::Google::Cloud::Logging::V2::TailLogEntriesResponse::SuppressionInfo>]
+        #     If entries that otherwise would have been included in the session were not
+        #     sent back to the client, counts of relevant entries omitted from the
+        #     session with the reason that they were not included. There will be at most
+        #     one of each reason per response. The counts represent the number of
+        #     suppressed entries since the last streamed response.
+        class TailLogEntriesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Information about entries that were omitted from the session.
+          # @!attribute [rw] reason
+          #   @return [::Google::Cloud::Logging::V2::TailLogEntriesResponse::SuppressionInfo::Reason]
+          #     The reason that entries were omitted from the session.
+          # @!attribute [rw] suppressed_count
+          #   @return [::Integer]
+          #     A lower bound on the count of entries omitted due to `reason`.
+          class SuppressionInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # An indicator of why entries were omitted.
+            module Reason
+              # Unexpected default.
+              REASON_UNSPECIFIED = 0
+
+              # Indicates suppression occurred due to relevant entries being
+              # received in excess of rate limits. For quotas and limits, see
+              # [Logging API quotas and
+              # limits](https://cloud.google.com/logging/quotas#api-limits).
+              RATE_LIMIT = 1
+
+              # Indicates suppression occurred due to the client not consuming
+              # responses quickly enough.
+              NOT_CONSUMED = 2
+            end
+          end
+        end
       end
     end
   end

data/proto_docs/google/logging/v2/logging_config.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Logging
       module V2
-        # Describes a repository of logs (Beta).
+        # Describes a repository of logs.
         # @!attribute [rw] name
         #   @return [::String]
         #     The resource name of the bucket.
@@ -29,7 +29,6 @@ module Google
         #     "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.
@@ -50,6 +49,11 @@ module Google
         #     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] locked
+        #   @return [::Boolean]
+        #     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.
         # @!attribute [r] lifecycle_state
         #   @return [::Google::Cloud::Logging::V2::LifecycleState]
         #     Output only. The bucket lifecycle state.
@@ -58,6 +62,36 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Describes a view over logs in a bucket.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The resource name of the view.
+        #     For example
+        #     "projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Describes this view.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The creation timestamp of the view.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The last update timestamp of the view.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     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")
+        class LogView
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        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.
@@ -99,12 +133,17 @@ module Google
         #   @return [::Boolean]
         #     Optional. If set to True, then this sink is disabled and it does not
         #     export any log entries.
+        # @!attribute [rw] exclusions
+        #   @return [::Array<::Google::Cloud::Logging::V2::LogExclusion>]
+        #     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.
         # @!attribute [rw] output_version_format
         #   @return [::Google::Cloud::Logging::V2::LogSink::VersionFormat]
         #     Deprecated. This field is unused.
         # @!attribute [r] writer_identity
         #   @return [::String]
-        #     Output only. An IAM identity–a service account or group&mdash;under which Logging
+        #     Output only. An IAM identity&mdash;a service account or group&mdash;under which Logging
         #     writes the exported log entries to the sink's destination. This field is
         #     set by {::Google::Cloud::Logging::V2::ConfigServiceV2::Client#create_sink sinks.create} and
         #     {::Google::Cloud::Logging::V2::ConfigServiceV2::Client#update_sink sinks.update} based on the
@@ -185,7 +224,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The parameters to `ListBuckets` (Beta).
+        # The parameters to `ListBuckets`.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The parent resource whose buckets are to be listed:
@@ -214,7 +253,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The response from ListBuckets (Beta).
+        # The response from ListBuckets.
         # @!attribute [rw] buckets
         #   @return [::Array<::Google::Cloud::Logging::V2::LogBucket>]
         #     A list of buckets.
@@ -228,7 +267,30 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The parameters to `UpdateBucket` (Beta).
+        # The parameters to `CreateBucket`.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The resource in which to create the bucket:
+        #
+        #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]"
+        #
+        #     Example: `"projects/my-logging-project/locations/global"`
+        # @!attribute [rw] bucket_id
+        #   @return [::String]
+        #     Required. A client-assigned identifier such as `"my-bucket"`. Identifiers are
+        #     limited to 100 characters and can include only letters, digits,
+        #     underscores, hyphens, and periods.
+        # @!attribute [rw] bucket
+        #   @return [::Google::Cloud::Logging::V2::LogBucket]
+        #     Required. The new bucket. The region specified in the new bucket must be compliant
+        #     with any Location Restriction Org Policy. The name field in the bucket is
+        #     ignored.
+        class CreateBucketRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The parameters to `UpdateBucket`.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The full resource name of the bucket to update.
@@ -260,7 +322,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The parameters to `GetBucket` (Beta).
+        # The parameters to `GetBucket`.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the bucket:
@@ -277,6 +339,151 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # The parameters to `DeleteBucket`.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The full resource name of the bucket to delete.
+        #
+        #         "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 DeleteBucketRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The parameters to `UndeleteBucket`.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The full resource name of the bucket to undelete.
+        #
+        #         "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 UndeleteBucketRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The parameters to `ListViews`.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The bucket whose views are to be listed:
+        #
+        #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+        # @!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 ListViewsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response from ListViews.
+        # @!attribute [rw] views
+        #   @return [::Array<::Google::Cloud::Logging::V2::LogView>]
+        #     A list of views.
+        # @!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 ListViewsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The parameters to `CreateView`.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The bucket in which to create the view
+        #
+        #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+        #
+        #     Example:
+        #     `"projects/my-logging-project/locations/my-location/buckets/my-bucket"`
+        # @!attribute [rw] view_id
+        #   @return [::String]
+        #     Required. The id to use for this view.
+        # @!attribute [rw] view
+        #   @return [::Google::Cloud::Logging::V2::LogView]
+        #     Required. The new view.
+        class CreateViewRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The parameters to `UpdateView`.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The full resource name of the view to update
+        #
+        #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
+        #
+        #     Example:
+        #       `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
+        # @!attribute [rw] view
+        #   @return [::Google::Cloud::Logging::V2::LogView]
+        #     Required. The updated view.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. Field mask that specifies the fields in `view` that need
+        #     an update. A 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=filter`.
+        class UpdateViewRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The parameters to `GetView`.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the policy:
+        #
+        #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
+        #
+        #     Example:
+        #     `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
+        class GetViewRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The parameters to `DeleteView`.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The full resource name of the view to delete:
+        #
+        #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
+        #
+        #     Example:
+        #        `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
+        class DeleteViewRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # The parameters to `ListSinks`.
         # @!attribute [rw] parent
         #   @return [::String]
@@ -724,7 +931,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # LogBucket lifecycle states (Beta).
+        # LogBucket lifecycle states.
         module LifecycleState
           # Unspecified state.  This is only used/useful for distinguishing
           # unset values.