google-cloud-spanner-admin-instance-v1 0.7.0 → 0.8.0

data/lib/google/cloud/spanner/admin/instance/v1/version.rb

@@ -23,7 +23,7 @@ module Google
       module Admin
         module Instance
           module V1
-            VERSION = "0.7.0"
+            VERSION = "0.8.0"
           end
         end
       end

data/lib/google/spanner/admin/instance/v1/common_pb.rb

@@ -0,0 +1,30 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/spanner/admin/instance/v1/common.proto
+
+require 'google/protobuf'
+
+require 'google/protobuf/timestamp_pb'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/spanner/admin/instance/v1/common.proto", :syntax => :proto3) do
+    add_message "google.spanner.admin.instance.v1.OperationProgress" do
+      optional :progress_percent, :int32, 1
+      optional :start_time, :message, 2, "google.protobuf.Timestamp"
+      optional :end_time, :message, 3, "google.protobuf.Timestamp"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Spanner
+      module Admin
+        module Instance
+          module V1
+            OperationProgress = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.OperationProgress").msgclass
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_pb.rb

@@ -13,6 +13,7 @@ require 'google/longrunning/operations_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/spanner/admin/instance/v1/common_pb'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/admin/instance/v1/spanner_instance_admin.proto", :syntax => :proto3) do
@@ -30,8 +31,25 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.spanner.admin.instance.v1.InstanceConfig" do
       optional :name, :string, 1
       optional :display_name, :string, 2
+      optional :config_type, :enum, 5, "google.spanner.admin.instance.v1.InstanceConfig.Type"
       repeated :replicas, :message, 3, "google.spanner.admin.instance.v1.ReplicaInfo"
+      repeated :optional_replicas, :message, 6, "google.spanner.admin.instance.v1.ReplicaInfo"
+      optional :base_config, :string, 7
+      map :labels, :string, :string, 8
+      optional :etag, :string, 9
       repeated :leader_options, :string, 4
+      optional :reconciling, :bool, 10
+      optional :state, :enum, 11, "google.spanner.admin.instance.v1.InstanceConfig.State"
+    end
+    add_enum "google.spanner.admin.instance.v1.InstanceConfig.Type" do
+      value :TYPE_UNSPECIFIED, 0
+      value :GOOGLE_MANAGED, 1
+      value :USER_MANAGED, 2
+    end
+    add_enum "google.spanner.admin.instance.v1.InstanceConfig.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :CREATING, 1
+      value :READY, 2
     end
     add_message "google.spanner.admin.instance.v1.Instance" do
       optional :name, :string, 1
@@ -62,6 +80,32 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.spanner.admin.instance.v1.GetInstanceConfigRequest" do
       optional :name, :string, 1
     end
+    add_message "google.spanner.admin.instance.v1.CreateInstanceConfigRequest" do
+      optional :parent, :string, 1
+      optional :instance_config_id, :string, 2
+      optional :instance_config, :message, 3, "google.spanner.admin.instance.v1.InstanceConfig"
+      optional :validate_only, :bool, 4
+    end
+    add_message "google.spanner.admin.instance.v1.UpdateInstanceConfigRequest" do
+      optional :instance_config, :message, 1, "google.spanner.admin.instance.v1.InstanceConfig"
+      optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+      optional :validate_only, :bool, 3
+    end
+    add_message "google.spanner.admin.instance.v1.DeleteInstanceConfigRequest" do
+      optional :name, :string, 1
+      optional :etag, :string, 2
+      optional :validate_only, :bool, 3
+    end
+    add_message "google.spanner.admin.instance.v1.ListInstanceConfigOperationsRequest" do
+      optional :parent, :string, 1
+      optional :filter, :string, 2
+      optional :page_size, :int32, 3
+      optional :page_token, :string, 4
+    end
+    add_message "google.spanner.admin.instance.v1.ListInstanceConfigOperationsResponse" do
+      repeated :operations, :message, 1, "google.longrunning.Operation"
+      optional :next_page_token, :string, 2
+    end
     add_message "google.spanner.admin.instance.v1.GetInstanceRequest" do
       optional :name, :string, 1
       optional :field_mask, :message, 2, "google.protobuf.FieldMask"
@@ -100,6 +144,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :cancel_time, :message, 3, "google.protobuf.Timestamp"
       optional :end_time, :message, 4, "google.protobuf.Timestamp"
     end
