View a markdown version of this page

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

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

Amazon IoT TwinMaker 批量操作

使用元数据TransferJob 大规模传输和管理您的 Amazon IoT TwinMaker 资源。元数据TransferJob 允许您在和和 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 顶级资源：现有 API 中使用的资源。具体而言，一个实体或 ComponentType.

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

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

  • 元数据 TransferJob：运行时创建的对象CreateMetadataTransferJob。

Amazon IoT TwinMaker 元数据TransferJob 功能

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

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

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

  • Sub-resource 创建或替换：

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

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

  • Sub-resource 删除：

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

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

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

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

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

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

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

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

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

    如果在属性或关系中使用实体ID、组件名称、属性名称组合，则不能在属性或关系中使用相同的组合。

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