翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 一般的なシナリオ
<a name="data-ingestion-scenarios"></a>

## データストリームを移動する
<a name="data-ingestion-scenario-move-data-stream"></a>

 データストリームの関連付けを別のアセットプロパティに変更するには、まず現在のアセットプロパティからデータストリームの関連付けを解除します。アセットプロパティからデータストリームの関連付けを解除する場合、そのアセットプロパティにエイリアスを割り当てる必要があります。

```
    aws iotsitewise disassociate-time-series-from-asset-property \ 
        --alias <asset-property-alias> \
        --assetId <asset-ID> \
        --propertyId <property-ID>
```

 次に、データストリームを新しいアセットプロパティに再割り当てします。

```
    aws iotsitewise associate-time-series-from-asset-property \ 
        --alias <data-stream-alias> \
        --assetId <new-asset-ID> \
        --propertyId <new-property-ID>
```

## アセットプロパティにエイリアスを割り当てるときのエラー
<a name="data-ingestion-scenario-assetid-contains-data"></a>

 `UpdateAssetProperty` API を使用して プロパティにエイリアスを割り当てると、次のエラーメッセージが表示されることがあります。

```
Given alias <data-stream-alias> for property <property-name> with ID <property-ID> already in use by another property or data stream
```

 このエラーメッセージは、現在別のプロパティまたはデータストリームで使用されているため、エイリアスが プロパティに割り当てられていないことを示します。

 これは、データがエイリアス AWS IoT SiteWise で に取り込まれている場合に発生します。別のデータストリームまたはアセットプロパティによって使用されていないエイリアスでデータが送信されると、そのエイリアスで新しいデータストリームが作成されます。以下の 2 つのオプションで問題を解決します。
+  `AssociateTimeSeriesToAssetProperty` API を使用して、データストリームとそのエイリアスをアセットプロパティに関連付けます。
+  データ取り込みを一時的に停止し、データストリームを削除します。`UpdateAssetProperty` API を使用してアセットプロパティにエイリアスを割り当て、データ取り込みを再度オンにします。

## データストリームをアセットプロパティに関連付けるときのエラー
<a name="data-ingestion-scenario-move-data-stream"></a>

 データストリームをアセットプロパティに関連付けると、次のエラーメッセージが表示されます。

```
assetProperty <property-name> with assetId <asset-ID> propertyId <property-ID> contains data
```

 このエラーメッセージは、アセットプロパティが既にデータを含むデータストリームに関連付けられていることを示します。他のデータストリームをそのアセットプロパティに関連付ける前に、そのデータストリームの関連付けを解除または削除する必要があります。

**注記**  
 アセットプロパティからデータストリームの関連付けを解除すると、プロパティに割り当てられたエイリアスがデータストリームに割り当てられます。そのエイリアスを プロパティに割り当てたままにするには、データストリームの関連付けを解除する前に、そのプロパティに新しいエイリアスを割り当てます。

 アセットプロパティに保存されているデータを保持するには、次の手順を実行します。
+  新しいデータストリームが作成されないように、アセットプロパティにデータが取り込まれていないことを確認します。
+  `UpdateAssetProperty` API を使用して、現在割り当てられているデータストリームに与えられる新しいエイリアスを設定します。
+  `DisassociateTimeSeriesFromAssetProperty` API を使用して、アセットプロパティから現在のデータストリームの関連付けを解除します。
+  `AssociateTimeSeriesToAssetProperty` API を使用して、目的のデータストリームをアセットプロパティに関連付けます。

 アセットプロパティに保存されているデータを削除する必要がある場合は、次の操作を行います。
+  新しいデータストリームが作成されないように、アセットプロパティにデータが取り込まれていないことを確認します。
+  `DeleteTimeSeries` API を使用して、現在割り当てられているデータストリームを削除します。
+  `AssociateTimeSeriesToAssetProperty` API を使用して、目的のデータストリームをアセットプロパティに関連付けます。