AWS IoT TwinMaker 大量操作 - AWS IoT TwinMaker
重要概念和術語

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWS IoT TwinMaker 大量操作

使用metadataTransferJob 大規模傳輸和管理 AWS IoT TwinMaker 資源。metadataTransferJob 可讓您在 AWS IoT TwinMaker 和 Amazon S3 之間執行大量操作 AWS IoT SiteWise 和傳輸資源。

您可以在下列案例中使用大量操作：

  • 在帳戶之間大量遷移資產和資料，例如從開發帳戶遷移到生產帳戶。

  • 大規模資產管理，例如大規模上傳和編輯 AWS IoT 資產。

  • 將您的資產大量匯入至 AWS IoT TwinMaker 和 AWS IoT SiteWise。

  • 從現有內科檔案大量匯入 AWS IoT TwinMaker 實體，例如 revit或 BIM 檔案。

主題

重要概念和術語

AWS IoT TwinMaker 大量操作使用以下概念和術語：

  • 匯入：將資源 AWS IoT TwinMaker 移至工作區的動作。例如，從本機檔案、Amazon S3 儲存貯體中的檔案，或從 AWS IoT SiteWise 到 AWS IoT TwinMaker 工作區。

  • 匯出：將資源從 AWS IoT TwinMaker 工作區移至本機電腦或 Amazon S3 儲存貯體的動作。

  • 來源：您要從中移動資源的起始位置。

    例如，Amazon S3 儲存貯體是匯入來源，而 AWS IoT TwinMaker 工作區是匯出來源。

  • 目的地：您要將資源移動到的所需位置。

    例如，Amazon S3 儲存貯體是匯出目的地，而 AWS IoT TwinMaker 工作區是匯入目的地。

  • AWS IoT SiteWise 結構描述：用於匯入和匯出資源的結構描述 AWS IoT SiteWise。

  • AWS IoT TwinMaker 結構描述：用於匯入和匯出資源的結構描述 AWS IoT TwinMaker。

  • AWS IoT TwinMaker 最上層資源：現有 APIs中使用的資源。具體而言，實體或 ComponentType。

  • AWS IoT TwinMaker 子層級資源：中繼資料定義中使用的巢狀資源類型。特別是元件。

  • 中繼資料：成功匯入或匯出 AWS IoT TwinMaker AWS IoT SiteWise 和資源所需的金鑰資訊。

  • metadataTransferJob：執行 時建立的物件CreateMetadataTransferJob。

AWS IoT TwinMaker metadataTransferJob 功能

本主題說明執行大量操作時 AWS IoT TwinMaker 遵循的行為 – 如何處理metadataTransferJob。它還說明如何使用轉移資源所需的中繼資料來定義結構描述。 AWS IoT TwinMaker 大量操作支援下列功能：

  • 最上層資源建立或取代： AWS IoT TwinMaker 將建立新的資源，或取代資源 ID 唯一識別的所有現有資源。

    例如，如果 實體存在於系統中，實體定義將取代為 Entity金鑰下範本中定義的新實體定義。

  • 子資源建立或取代：

    從 EntityComponent 層級，您只能建立或取代元件。實體必須已存在，否則，動作會產生 ValidationException。

    從屬性或關係層級，您只能建立或取代屬性或關係，且包含 EntityComponent 的 必須已存在。

  • 子資源刪除：

    AWS IoT TwinMaker 也支援子資源刪除。子資源可以是元件、屬性或關係。

    如果您想要刪除元件，您必須從實體層級執行。

    如果您想要刪除屬性或關係，則必須從實體或 EntityComponent 層級執行。

    若要刪除子資源，請更新更高層級的資源，並省略子資源的定義。

  • 不刪除頂層資源： AWS IoT TwinMaker 永遠不會刪除頂層資源。最上層資源是指實體或 ComponentType。

  • 一個範本中沒有相同頂層資源的子資源定義：

    您無法在相同範本中提供相同實體的完整實體定義和子資源 （例如 屬性） 定義。

    如果在實體中使用 entityId，則無法在實體、EntityComponent、屬性或關係中使用相同的 ID。

    如果 EntityComponent 中使用 entityId 或 componentName 組合，您就無法在 EntityComponent、 屬性或關係中使用相同的組合。

    如果在屬性或關係中使用 entityId、 componentName、 propertyName 組合，則無法在屬性或關係中使用相同的組合。

  • ExternalId 是選用的 AWS IoT TwinMaker：ExternalId 可用來協助您識別資源。