google-cloud-bigtable-admin-v2 0.1.0

data/proto_docs/google/bigtable/admin/v2/common.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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 Bigtable
+      module Admin
+        module V2
+          # Encapsulates progress related information for a Cloud Bigtable long
+          # running operation.
+          # @!attribute [rw] progress_percent
+          #   @return [::Integer]
+          #     Percent completion of the operation.
+          #     Values are between 0 and 100 inclusive.
+          # @!attribute [rw] start_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Time the request was received.
+          # @!attribute [rw] end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     If set, the time at which this operation failed or was completed
+          #     successfully.
+          class OperationProgress
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Storage media types for persisting Bigtable data.
+          module StorageType
+            # The user did not specify a storage type.
+            STORAGE_TYPE_UNSPECIFIED = 0
+
+            # Flash (SSD) storage should be used.
+            SSD = 1
+
+            # Magnetic drive (HDD) storage should be used.
+            HDD = 2
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/bigtable/admin/v2/instance.rb

@@ -0,0 +1,223 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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 Bigtable
+      module Admin
+        module V2
+          # A collection of Bigtable {::Google::Cloud::Bigtable::Admin::V2::Table Tables} and
+          # the resources that serve them.
+          # All tables in an instance are served from all
+          # {::Google::Cloud::Bigtable::Admin::V2::Cluster Clusters} in the instance.
+          # @!attribute [r] name
+          #   @return [::String]
+          #     The unique name of the instance. Values are of the form
+          #     `projects/{project}/instances/[a-z][a-z0-9\\-]+[a-z0-9]`.
+          # @!attribute [rw] display_name
+          #   @return [::String]
+          #     Required. The descriptive name for this instance as it appears in UIs.
+          #     Can be changed at any time, but should be kept globally unique
+          #     to avoid confusion.
+          # @!attribute [rw] state
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::Instance::State]
+          #     (`OutputOnly`)
+          #     The current state of the instance.
+          # @!attribute [rw] type
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::Instance::Type]
+          #     The type of the instance. Defaults to `PRODUCTION`.
+          # @!attribute [rw] labels
+          #   @return [::Google::Protobuf::Map{::String => ::String}]
+          #     Labels are a flexible and lightweight mechanism for organizing cloud
+          #     resources into groups that reflect a customer's organizational needs and
+          #     deployment strategies. They can be used to filter resources and aggregate
+          #     metrics.
+          #
+          #     * Label keys must be between 1 and 63 characters long and must conform to
+          #       the regular expression: `[\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62}`.
+          #     * Label values must be between 0 and 63 characters long and must conform to
+          #       the regular expression: `[\p{Ll}\p{Lo}\p{N}_-]{0,63}`.
+          #     * No more than 64 labels can be associated with a given resource.
+          #     * Keys and values must both be under 128 bytes.
+          class Instance
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # @!attribute [rw] key
+            #   @return [::String]
+            # @!attribute [rw] value
+            #   @return [::String]
+            class LabelsEntry
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Possible states of an instance.
+            module State
+              # The state of the instance could not be determined.
+              STATE_NOT_KNOWN = 0
+
+              # The instance has been successfully created and can serve requests
+              # to its tables.
+              READY = 1
+
+              # The instance is currently being created, and may be destroyed
+              # if the creation process encounters an error.
+              CREATING = 2
+            end
+
+            # The type of the instance.
+            module Type
+              # The type of the instance is unspecified. If set when creating an
+              # instance, a `PRODUCTION` instance will be created. If set when updating
+              # an instance, the type will be left unchanged.
+              TYPE_UNSPECIFIED = 0
+
+              # An instance meant for production use. `serve_nodes` must be set
+              # on the cluster.
+              PRODUCTION = 1
+
+              # The instance is meant for development and testing purposes only; it has
+              # no performance or uptime guarantees and is not covered by SLA.
+              # After a development instance is created, it can be upgraded by
+              # updating the instance to type `PRODUCTION`. An instance created
+              # as a production instance cannot be changed to a development instance.
+              # When creating a development instance, `serve_nodes` on the cluster must
+              # not be set.
+              DEVELOPMENT = 2
+            end
+          end
+
+          # A resizable group of nodes in a particular cloud location, capable
+          # of serving all {::Google::Cloud::Bigtable::Admin::V2::Table Tables} in the parent
+          # {::Google::Cloud::Bigtable::Admin::V2::Instance Instance}.
+          # @!attribute [r] name
+          #   @return [::String]
+          #     The unique name of the cluster. Values are of the form
+          #     `projects/{project}/instances/{instance}/clusters/[a-z][-a-z0-9]*`.
+          # @!attribute [rw] location
+          #   @return [::String]
+          #     (`CreationOnly`)
+          #     The location where this cluster's nodes and storage reside. For best
+          #     performance, clients should be located as close as possible to this
+          #     cluster. Currently only zones are supported, so values should be of the
+          #     form `projects/{project}/locations/{zone}`.
+          # @!attribute [r] state
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::Cluster::State]
+          #     The current state of the cluster.
+          # @!attribute [rw] serve_nodes
+          #   @return [::Integer]
+          #     Required. The number of nodes allocated to this cluster. More nodes enable
+          #     higher throughput and more consistent performance.
+          # @!attribute [rw] default_storage_type
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::StorageType]
+          #     (`CreationOnly`)
+          #     The type of storage used by this cluster to serve its
+          #     parent instance's tables, unless explicitly overridden.
+          class Cluster
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Possible states of a cluster.
+            module State
+              # The state of the cluster could not be determined.
+              STATE_NOT_KNOWN = 0
+
+              # The cluster has been successfully created and is ready to serve requests.
+              READY = 1
+
+              # The cluster is currently being created, and may be destroyed
+              # if the creation process encounters an error.
+              # A cluster may not be able to serve requests while being created.
+              CREATING = 2
+
+              # The cluster is currently being resized, and may revert to its previous
+              # node count if the process encounters an error.
+              # A cluster is still capable of serving requests while being resized,
+              # but may exhibit performance as if its number of allocated nodes is
+              # between the starting and requested states.
+              RESIZING = 3
+
+              # The cluster has no backing nodes. The data (tables) still
+              # exist, but no operations can be performed on the cluster.
+              DISABLED = 4
+            end
+          end
+
+          # A configuration object describing how Cloud Bigtable should treat traffic
+          # from a particular end user application.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     (`OutputOnly`)
+          #     The unique name of the app profile. Values are of the form
+          #     `projects/<project>/instances/<instance>/appProfiles/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`.
+          # @!attribute [rw] etag
+          #   @return [::String]
+          #     Strongly validated etag for optimistic concurrency control. Preserve the
+          #     value returned from `GetAppProfile` when calling `UpdateAppProfile` to
+          #     fail the request if there has been a modification in the mean time. The
+          #     `update_mask` of the request need not include `etag` for this protection
+          #     to apply.
+          #     See [Wikipedia](https://en.wikipedia.org/wiki/HTTP_ETag) and
+          #     [RFC 7232](https://tools.ietf.org/html/rfc7232#section-2.3) for more
+          #     details.
+          # @!attribute [rw] description
+          #   @return [::String]
+          #     Optional long form description of the use case for this AppProfile.
+          # @!attribute [rw] multi_cluster_routing_use_any
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::AppProfile::MultiClusterRoutingUseAny]
+          #     Use a multi-cluster routing policy.
+          # @!attribute [rw] single_cluster_routing
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::AppProfile::SingleClusterRouting]
+          #     Use a single-cluster routing policy.
+          class AppProfile
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Read/write requests are routed to the nearest cluster in the instance, and
+            # will fail over to the nearest cluster that is available in the event of
+            # transient errors or delays. Clusters in a region are considered
+            # equidistant. Choosing this option sacrifices read-your-writes consistency
+            # to improve availability.
+            class MultiClusterRoutingUseAny
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Unconditionally routes all read/write requests to a specific cluster.
+            # This option preserves read-your-writes consistency but does not improve
+            # availability.
+            # @!attribute [rw] cluster_id
+            #   @return [::String]
+            #     The cluster to which read/write requests should be routed.
+            # @!attribute [rw] allow_transactional_writes
+            #   @return [::Boolean]
+            #     Whether or not `CheckAndMutateRow` and `ReadModifyWriteRow` requests are
+            #     allowed by this app profile. It is unsafe to send these requests to
+            #     the same table/row/column in multiple clusters.
+            class SingleClusterRouting
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/bigtable/admin/v2/table.rb

