AWS IoT Jobs SDK release 使用 的範例 AWS CLI - AWS Command Line Interface
動作

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

AWS IoT Jobs SDK release 使用 的範例 AWS CLI

下列程式碼範例示範如何搭配 AWS Command Line Interface 使用 來執行動作和實作常見案例 AWS IoT Jobs SDK release。

Actions 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會示範如何呼叫個別服務函數，但您可以在相關案例中查看內容中的動作。

每個範例都包含完整原始程式碼的連結，您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例示範如何使用 describe-job-execution。

AWS CLI

取得任務執行的詳細資訊

下列describe-job-execution範例會擷取指定任務和物件的最新執行詳細資訊。

aws iot-jobs-data describe-job-execution \
    --job-id SampleJob \
    --thing-name MotionSensor1 \
    --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com

輸出：

{
    "execution": {
        "approximateSecondsBeforeTimedOut": 88,
        "executionNumber": 2939653338,
        "jobId": "SampleJob",
        "lastUpdatedAt": 1567701875.743,
        "queuedAt": 1567701902.444,
        "status": "QUEUED",
        "thingName": "MotionSensor1 ",
        "versionNumber": 3
   }
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的裝置和任務。

下列程式碼範例示範如何使用 get-pending-job-executions。

AWS CLI

若要取得物件未處於終端機狀態的所有任務清單

下列get-pending-job-executions範例顯示指定物件未處於終端機狀態的所有任務清單。

aws iot-jobs-data get-pending-job-executions \
    --thing-name MotionSensor1
    --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com

輸出：

{
    "inProgressJobs": [
    ],
    "queuedJobs": [
        {
            "executionNumber": 2939653338,
            "jobId": "SampleJob",
            "lastUpdatedAt": 1567701875.743,
            "queuedAt": 1567701902.444,
            "versionNumber": 3
      }
    ]
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的裝置和任務。

下列程式碼範例示範如何使用 start-next-pending-job-execution。

AWS CLI

取得並啟動物件的下一個待執行任務

下列start-next-pending-job-execution範例會擷取並啟動下一個任務執行，其狀態為 IN_PROGRESS 或QUEUED指定物件。

aws iot-jobs-data start-next-pending-job-execution \
    --thing-name MotionSensor1
    --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com

輸出：

{
    "execution": {
        "approximateSecondsBeforeTimedOut": 88,
        "executionNumber": 2939653338,
        "jobId": "SampleJob",
        "lastUpdatedAt": 1567714853.743,
        "queuedAt": 1567701902.444,
        "startedAt": 1567714871.690,
        "status": "IN_PROGRESS",
        "thingName": "MotionSensor1 ",
        "versionNumber": 3
   }
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的裝置和任務。

下列程式碼範例示範如何使用 update-job-execution。

AWS CLI

更新任務執行的狀態

下列update-job-execution範例會更新指定任務和物件的狀態。

aws iot-jobs-data update-job-execution \
    --job-id SampleJob \
    --thing-name MotionSensor1 \
    --status REMOVED \
    --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com

輸出：

{
    "executionState": {
        "status": "REMOVED",
        "versionNumber": 3
    },
}

如需詳細資訊，請參閱 AWS IoT 開發人員指南中的裝置和任務。