google-cloud-bigtable 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9eddd8059079440d6581a1e6342310ad31127c8f27f9f34a3e18d975a6a5d699
-  data.tar.gz: 637a977333b83097dc2a37bf70bf08b014305ed6409c258aeae3dba74ccb5602
+  metadata.gz: 3d888a5ae0e03db4d343f1f472df17e34e6749305a18907309afc1e9aba13451
+  data.tar.gz: 921696b2987c12c2480bf8407b9d19c500bdbfd0ff2ab2401a58a3880ca357d5
 SHA512:
-  metadata.gz: 0551601ee5fda48a466492e92a8c4c714f6fe06dde7a8cbe14c3ea6f25c8847df7afac42389cef51e414f239034dce1e93cf724087e0500ed25fb7663b0105a9
-  data.tar.gz: 85614a616934df1c135d279e5ed0136d2a382ce538535db1519e712e5d30942e3c75c5d69ac67918aab9568d183e74393b46652995f85568f4c602067d543c5d
+  metadata.gz: 5f898010312460f67d88380f2252a83b26acfd2e1220c31a09bacc1026c87066ffe184369807fc2fadcf17e49e98cee4ae255aaf771dd54617cdb706ba829f91
+  data.tar.gz: 17358abe5747ae235d77a62cbb4d3e0030939bb254111fbdd2d1dfea8e520681a1dbc4376b9c2a36d0880167864e109b89f4f42317bb1a59a43d748452dff7ec

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Release History
 
+### 0.6.1 / 2019-09-05
+
+#### Features
+	
+* Add IAM to low-level API client
+  * Add BigtableTableAdminClient#get_iam_policy
+  * Add BigtableTableAdminClient#set_iam_policy
+  * Add BigtableTableAdminClient#test_iam_permissions
+
+#### Documentation
+
+* Update low-level IAM documentation
+  * Update GetPolicyOption#requested_policy_version docs
+  * Un-deprecate Policy#version
+
 ### 0.6.0 / 2019-08-23
 
 #### Features

data/lib/google/bigtable/admin/v2/bigtable_table_admin_pb.rb

@@ -6,6 +6,8 @@ require 'google/protobuf'
 
 require 'google/api/annotations_pb'
 require 'google/bigtable/admin/v2/table_pb'
+require 'google/iam/v1/iam_policy_pb'
+require 'google/iam/v1/policy_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'

data/lib/google/bigtable/admin/v2/bigtable_table_admin_services_pb.rb

@@ -109,6 +109,14 @@ module Google
             # recommended for production use. It is not subject to any SLA or deprecation
             # policy.
             rpc :DeleteSnapshot, DeleteSnapshotRequest, Google::Protobuf::Empty
+            # Gets the access control policy for an instance resource. Returns an empty
+            # policy if an table exists but does not have a policy set.
+            rpc :GetIamPolicy, Google::Iam::V1::GetIamPolicyRequest, Google::Iam::V1::Policy
+            # Sets the access control policy on a table resource. Replaces any existing
+            # policy.
+            rpc :SetIamPolicy, Google::Iam::V1::SetIamPolicyRequest, Google::Iam::V1::Policy
+            # Returns permissions that the caller has on the specified table resource.
+            rpc :TestIamPermissions, Google::Iam::V1::TestIamPermissionsRequest, Google::Iam::V1::TestIamPermissionsResponse
           end
 
           Stub = Service.rpc_stub_class

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

@@ -361,6 +361,30 @@ module Google
                   {'name' => request.name}
                 end
               )
