MediaStore esempi utilizzando AWS CLI - AWS Command Line Interface

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

MediaStore esempi utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with MediaStore.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-container.

AWS CLI

Come creare un container

L’esempio create-container seguente crea un nuovo container vuoto.

aws mediastore create-container --container-name ExampleContainer

Output:

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

Per ulteriori informazioni, consulta Creazione di un contenitore nella Guida MediaStore utente di AWS Elemental.

Il seguente esempio di codice mostra come utilizzaredelete-container-policy.

AWS CLI

Come eliminare una policy di container

L’esempio delete-container-policy seguente elimina la policy assegnata al container specificato. Quando la policy viene eliminata, AWS Elemental assegna MediaStore automaticamente la policy predefinita al contenitore.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta il riferimento DeleteContainerPolicyall'API AWS MediaStore Elemental.

Il seguente esempio di codice mostra come utilizzaredelete-container.

AWS CLI

Come eliminare un container

L’esempio delete-container seguente elimina il container specificato. Puoi eliminare un container solo se non contiene oggetti.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Eliminazione di un contenitore nella Guida per l' MediaStore utente di AWS Elemental.

  • Per i dettagli sull'API, consulta AWS CLI Command DeleteContainerReference.

Il seguente esempio di codice mostra come utilizzaredelete-cors-policy.

AWS CLI

Come eliminare una policy CORS

L’esempio delete-cors-policy seguente elimina la policy Cross-Origin Resource Sharing (CORS) assegnata al container specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, vedete Eliminazione di una policy CORS nella Guida per l'utente di AWS MediaStore Elemental.

  • Per i dettagli sull'API, consultate Command DeleteCorsPolicyReference AWS CLI .

Il seguente esempio di codice mostra come utilizzaredelete-lifecycle-policy.

AWS CLI

Come eliminare una policy del ciclo di vita degli oggetti

L’esempio delete-lifecycle-policy seguente elimina la policy del ciclo di vita degli oggetti allegata al container specificato. Sono necessari fino a 20 minuti per rendere effettiva la modifica.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Eliminazione di una policy sul ciclo di vita degli oggetti nella Guida per l'utente di AWS MediaStore Elemental.

Il seguente esempio di codice mostra come utilizzaredescribe-container.

AWS CLI

Come visualizzare i dettagli di un container

L’esempio describe-container seguente visualizza i dettagli del container specificato.

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

Output:

{ "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" } }

Per ulteriori informazioni, consulta Visualizzazione dei dettagli di un contenitore nella Guida per l' MediaStore utente di AWS Elemental.

Il seguente esempio di codice mostra come utilizzaredescribe-object.

AWS CLI

Come visualizzare un elenco di oggetti e cartelle in un determinato container

L’esempio describe-object seguente visualizza degli elementi (oggetti e cartelle) memorizzati in un container specificato.

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

Output:

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

Per ulteriori informazioni, consulta Visualizzazione dei dettagli di un oggetto nella Guida per l' MediaStore utente di AWS Elemental.

Il seguente esempio di codice mostra come utilizzareget-container-policy.

AWS CLI

Come visualizzare una policy di container

L’esempio get-container-policy seguente visualizza la policy basata sulle risorse del container specificato.

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

Output:

{ "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" } } } ] } }

Per ulteriori informazioni, consulta Visualizzazione di una politica sui contenitori nella Guida per l' MediaStore utente di AWS Elemental.

Il seguente esempio di codice mostra come utilizzareget-cors-policy.

AWS CLI

Come visualizzare una policy CORS

L’esempio get-cors-policy seguente visualizza la policy Cross-Origin Resource Sharing (CORS) assegnata al container specificato.

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

Output:

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

Per ulteriori informazioni, vedere Visualizzazione di una politica CORS nella Guida per l' MediaStore utente di AWS Elemental.

  • Per i dettagli sulle API, consultate AWS CLI Command GetCorsPolicyReference.

Il seguente esempio di codice mostra come utilizzareget-lifecycle-policy.

AWS CLI

Come visualizzare una policy del ciclo di vita degli oggetti

L’esempio get-lifecycle-policy seguente elimina la policy del ciclo di vita degli oggetti associata al container specificato.

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

Output:

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

Per ulteriori informazioni, consulta Visualizzazione di una politica sul ciclo di vita degli oggetti nella Guida per l'utente di AWS MediaStore Elemental.

Il seguente esempio di codice mostra come utilizzareget-object.

AWS CLI

Come scaricare un oggetto

L’esempio get-object seguente scarica un oggetto nell’endpoint specificato.

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

Output:

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

Come scaricare parte di un oggetto

L’esempio get-object seguente scarica una parte di un oggetto nell’endpoint specificato.

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

Output:

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

Per ulteriori informazioni, consulta Downloading an Object nella AWS Elemental MediaStore User Guide.

Il seguente esempio di codice mostra come utilizzarelist-containers.

AWS CLI

