Package com.google.cloud.clouddms.v1 (2.12.0)

A client to Database Migration API

The interfaces provided are listed below, along with usage samples.

DataMigrationServiceClient

Service Description: Database Migration service

Sample for DataMigrationServiceClient:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (DataMigrationServiceClient dataMigrationServiceClient =
     DataMigrationServiceClient.create()) {
   MigrationJobName name = MigrationJobName.of("[PROJECT]", "[LOCATION]", "[MIGRATION_JOB]");
   MigrationJob response = dataMigrationServiceClient.getMigrationJob(name);
 }
 

Classes

CloudSqlConnectionProfile

Specifies required connection parameters, and, optionally, the parameters required to create a Cloud SQL destination database instance.

Protobuf type google.cloud.clouddms.v1.CloudSqlConnectionProfile

CloudSqlConnectionProfile.Builder

Specifies required connection parameters, and, optionally, the parameters required to create a Cloud SQL destination database instance.

Protobuf type google.cloud.clouddms.v1.CloudSqlConnectionProfile

CloudSqlSettings

Settings for creating a Cloud SQL database instance.

Protobuf type google.cloud.clouddms.v1.CloudSqlSettings

CloudSqlSettings.Builder

Settings for creating a Cloud SQL database instance.

Protobuf type google.cloud.clouddms.v1.CloudSqlSettings

ClouddmsProto

ClouddmsResourcesProto

ConnectionProfile

A connection profile definition.

Protobuf type google.cloud.clouddms.v1.ConnectionProfile

ConnectionProfile.Builder

A connection profile definition.

Protobuf type google.cloud.clouddms.v1.ConnectionProfile

ConnectionProfileName

ConnectionProfileName.Builder

Builder for projects/{project}/locations/{location}/connectionProfiles/{connection_profile}.

CreateConnectionProfileRequest

Request message for 'CreateConnectionProfile' request.

Protobuf type google.cloud.clouddms.v1.CreateConnectionProfileRequest

CreateConnectionProfileRequest.Builder

Request message for 'CreateConnectionProfile' request.

Protobuf type google.cloud.clouddms.v1.CreateConnectionProfileRequest

CreateMigrationJobRequest

Request message to create a new Database Migration Service migration job in the specified project and region.

Protobuf type google.cloud.clouddms.v1.CreateMigrationJobRequest

CreateMigrationJobRequest.Builder

Request message to create a new Database Migration Service migration job in the specified project and region.

Protobuf type google.cloud.clouddms.v1.CreateMigrationJobRequest

DataMigrationServiceClient

Service Description: Database Migration service

This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (DataMigrationServiceClient dataMigrationServiceClient =
     DataMigrationServiceClient.create()) {
   MigrationJobName name = MigrationJobName.of("[PROJECT]", "[LOCATION]", "[MIGRATION_JOB]");
   MigrationJob response = dataMigrationServiceClient.getMigrationJob(name);
 }
 

Note: close() needs to be called on the DataMigrationServiceClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().

The surface of this class includes several types of Java methods for each of the API's methods:

  1. A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
  2. A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
  3. A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

See the individual methods for example code.

Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.

This class can be customized by passing in a custom instance of DataMigrationServiceSettings to create(). For example:

To customize credentials:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 DataMigrationServiceSettings dataMigrationServiceSettings =
     DataMigrationServiceSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 DataMigrationServiceClient dataMigrationServiceClient =
     DataMigrationServiceClient.create(dataMigrationServiceSettings);
 

To customize the endpoint:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 DataMigrationServiceSettings dataMigrationServiceSettings =
     DataMigrationServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
 DataMigrationServiceClient dataMigrationServiceClient =
     DataMigrationServiceClient.create(dataMigrationServiceSettings);
 

Please refer to the GitHub repository's samples for more quickstart code snippets.

DataMigrationServiceClient.ListConnectionProfilesFixedSizeCollection

DataMigrationServiceClient.ListConnectionProfilesPage

