

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

# AWS IoT FleetWise シグナルカタログを更新する
<a name="update-signal-catalog"></a>

既存のシグナルカタログを更新するには、[UpdateSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateSignalCatalog.html) API オペレーションを使用します。次の例では、 を使用します AWS CLI。

既存のシグナルカタログを更新するには、次のコマンドを実行します。

*signal-catalog-configuration* を、設定を含む .json ファイルの名前に置き換えます。

```
aws iotfleetwise update-signal-catalog --cli-input-json file://signal-catalog-configuration.json
```

## シグナルカタログの構成
<a name="update-signal-catalog-configuration"></a>

*signal-catalog-name* は、更新するシグナルカタログの名前に置き換えます。

ブランチ、属性、センサー、アクチュエータの構成方法の詳細については、「[Configure AWS IoT FleetWise シグナル](define-signal.md)」を参照してください。

**重要**  
カスタム構造はイミュータブルです。既存のカスタム構造 (構造体) にプロパティの順序を変更または挿入する必要がある場合は、構造を削除し、目的のプロパティの順序でまったく新しい構造を作成します。  
カスタム構造を削除するには、構造の完全修飾名を `nodesToRemove` に追加します。シグナルが参照している構造は、削除できません。構造を参照するシグナル (そのデータ型はターゲット構造として定義されます) は、シグナルカタログの更新リクエストの前に、更新または削除する必要があります。

```
{
    	"name": "signal-catalog-name",
    	"nodesToAdd": [{
    			"branch": {
    				"description": "Front left of vehicle specific data.",
    				"fullyQualifiedName": "Vehicle.Front.Left"
    			}
    		},
    		{
    			"branch": {
    				"description": "Door-specific data for the front left of vehicle.",
    				"fullyQualifiedName": "Vehicle.Front.Left.Door"
    			}
    		},
    		{
    			"actuator": {
    				"fullyQualifiedName": "Vehicle.Front.Left.Door.Lock",
    				"description": "Whether the front left door is locked.",
    				"dataType": "BOOLEAN"
    			}
    		},
    		{
    			"branch": {
    				"fullyQualifiedName": "Vehicle.Camera"
    			}
    		},
    		{
    			"struct": {
    				"fullyQualifiedName": "Vehicle.Camera.SVMCamera"
    			}
    		},
    		{
    			"property": {
    				"fullyQualifiedName": "Vehicle.Camera.SVMCamera.ISO",
    				"dataType": "STRING"
    			}
    		}
    	],
    	"nodesToRemove": ["Vehicle.Chassis.SteeringWheel.HandsOffSteeringState"],
    	"nodesToUpdate": [{
    		"attribute": {
    			"dataType": "FLOAT",
    			"fullyQualifiedName": "Vehicle.Chassis.SteeringWheel.Diameter",
    			"max": 55
    		}
    	}]
    }
```

カスタマーマネージド AWS KMS キーを使用して[暗号化を有効に](key-management.md)した場合は、ロールが `UpdateSignalCatalog` API オペレーションを呼び出すことができるように、次のポリシーステートメントを含めます。

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kms:GenerateDataKey*",
                "kms:Decrypt"
            ],
            "Resource": [
                "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
            ]
        }
    ]
}
```

------

## シグナルカタログの更新を確認する
<a name="verify-catalog-update"></a>

[ListSignalCatalogNodes](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListSignalCatalogNodes.html) API オペレーションを使用して、シグナルカタログが更新されたかどうかを確認できます。次の例では、 を使用します AWS CLI。

特定のシグナルカタログに含まれているすべてのシグナル (ノード) の概要をページ分割されたリストとして取得するには、次のコマンドを実行します。

*signal-catalog-name* は、確認するシグナルカタログの名前に置き換えます。

```
aws iotfleetwise list-signal-catalog-nodes --name signal-catalog-name
```

カスタマーマネージド AWS KMS キーを使用して[暗号化を有効に](key-management.md)した場合は、ロールが `ListSignalCatalogNodes` API オペレーションを呼び出すことができるように、次のポリシーステートメントを含めます。

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kms:Decrypt"
            ],
            "Resource": [
                "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
            ]
        }
    ]
}
```

------