Come visualizzare un elenco di container

L’esempio list-containers seguente visualizza un elenco di tutti i container associati all’account in uso.

aws mediastore list-containers

Output:

{ "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" } ] }

Per ulteriori informazioni, consulta Visualizzazione di un elenco di contenitori nella Guida per l' MediaStore utente di AWS Elemental.

Il seguente esempio di codice mostra come utilizzarelist-items.

AWS CLI

Esempio 1: come visualizzare un elenco di oggetti e cartelle in un determinato container

L’esempio list-items seguente visualizza degli elementi (oggetti e cartelle) archiviati in un container specificato.

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

Output:

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

Esempio 2: come visualizzare un elenco di oggetti e cartelle in una determinata cartella

L’esempio list-items seguente visualizza degli elementi (oggetti e cartelle) archiviati in una cartella specificata.

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

Output:

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

Per ulteriori informazioni, consulta Visualizzazione di un elenco di oggetti nella Guida MediaStore utente di AWS Elemental.

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Come elencare i tag per un container

L’esempio list-tags-for-resource seguente visualizza le chiavi e i valori dei tag assegnati al container specificato.

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

Output:

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

Per ulteriori informazioni, consulta ListTagsForResource AWSElemental MediaStore API Reference.

Il seguente esempio di codice mostra come utilizzareput-container-policy.

AWS CLI

Come modificare una policy di container

L’esempio put-container-policy seguente assegna una policy diversa al container specificato. In questo esempio, la policy aggiornata viene definita in un file denominato LiveEventsContainerPolicy.json.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Modifica di una politica sui contenitori nella Guida per l' MediaStore utente di AWS Elemental.

Il seguente esempio di codice mostra come utilizzareput-cors-policy.

AWS CLI

Esempio 1: come aggiungere una policy CORS

L’esempio put-cors-policy seguente aggiunge una policy Cross-Origin Resource Sharing (CORS) assegnata al container specificato. Il contenuto della policy CORS si trova nel file denominato corsPolicy.json.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, vedete Aggiungere una politica CORS a un contenitore nella Guida per l' MediaStore utente di AWS Elemental.

Esempio 2: come modificare una policy CORS

L’esempio put-cors-policy seguente aggiorna la policy Cross-Origin Resource Sharing (CORS) assegnata al container specificato. Il contenuto della policy CORS aggiornata si trova nel file denominato corsPolicy2.json.

Per ulteriori informazioni, vedete Modifica di una politica CORS nella Guida per l'utente di AWS MediaStore Elemental.

  • Per i dettagli sulle API, consultate AWS CLI Command PutCorsPolicyReference.

Il seguente esempio di codice mostra come utilizzareput-lifecycle-policy.

AWS CLI

Come creare una policy del ciclo di vita degli oggetti

L’esempio put-lifecycle-policy seguente associa una policy del ciclo di vita degli oggetti al container specificato. Ciò consente di specificare per quanto tempo il servizio deve archiviare gli oggetti nel contenitore. MediaStore elimina gli oggetti nel contenitore una volta raggiunta la data di scadenza, come indicato nella policy, che si trova nel file denominatoLiveEventsLifecyclePolicy.json.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere una policy sul ciclo di vita degli oggetti a un contenitore nella Guida per l'utente di AWS MediaStore Elemental.

Il seguente esempio di codice mostra come utilizzareput-object.

AWS CLI

Come caricare un oggetto

L’esempio put-object seguente carica un oggetto nel container specificato. Puoi specificare un percorso di cartella in cui salvare l’oggetto all’interno del container. Se la cartella esiste già, AWS Elemental MediaStore memorizza l'oggetto nella cartella. Se la cartella non esiste, il servizio la crea e quindi archivia l’oggetto nella cartella.

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

Output:

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

Per ulteriori informazioni, consulta Caricamento di un oggetto nella Guida utente di AWS MediaStore Elemental.

  • Per i dettagli sull'API, consulta AWS CLI Command PutObjectReference.

Il seguente esempio di codice mostra come utilizzarestart-access-logging.

AWS CLI

Come abilitare la registrazione di log su un container

L’esempio start-access-logging seguente abilita la registrazione di log degli accessi sul container specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Enabling Access Logging for a Container nella Guida per l' MediaStore utente di AWS Elemental.

Il seguente esempio di codice mostra come utilizzarestop-access-logging.

AWS CLI

Come disabilitare la registrazione di log su un container

L’esempio stop-access-logging seguente disabilita la registrazione di log sul container specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, vedete Disabling Access Logging for a Container nella Guida per l'utente di AWS MediaStore Elemental.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come aggiungere tag a un container

L’esempio tag-resource seguente aggiunge chiavi e valori di tag al container specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta TagResource AWSElemental MediaStore API Reference.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere i tag da un container

L’esempio untag-resource seguente rimuove la chiave di tag specificata e il valore associato da un container.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta UntagResource AWSElemental MediaStore API Reference. .