Esempi di MediaPackage con AWS CLI

Gli esempi di codice seguenti mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con MediaPackage.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

Operazioni

L’esempio di codice seguente mostra come utilizzare create-channel.

AWS CLI

Come creare un canale

Il comando seguente create-channel crea un canale denominato sportschannel nell’account corrente.


aws mediapackage create-channel --id sportschannel

Output:


{
   "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"
    }
}

Per ulteriori informazioni, consulta Creazione di un canale nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sull’API, consulta CreateChannel in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-origin-endpoint.

AWS CLI

Come creare un endpoint di origine

Il comando seguente create-origin-endpoint crea un endpoint di origine denominato cmafsports con le impostazioni del pacchetto fornite in un file JSON e le impostazioni dell’endpoint specificate.


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

Output:


{
    "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": []
}

Per ulteriori informazioni, consulta Creazione di un endpoint nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sull’API, consulta CreateOriginEndpoint in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-channel.

AWS CLI

Come eliminare un canale

Il comando seguente delete-channel elimina il canale denominato test.


aws mediapackage delete-channel \
    --id test

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Eliminazione di un canale nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sull’API, consulta DeleteChannel in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-origin-endpoint.

AWS CLI

Come eliminare un endpoint di origine

Il comando seguente delete-origin-endpoint elimina l’endpoint di origine denominato tester2.


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

Per ulteriori informazioni, consulta Eliminazione di un endpoint nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sull’API, consulta DeleteOriginEndpoint in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-channel.

AWS CLI

Come descrivere un canale

Il comando seguente describe-channel visualizza tutti i dettagli del canale denominato test.


aws mediapackage describe-channel \
    --id test

Output:


{
    "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": {}
}

Per ulteriori informazioni, consulta Viewing Channel Details<https://docs.aws.amazon.com/mediapackage/latest/ug/channels-view.html> nella Guida per l’utente di AWS Elemental MediaPackage

Per informazioni dettagliate sull’API, consulta DescribeChannel in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-origin-endpoint.

AWS CLI

Come descrivere un endpoint di origine

Il comando seguente describe-origin-endpoint visualizza tutti i dettagli dell’endpoint di origine denominato cmaf_sports.


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

Output:


{
    "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": []
}

Per ulteriori informazioni, consulta Visualizzazione di un singolo endpoint nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sull’API, consulta DescribeOriginEndpoint in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-channels.

AWS CLI

Come elencare tutti i canali

Il comando seguente list-channels elenca tutti i canali configurati nell’account AWS corrente.


aws mediapackage list-channels

Output:


{
    "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": {}
        }
    ]
}

Per ulteriori informazioni, consulta Viewing Channel Details nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sull’API, consulta ListChannels in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-origin-endpoints.

AWS CLI

Come elencare tutti gli endpoint di origine su un canale

Il comando seguente list-origin-endpoints elenca tutti gli endpoint di origine configurati nel canale denominato test.


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

Output:


{
    "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": []
        }
    ]
}

Per ulteriori informazioni, consulta Viewing all Endpoints Associated with a Channel nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sull’API, consulta ListOriginEndpoints in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Come elencare i tag assegnati a una risorsa

Il comando seguente list-tags-for-resource elenca i tag assegnati alla risorsa specificata.


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

Output:


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

Per ulteriori informazioni, consulta Tagging Resources in AWS Elemental MediaPackage nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sull'API, consulta ListTagsForResource nella Documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare rotate-ingest-endpoint-credentials.

AWS CLI

Come ruotare le credenziali di importazione

Il comando seguente rotate-ingest-endpoint-credentials ruota il nome utente e la password WebDAV per l’endpoint di importazione specificato.


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

Output:


{
    "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": {}
}

Per ulteriori informazioni, consulta Rotazione delle credenziali di un URL di input nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sull’API, consulta RotateIngestEndpointCredentials in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

Per aggiungere un tag a una risorsa

I comandi tag-resource seguenti aggiungono una coppia chiave/valore region=west alla risorsa specificata.


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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagging Resources in AWS Elemental MediaPackage nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sulle API, consulta TagResource nel Riferimento ai comandi AWS CLI.

L’esempio di codice seguente mostra come utilizzare untag-resource.

AWS CLI

Come rimuovere un tag da una risorsa

Il comando seguente untag-resource rimuove il tag con la chiave region dal canale specificato.


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

Per ulteriori informazioni, consulta Tagging Resources in AWS Elemental MediaPackage nella Guida per l’utente di AWS Elemental MediaPackage.

Per i dettagli dell'API, consulta UntagResource in Riferimento ai comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare update-channel.

AWS CLI

Come modificare un canale

Il comando seguente update-channel aggiorna il canale denominato sportschannel per includere la descrizione 24x7 sports.


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

Output:


{
    "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": {}
}

Per ulteriori informazioni, consulta Modifica di un canale nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sull’API, consulta UpdateChannel in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-origin-endpoint.

AWS CLI

Come aggiornare un endpoint di origine

Il comando seguente update-origin-endpoint aggiorna l’endpoint di origine denominato cmaf_sports. Cambia il ritardo in 0 secondi.


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

Output:


{
    "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": []
}

Per ulteriori informazioni, consulta Modifica di un endpoint nella Guida per l’utente di AWS Elemental MediaPackage.

Per informazioni dettagliate sull’API, consulta UpdateOriginEndpoint in AWS CLI Command Reference.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

MediaLive

Video on demand (VOD) di MediaPackage