你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

SQL Migration Service - list Migrations

服务:: Data Migration

API 版本:: 2022-01-30-preview

检索附加到服务的数据库迁移列表。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataMigration/sqlMigrationServices/{sqlMigrationServiceName}/listMigrations?api-version=2022-01-30-preview

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string	包含资源的资源组的名称。可以从 Azure 资源管理器 API 或门户获取此值。
sqlMigrationServiceName	path	True	string	SQL 迁移服务的名称。
subscriptionId	path	True	string	标识 Azure 订阅的订阅 ID。
api-version	query	True	string	要用于请求的 API 版本。

响应

名称	类型	说明
200 OK	DatabaseMigrationListResult	成功返回附加到服务的迁移。
Other Status Codes		错误响应： *** 400 InvalidParameterValue - 为参数“{0}”提供了无效值。 400 GenericUser - 调用其他资源提供程序时用户失败。 400 OperationIdNotFound - 找不到作 ID “{0}”。 400 OperationTypeNotFound - 找不到作类型“{0}”。 400 InvalidArgument - 参数无效“{0}”。 400 RegenerateAuthenticationKeyNameInvalid - 密钥名称“{0}”无效。有效的密钥名称为 authKey1 和 authKey2。 400 DeleteServiceNotAllowed - 当前正在运行附加到迁移服务“{0}”的一个或多个迁移。若要删除迁移服务，请等待所有迁移完成或手动取消迁移，然后重试删除服务。正在运行的迁移包括：“{1}” 400 IntegrationRuntimeIsNotSelfHosted - Integration Runtime 不为订阅“{0}”资源组“{1}”和名称“{2}”自承载 400 SerializationError - 处理来自 RP 服务的响应时出错：“{0}” 400 ServiceNameInvalid - 服务名称“{0}”无效。有关命名规则，请参阅 https://aka.ms/dmsv2naming。 403 AccessDenied - 访问被拒绝。 404 ResourceNotFound - 找不到请求的资源。 404 SubscriptionDoesNotExist - 订阅 ID 不存在。 404 ResourceDoesNotExist - 资源不存在。 409 OperationInProgress - 已在资源上执行作。 409 OperationCanceled -作已取消。 409 ResourceAlreadyExists - 资源已存在。 409 SubscriptionOperationInProgress - 订阅的作正在进行中 500 UnExpectedErrorOccurred - 发生意外错误。 500 OperationTimeout -作超时。 500 GenericSystem - 调用其他资源提供程序时出现系统故障。

名称

类型

说明

200 OK

DatabaseMigrationListResult

成功返回附加到服务的迁移。

Other Status Codes

错误响应： ***

400 InvalidParameterValue - 为参数“{0}”提供了无效值。
400 GenericUser - 调用其他资源提供程序时用户失败。
400 OperationIdNotFound - 找不到作 ID “{0}”。
400 OperationTypeNotFound - 找不到作类型“{0}”。
400 InvalidArgument - 参数无效“{0}”。
400 RegenerateAuthenticationKeyNameInvalid - 密钥名称“{0}”无效。有效的密钥名称为 authKey1 和 authKey2。
400 DeleteServiceNotAllowed - 当前正在运行附加到迁移服务“{0}”的一个或多个迁移。若要删除迁移服务，请等待所有迁移完成或手动取消迁移，然后重试删除服务。正在运行的迁移包括：“{1}”
400 IntegrationRuntimeIsNotSelfHosted - Integration Runtime 不为订阅“{0}”资源组“{1}”和名称“{2}”自承载
400 SerializationError - 处理来自 RP 服务的响应时出错：“{0}”
400 ServiceNameInvalid - 服务名称“{0}”无效。有关命名规则，请参阅 https://aka.ms/dmsv2naming。
403 AccessDenied - 访问被拒绝。
404 ResourceNotFound - 找不到请求的资源。
404 SubscriptionDoesNotExist - 订阅 ID 不存在。
404 ResourceDoesNotExist - 资源不存在。
409 OperationInProgress - 已在资源上执行作。
409 OperationCanceled -作已取消。
409 ResourceAlreadyExists - 资源已存在。
409 SubscriptionOperationInProgress - 订阅的作正在进行中
500 UnExpectedErrorOccurred - 发生意外错误。
500 OperationTimeout -作超时。
500 GenericSystem - 调用其他资源提供程序时出现系统故障。

示例

List database migrations attached to the service.

示例请求

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/service1/listMigrations?api-version=2022-01-30-preview

示例响应

状态代码:: 200

