MediaPackage exemples utilisant AWS CLI - AWS Exemples de code SDK
Actions

D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples GitHub .

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 façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

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

AWS CLI

Pour créer une chaîne

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

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 create-origin-endpoint commande 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 de 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 delete-channel commande suivante supprime le canal nommétest.

aws mediapackage delete-channel \
    --id test

Cette commande ne produit aucun résultat.

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 delete-origin-endpoint commande 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 une chaîne

La describe-channel commande 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 describe-origin-endpoint commande 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 toutes les chaînes

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 d'origine et de terminaison d'une chaîne

La list-origin-endpoints commande 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 list-tags-for-resource commande suivante répertorie 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'ingestion

La rotate-ingest-endpoint-credentials commande 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

Ajout d’une balise à une ressource

Les tag-resource commandes suivantes ajoutent une paire region=west clé/valeur à 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 aucun résultat.

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 un tag d'une ressource

La untag-resource commande suivante supprime le tag 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 une chaîne

La update-channel commande suivante met à jour le canal nommé sportschannel pour inclure la description24x7 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 update-origin-endpoint commande suivante met à jour le point de terminaison d'origine nommécmaf_sports. Cela change le délai en 0 secondes.

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.