google-cloud-bigtable 0.7.0 → 1.1.0

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

@@ -19,7 +19,7 @@ module Google
   module Cloud
     module Bigtable
       # @private
-      # # RowsMutator
+      # # ChunkProcessor
       #
       # Read a chunk of data and merge it based on states and build rows and cells
       #

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

@@ -56,7 +56,7 @@ module Google
         end
 
         ##
-        # The unique identifier for the project.
+        # The unique identifier for the project to which the cluster belongs.
         #
         # @return [String]
         #
@@ -65,7 +65,7 @@ module Google
         end
 
         ##
-        # The unique identifier for the instance.
+        # The unique identifier for the instance to which the cluster belongs.
         #
         # @return [String]
         #
@@ -93,7 +93,7 @@ module Google
         end
 
         ##
-        # The current instance state.
+        # The current state of the cluster.
         # Possible values are
         # `:CREATING`, `:READY`, `:STATE_NOT_KNOWN`, `:RESIZING`, `:DISABLED`.
         #
@@ -113,7 +113,7 @@ module Google
         end
 
         ##
-        # The instance is currently being created, and may be destroyed if the
+        # The cluster is currently being created, and may be destroyed if the
         # creation process encounters an error.
         #
         # @return [Boolean]
@@ -197,9 +197,9 @@ module Google
         end
 
         ##
-        # Update cluster.
+        # Updates the cluster.
         #
-        # `serve_nodes` is the only updatable field
+        # `serve_nodes` is the only updatable field.
         #
         # @return [Google::Cloud::Bigtable::Cluster::Job]
         #   The job representing the long-running, asynchronous processing of
@@ -235,7 +235,7 @@ module Google
         alias update save
 
         ##
-        # Reloads cluster information.
+        # Reloads cluster data.
         #
         # @return [Google::Cloud::Bigtable::Cluster]
         #

data/lib/google/cloud/bigtable/cluster/list.rb

@@ -53,7 +53,7 @@ module Google
           end
 
           ##
-          # Whether there is a next page of instances.
+          # Whether there is a next page of clusters.
           #
           # @return [Boolean]
           #
@@ -126,7 +126,7 @@ module Google
           #   bigtable = Google::Cloud::Bigtable.new
           #
           #   all_cluster_ids = bigtable.clusters.all.map do |cluster|
-          #     puts cluster.instance_id
+          #     puts cluster.cluster_id
           #   end
           #
           def all

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

@@ -37,10 +37,12 @@ module Google
       #   puts column_family.gc_rule
       #
       class ColumnFamily
-        # Name of the column family
+        ##
+        # Name of the column family.
         # @return [String]
         attr_reader :name
 
+        ##
         # The garbage collection rule to be used for the column family.
         # Optional. The service default value will be used when not specified.
         # @return [Google::Cloud::Bigtable::GcRule, nil]
@@ -52,14 +54,6 @@ module Google
           @gc_rule = gc_rule
         end
 
-        # @private
-        # @return [Google::Bigtable::Admin::V2::ColumnFamily]
-        def to_grpc
-          grpc = Google::Bigtable::Admin::V2::ColumnFamily.new
-          grpc.gc_rule = gc_rule.to_grpc if gc_rule
-          grpc
-        end
-
         # @private
         #
         # Create a new ColumnFamily instance from a {Google::Bigtable::Admin::V2::ColumnFamily}.

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

@@ -79,7 +79,7 @@ module Google
         include Enumerable
 
         ##
-        # Create a new ColumnFamilyMap object.
+        # Creates a new ColumnFamilyMap object.
         #
         # @example
         #   require "google/cloud/bigtable"
@@ -108,14 +108,14 @@ module Google
         end
 
         ##
-        # Calls block once for each column family in the map, passing passing
+        # Calls the block once for each column family in the map, passing
         # the name and column family pair as parameters.
         #
         # If no block is given, an enumerator is returned instead.
         #
