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

Exemples d’utilisation de l’AWS CLI avec MediaPackage

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 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 utiliser create-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 Création d’un canal dans le Guide de l’utilisateur AWS Elemental MediaPackage.

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

L’exemple de code suivant montre comment utiliser create-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 Création d’un point de terminaison dans le Guide de l’utilisateur AWS Elemental MediaPackage.

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

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

AWS CLI

Pour supprimer un canal

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 Suppression d’un canal dans le Guide de l’utilisateur AWS Elemental MediaPackage.

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

L’exemple de code suivant montre comment utiliser delete-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 Suppression d’un point de terminaison dans le Guide de l’utilisateur AWS Elemental MediaPackage.

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

L’exemple de code suivant montre comment utiliser describe-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 Affichage des détails du canal<https://docs.aws.amazon.com/mediapackage/latest/ug/channels-view.html> dans le Guide de l’utilisateur AWS Elemental MediaPackage

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

L’exemple de code suivant montre comment utiliser describe-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 Affichage d’un point de terminaison unique dans le Guide de l’utilisateur AWS Elemental MediaPackage.

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

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

AWS CLI

Pour répertorier tous les canaux

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

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 Affichage des détails du canal dans le Guide de l’utilisateur AWS Elemental MediaPackage.

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

L’exemple de code suivant montre comment utiliser list-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 Affichage de tous les points de terminaison associés à un canal dans le Guide de l’utilisateur AWS Elemental MediaPackage.

  • Pour plus de détails sur l’API, consultez ListOriginEndpoints 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 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 Balisage des ressources dans AWS Elemental MediaPackage dans le Guide de l’utilisateur AWS Elemental MediaPackage.

  • 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 rotate-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, consultez Rotation des informations d’identification sur une URL d’entrée dans le Guide de l’utilisateur AWS Elemental MediaPackage.

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

AWS CLI

Ajout d’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 Balisage des ressources dans AWS Elemental MediaPackage dans le Guide de l’utilisateur AWS Elemental MediaPackage.

  • 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 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 Balisage des ressources dans AWS Elemental MediaPackage dans le Guide de l’utilisateur AWS Elemental MediaPackage.

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

L’exemple de code suivant montre comment utiliser update-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 Modification d’un canal dans le Guide de l’utilisateur AWS Elemental MediaPackage.

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

L’exemple de code suivant montre comment utiliser update-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 Modification d’un point de terminaison dans le Guide de l’utilisateur AWS Elemental MediaPackage.

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