Ejemplos de MediaStore que utilizan la AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

Ejemplos de MediaStore que utilizan la AWS CLI

En los siguientes ejemplos de código se muestra cómo ejecutar acciones e implementar escenarios comunes usando AWS Command Line Interface con 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 funciones de servicio individuales, 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.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar create-container.

AWS CLI

Para crear un contenedor

En el siguiente ejemplo de create-container, se crea un nuevo contenedor vacío.

aws mediastore create-container --container-name ExampleContainer

Salida:

{
    "Container": {
        "AccessLoggingEnabled": false,
        "CreationTime": 1563557265,
        "Name": "ExampleContainer",
        "Status": "CREATING",
        "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleContainer"
    }
}

Para obtener más información, consulte Creating a Container en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte CreateContainer en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para eliminar una política de contenedor

En el siguiente ejemplo de delete-container-policy, se elimina la política asignada al contenedor especificado. Cuando se elimina la política, AWS Elemental MediaStore asigna automáticamente la política predeterminada al contenedor.

aws mediastore delete-container-policy \
    --container-name LiveEvents

Este comando no genera ninguna salida.

Para obtener más información, consulte DeleteContainerPolicy en la Referencia de la API de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte DeleteContainerPolicy en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para eliminar un contenedor

En el siguiente ejemplo de delete-container, se elimina el contenedor especificado. Un contenedor únicamente se puede eliminar si no tiene objetos.

aws mediastore delete-container \
    --container-name=ExampleLiveDemo

Este comando no genera ninguna salida.

Para obtener más información, consulte Deleting a Container en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte DeleteContainer en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para eliminar una política del CORS

En el siguiente ejemplo de delete-cors-policy, se elimina la política de uso compartido de recursos entre orígenes (CORS) que está asignada al contenedor especificado.

aws mediastore delete-cors-policy \
    --container-name ExampleContainer

Este comando no genera ninguna salida.

Para obtener más información, consulte Deleting a CORS Policy en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte DeleteCorsPolicy en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para eliminar una política de ciclo de vida de objetos

En el siguiente ejemplo de delete-lifecycle-policy, se elimina la política de ciclo de vida de objetos asociada al contenedor especificado. Este cambio puede tardar hasta 20 minutos en surtir efecto.

aws mediastore delete-lifecycle-policy \
    --container-name LiveEvents

Este comando no genera ninguna salida.

Para obtener más información, consulte Deleting an Object Lifecycle Policy en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte DeleteLifecyclePolicy en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para ver los detalles de un contenedor

En el siguiente ejemplo de describe-container, se muestran los detalles del contenedor especificado.

aws mediastore describe-container \
    --container-name ExampleContainer

Salida:

{
    "Container": {
        "CreationTime": 1563558086,
        "AccessLoggingEnabled": false,
        "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleContainer",
        "Status": "ACTIVE",
        "Name": "ExampleContainer",
        "Endpoint": "https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com"
    }
}

Para obtener más información, consulte Viewing the Details for a Container en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte DescribeContainer en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para ver una lista de objetos y carpetas de un contenedor específico

El siguiente ejemplo de describe-object muestra elementos (objetos y carpetas) almacenados en un contenedor específico.

aws mediastore-data describe-object \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
    --path /folder_name/file1234.jpg

Salida:

{
    "ContentType": "image/jpeg",
    "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT",
    "ContentLength": "2307346",
    "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3"
}

Para obtener más información, consulte Viewing the Details of an Object en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte DescribeObject en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para ver una política de contenedor

En el siguiente ejemplo de get-container-policy, se muestra la política basada en recursos del contenedor especificado.

aws mediastore get-container-policy \
    --container-name ExampleLiveDemo

Salida:

{
    "Policy": {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "PublicReadOverHttps",
                "Effect": "Allow",
                "Principal": {
                    "AWS": "arn:aws:iam::111122223333:root"
                },
                "Action": [
                    "mediastore:GetObject",
                    "mediastore:DescribeObject"
                ],
                "Resource": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleLiveDemo/",
                "Condition": {
                    "Bool": {
                        "aws:SecureTransport": "true"
                    }
                }
            }
        ]
    }
}

Para obtener más información, consulte Viewing a Container Policy en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte GetContainerPolicy en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para ver una política de CORS

En el siguiente ejemplo de get-cors-policy, se muestra la política de uso compartido de recursos entre orígenes (CORS) que está asignada al contenedor especificado.

aws mediastore get-cors-policy \
    --container-name ExampleContainer \
    --region us-west-2

Salida:

{
    "CorsPolicy": [
        {
            "AllowedMethods": [
                "GET",
                "HEAD"
            ],
            "MaxAgeSeconds": 3000,
            "AllowedOrigins": [
                ""
            ],
            "AllowedHeaders": [
                ""
            ]
        }
    ]
}

Para obtener más información, consulte Viewing a CORS Policy en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte GetCorsPolicy en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para ver una política de ciclo de vida de objetos

