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

# 使用 AWS IoT 任務上傳資料
<a name="update-campaign-cli-data-partitions-jobs"></a>

**重要**  
對特定 AWS IoT FleetWise 功能的存取目前受到鎖定。如需詳細資訊，請參閱[AWS AWS IoT FleetWise 中的區域和功能可用性](fleetwise-regions.md)。

使用 AWS IoT 任務，您可以設定行銷活動，在需要時將存放的車輛資料上傳至雲端。

**為您的行銷活動建立任務文件**
+ 使用下列範例來建立行銷活動的任務文件。任務文件是 .json 檔案，其中包含執行任務所需的車輛或機群資訊。如需建立任務文件的詳細資訊，請參閱《 *AWS IoT 開發人員指南*》中的[使用 建立和管理任務 AWS CLI](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)。

  若要請求只有一輛車上傳資料，請將任務目標設定為與車輛相關聯的 AWS IoT 物件。若要請求多個車輛 （在同一行銷活動中） 上傳資料，請建立與車輛對應之所有物件的物件群組，然後將任務目標設定為物件群組。

  ```
  {
    "version": "1.0",
    "parameters": {
       "campaignArn": ${aws:iot:parameter:campaignArn},
       "endTime": ${aws:iot:parameter:endTime}
    }
  }
  ```

  1. `CampaignArn` 將 取代為相同區域和帳戶中行銷活動的 Amazon Resource Name (ARN)。需要行銷活動 ARN。

  1. （選用） `endTime`以 ISO 8601 UTC 格式 （無毫秒） 的車輛收集資料的時間戳記取代 。例如 `2024-03-05T23:00:00Z`。時間戳記為專屬，並決定要上傳的最後一個資料點。如果您省略 `endTime`，則 Edge Agent 軟體會繼續上傳，直到上傳所有行銷活動的儲存資料為止。上傳所有資料後，它會將[任務執行狀態](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-job-execution-states)更新為 `SUCCEEDED`。任務[的狀態](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-jobs-states)會更新為 `COMPLETED`。

**使用受管任務範本建立任務**

1. 從受管範本清單中選擇 **IoT-IoTFleetWise-CollectCampaignData**。如需詳細資訊，請參閱《 *AWS IoT 開發人員指南*》中的[從 AWS 受管範本建立任務](https://docs.aws.amazon.com/iot/latest/developerguide/job-template-manage-console-create.html)。

1. 受管範本具有 `CampaignArn`和 `endTime` 參數。

   1. `CampaignArn` 將 取代為相同區域和帳戶中行銷活動的 Amazon Resource Name (ARN)。需要行銷活動 ARN。

   1. （選用） `endTime`以 ISO 8601 UTC 格式 （無毫秒） 的車輛收集資料的時間戳記取代 。例如 `2024-03-05T23:00:00Z`。時間戳記為專屬，並決定要上傳的最後一個資料點。如果您省略 `endTime`，則 Edge Agent 軟體會繼續上傳，直到上傳所有行銷活動的儲存資料為止。上傳所有資料後，它會將[任務執行狀態](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-job-execution-states)更新為 `SUCCEEDED`。任務[的狀態](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-jobs-states)會更新為 `COMPLETED`。

如需相關故障診斷主題，請參閱 [存放和轉送問題](troubleshooting-campaign.md)。

如需 AWS IoT 任務的詳細資訊，請參閱《 *AWS IoT 開發人員指南*》中的 [任務](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs.html)。