Esempi per MediaStore con AWS CLI

Come creare un container

Nell’esempio seguente create-container 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.

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 di AWS Elemental MediaStore.

Come eliminare un container

Nell’esempio seguente delete-container 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.

Come eliminare una policy CORS

Nell’esempio seguente delete-cors-policy 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.

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.

Come visualizzare i dettagli di un container

Nell’esempio seguente describe-container 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.

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

Nell’esempio seguente describe-object 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.

Come visualizzare una policy di container

Nell’esempio seguente get-container-policy 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.

Come visualizzare una policy CORS

Nell’esempio seguente get-cors-policy 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.

Come visualizzare una policy del ciclo di vita degli oggetti

Nell’esempio seguente get-lifecycle-policy elimina la policy del ciclo di vita degli oggetti allegata 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.

Come scaricare un oggetto

Nell’esempio seguente get-object 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

Nell’esempio seguente get-object 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.

Come visualizzare un elenco di container

Nell’esempio seguente list-containers 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.

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

Nell’esempio seguente list-items visualizza degli elementi (oggetti e cartelle) memorizzati 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: per visualizzare un elenco di oggetti e cartelle in una determinata cartella

Nell’esempio seguente list-items visualizza degli elementi (oggetti e cartelle) memorizzati 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.

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 di AWS Elemental MediaStore.

Come modificare una policy di container

Nell’esempio seguente put-container-policy assegna una la 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.

Esempio 1: aggiungere una policy CORS

Nell’esempio seguente put-cors-policy 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: modificare una policy CORS

Nell’esempio seguente put-cors-policy 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.

Come creare una policy del ciclo di vita degli oggetti

Nell’esempio seguente put-lifecycle-policy allega 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.

Come caricare un oggetto

Nell’esempio seguente put-object 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.

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.

Come disabilitare la registrazione di log su un container

Nell’esempio seguente stop-access-logging 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.

Come aggiungere tag a un container

Nell’esempio seguente tag-resource aggiunge le chiavi e i valori dei 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 di AWS Elemental MediaStore.

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 di AWS Elemental MediaStore.