AWS IoT TwinMaker 批次作業 - AWS IoT TwinMaker
關鍵概念和術語

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

AWS IoT TwinMaker 批次作業

使用 a metadataTransferJob 大規模傳輸和管理您的 AWS IoT TwinMaker 資源。A metadataTransferJob 可讓您在和和 Amazon S3 之間執行批量操作 AWS IoT TwinMaker 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 頂級資源：現有 API 中使用的資源。具體而言，實體或 ComponentType.

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

  • 元數據：成功導入或導出所需的關鍵信息以 AWS IoT SiteWise 及 AWS IoT TwinMaker 資源。

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

AWS IoT TwinMaker metadataTransferJob 功能

本主題說明執行 AWS IoT TwinMaker 批次處理作業時的行為 — 如何 metadataTransferJob 處理 a。它也說明如何使用傳輸資源所需的中繼資料來定義結構描述。 AWS IoT TwinMaker 批次作業支援下列功能：

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

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

  • 子資源創建或替換：

    從 EntityComponent 層級中，您只能建立或取代元件。該實體必須已經存在，否則動作將產生一個 ValidationException.

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

  • 子資源刪除：

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

    如果要刪除元件，則必須從圖元層級執行。

    如果要刪除屬性或關係，則必須從「實體」或「 EntityComponent 層級」執行此操作。

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

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

  • 在一個模板中沒有相同頂級資源的子資源定義：

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

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

    如果在中使用實體 ID 或元件名稱組合，則無法在 EntityComponent、屬性或關係中使用相同的 EntityComponent組合。

    如果在屬性或關係中使用實體 ID、元件名稱、屬性名稱組合，則無法在屬性或關係中使用相同的組合。

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