Exemples d’utilisation de l’AWS CLI avec MediaStore - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec MediaStore

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec MediaStore.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser create-container.

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 Création d’un conteneur dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez CreateContainer dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-container-policy.

AWS CLI

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 MediaStore attribue 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 DeleteContainerPolicy dans la Référence des API AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez DeleteContainerPolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-container.

AWS CLI

Pour supprimer un conteneur

L’exemple 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 Suppression d’un conteneur dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez DeleteContainer dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-cors-policy.

AWS CLI

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, consultez Suppression d’une stratégie CORS dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez DeleteCorsPolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-lifecycle-policy.

AWS CLI

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 Suppression d’une stratégie de cycle de vie des objets dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez DeleteLifecyclePolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-container.

AWS CLI

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 Affichage des détails d’un conteneur dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez DescribeContainer dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-object.

AWS CLI

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

L’exemple describe-object suivant affiche 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 Affichage des détails d’un objet dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez DescribeObject dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-container-policy.

AWS CLI

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 Affichage d’une stratégie de conteneur dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez GetContainerPolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-cors-policy.

AWS CLI

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 Affichage d’une stratégie CORS dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez GetCorsPolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-lifecycle-policy.

AWS CLI

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 Affichage d’une stratégie de cycle de vie des objets dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez GetLifecyclePolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-object.

AWS CLI

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 Télécharger un objet dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez GetObject dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-containers.

AWS CLI

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 Affichage d’une liste des conteneurs dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez ListContainers dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-items.

AWS CLI

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 affiche 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 Affichage d’une liste d’objets dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez ListItems dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-tags-for-resource.

AWS CLI

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 ListTagsForResource dans la Référence des API d’AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez ListTagsForResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser put-container-policy.

AWS CLI

Pour modifier une stratégie 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 Modification d’une stratégie de conteneur dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez PutContainerPolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser put-cors-policy.

AWS CLI

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 Ajout d’une stratégie CORS à un conteneur dans le Guide de l’utilisateur AWS Elemental MediaStore.

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 Modification d’une stratégie CORS dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez PutCorsPolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser put-lifecycle-policy.

AWS CLI

Pour créer une stratégie 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 figurant 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 Ajout d’une stratégie de cycle de vie des objets à un conteneur dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez PutLifecyclePolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser put-object.

AWS CLI

Pour charger un objet

L’exemple put-object suivant charge un objet dans le conteneur spécifié. Vous pouvez spécifier un chemin de dossier où l’objet sera sauvegardé dans le conteneur. Si le dossier existe déjà, AWS Elemental MediaStore stocke l’objet dans le dossier. 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 Chargement d’un objet dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez PutObject dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser start-access-logging.

AWS CLI

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 Activation de la journalisation des accès pour un conteneur dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez StartAccessLogging dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser stop-access-logging.

AWS CLI

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 Désactivation de la journalisation des accès pour un conteneur dans le Guide de l’utilisateur AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez StopAccessLogging dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser tag-resource.

AWS CLI

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 TagResource dans la Référence des API AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez TagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser untag-resource.

AWS CLI

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 UntagResource dans la Référence des API AWS Elemental MediaStore.

  • Pour plus de détails sur l’API, consultez UntagResource dans la Référence des commandes de l’AWS CLI.