DataMigrationServiceClient.ListConnectionProfilesPagedResponse

DataMigrationServiceClient.ListMigrationJobsFixedSizeCollection

DataMigrationServiceClient.ListMigrationJobsPage

DataMigrationServiceClient.ListMigrationJobsPagedResponse

DataMigrationServiceGrpc

Database Migration service

DataMigrationServiceGrpc.DataMigrationServiceBlockingStub

Database Migration service

DataMigrationServiceGrpc.DataMigrationServiceFutureStub

Database Migration service

DataMigrationServiceGrpc.DataMigrationServiceImplBase

Database Migration service

DataMigrationServiceGrpc.DataMigrationServiceStub

Database Migration service

DataMigrationServiceSettings

Settings class to configure an instance of DataMigrationServiceClient.

The default instance has everything set to sensible defaults:

  • The default service address (datamigration.googleapis.com) and default port (443) are used.
  • Credentials are acquired automatically through Application Default Credentials.
  • Retries are configured for idempotent methods but not for non-idempotent methods.

The builder of this class is recursive, so contained classes are themselves builders. When build() is called, the tree of builders is called to create the complete settings object.

For example, to set the total timeout of getMigrationJob to 30 seconds:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 DataMigrationServiceSettings.Builder dataMigrationServiceSettingsBuilder =
     DataMigrationServiceSettings.newBuilder();
 dataMigrationServiceSettingsBuilder
     .getMigrationJobSettings()
     .setRetrySettings(
         dataMigrationServiceSettingsBuilder
             .getMigrationJobSettings()
             .getRetrySettings()
             .toBuilder()
             .setTotalTimeout(Duration.ofSeconds(30))
             .build());
 DataMigrationServiceSettings dataMigrationServiceSettings =
     dataMigrationServiceSettingsBuilder.build();
 

DataMigrationServiceSettings.Builder

Builder for DataMigrationServiceSettings.

DatabaseType

A message defining the database engine and provider.

Protobuf type google.cloud.clouddms.v1.DatabaseType

DatabaseType.Builder

A message defining the database engine and provider.

Protobuf type google.cloud.clouddms.v1.DatabaseType

DeleteConnectionProfileRequest

Request message for 'DeleteConnectionProfile' request.

Protobuf type google.cloud.clouddms.v1.DeleteConnectionProfileRequest

DeleteConnectionProfileRequest.Builder

Request message for 'DeleteConnectionProfile' request.

Protobuf type google.cloud.clouddms.v1.DeleteConnectionProfileRequest

DeleteMigrationJobRequest

Request message for 'DeleteMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.DeleteMigrationJobRequest

DeleteMigrationJobRequest.Builder

Request message for 'DeleteMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.DeleteMigrationJobRequest

GenerateSshScriptRequest

Request message for 'GenerateSshScript' request.

Protobuf type google.cloud.clouddms.v1.GenerateSshScriptRequest

GenerateSshScriptRequest.Builder

Request message for 'GenerateSshScript' request.

Protobuf type google.cloud.clouddms.v1.GenerateSshScriptRequest

GetConnectionProfileRequest

Request message for 'GetConnectionProfile' request.

Protobuf type google.cloud.clouddms.v1.GetConnectionProfileRequest

GetConnectionProfileRequest.Builder

Request message for 'GetConnectionProfile' request.

Protobuf type google.cloud.clouddms.v1.GetConnectionProfileRequest

GetMigrationJobRequest

Request message for 'GetMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.GetMigrationJobRequest

GetMigrationJobRequest.Builder

Request message for 'GetMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.GetMigrationJobRequest

ListConnectionProfilesRequest

Request message for 'ListConnectionProfiles' request.

Protobuf type google.cloud.clouddms.v1.ListConnectionProfilesRequest

ListConnectionProfilesRequest.Builder

Request message for 'ListConnectionProfiles' request.

Protobuf type google.cloud.clouddms.v1.ListConnectionProfilesRequest

