google-cloud-cloud_dms-v1 0.1.5 → 0.3.0

data/lib/google/cloud/cloud_dms/v1/data_migration_service/operations.rb

@@ -95,6 +95,9 @@ module Google
                 channel_args: @config.channel_args,
                 interceptors: @config.interceptors
               )
+
+              # Used by an LRO wrapper for some methods of this service
+              @operations_client = self
             end
 
             # Service calls
@@ -155,13 +158,11 @@ module Google
             #   # Call the list_operations method.
             #   result = client.list_operations request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Longrunning::Operation.
-            #     p response
+            #     p item
             #   end
             #
             def list_operations request, options = nil
@@ -250,14 +251,14 @@ module Google
             #   # Call the get_operation method.
             #   result = client.get_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def get_operation request, options = nil
@@ -537,14 +538,14 @@ module Google
             #   # Call the wait_operation method.
             #   result = client.wait_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def wait_operation request, options = nil
@@ -619,9 +620,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials

data/lib/google/cloud/cloud_dms/v1/data_migration_service/paths.rb

@@ -43,6 +43,25 @@ module Google
               "projects/#{project}/locations/#{location}/connectionProfiles/#{connection_profile}"
             end
 
+            ##
+            # Create a fully-qualified ConversionWorkspace resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/conversionWorkspaces/{conversion_workspace}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param conversion_workspace [String]
+            #
+            # @return [::String]
+            def conversion_workspace_path project:, location:, conversion_workspace:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/conversionWorkspaces/#{conversion_workspace}"
+            end
+
             ##
             # Create a fully-qualified Location resource string.
             #
@@ -79,6 +98,42 @@ module Google
               "projects/#{project}/locations/#{location}/migrationJobs/#{migration_job}"
             end
 
+            ##
+            # Create a fully-qualified Networks resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/global/networks/{network}`
+            #
+            # @param project [String]
+            # @param network [String]
+            #
+            # @return [::String]
+            def networks_path project:, network:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/global/networks/#{network}"
+            end
+
+            ##
+            # Create a fully-qualified PrivateConnection resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/privateConnections/{private_connection}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param private_connection [String]
+            #
+            # @return [::String]
+            def private_connection_path project:, location:, private_connection:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/privateConnections/#{private_connection}"
+            end
+
             extend self
           end
         end

data/lib/google/cloud/cloud_dms/v1/data_migration_service.rb

@@ -34,7 +34,7 @@ module Google
         ##
         # Database Migration service
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/cloud_dms/v1/data_migration_service"
         #     client = ::Google::Cloud::CloudDMS::V1::DataMigrationService::Client.new

data/lib/google/cloud/cloud_dms/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module CloudDMS
       module V1
-        VERSION = "0.1.5"
+        VERSION = "0.3.0"
       end
     end
   end

data/lib/google/cloud/cloud_dms/v1.rb

@@ -23,7 +23,9 @@ module Google
   module Cloud
     module CloudDMS
       ##
-      # To load this package, including all its services, and instantiate a client:
+      # API client module.
+      #
+      # @example Load this package, including all its services, and instantiate a gRPC client
       #
       #     require "google/cloud/cloud_dms/v1"
       #     client = ::Google::Cloud::CloudDMS::V1::DataMigrationService::Client.new

data/lib/google/cloud/clouddms/v1/clouddms_pb.rb

@@ -1,15 +1,17 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/clouddms/v1/clouddms.proto
 
+require 'google/protobuf'
+
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/clouddms/v1/clouddms_resources_pb'
+require 'google/cloud/clouddms/v1/conversionworkspace_resources_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/clouddms/v1/clouddms.proto", :syntax => :proto3) do
@@ -102,17 +104,47 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :connection_profile_id, :string, 2
       optional :connection_profile, :message, 3, "google.cloud.clouddms.v1.ConnectionProfile"
       optional :request_id, :string, 4
+      optional :validate_only, :bool, 5
+      optional :skip_validation, :bool, 6
     end
     add_message "google.cloud.clouddms.v1.UpdateConnectionProfileRequest" do
       optional :update_mask, :message, 1, "google.protobuf.FieldMask"
       optional :connection_profile, :message, 2, "google.cloud.clouddms.v1.ConnectionProfile"
       optional :request_id, :string, 3
+      optional :validate_only, :bool, 4
+      optional :skip_validation, :bool, 5
     end
     add_message "google.cloud.clouddms.v1.DeleteConnectionProfileRequest" do
       optional :name, :string, 1
       optional :request_id, :string, 2
       optional :force, :bool, 3
     end
