

# Ejemplos de planos de datos de MediaStore que utilizan la AWS CLI
<a name="cli_mediastore-data_code_examples"></a>

Los siguientes ejemplos de código muestran cómo ejecutar acciones e implementar escenarios comunes usando AWS Command Line Interface con plano de datos de MediaStore.

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

**Topics**
+ [Acciones](#actions)

## Acciones
<a name="actions"></a>

### `delete-object`
<a name="mediastore-data_DeleteObject_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-object`.

**AWS CLI**  
**Para eliminar un objeto**  
En el siguiente ejemplo de `delete-object`, se elimina el objeto especificado.  

```
aws mediastore-data delete-object \
    --endpoint=https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
    --path=/folder_name/README.md
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Deleting an Object](https://docs.aws.amazon.com/mediastore/latest/ug/objects-delete.html) en la *Guía del usuario de AWS Elemental MediaStore*.  
+  Para obtener información sobre la API, consulte [DeleteObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/delete-object.html) en la *Referencia de comandos de AWS CLI*. 

### `describe-object`
<a name="mediastore-data_DescribeObject_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-object`.

**AWS CLI**  
**Para ver los encabezados de un objeto**  
En el siguiente ejemplo de `describe-object`, se muestran los encabezados de un objeto en la ruta especificada.  

```
aws mediastore-data describe-object \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
    --path events/baseball/setup.jpg
```
Salida:  

```
{
    "LastModified": "Fri, 19 Jul 2019 21:50:31 GMT",
    "ContentType": "image/jpeg",
    "ContentLength": "3860266",
    "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3"
}
```
Para obtener más información, consulte [Viewing the Details of an Object](https://docs.aws.amazon.com/mediastore/latest/ug/objects-view-details.html) en la *Guía del usuario de AWS Elemental MediaStore*.  
+  Para obtener información sobre la API, consulte [DescribeObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/describe-object.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-object`
<a name="mediastore-data_GetObject_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-object`.

**AWS CLI**  
**Ejemplo 1: descargar un objeto completo**  
En el siguiente ejemplo de `get-object`, se descarga el objeto especificado.  

```
aws mediastore-data get-object \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
    --path events/baseball/setup.jpg setup.jpg
```
Salida:  

```
{
    "ContentType": "image/jpeg",
    "StatusCode": 200,
    "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
    "ContentLength": "3860266",
    "LastModified": "Fri, 19 Jul 2019 21:50:31 GMT"
}
```
**Ejemplo 2: descargar parte de un objeto**  
En el siguiente ejemplo de `get-object`, se descarga la parte especificada de un 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"
```
Salida:  

```
{
    "StatusCode": 206,
    "LastModified": "Fri, 19 Jul 2019 21:50:31 GMT",
    "ContentType": "image/jpeg",
    "ContentRange": "bytes 0-100/3860266",
    "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
    "ContentLength": "101"
}
```
Para obtener más información, consulte [Downloading an Object](https://docs.aws.amazon.com/mediastore/latest/ug/objects-download.html) en la *Guía del usuario de AWS Elemental MediaStore*.  
+  Para obtener información sobre la API, consulte [GetObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/get-object.html) en la *Referencia de comandos de AWS CLI*. 

### `list-items`
<a name="mediastore-data_ListItems_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-items`.

**AWS CLI**  
**Ejemplo 1: ver una lista de elementos (objetos y carpetas) almacenados en un contenedor**  
En el siguiente ejemplo de `list-items`, se muestra una lista de elementos (objetos y carpetas) almacenados en el contenedor especificado.  

```
aws mediastore-data list-items \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com
```
Salida:  

```
{
    "Items": [
        {
            "Type": "OBJECT",
            "ContentLength": 3784,
            "Name": "setup.jpg",
            "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
            "ContentType": "image/jpeg",
            "LastModified": 1563571859.379
        },
        {
            "Type": "FOLDER",
            "Name": "events"
        }
    ]
}
```
**Ejemplo 2: ver una lista de elementos (objetos y carpetas) almacenados en una carpeta**  
En el siguiente ejemplo de `list-items`, se muestra una lista de elementos (objetos y carpetas) almacenados en la carpeta especificada.  

```
aws mediastore-data list-items \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
    --path events/baseball
```
Salida:  

```
{
    "Items": [
        {
            "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
            "ContentType": "image/jpeg",
            "Type": "OBJECT",
            "ContentLength": 3860266,
            "LastModified": 1563573031.872,
            "Name": "setup.jpg"
        }
    ]
}
```
Para obtener más información, consulte [Viewing a List of Objects](https://docs.aws.amazon.com/mediastore/latest/ug/objects-view-list.html) en la *Guía del usuario de AWS Elemental MediaStore*.  
+  Para obtener información sobre la API, consulte [ListItems](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/list-items.html) en la *Referencia de comandos de la AWS CLI*. 

### `put-object`
<a name="mediastore-data_PutObject_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `put-object`.

**AWS CLI**  
**Ejemplo 1: cargar un objeto en un contenedor**  
En el siguiente ejemplo de `put-object`, se carga un objeto en el contenedor 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
```
Salida:  

```
{
    "ContentSHA256": "f29bc64a9d3732b4b9035125fdb3285f5b6455778edca72414671e0ca3b2e0de",
    "StorageClass": "TEMPORAL",
    "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3"
}
```
**Ejemplo 2: cargar un objeto en una carpeta dentro de un contenedor**  
En el siguiente ejemplo de `put-object`, se carga un objeto en la carpeta especificada dentro de un contenedor.  

```
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
```
Salida:  

```
{
    "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
    "ContentSHA256": "f29bc64a9d3732b4b9035125fdb3285f5b6455778edca72414671e0ca3b2e0de",
    "StorageClass": "TEMPORAL"
}
```
Para obtener más información, consulte [Uploading an Object](https://docs.aws.amazon.com/mediastore/latest/ug/objects-upload.html) en la *Guía del usuario de AWS Elemental MediaStore*.  
+  Para obtener información sobre la API, consulte [PutObject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediastore-data/put-object.html) en la *Referencia de comandos de AWS CLI*. 