Amazon IoT TwinMaker 批量操作 - Amazon IoT TwinMaker
关键概念和术语
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon IoT TwinMaker 批量操作

使用大规模 metadataTransferJob 转移和管理您的 Amazon IoT TwinMaker 资源。A metadataTransferJob 允许您在和和 Amazon S3 之间执行批量操作 Amazon IoT TwinMaker Amazon IoT SiteWise 和传输资源。

您可以在以下场景中使用批量操作：

  • 在账户之间大规模迁移资产和数据，例如从开发账户迁移到生产账户。

  • 大规模资产管理，例如大规模上传和编辑 Amazon IoT 资产。

  • 将您的资产批量导入 Amazon IoT TwinMaker 和 Amazon IoT SiteWise。

  • 从现有本体文件（例如revit或BIM文件）中批量导入 Amazon IoT TwinMaker 实体。

主题

关键概念和术语

Amazon IoT TwinMaker 批量操作使用以下概念和术语：

  • 导入：将资源移入 Amazon IoT TwinMaker 工作区的操作。例如，从本地文件、Amazon S3 存储桶中的文件或从 Amazon IoT SiteWise 到 Amazon IoT TwinMaker 工作空间。

  • 导出：将资源从 Amazon IoT TwinMaker 工作空间移动到本地计算机或 Amazon S3 存储桶的操作。

  • 来源：您要移动资源的起始位置。

    例如，Amazon S3 存储桶是导入源， Amazon IoT TwinMaker 工作空间是导出源。

  • 目的地：您要将资源转移到的所需位置。

    例如，Amazon S3 存储桶是导出目标， Amazon IoT TwinMaker 工作空间是导入目标。

  • Amazon IoT SiteWise 架构：用于导入和导出资源的架构 Amazon IoT SiteWise。

  • Amazon IoT TwinMaker 架构：用于导入和导出资源的架构 Amazon IoT TwinMaker。

  • Amazon IoT TwinMaker 顶级资源：现有资源中使用的资源 APIs。具体而言，一个实体或 ComponentType.

  • Amazon IoT TwinMaker 子级资源：元数据定义中使用的嵌套资源类型。具体而言，是组件。

  • 元数据：成功导入或导出所需的关键 Amazon IoT SiteWise 信息和 Amazon IoT TwinMaker 资源。

  • metadataTransferJob：运行时创建的对象CreateMetadataTransferJob。

Amazon IoT TwinMaker metadataTransferJob 功能

本主题说明了运行批量操作时 Amazon IoT TwinMaker 所遵循的行为， metadataTransferJob 即如何处理。它还说明了如何使用传输资源所需的元数据来定义架构。 Amazon IoT TwinMaker 批量操作支持以下功能：

  • 顶级资源创建或替换： Amazon IoT TwinMaker 将创建新资源或替换所有由资源 ID 唯一标识的现有资源。

    例如，如果系统中存在一个实体，则该实体定义将被该Entity密钥下模板中定义的新实体定义所取代。

  • 子资源创建或替换：

    在 EntityComponent 关卡中，您只能创建或替换组件。该实体必须已经存在，否则，该操作将生成 ValidationException.

    在属性或关系级别上，您只能创建或替换属性或关系，并且包含的属性或关系 EntityComponent 必须已经存在。

  • 子资源删除：

    Amazon IoT TwinMaker 还支持删除子资源。子资源可以是组件、属性或关系。

    如果要删除组件，则必须从实体级别进行删除。

    如果要删除属性或关系，则必须从实体或 EntityComponent 关卡中删除。

    要删除子资源，请更新更高级别的资源并省略子资源的定义。

  • 不删除顶级资源： Amazon IoT TwinMaker 永远不会删除顶级资源。顶级资源是指实体或 ComponentType。

  • 在一个模板中没有针对同一顶级资源的子资源定义：

    您不能在同一个模板中提供同一实体的完整实体定义和子资源（如属性）定义。

    如果实体中使用了 EntityID，则不能在实体 EntityComponent、属性或关系中使用相同的 ID。

    如果在中使用了 EntityID 或 componentName 组合 EntityComponent，则不能在 EntityComponent、属性或关系中使用相同的组合。

    如果在属性或关系中使用了 EntityID、componentName、PropertyName 组合，则不能在属性或关系中使用相同的组合。

  • ExternalId 是可选的 Amazon IoT TwinMaker： ExternalId 可用于帮助您识别资源。