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

SQL Migration Service - list Migrations

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

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 - 订阅“”资源组“”和名称“”{0}{1}{2}Integration Runtime不是自承载的

  • 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.

示例请求

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

示例响应

{
  "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

Azure Blob 详细信息

名称 类型 说明
accountKey

string

存储帐户密钥。

blobContainerName

string

存储备份的 Blob 容器名称。

storageAccountResourceId

string

存储备份的存储帐户的资源 ID。

BackupConfiguration

备份配置

名称 类型 说明
sourceLocation

SourceLocation

备份的源位置。

targetLocation

TargetLocation

复制备份的目标位置。

createdByType

名称 类型 说明
Application

string

Key

string

ManagedIdentity

string

User

string

DatabaseMigration

数据库迁移资源。

名称 类型 说明
id

string

name

string

properties DatabaseMigrationProperties:

数据库迁移资源属性。

systemData

SystemData

与资源的创建和上次修改相关的元数据。

type

string

DatabaseMigrationListResult

数据库迁移的列表。

名称 类型 说明
nextLink

string

value

DatabaseMigration[]

数据库迁移资源。

DatabaseMigrationPropertiesSqlMi

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

名称 类型 说明
backupConfiguration

BackupConfiguration

备份配置信息。

endedOn

string

数据库迁移结束时间。

kind string:

SqlMi

migrationFailureError

ErrorInfo

迁移失败时的错误详细信息。

migrationOperationId

string

跟踪当前迁移操作的 ID。

migrationService

string

迁移服务的资源 ID。

migrationStatus

string

迁移状态。

migrationStatusDetails

MigrationStatusDetails

详细的迁移状态。 默认情况下不包括在内。

offlineConfiguration

OfflineConfiguration

脱机配置。

provisioningError

string

迁移预配失败的错误消息(如果有)。

provisioningState

string

迁移的预配状态。 作为 Succeeded 的 ProvisioningState 表示已执行验证并已开始迁移。

scope

string

目标资源的资源 ID (SQL VM 或 SQL 托管实例) 。

sourceDatabaseName

string

源数据库的名称。

sourceSqlConnection

SqlConnectionInformation

源SQL Server连接详细信息。

startedOn

string

数据库迁移开始时间。

targetDatabaseCollation

string

要用于目标数据库的数据库排序规则。

DatabaseMigrationPropertiesSqlVm

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

名称 类型 说明
backupConfiguration

BackupConfiguration

备份配置信息。

endedOn

string

数据库迁移结束时间。

kind string:

SqlVm

migrationFailureError

ErrorInfo

迁移失败时的错误详细信息。

migrationOperationId

string

跟踪当前迁移操作的 ID。

migrationService

string

迁移服务的资源 ID。

migrationStatus

string

迁移状态。

migrationStatusDetails

MigrationStatusDetails

详细的迁移状态。 默认情况下不包括在内。

offlineConfiguration

OfflineConfiguration

脱机配置。

provisioningError

string

迁移预配失败的错误消息(如果有)。

provisioningState

string

迁移的预配状态。 作为 Succeeded 的 ProvisioningState 表示已执行验证并已开始迁移。

scope

string

目标资源的资源 ID (SQL VM 或 SQL 托管实例) 。

sourceDatabaseName

string

源数据库的名称。

sourceSqlConnection

SqlConnectionInformation

源SQL Server连接详细信息。

startedOn

string

数据库迁移开始时间。

targetDatabaseCollation

string

要用于目标数据库的数据库排序规则。

ErrorInfo

错误详细信息

名称 类型 说明
code

string

错误代码。

message

string

错误消息。

MigrationStatusDetails

当前迁移的详细状态。

名称 类型 说明
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

挂起的日志备份总数。

restoreBlockingReason

string

还原阻止原因(如果有)

OfflineConfiguration

脱机配置

名称 类型 说明
lastBackupName

string

脱机迁移的上次备份名称。 对于从文件共享迁移,这是可选的。 如果未提供,则服务将根据文件共享中存在的最新备份文件确定最后一个备份文件名。

offline

boolean

脱机迁移

SourceLocation

备份的源位置详细信息。

名称 类型 说明
azureBlob

AzureBlob

源 Azure Blob。

fileShare

SqlFileShare

源文件共享。

SqlBackupFileInfo

备份文件的信息

名称 类型 说明
copyDuration

integer

复制持续时间(秒)

copyThroughput

number

复制吞吐量(以 KBps 为单位)

dataRead

integer

读取的字节数

dataWritten

integer

写入的字节数

familySequenceNumber

integer

媒体系列序列号

fileName

string

文件名。

status

string

文件的状态。 (初始、正在上传、上传、还原、还原或跳过)

totalSize

integer

文件大小(以字节为单位)

SqlBackupSetInfo

备份集的信息

名称 类型 说明
backupFinishDate

string

备份结束时间。

backupSetId

string

备份集 ID。

backupStartDate

string

备份开始日期。

backupType

string

备份类型。

familyCount

integer

介质簇计数

firstLSN

string

备份集的第一个 LSN。

hasBackupChecksums

boolean

具有备份校验和

ignoreReasons

string[]

忽略备份集的原因

isBackupRestored

boolean

此备份集是否已还原。

lastLSN

string

备份集的最后一个 LSN。

listOfBackupFiles

SqlBackupFileInfo[]

备份集中的文件列表。

SqlConnectionInformation

源 SQL 连接

名称 类型 说明
authentication

string

身份验证类型。

dataSource

string

数据源。

encryptConnection

boolean

是否加密连接。

password

string

用于连接到源 SQL 的密码。

trustServerCertificate

boolean

是否信任服务器证书。

userName

string

用于连接到源 SQL 的用户名。

SqlFileShare

文件共享

名称 类型 说明
password

string

用于访问文件共享位置的用户名的密码。

path

string

作为 SMB 共享或本地驱动器放置备份的位置。

username

string

用于访问备份的文件共享位置的用户名。

SystemData

名称 类型 说明
createdAt

string

createdBy

string

createdByType

createdByType

lastModifiedAt

string

lastModifiedBy

string

lastModifiedByType

createdByType

TargetLocation

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

名称 类型 说明
accountKey

string

存储帐户密钥。

storageAccountResourceId

string

存储帐户复制备份的资源 ID。