{
  "value": [
    {
      "properties": {
        "kind": "SqlMi",
        "scope": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/miname",
        "migrationStatus": "InProgress",
        "migrationStatusDetails": {
          "migrationState": "WaitForFullBackupUploadOperation",
          "activeBackupSets": [],
          "isFullBackupRestored": false
        },
        "startedOn": "0001-01-01T08:00:00Z",
        "endedOn": "0001-01-01T08:00:00Z",
        "sourceDatabaseName": "sourcename",
        "migrationOperationId": "858ba109-5ab7-4fa1-8aea-bea487cacdcd"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/miname/providers/Microsoft.DataMigration/databaseMigrations/targetdb",
      "name": "targetdb",
      "type": "Microsoft.DataMigration/dataMigrations"
    },
    {
      "properties": {
        "kind": "SqlMi",
        "scope": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/miname",
        "migrationStatus": "InProgress",
        "migrationStatusDetails": {
          "migrationState": "WaitForFullBackupUploadOperation",
          "activeBackupSets": [],
          "isFullBackupRestored": false
        },
        "startedOn": "0001-01-01T08:00:00Z",
        "endedOn": "0001-01-01T08:00:00Z",
        "sourceDatabaseName": "sourcename",
        "migrationOperationId": "858ba109-5ab7-4fa1-8aea-bea487cacdcd"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/miname/providers/Microsoft.DataMigration/databaseMigrations/targetdb",
      "name": "targetdb",
      "type": "Microsoft.DataMigration/dataMigrations"
    }
  ]
}

定义

名称	说明
AzureBlob	Azure Blob 详细信息
BackupConfiguration	备份配置
createdByType
DatabaseMigration	数据库迁移资源。
DatabaseMigrationListResult	数据库迁移的列表。
DatabaseMigrationPropertiesSqlMi	SQL 托管实例的数据库迁移资源属性。
DatabaseMigrationPropertiesSqlVm	SQL 虚拟机的数据库迁移资源属性。
ErrorInfo	错误详细信息
MigrationStatusDetails	当前迁移的详细状态。
OfflineConfiguration	脱机配置
SourceLocation	备份的源位置详细信息。
SqlBackupFileInfo	备份文件的信息
SqlBackupSetInfo	备份集的信息
SqlConnectionInformation	源 SQL 连接
SqlFileShare	文件共享
SystemData
TargetLocation	可选备份副本的目标位置详细信息

AzureBlob

Object

Azure Blob 详细信息

名称	类型	说明
accountKey	string	存储帐户密钥。
blobContainerName	string	存储备份的 Blob 容器名称。
storageAccountResourceId	string	存储备份的存储帐户的资源 ID。

BackupConfiguration

Object

备份配置

名称	类型	说明
sourceLocation	SourceLocation	备份的源位置。
targetLocation	TargetLocation	复制备份的目标位置。

createdByType

枚举

值	说明
User
Application
ManagedIdentity
Key

DatabaseMigration

Object

数据库迁移资源。

名称	类型	说明
id	string
name	string
properties	DatabaseMigrationProperties: DatabaseMigrationPropertiesSqlMi DatabaseMigrationPropertiesSqlVm	数据库迁移资源属性。
systemData	SystemData	与创建和上次修改资源相关的元数据。
type	string

DatabaseMigrationListResult

Object

数据库迁移的列表。

名称	类型	说明
nextLink	string
value	DatabaseMigration[]	数据库迁移资源。

DatabaseMigrationPropertiesSqlMi

Object

SQL 托管实例的数据库迁移资源属性。

名称	类型	说明
backupConfiguration	BackupConfiguration	备份配置信息。
endedOn	string (date-time)	数据库迁移结束时间。
kind	string: SqlMi
migrationFailureError	ErrorInfo	迁移失败时的错误详细信息。
migrationOperationId	string	ID 跟踪当前迁移操作。
migrationService	string	迁移服务的资源 ID。
migrationStatus	string	迁移状态。
migrationStatusDetails	MigrationStatusDetails	详细的迁移状态。默认情况下不包括。
offlineConfiguration	OfflineConfiguration	脱机配置。
provisioningError	string	迁移预配失败的错误消息（如果有）。
provisioningState	string	预配迁移状态。 ProvisioningState 作为 Succeeded 意味着已执行验证并已开始迁移。
scope	string	目标资源的资源 ID（SQL VM 或 SQL 托管实例）。
sourceDatabaseName	string	源数据库的名称。
sourceSqlConnection	SqlConnectionInformation	源 SQL Server 连接详细信息。
startedOn	string (date-time)	数据库迁移开始时间。
targetDatabaseCollation	string	要用于目标数据库的数据库排序规则。

DatabaseMigrationPropertiesSqlVm

Object

SQL 虚拟机的数据库迁移资源属性。

名称	类型	说明
backupConfiguration	BackupConfiguration	备份配置信息。
endedOn	string (date-time)	数据库迁移结束时间。
kind	string: SqlVm
migrationFailureError	ErrorInfo	迁移失败时的错误详细信息。
migrationOperationId	string	ID 跟踪当前迁移操作。
migrationService	string	迁移服务的资源 ID。
migrationStatus	string	迁移状态。
migrationStatusDetails	MigrationStatusDetails	详细的迁移状态。默认情况下不包括。
offlineConfiguration	OfflineConfiguration	脱机配置。
provisioningError	string	迁移预配失败的错误消息（如果有）。
provisioningState	string	预配迁移状态。 ProvisioningState 作为 Succeeded 意味着已执行验证并已开始迁移。
scope	string	目标资源的资源 ID（SQL VM 或 SQL 托管实例）。
sourceDatabaseName	string	源数据库的名称。
sourceSqlConnection	SqlConnectionInformation	源 SQL Server 连接详细信息。
startedOn	string (date-time)	数据库迁移开始时间。
targetDatabaseCollation	string	要用于目标数据库的数据库排序规则。

ErrorInfo

Object

错误详细信息

名称	类型	说明
code	string	错误代码。
message	string	错误信息。

MigrationStatusDetails

Object

当前迁移的详细状态。

名称	类型	说明
activeBackupSets	SqlBackupSetInfo[]	当前处于活动状态的备份集。
blobContainerName	string	Blob 容器的名称。
completeRestoreErrorMessage	string	完成还原错误消息（如果有）
currentRestoringFilename	string	当前正在还原的文件名。
fileUploadBlockingErrors	string[]	文件上传阻止错误（如果有）。
fullBackupSetInfo	SqlBackupSetInfo	完整备份集的详细信息。
invalidFiles	string[]	无效备份文件的文件。
isFullBackupRestored	boolean	是否已将完整备份应用于目标数据库。
lastRestoredBackupSetInfo	SqlBackupSetInfo	上次应用的备份集信息。
lastRestoredFilename	string	上次还原的文件名。
migrationState	string	迁移的当前状态。
pendingLogBackupsCount	integer (int32)	挂起的日志备份总数。
restoreBlockingReason	string	还原阻止原因（如果有）

OfflineConfiguration

Object

脱机配置

名称	类型	说明
lastBackupName	string	脱机迁移的姓氏。这是从文件共享迁移的可选选项。如果未提供，服务将基于文件共享中存在的最新备份文件确定最后一个备份文件名。
offline	boolean	脱机迁移

SourceLocation

Object

备份的源位置详细信息。

名称	类型	说明
azureBlob	AzureBlob	源 Azure Blob。
fileShare	SqlFileShare	源文件共享。

SqlBackupFileInfo

Object

备份文件的信息

名称	类型	说明
copyDuration	integer (int32)	复制持续时间（以秒为单位）
copyThroughput	number (double)	KBps 中的复制吞吐量
dataRead	integer (int64)	读取字节数
dataWritten	integer (int64)	写入的字节数
familySequenceNumber	integer (int32)	媒体系列序列号
fileName	string	文件名。
status	string	文件的状态。（初始、上传、上传、还原、还原或跳过）
totalSize	integer (int64)	文件大小（以字节为单位）

SqlBackupSetInfo

Object

备份集的信息

名称	类型	说明
backupFinishDate	string (date-time)	备份结束时间。
backupSetId	string (uuid)	备份集 ID。
backupStartDate	string (date-time)	备份开始日期。
backupType	string	备份类型。
familyCount	integer (int32)	媒体家庭计数
firstLSN	string	备份集的第一个 LSN。
hasBackupChecksums	boolean	具有备份校验和
ignoreReasons	string[]	备份集被忽略的原因
isBackupRestored	boolean	此备份集是否已还原。
lastLSN	string	备份集的最后一个 LSN。
listOfBackupFiles	SqlBackupFileInfo[]	备份集中的文件列表。

SqlConnectionInformation

Object

源 SQL 连接

名称	类型	说明
authentication	string	身份验证类型。
dataSource	string	数据源。
encryptConnection	boolean	是否加密连接。
password	string	连接到源 SQL 的密码。
trustServerCertificate	boolean	是否信任服务器证书。
userName	string	用于连接到源 SQL 的用户名。

SqlFileShare

Object

文件共享

名称	类型	说明
password	string	用于访问文件共享位置的用户名的密码。
path	string	作为 SMB 共享或放置备份的本地驱动器的位置。
username	string	用于访问备份的文件共享位置的用户名。

SystemData

Object

名称	类型	说明
createdAt	string (date-time)
createdBy	string
createdByType	createdByType
lastModifiedAt	string (date-time)
lastModifiedBy	string
lastModifiedByType	createdByType

TargetLocation

Object

可选备份副本的目标位置详细信息

名称	类型	说明
accountKey	string	存储帐户密钥。
storageAccountResourceId	string	复制备份的存储帐户的资源 ID。

通过

SQL Migration Service - list Migrations

URI 参数

响应

示例

List database migrations attached to the service.

示例请求

示例响应

定义

AzureBlob

BackupConfiguration

createdByType

DatabaseMigration

DatabaseMigrationListResult

DatabaseMigrationPropertiesSqlMi

DatabaseMigrationPropertiesSqlVm

ErrorInfo

MigrationStatusDetails

OfflineConfiguration

SourceLocation

SqlBackupFileInfo

SqlBackupSetInfo

SqlConnectionInformation

SqlFileShare

SystemData

TargetLocation