+              @get_iam_policy = Google::Gax.create_api_call(
+                @bigtable_table_admin_stub.method(:get_iam_policy),
+                defaults["get_iam_policy"],
+                exception_transformer: exception_transformer,
+                params_extractor: proc do |request|
+                  {'resource' => request.resource}
+                end
+              )
+              @set_iam_policy = Google::Gax.create_api_call(
+                @bigtable_table_admin_stub.method(:set_iam_policy),
+                defaults["set_iam_policy"],
+                exception_transformer: exception_transformer,
+                params_extractor: proc do |request|
+                  {'resource' => request.resource}
+                end
+              )
+              @test_iam_permissions = Google::Gax.create_api_call(
+                @bigtable_table_admin_stub.method(:test_iam_permissions),
+                defaults["test_iam_permissions"],
+                exception_transformer: exception_transformer,
+                params_extractor: proc do |request|
+                  {'resource' => request.resource}
+                end
+              )
               @snapshot_table = Google::Gax.create_api_call(
                 @bigtable_table_admin_stub.method(:snapshot_table),
                 defaults["snapshot_table"],
@@ -846,6 +870,130 @@ module Google
               @check_consistency.call(req, options, &block)
             end
 
+            # Gets the access control policy for an instance resource. Returns an empty
+            # policy if an table exists but does not have a policy set.
+            #
+            # @param resource [String]
+            #   REQUIRED: The resource for which the policy is being requested.
+            #   See the operation documentation for the appropriate value for this field.
+            # @param options_ [Google::Iam::V1::GetPolicyOptions | Hash]
+            #   OPTIONAL: A `GetPolicyOptions` object for specifying options to
+            #   `GetIamPolicy`. This field is only used by Cloud IAM.
+            #   A hash of the same form as `Google::Iam::V1::GetPolicyOptions`
+            #   can also be provided.
+            # @param options [Google::Gax::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout,
+            #   retries, etc.
+            # @yield [result, operation] Access the result along with the RPC operation
+            # @yieldparam result [Google::Iam::V1::Policy]
+            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @return [Google::Iam::V1::Policy]
+            # @raise [Google::Gax::GaxError] if the RPC is aborted.
+            # @example
+            #   require "google/cloud/bigtable/admin"
+            #
+            #   bigtable_table_admin_client = Google::Cloud::Bigtable::Admin::BigtableTableAdmin.new(version: :v2)
+            #   formatted_resource = Google::Cloud::Bigtable::Admin::V2::BigtableTableAdminClient.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+            #   response = bigtable_table_admin_client.get_iam_policy(formatted_resource)
+
+            def get_iam_policy \
+                resource,
+                options_: nil,
+                options: nil,
+                &block
+              req = {
+                resource: resource,
+                options: options_
+              }.delete_if { |_, v| v.nil? }
+              req = Google::Gax::to_proto(req, Google::Iam::V1::GetIamPolicyRequest)
+              @get_iam_policy.call(req, options, &block)
+            end
+
+            # Sets the access control policy on a table resource. Replaces any existing
+            # policy.
+            #
+            # @param resource [String]
+            #   REQUIRED: The resource for which the policy is being specified.
+            #   See the operation documentation for the appropriate value for this field.
+            # @param policy [Google::Iam::V1::Policy | Hash]
+            #   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.
+            #   A hash of the same form as `Google::Iam::V1::Policy`
+            #   can also be provided.
+            # @param options [Google::Gax::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout,
+            #   retries, etc.
+            # @yield [result, operation] Access the result along with the RPC operation
+            # @yieldparam result [Google::Iam::V1::Policy]
+            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @return [Google::Iam::V1::Policy]
+            # @raise [Google::Gax::GaxError] if the RPC is aborted.
+            # @example
+            #   require "google/cloud/bigtable/admin"
+            #
+            #   bigtable_table_admin_client = Google::Cloud::Bigtable::Admin::BigtableTableAdmin.new(version: :v2)
+            #   formatted_resource = Google::Cloud::Bigtable::Admin::V2::BigtableTableAdminClient.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+            #
+            #   # TODO: Initialize `policy`:
+            #   policy = {}
+            #   response = bigtable_table_admin_client.set_iam_policy(formatted_resource, policy)
+
+            def set_iam_policy \
+                resource,
+                policy,
+                options: nil,
+                &block
+              req = {
+                resource: resource,
+                policy: policy
+              }.delete_if { |_, v| v.nil? }
+              req = Google::Gax::to_proto(req, Google::Iam::V1::SetIamPolicyRequest)
+              @set_iam_policy.call(req, options, &block)
+            end
+
+            # Returns permissions that the caller has on the specified table resource.
+            #
+            # @param resource [String]
+            #   REQUIRED: The resource for which the policy detail is being requested.
+            #   See the operation documentation for the appropriate value for this field.
+            # @param permissions [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).
+            # @param options [Google::Gax::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout,
+            #   retries, etc.
+            # @yield [result, operation] Access the result along with the RPC operation
+            # @yieldparam result [Google::Iam::V1::TestIamPermissionsResponse]
+            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @return [Google::Iam::V1::TestIamPermissionsResponse]
+            # @raise [Google::Gax::GaxError] if the RPC is aborted.
+            # @example
+            #   require "google/cloud/bigtable/admin"
+            #
+            #   bigtable_table_admin_client = Google::Cloud::Bigtable::Admin::BigtableTableAdmin.new(version: :v2)
+            #   formatted_resource = Google::Cloud::Bigtable::Admin::V2::BigtableTableAdminClient.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+            #
+            #   # TODO: Initialize `permissions`:
+            #   permissions = []
+            #   response = bigtable_table_admin_client.test_iam_permissions(formatted_resource, permissions)
+
+            def test_iam_permissions \
+                resource,
+                permissions,
+                options: nil,
+                &block
+              req = {
+                resource: resource,
+                permissions: permissions
+              }.delete_if { |_, v| v.nil? }
+              req = Google::Gax::to_proto(req, Google::Iam::V1::TestIamPermissionsRequest)
+              @test_iam_permissions.call(req, options, &block)
+            end
+
             # Creates a new snapshot in the specified cluster from the specified
             # source table. The cluster and the table must be in the same instance.
             #

data/lib/google/cloud/bigtable/admin/v2/bigtable_table_admin_client_config.json

@@ -92,6 +92,21 @@
           "retry_codes_name": "idempotent",
           "retry_params_name": "idempotent_params"
         },
