# AWS CLI를 사용한 AWS IoT data 예시
<a name="cli_iot-data-plane_code_examples"></a>

다음 코드 예시는 AWS IoT data와 함께 AWS Command Line Interface를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.

**Topics**
+ [작업](#actions)

## 작업
<a name="actions"></a>

### `delete-thing-shadow`
<a name="iot-data-plane_DeleteThingShadow_cli_topic"></a>

다음 코드 예시에서는 `delete-thing-shadow`의 사용 방법을 보여줍니다.

**AWS CLI**  
**디바이스의 섀도우 문서 삭제**  
다음 `delete-thing-shadow` 예시에서는 `MyRPi`라는 디바이스의 전체 섀도우 문서를 삭제합니다.  

```
aws iot-data delete-thing-shadow \
    --thing-name MyRPi \
    "output.txt"
```
이 명령은 디스플레이에 출력을 생성하지 않지만 삭제한 섀도우 문서의 버전과 타임스탬프를 확인하는 정보가 `output.txt`에 포함되어 있습니다.  

```
{"version":2,"timestamp":1560270384}
```
자세한 내용은 *AWS IoT 개발자 안내서*의 [섀도우 사용](https://docs.aws.amazon.com/iot/latest/developerguide/using-device-shadows.html)을 참조하세요.  
+  API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/delete-thing-shadow.html)를 참조하세요.

### `get-thing-shadow`
<a name="iot-data-plane_GetThingShadow_cli_topic"></a>

다음 코드 예시에서는 `get-thing-shadow`의 사용 방법을 보여줍니다.

**AWS CLI**  
**사물 섀도우 문서 가져오기**  
다음 `get-thing-shadow` 예시에서는 지정된 IoT 사물의 사물 섀도우 문서를 가져옵니다.  

```
aws iot-data get-thing-shadow \
    --thing-name MyRPi \
    output.txt
```
이 명령은 디스플레이에 출력을 생성하지 않지만, 다음은 `output.txt`의 내용을 보여줍니다.  

```
{
  "state":{
    "reported":{
    "moisture":"low"
    }
  },
  "metadata":{
    "reported":{
      "moisture":{
        "timestamp":1560269319
      }
    }
  },
  "version":1,"timestamp":1560269405
}
```
자세한 내용은 *AWS IoT 개발자 안내서*의 [디바이스 섀도우 서비스 데이터 흐름](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html)을 참조하세요.  
+  API 세부 정보는 *AWS CLI 명령 참조*의 [GetThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/get-thing-shadow.html)를 참조하세요.

### `update-thing-shadow`
<a name="iot-data-plane_UpdateThingShadow_cli_topic"></a>

다음 코드 예시에서는 `update-thing-shadow`의 사용 방법을 보여줍니다.

**AWS CLI**  
**사물 섀도우 업데이트**  
다음 `update-thing-shadow` 예시에서는 지정된 사물의 현재 디바이스 섀도우 상태를 수정하고 파일 `output.txt`에 저장합니다.  

```
aws iot-data update-thing-shadow \
    --thing-name MyRPi \
    --payload "{"state":{"reported":{"moisture":"okay"}}}" \
    "output.txt"
```
이 명령은 디스플레이에 출력을 생성하지 않지만, 다음은 `output.txt`의 내용을 보여줍니다.  

```
{
    "state": {
        "reported": {
            "moisture": "okay"
        }
    },
    "metadata": {
        "reported": {
            "moisture": {
                "timestamp": 1560270036
            }
        }
    },
    "version": 2,
    "timestamp": 1560270036
}
```
자세한 내용은 *AWS IoT 개발자 안내서*의 [디바이스 섀도우 서비스 데이터 흐름](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-data-flow.html)을 참조하세요.  
+  API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateThingShadow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/update-thing-shadow.html)를 참조하세요.