-        # @yield [name, column_family] The name and column family pair
-        # @yieldparam [String] name the column family name
-        # @yieldparam [ColumnFamily] column_family the column family object
+        # @yield [name, column_family] The name and column family pair.
+        # @yieldparam [String] name the column family name.
+        # @yieldparam [ColumnFamily] column_family the column family object.
         #
         # @return [Enumerator]
         #
@@ -183,7 +183,7 @@ module Google
         # Adds a new column family to the table.
         #
         # @overload add(name, gc_rule: nil)
-        #   @param name [String] Column family name
+        #   @param name [String] Column family name.
         #   @param gc_rule [Google::Cloud::Bigtable::GcRule] The garbage
         #     collection rule to be used for the column family. Optional. The
         #     service default value will be used when not specified.
@@ -222,7 +222,7 @@ module Google
         ##
         # Updates an existing column family in the table.
         #
-        # @param name [String] Column family name
+        # @param name [String] Column family name.
         # @param gc_rule [Google::Cloud::Bigtable::GcRule] The new garbage
         #   collection rule to be used for the column family. Optional. The
         #   service default value will be used when not specified.
@@ -258,7 +258,7 @@ module Google
         ##
         # Deletes the named column family from the table.
         #
-        # @param name [String] Column family name
+        # @param name [String] Column family name.
         #
         # @raise [ArgumentError] if the column family name does not exist.
         # @raise [FrozenError] if the column family map is frozen.

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

@@ -60,7 +60,7 @@ module Google
         end
 
         ##
-        # Get column family name
+        # Gets the column family name.
         #
         # @return [String]
         #
@@ -69,7 +69,7 @@ module Google
         end
 
         ##
-        # Set column family name
+        # Sets the column family name.
         #
         # @param name [String] Column family name
         #
@@ -78,7 +78,7 @@ module Google
         end
 
         ##
-        # Set column range with the lower bound.
+        # Sets the column range with the lower bound.
         #
         # @param qualifier [String] Column qualifier name. Required
         # @param inclusive [String] Lower bound flag. Inclusive/Exclusive.
@@ -111,7 +111,7 @@ module Google
         end
 
         ##
-        # Set column range with the upper bound.
+        # Sets the column range with the upper bound.
         #
         # @param qualifier [String] Column qualifier name. Required.
         # @param inclusive [String] Upper bound flag. Inclusive/Exclusive.
@@ -144,7 +144,7 @@ module Google
         end
 
         ##
-        # Set column range with the inclusive upper and lower bound.
+        # Sets the column range with the inclusive upper and lower bound.
         #
         # @param from_qualifier [String] Inclusive from qualifier. Required.
         # @param to_qualifier [String] Inclusive to qualifier. Required.
@@ -163,7 +163,7 @@ module Google
         end
 
         ##
-        # Set column range with the inclusive upper and the exclusive lower bound.
+        # Sets the column range with the inclusive upper and the exclusive lower bound.
         #
         # @param from_qualifier [String] Inclusive from qualifier
         # @param to_qualifier [String] Exclusive to qualifier

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

@@ -219,12 +219,12 @@ module Google
         end
 
         ##
-        # Create GcRule instance with max number of versions.
+        # Creates a GcRule instance with max number of versions.
         #
         # @param versions [Integer] Max number of versions
         # @return [Google::Cloud::Bigtable::GcRule]
         #
-        # @example Create a table with column families.
+        # @example
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -240,12 +240,12 @@ module Google
         end
 
         ##
-        # Create GcRule instance with max age.
+        # Creates a GcRule instance with max age.
         #
         # @param age [Integer] Max age in seconds.
         # @return [Google::Cloud::Bigtable::GcRule]
         #
-        # @example Create a table with column families.
+        # @example
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -261,13 +261,13 @@ module Google
         end
 
         ##
-        # Create union GcRule instance.
+        # Creates a union GcRule instance.
         #
         # @param rules [Google::Cloud::Bigtable::GcRule, Array<Google::Cloud::Bigtable::GcRule>]
         #   List of GcRule with nested rules.
         # @return [Google::Cloud::Bigtable::GcRule]
         #
-        # @example Create a table with column families.
+        # @example
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -287,13 +287,13 @@ module Google
         end
 
         ##
