MediaPackage exemples utilisant AWS CLI - AWS Command Line Interface
Actions

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

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.

MediaPackage 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 MediaPackage.

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 utilisercreate-channel.

AWS CLI

Pour créer un canal

La commande create-channel suivante crée un canal nommé sportschannel dans le compte actuel.

aws mediapackage create-channel --id sportschannel

Sortie :

{
   "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0",
   "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "6d345804ec3f46c9b454a91d4a80d0e0",
                "Password": "generatedwebdavpassword1",
                "Url": "https://f31c86aed53b815a.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/6d345804ec3f46c9b454a91d4a80d0e0/channel",
                "Username": "generatedwebdavusername1"
            },
            {
                "Id": "2daa32878af24803b24183727211b8ff",
                "Password": "generatedwebdavpassword2",
                "Url": "https://6ebbe7e04c4b0afa.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/2daa32878af24803b24183727211b8ff/channel",
                "Username": "generatedwebdavusername2"
            }
        ]
    },
    "Id": "sportschannel",
    "Tags": {
        "region": "west"
    }
}

Pour plus d'informations, consultez la section Création d'une chaîne dans le guide de l' MediaPackage utilisateur AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous CreateChannelà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-origin-endpoint.

AWS CLI

Pour créer un point de terminaison d’origine

La commande create-origin-endpoint suivante crée un point de terminaison d’origine nommé cmafsports avec les paramètres du package fournis dans un fichier JSON et les paramètres du point de terminaison spécifiés.

aws mediapackage create-origin-endpoint \
    --channel-id sportschannel \
    --id cmafsports \
    --cmaf-package file://file/path/cmafpkg.json --description "cmaf output of sports" \
    --id cmaf_sports \
    --manifest-name sports_channel \
    --startover-window-seconds 300 \
    --tags region=west,media=sports \
    --time-delay-seconds 10

Sortie :

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6",
    "ChannelId": "sportschannel",
    "CmafPackage": {
        "HlsManifests": [
            {
                "AdMarkers": "PASSTHROUGH",
                "Id": "cmaf_sports_endpoint",
                "IncludeIframeOnlyStream": true,
                "ManifestName": "index",
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 300,
                "ProgramDateTimeIntervalSeconds": 300,
                "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8"
            }
        ],
        "SegmentDurationSeconds": 2,
        "SegmentPrefix": "sportschannel"
    },
    "Description": "cmaf output of sports",
    "Id": "cmaf_sports",
    "ManifestName": "sports_channel",
    "StartoverWindowSeconds": 300,
    "Tags": {
        "region": "west",
        "media": "sports"
    },
    "TimeDelaySeconds": 10,
    "Url": "",
    "Whitelist": []
}

Pour plus d'informations, consultez la section Création d'un point de terminaison dans le guide de MediaPackage l'utilisateur AWS élémentaire.

  • Pour plus de détails sur l'API, reportez-vous CreateOriginEndpointà la section Référence des AWS CLI commandes.

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

AWS CLI

Pour supprimer une chaîne

La commande delete-channel suivante supprime un canal nommé test.

aws mediapackage delete-channel \
    --id test

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Suppression d'une chaîne dans le guide de l' MediaPackage utilisateur AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous DeleteChannelà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-origin-endpoint.

AWS CLI

Pour supprimer un point de terminaison d’origine

La commande delete-origin-endpoint suivante supprime le point de terminaison d’origine nommé tester2.

aws mediapackage delete-origin-endpoint \
    --id tester2

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

  • Pour plus de détails sur l'API, reportez-vous DeleteOriginEndpointà la section Référence des AWS CLI commandes.

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

AWS CLI

Pour décrire un canal

La commande describe-channel suivante affiche tous les détails du canal nommé test.

aws mediapackage describe-channel \
    --id test

Sortie :

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63",
    "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "584797f1740548c389a273585dd22a63",
                "Password": "webdavgeneratedpassword1",
                "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel",
                "Username": "webdavgeneratedusername1"
            },
            {
                "Id": "7d187c8616fd455f88aaa5a9fcf74442",
                "Password": "webdavgeneratedpassword2",
                "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel",
                "Username": "webdavgeneratedusername2"
            }
        ]
    },
    "Id": "test",
    "Tags": {}
}

Pour plus d'informations, consultez la section Affichage des détails de la chaîne < https://docs.aws.amazon.com/mediapackage/ latest/ug/channels -view.html> dans le guide de l'utilisateur élémentaire AWS MediaPackage

  • Pour plus de détails sur l'API, reportez-vous DescribeChannelà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-origin-endpoint.

AWS CLI

Pour décrire un point de terminaison d’origine

La commande describe-origin-endpoint suivante affiche tous les détails du point de terminaison d’origine nommé cmaf_sports.

aws mediapackage describe-origin-endpoint \
    --id cmaf_sports

