でタグを使用する AWS IoT SiteWise - AWS IoT SiteWise

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

でタグを使用する AWS IoT SiteWise

タグを使用して、ユースケースの目的、所有者、環境、またはその他の分類で AWS IoT SiteWise リソースを分類します。同じ型のリソースが多い場合に、そのタグに基づいて特定のリソースをすばやく識別できます。

各タグは、ユーザーが定義したキーとオプション値で構成されます。例えば、アセットモデルの一連のタグを確立して、それらがサポートする産業プロセスに従って追跡できます。管理するリソースのタイプごとにカスタマイズされたタグキーのセットを開発することをお勧めします。一貫性のある一連のタグキーを使用することで、リソースの管理が容易になります。

でタグ付けする AWS Management Console

タグエディタ AWS Management Console は、すべての AWS サービスからリソースのタグを作成および管理するための一元的で統一された方法を提供します。詳細については、「 AWS リソースのタグ付け」および「タグエディタユーザーガイド」の「タグエディタの開始方法」を参照してください。

AWS IoT SiteWise API でタグ付けする

AWS IoT SiteWise API はタグも使用します。タグを作成する前に、タグの制限に注意してください。詳細については、「AWS 全般のリファレンス」の「タグの命名規則と使用規則」を参照してください。

  • リソースの作成時にタグを追加するには、リソースの tags プロパティでタグを定義します。

  • 既存のリソースにタグを追加したり、タグ値を更新するには、TagResource オペレーションを使用します。

  • リソースからタグを削除するには、UntagResource オペレーションを使用します。

  • リソースに関連付けられたタグを取得するには、ListTagsForResource オペレーションを使用するか、リソースを取得してその tags プロパティを調べます。

次の表に、 AWS IoT SiteWise API を使用してタグ付けできるリソースと、対応する Create および Describeオペレーションを示します。

タグ付け可能な AWS IoT SiteWise リソース
リソース 作成オペレーション オペレーションの説明
アセットモデルまたはコンポーネントモデル CreateAssetModel DescribeAssetModel
アセット CreateAsset DescribeAsset
SiteWise Edge ゲートウェイ CreateGateway DescribeGateway
Portal CreatePortal DescribePortal
プロジェクト CreateProject DescribeProject
ダッシュボード CreateDashboard DescribeDashboard
アクセスポリシー CreateAccessPolicy DescribeAccessPolicy
時系列 BatchPutAssetPropertyValue DescribeTimeSeries

ではBatchPutAssetPropertyValue、アセットモデルとアセットを作成する AWS IoT SiteWise 前に、 に産業データを送信するようにデータソースを設定できます。 は、機器から raw データのストリームを受信するデータストリーム AWS IoT SiteWise を自動的に作成します。詳細については、「データインジェストの管理」を参照してください。

ビューで次のオペレーションを使用して、タグ付けをサポートしているリソースのタグを管理します。

  • TagResource - リソースにタグを追加するか、既存のタグの値を更新します。

  • ListTagsForResource - リソースのタグをリストします。

  • UntagResource - リソースからタグを削除します。

任意の時点でリソースにタグを追加または削除します。既存のタグキーの値を更新するには、同じキーと望ましい新しい値を持つ新しいタグをリソースに追加します。このアクションにより、古い値が新しい値に置き換えられます。空の文字列をタグ値として割り当てることはできますが、null 値を割り当てることはできません。

リソースを削除すると、リソースにリンクされたタグも削除されます。