google-cloud-bigtable 0.1.0

data/lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/instance.rb

@@ -0,0 +1,194 @@
+# Copyright 2018 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.
+
+module Google
+  module Bigtable
+    module Admin
+      module V2
+        # A collection of Bigtable {Google::Bigtable::Admin::V2::Table Tables} and
+        # the resources that serve them.
+        # All tables in an instance are served from a single
+        # {Google::Bigtable::Admin::V2::Cluster Cluster}.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     (+OutputOnly+)
+        #     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]
+        #     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::Bigtable::Admin::V2::Instance::State]
+        #     (+OutputOnly+)
+        #     The current state of the instance.
+        # @!attribute [rw] type
+        #   @return [Google::Bigtable::Admin::V2::Instance::Type]
+        #     The type of the instance. Defaults to +PRODUCTION+.
+        # @!attribute [rw] labels
+        #   @return [Hash{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
+          # 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::Bigtable::Admin::V2::Table Tables} in the parent
+        # {Google::Bigtable::Admin::V2::Instance Instance}.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     (+OutputOnly+)
+        #     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 [rw] state
+        #   @return [Google::Bigtable::Admin::V2::Cluster::State]
+        #     (+OutputOnly+)
+        #     The current state of the cluster.
+        # @!attribute [rw] serve_nodes
+        #   @return [Integer]
+        #     The number of nodes allocated to this cluster. More nodes enable higher
+        #     throughput and more consistent performance.
+        # @!attribute [rw] default_storage_type
+        #   @return [Google::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
+          # 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::Bigtable::Admin::V2::AppProfile::MultiClusterRoutingUseAny]
+        #     Use a multi-cluster routing policy that may pick any cluster.
+        # @!attribute [rw] single_cluster_routing
+        #   @return [Google::Bigtable::Admin::V2::AppProfile::SingleClusterRouting]
+        #     Use a single-cluster routing policy.
+        class AppProfile
+          # Read/write requests may be routed to any cluster in the instance, and will
+          # fail over to another cluster in the event of transient errors or delays.
+          # Choosing this option sacrifices read-your-writes consistency to improve
+          # availability.
+          class MultiClusterRoutingUseAny; 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 [true, false]
+          #     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; end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/table.rb

@@ -0,0 +1,209 @@
+# Copyright 2018 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.
+
+module Google
+  module Bigtable
+    module Admin
+      module V2
+        # 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]
+        #     (+OutputOnly+)
+        #     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 [Hash{String => Google::Bigtable::Admin::V2::Table::ClusterState}]
+        #     (+OutputOnly+)
+        #     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 [Hash{String => Google::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::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+
+        class Table
+          # The state of a table's data in a particular cluster.
+          # @!attribute [rw] replication_state
+          #   @return [Google::Bigtable::Admin::V2::Table::ClusterState::ReplicationState]
+          #     (+OutputOnly+)
+          #     The state of replication for the table in this cluster.
+          class ClusterState
+            # 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
+            end
+          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::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; 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::Bigtable::Admin::V2::GcRule::Intersection]
+        #     Delete cells that would be deleted by every nested rule.
+        # @!attribute [rw] union
+        #   @return [Google::Bigtable::Admin::V2::GcRule::Union]
+        #     Delete cells that would be deleted by any nested rule.
+        class GcRule
+          # A GcRule which deletes cells matching all of the given rules.
+          # @!attribute [rw] rules
+          #   @return [Array<Google::Bigtable::Admin::V2::GcRule>]
+          #     Only delete cells which would be deleted by every element of +rules+.
+          class Intersection; end
+
+          # A GcRule which deletes cells matching any of the given rules.
+          # @!attribute [rw] rules
+          #   @return [Array<Google::Bigtable::Admin::V2::GcRule>]
+          #     Delete cells which would be deleted by any element of +rules+.
+          class Union; 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]
+        #     (+OutputOnly+)
+        #     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::Bigtable::Admin::V2::Table]
+        #     (+OutputOnly+)
+        #     The source table at the time the snapshot was taken.
+        # @!attribute [rw] data_size_bytes
+        #   @return [Integer]
+        #     (+OutputOnly+)
+        #     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]
+        #     (+OutputOnly+)
+        #     The time when the snapshot is created.
+        # @!attribute [rw] delete_time
+        #   @return [Google::Protobuf::Timestamp]
+        #     (+OutputOnly+)
+        #     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::Bigtable::Admin::V2::Snapshot::State]
+        #     (+OutputOnly+)
+        #     The current state of the snapshot.
+        # @!attribute [rw] description
+        #   @return [String]
+        #     (+OutputOnly+)
+        #     Description of the snapshot.
+        class Snapshot
+          # 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
+      end
+    end
+  end
+end

data/lib/google/cloud/bigtable/admin/v2/doc/google/iam/v1/iam_policy.rb

@@ -0,0 +1,62 @@
+# Copyright 2018 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.
+
+module Google
+  module Iam
+    module V1
+      # Request message for +SetIamPolicy+ method.
+      # @!attribute [rw] resource
+      #   @return [String]
+      #     REQUIRED: The resource for which the policy is being specified.
+      #     +resource+ is usually specified as a path. For example, a Project
+      #     resource is specified as +projects/{project}+.
+      # @!attribute [rw] policy
+      #   @return [Google::Iam::V1::Policy]
+      #     REQUIRED: The complete policy to be applied to the +resource+. The size of
+      #     the policy is limited to a few 10s of KB. An empty policy is a
+      #     valid policy but certain Cloud Platform services (such as Projects)
+      #     might reject them.
+      class SetIamPolicyRequest; end
+
+      # Request message for +GetIamPolicy+ method.
+      # @!attribute [rw] resource
+      #   @return [String]
+      #     REQUIRED: The resource for which the policy is being requested.
+      #     +resource+ is usually specified as a path. For example, a Project
+      #     resource is specified as +projects/{project}+.
+      class GetIamPolicyRequest; end
+
+      # Request message for +TestIamPermissions+ method.
+      # @!attribute [rw] resource
+      #   @return [String]
+      #     REQUIRED: The resource for which the policy detail is being requested.
+      #     +resource+ is usually specified as a path. For example, a Project
+      #     resource is specified as +projects/{project}+.
+      # @!attribute [rw] permissions
+      #   @return [Array<String>]
+      #     The set of permissions to check for the +resource+. Permissions with
+      #     wildcards (such as '*' or 'storage.*') are not allowed. For more
+      #     information see
+      #     [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+      class TestIamPermissionsRequest; end
+
+      # Response message for +TestIamPermissions+ method.
+      # @!attribute [rw] permissions
+      #   @return [Array<String>]
+      #     A subset of +TestPermissionsRequest.permissions+ that the caller is
+      #     allowed.
+      class TestIamPermissionsResponse; end
+    end
+  end
+end