From 2e6f8055797a872c1e9f8039409bea9ea754bc11 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 19 Mar 2024 07:08:20 +0000 Subject: [PATCH] feat(datamigration): update the api #### datamigration:v1 The following keys were added: - schemas.ConnectionProfile.properties.sqlserver.$ref (Total Keys: 1) - schemas.MigrationJob.properties.sqlserverHomogeneousMigrationJobConfig.$ref (Total Keys: 1) - schemas.SqlServerBackups (Total Keys: 4) - schemas.SqlServerConnectionProfile (Total Keys: 16) - schemas.SqlServerDatabaseBackup (Total Keys: 4) - schemas.SqlServerEncryptionOptions (Total Keys: 5) - schemas.SqlServerHomogeneousMigrationJobConfig (Total Keys: 5) --- ...projects.locations.connectionProfiles.html | 132 ++++++++++++++ ...n_v1.projects.locations.migrationJobs.html | 65 +++++++ .../documents/datamigration.v1.json | 164 ++++++++++++++++-- .../documents/datamigration.v1beta1.json | 2 +- 4 files changed, 349 insertions(+), 14 deletions(-) diff --git a/docs/dyn/datamigration_v1.projects.locations.connectionProfiles.html b/docs/dyn/datamigration_v1.projects.locations.connectionProfiles.html index cd6f367287..791b835b1d 100644 --- a/docs/dyn/datamigration_v1.projects.locations.connectionProfiles.html +++ b/docs/dyn/datamigration_v1.projects.locations.connectionProfiles.html @@ -275,6 +275,39 @@

Method Details

"username": "A String", # Required. The username that Database Migration Service will use to connect to the database. The value is encrypted when stored in Database Migration Service. }, "provider": "A String", # The database provider. + "sqlserver": { # Specifies connection parameters required specifically for SQL Server databases. # Connection profile for a SQL Server data source. + "backups": { # Specifies the backup details in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. # The backup details in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. + "gcsBucket": "A String", # Required. The Cloud Storage bucket that stores backups for all replicated databases. + "gcsPrefix": "A String", # Optional. Cloud Storage path inside the bucket that stores backups. + }, + "cloudSqlId": "A String", # If the source is a Cloud SQL database, use this field to provide the Cloud SQL instance ID of the source. + "forwardSshConnectivity": { # Forward SSH Tunnel connectivity. # Forward SSH tunnel connectivity. + "hostname": "A String", # Required. Hostname for the SSH tunnel. + "password": "A String", # Input only. SSH password. + "port": 42, # Port for the SSH tunnel, default value is 22. + "privateKey": "A String", # Input only. SSH private key. + "username": "A String", # Required. Username for the SSH tunnel. + }, + "host": "A String", # Required. The IP or hostname of the source SQL Server database. + "password": "A String", # Required. Input only. The password for the user that Database Migration Service will be using to connect to the database. This field is not returned on request, and the value is encrypted when stored in Database Migration Service. + "passwordSet": True or False, # Output only. Indicates whether a new password is included in the request. + "port": 42, # Required. The network port of the source SQL Server database. + "privateConnectivity": { # Private Connectivity. # Private connectivity. + "privateConnection": "A String", # Required. The resource name (URI) of the private connection. + }, + "privateServiceConnectConnectivity": { # [Private Service Connect connectivity](https://cloud.google.com/vpc/docs/private-service-connect#service-attachments) # Private Service Connect connectivity. + "serviceAttachment": "A String", # Required. A service attachment that exposes a database, and has the following format: projects/{project}/regions/{region}/serviceAttachments/{service_attachment_name} + }, + "ssl": { # SSL configuration information. # SSL configuration for the destination to connect to the source database. + "caCertificate": "A String", # Required. Input only. The x509 PEM-encoded certificate of the CA that signed the source database server's certificate. The replica will use this certificate to verify it's connecting to the right host. + "clientCertificate": "A String", # Input only. The x509 PEM-encoded certificate that will be used by the replica to authenticate against the source database server.If this field is used then the 'client_key' field is mandatory. + "clientKey": "A String", # Input only. The unencrypted PKCS#1 or PKCS#8 PEM-encoded private key associated with the Client Certificate. If this field is used then the 'client_certificate' field is mandatory. + "type": "A String", # Output only. The ssl config type according to 'client_key', 'client_certificate' and 'ca_certificate'. + }, + "staticIpConnectivity": { # The source database will allow incoming connections from the public IP of the destination database. You can retrieve the public IP of the Cloud SQL instance from the Cloud SQL console or using Cloud SQL APIs. No additional configuration is required. # Static IP connectivity data (default, no additional details needed). + }, + "username": "A String", # Required. The username that Database Migration Service will use to connect to the database. The value is encrypted when stored in Database Migration Service. + }, "state": "A String", # The current connection profile state (e.g. DRAFT, READY, or FAILED). "updateTime": "A String", # Output only. The timestamp when the resource was last updated. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z". } @@ -519,6 +552,39 @@

