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

# アセットモデルのバージョン
<a name="model-active-version"></a>

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

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

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

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

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

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

 デフォルトでは、アセットモデルまたはコンポーネントモデルで describe API が呼び出されると、モデルの最新バージョンの詳細が返されます。アセットモデルまたはコンポーネントモデルのアクティブバージョンが必要なシナリオがあります。以下のシナリオの例を参照してください。
+  定義が無効な更新オペレーションでは、アセットモデルは `FAILED` 状態になります。アセットモデルのアクティブバージョンを取得し、この有効な定義を参照する別の更新リクエストを作成することで、変更を元に戻す必要があります。
+  のアプリケーションは、顧客がアセットとそれに対応するアセットモデルを表示できる場所 AWS IoT SiteWise にあります。ユーザーが特定のアセットに対応するアセットモデル定義を参照し、アセットモデルが一時的な `UPDATING`、`PROPAGATING`、または `FAILED` 状態の場合、最新バージョンはアセットにまだ伝播されていないアセットモデル定義を返します。この場合、顧客にアセットモデルのアクティブバージョンを取得する必要があります。

**Topics**
+ [アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得する (コンソール)](#active-console)
+ [アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得する (AWS CLI)](#active-cli)

## アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得する (コンソール)
<a name="active-console"></a>

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

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

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

1. <a name="sitewise-open-console"></a>[AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。

1. <a name="sitewise-choose-models"></a>ナビゲーションペインで、[**モデル**] を選択します。

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

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

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

## アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得する (AWS CLI)
<a name="active-cli"></a>

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

アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得するには、 `assetModelVersion` パラメータを指定して [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html) オペレーションを使用します。

**ヒント**  
は、コンポーネントモデルをアセットモデルのタイプとして AWS CLI 定義します。したがって、両方のタイプのモデルに同じ [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html) オペレーションを使用します。レスポンスの `assetModelType` フィールドは、それが `ASSET_MODEL` か `COMPONENT_MODEL` かを示します。

**アセットモデルまたはコンポーネントモデルのアクティブバージョンを取得するには (AWS CLI)**
+ 次のコマンドを実行して、モデルを記述します。{{asset-model-id}} をアセットモデルまたはコンポーネントモデルの ID または外部 ID に置き換えます。外部 ID はユーザー定義 ID です。詳細については、AWS IoT SiteWise  ユーザーガイドの [外部 ID を持つリファレンスオブジェクト](object-ids.md#external-id-references)を参照してください。

  ```
  aws iotsitewise describe-asset-model --asset-model-id {{asset-model-id}} --asset-model-version ACTIVE
  ```

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

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