导入手动生成的表

借助 Migration Center，您可以上传使用提供的模板手动填写的表格数据。 如果您的基础架构只有有限数量的资产，并且您想手动创建数据，那么此方法非常有用。

如需导入您手动填写的表格，请执行以下步骤：

  1. 从可用模板列表中下载模板。
  2. 手动填写包含基础架构数据的表格。
  3. 将表格上传到迁移中心。

限制

  • 文件上传大小上限为 100 Mb。

可用的数据模板

下表提供了可用于将基础架构数据上传到 Migration Center 的文件模板。 模板包含示例数据，可作为有关如何填写表格的建议。 如需详细了解所需的数据格式，请参阅导入文件规范。

文件名 数据类型 说明
vmInfo.csv 计算机相关信息 使用此模板提供有关各个资产的信息，包括 CPU、内存和其他配置参数。每次创建新导入时，都需要使用此表。
perfInfo.csv 性能数据 可选：使用此模板以时序格式提供资产的性能数据。
diskInfo.csv 磁盘数据 可选：使用此模板提供有关磁盘及其利用率的信息。
tagInfo.csv 系统代码 可选：使用此模板为您的 Amazon Web Services (AWS) 资产分配键值对属性。属性的格式为 "tag:KEY" : "VALUE"。例如 "tag:Name" : "AWS-example"。

如需详细了解每个文件的规范，请参阅导入文件规范。

上传表格

如需上传文件，请按以下步骤操作：

控制台

  1. 前往数据导入页面。

    前往“数据导入”

  2. 依次点击添加数据 > 上传文件。

  3. 在设置文件上传部分，输入文件上传的名称。

  4. 从文件格式列表中，选择手动填充的 CSV 模板。

  5. 点击选择要上传的文件，然后选择要上传的所有文件。

  6. 如需确认并开始上传文件，请点击上传文件。

  7. 如果文件已通过验证，请点击导入数据，然后点击确认，以根据文件创建素材资源。

API

  1. 创建导入作业。

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID

{
  "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID"
}

    替换以下内容：

    • PROJECT_ID：要在其中创建导入作业的项目的 ID。
    • REGION：用于创建导入作业的区域。
    • IMPORT_JOB_ID：新导入作业的 ID。
    • SOURCE_ID：要与导入作业关联的现有来源的 ID。

  2. 可选：如需确认导入作业已正确创建，请获取该导入作业。

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

  3. 创建附加到导入作业的导入数据文件。

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID

{
  "format": "IMPORT_JOB_FORMAT"
}

    替换以下内容：

    • DATA_FILE_ID：新数据文件的 ID
    • IMPORT_JOB_FORMAT： IMPORT_JOB_FORMAT_MANUAL_CSV

  4. 获取数据文件。

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID

  5. 从响应的 signedUrl 字段中复制网址。

  6. 将文件上传到复制的网址。

    PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'

    替换以下内容：

    • UPLOAD_FILE_PATH：所上传文件的本地路径。
    • COPIED_URL：上一步中复制的签名网址。

  7. 可选：重复第 3-6 步，以在同一导入作业下创建更多数据文件。

  8. 可选：获取导入作业的所有数据文件。

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles

  9. 验证导入作业。

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate

  10. 获取导入作业并查看验证报告。 如果状态为 READY，则可以继续执行后续步骤。 否则，您需要修复作业或特定文件，这可能需要删除文件或上传新文件。

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

  11. 运行导入作业。

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run

  12. 获取导入作业并查看执行报告。 如果状态为 COMPLETED，则表示作业已成功执行。 否则，如果作业失败且处于终端状态，执行报告会包含错误。 创建新的导入作业并应用所需的更改。

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

如果您在上传文件时遇到问题，请了解如何排查常见错误消息。

查看上传内容

上传文件后，迁移中心会验证这些文件，以检查其格式是否正确。如果验证成功，Migration Center 随后会处理数据以创建新资产或更新现有资产。您可以在 Google Cloud 控制台中查看上传作业的状态。

如需查看上传作业的状态，请按以下步骤操作：

  1. 前往数据导入页面，然后点击文件上传。
  2. 从文件导入列表中，选择要查看的上传内容。
  3. 在文件上传页面上，查看数据导入进度下已上传文件的状态。

