# 使用 AWS CLI 的 MediaStore Data Plane 示例
以下代码示例演示如何通过将 AWS Command Line Interface与 MediaStore Data Plane 结合使用，来执行操作和实现常见场景。
*操作是大型程序的代码摘录*，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。
每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。
**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)。