En el siguiente ejemplo de get-lifecycle-policy, se muestra la política de ciclo de vida de objetos asociada al contenedor especificado.

aws mediastore get-lifecycle-policy \
    --container-name LiveEvents

Salida:

{
    "LifecyclePolicy": {
        "rules": [
            {
                "definition": {
                    "path": [
                        {
                            "prefix": "Football/"
                        },
                        {
                            "prefix": "Baseball/"
                        }
                    ],
                    "days_since_create": [
                        {
                            "numeric": [
                                ">",
                                28
                            ]
                        }
                    ]
                },
                "action": "EXPIRE"
            }
        ]
    }
}

Para obtener más información, consulte Viewing an Object Lifecycle Policy en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte GetLifecyclePolicy en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para descargar un objeto

En el siguiente ejemplo de get-object, se descarga un objeto en el punto de conexión especificado.

aws mediastore-data get-object \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
    --path=/folder_name/README.md README.md

Salida:

{
    "ContentLength": "2307346",
    "ContentType": "image/jpeg",
    "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT",
    "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
    "StatusCode": 200
}

Para descargar parte de un objeto

En el siguiente ejemplo de get-object, se descarga parte de un objeto en el punto de conexión especificado.

aws mediastore-data get-object \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
    --path /folder_name/README.md \
    --range="bytes=0-100" README2.md

Salida:

{
    "StatusCode": 206,
    "ContentRange": "bytes 0-100/2307346",
    "ContentLength": "101",
    "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT",
    "ContentType": "image/jpeg",
    "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3"
}

Para obtener más información, consulte Downloading an Object en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte GetObject en la Referencia de comandos de AWS CLI.

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

AWS CLI

Para ver una lista de contenedores

En el siguiente ejemplo de list-containers, se muestra una lista de todos los contenedores que están asociados a la cuenta.

aws mediastore list-containers

Salida:

{
    "Containers": [
        {
            "CreationTime": 1505317931,
            "Endpoint": "https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com",
            "Status": "ACTIVE",
            "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleLiveDemo",
            "AccessLoggingEnabled": false,
            "Name": "ExampleLiveDemo"
        },
        {
            "CreationTime": 1506528818,
            "Endpoint": "https://fffggghhhiiijj.data.mediastore.us-west-2.amazonaws.com",
            "Status": "ACTIVE",
            "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleContainer",
            "AccessLoggingEnabled": false,
            "Name": "ExampleContainer"
        }
    ]
}

Para obtener más información, consulte Viewing a List of Containers en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte ListContainers en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Ejemplo 1: ver una lista de objetos y carpetas de un contenedor específico

En el siguiente ejemplo de list-items, se muestran 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": [
        {
            "ContentType": "image/jpeg",
            "LastModified": 1563571859.379,
            "Name": "filename.jpg",
            "Type": "OBJECT",
            "ETag": "543ab21abcd1a234ab123456a1a2b12345ab12abc12a1234abc1a2bc12345a12",
            "ContentLength": 3784
        },
        {
            "Type": "FOLDER",
            "Name": "ExampleLiveDemo"
        }
    ]
}

Ejemplo 2: ver una lista de los objetos y las carpetas de una carpeta específica

En el siguiente ejemplo de list-items, se muestran elementos (objetos y carpetas) almacenados en una carpeta específica.

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

Salida:

{
    "Items": [
        {
            "ContentType": "image/jpeg",
            "LastModified": 1563571859.379,
            "Name": "filename.jpg",
            "Type": "OBJECT",
            "ETag": "543ab21abcd1a234ab123456a1a2b12345ab12abc12a1234abc1a2bc12345a12",
            "ContentLength": 3784
        },
        {
            "Type": "FOLDER",
            "Name": "ExampleLiveDemo"
        }
    ]
}

Para obtener más información, consulte Viewing a List of Objects en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte ListItems en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-tags-for-resource.

AWS CLI

Para enumerar las etiquetas de un contenedor

En el siguiente ejemplo de list-tags-for-resource, se muestran las claves y los valores de etiqueta asignados al contenedor especificado.

aws mediastore list-tags-for-resource \
    --resource arn:aws:mediastore:us-west-2:1213456789012:container/ExampleContainer

Salida:

{
    "Tags": [
        {
            "Value": "Test",
            "Key": "Environment"
        },
        {
            "Value": "West",
            "Key": "Region"
        }
    ]
}

Para obtener más información, consulte ListTagsForResource en la Referencia de la API de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte ListTagsForResource en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para editar una política de contenedor

En el siguiente ejemplo de put-container-policy, se asigna una política diferente al contenedor especificado. En este ejemplo, la política actualizada se define en un archivo llamado LiveEventsContainerPolicy.json.

aws mediastore put-container-policy \
    --container-name LiveEvents \
    --policy file://LiveEventsContainerPolicy.json

Este comando no genera ninguna salida.