+    add_message "google.cloud.clouddms.v1.CreatePrivateConnectionRequest" do
+      optional :parent, :string, 1
+      optional :private_connection_id, :string, 2
+      optional :private_connection, :message, 3, "google.cloud.clouddms.v1.PrivateConnection"
+      optional :request_id, :string, 4
+      optional :skip_validation, :bool, 5
+    end
+    add_message "google.cloud.clouddms.v1.ListPrivateConnectionsRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+      optional :filter, :string, 4
+      optional :order_by, :string, 5
+    end
+    add_message "google.cloud.clouddms.v1.ListPrivateConnectionsResponse" do
+      repeated :private_connections, :message, 1, "google.cloud.clouddms.v1.PrivateConnection"
+      optional :next_page_token, :string, 2
+      repeated :unreachable, :string, 3
+    end
+    add_message "google.cloud.clouddms.v1.DeletePrivateConnectionRequest" do
+      optional :name, :string, 1
+      optional :request_id, :string, 2
+    end
+    add_message "google.cloud.clouddms.v1.GetPrivateConnectionRequest" do
+      optional :name, :string, 1
+    end
     add_message "google.cloud.clouddms.v1.OperationMetadata" do
       optional :create_time, :message, 1, "google.protobuf.Timestamp"
       optional :end_time, :message, 2, "google.protobuf.Timestamp"
@@ -122,6 +154,116 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :requested_cancellation, :bool, 6
       optional :api_version, :string, 7
     end
+    add_message "google.cloud.clouddms.v1.ListConversionWorkspacesRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+      optional :filter, :string, 4
+    end
+    add_message "google.cloud.clouddms.v1.ListConversionWorkspacesResponse" do
+      repeated :conversion_workspaces, :message, 1, "google.cloud.clouddms.v1.ConversionWorkspace"
+      optional :next_page_token, :string, 2
+      repeated :unreachable, :string, 3
+    end
+    add_message "google.cloud.clouddms.v1.GetConversionWorkspaceRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.clouddms.v1.CreateConversionWorkspaceRequest" do
+      optional :parent, :string, 1
+      optional :conversion_workspace_id, :string, 2
+      optional :conversion_workspace, :message, 3, "google.cloud.clouddms.v1.ConversionWorkspace"
+      optional :request_id, :string, 4
+    end
+    add_message "google.cloud.clouddms.v1.UpdateConversionWorkspaceRequest" do
+      optional :update_mask, :message, 1, "google.protobuf.FieldMask"
+      optional :conversion_workspace, :message, 2, "google.cloud.clouddms.v1.ConversionWorkspace"
+      optional :request_id, :string, 3
+    end
+    add_message "google.cloud.clouddms.v1.DeleteConversionWorkspaceRequest" do
+      optional :name, :string, 1
+      optional :request_id, :string, 2
+    end
+    add_message "google.cloud.clouddms.v1.CommitConversionWorkspaceRequest" do
+      optional :name, :string, 1
+      optional :commit_name, :string, 2
+    end
+    add_message "google.cloud.clouddms.v1.RollbackConversionWorkspaceRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.clouddms.v1.ApplyConversionWorkspaceRequest" do
+      optional :name, :string, 1
+      optional :filter, :string, 2
+      oneof :destination do
+        optional :connection_profile, :string, 100
+      end
+    end
+    add_message "google.cloud.clouddms.v1.SeedConversionWorkspaceRequest" do
+      optional :name, :string, 1
+      optional :auto_commit, :bool, 2
+      oneof :seed_from do
+        optional :source_connection_profile, :string, 100
+        optional :destination_connection_profile, :string, 101
+      end
+    end
+    add_message "google.cloud.clouddms.v1.ConvertConversionWorkspaceRequest" do
+      optional :name, :string, 1
+      optional :auto_commit, :bool, 4
+      optional :filter, :string, 5
+    end
+    add_message "google.cloud.clouddms.v1.ImportMappingRulesRequest" do
+      optional :parent, :string, 1
+      optional :rules_format, :enum, 2, "google.cloud.clouddms.v1.ImportRulesFileFormat"
+      repeated :rules_files, :message, 3, "google.cloud.clouddms.v1.ImportMappingRulesRequest.RulesFile"
+      optional :auto_commit, :bool, 6
+    end
+    add_message "google.cloud.clouddms.v1.ImportMappingRulesRequest.RulesFile" do
+      optional :rules_source_filename, :string, 1
+      optional :rules_content, :string, 2
+    end
+    add_message "google.cloud.clouddms.v1.DescribeDatabaseEntitiesRequest" do
+      optional :conversion_workspace, :string, 1
+      optional :page_size, :int32, 3
+      optional :page_token, :string, 4
+      optional :tree, :enum, 6, "google.cloud.clouddms.v1.DescribeDatabaseEntitiesRequest.DBTreeType"
+      optional :uncommitted, :bool, 11
+      optional :commit_id, :string, 12
+      optional :filter, :string, 13
+    end
+    add_enum "google.cloud.clouddms.v1.DescribeDatabaseEntitiesRequest.DBTreeType" do
+      value :DB_TREE_TYPE_UNSPECIFIED, 0
+      value :SOURCE_TREE, 1
+      value :DRAFT_TREE, 2
+      value :DESTINATION_TREE, 3
+    end
+    add_message "google.cloud.clouddms.v1.DescribeDatabaseEntitiesResponse" do
+      repeated :database_entities, :message, 1, "google.cloud.clouddms.v1.DatabaseEntity"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.cloud.clouddms.v1.SearchBackgroundJobsRequest" do
+      optional :conversion_workspace, :string, 1
+      optional :return_most_recent_per_job_type, :bool, 2
+      optional :max_size, :int32, 3
+      optional :completed_until_time, :message, 4, "google.protobuf.Timestamp"
+    end
+    add_message "google.cloud.clouddms.v1.SearchBackgroundJobsResponse" do
+      repeated :jobs, :message, 1, "google.cloud.clouddms.v1.BackgroundJobLogEntry"
+    end
+    add_message "google.cloud.clouddms.v1.DescribeConversionWorkspaceRevisionsRequest" do
+      optional :conversion_workspace, :string, 1
+      optional :commit_id, :string, 2
+    end
+    add_message "google.cloud.clouddms.v1.DescribeConversionWorkspaceRevisionsResponse" do
+      repeated :revisions, :message, 1, "google.cloud.clouddms.v1.ConversionWorkspace"
+    end
+    add_message "google.cloud.clouddms.v1.FetchStaticIpsRequest" do
+      optional :name, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+    end
+    add_message "google.cloud.clouddms.v1.FetchStaticIpsResponse" do
+      repeated :static_ips, :string, 1
+      optional :next_page_token, :string, 2
+    end
   end
 end
 