Method Details

"username": "A String", # Required. The username that Database Migration Service will use to connect to the database. The value is encrypted when stored in Database Migration Service. }, "provider": "A String", # The database provider. + "sqlserver": { # Specifies connection parameters required specifically for SQL Server databases. # Connection profile for a SQL Server data source. + "backups": { # Specifies the backup details in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. # The backup details in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. + "gcsBucket": "A String", # Required. The Cloud Storage bucket that stores backups for all replicated databases. + "gcsPrefix": "A String", # Optional. Cloud Storage path inside the bucket that stores backups. + }, + "cloudSqlId": "A String", # If the source is a Cloud SQL database, use this field to provide the Cloud SQL instance ID of the source. + "forwardSshConnectivity": { # Forward SSH Tunnel connectivity. # Forward SSH tunnel connectivity. + "hostname": "A String", # Required. Hostname for the SSH tunnel. + "password": "A String", # Input only. SSH password. + "port": 42, # Port for the SSH tunnel, default value is 22. + "privateKey": "A String", # Input only. SSH private key. + "username": "A String", # Required. Username for the SSH tunnel. + }, + "host": "A String", # Required. The IP or hostname of the source SQL Server database. + "password": "A String", # Required. Input only. The password for the user that Database Migration Service will be using to connect to the database. This field is not returned on request, and the value is encrypted when stored in Database Migration Service. + "passwordSet": True or False, # Output only. Indicates whether a new password is included in the request. + "port": 42, # Required. The network port of the source SQL Server database. + "privateConnectivity": { # Private Connectivity. # Private connectivity. + "privateConnection": "A String", # Required. The resource name (URI) of the private connection. + }, + "privateServiceConnectConnectivity": { # [Private Service Connect connectivity](https://cloud.google.com/vpc/docs/private-service-connect#service-attachments) # Private Service Connect connectivity. + "serviceAttachment": "A String", # Required. A service attachment that exposes a database, and has the following format: projects/{project}/regions/{region}/serviceAttachments/{service_attachment_name} + }, + "ssl": { # SSL configuration information. # SSL configuration for the destination to connect to the source database. + "caCertificate": "A String", # Required. Input only. The x509 PEM-encoded certificate of the CA that signed the source database server's certificate. The replica will use this certificate to verify it's connecting to the right host. + "clientCertificate": "A String", # Input only. The x509 PEM-encoded certificate that will be used by the replica to authenticate against the source database server.If this field is used then the 'client_key' field is mandatory. + "clientKey": "A String", # Input only. The unencrypted PKCS#1 or PKCS#8 PEM-encoded private key associated with the Client Certificate. If this field is used then the 'client_certificate' field is mandatory. + "type": "A String", # Output only. The ssl config type according to 'client_key', 'client_certificate' and 'ca_certificate'. + }, + "staticIpConnectivity": { # The source database will allow incoming connections from the public IP of the destination database. You can retrieve the public IP of the Cloud SQL instance from the Cloud SQL console or using Cloud SQL APIs. No additional configuration is required. # Static IP connectivity data (default, no additional details needed). + }, + "username": "A String", # Required. The username that Database Migration Service will use to connect to the database. The value is encrypted when stored in Database Migration Service. + }, "state": "A String", # The current connection profile state (e.g. DRAFT, READY, or FAILED). "updateTime": "A String", # Output only. The timestamp when the resource was last updated. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z". } @@ -748,6 +814,39 @@

Method Details

