本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 资产和模型状态
<a name="asset-and-model-states"></a>

创建、更新或删除资产、资产模型或组件模型时，更改需要一段时间才能传播。 AWS IoT SiteWise 异步解析这些操作并更新每个资源的状态。每个资产、资产模型和组件模型都有一个状态字段，包含资源状态和任何错误消息（如适用）。状态可以是以下值之一：
+ `ACTIVE` — 资源处于活动状态。这是唯一状态，您可以在其中查询资产、资产模型和组件模型并与之交互。
+ `CREATING` — 正在创建资源。
+ `UPDATING` — 正在更新资源。
+ `DELETING` — 正在删除资源。
+ `PROPAGATING` —（仅限资产模型和组件模型）更改将传播到所有依赖资源（从资产模型传播到资产，或从组件模型传播到资产模型）。
+ `FAILED` — 资源在创建或更新操作期间无法验证，可能是由于表达式中的循环引用。您可以删除处于 `FAILED` 状态的资源。

一些创建、更新和删除操作`ACTIVE`会将资产、资产模型或组件模型 AWS IoT SiteWise 置于操作解析之外的状态。如要在执行其中一项操作后查询资源或与之进行交互，必须等到状态更改为 `ACTIVE`。否则，您的请求将失败。

**Topics**
+ [检查资产的状态](check-asset-status.md)
+ [检查资产或组件模型的状态](check-model-status.md)

# 检查资产的状态
<a name="check-asset-status"></a>

您可以使用 AWS IoT SiteWise 控制台或 API 来检查资产的状态。

**Topics**
+ [检查资产的状态（控制台）](#check-asset-status-console)
+ [检查资产的状态（AWS CLI）](#check-asset-status-cli)

## 检查资产的状态（控制台）
<a name="check-asset-status-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-assets"></a>在导航窗格中，选择**资产**。

1. 选择要检查的资产。
**提示**  <a name="sitewise-expand-asset-hierarchy"></a>
您可以选择箭头图标来展开资产层次结构以查找资产。

1. 在 **资源详细信息**面板中查找 **状态**。  
![\[AWS IoT SiteWise 资产详细信息面板，状态为激活。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/sitewise-view-asset-status-console.png)

## 检查资产的状态（AWS CLI）
<a name="check-asset-status-cli"></a>

您可以使用 AWS Command Line Interface (AWS CLI) 来检查资产的状态。

要检查资产的状态，请使用带`assetId`参数的[DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)操作。

**要检查资产的状态（AWS CLI），请执行以下步骤：**
+ 运行以下命令以描述资产。*asset-id*替换为资产的 ID 或外部 ID。外部 ID 是用户定义的 ID。有关更多信息，请参阅《AWS IoT SiteWise 用户指南》**中的 [使用外部引用对象 IDs](object-ids.md#external-id-references)。

  ```
  aws iotsitewise describe-asset --asset-id asset-id
  ```

  此操作将返回包含资产详细信息的响应。响应中包含具有以下结构的 `assetStatus` 对象：

  ```
  {
      ...
      "assetStatus": {
        "state": "String",
        "error": {
           "code": "String",
           "message": "String"
        }
      }
    }
  ```

  资产的状态位于 JSON 对象的 `assetStatus.state` 中。

# 检查资产或组件模型的状态
<a name="check-model-status"></a>

您可以使用 AWS IoT SiteWise 控制台或 API 来检查资产模型或组件模型的状态。

**Topics**
+ [检查资产模型或组件模型的状态（控制台）](#check-model-status-console)
+ [检查资产模型或组件模型的状态（AWS CLI）](#check-model-status-cli)

## 检查资产模型或组件模型的状态（控制台）
<a name="check-model-status-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. 在**详细信息**面板中查找**状态**。  
![\[AWS IoT SiteWise “资产模型” 页面屏幕截图，突出显示了资产模型的状态。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/sitewise-view-model-status-console.png)

## 检查资产模型或组件模型的状态（AWS CLI）
<a name="check-model-status-cli"></a>

您可以使用 AWS CLI 来检查资产模型或组件模型的状态。

要检查资产模型或组件模型的状态，请使用带`assetModelId`参数的[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 用户指南》**中的 [使用外部引用对象 IDs](object-ids.md#external-id-references)。

  ```
  aws iotsitewise describe-asset-model --asset-model-id asset-model-id
  ```

  此操作将返回包含模型详细信息的响应。响应中包含具有以下结构的 `assetModelStatus` 对象。

  ```
  {
      ...
      "assetModelStatus": {
        "state": "String",
        "error": {
           "code": "String",
           "message": "String"
        }
      }
    }
  ```

  模型的状态位于 JSON 对象的 `assetModelStatus.state` 中。