Sortie :

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6",
    "ChannelId": "sportschannel",
    "CmafPackage": {
        "HlsManifests": [
            {
                "AdMarkers": "NONE",
                "Id": "cmaf_sports_endpoint",
                "IncludeIframeOnlyStream": false,
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 60,
                "ProgramDateTimeIntervalSeconds": 0,
                "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8"
            }
        ],
        "SegmentDurationSeconds": 2,
        "SegmentPrefix": "sportschannel"
    },
    "Id": "cmaf_sports",
    "ManifestName": "index",
    "StartoverWindowSeconds": 0,
    "Tags": {
        "region": "west",
        "media": "sports"
    },
    "TimeDelaySeconds": 0,
    "Url": "",
    "Whitelist": []
}

Pour plus d'informations, consultez la section Affichage d'un seul point de terminaison dans le guide de MediaPackage l'utilisateur AWS élémentaire.

  • Pour plus de détails sur l'API, reportez-vous DescribeOriginEndpointà la section Référence des AWS CLI commandes.

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

AWS CLI

Pour répertorier tous les canaux

La list-channels commande suivante répertorie tous les canaux configurés sur le AWS compte courant.

aws mediapackage list-channels

Sortie :

{
    "Channels": [
        {
            "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63",
            "HlsIngest": {
                "IngestEndpoints": [
                    {
                        "Id": "584797f1740548c389a273585dd22a63",
                        "Password": "webdavgeneratedpassword1",
                        "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel",
                        "Username": "webdavgeneratedusername1"
                    },
                    {
                        "Id": "7d187c8616fd455f88aaa5a9fcf74442",
                        "Password": "webdavgeneratedpassword2",
                        "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel",
                        "Username": "webdavgeneratedusername2"
                    }
                ]
            },
            "Id": "test",
            "Tags": {}
        }
    ]
}

Pour plus d'informations, consultez la section Affichage des détails des chaînes dans le guide de l' MediaPackage utilisateur AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous ListChannelsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-origin-endpoints.

AWS CLI

Pour répertorier tous les points de terminaison d’origine d’un canal

La commande list-origin-endpoints suivante répertorie tous les points de terminaison d’origine configurés sur le canal nommé test.

aws mediapackage list-origin-endpoints \
    --channel-id test

Sortie :

{
    "OriginEndpoints": [
        {
            "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/247cff871f2845d3805129be22f2c0a2",
            "ChannelId": "test",
            "DashPackage": {
                "ManifestLayout": "FULL",
                "ManifestWindowSeconds": 60,
                "MinBufferTimeSeconds": 30,
                "MinUpdatePeriodSeconds": 15,
                "PeriodTriggers": [],
                "Profile": "NONE",
                "SegmentDurationSeconds": 2,
                "SegmentTemplateFormat": "NUMBER_WITH_TIMELINE",
                "StreamSelection": {
                    "MaxVideoBitsPerSecond": 2147483647,
                    "MinVideoBitsPerSecond": 0,
                    "StreamOrder": "ORIGINAL"
                },
                "SuggestedPresentationDelaySeconds": 25
            },
            "Id": "tester2",
            "ManifestName": "index",
            "StartoverWindowSeconds": 0,
            "Tags": {},
            "TimeDelaySeconds": 0,
            "Url": "https://8343f7014c0ea438.mediapackage.us-west-2.amazonaws.com/out/v1/247cff871f2845d3805129be22f2c0a2/index.mpd",
            "Whitelist": []
        },
        {
            "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/869e237f851549e9bcf10e3bc2830839",
            "ChannelId": "test",
            "HlsPackage": {
                "AdMarkers": "NONE",
                "IncludeIframeOnlyStream": false,
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 60,
                "ProgramDateTimeIntervalSeconds": 0,
                "SegmentDurationSeconds": 6,
                "StreamSelection": {
                    "MaxVideoBitsPerSecond": 2147483647,
                    "MinVideoBitsPerSecond": 0,
                    "StreamOrder": "ORIGINAL"
                },
                "UseAudioRenditionGroup": false
            },
            "Id": "tester",
            "ManifestName": "index",
            "StartoverWindowSeconds": 0,
            "Tags": {},
            "TimeDelaySeconds": 0,
            "Url": "https://8343f7014c0ea438.mediapackage.us-west-2.amazonaws.com/out/v1/869e237f851549e9bcf10e3bc2830839/index.m3u8",
            "Whitelist": []
        }
    ]
}

Pour plus d'informations, consultez la section Affichage de tous les points de terminaison associés à un canal dans le guide de l' MediaPackage utilisateur AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous ListOriginEndpointsà la 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 attribuées à une ressource

La commande list-tags-for-resource suivante permet de répertorier les balises attribuées à la ressource spécifiée.