"username": "A String", # Required. The username that Database Migration Service will use to connect to the database. The value is encrypted when stored in Database Migration Service. }, "provider": "A String", # The database provider. + "sqlserver": { # Specifies connection parameters required specifically for SQL Server databases. # Connection profile for a SQL Server data source. + "backups": { # Specifies the backup details in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. # The backup details in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. + "gcsBucket": "A String", # Required. The Cloud Storage bucket that stores backups for all replicated databases. + "gcsPrefix": "A String", # Optional. Cloud Storage path inside the bucket that stores backups. + }, + "cloudSqlId": "A String", # If the source is a Cloud SQL database, use this field to provide the Cloud SQL instance ID of the source. + "forwardSshConnectivity": { # Forward SSH Tunnel connectivity. # Forward SSH tunnel connectivity. + "hostname": "A String", # Required. Hostname for the SSH tunnel. + "password": "A String", # Input only. SSH password. + "port": 42, # Port for the SSH tunnel, default value is 22. + "privateKey": "A String", # Input only. SSH private key. + "username": "A String", # Required. Username for the SSH tunnel. + }, + "host": "A String", # Required. The IP or hostname of the source SQL Server database. + "password": "A String", # Required. Input only. The password for the user that Database Migration Service will be using to connect to the database. This field is not returned on request, and the value is encrypted when stored in Database Migration Service. + "passwordSet": True or False, # Output only. Indicates whether a new password is included in the request. + "port": 42, # Required. The network port of the source SQL Server database. + "privateConnectivity": { # Private Connectivity. # Private connectivity. + "privateConnection": "A String", # Required. The resource name (URI) of the private connection. + }, + "privateServiceConnectConnectivity": { # [Private Service Connect connectivity](https://cloud.google.com/vpc/docs/private-service-connect#service-attachments) # Private Service Connect connectivity. + "serviceAttachment": "A String", # Required. A service attachment that exposes a database, and has the following format: projects/{project}/regions/{region}/serviceAttachments/{service_attachment_name} + }, + "ssl": { # SSL configuration information. # SSL configuration for the destination to connect to the source database. + "caCertificate": "A String", # Required. Input only. The x509 PEM-encoded certificate of the CA that signed the source database server's certificate. The replica will use this certificate to verify it's connecting to the right host. + "clientCertificate": "A String", # Input only. The x509 PEM-encoded certificate that will be used by the replica to authenticate against the source database server.If this field is used then the 'client_key' field is mandatory. + "clientKey": "A String", # Input only. The unencrypted PKCS#1 or PKCS#8 PEM-encoded private key associated with the Client Certificate. If this field is used then the 'client_certificate' field is mandatory. + "type": "A String", # Output only. The ssl config type according to 'client_key', 'client_certificate' and 'ca_certificate'. + }, + "staticIpConnectivity": { # The source database will allow incoming connections from the public IP of the destination database. You can retrieve the public IP of the Cloud SQL instance from the Cloud SQL console or using Cloud SQL APIs. No additional configuration is required. # Static IP connectivity data (default, no additional details needed). + }, + "username": "A String", # Required. The username that Database Migration Service will use to connect to the database. The value is encrypted when stored in Database Migration Service. + }, "state": "A String", # The current connection profile state (e.g. DRAFT, READY, or FAILED). "updateTime": "A String", # Output only. The timestamp when the resource was last updated. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z". }, @@ -938,6 +1037,39 @@

Method Details

