# Exemplos de plano de dados do MediaStore usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a AWS Command Line Interface com o plano de dados do MediaStore.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `delete-object`
O código de exemplo a seguir mostra como usar `delete-object`.
**AWS CLI**
**Para excluir um objeto**
O exemplo `delete-object` a seguir exclui o objeto especificado.
```
aws mediastore-data delete-object \
--endpoint=https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
--path=/folder_name/README.md
```
Este comando não produz saída.
Para obter mais informações, consulte [Excluir um objeto](https://docs.aws.amazon.com/mediastore/latest/ug/objects-delete.html) no *Guia do usuário do AWS Elemental MediaStore*.
+ Consulte detalhes da API em [DeleteObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/delete-object.html) na *Referência de comandos da AWS CLI*.
### `describe-object`
O código de exemplo a seguir mostra como usar `describe-object`.
**AWS CLI**
**Como visualizar os cabeçalhos de um objeto**
O exemplo `describe-object` a seguir exibe os cabeçalhos de um objeto no caminho especificado.
```
aws mediastore-data describe-object \
--endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
--path events/baseball/setup.jpg
```
Resultado:
```
{
"LastModified": "Fri, 19 Jul 2019 21:50:31 GMT",
"ContentType": "image/jpeg",
"ContentLength": "3860266",
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3"
}
```
Para obter mais informações, consulte [Visualizar detalhes de um objeto](https://docs.aws.amazon.com/mediastore/latest/ug/objects-view-details.html) no *Guia do usuário do AWS Elemental MediaStore*.
+ Para ver detalhes da API, consulte [DescribeObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/describe-object.html) na *Referência de comandos da AWS CLI*.
### `get-object`
O código de exemplo a seguir mostra como usar `get-object`.
**AWS CLI**
**Exemplo 1: fazer o download de um objeto inteiro**
O exemplo `get-object` a seguir faz o download do objeto especificado.
```
aws mediastore-data get-object \
--endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
--path events/baseball/setup.jpg setup.jpg
```
Resultado:
```
{
"ContentType": "image/jpeg",
"StatusCode": 200,
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
"ContentLength": "3860266",
"LastModified": "Fri, 19 Jul 2019 21:50:31 GMT"
}
```
**Exemplo 2: fazer download de parte de um objeto**
O exemplo `get-object` a seguir faz o download da parte especificada do objeto.
```
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"
```
Resultado:
```
{
"StatusCode": 206,
"LastModified": "Fri, 19 Jul 2019 21:50:31 GMT",
"ContentType": "image/jpeg",
"ContentRange": "bytes 0-100/3860266",
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
"ContentLength": "101"
}
```
Para obter mais informações, consulte [Fazer download de um objeto](https://docs.aws.amazon.com/mediastore/latest/ug/objects-download.html) no *Guia do usuário do AWS Elemental MediaStore*.
+ Consulte detalhes da API em [GetObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/get-object.html) na *Referência de comandos da AWS CLI*.
### `list-items`
O código de exemplo a seguir mostra como usar `list-items`.
**AWS CLI**
**Exemplo 1: visualizar uma lista de itens (objetos e pastas) armazenados em um contêiner**
O exemplo `list-items` a seguir exibe uma lista de itens (objetos e pastas) armazenados no contêiner especificado.
```
aws mediastore-data list-items \
--endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com
```
Resultado:
```
{
"Items": [
{
"Type": "OBJECT",
"ContentLength": 3784,
"Name": "setup.jpg",
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
"ContentType": "image/jpeg",
"LastModified": 1563571859.379
},
{
"Type": "FOLDER",
"Name": "events"
}
]
}
```
**Exemplo 2: visualizar uma lista de itens (objetos e pastas) armazenados em uma pasta**
O exemplo `list-items` a seguir exibe uma lista de itens (objetos e pastas) armazenados na pasta especificada.
```
aws mediastore-data list-items \
--endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
--path events/baseball
```
Resultado:
```
{
"Items": [
{
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
"ContentType": "image/jpeg",
"Type": "OBJECT",
"ContentLength": 3860266,
"LastModified": 1563573031.872,
"Name": "setup.jpg"
}
]
}
```
Para obter mais informações, consulte [Visualizar uma lista de objetos](https://docs.aws.amazon.com/mediastore/latest/ug/objects-view-list.html) no *Guia do usuário do AWS Elemental MediaStore*.
+ Para ver detalhes da API, consulte [ListItems](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/list-items.html) na *Referência de comandos da AWS CLI*.
### `put-object`
O código de exemplo a seguir mostra como usar `put-object`.
**AWS CLI**
**Exemplo 1: fazer upload de um objeto em um contêiner**
O exemplo `put-object` a seguir faz upload de um objeto no contêiner especificado.
```
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
```
Resultado:
```
{
"ContentSHA256": "f29bc64a9d3732b4b9035125fdb3285f5b6455778edca72414671e0ca3b2e0de",
"StorageClass": "TEMPORAL",
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3"
}
```
**Exemplo 2: fazer upload de um objeto em uma pasta dentro de um contêiner**
O exemplo `put-object` a seguir faz upload de um objeto na pasta especificada dentro de um contêiner.
```
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
```
Resultado:
```
{
"ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
"ContentSHA256": "f29bc64a9d3732b4b9035125fdb3285f5b6455778edca72414671e0ca3b2e0de",
"StorageClass": "TEMPORAL"
}
```
Para obter mais informações, consulte [Fazer upload de um objeto](https://docs.aws.amazon.com/mediastore/latest/ug/objects-upload.html) no *Guia do usuário do AWS Elemental MediaStore*.
+ Consulte detalhes da API em [PutObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/put-object.html) na *Referência de comandos da AWS CLI*.