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

# フリートのインデックス作成の管理
<a name="managing-fleet-index"></a>

フリートインデックス作成では、モノのインデックス作成およびモノのグループのインデックス作成の 2 種類のインデックスを管理できます。

## モノのインデックス作成
<a name="thing-index"></a>

すべてのモノに対して作成されるインデックスは `AWS_Things` と呼ばれます。モノのインデックス作成では、次のデータソースがサポートされています。[AWS IoT レジストリ](thing-registry.md)データ、[AWS IoT デバイスシャドウ](iot-device-shadows.md)データ、[AWS IoT 接続性](life-cycle-events.md)データ、[AWS IoT Device Defender](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/what-is-device-defender.html) 違反データ。これらのデータソースをフリートのインデックス作成設定に追加することで、モノの検索、集計データのクエリを行い、検索クエリに基づく動的なモノのグループとフリートメトリクスを作成できます。

**レジストリ** - モノの管理に役立つレジストリ AWS IoT を提供します。レジストリデータをフリートのインデックス作成設定に追加して、モノの名前、説明、およびその他のレジストリ属性に基づいてデバイスを検索できます。レジストリの詳細については、「[レジストリによるモノの管理方法](thing-registry.md)」を参照してください。

**シャドウ** - [AWS IoT Device Shadow サービスは](iot-device-shadows.md)、デバイスの状態データの保存に役立つシャドウを提供します。モノのインデックス作成では、名前のないクラシックシャドウおよび名前付きシャドウの両方がサポートされています。名前付きシャドウのインデックスを作成するには、名前付きシャドウの設定を有効にし、モノのインデックス作成設定でシャドウ名を指定します。デフォルトでは、1 つにつき最大 10 個のシャドウ名を追加できます AWS アカウント。シャドウ名数の上限を増やす方法については、「AWS 全般のリファレンス」の「[AWS IoT Device Management クォータ](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits)」を参照してください。

