google-cloud-bigtable-admin-v2 0.3.0 → 0.5.3

data/lib/google/cloud/bigtable/admin/v2/bigtable_table_admin/operations.rb

@@ -83,7 +83,7 @@ module Google
                 # Create credentials
                 credentials = @config.credentials
                 credentials ||= Credentials.default scope: @config.scope
-                if credentials.is_a?(String) || credentials.is_a?(Hash)
+                if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                   credentials = Credentials.new credentials, scope: @config.scope
                 end
                 @quota_project_id = @config.quota_project
@@ -397,9 +397,9 @@ module Google
               end
 
               ##
-              # Waits for the specified long-running operation until it is done or reaches
-              # at most a specified timeout, returning the latest state.  If the operation
-              # is already done, the latest state is immediately returned.  If the timeout
+              # Waits until the specified long-running operation is done or reaches at most
+              # a specified timeout, returning the latest state.  If the operation is
+              # already done, the latest state is immediately returned.  If the timeout
               # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
               # timeout is used.  If the server does not support this method, it returns
               # `google.rpc.Code.UNIMPLEMENTED`.
@@ -561,7 +561,7 @@ module Google
                 config_attr :scope,         nil, ::String, ::Array, nil
                 config_attr :lib_name,      nil, ::String, nil
                 config_attr :lib_version,   nil, ::String, nil
-                config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+                config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
                 config_attr :interceptors,  nil, ::Array, nil
                 config_attr :timeout,       nil, ::Numeric, nil
                 config_attr :metadata,      nil, ::Hash, nil
@@ -582,7 +582,7 @@ module Google
                 def rpcs
                   @rpcs ||= begin
                     parent_rpcs = nil
-                    parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                    parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                     Rpcs.new parent_rpcs
                   end
                 end
@@ -633,15 +633,15 @@ module Google
 
                   # @private
                   def initialize parent_rpcs = nil
-                    list_operations_config = parent_rpcs&.list_operations if parent_rpcs&.respond_to? :list_operations
+                    list_operations_config = parent_rpcs.list_operations if parent_rpcs.respond_to? :list_operations
                     @list_operations = ::Gapic::Config::Method.new list_operations_config
-                    get_operation_config = parent_rpcs&.get_operation if parent_rpcs&.respond_to? :get_operation
+                    get_operation_config = parent_rpcs.get_operation if parent_rpcs.respond_to? :get_operation
                     @get_operation = ::Gapic::Config::Method.new get_operation_config
-                    delete_operation_config = parent_rpcs&.delete_operation if parent_rpcs&.respond_to? :delete_operation
+                    delete_operation_config = parent_rpcs.delete_operation if parent_rpcs.respond_to? :delete_operation
                     @delete_operation = ::Gapic::Config::Method.new delete_operation_config
-                    cancel_operation_config = parent_rpcs&.cancel_operation if parent_rpcs&.respond_to? :cancel_operation
+                    cancel_operation_config = parent_rpcs.cancel_operation if parent_rpcs.respond_to? :cancel_operation
                     @cancel_operation = ::Gapic::Config::Method.new cancel_operation_config
-                    wait_operation_config = parent_rpcs&.wait_operation if parent_rpcs&.respond_to? :wait_operation
+                    wait_operation_config = parent_rpcs.wait_operation if parent_rpcs.respond_to? :wait_operation
                     @wait_operation = ::Gapic::Config::Method.new wait_operation_config
 
                     yield self if block_given?

data/lib/google/cloud/bigtable/admin/v2/bigtable_table_admin/paths.rb

@@ -65,6 +65,29 @@ module Google
                 "projects/#{project}/instances/#{instance}/clusters/#{cluster}"
               end
 
+              ##
+              # Create a fully-qualified CryptoKeyVersion resource string.
+              #
+              # The resource will be in the following format:
+              #
+              # `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`
+              #
+              # @param project [String]
+              # @param location [String]
+              # @param key_ring [String]
+              # @param crypto_key [String]
+              # @param crypto_key_version [String]
+              #
+              # @return [::String]
+              def crypto_key_version_path project:, location:, key_ring:, crypto_key:, crypto_key_version:
+                raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                raise ::ArgumentError, "key_ring cannot contain /" if key_ring.to_s.include? "/"
+                raise ::ArgumentError, "crypto_key cannot contain /" if crypto_key.to_s.include? "/"
+
+                "projects/#{project}/locations/#{location}/keyRings/#{key_ring}/cryptoKeys/#{crypto_key}/cryptoKeyVersions/#{crypto_key_version}"
+              end
+
               ##
               # Create a fully-qualified Instance resource string.
               #