aws mediapackage list-tags-for-resource \
    --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0

Sortie :

{
    "Tags": {
        "region": "west"
    }
}

Pour plus d'informations, consultez la section Marquage des ressources dans AWS Elemental MediaPackage dans le guide de l'utilisateur d'AWS Elemental MediaPackage .

  • Pour plus de détails sur l'API, reportez-vous ListTagsForResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserrotate-ingest-endpoint-credentials.

AWS CLI

Pour faire pivoter les informations d’identification d’ingestion

La commande rotate-ingest-endpoint-credentials suivante fait pivoter le nom d’utilisateur et le mot de passe WebDAV pour le point de terminaison d’ingestion spécifié.

aws mediapackage rotate-ingest-endpoint-credentials \
    --id test \
    --ingest-endpoint-id 584797f1740548c389a273585dd22a63

Sortie :

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63",
    "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "584797f1740548c389a273585dd22a63",
                "Password": "webdavregeneratedpassword1",
                "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel",
                "Username": "webdavregeneratedusername1"
            },
            {
                "Id": "7d187c8616fd455f88aaa5a9fcf74442",
                "Password": "webdavgeneratedpassword2",
                "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel",
                "Username": "webdavgeneratedusername2"
            }
        ]
    },
    "Id": "test",
    "Tags": {}
}

Pour plus d'informations, voir Rotation des informations d'identification sur une URL d'entrée dans le Guide de l' MediaPackage utilisateur AWS Elemental.

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

AWS CLI

Pour ajouter une balise à une ressource

Les commandes tag-resource suivantes ajoutent une paire de clé et de valeur region=west à la ressource spécifiée.

aws mediapackage tag-resource \
    --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \
    --tags region=west

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Marquage des ressources dans AWS Elemental MediaPackage dans le guide de l'utilisateur d'AWS Elemental MediaPackage .

  • Pour plus de détails sur l'API, reportez-vous TagResourceà la section Référence des AWS CLI commandes.

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

AWS CLI

Pour supprimer une balise d’une ressource

La commande untag-resource suivante supprime la balise contenant la clé region du canal spécifié.

aws mediapackage untag-resource \
    --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \
    --tag-keys region

Pour plus d'informations, consultez la section Marquage des ressources dans AWS Elemental MediaPackage dans le guide de l'utilisateur d'AWS Elemental MediaPackage .

  • Pour plus de détails sur l'API, reportez-vous UntagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-channel.

AWS CLI

Pour mettre à jour un canal

La commande update-channel suivante met à jour le canal nommé sportschannel pour inclure la description 24x7 sports.

aws mediapackage update-channel \
    --id sportschannel \
    --description "24x7 sports"

Sortie :

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0",
    "Description": "24x7 sports",
    "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "6d345804ec3f46c9b454a91d4a80d0e0",
                "Password": "generatedwebdavpassword1",
                "Url": "https://f31c86aed53b815a.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/6d345804ec3f46c9b454a91d4a80d0e0/channel",
                "Username": "generatedwebdavusername1"
            },
            {
                "Id": "2daa32878af24803b24183727211b8ff",
                "Password": "generatedwebdavpassword2",
                "Url": "https://6ebbe7e04c4b0afa.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/2daa32878af24803b24183727211b8ff/channel",
                "Username": "generatedwebdavusername2"
            }
        ]
    },
    "Id": "sportschannel",
    "Tags": {}
}

Pour plus d'informations, consultez la section Modification d'une chaîne dans le guide de l' MediaPackage utilisateur AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous UpdateChannelà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-origin-endpoint.

AWS CLI

Pour mettre à jour un point de terminaison d’origine

La commande update-origin-endpoint suivante met à jour le point de terminaison d’origine nommé cmaf_sports. Elle modifie le délai en le fixant à 0 seconde.

aws mediapackage update-origin-endpoint \
    --id cmaf_sports \
    --time-delay-seconds 0

Sortie :

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6",
    "ChannelId": "sportschannel",
    "CmafPackage": {
        "HlsManifests": [
            {
                "AdMarkers": "NONE",
                "Id": "cmaf_sports_endpoint",
                "IncludeIframeOnlyStream": false,
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 60,
                "ProgramDateTimeIntervalSeconds": 0,
                "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8"
            }
        ],
        "SegmentDurationSeconds": 2,
        "SegmentPrefix": "sportschannel"
    },
    "Id": "cmaf_sports",
    "ManifestName": "index",
    "StartoverWindowSeconds": 0,
    "Tags": {
        "region": "west",
        "media": "sports"
    },
    "TimeDelaySeconds": 0,
    "Url": "",
    "Whitelist": []
}

Pour plus d'informations, consultez la section Modification d'un point de terminaison dans le guide de MediaPackage l'utilisateur AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous UpdateOriginEndpointà la section Référence des AWS CLI commandes.