インデックス作成のために名前付きシャドウを追加するには:
+ [AWS IoT コンソール](https://console.aws.amazon.com/iot/home)を使用する場合、**[Thing indexing]** (モノのインデックス作成) を有効化し、**[Add named shadows]** (名前付きシャドウの追加) を選択して、**[Named shadow selection]** (名前付きシャドウの選択) からシャドウの名前を追加します。
+  AWS Command Line Interface (AWS CLI) を使用する場合は、 `namedShadowIndexingMode` を に設定し`ON`、 でシャドウ名を指定します[`IndexingFilter`](https://docs.aws.amazon.com/iot/latest/apireference/API_IndexingFilter.html)。CLI コマンドの例については、[「モノのインデックス作成の管理](managing-index.md#enable-index)」を参照してください。

 シャドウの詳細については、「[AWS IoT Device Shadow サービス](iot-device-shadows.md)」を参照してください。

**接続** - デバイス接続データは、デバイスの接続ステータスを識別するのに役立ちます。この接続性に関するデータは、[ライフサイクルイベント](life-cycle-events.md)によって扱われます。クライアントが接続または切断すると、 は MQTT トピックにメッセージを含むライフサイクルイベント AWS IoT を発行します。接続または切断メッセージは、クライアント ID、キープアライブ期間、クリーンセッションフラグ、セッションの有効期限など、接続ステータスの詳細を提供する JSON 要素のリストです。デバイスの接続性についての詳細は、「[ライフサイクルイベント](life-cycle-events.md)」を参照してください。

**Device Defender 違反** - AWS IoT Device Defender 違反データは、セキュリティプロファイルで定義した通常の動作と照らし合わせて、異常なデバイス動作を特定するのに役立ちます。Security Profile には、予想される一連のデバイスの動作が含まれています。各動作では、デバイスにおける通常の動作を指定するメトリクスを使用します。Device Defender 違反の詳細については、「[AWS IoT Device Defender 検出](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/device-defender-detect.html)」を参照してください。

詳細については、「[モノのインデックス作成の管理](managing-index.md)」を参照してください。

## モノのグループのインデックス作成
<a name="thing-group-index"></a>

`AWS_ThingGroups` は、すべてのモノのグループが含まれるインデックスです。このインデックスを使用して、グループ名、説明、属性、すべての親グループ名に基づいてグループを検索することができます。

詳細については、「[モノのグループのインデックス作成の管理](thinggroup-index.md)」を参照してください。

## 管理対象フィールド
<a name="managed-field"></a>

マネージドフィールドには、モノ、モノのグループ、デバイスシャドウ、デバイス接続、Device Defender 違反に関連するデータが含まれます。 は、マネージドフィールドのデータ型 AWS IoT を定義します。 AWS IoT モノを作成するときに、各マネージドフィールドの値を指定します。例えば、モノの名前、モノのグループ、モノの説明はすべて管理対象フィールドです。フリートインデックス作成では、指定したインデックス作成モードに基づいて、管理対象フィールドがインデックス化されます。`customFields` では、管理対象フィールドを変更したり表示することはできません。詳細については、「[Custom fields](#custom-field)」を参照してください。

モノのインデックス作成の管理対象フィールドを次に示します。
+ レジストリの管理対象フィールド

  ```
  "managedFields" : [
    {name:thingId, type:String},
    {name:thingName, type:String},
    {name:registry.version, type:Number},
    {name:registry.thingTypeName, type:String},
    {name:registry.thingGroupNames, type:String},
  ]
  ```
+ 名前のないクラシックシャドウの管理対象フィールド

  ```
  "managedFields" : [
    {name:shadow.version, type:Number},
    {name:shadow.hasDelta, type:Boolean}
  ]
  ```
+ 名前付きシャドウの管理対象フィールド

  ```
  "managedFields" : [
    {name:shadow.name.shadowName.version, type:Number},
    {name:shadow.name.shadowName.hasDelta, type:Boolean}
  ]
  ```
+ モノの接続性の管理対象フィールド

  ```
  "managedFields" : [
    {name:connectivity.timestamp, type:Number},
    {name:connectivity.version, type:Number},
    {name:connectivity.connected, type:Boolean},
    {name:connectivity.disconnectReason, type:String},
    {name:connectivity.clientId, type:String},
    {name:connectivity.keepAliveDuration, type:Number},
    {name:connectivity.cleanSession, type:Boolean},
    {name:connectivity.sessionExpiry, type:Number}
  ]
  ```
+ Device Defender の管理フィールド

  ```
  "managedFields" : [
    {name:deviceDefender.violationCount, type:Number},
    {name:deviceDefender.securityprofile.behaviorname.metricName, type:String},
    {name:deviceDefender.securityprofile.behaviorname.lastViolationTime, type:Number},
    {name:deviceDefender.securityprofile.behaviorname.lastViolationValue, type:String},
    {name:deviceDefender.securityprofile.behaviorname.inViolation, type:Boolean}
  ]
  ```
+ モノのグループの管理対象フィールド

  ```
  "managedFields" : [
    {name:description, type:String},
    {name:parentGroupNames, type:String},
    {name:thingGroupId, type:String},
    {name:thingGroupName, type:String},
    {name:version, type:Number},
  ]
  ```

次の表は、検索できない管理フィールドです。


| データソース | 検索できない管理フィールド | 
| --- | --- | 
| レジストリ | registry.version | 
| 名前のないシャドウ | shadow.version | 
| 名前付きシャドウ | shadow.name.\*.version | 
| Device Defender | deviceDefender.version | 
| モノのグループ | version | 

## カスタムフィールド
<a name="custom-field"></a>

モノの属性、Device Shadow データ、Device Defender 違反のデータを集計するには、カスタムフィールドを作成してそれらをインデックス化します。`customFields` 属性は、フィールド名とデータ型のペアのリストです。データ型に基づいて、集計クエリを実行できます。選択するインデックス作成モードは、`customFields` で指定できるフィールドに影響します。例えば、`REGISTRY` インデックス作成モードを指定した場合、Thing Shadow からカスタムフィールドを指定することはできません。[update-indexing-configuration](https://docs.aws.amazon.com/cli/latest/reference/iot/update-indexing-configuration.html) CLI コマンドを使用して、カスタムフィールドを作成または更新できます ([Updating indexing configuration examples](managing-index.md#update-index-examples) のコマンド例を参照してください)。

**カスタムフィールド名**

モノおよび モノのグループ属性のカスタムフィールド名は `attributes.` で始まり、属性名が続きます。名前のないシャドウのインデックス作成がオンの場合、モノのカスタムフィールド名は `shadow.desired` または `shadow.reported` で始まり、名前のないシャドウデータの値名が続きます。名前付きシャドウのインデックス作成がオンの場合、モノのカスタムフィールド名は `shadow.name.*.desired.` または `shadow.name.*.reported.` で始まり、名前付きシャドウデータの値が続きます。Device Defender 違反のインデックス作成がオンの場合、モノのカスタムフィールド名は `deviceDefender.` で始まり、Device Defender 違反のデータの値が続きます。

プレフィックスに続く属性名またはデータの値名には、英数字、— (ハイフン)、\_ (アンダースコア) のみを使用できます。スペースを含めることはできません。

設定内のカスタムフィールドとインデックス化される値のタイプに不整合がある場合、フリートインデックス作成では集計クエリの不整合値が無視されます。CloudWatch ログは、集約クエリの問題のトラブルシューティングに役立ちます。詳細については、「[フリートインデックス作成サービスの集計クエリのトラブルシューティング](fleet-indexing-troubleshooting.md#aggregation-troubleshooting)」を参照してください。

**カスタムフィールドの型**

カスタムフィールドのタイプには、次の値がサポートされています: `Number`、`String`、`Boolean`