ListConnectionProfilesResponse

Response message for 'ListConnectionProfiles' request.

Protobuf type google.cloud.clouddms.v1.ListConnectionProfilesResponse

ListConnectionProfilesResponse.Builder

Response message for 'ListConnectionProfiles' request.

Protobuf type google.cloud.clouddms.v1.ListConnectionProfilesResponse

ListMigrationJobsRequest

Retrieve a list of all migration jobs in a given project and location.

Protobuf type google.cloud.clouddms.v1.ListMigrationJobsRequest

ListMigrationJobsRequest.Builder

Retrieve a list of all migration jobs in a given project and location.

Protobuf type google.cloud.clouddms.v1.ListMigrationJobsRequest

ListMigrationJobsResponse

Response message for 'ListMigrationJobs' request.

Protobuf type google.cloud.clouddms.v1.ListMigrationJobsResponse

ListMigrationJobsResponse.Builder

Response message for 'ListMigrationJobs' request.

Protobuf type google.cloud.clouddms.v1.ListMigrationJobsResponse

LocationName

LocationName.Builder

Builder for projects/{project}/locations/{location}.

MigrationJob

Represents a Database Migration Service migration job object.

Protobuf type google.cloud.clouddms.v1.MigrationJob

MigrationJob.Builder

Represents a Database Migration Service migration job object.

Protobuf type google.cloud.clouddms.v1.MigrationJob

MigrationJobName

MigrationJobName.Builder

Builder for projects/{project}/locations/{location}/migrationJobs/{migration_job}.

MigrationJobVerificationError

Error message of a verification Migration job.

Protobuf type google.cloud.clouddms.v1.MigrationJobVerificationError

MigrationJobVerificationError.Builder

Error message of a verification Migration job.

Protobuf type google.cloud.clouddms.v1.MigrationJobVerificationError

MySqlConnectionProfile

Specifies connection parameters required specifically for MySQL databases.

Protobuf type google.cloud.clouddms.v1.MySqlConnectionProfile

MySqlConnectionProfile.Builder

Specifies connection parameters required specifically for MySQL databases.

Protobuf type google.cloud.clouddms.v1.MySqlConnectionProfile

OperationMetadata

Represents the metadata of the long-running operation.

Protobuf type google.cloud.clouddms.v1.OperationMetadata

OperationMetadata.Builder

Represents the metadata of the long-running operation.

Protobuf type google.cloud.clouddms.v1.OperationMetadata

PostgreSqlConnectionProfile

Specifies connection parameters required specifically for PostgreSQL databases.

Protobuf type google.cloud.clouddms.v1.PostgreSqlConnectionProfile

PostgreSqlConnectionProfile.Builder

Specifies connection parameters required specifically for PostgreSQL databases.

Protobuf type google.cloud.clouddms.v1.PostgreSqlConnectionProfile

PromoteMigrationJobRequest

Request message for 'PromoteMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.PromoteMigrationJobRequest

PromoteMigrationJobRequest.Builder

Request message for 'PromoteMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.PromoteMigrationJobRequest

RestartMigrationJobRequest

Request message for 'RestartMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.RestartMigrationJobRequest

RestartMigrationJobRequest.Builder

Request message for 'RestartMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.RestartMigrationJobRequest

ResumeMigrationJobRequest

Request message for 'ResumeMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.ResumeMigrationJobRequest

ResumeMigrationJobRequest.Builder

Request message for 'ResumeMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.ResumeMigrationJobRequest

ReverseSshConnectivity

