View a markdown version of this page

使用資產和模型進行大量操作 - AWS IoT SiteWise
重要概念和術語受支援的功能

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

使用資產和模型進行大量操作

若要使用大量資產或資產模型，請使用大量操作來大量匯入和匯出資源到不同的位置。例如，您可以建立資料檔案來定義 Amazon S3 儲存貯體中的資產或資產模型，並使用大量匯入來建立或更新它們AWS IoT SiteWise。或者，如果您有大量的資產或資產模型AWS IoT SiteWise，您可以將它們匯出至 Amazon S3。

注意

您可以透過在 AWS IoT TwinMakerAPI 中AWS IoT SiteWise呼叫 操作，在 中執行大量操作。您可以這樣做，而無需設定AWS IoT TwinMaker或建立AWS IoT TwinMaker工作區。您只需要一個 Amazon S3 儲存貯體，您可以在其中放置AWS IoT SiteWise內容。

主題

重要概念和術語

AWS IoT SiteWise大量匯入和匯出功能依賴下列概念和術語：

  • 匯入：將資產或資產模型從 Amazon S3 儲存貯體中的檔案移至 的動作AWS IoT SiteWise。

  • 匯出：將資產或資產模型從 移至 Amazon S3 儲存貯AWS IoT SiteWise體的動作。

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

    例如，Amazon S3 儲存貯體是匯入來源，AWS IoT SiteWise也是匯出來源。

  • 目的地：您要將內容移至其中的所需位置。

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

  • AWS IoT SiteWise結構描述：此結構描述用於從中匯入和匯出中繼資料AWS IoT SiteWise。

  • 最上層資源：您可以個別建立或更新AWS IoT SiteWise的資源，例如資產或資產模型。

  • 子資源：頂層AWS IoT SiteWise資源中的巢狀資源。範例包括屬性、階層和複合模型。

  • 中繼資料：成功匯入或匯出資源所需的金鑰資訊。中繼資料的範例是資產和資產模型的定義。

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

受支援的功能

本主題說明執行大量操作時可以執行的操作。大量操作支援下列功能：

  • 最上層資源建立：當您匯入的資產或資產模型未定義 ID，或其 ID 與現有資源的 ID 不相符時，將會建立新的資源。

  • 最上層資源取代：當您匯入 ID 與已存在的資產或資產模型相符時，它會取代現有的資源。

  • 子資源建立、取代或刪除：當您的匯入取代資產或資產模型等頂層資源時，新定義會取代所有子資源，例如屬性、階層或複合模型。

    例如，如果您在大量匯入期間更新資產模型，且更新版本定義了原始屬性上不存在的屬性，則會建立新的屬性。如果定義已存在的屬性，則會更新現有的屬性。如果更新的資產模型省略存在於原始的 屬性，則會刪除 屬性。

  • 不刪除頂層資源：大量操作不會刪除資產或資產模型。大量操作只會建立或更新它們。