アセットモデルのバージョン - AWS IoT SiteWise
アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得する (コンソール)アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得する (AWS CLI)

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

アセットモデルのバージョン

AWS IoT SiteWise は、アセットモデルとコンポーネントモデルの作成および更新オペレーションの非同期処理をサポートします。また、モデルのステータスも更新します。

AWS IoT SiteWise は、作成および更新リクエストにおける有効なモデルの変更を、依存リソース (アセットモデルからアセットへ、またはコンポーネントモデルからアセットモデルへ) に伝達します。次に、モデルを ACTIVE 状態にします。

指定されたモデル定義が無効である場合、 はモデルを FAILED状態 AWS IoT SiteWise に配置します。変更は依存リソースに伝播されません。依存リソースとは、モデルが ACTIVE 状態のときに伝播される最後のモデル定義を指します。

上記の情報に基づいて、モデル定義には 2 種類のモデルバージョンがあります。

  1. 最新バージョン – 作成または更新リクエストの一部として受け入れられる最新の定義。

  2. アクティブバージョン – 最新の定義が正常に処理され、モデルの状態は ACTIVE です。

デフォルトでは、アセットモデルまたはコンポーネントモデルで describe API が呼び出されると、モデルの最新バージョンの詳細が返されます。アセットモデルまたはコンポーネントモデルのアクティブバージョンが必要なシナリオがあります。以下のシナリオの例を参照してください。

  • 定義が無効な更新オペレーションでは、アセットモデルは FAILED 状態になります。アセットモデルのアクティブバージョンを取得し、この有効な定義を参照する別の更新リクエストを作成することで、変更を元に戻す必要があります。

  • のアプリケーションは、お客様がアセットとそれに対応するアセットモデルを表示できる場所 AWS IoT SiteWise にあります。ユーザーが特定のアセットに対応するアセットモデル定義を参照し、アセットモデルが一時的な UPDATING、PROPAGATING、または FAILED 状態の場合、最新バージョンはアセットにまだ伝播されていないアセットモデル定義を返します。この場合、顧客にアセットモデルのアクティブバージョンを取得する必要があります。

アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得する (コンソール)

AWS IoT SiteWise コンソールでアセットモデルまたはコンポーネントモデルのアクティブバージョンを取得するには、次の手順に従います。

ヒント

アセットモデルとコンポーネントモデルはどちらも、ナビゲーションペインの [モデル] に一覧表示されます。選択されたアセットモデルまたはコンポーネントモデルの [詳細] パネルには、そのタイプが表示されます。

アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得するには (コンソール)

  1. AWS IoT SiteWise コンソールに移動します。

  2. ナビゲーションペインで、[モデル] を選択します。

  3. アクティブバージョンを取得するモデルを選択します。

    1. モデルが ACTIVE 状態の場合、そのアクティブバージョンが表示されます。

    2. モデルが一時的な UPDATING、PROPAGATING、または FAILED 状態の場合、[詳細] パネルの [ステータス] にある [アクティブバージョンを表示] を見つけます。

アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得する (AWS CLI)

を使用して、アセットモデルまたはコンポーネントモデルのアクティブバージョン AWS CLI を取得します。

アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得するには、 assetModelVersion パラメータを指定して DescribeAssetModel オペレーションを使用します。

ヒント

は、コンポーネントモデルをアセットモデルの一種として AWS CLI 定義します。したがって、両方のタイプのモデルに同じ DescribeAssetModel オペレーションを使用します。レスポンスの assetModelType フィールドは、それが ASSET_MODEL か COMPONENT_MODEL かを示します。

アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得するには (AWS CLI)

  • 次のコマンドを実行して、モデルを記述します。asset-model-id をアセットモデルまたはコンポーネントモデルの ID または外部 ID に置き換えます。外部 ID はユーザー定義 ID です。詳細については、AWS IoT SiteWise  ユーザーガイドの 外部 ID を持つリファレンスオブジェクトを参照してください。

    aws iotsitewise describe-asset-model --asset-model-id asset-model-id --asset-model-version ACTIVE

    このオペレーションは、モデルの詳細を含むレスポンスを返します。レスポンスには、次の構造を持つ assetModelStatus オブジェクトが含まれています。

    {
    ...
    "assetModelName": "string",
    "assetModelProperties": [ ... ],
    ...,
    "assetModelVersion": "string"
}