"username": "A String", # Required. The username that Database Migration Service will use to connect to the database. The value is encrypted when stored in Database Migration Service. }, "provider": "A String", # The database provider. + "sqlserver": { # Specifies connection parameters required specifically for SQL Server databases. # Connection profile for a SQL Server data source. + "backups": { # Specifies the backup details in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. # The backup details in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. + "gcsBucket": "A String", # Required. The Cloud Storage bucket that stores backups for all replicated databases. + "gcsPrefix": "A String", # Optional. Cloud Storage path inside the bucket that stores backups. + }, + "cloudSqlId": "A String", # If the source is a Cloud SQL database, use this field to provide the Cloud SQL instance ID of the source. + "forwardSshConnectivity": { # Forward SSH Tunnel connectivity. # Forward SSH tunnel connectivity. + "hostname": "A String", # Required. Hostname for the SSH tunnel. + "password": "A String", # Input only. SSH password. + "port": 42, # Port for the SSH tunnel, default value is 22. + "privateKey": "A String", # Input only. SSH private key. + "username": "A String", # Required. Username for the SSH tunnel. + }, + "host": "A String", # Required. The IP or hostname of the source SQL Server database. + "password": "A String", # Required. Input only. The password for the user that Database Migration Service will be using to connect to the database. This field is not returned on request, and the value is encrypted when stored in Database Migration Service. + "passwordSet": True or False, # Output only. Indicates whether a new password is included in the request. + "port": 42, # Required. The network port of the source SQL Server database. + "privateConnectivity": { # Private Connectivity. # Private connectivity. + "privateConnection": "A String", # Required. The resource name (URI) of the private connection. + }, + "privateServiceConnectConnectivity": { # [Private Service Connect connectivity](https://cloud.google.com/vpc/docs/private-service-connect#service-attachments) # Private Service Connect connectivity. + "serviceAttachment": "A String", # Required. A service attachment that exposes a database, and has the following format: projects/{project}/regions/{region}/serviceAttachments/{service_attachment_name} + }, + "ssl": { # SSL configuration information. # SSL configuration for the destination to connect to the source database. + "caCertificate": "A String", # Required. Input only. The x509 PEM-encoded certificate of the CA that signed the source database server's certificate. The replica will use this certificate to verify it's connecting to the right host. + "clientCertificate": "A String", # Input only. The x509 PEM-encoded certificate that will be used by the replica to authenticate against the source database server.If this field is used then the 'client_key' field is mandatory. + "clientKey": "A String", # Input only. The unencrypted PKCS#1 or PKCS#8 PEM-encoded private key associated with the Client Certificate. If this field is used then the 'client_certificate' field is mandatory. + "type": "A String", # Output only. The ssl config type according to 'client_key', 'client_certificate' and 'ca_certificate'. + }, + "staticIpConnectivity": { # The source database will allow incoming connections from the public IP of the destination database. You can retrieve the public IP of the Cloud SQL instance from the Cloud SQL console or using Cloud SQL APIs. No additional configuration is required. # Static IP connectivity data (default, no additional details needed). + }, + "username": "A String", # Required. The username that Database Migration Service will use to connect to the database. The value is encrypted when stored in Database Migration Service. + }, "state": "A String", # The current connection profile state (e.g. DRAFT, READY, or FAILED). "updateTime": "A String", # Output only. The timestamp when the resource was last updated. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z". } diff --git a/docs/dyn/datamigration_v1.projects.locations.migrationJobs.html b/docs/dyn/datamigration_v1.projects.locations.migrationJobs.html index 4225497cac..844b48b8a6 100644 --- a/docs/dyn/datamigration_v1.projects.locations.migrationJobs.html +++ b/docs/dyn/datamigration_v1.projects.locations.migrationJobs.html @@ -199,6 +199,19 @@

Method Details

"engine": "A String", # The database engine. "provider": "A String", # The database provider. }, + "sqlserverHomogeneousMigrationJobConfig": { # Configuration for homogeneous migration to Cloud SQL for SQL Server. # Optional. Configuration for SQL Server homogeneous migration. + "backupFilePattern": "A String", # Required. Pattern that describes the default backup naming strategy. The specified pattern should ensure lexicographical order of backups. The pattern must define one of the following capture group sets: Capture group set #1 yy/yyyy - year, 2 or 4 digits mm - month number, 1-12 dd - day of month, 1-31 hh - hour of day, 00-23 mi - minutes, 00-59 ss - seconds, 00-59 Example: For backup file TestDB_backup_20230802_155400.trn, use pattern: (?.*)_backup_(?\d{4})(?\d{2})(?\d{2})_(?\d{2})(?\d{2})(?\d{2}).trn Capture group set #2 timestamp - unix timestamp Example: For backup file TestDB_backup_1691448254.trn, use pattern: (?.*)_backup_(?.*).trn + "databaseBackups": [ # Required. Backup details per database in Cloud Storage. + { # Specifies the backup details for a single database in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. + "database": "A String", # Required. Name of a SQL Server database for which to define backup configuration. + "encryptionOptions": { # Encryption settings for the SQL Server database. # Optional. Encryption settings for the database. Required if provided database backups are encrypted. Encryption settings include path to certificate, path to certificate private key, and key password. + "certPath": "A String", # Required. Path to certificate. + "pvkPassword": "A String", # Required. Input only. Private key password. + "pvkPath": "A String", # Required. Path to certificate private key. + }, + }, + ], + }, "state": "A String", # The current migration job state. "staticIpConnectivity": { # The source database will allow incoming connections from the public IP of the destination database. You can retrieve the public IP of the Cloud SQL instance from the Cloud SQL console or using Cloud SQL APIs. No additional configuration is required. # static ip connectivity data (default, no additional details needed). }, @@ -449,6 +462,19 @@

