更新 AWS IoT FleetWise Word 訊號目錄 - AWS IoT FleetWise
驗證訊號目錄更新

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

更新 AWS IoT FleetWise Word 訊號目錄

您可以使用 UpdateSignalCatalog API來更新現有的訊號目錄。下列範例使用 AWS CLI。

若要更新現有的訊號目錄，請執行下列命令。

Replace (取代) signal-catalog-configuration 包含組態的 .json 檔案名稱。

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

Replace (取代) signal-catalog-name 您更新之訊號目錄的名稱。

如需如何設定分支、屬性、感應器和致動器的詳細資訊，請參閱 設定 AWS IoT FleetWise Word 訊號。

重要

自訂結構是不可變的。如果您需要將屬性重新排序或插入現有自訂結構 （結構），請刪除結構，並以所需的屬性順序建立新的結構。

若要刪除自訂結構，請在 中新增結構的完整名稱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 金鑰啟用加密，請包含下列政策陳述式，讓您的角色可以叫用 API UpdateSignalCatalog 操作。

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

驗證訊號目錄更新

您可以使用 ListSignalCatalogNodes API來驗證訊號目錄是否已更新。下列範例使用 AWS CLI。

若要擷取指定訊號目錄中所有訊號 （節點） 的分頁清單，請執行下列命令。

Replace (取代) signal-catalog-name 您檢查的訊號目錄名稱。

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

如果您使用客戶受管 AWS KMS 金鑰啟用加密，請包含下列政策陳述式，讓您的角色可以叫用 API ListSignalCatalogNodes 操作。

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