@@ -0,0 +1,357 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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 Bigtable
+      module Admin
+        module V2
+          # Information about a table restore.
+          # @!attribute [rw] source_type
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::RestoreSourceType]
+          #     The type of the restore source.
+          # @!attribute [rw] backup_info
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::BackupInfo]
+          #     Information about the backup used to restore the table. The backup
+          #     may no longer exist.
+          class RestoreInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # A collection of user data indexed by row, column, and timestamp.
+          # Each table is served using the resources of its parent cluster.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Output only. The unique name of the table. Values are of the form
+          #     `projects/<project>/instances/<instance>/tables/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`.
+          #     Views: `NAME_ONLY`, `SCHEMA_VIEW`, `REPLICATION_VIEW`, `FULL`
+          # @!attribute [rw] cluster_states
+          #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Bigtable::Admin::V2::Table::ClusterState}]
+          #     Output only. Map from cluster ID to per-cluster table state.
+          #     If it could not be determined whether or not the table has data in a
+          #     particular cluster (for example, if its zone is unavailable), then
+          #     there will be an entry for the cluster with UNKNOWN `replication_status`.
+          #     Views: `REPLICATION_VIEW`, `FULL`
+          # @!attribute [rw] column_families
+          #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Bigtable::Admin::V2::ColumnFamily}]
+          #     (`CreationOnly`)
+          #     The column families configured for this table, mapped by column family ID.
+          #     Views: `SCHEMA_VIEW`, `FULL`
+          # @!attribute [rw] granularity
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::Table::TimestampGranularity]
+          #     (`CreationOnly`)
+          #     The granularity (i.e. `MILLIS`) at which timestamps are stored in
+          #     this table. Timestamps not matching the granularity will be rejected.
+          #     If unspecified at creation time, the value will be set to `MILLIS`.
+          #     Views: `SCHEMA_VIEW`, `FULL`.
+          # @!attribute [rw] restore_info
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::RestoreInfo]
+          #     Output only. If this table was restored from another data source (e.g. a
+          #     backup), this field will be populated with information about the restore.
+          class Table
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # The state of a table's data in a particular cluster.
+            # @!attribute [rw] replication_state
+            #   @return [::Google::Cloud::Bigtable::Admin::V2::Table::ClusterState::ReplicationState]
+            #     Output only. The state of replication for the table in this cluster.
+            class ClusterState
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Table replication states.
+              module ReplicationState
+                # The replication state of the table is unknown in this cluster.
+                STATE_NOT_KNOWN = 0
+
+                # The cluster was recently created, and the table must finish copying
+                # over pre-existing data from other clusters before it can begin
+                # receiving live replication updates and serving Data API requests.
+                INITIALIZING = 1
+
+                # The table is temporarily unable to serve Data API requests from this
+                # cluster due to planned internal maintenance.
+                PLANNED_MAINTENANCE = 2
+
+                # The table is temporarily unable to serve Data API requests from this
+                # cluster due to unplanned or emergency maintenance.
+                UNPLANNED_MAINTENANCE = 3
+
+                # The table can serve Data API requests from this cluster. Depending on
+                # replication delay, reads may not immediately reflect the state of the
+                # table in other clusters.
+                READY = 4
+
+                # The table is fully created and ready for use after a restore, and is
+                # being optimized for performance. When optimizations are complete, the
+                # table will transition to `READY` state.
+                READY_OPTIMIZING = 5
+              end
+            end
+
+            # @!attribute [rw] key
+            #   @return [::String]
+            # @!attribute [rw] value
+            #   @return [::Google::Cloud::Bigtable::Admin::V2::Table::ClusterState]
+            class ClusterStatesEntry
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # @!attribute [rw] key
+            #   @return [::String]
+            # @!attribute [rw] value
+            #   @return [::Google::Cloud::Bigtable::Admin::V2::ColumnFamily]
+            class ColumnFamiliesEntry
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Possible timestamp granularities to use when keeping multiple versions
+            # of data in a table.
+            module TimestampGranularity
+              # The user did not specify a granularity. Should not be returned.
+              # When specified during table creation, MILLIS will be used.
+              TIMESTAMP_GRANULARITY_UNSPECIFIED = 0
+
+              # The table keeps data versioned at a granularity of 1ms.
+              MILLIS = 1
+            end
+
+            # Defines a view over a table's fields.
+            module View
+              # Uses the default view for each method as documented in its request.
+              VIEW_UNSPECIFIED = 0
+
+              # Only populates `name`.
+              NAME_ONLY = 1
+
+              # Only populates `name` and fields related to the table's schema.
+              SCHEMA_VIEW = 2
+
+              # Only populates `name` and fields related to the table's replication
+              # state.
+              REPLICATION_VIEW = 3
+
+              # Populates all fields.
+              FULL = 4
+            end
+          end
+
+          # A set of columns within a table which share a common configuration.
+          # @!attribute [rw] gc_rule
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::GcRule]
+          #     Garbage collection rule specified as a protobuf.
+          #     Must serialize to at most 500 bytes.
+          #
+          #     NOTE: Garbage collection executes opportunistically in the background, and
+          #     so it's possible for reads to return a cell even if it matches the active
+          #     GC expression for its family.
+          class ColumnFamily
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Rule for determining which cells to delete during garbage collection.
+          # @!attribute [rw] max_num_versions
+          #   @return [::Integer]
+          #     Delete all cells in a column except the most recent N.
+          # @!attribute [rw] max_age
+          #   @return [::Google::Protobuf::Duration]
+          #     Delete cells in a column older than the given age.
+          #     Values must be at least one millisecond, and will be truncated to
+          #     microsecond granularity.
+          # @!attribute [rw] intersection
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::GcRule::Intersection]
+          #     Delete cells that would be deleted by every nested rule.
+          # @!attribute [rw] union
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::GcRule::Union]
+          #     Delete cells that would be deleted by any nested rule.
+          class GcRule
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # A GcRule which deletes cells matching all of the given rules.
+            # @!attribute [rw] rules
+            #   @return [::Array<::Google::Cloud::Bigtable::Admin::V2::GcRule>]
+            #     Only delete cells which would be deleted by every element of `rules`.
+            class Intersection
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # A GcRule which deletes cells matching any of the given rules.
+            # @!attribute [rw] rules
+            #   @return [::Array<::Google::Cloud::Bigtable::Admin::V2::GcRule>]
+            #     Delete cells which would be deleted by any element of `rules`.
+            class Union
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # A snapshot of a table at a particular time. A snapshot can be used as a
+          # checkpoint for data restoration or a data source for a new table.
+          #
+          # Note: This is a private alpha release of Cloud Bigtable snapshots. This
+          # feature is not currently available to most Cloud Bigtable customers. This
+          # feature might be changed in backward-incompatible ways and is not recommended
+          # for production use. It is not subject to any SLA or deprecation policy.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Output only. The unique name of the snapshot.
+          #     Values are of the form
+          #     `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>`.
+          # @!attribute [rw] source_table
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::Table]
+          #     Output only. The source table at the time the snapshot was taken.
+          # @!attribute [rw] data_size_bytes
+          #   @return [::Integer]
+          #     Output only. The size of the data in the source table at the time the
+          #     snapshot was taken. In some cases, this value may be computed
+          #     asynchronously via a background process and a placeholder of 0 will be used
+          #     in the meantime.
+          # @!attribute [rw] create_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. The time when the snapshot is created.
+          # @!attribute [rw] delete_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. The time when the snapshot will be deleted. The maximum amount
+          #     of time a snapshot can stay active is 365 days. If 'ttl' is not specified,
+          #     the default maximum of 365 days will be used.
+          # @!attribute [rw] state
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::Snapshot::State]
+          #     Output only. The current state of the snapshot.
+          # @!attribute [rw] description
+          #   @return [::String]
+          #     Output only. Description of the snapshot.
+          class Snapshot
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Possible states of a snapshot.
+            module State
+              # The state of the snapshot could not be determined.
+              STATE_NOT_KNOWN = 0
+
+              # The snapshot has been successfully created and can serve all requests.
+              READY = 1
+
+              # The snapshot is currently being created, and may be destroyed if the
+              # creation process encounters an error. A snapshot may not be restored to a
+              # table while it is being created.
+              CREATING = 2
+            end
+          end
+
+          # A backup of a Cloud Bigtable table.
+          # @!attribute [r] name
+          #   @return [::String]
+          #     Output only. A globally unique identifier for the backup which cannot be
+          #     changed. Values are of the form
+          #     `projects/{project}/instances/{instance}/clusters/{cluster}/
+          #        backups/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`
+          #     The final segment of the name must be between 1 and 50 characters
+          #     in length.
+          #
+          #     The backup is stored in the cluster identified by the prefix of the backup
+          #     name of the form
+          #     `projects/{project}/instances/{instance}/clusters/{cluster}`.
+          # @!attribute [rw] source_table
+          #   @return [::String]
+          #     Required. Immutable. Name of the table from which this backup was created.
+          #     This needs to be in the same instance as the backup. Values are of the form
+          #     `projects/{project}/instances/{instance}/tables/{source_table}`.
+          # @!attribute [rw] expire_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Required. The expiration time of the backup, with microseconds
+          #     granularity that must be at least 6 hours and at most 30 days
+          #     from the time the request is received. Once the `expire_time`
+          #     has passed, Cloud Bigtable will delete the backup and free the
+          #     resources used by the backup.
+          # @!attribute [r] start_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. `start_time` is the time that the backup was started
+          #     (i.e. approximately the time the
+          #     {::Google::Cloud::Bigtable::Admin::V2::BigtableTableAdmin::Client#create_backup CreateBackup}
+          #     request is received).  The row data in this backup will be no older than
+          #     this timestamp.
+          # @!attribute [r] end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. `end_time` is the time that the backup was finished. The row
+          #     data in the backup will be no newer than this timestamp.
+          # @!attribute [r] size_bytes
+          #   @return [::Integer]
+          #     Output only. Size of the backup in bytes.
+          # @!attribute [r] state
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::Backup::State]
+          #     Output only. The current state of the backup.
+          class Backup
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Indicates the current state of the backup.
+            module State
+              # Not specified.
+              STATE_UNSPECIFIED = 0
+
+              # The pending backup is still being created. Operations on the
+              # backup may fail with `FAILED_PRECONDITION` in this state.
+              CREATING = 1
+
+              # The backup is complete and ready for use.
+              READY = 2
+            end
+          end
+
+          # Information about a backup.
+          # @!attribute [r] backup
+          #   @return [::String]
+          #     Output only. Name of the backup.
+          # @!attribute [r] start_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. The time that the backup was started. Row data in the backup
+          #     will be no older than this timestamp.
+          # @!attribute [r] end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. This time that the backup was finished. Row data in the
+          #     backup will be no newer than this timestamp.
+          # @!attribute [r] source_table
+          #   @return [::String]
+          #     Output only. Name of the table the backup was created from.
+          class BackupInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Indicates the type of the restore source.
+          module RestoreSourceType
+            # No restore associated.
+            RESTORE_SOURCE_TYPE_UNSPECIFIED = 0
+
+            # A backup was used as the source of the restore.
+            BACKUP = 1
+          end
+        end
+      end
+    end
+  end
+end