The details needed to configure a reverse SSH tunnel between the source and destination databases. These details will be used when calling the generateSshScript method (see https://cloud.google.com/database-migration/docs/reference/rest/v1/projects.locations.migrationJobs/generateSshScript) to produce the script that will help set up the reverse SSH tunnel, and to set up the VPC peering between the Cloud SQL private network and the VPC.

Protobuf type google.cloud.clouddms.v1.ReverseSshConnectivity

ReverseSshConnectivity.Builder

The details needed to configure a reverse SSH tunnel between the source and destination databases. These details will be used when calling the generateSshScript method (see https://cloud.google.com/database-migration/docs/reference/rest/v1/projects.locations.migrationJobs/generateSshScript) to produce the script that will help set up the reverse SSH tunnel, and to set up the VPC peering between the Cloud SQL private network and the VPC.

Protobuf type google.cloud.clouddms.v1.ReverseSshConnectivity

SqlAclEntry

An entry for an Access Control list.

Protobuf type google.cloud.clouddms.v1.SqlAclEntry

SqlAclEntry.Builder

An entry for an Access Control list.

Protobuf type google.cloud.clouddms.v1.SqlAclEntry

SqlIpConfig

IP Management configuration.

Protobuf type google.cloud.clouddms.v1.SqlIpConfig

SqlIpConfig.Builder

IP Management configuration.

Protobuf type google.cloud.clouddms.v1.SqlIpConfig

SshScript

Response message for 'GenerateSshScript' request.

Protobuf type google.cloud.clouddms.v1.SshScript

SshScript.Builder

Response message for 'GenerateSshScript' request.

Protobuf type google.cloud.clouddms.v1.SshScript

SslConfig

SSL configuration information.

Protobuf type google.cloud.clouddms.v1.SslConfig

SslConfig.Builder

SSL configuration information.

Protobuf type google.cloud.clouddms.v1.SslConfig

StartMigrationJobRequest

Request message for 'StartMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.StartMigrationJobRequest

StartMigrationJobRequest.Builder

Request message for 'StartMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.StartMigrationJobRequest

StaticIpConnectivity

The source database will allow incoming connections from the destination database's public IP. You can retrieve the Cloud SQL instance's public IP from the Cloud SQL console or using Cloud SQL APIs. No additional configuration is required.

Protobuf type google.cloud.clouddms.v1.StaticIpConnectivity

StaticIpConnectivity.Builder

The source database will allow incoming connections from the destination database's public IP. You can retrieve the Cloud SQL instance's public IP from the Cloud SQL console or using Cloud SQL APIs. No additional configuration is required.

Protobuf type google.cloud.clouddms.v1.StaticIpConnectivity

StopMigrationJobRequest

Request message for 'StopMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.StopMigrationJobRequest

StopMigrationJobRequest.Builder

Request message for 'StopMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.StopMigrationJobRequest

UpdateConnectionProfileRequest

Request message for 'UpdateConnectionProfile' request.

Protobuf type google.cloud.clouddms.v1.UpdateConnectionProfileRequest

UpdateConnectionProfileRequest.Builder

Request message for 'UpdateConnectionProfile' request.

Protobuf type google.cloud.clouddms.v1.UpdateConnectionProfileRequest

UpdateMigrationJobRequest

Request message for 'UpdateMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.UpdateMigrationJobRequest

UpdateMigrationJobRequest.Builder

Request message for 'UpdateMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.UpdateMigrationJobRequest

VerifyMigrationJobRequest

Request message for 'VerifyMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.VerifyMigrationJobRequest

VerifyMigrationJobRequest.Builder

Request message for 'VerifyMigrationJob' request.

Protobuf type google.cloud.clouddms.v1.VerifyMigrationJobRequest

VmCreationConfig

VM creation configuration message

Protobuf type google.cloud.clouddms.v1.VmCreationConfig

VmCreationConfig.Builder

VM creation configuration message

Protobuf type google.cloud.clouddms.v1.VmCreationConfig

VmSelectionConfig

VM selection configuration message

Protobuf type google.cloud.clouddms.v1.VmSelectionConfig

VmSelectionConfig.Builder

VM selection configuration message

Protobuf type google.cloud.clouddms.v1.VmSelectionConfig

VpcPeeringConnectivity

The details of the VPC where the source database is located in Google Cloud. We will use this information to set up the VPC peering connection between Cloud SQL and this VPC.

Protobuf type google.cloud.clouddms.v1.VpcPeeringConnectivity

VpcPeeringConnectivity.Builder

The details of the VPC where the source database is located in Google Cloud. We will use this information to set up the VPC peering connection between Cloud SQL and this VPC.

Protobuf type google.cloud.clouddms.v1.VpcPeeringConnectivity

Interfaces

CloudSqlConnectionProfileOrBuilder

CloudSqlSettingsOrBuilder

ConnectionProfileOrBuilder

CreateConnectionProfileRequestOrBuilder

CreateMigrationJobRequestOrBuilder

DatabaseTypeOrBuilder

DeleteConnectionProfileRequestOrBuilder

DeleteMigrationJobRequestOrBuilder

GenerateSshScriptRequestOrBuilder

GetConnectionProfileRequestOrBuilder

GetMigrationJobRequestOrBuilder

ListConnectionProfilesRequestOrBuilder

ListConnectionProfilesResponseOrBuilder

ListMigrationJobsRequestOrBuilder

ListMigrationJobsResponseOrBuilder

MigrationJobOrBuilder

MigrationJobVerificationErrorOrBuilder

MySqlConnectionProfileOrBuilder

OperationMetadataOrBuilder

PostgreSqlConnectionProfileOrBuilder

PromoteMigrationJobRequestOrBuilder

RestartMigrationJobRequestOrBuilder

ResumeMigrationJobRequestOrBuilder

ReverseSshConnectivityOrBuilder

SqlAclEntryOrBuilder

SqlIpConfigOrBuilder

SshScriptOrBuilder

SslConfigOrBuilder

StartMigrationJobRequestOrBuilder

StaticIpConnectivityOrBuilder

StopMigrationJobRequestOrBuilder

UpdateConnectionProfileRequestOrBuilder

UpdateMigrationJobRequestOrBuilder

VerifyMigrationJobRequestOrBuilder

VmCreationConfigOrBuilder

VmSelectionConfigOrBuilder

VpcPeeringConnectivityOrBuilder

Enums

CloudSqlSettings.SqlActivationPolicy

Specifies when the instance should be activated.

Protobuf enum google.cloud.clouddms.v1.CloudSqlSettings.SqlActivationPolicy

CloudSqlSettings.SqlDataDiskType

The storage options for Cloud SQL databases.

Protobuf enum google.cloud.clouddms.v1.CloudSqlSettings.SqlDataDiskType

CloudSqlSettings.SqlDatabaseVersion

The database engine type and version.

Protobuf enum google.cloud.clouddms.v1.CloudSqlSettings.SqlDatabaseVersion

ConnectionProfile.ConnectionProfileCase

ConnectionProfile.State

The current connection profile state (e.g. DRAFT, READY, or FAILED).

Protobuf enum google.cloud.clouddms.v1.ConnectionProfile.State

DatabaseEngine

The database engine types.

Protobuf enum google.cloud.clouddms.v1.DatabaseEngine

DatabaseProvider

The database providers.

Protobuf enum google.cloud.clouddms.v1.DatabaseProvider

GenerateSshScriptRequest.VmConfigCase

MigrationJob.ConnectivityCase

MigrationJob.Phase

The current migration job phase.

Protobuf enum google.cloud.clouddms.v1.MigrationJob.Phase

MigrationJob.State

The current migration job states.

Protobuf enum google.cloud.clouddms.v1.MigrationJob.State

MigrationJob.Type

The type of migration job (one-time or continuous).

Protobuf enum google.cloud.clouddms.v1.MigrationJob.Type

MigrationJobVerificationError.ErrorCode

A general error code describing the type of error that occurred.

Protobuf enum google.cloud.clouddms.v1.MigrationJobVerificationError.ErrorCode

SqlAclEntry.ExpirationCase

SslConfig.SslType

Specifies The kind of ssl configuration used.

Protobuf enum google.cloud.clouddms.v1.SslConfig.SslType