-        # Create intersection GCRule instance.
+        # Creates a intersection GCRule instance.
         #
         # @param rules [Google::Cloud::Bigtable::GcRule, Array<Google::Cloud::Bigtable::GcRule>]
         #   List of GcRule with nested rules.
         # @return [Google::Cloud::Bigtable::GcRule]
         #
-        # @example Create a table with column families.
+        # @example
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new

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

@@ -29,7 +29,7 @@ module Google
       # # Instance
       #
       # Represents a Bigtable instance. Instances are dedicated Bigtable
-      # storage resources that Bigtable tables.
+      # storage resources that contain Bigtable tables.
       #
       # See {Google::Cloud::Bigtable::Project#instances},
       # {Google::Cloud::Bigtable::Project#instance}, and
@@ -46,7 +46,7 @@ module Google
       #     type: :DEVELOPMENT,
       #     labels: { "env" => "dev"}
       #   ) do |clusters|
-      #     clusters.add("test-cluster", "us-east1-b", nodes: 1)
+      #     clusters.add("test-cluster", "us-east1-b") # nodes not allowed
       #   end
       #
       #   job.done? #=> false
@@ -75,7 +75,7 @@ module Google
         end
 
         ##
-        # The unique identifier for the project.
+        # The unique identifier for the project to which the instance belongs.
         #
         # @return [String]
         #
@@ -93,7 +93,7 @@ module Google
         end
 
         ##
-        # The descriptive name for this instance as it appears in UIs. Must be
+        # The descriptive name for the instance as it appears in UIs. Must be
         # unique per project and between 4 and 30 characters long.
         #
         # @return [String]
@@ -103,11 +103,11 @@ module Google
         end
 
         ##
-        # Updates the descriptive name for this instance as it appears in UIs.
+        # Updates the descriptive name for the instance as it appears in UIs.
         # Can be changed at any time, but should be kept globally unique
         # to avoid confusion.
         #
-        # @param value [String] The descriptive name for this instance.
+        # @param value [String] The descriptive name for the instance.
         #
         def display_name= value
           @grpc.display_name = value
@@ -154,8 +154,7 @@ module Google
         end
 
         ##
-        # Instance type. Possible values are `:DEVELOPMENT`, `:PRODUCTION`,
-        # `:TYPE_UNSPECIFIED`
+        # Instance type. Possible values include `:DEVELOPMENT` and `:PRODUCTION`.
         #
         # @return [Symbol]
         #
@@ -167,10 +166,10 @@ module Google
         # 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
+        # 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.
+        # When creating a development instance, `nodes` on the cluster must
+        # not be set. (See {#create_cluster}.)
         #
         # @return [Boolean]
         #
@@ -179,8 +178,8 @@ module Google
         end
 
         ##
-        # An instance meant for production use. `serve_nodes` must be set
-        # on the cluster.
+        # An instance meant for production use. Requires that `nodes` must be set
+        # on the cluster. (See {#create_cluster}.)
         #
         # @return [Boolean]
         #
@@ -189,22 +188,34 @@ module Google
         end
 
         ##
-        # Set instance type.
+        # Sets the instance type.
         #
-        # Valid values are `:DEVELOPMENT`, `:PRODUCTION`.
+        # Valid values are `:DEVELOPMENT` and `:PRODUCTION`.
         # After a development instance is created, it can be upgraded
-        # by updating the instance to type `PRODUCTION`.
+        # by updating the instance to type `:PRODUCTION`.
         # An instance created as a production instance cannot be changed to a
         # development instance.
         #
         # @param instance_type [Symbol]
         #
+        # @example
+        #   require "google/cloud/bigtable"
+        #
+        #   bigtable = Google::Cloud::Bigtable.new
+        #
+        #   instance = bigtable.instance("my-instance")
+        #
+        #   instance.development? # true
+        #   instance.type = :PRODUCTION
+        #   instance.development? # false
+        #   instance.production? # true
+        #
         def type= instance_type
           @grpc.type = instance_type
         end
 
         ##