您的文件可能处于以下状态之一。

状态列表

  • 已完成。您的文件已成功导入。
  • 准备就绪。您的文件已通过验证，可以导入。
  • 待处理。您的文件正在等待另一个文件完成处理。
  • 正在运行。系统正在处理您的文件。
  • 验证。您的文件正处于验证阶段。
  • 验证失败。您的文件包含一些错误。请修正错误，然后尝试重新上传文件。
  • 失败。无法导入您的文件。

查看错误详情

如果您在导入文件后遇到错误，可以直接在 Google Cloud 控制台中查看错误消息。

如需查看上传作业的错误，请按以下步骤操作：

  1. 前往数据导入页面，然后点击文件上传。
  2. 点击显示警告或错误的导入文件。 导入文件详情页面会显示完整的错误列表。

在导入文件详情页面上，您可以查看导致错误的素材资源和数据字段，并查看错误说明。 文件导入作业中的错误可能会阻止 Migration Center 创建新资产或使用新更改更新现有资产。如需修正此错误，请修改文件并创建新的文件导入作业以重新上传文件。

如需详细了解可能出现的错误消息，请参阅排查文件导入错误。

导入文件规范

下表显示了用于手动导入的模板文件的技术规格。

vmInfo 文件

列 预期类型 说明
MachineId 字符串 虚拟机的唯一标识符。
MachineName 字符串 虚拟机的显示名称。
PrimaryIPAddress 字符串 机器的 IP 地址。
PrimaryMACAddress 字符串 机器的 MAC 地址。此属性仅用于标识机器。
PublicIPAddress 字符串 机器的公共 IP 地址。
IpAddressListSemiColonDelimited 消息列表 已分配或已分配的网络地址的列表。
TotalDiskAllocatedGiB int64 磁盘的总容量。
TotalDiskUsedGiB int64 磁盘中已用空间的总量。
MachineTypeLabel 字符串 AWS 或 Azure 机器类型标签。
AllocatedProcessorCoreCount int64 虚拟机中的 CPU 核心数。
MemoryGiB int32 虚拟机的内存量。
HostingLocation 字符串 AWS 或 Azure 格式的机器位置。
OsType 字符串 机器的操作系统。
OsName 字符串 机器的操作系统。
OsVersion 字符串 机器的操作系统版本。
MachineStatus 字符串 机器的电源状态。
ProvisioningState 字符串 仅适用于 Azure 虚拟机的预配状态。
CreateDate 时间戳 机器的创建时间戳。
IsPhysical 字符串 相应机器是物理机还是虚拟机。
来源 消息 AWS 或 Azure 机器的来源详细信息。

diskInfo 文件

列 预期类型 说明
MachineId 字符串 虚拟机的唯一标识符。
DiskLabel 字符串 磁盘标签。
SizeInGib int64 磁盘的总容量。
UsedInGib int64 磁盘中已用空间的总量。
StorageTypeLabel 字符串 磁盘标签类型（例如 BIOS 或 GPT）。

perfInfo 文件

列 预期类型 说明
MachineId 字符串 虚拟机的唯一标识符。
TimeStamp 收集样本时的时间戳。
CpuUtilizationPercentage 浮点数 已用 CPU 总容量的百分比。必须介于 0 到 100 之间。
MemoryUtilizationPercentage 浮点数 已用系统内存的百分比。必须介于 0 到 100 之间。
UtilizedMemoryBytes 浮点数 使用的总内存（以字节为单位）。
DiskReadOperationsPerSec 浮点数 在短时间窗口内采样的平均 IOPS。
DiskWriteOperationsPerSec 浮点数 在短时间窗口内采样的平均 IOPS。
NetworkBytesPerSecSent 浮点数 在短时间窗口内采样的平均网络出站流量（以 B/s 为单位）。
NetworkBytesPerSecReceived 浮点数 在短时间内采样的平均网络入站流量（以 B/s 为单位）。

tagInfo 文件

列 预期类型 说明
键 字符串 属性键。
值 字符串 属性值。

后续步骤