+    add_message "google.spanner.admin.instance.v1.CreateInstanceConfigMetadata" do
+      optional :instance_config, :message, 1, "google.spanner.admin.instance.v1.InstanceConfig"
+      optional :progress, :message, 2, "google.spanner.admin.instance.v1.OperationProgress"
+      optional :cancel_time, :message, 3, "google.protobuf.Timestamp"
+    end
+    add_message "google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata" do
+      optional :instance_config, :message, 1, "google.spanner.admin.instance.v1.InstanceConfig"
+      optional :progress, :message, 2, "google.spanner.admin.instance.v1.OperationProgress"
+      optional :cancel_time, :message, 3, "google.protobuf.Timestamp"
+    end
   end
 end
 
@@ -112,11 +166,18 @@ module Google
             ReplicaInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ReplicaInfo").msgclass
             ReplicaInfo::ReplicaType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ReplicaInfo.ReplicaType").enummodule
             InstanceConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.InstanceConfig").msgclass
+            InstanceConfig::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.InstanceConfig.Type").enummodule
+            InstanceConfig::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.InstanceConfig.State").enummodule
             Instance = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.Instance").msgclass
             Instance::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.Instance.State").enummodule
             ListInstanceConfigsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ListInstanceConfigsRequest").msgclass
             ListInstanceConfigsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ListInstanceConfigsResponse").msgclass
             GetInstanceConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.GetInstanceConfigRequest").msgclass
+            CreateInstanceConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.CreateInstanceConfigRequest").msgclass
+            UpdateInstanceConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.UpdateInstanceConfigRequest").msgclass
+            DeleteInstanceConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.DeleteInstanceConfigRequest").msgclass
+            ListInstanceConfigOperationsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ListInstanceConfigOperationsRequest").msgclass
+            ListInstanceConfigOperationsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ListInstanceConfigOperationsResponse").msgclass
             GetInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.GetInstanceRequest").msgclass
             CreateInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.CreateInstanceRequest").msgclass
             ListInstancesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.ListInstancesRequest").msgclass
@@ -125,6 +186,8 @@ module Google
             DeleteInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.DeleteInstanceRequest").msgclass
             CreateInstanceMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.CreateInstanceMetadata").msgclass
             UpdateInstanceMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.UpdateInstanceMetadata").msgclass
+            CreateInstanceConfigMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.CreateInstanceConfigMetadata").msgclass
+            UpdateInstanceConfigMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata").msgclass
           end
         end
       end

data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_services_pb.rb

@@ -59,6 +59,114 @@ module Google
                 rpc :ListInstanceConfigs, ::Google::Cloud::Spanner::Admin::Instance::V1::ListInstanceConfigsRequest, ::Google::Cloud::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse
                 # Gets information about a particular instance configuration.
                 rpc :GetInstanceConfig, ::Google::Cloud::Spanner::Admin::Instance::V1::GetInstanceConfigRequest, ::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig
