MediaStore exemples utilisant AWS CLI

Pour créer un conteneur

L’exemple create-container suivant crée un nouveau conteneur vide.

aws mediastore create-container --container-name ExampleContainer

Sortie :

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

Pour plus d'informations, consultez la section Création d'un conteneur dans le guide de l' MediaStore utilisateur AWS Elemental.

Pour supprimer une politique de conteneur

L’exemple delete-container-policy suivant supprime la politique attribuée au conteneur spécifié. Lorsque la politique est supprimée, AWS Elemental attribue MediaStore automatiquement la politique par défaut au conteneur.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez DeleteContainerPolicyla référence de l' MediaStore API AWS Elemental.

Pour supprimer un conteneur

L’exemple de delete-container suivant supprime le conteneur spécifié. Vous pouvez supprimer un conteneur uniquement s’il ne possède aucun objet.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Suppression d'un conteneur dans le guide de l' MediaStore utilisateur AWS Elemental.

Pour supprimer une stratégie CORS

L’exemple delete-cors-policy suivant supprime la stratégie du partage des ressources cross-origin (CORS) qui est attribuée au conteneur spécifié.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, voir Supprimer une politique CORS dans le Guide de l' MediaStore utilisateur AWS élémentaire.

Pour supprimer une stratégie de cycle de vie des objets

L’exemple delete-lifecycle-policy suivant supprime la stratégie de cycle de vie des objets attachée au conteneur spécifié. La modification peut prendre jusqu’à 20 minutes.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Suppression d'une politique de cycle de vie d'objet dans le Guide de MediaStore l'utilisateur AWS élémentaire.

Pour afficher les détails d’un conteneur

L’exemple describe-container suivant affiche les détails du conteneur spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Affichage des détails d'un conteneur dans le Guide de l' MediaStore utilisateur AWS Elemental.

Pour afficher une liste des objets et dossiers dans un conteneur spécifique

L’exemple describe-object suivant montre comment afficher les éléments (objets et dossiers) stockés dans un conteneur spécifique.

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

Sortie :

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

Pour plus d'informations, consultez la section Affichage des détails d'un objet dans le Guide de l' MediaStore utilisateur AWS Elemental.

Pour afficher une stratégie de conteneur

L’exemple get-container-policy suivant affiche la stratégie basée sur les ressources du conteneur spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Affichage d'une politique de conteneur dans le Guide de MediaStore l'utilisateur AWS élémentaire.

Pour afficher une stratégie CORS

L’exemple get-cors-policy suivant affiche la stratégie du partage des ressources cross-origin (CORS) qui est attribuée au conteneur spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Affichage d'une politique CORS dans le Guide de l' MediaStore utilisateur AWS élémentaire.

Pour afficher une stratégie de cycle de vie des objets

L’exemple get-lifecycle-policy suivant affiche la stratégie de cycle de vie des objets attachée au conteneur spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Affichage d'une politique de cycle de vie d'objet dans le Guide de MediaStore l'utilisateur AWS élémentaire.

Pour télécharger un objet

L’exemple get-object suivant télécharge un objet vers le point de terminaison spécifié.

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

Sortie :

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

Pour télécharger une partie d’un objet

L’exemple get-object suivant télécharge une partie d’un objet vers le point de terminaison spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Téléchargement d'un objet dans le guide de l' MediaStore utilisateur AWS Elemental.

Pour afficher une liste des conteneurs

L’exemple list-containers suivant affiche une liste de tous les conteneurs qui sont associés à votre compte.

aws mediastore list-containers

Sortie :

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

Pour plus d'informations, consultez la section Affichage d'une liste de conteneurs dans le guide de l' MediaStore utilisateur AWS Elemental.

Exemple 1 : pour afficher une liste des objets et dossiers dans un conteneur spécifique

L’exemple list-items suivant affiche les éléments (objets et dossiers) stockés dans le conteneur spécifié.

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

Sortie :

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

