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 CreateContainer
na 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.
-
Para API obter detalhes, consulte DeleteContainerPolicy
na Referência de AWS CLI Comandos.
-
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 DeleteContainer
na 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 DeleteCorsPolicy
na 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 .
-
Para API obter detalhes, consulte DeleteLifecyclePolicy
na Referência de AWS CLI Comandos.
-
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 DescribeContainer
na 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 DescribeObject
na 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.
-
Para API obter detalhes, consulte GetContainerPolicy
na Referência de AWS CLI Comandos.
-
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
\ --regionus-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 GetCorsPolicy
na 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 .
-
Para API obter detalhes, consulte GetLifecyclePolicy
na Referência de AWS CLI Comandos.
-
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.mdSaí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 GetObject
na 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 ListContainers
na 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 ListItems
na 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.
-
Para API obter detalhes, consulte ListTagsForResource
na Referência de AWS CLI Comandos.
-
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
\ --policyfile://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.
-
Para API obter detalhes, consulte PutContainerPolicy
na Referência de AWS CLI Comandos.
-
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-policyfile://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 PutCorsPolicy
na 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-policyfile://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 .
-
Para API obter detalhes, consulte PutLifecyclePolicy
na Referência de AWS CLI Comandos.
-
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
\ --bodyREADME.md
\ --path/folder_name/README.md
\ --cache-control"max-age=6, public"
\ --content-typebinary/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 PutObject
na 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.
-
Para API obter detalhes, consulte StartAccessLogging
na Referência de AWS CLI Comandos.
-
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 StopAccessLogging
na 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 TagResource
na 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-keysRegion
Este comando não produz saída.
Para obter mais informações, consulte UntagResourcena MediaStore APIReferência AWS Elemental. .
-
Para API obter detalhes, consulte UntagResource
na Referência de AWS CLI Comandos.
-