常用案例 - AWS IoT SiteWise
移動資料串流將別名指派給資產屬性時發生錯誤將資料串流與資產屬性建立關聯時發生錯誤

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

常用案例

移動資料串流

若要變更資料串流與另一個資產屬性的關聯，請先取消資料串流與目前資產屬性的關聯。取消資料串流與資產屬性的關聯時，必須指派別名至該資產屬性。


    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>

將別名指派給資產屬性時發生錯誤

使用 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 使用別名擷取資料至 ，就會發生這種情況。當資料以另一個資料串流或資產屬性未使用的別名傳送時，會使用該別名建立新的資料串流。以下兩個選項可解決問題。

  • 使用 AssociateTimeSeriesToAssetProperty API 將資料串流與其別名與資產屬性建立關聯。

  • 暫時停止資料擷取並刪除資料串流。使用 UpdateAssetProperty API 將別名指派給資產屬性，然後重新開啟資料擷取。

將資料串流與資產屬性建立關聯時發生錯誤

將資料串流與資產屬性建立關聯時，會看到下列錯誤訊息。

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

此錯誤訊息表示資產屬性已與包含資料的資料串流相關聯。在將其他資料串流與該資產屬性建立關聯之前，該資料串流必須取消關聯或刪除。

注意

取消資料串流與資產屬性的關聯時，指派給屬性的別名會提供給資料串流。若要讓該別名保持指派給 屬性，請先將新的別名指派給該屬性，再取消資料串流的關聯。

若要保留儲存在資產屬性中的資料，請執行下列動作：

  • 確保資產屬性未擷取任何資料，以防止建立新的資料串流。

  • 使用 UpdateAssetProperty API 設定提供給目前指派資料串流的新別名。

  • 使用 DisassociateTimeSeriesFromAssetProperty API 取消目前資料串流與資產屬性的關聯。

  • 使用 AssociateTimeSeriesToAssetProperty API 將所需的資料串流與資產屬性建立關聯。

如果必須刪除存放在資產屬性中的資料，請執行下列動作：

  • 確保資產屬性未擷取任何資料，以防止建立新的資料串流。

  • 使用 DeleteTimeSeries API 刪除目前指派的資料串流。

  • 使用 AssociateTimeSeriesToAssetProperty API 將所需的資料串流與資產屬性建立關聯。