翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # とアセットの同期 AWS IoT SiteWise AWS IoT TwinMaker は、アセットとアセットモデルのアセット同期 (アセット同期) AWS IoT SiteWise をサポートします。 AWS IoT SiteWise コンポーネントタイプを使用すると、アセット同期は既存の AWS IoT SiteWise アセットとアセットモデルを取得し、これらのリソースを AWS IoT TwinMaker エンティティ、コンポーネント、コンポーネントタイプに変換します。以下のセクションでは、アセット同期を設定する方法と、 AWS IoT TwinMaker ワークスペースに同期できる AWS IoT SiteWise アセットとアセットモデルについて説明します。 **Topics** + [でのアセット同期の使用 AWS IoT SiteWise](tm-sw-asset-sync-use.md) + [カスタムワークスペースとデフォルトワークスペースの違い](tm-sw-default-ws-diffs.md) + [から同期されたリソース AWS IoT SiteWise](tm-sw-asset-sync-map.md) + [同期ステータスとエラーを分析する](tm-sw-asset-sync-ts.md) + [同期ジョブを削除する](tm-sw-asset-sync-delete.md) + [アセット同期の上限](tm-sw-asset-sync-limits.md) # でのアセット同期の使用 AWS IoT SiteWise このトピックでは、 AWS IoT SiteWise アセット同期を有効にして設定する方法について説明します。使用しているワークスペースのタイプに基づいて、適切な手順に従ってください。 **重要** カスタムワークスペースとデフォルトワークスペースの違いについては、[カスタムワークスペースとデフォルトワークスペースの違い](tm-sw-default-ws-diffs.md)「」を参照してください。 **Topics** + [カスタムワークスペースの使用](tm-sw-custom-ws.md) + [IoTSiteWiseDefaultWorkspace の使用](tm-sw-default-ws.md) # カスタムワークスペースの使用 アセット同期を有効にする前に、次の前提条件を確認します。 ## 前提条件 を使用する前に AWS IoT SiteWise、以下を完了する必要があります。 + AWS IoT TwinMaker ワークスペースがある。 + にアセットとアセットモデルがあります AWS IoT SiteWise。モデル作成の詳細については、「[アセットモデルの作成](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/create-asset-models.html)」を参照してください。 + 次の AWS IoT SiteWise アクションの読み取り権限を持つ既存の IAM ロール。 + `ListAssets` + `ListAssetModels` + `DescribeAsset` + `DescribeAssetModel` + IAM ロールには、 に対する次の書き込みアクセス許可が必要です AWS IoT TwinMaker。 + `CreateEntity` + `UpdateEntity` + `DeleteEntity` + `CreateComponentType` + `UpdateComponentType` + `DeleteComponentType` + `ListEntities` + `GetEntity` + `ListComponentTypes` 次の IAM ロールを必要なロールのテンプレートとして使用します。 ``` // trust relationships { { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": [ "iottwinmaker.amazonaws.com" ] }, "Action": "sts:AssumeRole" } ] } // permissions - replace ACCOUNT_ID, REGION, WORKSPACE_ID with actual values { "Version": "2012-10-17", "Statement": [{ "Sid": "SiteWiseAssetReadAccess", "Effect": "Allow", "Action": [ "iotsitewise:DescribeAsset" ], "Resource": [ "arn:aws:iotsitewise:REGION:ACCOUNT_ID:asset/*" ] }, { "Sid": "SiteWiseAssetModelReadAccess", "Effect": "Allow", "Action": [ "iotsitewise:DescribeAssetModel" ], "Resource": [ "arn:aws:iotsitewise:REGION:ACCOUNT_ID:asset-model/*" ] }, { "Sid": "SiteWiseAssetModelAndAssetListAccess", "Effect": "Allow", "Action": [ "iotsitewise:ListAssets", "iotsitewise:ListAssetModels" ], "Resource": [ "*" ] }, { "Sid": "TwinMakerAccess", "Effect": "Allow", "Action": [ "iottwinmaker:GetEntity", "iottwinmaker:CreateEntity", "iottwinmaker:UpdateEntity", "iottwinmaker:DeleteEntity", "iottwinmaker:ListEntities", "iottwinmaker:GetComponentType", "iottwinmaker:CreateComponentType", "iottwinmaker:UpdateComponentType", "iottwinmaker:DeleteComponentType", "iottwinmaker:ListComponentTypes" ], "Resource": [ "arn:aws:iottwinmaker:REGION:ACCOUNT_ID:workspace/WORKSPACE_ID", "arn:aws:iottwinmaker:REGION:ACCOUNT_ID:workspace/WORKSPACE_ID/*" ] } ] } ``` 以下の手順を使用して、 AWS IoT SiteWise のアセット同期を有効にします。 1. [AWS IoT TwinMaker コンソール](https://console.aws.amazon.com/iottwinmaker/)で **[設定]** ページに移動します。 1. **[モデルソース]** タブを開きます。 ![\[AWS IoT TwinMaker モデルソースタブが開いたコンソールの設定ページ。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/asset-sync-settings.png) 1. **Connect workspace** を選択して、ワークスペースを AWS IoT TwinMaker AWS IoT SiteWise アセットにリンクします。 **注記** アセット同期は 1 つの AWS IoT TwinMaker ワークスペースでのみ使用できます。別のワークスペースで同期する場合は、ワークスペースから同期を切断し、別のワークスペースに接続する必要があります。 1. 次に、アセットの同期を使用するワークスペースに移動します。 1. 「**ソースを追加**」 を選択します。**[エンティティモデルソースを追加]** ページが開きます。 ![\[エンティティモデルソースの追加ページ。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/add-model-source.png) 1. **[エンティティモデルソースを追加]** ページで、[ソース] フィールドに **AWS IoT SiteWise** が表示されることを確認します。**[IAM ロール]** で、前提条件として作成した IAM ロールを選択します。 1. これで、 AWS IoT SiteWise アセット同期が有効になりました。選択した **[ワークスペース]** ページの上部に、アセットの同期がアクティブであることを確認する確認バナーが表示されます。また、**[エンティティモデルソース]** セクションに同期ソースが表示されます。 ![\[エンティティモデルソースのリストを示すワークスペースページ。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/success-sync.png) # IoTSiteWiseDefaultWorkspace の使用 [AWS IoT SiteWiseAWS IoT TwinMaker 統合](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/integrate-tm.html)にオプトインすると、 という名前のデフォルトのワークスペース`IoTSiteWiseDefaultWorkspace`が作成され、自動的に同期されます AWS IoT SiteWise。 API を使用して AWS IoT TwinMaker `CreateWorkspace`、 という名前のワークスペースを作成することもできます`IoTSiteWiseDefaultWorkspace`。 ## 前提条件 を作成する前に`IoTSiteWiseDefaultWorkspace`、以下を実行していることを確認してください。 + AWS IoT TwinMaker サービスにリンクされたロールを作成します。詳細については「[のサービスにリンクされたロールの使用 AWS IoT TwinMaker](using-service-linked-roles.md)」を参照してください。 + IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。 ロールまたはユーザーを確認し、 へのアクセス許可があることを確認します`iotsitewise:EnableSiteWiseIntegration`。 必要に応じて、ロールまたはユーザーにアクセス許可を追加します。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:EnableSiteWiseIntegration", "Resource": "*" } ] } ``` ------ # カスタムワークスペースとデフォルトワークスペースの違い **重要** AWS IoT SiteWise などの新機能は[https://docs.aws.amazon.com//iot-sitewise/latest/userguide/custom-composite-models.html](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/custom-composite-models.html)、 でのみ使用できます`IoTSiteWiseDefaultWorkspace`。カスタムワークスペースの代わりにデフォルトのワークスペースを使用することをお勧めします。 を使用する場合`IoTSiteWiseDefaultWorkspace`、アセット同期でカスタムワークスペースを使用することにはいくつかの顕著な違いがあります。 + デフォルトのワークスペースを作成する場合、Amazon S3 の場所と IAM ロールはオプションです。 **注記** を使用して`UpdateWorkspace`、Amazon S3 の場所と IAM ロールを指定できます。 + には、リソースを同期する AWS IoT SiteWise リソース数の制限`IoTSiteWiseDefaultWorkspace`はありません AWS IoT TwinMaker。 + リソースを から同期すると AWS IoT SiteWise、リソース`SyncSource`は になります`SITEWISE_MANAGED`。これには、 `Entities`と が含まれます`ComponentTypes`。 + などの新機能`CompositionModel`は AWS IoT SiteWise 、 でのみ使用できます`IoTSiteWiseDefaultWorkspace`。 にはいくつかの制限があります`IoTSiteWiseDefaultWorkspace`。 + デフォルトのワークスペースは削除できません。 + リソースを削除するには、まず AWS IoT SiteWise リソースを削除する必要があります。その後、 の対応するリソース AWS IoT TwinMaker が削除されます。 # から同期されたリソース AWS IoT SiteWise このトピックでは、ワークスペース AWS IoT SiteWise に同期できるアセットを一覧表示します AWS IoT TwinMaker 。 **重要** カスタムワークスペースとデフォルトワークスペースの違いについては、[カスタムワークスペースとデフォルトワークスペースの違い](tm-sw-default-ws-diffs.md)「」を参照してください。 ## カスタムワークスペースとデフォルトワークスペース 次のリソースは同期され、カスタムワークスペースとデフォルトワークスペース**の両方で**使用できます。 **アセットモデル** AWS IoT TwinMaker は、 でアセットモデルごとに新しいコンポーネントタイプを作成します AWS IoT SiteWise。 + `TypeId` アセットモデルのコンポーネントは、次のいずれかのパターンを使用します。 + **カスタムワークスペース - ** `iotsitewise.assetmodel:assetModelId` + **デフォルトのワークスペース -** `assetModelId` + アセットモデル内の各プロパティは、次のいずれかの命名パターンを持つコンポーネントタイプの新しいプロパティです。 + **カスタムワークスペース - ** `Property_propertyId` + **デフォルトのワークスペース - ** `propertyId` のプロパティ名 AWS IoT SiteWise は、 プロパティ定義`displayName`の として保存されます。 + アセットモデルの各階層は タイプの新しいプロパティ`LIST`であり、 `nestedType`は コンポーネントタイプ`RELATIONSHIP`です。階層は、次のいずれかのプレフィックスが付いた名前で プロパティにマッピングされます。 + **カスタムワークスペース - ** `Hierarchy_hierarchyId` + **デフォルトのワークスペース - ** `hierarchyId` **アセット** AWS IoT TwinMaker は、 のアセットごとに新しいエンティティを作成します AWS IoT SiteWise。 + `entityId` は `assetId`の と同じです AWS IoT SiteWise。 + これらのエンティティには `sitewiseBase` という単一のコンポーネントがあり、そのコンポーネントタイプはこのアセットのアセットモデルに対応します。 + プロパティエイリアスや測定単位の設定など、アセットレベルのオーバーライドはすべて、 AWS IoT TwinMakerのエンティティに反映されます。 ## デフォルトのワークスペースのみ 次のアセットは同期され、**デフォルトのワークスペース でのみ使用できます**`IoTSiteWiseDefaultWorkspace`。 **AssetModelComponents** AWS IoT TwinMaker は、 `AssetModelComponents` ごとに新しいコンポーネントタイプを作成します AWS IoT SiteWise。 + アセットモデルのコンポーネントは`TypeId`、次のパターンを使用します: `assetModelId`。 + アセットモデル内の各プロパティは、コンポーネントタイプの新しいプロパティで、プロパティ名は `propertyId` です。のプロパティ名 AWS IoT SiteWise は、プロパティ定義`displayName`の として保存されます。 + アセットモデルの各階層は タイプの新しいプロパティ`LIST`であり、 `nestedType`は コンポーネントタイプ`RELATIONSHIP`です。階層は、名前の前に `hierarchyId` が付いたプロパティにマップされます。 **AssetModelCompositeModel** AWS IoT TwinMaker は、 `AssetModelCompositeModel` ごとに新しいコンポーネントタイプを作成します AWS IoT SiteWise。 + アセットモデルのコンポーネントは`TypeId`、次のパターンを使用します: `assetModelId_assetModelCompositeModelId`。 + アセットモデル内の各プロパティは、コンポーネントタイプの新しいプロパティで、プロパティ名は `propertyId` です。のプロパティ名 AWS IoT SiteWise は、プロパティ定義`displayName`の として保存されます。 **AssetCompositeModels** AWS IoT TwinMaker は、 `AssetCompositeModel` のそれぞれの新しい複合コンポーネントを作成します AWS IoT SiteWise。 + `componentName` は `assetModelCompositeModelId`の と同じです AWS IoT SiteWise。 ## リソースが同期されていません 次のリソースは同期されません。 **同期されていないアセットとアセットモデル** + アラームモデルは compositeModels として同期されますが、アラームに関連するアセット内の対応するデータは同期されません。 + [AWS IoT SiteWise データストリームは](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/manage-data-streams.html)同期されません。アセットモデルでモデル化されたプロパティのみが同期されます。 + 属性、測定値、変換、集計、および式やウィンドウなどのメタデータ計算のプロパティ値は同期されません。エイリアス、測定単位、データ型など、プロパティに関するメタデータのみが同期されます。値は、通常の AWS IoT TwinMaker データコネクタ API である [ GetPropertyValueHistory](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetPropertyValueHistory.html) を使用してクエリできます。 ## で同期されたエンティティとコンポーネントタイプを使用する AWS IoT TwinMaker アセットが同期されると AWS IoT SiteWise、同期されたコンポーネントタイプは読み取り専用になります AWS IoT TwinMaker。更新または削除アクションは で実行する必要があり AWS IoT SiteWise、syncJob がまだアクティブな AWS IoT TwinMaker 場合、それらの変更は に同期されます。 同期されたエンティティと AWS IoT SiteWise ベースコンポーネントも読み取り専用です AWS IoT TwinMaker。説明や `entityName` などのエンティティレベルの属性が更新されていない限り、同期されていないコンポーネントを同期されたエンティティに追加できます。 同期されたエンティティを操作する方法には、いくつかの制限があります。同期されたエンティティの階層で同期されたエンティティの下に子エンティティを作成することはできません。さらに、同期されたコンポーネントタイプから拡張された非同期コンポーネントタイプを作成することはできません。 **注記** アセットが で削除された場合、 AWS IoT SiteWise または同期ジョブを削除した場合、追加のコンポーネントはエンティティとともに削除されます。 これらの同期されたエンティティは Grafana ダッシュボードで使用でき、通常のエンティティと同様にシーンコンポーザーにタグとして追加できます。これらの同期されたエンティティに対してナレッジグラフクエリを発行することもできます。 **注記** 変更されていない同期されたエンティティには料金は発生しませんが、 AWS IoT TwinMakerで変更が加えられた場合はそれらのエンティティに対して料金が発生します。たとえば、同期されていないコンポーネントを同期されたエンティティに追加すると、そのエンティティに課金されるようになりました AWS IoT TwinMaker。詳細については、[AWS IoT TwinMaker の料金](https://aws.amazon.com//iot-twinmaker/pricing/)を参照してください。 # 同期ステータスとエラーを分析する このトピックでは、同期エラーとステータスを分析する方法についてのガイダンスを提供します。 **重要** カスタムワークスペースとデフォルトワークスペースの違いについては、[カスタムワークスペースとデフォルトワークスペースの違い](tm-sw-default-ws-diffs.md)「」を参照してください。 ## ジョブステータスを同期する 同期ジョブは、状態に応じて以下のいずれかのステータスになります。 + 同期ジョブ`CREATING`の状態は、同期を準備する AWS IoT SiteWise ためにジョブがアクセス許可をチェックし、 からデータをロードしていることを意味します。 + 同期ジョブ`INITIALIZING`の状態は、 のすべての既存のリソース AWS IoT SiteWise が同期されていることを意味します AWS IoT TwinMaker。ユーザーが多数のアセットとアセットモデルが AWS IoT SiteWiseにある場合は、この手順が完了するまでに時間がかかることがあります。同期されたリソースの数は、[AWS IoT TwinMaker コンソール](https://console.aws.amazon.com/iottwinmaker/)で同期ジョブを確認するか、`ListSyncResources` API を呼び出して監視できます。 + 同期ジョブの `ACTIVE` 状態は、初期化ステップが完了している状態です。これで、ジョブは AWS IoT SiteWiseからの新しい更新を同期する準備ができました。 + 同期ジョブの `ERROR` 状態は、前述のいずれかの状態でのエラーを示しています。エラーメッセージを確認します。IAM ロールの設定に問題がある可能性があります。新しい IAM ロールを使用する場合は、エラーが発生した同期ジョブを削除し、新しいロールで新しい同期ジョブを作成します。 同期エラーは、ワークスペースの **[エンティティモデルソース]** テーブルからアクセスできるモデルソースページに表示されます。モデルソースページには、同期に失敗したリソースのリストが表示されます。ほとんどのエラーは同期ジョブによって自動的に再試行されますが、リソースにアクションが必要な場合は `ERROR` 状態のままになります。[ ListSyncResources](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListSyncResources.html) API を使用してエラーのリストを取得することもできます。 現在のソースのリストにあるエラーをすべて表示するには、以下の手順を実行します。 1. [AWS IoT TwinMaker コンソール](https://console.aws.amazon.com/iottwinmaker/)のワークスペースに移動します。 1. エンティティモデル AWS IoT SiteWise ソースモーダルにリストされているソースを選択して、アセット同期の詳細ページを開きます。 **** ![\[AWS IoT SiteWise ソースページには、エラーを含むアセット同期の詳細が表示されます。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/synced-resources.png) 1. 前のスクリーンショットに示すように、エラーが続くリソースは **[エラー]** テーブルに一覧表示されます。このテーブルを使用して、特定のリソースに関連するエラーを追跡して修正できます。 次のようなエラーが考えられます。 + は重複するアセット名 AWS IoT SiteWise をサポートしますが、 は同じ親エンティティではなく、 `ROOT`レベルで AWS IoT TwinMaker のみサポートします。の親エンティティの下に同じ名前のアセットが 2 つある場合 AWS IoT SiteWise、そのうちの 1 つは同期に失敗します。このエラーを修正するには、同期 AWS IoT SiteWise する前に、いずれかのアセットを削除するか、 で別の親アセットに移動してください。 + アセット ID AWS IoT SiteWise と同じ ID を持つエンティティが既にある場合、そのアセットは既存のエンティティを削除するまで同期されません。 # 同期ジョブを削除する 以下の手順に従って、同期ジョブを削除します。 **重要** カスタムワークスペースとデフォルトワークスペースの違いについては、[カスタムワークスペースとデフォルトワークスペースの違い](tm-sw-default-ws-diffs.md)「」を参照してください。 1. [AWS IoT TwinMaker コンソール](https://console.aws.amazon.com/iottwinmaker/)に移動します。 1. 同期ジョブを削除するワークスペースを開きます。 1. **[エンティティモデルソース]** で、[ AWS IoT SiteWise ソース] を選択してソースの詳細ページを開きます。 1. 同期ジョブを停止するには、**[切断]** を選択します。同期ジョブを完全に削除するかどうかの選択を確定します。 ![\[Disconnect AWS IoT SiteWise 同期ダイアログボックスには、同期ジョブをキャンセルまたは切断するボタンがあります。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/confirm-delete.png) 同期ジョブが削除されると、同じワークスペースまたは別のワークスペースで同期ジョブを再作成できます。 ワークスペースに同期ジョブがある場合、そのワークスペースを削除することはできません。ワークスペースを削除する前に、まず同期ジョブを削除してください。 同期ジョブの削除中にエラーが発生した場合、同期ジョブは `DELETING` 状態のままになり、自動的に再試行されます。リソースの削除に関連するエラーが発生した場合に、同期されたエンティティまたはコンポーネントタイプを手動で削除できるようになりました。 **注記** から同期されたリソース AWS IoT SiteWise はすべて最初に削除され、同期ジョブ自体が削除されます。 # アセット同期の上限 **重要** カスタムワークスペースとデフォルトワークスペースの違いについては、[カスタムワークスペースとデフォルトワークスペースの違い](tm-sw-default-ws-diffs.md)「」を参照してください。 [AWS IoT SiteWise クォータ](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html)はデフォルトの [AWS IoT TwinMaker クォータ](https://docs.aws.amazon.com//general/latest/gr/iot-twinmaker.html)よりも高いため、 AWS IoT SiteWiseからの同期のエンティティとコンポーネントタイプの以下の制限を引き上げています。 + ワークスペース内の同期コンポーネントタイプは 1,000 個です。これは、1,000 個のアセットモデルのみを同期できるためです AWS IoT SiteWise。 + ワークスペース内の 100,000 個の同期されたエンティティは、100,000 個のアセットのみを同期できるためです AWS IoT SiteWise。 + 親エンティティあたりの子エンティティは最大 2000 です。1 つの親アセットにつき 2000 の子アセットを同期します。 **注記** [GetEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetEntity.html) API は階層プロパティの最初の 50 の子エンティティのみを返しますが、[GetPropertyValue](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetPropertyValue.html) API を使用してすべての子エンティティのリストをページ分割して取得できます。 + 同期されたコンポーネントごとに 600 個のプロパティ AWS IoT SiteWise。アセットモデルを 600 個のプロパティと階層に同期できます。 **注記** これらの制限は同期されたエンティティにのみ適用されます。同期されていないリソースの制限を増やす必要がある場合は、クォータ引き上げをリクエストしてください。