MediaStore exemplos usando AWS CLI - AWS Command Line Interface

Esta documentação é para a AWS CLI única versão 1. Para obter a documentação relacionada à versão 2 do AWS CLI, consulte o Guia do usuário da versão 2.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

MediaStore exemplos usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with 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 funções 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, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.

Tópicos

Ações

O código de exemplo a seguir mostra como usar create-container.

AWS CLI

Para criar um contêiner

O create-container exemplo a seguir cria um novo contêiner 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 Criação de um contêiner no Guia do MediaStore usuário do AWS Elemental.

  • Para API obter detalhes, consulte CreateContainerna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-container-policy.

AWS CLI

Para excluir uma política de contêiner

O delete-container-policy exemplo a seguir exclui a política atribuída ao contêiner especificado. Quando a política é excluída, o AWS Elemental atribui MediaStore 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 DeleteContainerPolicyna MediaStore APIreferência AWS Elemental.

O código de exemplo a seguir mostra como usar delete-container.

AWS CLI

Para excluir um contêiner

O delete-container exemplo 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 Excluindo um contêiner no Guia do MediaStore usuário do AWS Elemental.

  • Para API obter detalhes, consulte DeleteContainerna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-cors-policy.

AWS CLI

Para excluir uma CORS política

O delete-cors-policy exemplo a seguir exclui a política de compartilhamento de recursos de origem cruzada (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 Excluindo uma CORS política no Guia do MediaStore usuário do AWS Elemental.

  • Para API obter detalhes, consulte DeleteCorsPolicyna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-lifecycle-policy.

AWS CLI

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

O delete-lifecycle-policy exemplo a seguir exclui a política de ciclo de vida do objeto anexada ao contêiner especificado. Essa alteração pode levar até 20 minutos para entrar em vigor.

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

Este comando não produz saída.

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

O código de exemplo a seguir mostra como usar describe-container.

AWS CLI

Para ver os detalhes de um contêiner

O describe-container exemplo 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 Visualizando os detalhes de um contêiner no Guia do MediaStore usuário do AWS Elemental.

  • Para API obter detalhes, consulte DescribeContainerna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar describe-object.

AWS CLI

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

O describe-object exemplo a seguir exibe itens (objetos e pastas) armazenados em um contêiner específico.

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 Visualizando os detalhes de um objeto no Guia do MediaStore usuário do AWS Elemental.

  • Para API obter detalhes, consulte DescribeObjectna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-container-policy.

AWS CLI

Para ver uma política de contêiner

O get-container-policy exemplo 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 Visualizando uma política de contêiner no Guia do MediaStore usuário do AWS Elemental.

O código de exemplo a seguir mostra como usar get-cors-policy.

AWS CLI

Para ver uma CORS política

O get-cors-policy exemplo a seguir exibe a política de compartilhamento de recursos de origem cruzada (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 Visualizando uma CORS política no Guia do MediaStore usuário do AWS Elemental.

  • Para API obter detalhes, consulte GetCorsPolicyna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-lifecycle-policy.

AWS CLI

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

O get-lifecycle-policy exemplo a seguir exibe a política de ciclo de vida do objeto anexada 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 Visualizando uma política de ciclo de vida de objetos no Guia do usuário do AWS Elemental MediaStore .

O código de exemplo a seguir mostra como usar get-object.

AWS CLI

Para baixar um objeto

O get-object exemplo a seguir baixa um objeto para o 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 baixar parte de um objeto

O get-object exemplo a seguir baixa uma parte de um objeto para o 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 Baixar um objeto no Guia do MediaStore usuário do AWS Elemental.

  • Para API obter detalhes, consulte GetObjectna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-containers.

AWS CLI

Para ver uma lista de contêineres

O list-containers exemplo a seguir exibe uma lista de 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 Visualizando uma lista de contêineres no Guia do MediaStore usuário do AWS Elemental.

  • Para API obter detalhes, consulte ListContainersna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-items.

AWS CLI

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

O list-items exemplo a seguir exibe 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: Para visualizar uma lista de objetos e pastas em uma pasta específica

O list-items exemplo a seguir exibe itens (objetos e pastas) armazenados em uma pasta específica.

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 Visualizando uma lista de objetos no Guia do MediaStore usuário do AWS Elemental.

  • Para API obter detalhes, consulte ListItemsna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-tags-for-resource.

AWS CLI

Para listar tags para um contêiner

O list-tags-for-resource exemplo a seguir exibe as chaves e os valores de tag atribuídos 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 ListTagsForResourcena MediaStore APIReferência AWS Elemental.

O código de exemplo a seguir mostra como usar put-container-policy.

AWS CLI

Para editar uma política de contêiner

O put-container-policy exemplo a seguir atribui uma política diferente ao contêiner especificado. Neste exemplo, a política atualizada é definida em um arquivo chamadoLiveEventsContainerPolicy.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 Editando uma política de contêiner no Guia do MediaStore usuário do AWS Elemental.

O código de exemplo a seguir mostra como usar put-cors-policy.

AWS CLI

Exemplo 1: Para adicionar uma CORS política

O put-cors-policy exemplo a seguir adiciona uma política de compartilhamento de recursos (CORS) de origem cruzada ao contêiner especificado. O conteúdo da CORS política está no arquivo chamadocorsPolicy.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 CORS política a um contêiner no Guia do MediaStore usuário do AWS Elemental.

Exemplo 2: Para editar uma CORS política

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

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

  • Para API obter detalhes, consulte PutCorsPolicyna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar put-lifecycle-policy.

AWS CLI

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

O put-lifecycle-policy exemplo a seguir anexa uma política de ciclo de vida do objeto ao contêiner especificado. Isso permite que você especifique por quanto tempo o serviço deve armazenar objetos em seu contêiner. MediaStore exclui objetos no contêiner quando eles atingem sua data de expiração, conforme indicado na política, que está no arquivo nomeadoLiveEventsLifecyclePolicy.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 .

O código de exemplo a seguir mostra como usar put-object.

AWS CLI

Para fazer o upload de um objeto

O put-object exemplo a seguir carrega um objeto no contêiner especificado. Você pode especificar um caminho de pasta em que o objeto será salvo no contêiner. Se a pasta já existir, o AWS Elemental MediaStore armazena 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 Carregando um objeto no Guia do MediaStore usuário do AWS Elemental.

  • Para API obter detalhes, consulte PutObjectna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar start-access-logging.

AWS CLI

Para habilitar o registro de acesso em um contêiner

O start-access-logging exemplo a seguir habilita o registro de acesso no contêiner especificado.

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

Este comando não produz saída.

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

O código de exemplo a seguir mostra como usar stop-access-logging.

AWS CLI

Para desativar o registro de acesso em um contêiner

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

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

Este comando não produz saída.

Para obter mais informações, consulte Como desativar o registro de acesso para um contêiner no Guia do MediaStore usuário do AWS Elemental.

  • Para API obter detalhes, consulte StopAccessLoggingna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar tag-resource.

AWS CLI

Para adicionar tags a um contêiner

O tag-resource exemplo a seguir adiciona chaves e valores de tag 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 TagResourcena MediaStore APIReferência AWS Elemental.

  • Para API obter detalhes, consulte TagResourcena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar untag-resource.

AWS CLI

Para remover etiquetas de um contêiner

O untag-resource exemplo a seguir remove a chave de tag especificada 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 UntagResourcena MediaStore APIReferência AWS Elemental. .

  • Para API obter detalhes, consulte UntagResourcena Referência de AWS CLI Comandos.