Esempi per MediaStore con AWS CLI

Gli esempi di codice seguenti mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Command Line Interface con MediaStore.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni 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

Azioni

L’esempio di codice seguente mostra come utilizzare create-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 container nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta CreateContainer in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-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 MediaStore assegna automaticamente la policy predefinita al container.


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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta DeleteContainerPolicy nella documentazione di riferimento dell’API AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta DeleteContainerPolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-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 container nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta DeleteContainer in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-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, consulta Eliminazione di una policy CORS nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta DeleteCorsPolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-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 Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta DeleteLifecyclePolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-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 container nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta DescribeContainer in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-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’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta DescribeObject nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare get-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 policy di container nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta GetContainerPolicy nella documentazione dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare get-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, consulta Visualizzazione di una policy CORS nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta GetCorsPolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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 policy del ciclo di vita degli oggetti nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta GetLifecyclePolicy nella documentazione dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare get-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 Download di un oggetto nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta GetObject nella documentazione di riferimento del comando AWS CLI.

L’esempio di codice seguente mostra come utilizzare list-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 container nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta ListContainers in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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 per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta ListItems in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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 nella documentazione di riferimento dell’API AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta ListTagsForResource nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare put-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 policy di container nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta PutContainerPolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare put-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, consulta Aggiunta di una policy CORS a un container nella Guida per l’utente di AWS Elemental MediaStore.

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, consulta Modifica di una policy CORS nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta PutCorsPolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare put-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 container. MediaStore elimina gli oggetti nel container una volta raggiunta la data di scadenza, come indicato nella policy che si trova nel file denominato LiveEventsLifecyclePolicy.json.


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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiunta di una policy del ciclo di vita degli oggetti a un container nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta PutLifecyclePolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare put-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 archivia l’oggetto in tale 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 per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta PutObject nella documentazione di riferimento del comando AWS CLI.

L’esempio di codice seguente mostra come utilizzare start-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 Abilitazione della registrazione degli accessi per un container nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta StartAccessLogging in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare stop-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, consulta Disabilitazione della registrazione degli accessi per un container nella Guida per l’utente di AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta StopAccessLogging in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag-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 nella documentazione di riferimento dell’API AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta TagResource nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare untag-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 nella documentazione di riferimento dell’API AWS Elemental MediaStore.

Per informazioni dettagliate sull’API, consulta UntagResource nella documentazione di riferimento dei comandi della AWS CLI.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

ElastiCache

Amazon EMR