Exemple 2 : pour afficher une liste des objets et dossiers dans un dossier spécifique

L’exemple list-items suivant montre comment afficher les éléments (objets et dossiers) stockés dans un dossier spécifique.

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

Sortie :

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

Pour plus d'informations, consultez la section Affichage d'une liste d'objets dans le Guide de l' MediaStore utilisateur AWS Elemental.

Pour répertorier les balises d’un conteneur

L’exemple list-tags-for-resource suivant affiche les clés et les valeurs de balise attribuées au conteneur spécifié.

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

Sortie :

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

Pour plus d'informations, consultez ListTagsForResourcele manuel AWS Elemental MediaStore API Reference.

Pour modifier une politique de conteneur

L’exemple put-container-policy suivant attribue une stratégie différente au conteneur spécifié. Dans cet exemple, la stratégie mise à jour est définie dans un fichier nommé LiveEventsContainerPolicy.json.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Modification d'une politique de conteneur dans le Guide de MediaStore l'utilisateur AWS élémentaire.

Exemple 1 : pour ajouter une stratégie CORS

L’exemple put-cors-policy suivant ajoute une stratégie de partage des ressources cross-origin (CORS) au conteneur spécifié. Le contenu de la stratégie CORS se trouve dans le fichier nommé corsPolicy.json.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Ajout d'une politique CORS à un conteneur dans le Guide de l' MediaStore utilisateur AWS élémentaire.

Exemple 2 : pour modifier une stratégie CORS

L’exemple put-cors-policy suivant met à jour la stratégie de partage des ressources cross-origin (CORS) qui est attribuée au conteneur spécifié. Le contenu de la stratégie CORS à jour se trouve dans le fichier nommé corsPolicy2.json.

Pour plus d'informations, consultez la section Modification d'une politique CORS dans le Guide de l' MediaStore utilisateur AWS élémentaire.

Pour créer une politique de cycle de vie des objets

L’exemple put-lifecycle-policy suivant attache une stratégie de cycle de vie d’objet au conteneur spécifié. Cela vous permet de spécifier la durée pendant laquelle le service doit stocker les objets dans votre conteneur. MediaStore supprime les objets du conteneur une fois qu'ils ont atteint leur date d'expiration, comme indiqué dans la politique, qui figure dans le fichier nomméLiveEventsLifecyclePolicy.json.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Ajout d'une politique de cycle de vie d'objet à un conteneur dans le Guide de MediaStore l'utilisateur AWS élémentaire.

Pour télécharger un objet

L’exemple put-object suivant charge un objet dans le conteneur spécifié. Vous pouvez spécifier un chemin de dossier dans lequel l’objet sera sauvegardé dans le conteneur. Si le dossier existe déjà, AWS Elemental y MediaStore stocke l'objet. Si le dossier n’existe pas, le service le crée, puis stocke l’objet dans le dossier.

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

Sortie :

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

Pour plus d'informations, consultez la section Chargement d'un objet dans le guide de l' MediaStore utilisateur AWS Elemental.

Pour activer la journalisation des accès sur un conteneur

L’exemple start-access-logging suivant active la journalisation des accès sur le conteneur spécifié.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Activation de la journalisation des accès pour un conteneur dans le Guide de MediaStore l'utilisateur AWS élémentaire.

Pour désactiver la journalisation des accès sur un conteneur

L’exemple stop-access-logging suivant désactive la journalisation des accès sur le conteneur spécifié.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Désactivation de la journalisation des accès pour un conteneur dans le Guide de l' MediaStore utilisateur AWS élémentaire.

Pour ajouter des balises à un conteneur

L’exemple tag-resource suivant ajoute des clés et des valeurs de balise au conteneur spécifié.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez TagResourcele manuel AWS Elemental MediaStore API Reference.

Pour supprimer des balises d’un conteneur

L’exemple untag-resource suivant supprime la clé de balise spécifiée et sa valeur associée d’un conteneur.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez UntagResourcele manuel AWS Elemental MediaStore API Reference. .