Mettre à jour un catalogue FleetWise de signaux AWS IoT

Vous pouvez utiliser cette UpdateSignalCatalogAPIopération pour mettre à jour un catalogue de signaux existant. L'exemple suivant utilise AWS CLI.

Pour mettre à jour un catalogue de signaux existant, exécutez la commande suivante.

Remplacez signal-catalog-configuration avec le nom du fichier .json qui contient la configuration.

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

Configuration du catalogue de signaux

Remplacez signal-catalog-name avec le nom du catalogue de signaux que vous mettez à jour.

Pour plus d'informations sur la configuration des branches, des attributs, des capteurs et des actionneurs, consultezConfiguration AWS des FleetWise signaux IoT.

Important

Les structures personnalisées sont immuables. Si vous devez réorganiser ou insérer des propriétés dans une structure personnalisée existante (structure), supprimez la structure et créez une toute nouvelle structure avec l'ordre de propriétés souhaité.

Pour supprimer une structure personnalisée, ajoutez le nom complet de la structurenodesToRemove. Une structure ne peut pas être supprimée si elle est référencée par des signaux. Tous les signaux faisant référence à la structure (leur type de données est défini comme étant la structure cible) doivent être mis à jour ou supprimés avant la demande de mise à jour du catalogue de signaux.

{
    	"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
    		}
    	}]
    }

Si vous avez activé le chiffrement à l'aide d'une AWS KMS clé gérée par le client, incluez la déclaration de politique suivante afin que votre rôle puisse invoquer l'UpdateSignalCatalogAPIopération.

{
  "Version": "2012-10-17",
  "Statement": [
{
      "Effect": "Allow",
      "Action": [
        "kms:GenerateDataKey*",
        "kms:Decrypt"
      ],
      "Resource": [
        "arn:aws:kms:KMS_KEY_REGION:KMS_KEY_ACCOUNT_ID:key/KMS_KEY_ID"
      ]
    },
  ]
}

Vérifier la mise à jour du catalogue de signaux

Vous pouvez utiliser cette ListSignalCatalogNodesAPIopération pour vérifier si un catalogue de signaux a été mis à jour. L'exemple suivant utilise AWS CLI.

Pour récupérer une liste paginée de résumés de tous les signaux (nœuds) d'un catalogue de signaux donné, exécutez la commande suivante.

Remplacez signal-catalog-name avec le nom du catalogue de signaux que vous êtes en train de vérifier.

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

Si vous avez activé le chiffrement à l'aide d'une AWS KMS clé gérée par le client, incluez la déclaration de politique suivante afin que votre rôle puisse invoquer l'ListSignalCatalogNodesAPIopération.

{
  "Version": "2012-10-17",
  "Statement": [

    {
      "Effect": "Allow",
      "Action": [
        "kms:Decrypt"
      ],
      "Resource": [
        "arn:aws:kms:KMS_KEY_REGION:KMS_KEY_ACCOUNT_ID:key/KMS_KEY_ID"
      ]
    },
  ]
}