创建 AWS 物联网 FleetWise 车辆 - AWS IoT FleetWise
创建车辆（控制台）创建车辆 (AWS CLI)

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

创建 AWS 物联网 FleetWise 车辆

重要

目前对某些 AWS 物联网 FleetWise 功能的访问受到限制。有关更多信息，请参阅 AWSAWS 物联网中的区域和功能可用性 FleetWise。

您可以使用 AWS 物联网 FleetWise 控制台或 API 来创建车辆。

重要

在开始之前，请检查以下事项：

创建车辆（控制台）

您可以使用 AWS 物联网 FleetWise 控制台创建车辆。

创建车辆

  1. 打开AWS 物联网 FleetWise 控制台。

  2. 在导航窗格中，选择车辆。

  3. 在车辆摘要页面上，选择创建车辆，然后执行以下步骤。

步骤 1：定义车辆属性

在此步骤中，您将为车辆命名并将其与模型清单和解码器清单相关联。

  1. 为车辆输入唯一名称。

    重要

    车辆对应于一 AWS IoT 件事物。如果已存在具有该名称的物品，请选择将车辆与 IoT 物品相关联以使用车辆更新该物品。或者，选择不同的车辆名称， AWS 物联网 FleetWise 将自动为车辆创建新事物。

  2. 从列表中选择车辆型号（模型清单）。

  3. 从列表中选择解码器清单。解码器清单与车辆型号关联。

  4. （可选）要关联车辆属性，请选择添加属性。如果您跳过此步骤，则必须在创建车辆后添加属性，然后才能将其部署到活动中。

  5. （可选）要将标签与车辆相关联，请选择添加新标签。您还可以在创建车辆后添加标签。

  6. 选择下一步。

步骤 2：配置车辆证书

要将您的车辆当作 AWS IoT 物品使用，您必须配置带有附加政策的车辆证书。如果您跳过此步骤，则必须在创建车辆后配置证书，然后才能将其部署到活动中。

  1. 选择自动生成新证书(推荐)。

  2. 选择下一步。

步骤 3：将策略附加到证书

将策略附加到您在上一步中配置的证书。

  1. 在策略中，请输入现有的策略名称。要创建新策略，请选择创建策略。

  2. 选择下一步。

步骤 4：审核并创建

验证车辆的配置，然后选择创建车辆。

重要

创建车辆后，您必须下载证书和密钥。您将使用证书和私钥在 Edge Agent for AWS IoT FleetWise 软件中连接车辆。

创建车辆 (AWS CLI)

创建车辆时，必须使用与解码器清单关联的车辆型号。您可以使用 CreateVehicleAPI 操作来创建车辆。下面的示例使用了 AWS CLI。

要创建车辆，请运行以下命令。

file-name替换为包含车辆配置的.json 文件的名称。

aws iotfleetwise create-vehicle --cli-input-json file://file-name.json
例 — 车辆配置

  • （可选）associationBehavior 可以是以下值之一：

    • CreateIotThing— 创建车辆后， AWS 物联网 FleetWise 会自动为您的车辆创建带有您的车辆 ID 名称 AWS IoT 的事物。

    • ValidateIotThingExists – 使用现有 AWS IoT 物品创建车辆。

      要创建 AWS IoT 事物，请运行以下命令。thing-name用要创建的事物的名称替换。

      aws iot create-thing --thing-name thing-name

    如果未指定， AWS IoT FleetWise 会自动为您的车辆创建 AWS IoT 物品。

    重要

    确保在车辆创建后配置该 AWS IoT 物品。有关更多信息，请参阅 配置 AWS 物联网 FleetWise 车辆。

  • vehicle-name替换为以下内容之一。

    • 您的 AWS IoT 事物的名称（如果配置associationBehavior为）ValidateIotThingExists。

    • 要创建的车辆的 ID（如果 associationBehavior 配置为 CreateIotThing）。

      车辆 ID 可以包含 1-100 个字符。有效字符：a—z、A—Z、0—9、短划线 (‐)、下划线 (_) 和冒号 (:)。

  • model-manifest-ARN替换为您的车辆型号（车型清单）的 ARN。

  • 替换为decoder-manifest-ARN与指定车辆型号关联的解码器清单的 ARN。

  • （可选）您可以添加其他属性，将此车辆与使用相同车辆型号创建的其他车辆区分开来。例如，如果您有一辆电动汽车，则可以为属性指定以下值：{"fuelType": "electric"}。

    重要

    必须先在关联的车辆型号中定义属性，然后才能将其添加到单个车辆中。

{
    "associationBehavior": "associationBehavior",
    "vehicleName": "vehicle-name", 
    "modelManifestArn": "model-manifest-ARN",
    "decoderManifestArn": "decoder-manifest-ARN",           
    "attributes": {
        "key": "value"
    }
}
例 — 将状态模板与车辆相关联

您可以使用stateTemplates字段将状态模板与车辆相关联，以允许在云端收集车辆的状态更新。

在此示例中，stateTemplateUpdateStrategy可以是以下之一：

  • periodic：允许您指定 Edge Agent 软件向云端发送信号更新的固定速率（即使信号值在两次更新之间没有变化，Edge Agent 软件也会发送更新）。

  • onChange: 只要信号发生变化，Edge Agent 软件就会发送信号更新。

aws iotfleetwise create-vehicle --cli-input-json file://create-vehicle.json

create-vehicle.json文件包含的位置（例如）：

{
    "associationBehavior": "associationBehavior",
    "vehicleName": "vehicle-name", 
    "modelManifestArn": "model-manifest-ARN",
    "decoderManifestArn": "decoder-manifest-ARN",           
    "attributes": {
        "key": "value"
    },
    "stateTemplates": [ 
        {
            "identifier": "state-template-name",
            "stateTemplateUpdateStrategy": {
                "periodic": {
                    "stateTemplateUpdateRate": {
                        "unit": "SECOND",
                        "value": 10
                    }
                }
            }
        }
    ]
}

如果您启用了使用客户托管 AWS KMS 密钥的加密，请包括以下政策声明，以便您的角色可以调用 CreateVehicle API 操作。

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