Exemplos do MediaStore usando a AWS CLI

Para criar um contêiner

O exemplo create-container a seguir cria um contêiner novo e vazio.

aws mediastore create-container --container-name ExampleContainer

Saída:

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

Para obter mais informações, consulte Criar um contêiner no Guia do usuário do AWS Elemental MediaStore.

Para excluir uma política de contêiner

O exemplo delete-container-policy a seguir exclui a política atribuída ao contêiner especificado. Quando a política é excluída, o AWS Elemental MediaStore atribui automaticamente a política padrão ao contêiner.

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

Este comando não produz saída.

Para obter mais informações, consulte DeleteContainerPolicy na Referência da API do AWSElemental MediaStore.

Para excluir um contêiner

O exemplo delete-container a seguir exclui o contêiner especificado. Você só pode excluir um contêiner se ele não tiver objetos.

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

Este comando não produz saída.

Para obter mais informações, consulte Excluir um contêiner no Guia do usuário do AWS Elemental MediaStore.

Para excluir uma política de CORS

O exemplo delete-cors-policy a seguir exclui a política de compartilhamento entre recursos (CORS) atribuída ao contêiner especificado.

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

Este comando não produz saída.

Para obter mais informações, consulte Excluir uma política CORS no Guia do usuário do AWS Elemental MediaStore.

Para excluir uma política de ciclo de vida de objetos

O exemplo delete-lifecycle-policy a seguir exclui a política de ciclo de vida do objeto anexada ao contêiner especificado. Pode demorar até 20 minutos para que a alteração seja implementada.

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

Este comando não produz saída.

Para obter mais informações, consulte Excluir uma política de ciclo de vida de um objeto no Guia do usuário do AWS Elemental MediaStore.

Como visualizar os detalhes de um contêiner

O exemplo describe-container a seguir exibe os detalhes do contêiner especificado.

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

Saída:

{
    "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 obter mais informações, consulte Visualizar detalhes de um contêiner no Guia do usuário do AWS Elemental MediaStore.

Como visualizar uma lista de objetos e pastas em um contêiner específico

O exemplo describe-object a seguir exibe os itens (objetos e pastas) armazenados no contêiner especificado.

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

Saída:

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

Para obter mais informações, consulte Visualizar detalhes de um objeto no Guia do usuário do AWS Elemental MediaStore.

Como visualizar uma política de contêiner

O exemplo get-container-policy a seguir exibe a política baseada em recursos do contêiner especificado.

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

Saída:

{
    "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 obter mais informações, consulte Visualizar uma política de um contêiner no Guia do usuário do AWS Elemental MediaStore.

Como visualizar uma política de CORS

O exemplo get-cors-policy a seguir exibe a política de compartilhamento entre recursos (CORS) atribuída ao contêiner especificado.

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

Saída:

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

Para obter mais informações, consulte Visualizar uma política de CORS no Guia do usuário do AWS Elemental MediaStore.

Como visualizar uma política de ciclo de vida de um objeto

O exemplo get-lifecycle-policy a seguir exibe a política de ciclo de vida do objeto anexado ao contêiner especificado.

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

Saída:

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

Para obter mais informações, consulte Visualizar uma política de ciclo de vida de um objeto no Guia do usuário do AWS Elemental MediaStore.

Como fazer download de um objeto

O exemplo get-object a seguir faz o download de um objeto no endpoint especificado.

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

Saída:

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

Para fazer o download de parte de um objeto

O exemplo get-object a seguir faz o download de um objeto no endpoint 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

Saída:

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

Para obter mais informações, consulte Fazer download de um objeto no Guia do usuário do AWS Elemental MediaStore.

Como visualizar uma lista de contêineres

O exemplo list-containers a seguir da lista todos os contêineres associados à sua conta.

aws mediastore list-containers

Saída:

{
    "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 obter mais informações, consulte Como visualizar uma lista de contêineres no Guia do usuário do AWS Elemental MediaStore.

Exemplo 1: visualizar uma lista de objetos e pastas em um contêiner específico

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

Saída:

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

Exemplo 2: visualizar uma lista de objetos e pastas em uma pasta específica

O exemplo list-items a seguir exibe os itens (objetos e pastas) armazenados na pasta especificada.

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

Saída:

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

Para obter mais informações, consulte Visualizar uma lista de objetos no Guia do usuário do AWS Elemental MediaStore.

Para listar tags para um contêiner

O exemplo list-tags-for-resource a seguir exibe as chaves de tag e valores associados ao contêiner especificado.

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

Saída:

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

Para obter mais informações, consulte ListTagsForResource na Referência da API AWS Elemental MediaStore.

Como editar uma política de contêiner

O exemplo put-container-policy a seguir define uma política diferente ao contêiner especificado. Neste exemplo, a política atualizada é definida em um arquivo chamado LiveEventsContainerPolicy.json.

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

Este comando não produz saída.

Para obter mais informações, consulte Editar uma política de um contêiner no Guia do usuário do AWS Elemental MediaStore.

Exemplo 1: adicionar uma política de CORS

O exemplo put-cors-policy a seguir adiciona uma política de compartilhamento entre recursos (CORS) atribuída ao contêiner especificado. O conteúdo da política de CORS está no arquivo chamado corsPolicy.json.

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar uma política de CORS a um contêiner no Guia do usuário do AWS Elemental MediaStore.

Exemplo 2: editar uma política de CORS

O exemplo put-cors-policy a seguir atualiza a política de compartilhamento entre recursos (CORS) atribuída ao contêiner especificado. O conteúdo da política de CORS atualizada está no arquivo chamado corsPolicy2.json.

Para obter mais informações, consulte Editar uma política de CORS no Guia do usuário do AWS Elemental MediaStore.

Para criar uma política de ciclo de vida de objetos

O exemplo put-lifecycle-policy a anexa uma política de ciclo de vida de um objeto ao contêiner especificado. Isso permite especificar por quanto tempo o serviço deve armazenar objetos em seu contêiner. O MediaStore exclui objetos no contêiner quando eles atingem a data de expiração, conforme indicado na política, que está no arquivo chamado LiveEventsLifecyclePolicy.json.

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar uma política de ciclo de vida de objetos a um contêiner no Guia do usuário do AWS Elemental MediaStore.

Como fazer upload de um objeto

O exemplo put-object a seguir faz upload de um objeto no contêiner especificado. É possível especificar um caminho de pasta no qual o objeto será salvo dentro do contêiner. Se a pasta já existir, o AWS Elemental MediaStore armazenará o objeto na pasta. Se a pasta não existir, o serviço a cria e, em seguida, armazena o objeto na pasta.

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

Saída:

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

Para obter mais informações, consulte Fazer upload de um objeto no Guia do usuário do AWS Elemental MediaStore.

Como ativar o log de acesso a um contêiner

O exemplo start-access-logging a seguir ativa o log de acesso ao contêiner especificado.

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

Este comando não produz saída.

Para obter mais informações, consulte Ativar o log de acesso a um contêiner no Guia do usuário do AWS Elemental MediaStore.

Para desativar o log de acesso a um contêiner

O exemplo stop-access-logging a seguir desativa o log de acesso ao contêiner especificado.

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

Este comando não produz saída.

Para obter mais informações, consulte Desativar o log de acesso a um contêiner no Guia do usuário do AWS Elemental MediaStore.

Para adicionar tags a um contêiner

O exemplo tag-resource a seguir adiciona as chaves de tag e valores associados ao contêiner 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 não produz saída.

Para obter mais informações, consulte TagResource na Referência da API AWS Elemental MediaStore.

Para remover tags de um contêiner

O exemplo untag-resource a seguir remove a tag com o nome de chave especificado e seu valor associado de um contêiner.

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

Este comando não produz saída.

Para obter mais informações, consulte UntagResource na Referência da API AWS Elemental MediaStore.