MediaStore exemples utilisant AWS CLI - AWS Command Line Interface
Actions

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

MediaStore exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with 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 montrent comment appeler des fonctions de service individuelles, vous pouvez les visualiser dans leur contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utilisercreate-container.

AWS CLI

Pour créer un conteneur

L'create-containerexemple 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 API plus de détails, voir CreateContainerla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-container-policy.

AWS CLI

Pour supprimer une politique relative aux conteneurs

L'delete-container-policyexemple 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 aucun résultat.

Pour plus d'informations, voir DeleteContainerPolicyla MediaStore APIréférence AWS élémentaire.

L'exemple de code suivant montre comment utiliserdelete-container.

AWS CLI

Pour supprimer un conteneur

L'delete-containerexemple 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 aucun résultat.

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

  • Pour API plus de détails, voir DeleteContainerla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-cors-policy.

AWS CLI

Pour supprimer une CORS politique

L'delete-cors-policyexemple suivant supprime la politique de partage de ressources entre origines (CORS) attribuée au conteneur spécifié.

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

Cette commande ne produit aucun résultat.

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

  • Pour API plus de détails, voir DeleteCorsPolicyla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-lifecycle-policy.

AWS CLI

Pour supprimer une politique de cycle de vie des objets

L'delete-lifecycle-policyexemple suivant supprime la politique de cycle de vie des objets attachée au conteneur spécifié. Cette modification peut prendre jusqu'à 20 minutes pour être prise en compte.

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

Cette commande ne produit aucun résultat.

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.

L'exemple de code suivant montre comment utiliserdescribe-container.

AWS CLI

Pour afficher les détails d'un conteneur

L'describe-containerexemple 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 API plus de détails, voir DescribeContainerla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-object.

AWS CLI

Pour afficher la liste des objets et des dossiers d'un conteneur spécifique

L'describe-objectexemple 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 API plus de détails, voir DescribeObjectla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-container-policy.

AWS CLI

Pour consulter une politique relative aux conteneurs

L'get-container-policyexemple suivant montre la politique 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 API plus de détails, voir GetContainerPolicyla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-cors-policy.

AWS CLI

Pour consulter une CORS politique

L'get-cors-policyexemple suivant montre la politique de partage de ressources entre origines (CORS) 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 CORS politique dans le guide de l' MediaStore utilisateur AWS Elemental.

  • Pour API plus de détails, voir GetCorsPolicyla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-lifecycle-policy.

AWS CLI

Pour consulter la politique de cycle de vie d'un objet

L'get-lifecycle-policyexemple suivant montre la politique 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 API plus de détails, voir GetLifecyclePolicyla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-object.

AWS CLI

Pour télécharger un objet

L'get-objectexemple 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'get-objectexemple 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 API plus de détails, voir GetObjectla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-containers.

AWS CLI

Pour consulter la liste des conteneurs

L'list-containersexemple suivant affiche la liste de tous les conteneurs 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.

  • Pour API plus de détails, voir ListContainersla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-items.

AWS CLI

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

L'list-itemsexemple suivant montre comment afficher 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 d'objets et de dossiers dans un dossier spécifique

L'list-itemsexemple 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 API plus de détails, voir ListItemsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-tags-for-resource.

AWS CLI

Pour répertorier les balises d'un conteneur

L'list-tags-for-resourceexemple suivant affiche les clés de balise et les valeurs 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, reportez-vous ListTagsForResourceà la section MediaStore APIRéférence AWS élémentaire.

  • Pour API plus de détails, voir ListTagsForResourcela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserput-container-policy.

AWS CLI

Pour modifier une politique de conteneur

L'put-container-policyexemple suivant attribue une politique différente au conteneur spécifié. Dans cet exemple, la politique 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 aucun résultat.

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

  • Pour API plus de détails, voir PutContainerPolicyla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserput-cors-policy.

AWS CLI

Exemple 1 : pour ajouter une CORS politique

L'put-cors-policyexemple suivant ajoute une politique de partage de ressources d'origine croisée (CORS) au conteneur spécifié. Le contenu de la CORS politique 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 aucun résultat.

Pour plus d'informations, voir Ajouter une CORS politique à un conteneur dans le Guide de l' MediaStore utilisateur AWS Elemental.

Exemple 2 : pour modifier une CORS politique

L'put-cors-policyexemple suivant met à jour la politique de partage de ressources entre origines (CORS) attribuée au conteneur spécifié. Le contenu de la CORS politique mise à jour se trouve dans le fichier nommécorsPolicy2.json.

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

  • Pour API plus de détails, voir PutCorsPolicyla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserput-lifecycle-policy.

AWS CLI

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

L'put-lifecycle-policyexemple suivant attache une politique de cycle de vie des objets 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 aucun résultat.

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 API plus de détails, voir PutLifecyclePolicyla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserput-object.

AWS CLI

Pour télécharger un objet

L'put-objectexemple suivant télécharge un objet dans le conteneur spécifié. Vous pouvez spécifier le chemin du dossier dans lequel l'objet sera enregistré 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 y stocke l'objet.

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 API plus de détails, voir PutObjectla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstart-access-logging.

AWS CLI

Pour activer la journalisation des accès sur un conteneur

L'start-access-loggingexemple suivant active la journalisation des accès sur le conteneur spécifié.

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

Cette commande ne produit aucun résultat.

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 API plus de détails, voir StartAccessLoggingla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstop-access-logging.

AWS CLI

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

L'stop-access-loggingexemple 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 aucun résultat.

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 API plus de détails, voir StopAccessLoggingla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertag-resource.

AWS CLI

Pour ajouter des balises à un conteneur

L'tag-resourceexemple 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 aucun résultat.

Pour plus d'informations, reportez-vous TagResourceà la section MediaStore APIRéférence AWS élémentaire.

  • Pour API plus de détails, voir TagResourcela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseruntag-resource.

AWS CLI

Pour supprimer des étiquettes d'un conteneur

L'untag-resourceexemple 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 aucun résultat.

Pour plus d'informations, reportez-vous UntagResourceà la section MediaStore APIRéférence AWS élémentaire. .

  • Pour API plus de détails, voir UntagResourcela section Référence des AWS CLI commandes.