文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 [AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 的 MediaStore 資料平面範例 AWS CLI
下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 MediaStore Data Plane 來執行動作和實作常見案例。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。
**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)。