手动创建和上传数据表

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

如需手动创建和上传数据表，请按照以下步骤操作：

  1. 从可用模板 列表中下载模板。
  2. 使用基础架构中的数据手动填写表格。
  3. 将表格上传 到 Migration Center。

限制

  • 上传的文件大小上限为 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 会对其进行验证，以检查其格式是否正确。如果验证成功，Migration Center 会处理数据以创建新资产或更新现有资产。您可以在 控制台 Google Cloud 中查看上传作业的状态。

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

  1. 在 Google Cloud 控制台中，前往 数据导入 页面。

    前往“数据导入”

  2. 在文件上传 标签页的文件导入列表中，点击要查看的导入作业。

  3. 查看上传文件的状态 。

    您可以看到文件处于以下状态之一：

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

查看错误详情

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

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

  1. 在 Google Cloud 控制台中，前往 数据导入 页面。

    前往“数据导入”

  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 字符串 机器是物理机还是虚拟机。
Source 消息 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/秒为单位）。
NetworkBytesPerSecReceived 浮点数 在短时间内采样的平均网络入站流量（以 B/秒为单位）。

tagInfo 文件

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

后续步骤