Method Details

"engine": "A String", # The database engine. "provider": "A String", # The database provider. }, + "sqlserverHomogeneousMigrationJobConfig": { # Configuration for homogeneous migration to Cloud SQL for SQL Server. # Optional. Configuration for SQL Server homogeneous migration. + "backupFilePattern": "A String", # Required. Pattern that describes the default backup naming strategy. The specified pattern should ensure lexicographical order of backups. The pattern must define one of the following capture group sets: Capture group set #1 yy/yyyy - year, 2 or 4 digits mm - month number, 1-12 dd - day of month, 1-31 hh - hour of day, 00-23 mi - minutes, 00-59 ss - seconds, 00-59 Example: For backup file TestDB_backup_20230802_155400.trn, use pattern: (?.*)_backup_(?\d{4})(?\d{2})(?\d{2})_(?\d{2})(?\d{2})(?\d{2}).trn Capture group set #2 timestamp - unix timestamp Example: For backup file TestDB_backup_1691448254.trn, use pattern: (?.*)_backup_(?.*).trn + "databaseBackups": [ # Required. Backup details per database in Cloud Storage. + { # Specifies the backup details for a single database in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. + "database": "A String", # Required. Name of a SQL Server database for which to define backup configuration. + "encryptionOptions": { # Encryption settings for the SQL Server database. # Optional. Encryption settings for the database. Required if provided database backups are encrypted. Encryption settings include path to certificate, path to certificate private key, and key password. + "certPath": "A String", # Required. Path to certificate. + "pvkPassword": "A String", # Required. Input only. Private key password. + "pvkPath": "A String", # Required. Path to certificate private key. + }, + }, + ], + }, "state": "A String", # The current migration job state. "staticIpConnectivity": { # The source database will allow incoming connections from the public IP of the destination database. You can retrieve the public IP of the Cloud SQL instance from the Cloud SQL console or using Cloud SQL APIs. No additional configuration is required. # static ip connectivity data (default, no additional details needed). }, @@ -581,6 +607,19 @@

Method Details

"engine": "A String", # The database engine. "provider": "A String", # The database provider. }, + "sqlserverHomogeneousMigrationJobConfig": { # Configuration for homogeneous migration to Cloud SQL for SQL Server. # Optional. Configuration for SQL Server homogeneous migration. + "backupFilePattern": "A String", # Required. Pattern that describes the default backup naming strategy. The specified pattern should ensure lexicographical order of backups. The pattern must define one of the following capture group sets: Capture group set #1 yy/yyyy - year, 2 or 4 digits mm - month number, 1-12 dd - day of month, 1-31 hh - hour of day, 00-23 mi - minutes, 00-59 ss - seconds, 00-59 Example: For backup file TestDB_backup_20230802_155400.trn, use pattern: (?.*)_backup_(?\d{4})(?\d{2})(?\d{2})_(?\d{2})(?\d{2})(?\d{2}).trn Capture group set #2 timestamp - unix timestamp Example: For backup file TestDB_backup_1691448254.trn, use pattern: (?.*)_backup_(?.*).trn + "databaseBackups": [ # Required. Backup details per database in Cloud Storage. + { # Specifies the backup details for a single database in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. + "database": "A String", # Required. Name of a SQL Server database for which to define backup configuration. + "encryptionOptions": { # Encryption settings for the SQL Server database. # Optional. Encryption settings for the database. Required if provided database backups are encrypted. Encryption settings include path to certificate, path to certificate private key, and key password. + "certPath": "A String", # Required. Path to certificate. + "pvkPassword": "A String", # Required. Input only. Private key password. + "pvkPath": "A String", # Required. Path to certificate private key. + }, + }, + ], + }, "state": "A String", # The current migration job state. "staticIpConnectivity": { # The source database will allow incoming connections from the public IP of the destination database. You can retrieve the public IP of the Cloud SQL instance from the Cloud SQL console or using Cloud SQL APIs. No additional configuration is required. # static ip connectivity data (default, no additional details needed). }, @@ -674,6 +713,19 @@

Method Details

