# AWS CLI를 사용한 MediaStore 데이터 플레인 예시
다음 코드 예시에서는 MediaStore 데이터 플레인과 함께 AWS Command Line Interface를 사용하여 일반적인 시나리오를 구현하고 개별 서비스 작업을 수행하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `delete-object`
다음 코드 예시에서는 `delete-object`의 사용 방법을 보여줍니다.
**AWS CLI**
**객체 삭제**
다음 `delete-object` 예시에서는 지정된 객체를 삭제합니다.
```
aws mediastore-data delete-object \
--endpoint=https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
--path=/folder_name/README.md
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS Elemental MediaStore 사용자 안내서*의 [객체 삭제](https://docs.aws.amazon.com/mediastore/latest/ug/objects-delete.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/delete-object.html)를 참조하세요.
### `describe-object`
다음 코드 예시에서는 `describe-object`의 사용 방법을 보여줍니다.
**AWS CLI**
**객체의 헤더 보기**
다음 `describe-object` 예시에서는 지정된 경로에 있는 객체의 헤더를 표시합니다.
```
aws mediastore-data describe-object \
--endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
--path events/baseball/setup.jpg
```
출력:
```
{
"LastModified": "Fri, 19 Jul 2019 21:50:31 GMT",
"ContentType": "image/jpeg",
"ContentLength": "3860266",
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3"
}
```
자세한 내용은 *AWS Elemental MediaStore 사용자 안내서*의 [객체 세부 정보 보기](https://docs.aws.amazon.com/mediastore/latest/ug/objects-view-details.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/describe-object.html)를 참조하세요.
### `get-object`
다음 코드 예시에서는 `get-object`의 사용 방법을 보여줍니다.
**AWS CLI**
**예시 1: 전체 객체 다운로드**
다음 `get-object` 예시에서는 지정된 객체를 다운로드합니다.
```
aws mediastore-data get-object \
--endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
--path events/baseball/setup.jpg setup.jpg
```
출력:
```
{
"ContentType": "image/jpeg",
"StatusCode": 200,
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
"ContentLength": "3860266",
"LastModified": "Fri, 19 Jul 2019 21:50:31 GMT"
}
```
**예시 2: 객체의 일부 다운로드**
다음 `get-object` 예시에서는 객체의 지정된 부분을 다운로드합니다.
```
aws mediastore-data get-object \
--endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
--path events/baseball/setup.jpg setup.jpg \
--range "bytes=0-100"
```
출력:
```
{
"StatusCode": 206,
"LastModified": "Fri, 19 Jul 2019 21:50:31 GMT",
"ContentType": "image/jpeg",
"ContentRange": "bytes 0-100/3860266",
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
"ContentLength": "101"
}
```
자세한 내용은 *AWS Elemental MediaStore 사용자 안내서*의 [객체 다운로드](https://docs.aws.amazon.com/mediastore/latest/ug/objects-download.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/get-object.html)를 참조하세요.
### `list-items`
다음 코드 예시에서는 `list-items`의 사용 방법을 보여줍니다.
**AWS CLI**
**예시 1: 컨테이너에 저장된 항목(객체 및 폴더) 목록 보기**
다음 `list-items` 예시에서는 지정된 컨테이너에 저장된 항목(객체 및 폴더) 목록을 표시합니다.
```
aws mediastore-data list-items \
--endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com
```
출력:
```
{
"Items": [
{
"Type": "OBJECT",
"ContentLength": 3784,
"Name": "setup.jpg",
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
"ContentType": "image/jpeg",
"LastModified": 1563571859.379
},
{
"Type": "FOLDER",
"Name": "events"
}
]
}
```
**예시 2: 폴더에 저장된 항목(객체 및 폴더) 목록 보기**
다음 `list-items` 예시에서는 지정된 폴더에 저장된 항목(객체 및 폴더) 목록을 표시합니다.
```
aws mediastore-data list-items \
--endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
--path events/baseball
```
출력:
```
{
"Items": [
{
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
"ContentType": "image/jpeg",
"Type": "OBJECT",
"ContentLength": 3860266,
"LastModified": 1563573031.872,
"Name": "setup.jpg"
}
]
}
```
자세한 내용은 *AWS Elemental MediaStore 사용자 안내서*의 [객체 목록 보기](https://docs.aws.amazon.com/mediastore/latest/ug/objects-view-list.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListItems](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/list-items.html)를 참조하세요.
### `put-object`
다음 코드 예시에서는 `put-object`의 사용 방법을 보여줍니다.
**AWS CLI**
**예시 1: 컨테이너에 객체 업로드**
다음 `put-object` 예시에서는 지정된 컨테이너에 객체를 업로드합니다.
```
aws mediastore-data put-object \
--endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
--body ReadMe.md \
--path ReadMe.md \
--cache-control "max-age=6, public" \
--content-type binary/octet-stream
```
출력:
```
{
"ContentSHA256": "f29bc64a9d3732b4b9035125fdb3285f5b6455778edca72414671e0ca3b2e0de",
"StorageClass": "TEMPORAL",
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3"
}
```
**예시 2: 컨테이너 내 폴더에 객체 업로드**
다음 `put-object` 예시에서는 컨테이너 내 지정된 폴더에 객체를 업로드합니다.
```
aws mediastore-data put-object \
--endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
--body ReadMe.md \
--path /september-events/ReadMe.md \
--cache-control "max-age=6, public" \
--content-type binary/octet-stream
```
출력:
```
{
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
"ContentSHA256": "f29bc64a9d3732b4b9035125fdb3285f5b6455778edca72414671e0ca3b2e0de",
"StorageClass": "TEMPORAL"
}
```
자세한 내용은 *AWS Elemental MediaStore 사용자 안내서*의 [객체 업로드](https://docs.aws.amazon.com/mediastore/latest/ug/objects-upload.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [PutObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/put-object.html)를 참조하세요.