+        "GetIamPolicy": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "idempotent_params"
+        },
+        "SetIamPolicy": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "non_idempotent_params"
+        },
+        "TestIamPermissions": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "idempotent_params"
+        },
         "SnapshotTable": {
           "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",

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

@@ -20,9 +20,13 @@ module Google
       # @!attribute [rw] requested_policy_version
       #   @return [Integer]
       #     Optional. The policy format version to be returned.
-      #     Acceptable values are 0 and 1.
-      #     If the value is 0, or the field is omitted, policy format version 1 will be
-      #     returned.
+      #
+      #     Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+      #     rejected.
+      #
+      #     Requests for policies with any conditional bindings must specify version 3.
+      #     Policies without any conditional bindings may specify any valid value or
+      #     leave the field unset.
       class GetPolicyOptions; end
     end
   end

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

@@ -63,7 +63,14 @@ module Google
       #     [IAM developer's guide](https://cloud.google.com/iam/docs).
       # @!attribute [rw] version
       #   @return [Integer]
-      #     Deprecated.
+      #     Specifies the format of the policy.
+      #
+      #     Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+      #     rejected.
+      #
+      #     Policies with any conditional bindings must specify version 3. Policies
+      #     without any conditional bindings may specify any valid value or leave the
+      #     field unset.
       # @!attribute [rw] bindings
       #   @return [Array<Google::Iam::V1::Binding>]
       #     Associates a list of `members` to a `role`.

data/lib/google/cloud/bigtable/admin/v2/doc/google/protobuf/timestamp.rb

@@ -88,11 +88,13 @@ module Google
     # 01:30 UTC on January 15, 2017.
     #
     # In JavaScript, one can convert a Date object to this format using the
-    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
+    # standard
+    # [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
     # method. In Python, a standard `datetime.datetime` object can be converted
-    # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
-    # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
-    # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
+    # to this format using
+    # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
+    # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
+    # the Joda Time's [`ISODateTimeFormat.dateTime()`](
     # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Bigtable
-      VERSION = "0.6.0".freeze
+      VERSION = "0.6.1".freeze
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigtable
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-08-23 00:00:00.000000000 Z
+date: 2019-09-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-gax