-        # Get instance labels.
+        # Gets the Cloud Labels for the instance.
         #
         # Cloud Labels are a flexible and lightweight mechanism for organizing
         # cloud resources into groups that reflect a customer's organizational
@@ -226,7 +237,7 @@ module Google
         end
 
         ##
-        # Set the Cloud Labels.
+        # Sets the Cloud Labels for the instance.
         #
         # @param labels [Hash{String=>String}] The Cloud Labels.
         #
@@ -239,10 +250,10 @@ module Google
         end
 
         ##
-        # Update instance.
+        # Updates the instance.
         #
-        # Updatable attributes are :
-        #   * `display_name` - The descriptive name for this instance.
+        # Updatable attributes are:
+        #   * `display_name` - The descriptive name for the instance.
         #   * `type` -  `:DEVELOPMENT` type instance can be upgraded to `:PRODUCTION` instance.
         #     An instance created as a production instance cannot be changed to a development instance.
         #   * `labels` - Cloud Labels are a flexible and lightweight mechanism for organizing cloud resources.
@@ -250,6 +261,7 @@ module Google
         # @return [Google::Cloud::Bigtable::Instance::Job]
         #   The job representing the long-running, asynchronous processing of
         #   an instance update operation.
+        #
         # @example
         #   require "google/cloud/bigtable"
         #
@@ -283,7 +295,7 @@ module Google
         alias update save
 
         ##
-        # Reload instance information.
+        # Reloads instance data.
         #
         # @return [Google::Cloud::Bigtable::Instance]
         #
@@ -293,7 +305,7 @@ module Google
         end
 
         ##
-        # Permanently deletes the instance from a project.
+        # Permanently deletes the instance from the project.
         #
         # @return [Boolean] Returns `true` if the instance was deleted.
         #
@@ -312,16 +324,16 @@ module Google
         end
 
         ##
-        # Lists information about clusters in an instance.
+        # Lists the clusters in the instance.
         #
-        #  See to delete {Google::Cloud::Bigtable::Cluster#delete} and update
-        #  cluster {Google::Cloud::Bigtable::Cluster#save}.
+        # See {Google::Cloud::Bigtable::Cluster#delete} and
+        # {Google::Cloud::Bigtable::Cluster#save}.
         #
         # @param token [String] The `token` value returned by the last call to
         #   `clusters`; indicates that this is a continuation of a call
         #   and that the system should return the next page of data.
         # @return [Array<Google::Cloud::Bigtable::Cluster>]
-        #  See({Google::Cloud::Bigtable::Cluster::List})
+        #   See({Google::Cloud::Bigtable::Cluster::List})
         #
         # @example
         #   require "google/cloud/bigtable"
@@ -341,10 +353,10 @@ module Google
         end
 
         ##
-        # Gets cluster information.
+        # Gets a cluster in the instance.
         #
-        #  See to delete {Google::Cloud::Bigtable::Cluster#delete} and update
-        #  cluster {Google::Cloud::Bigtable::Cluster#save}.
+        # See {Google::Cloud::Bigtable::Cluster#delete} and
+        # {Google::Cloud::Bigtable::Cluster#save}.
         #
         # @param cluster_id [String] The unique ID of the requested cluster.
         # @return [Google::Cloud::Bigtable::Cluster, nil]
@@ -368,11 +380,10 @@ module Google
         end
 
         ##
-        # Creates a cluster within an instance.
+        # Creates a cluster in the instance.
         #
         # @param cluster_id [String]
-        #   The ID to be used when referring to the new cluster within its instance,
-        #   e.g., just `mycluster`
+        #   The ID to be used when referring to the new cluster within its instance.
         # @param location [String]
         #   The location where this cluster's nodes and storage reside. For best
         #   performance, clients should be located as close as possible to this
@@ -426,10 +437,10 @@ module Google
         end
 
         ##
-        # List all tables.
+        # Lists all tables in the instance.
         #