data/lib/google/cloud/bigtable/admin/v2/version.rb

@@ -22,7 +22,7 @@ module Google
     module Bigtable
       module Admin
         module V2
-          VERSION = "0.3.0"
+          VERSION = "0.5.3"
         end
       end
     end

data/proto_docs/google/api/field_behavior.rb

@@ -57,9 +57,15 @@ module Google
 
       # 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
+      # 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
+
+      # Denotes that this field returns a non-empty default value if not set.
+      # This indicates that if the user provides the empty value in a request,
+      # a non-empty value will be returned. The user will not be aware of what
+      # non-empty value to expect.
+      NON_EMPTY_DEFAULT = 7
     end
   end
 end

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

@@ -27,8 +27,8 @@ module Google
           # @!attribute [rw] parent
           #   @return [::String]
           #     Required. The name of the instance in which to create the restored
-          #     table. This instance must be the parent of the source backup. Values are
-          #     of the form `projects/<project>/instances/<instance>`.
+          #     table. This instance must be in the same project as the source backup.
+          #     Values are of the form `projects/<project>/instances/<instance>`.
           # @!attribute [rw] table_id
           #   @return [::String]
           #     Required. The id of the table to create and restore to. This

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

@@ -130,10 +130,30 @@ module Google
           #     (`CreationOnly`)
           #     The type of storage used by this cluster to serve its
           #     parent instance's tables, unless explicitly overridden.
+          # @!attribute [rw] encryption_config
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::Cluster::EncryptionConfig]
+          #     Immutable. The encryption configuration for CMEK-protected clusters.
           class Cluster
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
 
+            # Cloud Key Management Service (Cloud KMS) settings for a CMEK-protected
+            # cluster.
+            # @!attribute [rw] kms_key_name
+            #   @return [::String]
+            #     Describes the Cloud KMS encryption key that will be used to protect the
+            #     destination Bigtable cluster. The requirements for this key are:
+            #      1) The Cloud Bigtable service account associated with the project that
+            #      contains this cluster must be granted the
+            #      `cloudkms.cryptoKeyEncrypterDecrypter` role on the CMEK key.
+            #      2) Only regional keys can be used and the region of the CMEK key must
+            #      match the region of the cluster.
+            #     3) All clusters within an instance must use the same CMEK key.
+            class EncryptionConfig
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
             # Possible states of a cluster.
             module State
               # The state of the cluster could not be determined.
@@ -166,7 +186,7 @@ module Google
           #   @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]*`.
+          #     `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

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

@@ -39,8 +39,8 @@ module Google
           # 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]*`.
+          #     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}]
@@ -48,7 +48,7 @@ module Google
           #     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`
+          #     Views: `REPLICATION_VIEW`, `ENCRYPTION_VIEW`, `FULL`
           # @!attribute [rw] column_families
           #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Bigtable::Admin::V2::ColumnFamily}]
           #     (`CreationOnly`)
@@ -73,6 +73,13 @@ module Google
             # @!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.
+            # @!attribute [r] encryption_info
+            #   @return [::Array<::Google::Cloud::Bigtable::Admin::V2::EncryptionInfo>]
+            #     Output only. The encryption information for the table in this cluster.
+            #     If the encryption key protecting this resource is customer managed, then
+            #     its version can be rotated in Cloud Key Management Service (Cloud KMS).
+            #     The primary version of the key and its status will be reflected here when
+            #     changes propagate from Cloud KMS.
             class ClusterState
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -151,6 +158,9 @@ module Google
               # state.
               REPLICATION_VIEW = 3
 
+              # Only populates 'name' and fields related to the table's encryption state.
+              ENCRYPTION_VIEW = 5
+
               # Populates all fields.
               FULL = 4
             end
@@ -208,6 +218,47 @@ module Google
             end
           end
 