+                # Creates an instance config and begins preparing it to be used. The
+                # returned [long-running operation][google.longrunning.Operation]
+                # can be used to track the progress of preparing the new
+                # instance config. The instance config name is assigned by the caller. If the
+                # named instance config already exists, `CreateInstanceConfig` returns
+                # `ALREADY_EXISTS`.
+                #
+                # Immediately after the request returns:
+                #
+                #   * The instance config is readable via the API, with all requested
+                #     attributes. The instance config's
+                #     [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
+                #     field is set to true. Its state is `CREATING`.
+                #
+                # While the operation is pending:
+                #
+                #   * Cancelling the operation renders the instance config immediately
+                #     unreadable via the API.
+                #   * Except for deleting the creating resource, all other attempts to modify
+                #     the instance config are rejected.
+                #
+                # Upon completion of the returned operation:
+                #
+                #   * Instances can be created using the instance configuration.
+                #   * The instance config's
+                #   [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
+                #   field becomes false. Its state becomes `READY`.
+                #
+                # The returned [long-running operation][google.longrunning.Operation] will
+                # have a name of the format
+                # `<instance_config_name>/operations/<operation_id>` and can be used to track
+                # creation of the instance config. The
+                # [metadata][google.longrunning.Operation.metadata] field type is
+                # [CreateInstanceConfigMetadata][google.spanner.admin.instance.v1.CreateInstanceConfigMetadata].
+                # The [response][google.longrunning.Operation.response] field type is
+                # [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if
+                # successful.
+                #
+                # Authorization requires `spanner.instanceConfigs.create` permission on
+                # the resource
+                # [parent][google.spanner.admin.instance.v1.CreateInstanceConfigRequest.parent].
+                rpc :CreateInstanceConfig, ::Google::Cloud::Spanner::Admin::Instance::V1::CreateInstanceConfigRequest, ::Google::Longrunning::Operation
+                # Updates an instance config. The returned
+                # [long-running operation][google.longrunning.Operation] can be used to track
+                # the progress of updating the instance. If the named instance config does
+                # not exist, returns `NOT_FOUND`.
+                #
+                # Only user managed configurations can be updated.
+                #
+                # Immediately after the request returns:
+                #
+                #   * The instance config's
+                #     [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
+                #     field is set to true.
+                #
+                # While the operation is pending:
+                #
+                #   * Cancelling the operation sets its metadata's
+                #     [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata.cancel_time].
+                #     The operation is guaranteed to succeed at undoing all changes, after
+                #     which point it terminates with a `CANCELLED` status.
+                #   * All other attempts to modify the instance config are rejected.
+                #   * Reading the instance config via the API continues to give the
+                #     pre-request values.
+                #
+                # Upon completion of the returned operation:
+                #
+                #   * Creating instances using the instance configuration uses the new
+                #     values.
+                #   * The instance config's new values are readable via the API.
+                #   * The instance config's
+                #   [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
+                #   field becomes false.
+                #
+                # The returned [long-running operation][google.longrunning.Operation] will
+                # have a name of the format
+                # `<instance_config_name>/operations/<operation_id>` and can be used to track
+                # the instance config modification.  The
+                # [metadata][google.longrunning.Operation.metadata] field type is
+                # [UpdateInstanceConfigMetadata][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata].
+                # The [response][google.longrunning.Operation.response] field type is
+                # [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if
+                # successful.
+                #
+                # Authorization requires `spanner.instanceConfigs.update` permission on
+                # the resource [name][google.spanner.admin.instance.v1.InstanceConfig.name].
+                rpc :UpdateInstanceConfig, ::Google::Cloud::Spanner::Admin::Instance::V1::UpdateInstanceConfigRequest, ::Google::Longrunning::Operation
+                # Deletes the instance config. Deletion is only allowed when no
+                # instances are using the configuration. If any instances are using
+                # the config, returns `FAILED_PRECONDITION`.
+                #
+                # Only user managed configurations can be deleted.
+                #
+                # Authorization requires `spanner.instanceConfigs.delete` permission on
+                # the resource [name][google.spanner.admin.instance.v1.InstanceConfig.name].
+                rpc :DeleteInstanceConfig, ::Google::Cloud::Spanner::Admin::Instance::V1::DeleteInstanceConfigRequest, ::Google::Protobuf::Empty
+                # Lists the user-managed instance config [long-running
+                # operations][google.longrunning.Operation] in the given project. An instance
+                # config operation has a name of the form
+                # `projects/<project>/instanceConfigs/<instance_config>/operations/<operation>`.
+                # The long-running operation
+                # [metadata][google.longrunning.Operation.metadata] field type
+                # `metadata.type_url` describes the type of the metadata. Operations returned
+                # include those that have completed/failed/canceled within the last 7 days,
+                # and pending operations. Operations returned are ordered by
+                # `operation.metadata.value.start_time` in descending order starting
+                # from the most recently started operation.
+                rpc :ListInstanceConfigOperations, ::Google::Cloud::Spanner::Admin::Instance::V1::ListInstanceConfigOperationsRequest, ::Google::Cloud::Spanner::Admin::Instance::V1::ListInstanceConfigOperationsResponse
                 # Lists all instances in the given project.
                 rpc :ListInstances, ::Google::Cloud::Spanner::Admin::Instance::V1::ListInstancesRequest, ::Google::Cloud::Spanner::Admin::Instance::V1::ListInstancesResponse
                 # Gets information about a particular instance.
@@ -112,9 +220,9 @@ module Google
                 # Until completion of the returned operation:
                 #
                 #   * Cancelling the operation sets its metadata's
-                #     [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceMetadata.cancel_time], and begins
-                #     restoring resources to their pre-request values. The operation
-                #     is guaranteed to succeed at undoing all resource changes,
+                #     [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceMetadata.cancel_time],
+                #     and begins restoring resources to their pre-request values. The
+                #     operation is guaranteed to succeed at undoing all resource changes,
                 #     after which point it terminates with a `CANCELLED` status.
                 #   * All other attempts to modify the instance are rejected.
                 #   * Reading the instance via the API continues to give the pre-request

data/proto_docs/google/protobuf/empty.rb

@@ -26,8 +26,6 @@ module Google
     #     service Foo {
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
-    #
-    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/spanner/admin/instance/v1/common.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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 Spanner
+      module Admin
+        module Instance
+          module V1
+            # Encapsulates progress related information for a Cloud Spanner long
+            # running instance operations.
+            # @!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
+          end
+        end
+      end
+    end
+  end
+end