-        #  See to delete table {Google::Cloud::Bigtable::Table#delete} and update
-        #  table {Google::Cloud::Bigtable::Table#save}.
+        #  See {Google::Cloud::Bigtable::Table#delete} and
+        #  {Google::Cloud::Bigtable::Table#save}.
         #
         # @return [Array<Google::Cloud::Bigtable::Table>]
         #   (See {Google::Cloud::Bigtable::Table::List})
@@ -453,10 +464,10 @@ module Google
         end
 
         ##
-        # Get metadata information of table.
+        # Gets metadata information of a table in the instance.
         #
         # @param view [Symbol]
-        #   The view to be applied to the returned tables' fields
+        #   The view to be applied to the returned tables' fields.
         #   Defaults to `SCHEMA_VIEW` if unspecified.
         #   Valid view types are.
         #   * `:NAME_ONLY` - Only populates `name`
@@ -481,7 +492,6 @@ module Google
         #
         #   instance = bigtable.instance("my-instance")
         #
-        #   # Default view is full view
         #   table = instance.table("my-table", perform_lookup: true)
         #   puts table.name
         #   puts table.column_families
@@ -490,7 +500,7 @@ module Google
         #   table = instance.table("my-table", view: :NAME_ONLY, perform_lookup: true)
         #   puts table.name
         #
-        # @example  Mutate rows
+        # @example  Mutate rows.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -524,14 +534,14 @@ module Google
         end
 
         ##
-        # Creates a new table.
+        # Creates a new table in the instance.
         #
         # The table can be created with a full set of initial column families,
         # specified in the request.
         #
         # @param name [String]
         #   The name by which the new table should be referred to within the parent
-        #   instance, e.g., `foobar`
+        #   instance.
         # @param column_families [Google::Cloud::Bigtable::ColumnFamilyMap]
         #   An object containing the column families for the table, mapped by
         #   column family name.
@@ -610,11 +620,11 @@ module Google
         end
 
         ##
-        # Create app profile for an instance with a routing policy.
-        # Only one routing policy can applied to app profile. The policy can be
+        # Creates an app profile for the instance with a routing policy.
+        # Only one routing policy can applied to the app profile. The policy can be
         # multi-cluster routing or single cluster routing.
         #
-        # @param name [String] Unique Id of the app profile
+        # @param name [String] Unique ID of the app profile.
         # @param routing_policy [Google::Cloud::Bigtable::RoutingPolicy]
         #   The routing policy for all read/write requests that use this app
         #   profile. A value must be explicitly set.
@@ -630,7 +640,7 @@ module Google
         #     preserves read-your-writes consistency but does not improve
         #     availability. Value contains `cluster_id` and optional field
         #     `allow_transactional_writes`.
-        # @param description [String] Description of the use case for this app profile
+        # @param description [String] Description of the use case for this app profile.
         # @param etag [String]
         #   Strongly validated etag for optimistic concurrency control. Preserve the
         #   value returned from `GetAppProfile` when calling `UpdateAppProfile` to
@@ -641,10 +651,10 @@ module Google
         #   [RFC 7232](https://tools.ietf.org/html/rfc7232#section-2.3) for more details.
         # @param ignore_warnings [Boolean]
         #   If true, ignore safety checks when creating the app profile.
-        #   Default value is `false`
+        #   Default value is `false`.
         # @return [Google::Cloud::Bigtable::AppProfile]
         #
-        # @example Create an app profile with a single cluster routing policy
+        # @example Create an app profile with a single cluster routing policy.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -663,7 +673,7 @@ module Google
         #   )
         #   puts app_profile.name
         #
-        # @example Create an app profile with multi-cluster routing policy
+        # @example Create an app profile with multi-cluster routing policy.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -722,10 +732,10 @@ module Google
         end
 
         ##
-        # Get app profile.
+        # Gets an app profile in the instance.
         #
-        #  See to delete app_profile {Google::Cloud::Bigtable::AppProfile#delete} and update
-        #  app_profile {Google::Cloud::Bigtable::AppProfile#save}.
+        # See {Google::Cloud::Bigtable::AppProfile#delete} and
+        # {Google::Cloud::Bigtable::AppProfile#save}.
         #
         # @param app_profile_id [String] The unique name of the requested app profile.
         # @return [Google::Cloud::Bigtable::AppProfile, nil]