+          # Encryption information for a given resource.
+          # If this resource is protected with customer managed encryption, the in-use
+          # Cloud Key Management Service (Cloud KMS) key version is specified along with
+          # its status.
+          # @!attribute [r] encryption_type
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::EncryptionInfo::EncryptionType]
+          #     Output only. The type of encryption used to protect this resource.
+          # @!attribute [r] encryption_status
+          #   @return [::Google::Rpc::Status]
+          #     Output only. The status of encrypt/decrypt calls on underlying data for
+          #     this resource. Regardless of status, the existing data is always encrypted
+          #     at rest.
+          # @!attribute [r] kms_key_version
+          #   @return [::String]
+          #     Output only. The version of the Cloud KMS key specified in the parent
+          #     cluster that is in use for the data underlying this table.
+          class EncryptionInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Possible encryption types for a resource.
+            module EncryptionType
+              # Encryption type was not specified, though data at rest remains encrypted.
+              ENCRYPTION_TYPE_UNSPECIFIED = 0
+
+              # The data backing this resource is encrypted at rest with a key that is
+              # fully managed by Google. No key version or status will be populated.
+              # This is the default state.
+              GOOGLE_DEFAULT_ENCRYPTION = 1
+
+              # The data backing this resource is encrypted at rest with a key that is
+              # managed by the customer.
+              # The in-use version of the key and its status are populated for
+              # CMEK-protected tables.
+              # CMEK-protected backups are pinned to the key version that was in use at
+              # the time the backup was taken. This key version is populated but its
+              # status is not tracked and is reported as `UNKNOWN`.
+              CUSTOMER_MANAGED_ENCRYPTION = 2
+            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.
           #
@@ -219,7 +270,7 @@ module Google
           #   @return [::String]
           #     Output only. The unique name of the snapshot.
           #     Values are of the form
-          #     `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>`.
+          #     `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.
@@ -304,6 +355,9 @@ module Google
           # @!attribute [r] state
           #   @return [::Google::Cloud::Bigtable::Admin::V2::Backup::State]
           #     Output only. The current state of the backup.
+          # @!attribute [r] encryption_info
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::EncryptionInfo]
+          #     Output only. The encryption information for the backup.
           class Backup
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/type/expr.rb

@@ -19,30 +19,53 @@
 
 module Google
   module Type
-    # Represents an expression text. Example:
+    # Represents a textual expression in the Common Expression Language (CEL)
+    # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+    # are documented at https://github.com/google/cel-spec.
     #
-    #     title: "User account presence"
-    #     description: "Determines whether the request has a user account"
-    #     expression: "size(request.user) > 0"
+    # Example (Comparison):
+    #
+    #     title: "Summary size limit"
+    #     description: "Determines if a summary is less than 100 chars"
+    #     expression: "document.summary.size() < 100"
+    #
+    # Example (Equality):
+    #
+    #     title: "Requestor is owner"
+    #     description: "Determines if requestor is the document owner"
+    #     expression: "document.owner == request.auth.claims.email"
+    #
+    # Example (Logic):
+    #
+    #     title: "Public documents"
+    #     description: "Determine whether the document should be publicly visible"
+    #     expression: "document.type != 'private' && document.type != 'internal'"
+    #
+    # Example (Data Manipulation):
+    #
+    #     title: "Notification string"
+    #     description: "Create a notification string with a timestamp."
+    #     expression: "'New message received at ' + string(document.create_time)"
+    #
+    # The exact variables and functions that may be referenced within an expression
+    # are determined by the service that evaluates it. See the service
+    # documentation for additional information.
     # @!attribute [rw] expression
     #   @return [::String]
-    #     Textual representation of an expression in
-    #     Common Expression Language syntax.
-    #
-    #     The application context of the containing message determines which
-    #     well-known feature set of CEL is supported.
+    #     Textual representation of an expression in Common Expression Language
+    #     syntax.
     # @!attribute [rw] title
     #   @return [::String]
-    #     An optional title for the expression, i.e. a short string describing
+    #     Optional. Title for the expression, i.e. a short string describing
     #     its purpose. This can be used e.g. in UIs which allow to enter the
     #     expression.
     # @!attribute [rw] description
     #   @return [::String]
-    #     An optional description of the expression. This is a longer text which
+    #     Optional. Description of the expression. This is a longer text which
     #     describes the expression, e.g. when hovered over it in a UI.
     # @!attribute [rw] location
     #   @return [::String]
-    #     An optional string indicating the location of the expression for error
+    #     Optional. String indicating the location of the expression for error
     #     reporting, e.g. a file name and a position in the file.
     class Expr
       include ::Google::Protobuf::MessageExts

metadata

@@ -1,29 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigtable-admin-v2
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.3
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-02-02 00:00:00.000000000 Z
+date: 2021-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement
@@ -47,7 +53,7 @@ dependencies:
         version: 0.6.10
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -57,21 +63,21 @@ dependencies:
         version: 0.6.10
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: google-style
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.24.0
+        version: 1.25.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.24.0
+        version: 1.25.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -235,14 +241,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.6
+rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Bigtable Admin V2 API