本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
常用案例
移動資料串流
若要變更資料串流與另一個資產屬性的關聯,請先取消資料串流與目前資產屬性的關聯。取消資料串流與資產屬性的關聯時,必須指派別名至該資產屬性。
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 將所需的資料串流與資產屬性建立關聯。