@@ -752,13 +762,13 @@ module Google
         end
 
         ##
-        # List all app profiles
+        # Lists all app profiles in the instance.
         #
-        #  See to delete app_profile {Google::Cloud::Bigtable::AppProfile#delete} and update
-        #  app_profile {Google::Cloud::Bigtable::AppProfile#save}.
+        # See {Google::Cloud::Bigtable::AppProfile#delete} and
+        # {Google::Cloud::Bigtable::AppProfile#save}.
         #
         # @return [Array<Google::Cloud::Bigtable::AppProfile>]
-        #  (See {Google::Cloud::Bigtable::AppProfile::List})
+        #   (See {Google::Cloud::Bigtable::AppProfile::List})
         #
         # @example
         #   require "google/cloud/bigtable"
@@ -779,7 +789,7 @@ module Google
 
         ##
         # Gets the [Cloud IAM](https://cloud.google.com/iam/) access control
-        # policy for this instance.
+        # policy for the instance.
         #
         # @see https://cloud.google.com/bigtable/docs/access-control
         #
@@ -788,9 +798,9 @@ module Google
         #   the block completes, the modified policy will be written to the
         #   service.
         # @yieldparam [Policy] policy the current Cloud IAM Policy for this
-        #   instance
+        #   instance.
         #
-        # @return [Policy] The current Cloud IAM Policy for this instance.
+        # @return [Policy] The current Cloud IAM Policy for the instance.
         #
         # @example
         #   require "google/cloud/bigtable"
@@ -800,7 +810,7 @@ module Google
         #   instance = bigtable.instance("my-instance")
         #   policy = instance.policy
         #
-        # @example Update the policy by passing a block:
+        # @example Update the policy by passing a block.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -821,7 +831,7 @@ module Google
 
         ##
         # Updates the [Cloud IAM](https://cloud.google.com/iam/) access control
-        # policy for this instance. The policy should be read from {#policy}.
+        # policy for the instance. The policy should be read from {#policy}.
         # See {Google::Cloud::Bigtable::Policy} for an explanation of the policy
         # `etag` property and how to modify policies.
         #
@@ -844,7 +854,7 @@ module Google
         #   policy.add("roles/owner", "user:owner@example.com")
         #   updated_policy = instance.update_policy(policy)
         #
-        #   puts update_policy.roles
+        #   puts updated_policy.roles
         #
         def update_policy new_policy
           ensure_service!
@@ -857,13 +867,13 @@ module Google
         # Tests the specified permissions against the [Cloud
         # IAM](https://cloud.google.com/iam/) access control policy.
         #
-        # @see https://cloud.google.com/iam/docs/managing-policies Managing
-        #   Policies
+        # @see https://cloud.google.com/iam/docs/managing-policies Managing Policies
+        # @see https://cloud.google.com/bigtable/docs/access-control Access Control
         #
         # @param permissions [String, Array<String>] permissions The set of permissions to
         #   check access for. Permissions with wildcards (such as `*` or
         #   `bigtable.*`) are not allowed.
-        #   See (https://cloud.google.com/bigtable/docs/access-control)
+        #   See [Access Control](https://cloud.google.com/bigtable/docs/access-control).
         #
         #   Some of the permissions that can be checked on a instance are:
         #   * bigtable.instances.create
@@ -874,7 +884,7 @@ module Google
         #   * bigtable.tables.get
         #   * bigtable.tables.list
         #
-        # @return [Array<Strings>] The permissions that have access.
+        # @return [Array<String>] The permissions that are configured for the policy.
         #
         # @example
         #   require "google/cloud/bigtable"
@@ -892,11 +902,8 @@ module Google
         #
         def test_iam_permissions *permissions
           ensure_service!
-          grpc = service.test_instance_permissions(
-            instance_id,
-            Array(permissions).flatten
-          )
-          grpc.permissions
+          grpc = service.test_instance_permissions instance_id, permissions.flatten
+          grpc.permissions.to_a
         end
 
         # @private