@@ -151,7 +293,34 @@ module Google
         CreateConnectionProfileRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.CreateConnectionProfileRequest").msgclass
         UpdateConnectionProfileRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.UpdateConnectionProfileRequest").msgclass
         DeleteConnectionProfileRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.DeleteConnectionProfileRequest").msgclass
+        CreatePrivateConnectionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.CreatePrivateConnectionRequest").msgclass
+        ListPrivateConnectionsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.ListPrivateConnectionsRequest").msgclass
+        ListPrivateConnectionsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.ListPrivateConnectionsResponse").msgclass
+        DeletePrivateConnectionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.DeletePrivateConnectionRequest").msgclass
+        GetPrivateConnectionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.GetPrivateConnectionRequest").msgclass
         OperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.OperationMetadata").msgclass
+        ListConversionWorkspacesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.ListConversionWorkspacesRequest").msgclass
+        ListConversionWorkspacesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.ListConversionWorkspacesResponse").msgclass
+        GetConversionWorkspaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.GetConversionWorkspaceRequest").msgclass
+        CreateConversionWorkspaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.CreateConversionWorkspaceRequest").msgclass
+        UpdateConversionWorkspaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.UpdateConversionWorkspaceRequest").msgclass
+        DeleteConversionWorkspaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.DeleteConversionWorkspaceRequest").msgclass
+        CommitConversionWorkspaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.CommitConversionWorkspaceRequest").msgclass
+        RollbackConversionWorkspaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.RollbackConversionWorkspaceRequest").msgclass
+        ApplyConversionWorkspaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.ApplyConversionWorkspaceRequest").msgclass
+        SeedConversionWorkspaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.SeedConversionWorkspaceRequest").msgclass
+        ConvertConversionWorkspaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.ConvertConversionWorkspaceRequest").msgclass
+        ImportMappingRulesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.ImportMappingRulesRequest").msgclass
+        ImportMappingRulesRequest::RulesFile = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.ImportMappingRulesRequest.RulesFile").msgclass
+        DescribeDatabaseEntitiesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.DescribeDatabaseEntitiesRequest").msgclass
+        DescribeDatabaseEntitiesRequest::DBTreeType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.DescribeDatabaseEntitiesRequest.DBTreeType").enummodule
+        DescribeDatabaseEntitiesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.DescribeDatabaseEntitiesResponse").msgclass
+        SearchBackgroundJobsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.SearchBackgroundJobsRequest").msgclass
+        SearchBackgroundJobsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.SearchBackgroundJobsResponse").msgclass
+        DescribeConversionWorkspaceRevisionsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.DescribeConversionWorkspaceRevisionsRequest").msgclass
+        DescribeConversionWorkspaceRevisionsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.DescribeConversionWorkspaceRevisionsResponse").msgclass
+        FetchStaticIpsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.FetchStaticIpsRequest").msgclass
+        FetchStaticIpsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.clouddms.v1.FetchStaticIpsResponse").msgclass
       end
     end
   end