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

# でアセットモデルのアセットを作成する AWS IoT SiteWise
<a name="create-assets"></a>

アセットモデルからアセットを作成できます。アセットを作成する前に、アセットモデルが必要です。アセットモデルを作成していない場合は、「[でアセットモデルを作成する AWS IoT SiteWise](create-asset-models.md)」を参照してください。

**注記**  
アセットは `ACTIVE` モデルからのみ作成できます。モデルの状態が `ACTIVE` でない場合は、そのモデルからアセットを作成できるようになるまで数分待たなければならない場合があります。詳細については、「[アセットおよびモデルの状態](asset-and-model-states.md)」を参照してください。

**Topics**
+ [アセットを作成する (コンソール)](#create-asset-console)
+ [アセットを作成する (AWS CLI)](#create-asset-cli)
+ [新しいアセットを設定する](create-asset-next-steps.md)

## アセットを作成する (コンソール)
<a name="create-asset-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>ナビゲーションペインで [**Assets (アセット) **] を選択します。

1. [**Create asset (アセットの作成) **] を選択します。

1. [**アセットの作成**] ページで、次の操作を実行します。

   1. [**モデル**] で、アセットを作成するアセットモデルを選択します。
**注記**  
モデルが [**アクティブ**] でない場合は、アクティブになるまで待つか、[**FAILED (失敗) **] の場合は問題を解決する必要があります。

   1. アセットの [**名前**] を入力します。

   1. (オプション) アセットにタグを追加します。詳細については、「[AWS IoT SiteWise リソースにタグを付ける](tag-resources.md)」を参照してください。

   1. [**Create asset (アセットの作成) **] を選択します。

   アセットを作成すると、 AWS IoT SiteWise コンソールは新しいアセットのページに移動します。このページでは、アセットの [**ステータス**] が表示されます。このステータスは、最初は [**作成中**] です。このページは自動的に更新されるため、アセットのステータスが更新されるまで待つことができます。
**注記**  
アセットの作成プロセスには、最大で 1 分かかる場合があります。**[Status]** (状態) が **[ACTIVE]** (アクティブ) になったら、アセットに対して更新オペレーションを実行できます。詳細については、「[アセットおよびモデルの状態](asset-and-model-states.md)」を参照してください。

アセットを作成したら、「[新しいアセットを設定する](create-asset-next-steps.md)」を参照してください。

## アセットを作成する (AWS CLI)
<a name="create-asset-cli"></a>

 AWS Command Line Interface (AWS CLI) を使用して、アセットモデルからアセットを作成できます。

アセットを作成するには `assetModelId` が必要です。アセットモデルを作成したが、その `assetModelId` が不明な場合は、[ListAssetModels](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssetModels.html) API を使用して、すべてのアセットモデルを表示できます。

アセットモデルからアセットを作成するには、以下のパラメータを指定して [CreateAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAsset.html) API を使用します。
+ `assetName` - 新しいアセットの名前。アセットを識別するのに役立つ名前をアセットに付けます。
+ `assetModelId` – アセットの ID。これは UUID 形式の実際の ID です。または、ある場合は `externalId:myExternalId` です。詳細については、AWS IoT SiteWise  ユーザーガイドの [外部 ID を持つリファレンスオブジェクト](object-ids.md#external-id-references)を参照してください。

**アセットを作成するには (AWS CLI)**
+ 次のコマンドを実行して、アセットを作成します。*asset-name* をアセットの名前に置き換え、*asset-model-id* をアセットモデルの ID または外部 ID に置き換えます。

  ```
  aws iotsitewise create-asset \
    --asset-name asset-name \
    --asset-model-id asset-model-id
  ```

  このオペレーションは、新しいアセットの詳細およびステータスを含むレスポンスを次の形式で返します。

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

  アセットの `state` は、アセットが作成されるまでは `CREATING` です。
**注記**  
アセットの作成プロセスには、最大で 1 分かかる場合があります。アセット状態をチェックするには、`assetId` パラメータにアセット ID を指定して [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) オペレーションを使用します。アセットの `state` が `ACTIVE` になったら、アセットに対して更新オペレーションを実行できます。詳細については、「[アセットおよびモデルの状態](asset-and-model-states.md)」を参照してください。

アセットを作成したら、「[新しいアセットを設定する](create-asset-next-steps.md)」を参照してください。