Para obtener más información, consulte Editing a Container Policy en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte PutContainerPolicy en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Ejemplo 1: añadir una política de CORS

En el siguiente ejemplo de put-cors-policy, se añade una política de uso compartido de recursos entre orígenes (CORS) al contenedor especificado. El contenido de la política de CORS se encuentra en el archivo llamado corsPolicy.json.

aws mediastore put-cors-policy \
    --container-name ExampleContainer \
    --cors-policy file://corsPolicy.json

Este comando no genera ninguna salida.

Para obtener más información, consulte Adding a CORS Policy to a Container en la Guía del usuario de AWS Elemental MediaStore.

Ejemplo 2: editar una política de CORS

En el siguiente ejemplo de put-cors-policy, se actualiza la política de uso compartido de recursos entre orígenes (CORS) que está asignada al contenedor especificado. El contenido de la política de CORS actualizada se encuentra en el archivo llamado corsPolicy2.json.

Para obtener más información, consulte Editing a CORS Policy en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información acerca de la API, consulte PutCorsPolicy en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para crear una política de ciclo de vida de objetos

En el siguiente ejemplo de put-lifecycle-policy, se asocia la política de ciclo de vida de objetos al contenedor especificado. Esto le permite especificar durante cuánto tiempo debe almacenar el servicio los objetos en su contenedor. MediaStore elimina los objetos del contenedor una vez que llegan a su fecha de caducidad, indicada en la política, que se encuentra en el archivo llamado LiveEventsLifecyclePolicy.json.

aws mediastore put-lifecycle-policy \
    --container-name ExampleContainer \
    --lifecycle-policy file://ExampleLifecyclePolicy.json

Este comando no genera ninguna salida.

Para obtener más información, consulte Adding an Object Lifecycle Policy to a Container en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte PutLifecyclePolicy en la Referencia de comandos de la AWS CLI.

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

AWS CLI

Para cargar un objeto

En el siguiente ejemplo de put-object, se carga un objeto en el contenedor especificado. Puede especificar una ruta de carpeta en la que se guardará el objeto dentro del contenedor. Si la carpeta ya existe, AWS Elemental MediaStore almacena el objeto en la carpeta. Si la carpeta no existe, el servicio la crea y, a continuación, almacena el objeto en ella.

aws mediastore-data put-object \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
    --body README.md \
    --path /folder_name/README.md \
    --cache-control "max-age=6, public" \
    --content-type binary/octet-stream

Salida:

{
    "ContentSHA256": "74b5fdb517f423ed750ef214c44adfe2be36e37d861eafe9c842cbe1bf387a9d",
    "StorageClass": "TEMPORAL",
    "ETag": "af3e4731af032167a106015d1f2fe934e68b32ed1aa297a9e325f5c64979277b"
}

Para obtener más información, consulte Uploading an Object en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte PutObject en la Referencia de comandos de AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar start-access-logging.

AWS CLI

Para habilitar el registro de acceso en un contenedor

En el siguiente ejemplo de start-access-logging, se habilita el registro de acceso en el contenedor especificado.

aws mediastore start-access-logging \
    --container-name LiveEvents

Este comando no genera ninguna salida.

Para obtener más información, consulte Enabling Access Logging for a Container en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte StartAccessLogging en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar stop-access-logging.

AWS CLI

Para deshabilitar el registro de acceso en un contenedor

En el siguiente ejemplo de stop-access-logging, se deshabilita el registro de acceso en el contenedor especificado.

aws mediastore stop-access-logging \
    --container-name LiveEvents

Este comando no genera ninguna salida.

Para obtener más información, consulte Disabling Access Logging for a Container en la Guía del usuario de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte StopAccessLogging en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar tag-resource.

AWS CLI

Para añadir etiquetas a un contenedor

En el siguiente ejemplo de tag-resource, se añaden las claves y los valores de etiqueta al contenedor especificado.

aws mediastore tag-resource \
    --resource arn:aws:mediastore:us-west-2:123456789012:container/ExampleContainer \
    --tags '[{"Key": "Region", "Value": "West"}, {"Key": "Environment", "Value": "Test"}]'

Este comando no genera ninguna salida.

Para obtener más información, consulte TagResource en la Referencia de la API de AWS Elemental MediaStore.

  • Para ver los detalles de la API, consulte TagResource en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar untag-resource.

AWS CLI

Para eliminar etiquetas de un contenedor

En el siguiente ejemplo de untag-resource, se elimina la clave de etiqueta especificada y su valor asociado de un contenedor.

aws mediastore untag-resource \
    --resource arn:aws:mediastore:us-west-2:123456789012:container/ExampleContainer \
    --tag-keys Region

Este comando no genera ninguna salida.

Para obtener más información, consulte UntagResource en la Referencia de la API de AWS Elemental MediaStore.

  • Para obtener información sobre la API, consulte UntagResource en la Referencia de comandos de la AWS CLI.