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

# AWS IoT Jobs SDK 發布 使用 的範例 AWS CLI
<a name="cli_iot-jobs-data-plane_code_examples"></a>

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

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

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

**Topics**
+ [動作](#actions)

## 動作
<a name="actions"></a>

### `describe-job-execution`
<a name="iot-jobs-data-plane_DescribeJobExecution_cli_topic"></a>

以下程式碼範例顯示如何使用 `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 開發人員指南》**中的[裝置和任務](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/describe-job-execution.html)。

### `get-pending-job-executions`
<a name="iot-jobs-data-plane_GetPendingJobExecutions_cli_topic"></a>

以下程式碼範例顯示如何使用 `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 開發人員指南》**中的[裝置和任務](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetPendingJobExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/get-pending-job-executions.html)。

### `start-next-pending-job-execution`
<a name="iot-jobs-data-plane_StartNextPendingJobExecution_cli_topic"></a>

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

**AWS CLI**  
**取得與開始物件的下一個待定任務執行**  
下列 `start-next-pending-job-execution` 範例會擷取與開始下一個任務執行，其狀態為指定物件的 IN\$1PROGRESS 或 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 開發人員指南》**中的[裝置和任務](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [StartNextPendingJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/start-next-pending-job-execution.html)。

### `update-job-execution`
<a name="iot-jobs-data-plane_UpdateJobExecution_cli_topic"></a>

以下程式碼範例顯示如何使用 `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 開發人員指南》**中的[裝置和任務](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/update-job-execution.html)。