google-cloud-observability-v1 0.a → 0.1.0

data/proto_docs/google/cloud/observability/v1/observability.rb

@@ -0,0 +1,709 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Observability
+      module V1
+        # Settings for configuring CMEK for a bucket.
+        # @!attribute [rw] kms_key
+        #   @return [::String]
+        #     Optional. The resource name for the configured Cloud KMS key. The format
+        #     is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]
+        #
+        #     For example:
+        #
+        #         projects/my-project/locations/us-central1/keyRings/my-ring/cryptoKeys/my-key
+        # @!attribute [r] kms_key_version
+        #   @return [::String]
+        #     Output only. The CryptoKeyVersion resource name for the configured Cloud
+        #     KMS key. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]/cryptoKeyVersions/[VERSION]
+        #
+        #     For example:
+        #
+        #         projects/my-project/locations/us-central1/keyRings/my-ring/cryptoKeys/my-key/cryptoKeyVersions/1
+        #
+        #     This read-only field is used to convey the specific configured
+        #     CryptoKeyVersion of the `kms_key` that has been configured. It is
+        #     populated when the CMEK settings are bound to a single key version.
+        # @!attribute [r] service_account_id
+        #   @return [::String]
+        #     Output only. The service account used to access the key.
+        class CmekSettings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Describes the settings associated with a project, organization, or folder.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. The resource name of the settings.
+        # @!attribute [rw] default_storage_location
+        #   @return [::String]
+        #     Optional. The location which should be used when any regional resources are
+        #     provisioned by Google Cloud.
+        # @!attribute [r] service_account_id
+        #   @return [::String]
+        #     Output only. The service account for the given resource container, such as
+        #     project or folder. This will be used by Cloud Observability to perform
+        #     actions in the container's project like access KMS keys or create Links.
+        #     Always the same service account per resource container regardless of
+        #     region.
+        # @!attribute [rw] kms_key_name
+        #   @return [::String]
+        #     Optional. 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/locations/us-central1/keyRings/my-ring/cryptoKeys/my-key"`
+        class Settings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Bucket configuration for storing observability data.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. Name of the bucket. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Optional. User friendly display name.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. Description of the bucket.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Create timestamp.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Update timestamp.
+        # @!attribute [r] delete_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Delete timestamp.
+        # @!attribute [r] purge_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Timestamp when the bucket in soft-deleted state is purged.
+        # @!attribute [rw] cmek_settings
+        #   @return [::Google::Cloud::Observability::V1::CmekSettings]
+        #     Optional. Settings for configuring CMEK on a bucket.
+        class Bucket
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for creating a bucket.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Name of the project and location for the bucket. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]
+        # @!attribute [rw] bucket_id
+        #   @return [::String]
+        #     Required. Id of the bucket to create.
+        # @!attribute [rw] bucket
+        #   @return [::Google::Cloud::Observability::V1::Bucket]
+        #     Required. Bucket to create.
+        class CreateBucketRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for updating a bucket.
+        # @!attribute [rw] bucket
+        #   @return [::Google::Cloud::Observability::V1::Bucket]
+        #     Required. The  bucket to update.
+        #
+        #     The name field of bucket identifies the resource to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. The list of fields to update.
+        class UpdateBucketRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for getting a bucket.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the bucket to retrieve. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]
+        class GetBucketRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for listing buckets.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent, which owns this collection of buckets. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of buckets to return. If unspecified, then at
+        #     most 100 buckets are returned. The maximum value is 1000; values above 1000
+        #     are coerced to 1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous `ListBuckets` call.
+        #     Provide this to retrieve the subsequent page.
+        # @!attribute [rw] show_deleted
+        #   @return [::Boolean]
+        #     Optional. If true, then the response will include deleted buckets.
+        class ListBucketsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for listing buckets.
+        # @!attribute [rw] buckets
+        #   @return [::Array<::Google::Cloud::Observability::V1::Bucket>]
+        #     Optional. The list of buckets.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Optional. A token that can be sent as `page_token` to retrieve the next
+        #     page. When this field is omitted, there are no subsequent pages.
+        class ListBucketsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A dataset is a collection of data that has a specific configuration. A
+        # dataset can be backed by multiple tables. One bucket can have multiple
+        # datasets.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. Name of the dataset. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Optional. User friendly display name.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. Description of the dataset.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Create timestamp.
+        # @!attribute [r] delete_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Delete timestamp.
+        # @!attribute [r] purge_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Timestamp when the dataset in soft-deleted state is purged.
+        class Dataset
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for getting a dataset.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the dataset to retrieve. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
+        class GetDatasetRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for listing datasets.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent bucket that owns this collection of datasets. The
+        #     format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of datasets to return. If unspecified, then at
+        #     most 100 datasets are returned. The maximum value is 1000; values above
+        #     1000 are coerced to 1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous `ListDatasets` call.
+        #     Provide this to retrieve the subsequent page.
+        # @!attribute [rw] show_deleted
+        #   @return [::Boolean]
+        #     Optional. If true, then the response will include deleted datasets.
+        class ListDatasetsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for listing datasets.
+        # @!attribute [rw] datasets
+        #   @return [::Array<::Google::Cloud::Observability::V1::Dataset>]
+        #     The list of datasets.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token that can be sent as `page_token` to retrieve the next page. When
+        #     this field is omitted, there are no subsequent pages.
+        class ListDatasetsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A view corresponds to a read-only representation of a subset of the data in
+        # a dataset.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. Name of the view. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]/views/[VIEW_ID]
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Optional. User friendly display name.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. Description of the view.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Create timestamp.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Update timestamp.
+        class View
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for getting a view.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the view to retrieve. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]/views/[VIEW_ID]
+        class GetViewRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for listing views.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Dataset whose views are to be listed. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of views to return. If unspecified, then at
+        #     most 100 views are returned. The maximum value is 1000; values above 1000
+        #     are coerced to 1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous `ListViews` call. Provide
+        #     this to retrieve the subsequent page.
+        class ListViewsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for listing views.
+        # @!attribute [rw] views
+        #   @return [::Array<::Google::Cloud::Observability::V1::View>]
+        #     The list of views.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Optional. A token that can be sent as `page_token` to retrieve the next
+        #     page. When this field is omitted, there are no subsequent pages.
+        class ListViewsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A link lets a dataset be accessible to BigQuery via usage of linked datasets.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. Name of the link. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]/links/[LINK_ID]
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Optional. A user friendly display name.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. Description of the link.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Create timestamp.
+        class Link
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for creating a link.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Name of the containing dataset for this link. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
+        # @!attribute [rw] link_id
+        #   @return [::String]
+        #     Required. Id of the link to create.
+        # @!attribute [rw] link
+        #   @return [::Google::Cloud::Observability::V1::Link]
+        #     Required. Link to create.
+        class CreateLinkRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for updating a link.
+        # @!attribute [rw] link
+        #   @return [::Google::Cloud::Observability::V1::Link]
+        #     Required. Link to update.
+        #
+        #     The name field of link identifies the resource to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. The list of fields to update.
+        class UpdateLinkRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for getting a link.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the link to retrieve. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]/links/[LINK_ID]
+        class GetLinkRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for listing links.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent dataset that owns this collection of links. The format
+        #     is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of links to return. If unspecified, then at
+        #     most 100 links are returned. The maximum value is 1000; values above 1000
+        #     are coerced to 1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous `ListLinks` call. Provide
+        #     this to retrieve the subsequent page.
+        class ListLinksRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for listing links.
+        # @!attribute [rw] links
+        #   @return [::Array<::Google::Cloud::Observability::V1::Link>]
+        #     The list of links.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Optional. A token that can be sent as `page_token` to retrieve the next
+        #     page. When this field is omitted, there are no subsequent pages.
+        class ListLinksResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for deleting a link.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the link to delete. The format is:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]/links/[LINK_ID]
+        class DeleteLinkRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message describing Scope object
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. Name of the resource. The format is:
+        #
+        #         projects/\\{project}/locations/\\{location}/scopes/\\{scope}
+        #
+        #     The `{location}` field must be set to `global`. The `{scope}` field must
+        #     be set to `_Default`.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Update timestamp.
+        #     Note: The Update timestamp for the default scope is initially unset.
+        # @!attribute [rw] log_scope
+        #   @return [::String]
+        #     Required. The full resource name of the `logging.googleapis.com/LogScope`.
+        #     For example:
+        #
+        #         //logging.googleapis.com/projects/myproject/locations/global/logScopes/my-log-scope
+        # @!attribute [rw] trace_scope
+        #   @return [::String]
+        #     Required. The unqualified resource name of the
+        #     `cloudtrace.googleapis.com/TraceScope`. For example:
+        #
+        #         projects/myproject/locations/global/traceScopes/my-trace-scope
+        class Scope
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for getting a Scope.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the resource. The format is:
+        #
+        #         projects/\\{project}/locations/\\{location}/scopes/\\{scope}
+        #
+        #     The `{location}` field must be set to `global`. The `{scope}` field must
+        #     be set to `_Default`.
+        class GetScopeRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message for updating a Scope.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. Field mask is used to specify the fields to be overwritten in the
+        #     Scope resource by the update.
+        #     The fields specified in the update_mask are relative to the resource, not
+        #     the full request. A field is overwritten when it is in the mask. If the
+        #     user does not provide a mask, then all fields present in the request are
+        #     overwritten.
+        # @!attribute [rw] scope
+        #   @return [::Google::Cloud::Observability::V1::Scope]
+        #     Required. The resource being updated.
+        class UpdateScopeRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents the metadata of the long-running operation.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time the operation was created.
+        # @!attribute [r] end_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time the operation finished running.
+        # @!attribute [r] target
+        #   @return [::String]
+        #     Output only. Server-defined resource path for the target of the operation.
+        # @!attribute [r] verb
+        #   @return [::String]
+        #     Output only. Name of the verb executed by the operation.
+        # @!attribute [r] status_message
+        #   @return [::String]
+        #     Output only. Human-readable status of the operation, if any.
+        # @!attribute [r] requested_cancellation
+        #   @return [::Boolean]
+        #     Output only. Identifies whether the user has requested cancellation
+        #     of the operation. Operations that have been cancelled successfully
+        #     have [Operation.error][] value with a
+        #     {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
+        #     `Code.CANCELLED`.
+        # @!attribute [r] api_version
+        #   @return [::String]
+        #     Output only. API version used to start the operation.
+        class OperationMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A trace scope is a collection of resources whose traces are queried together.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. The resource name of the trace scope.
+        #
+        #     For example:
+        #
+        #         projects/my-project/locations/global/traceScopes/my-trace-scope
+        # @!attribute [rw] resource_names
+        #   @return [::Array<::String>]
+        #     Required. Names of the projects that are included in this trace scope.
+        #
+        #     *  `projects/[PROJECT_ID]`
+        #
+        #     A trace scope can include a maximum of 20 projects.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. Describes this trace scope.
+        #
+        #     The maximum length of the description is 8000 characters.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The creation timestamp of the trace scope.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The last update timestamp of the trace scope.
+        class TraceScope
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for creating a TraceScope.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The full resource name of the location where the trace scope
+        #     should be created
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION_ID]
+        #
+        #     For example:
+        #
+        #         projects/my-project/locations/global
+        # @!attribute [rw] trace_scope_id
+        #   @return [::String]
+        #     Required. A client-assigned identifier for the trace scope.
+        # @!attribute [rw] trace_scope
+        #   @return [::Google::Cloud::Observability::V1::TraceScope]
+        #     Required. The new trace scope.
+        class CreateTraceScopeRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for getting a TraceScope.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the trace scope:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION_ID]/traceScopes/[TRACE_SCOPE_ID]
+        #
+        #     For example:
+        #
+        #         projects/my-project/locations/global/traceScopes/my-trace-scope
+        class GetTraceScopeRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for listing TraceScopes.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The full resource name of the location to look for trace scopes:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION_ID]
+        #
+        #     For example:
+        #
+        #         projects/my-project/locations/global
+        # @!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 `next_page_token` in the
+        #     response indicates that more results might be available.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. If present, then retrieve the next batch of results from the
+        #     preceding call to this method. `page_token` must be the value of
+        #     `next_page_token` from the previous response. The values of other method
+        #     parameters should be identical to those in the previous call.
+        class ListTraceScopesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for listing TraceScopes.
+        # @!attribute [rw] trace_scopes
+        #   @return [::Array<::Google::Cloud::Observability::V1::TraceScope>]
+        #     Optional. A list of trace scopes.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Optional. If there might be more results than appear in this response, then
+        #     `next_page_token` is included. To get the next set of results, call the
+        #     same method again using the value of `next_page_token` as `page_token`.
+        class ListTraceScopesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for updating a TraceScope.
+        # @!attribute [rw] trace_scope
+        #   @return [::Google::Cloud::Observability::V1::TraceScope]
+        #     Required. The updated trace scope.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. The list of fields to update.
+        class UpdateTraceScopeRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for deleting a TraceScope.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The full resource name of the trace scope to delete:
+        #
+        #         projects/[PROJECT_ID]/locations/[LOCATION_ID]/traceScopes/[TRACE_SCOPE_ID]
+        #
+        #     For example:
+        #
+        #         projects/my-project/locations/global/traceScopes/my-trace-scope
+        class DeleteTraceScopeRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for getting Settings.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the settings to retrieve.
+        #
+        #     Name format:
+        #
+        #         "projects/[PROJECT_ID]/locations/[LOCATION]/settings"
+        #         "folders/[FOLDER_ID]/locations/[LOCATION]/settings"
+        #         "organizations/[ORGANIZATION_ID]/locations/[LOCATION]/settings"
+        class GetSettingsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for updating Settings.
+        # @!attribute [rw] settings
+        #   @return [::Google::Cloud::Observability::V1::Settings]
+        #     Required. The settings to update.
+        #
+        #     The name field of settings is used to identify the resource to be updated.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. The field mask specifying which fields of the settings are to be
+        #     updated.
+        class UpdateSettingsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end