# AWS IoT ジョブ SDK リリース examples using AWS CLI
<a name="cli_iot-jobs-data-plane_code_examples"></a>

次のコード例では、AWS IoT ジョブ SDK リリース で AWS Command Line Interface を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。

**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)」を参照してください。