"engine": "A String", # The database engine. "provider": "A String", # The database provider. }, + "sqlserverHomogeneousMigrationJobConfig": { # Configuration for homogeneous migration to Cloud SQL for SQL Server. # Optional. Configuration for SQL Server homogeneous migration. + "backupFilePattern": "A String", # Required. Pattern that describes the default backup naming strategy. The specified pattern should ensure lexicographical order of backups. The pattern must define one of the following capture group sets: Capture group set #1 yy/yyyy - year, 2 or 4 digits mm - month number, 1-12 dd - day of month, 1-31 hh - hour of day, 00-23 mi - minutes, 00-59 ss - seconds, 00-59 Example: For backup file TestDB_backup_20230802_155400.trn, use pattern: (?.*)_backup_(?\d{4})(?\d{2})(?\d{2})_(?\d{2})(?\d{2})(?\d{2}).trn Capture group set #2 timestamp - unix timestamp Example: For backup file TestDB_backup_1691448254.trn, use pattern: (?.*)_backup_(?.*).trn + "databaseBackups": [ # Required. Backup details per database in Cloud Storage. + { # Specifies the backup details for a single database in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. + "database": "A String", # Required. Name of a SQL Server database for which to define backup configuration. + "encryptionOptions": { # Encryption settings for the SQL Server database. # Optional. Encryption settings for the database. Required if provided database backups are encrypted. Encryption settings include path to certificate, path to certificate private key, and key password. + "certPath": "A String", # Required. Path to certificate. + "pvkPassword": "A String", # Required. Input only. Private key password. + "pvkPath": "A String", # Required. Path to certificate private key. + }, + }, + ], + }, "state": "A String", # The current migration job state. "staticIpConnectivity": { # The source database will allow incoming connections from the public IP of the destination database. You can retrieve the public IP of the Cloud SQL instance from the Cloud SQL console or using Cloud SQL APIs. No additional configuration is required. # static ip connectivity data (default, no additional details needed). }, @@ -1100,6 +1152,19 @@

Method Details

"engine": "A String", # The database engine. "provider": "A String", # The database provider. }, + "sqlserverHomogeneousMigrationJobConfig": { # Configuration for homogeneous migration to Cloud SQL for SQL Server. # Optional. Configuration for SQL Server homogeneous migration. + "backupFilePattern": "A String", # Required. Pattern that describes the default backup naming strategy. The specified pattern should ensure lexicographical order of backups. The pattern must define one of the following capture group sets: Capture group set #1 yy/yyyy - year, 2 or 4 digits mm - month number, 1-12 dd - day of month, 1-31 hh - hour of day, 00-23 mi - minutes, 00-59 ss - seconds, 00-59 Example: For backup file TestDB_backup_20230802_155400.trn, use pattern: (?.*)_backup_(?\d{4})(?\d{2})(?\d{2})_(?\d{2})(?\d{2})(?\d{2}).trn Capture group set #2 timestamp - unix timestamp Example: For backup file TestDB_backup_1691448254.trn, use pattern: (?.*)_backup_(?.*).trn + "databaseBackups": [ # Required. Backup details per database in Cloud Storage. + { # Specifies the backup details for a single database in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server. + "database": "A String", # Required. Name of a SQL Server database for which to define backup configuration. + "encryptionOptions": { # Encryption settings for the SQL Server database. # Optional. Encryption settings for the database. Required if provided database backups are encrypted. Encryption settings include path to certificate, path to certificate private key, and key password. + "certPath": "A String", # Required. Path to certificate. + "pvkPassword": "A String", # Required. Input only. Private key password. + "pvkPath": "A String", # Required. Path to certificate private key. + }, + }, + ], + }, "state": "A String", # The current migration job state. "staticIpConnectivity": { # The source database will allow incoming connections from the public IP of the destination database. You can retrieve the public IP of the Cloud SQL instance from the Cloud SQL console or using Cloud SQL APIs. No additional configuration is required. # static ip connectivity data (default, no additional details needed). }, diff --git a/googleapiclient/discovery_cache/documents/datamigration.v1.json b/googleapiclient/discovery_cache/documents/datamigration.v1.json index 1dfdba912d..3a8d9e4c26 100644 --- a/googleapiclient/discovery_cache/documents/datamigration.v1.json +++ b/googleapiclient/discovery_cache/documents/datamigration.v1.json @@ -2125,7 +2125,7 @@ } } }, -"revision": "20240228", +"revision": "20240312", "rootUrl": "https://datamigration.googleapis.com/", "schemas": { "AlloyDbConnectionProfile": { @@ -2811,14 +2811,18 @@ "ALLOYDB" ], "enumDescriptions": [ -"The database provider is unknown.", -"CloudSQL runs the database.", -"RDS runs the database.", -"Amazon Aurora.", -"AlloyDB." +"Use this value for on-premise source database instances.", +"Cloud SQL is the source instance provider.", +"Amazon RDS is the source instance provider.", +"Amazon Aurora is the source instance provider.", +"AlloyDB for PostgreSQL is the source instance provider." ], "type": "string" }, +"sqlserver": { +"$ref": "SqlServerConnectionProfile", +"description": "Connection profile for a SQL Server data source." +}, "state": { "description": "The current connection profile state (e.g. DRAFT, READY, or FAILED).", "enum": [ @@ -3033,12 +3037,14 @@ "DATABASE_ENGINE_UNSPECIFIED", "MYSQL", "POSTGRESQL", +"SQLSERVER", "ORACLE" ], "enumDescriptions": [ "The source database engine of the migration job is unknown.", "The source engine is MySQL.", "The source engine is PostgreSQL.", +"The source engine is SQL Server.", "The source engine is Oracle." ], "type": "string" @@ -3211,12 +3217,14 @@ "DATABASE_ENGINE_UNSPECIFIED", "MYSQL", "POSTGRESQL", +"SQLSERVER", "ORACLE" ], "enumDescriptions": [ "The source database engine of the migration job is unknown.", "The source engine is MySQL.", "The source engine is PostgreSQL.", +"The source engine is SQL Server.", "The source engine is Oracle." ], "type": "string" @@ -3231,11 +3239,11 @@ "ALLOYDB" ], "enumDescriptions": [ -"The database provider is unknown.", -"CloudSQL runs the database.", -"RDS runs the database.", -"Amazon Aurora.", -"AlloyDB." +"Use this value for on-premise source database instances.", +"Cloud SQL is the source instance provider.", +"Amazon RDS is the source instance provider.", +"Amazon Aurora is the source instance provider.", +"AlloyDB for PostgreSQL is the source instance provider." ], "type": "string" } @@ -4445,7 +4453,8 @@ "CDC", "PROMOTE_IN_PROGRESS", "WAITING_FOR_SOURCE_WRITES_TO_STOP", -"PREPARING_THE_DUMP" +"PREPARING_THE_DUMP", +"READY_FOR_PROMOTE" ], "enumDescriptions": [ "The phase of the migration job is unknown.", @@ -4453,7 +4462,8 @@ "The migration job is CDC phase.", "The migration job is running the promote phase.", "Only RDS flow - waiting for source writes to stop", -"Only RDS flow - the sources writes stopped, waiting for dump to begin" +"Only RDS flow - the sources writes stopped, waiting for dump to begin", +"The migration job is ready to be promoted." ], "readOnly": true, "type": "string" @@ -4470,6 +4480,10 @@ "$ref": "DatabaseType", "description": "The database engine type and provider of the source." }, +"sqlserverHomogeneousMigrationJobConfig": { +"$ref": "SqlServerHomogeneousMigrationJobConfig", +"description": "Optional. Configuration for SQL Server homogeneous migration." +}, "state": { "description": "The current migration job state.", "enum": [ @@ -5567,6 +5581,130 @@ }, "type": "object" }, +"SqlServerBackups": { +"description": "Specifies the backup details in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server.", +"id": "SqlServerBackups", +"properties": { +"gcsBucket": { +"description": "Required. The Cloud Storage bucket that stores backups for all replicated databases.", +"type": "string" +}, +"gcsPrefix": { +"description": "Optional. Cloud Storage path inside the bucket that stores backups.", +"type": "string" +} +}, +"type": "object" +}, +"SqlServerConnectionProfile": { +"description": "Specifies connection parameters required specifically for SQL Server databases.", +"id": "SqlServerConnectionProfile", +"properties": { +"backups": { +"$ref": "SqlServerBackups", +"description": "The backup details in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server." +}, +"cloudSqlId": { +"description": "If the source is a Cloud SQL database, use this field to provide the Cloud SQL instance ID of the source.", +"type": "string" +}, +"forwardSshConnectivity": { +"$ref": "ForwardSshTunnelConnectivity", +"description": "Forward SSH tunnel connectivity." +}, +"host": { +"description": "Required. The IP or hostname of the source SQL Server database.", +"type": "string" +}, +"password": { +"description": "Required. Input only. The password for the user that Database Migration Service will be using to connect to the database. This field is not returned on request, and the value is encrypted when stored in Database Migration Service.", +"type": "string" +}, +"passwordSet": { +"description": "Output only. Indicates whether a new password is included in the request.", +"readOnly": true, +"type": "boolean" +}, +"port": { +"description": "Required. The network port of the source SQL Server database.", +"format": "int32", +"type": "integer" +}, +"privateConnectivity": { +"$ref": "PrivateConnectivity", +"description": "Private connectivity." +}, +"privateServiceConnectConnectivity": { +"$ref": "PrivateServiceConnectConnectivity", +"description": "Private Service Connect connectivity." +}, +"ssl": { +"$ref": "SslConfig", +"description": "SSL configuration for the destination to connect to the source database." +}, +"staticIpConnectivity": { +"$ref": "StaticIpConnectivity", +"description": "Static IP connectivity data (default, no additional details needed)." +}, +"username": { +"description": "Required. The username that Database Migration Service will use to connect to the database. The value is encrypted when stored in Database Migration Service.", +"type": "string" +} +}, +"type": "object" +}, +"SqlServerDatabaseBackup": { +"description": "Specifies the backup details for a single database in Cloud Storage for homogeneous migration to Cloud SQL for SQL Server.", +"id": "SqlServerDatabaseBackup", +"properties": { +"database": { +"description": "Required. Name of a SQL Server database for which to define backup configuration.", +"type": "string" +}, +"encryptionOptions": { +"$ref": "SqlServerEncryptionOptions", +"description": "Optional. Encryption settings for the database. Required if provided database backups are encrypted. Encryption settings include path to certificate, path to certificate private key, and key password." +} +}, +"type": "object" +}, +"SqlServerEncryptionOptions": { +"description": "Encryption settings for the SQL Server database.", +"id": "SqlServerEncryptionOptions", +"properties": { +"certPath": { +"description": "Required. Path to certificate.", +"type": "string" +}, +"pvkPassword": { +"description": "Required. Input only. Private key password.", +"type": "string" +}, +"pvkPath": { +"description": "Required. Path to certificate private key.", +"type": "string" +} +}, +"type": "object" +}, +"SqlServerHomogeneousMigrationJobConfig": { +"description": "Configuration for homogeneous migration to Cloud SQL for SQL Server.", +"id": "SqlServerHomogeneousMigrationJobConfig", +"properties": { +"backupFilePattern": { +"description": "Required. Pattern that describes the default backup naming strategy. The specified pattern should ensure lexicographical order of backups. The pattern must define one of the following capture group sets: Capture group set #1 yy/yyyy - year, 2 or 4 digits mm - month number, 1-12 dd - day of month, 1-31 hh - hour of day, 00-23 mi - minutes, 00-59 ss - seconds, 00-59 Example: For backup file TestDB_backup_20230802_155400.trn, use pattern: (?.*)_backup_(?\\d{4})(?\\d{2})(?\\d{2})_(?\\d{2})(?\\d{2})(?\\d{2}).trn Capture group set #2 timestamp - unix timestamp Example: For backup file TestDB_backup_1691448254.trn, use pattern: (?.*)_backup_(?.*).trn", +"type": "string" +}, +"databaseBackups": { +"description": "Required. Backup details per database in Cloud Storage.", +"items": { +"$ref": "SqlServerDatabaseBackup" +}, +"type": "array" +} +}, +"type": "object" +}, "SshScript": { "description": "Response message for 'GenerateSshScript' request.", "id": "SshScript", diff --git a/googleapiclient/discovery_cache/documents/datamigration.v1beta1.json b/googleapiclient/discovery_cache/documents/datamigration.v1beta1.json index 3f3d33d3d9..f380b7f0a2 100644 --- a/googleapiclient/discovery_cache/documents/datamigration.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/datamigration.v1beta1.json @@ -1049,7 +1049,7 @@ } } }, -"revision": "20240228", +"revision": "20240312", "rootUrl": "https://datamigration.googleapis.com/", "schemas": { "AuditConfig": {