Esempi per i video on demand (VOD) di MediaPackage con AWS CLI - AWS Command Line Interface
Operazioni

Esempi per i video on demand (VOD) di MediaPackage con AWS CLI

Gli esempi di codice seguenti mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con i video on demand (VOD) di 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

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

AWS CLI

Come creare un asset

Il comando seguente create-asset crea un asset denominato Chicken_Asset nell’account AWScorrente. L’asset inserisce il file 30sec_chicken.smil in MediaPackage.

aws mediapackage-vod create-asset \
    --id chicken_asset \
    --packaging-group-id hls_chicken_gp \
    --source-role-arn arn:aws:iam::111122223333:role/EMP_Vod \
    --source-arn arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil

Output:

{
    "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:assets/chicken_asset",
    "Id":"chicken_asset",
    "PackagingGroupId":"hls_chicken_gp",
    "SourceArn":"arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil",
    "SourceRoleArn":"arn:aws:iam::111122223333:role/EMP_Vod",
    "EgressEndpoints":[
        {
            "PackagingConfigurationId":"New_config_1",
            "Url":"https://c75ea2668ab49d02bca7ae10ef31c59e.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/6644b55df1744261ab3732a8e5cdaf07/904b06a58c7645e08d57d40d064216ac/f5b2e633ff4942228095d164c10074f3/index.m3u8"
        },
        {
            "PackagingConfigurationId":"new_hls",
            "Url":" https://c75ea2668ab49d02bca7ae10ef31c59e.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/6644b55df1744261ab3732a8e5cdaf07/fe8f1f00a80e424cb4f8da4095835e9e/7370ec57432343af816332356d2bd5c6/string.m3u8"
        }
    ]
}

Per ulteriori informazioni, consulta Ingest an Asset nella Guida per l’utente di AWS Elemental MediaPackage.

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

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

AWS CLI

Come creare una configurazione di creazione pacchetti

Nell’esempio seguente create-packaging-configuration crea una configurazione di creazione pacchetti denominata new_hls nel gruppo di pacchetti denominato hls_chicken. Questo esempio utilizza un file su disco denominato hls_pc.json per fornire i dettagli.

aws mediapackage-vod create-packaging-configuration \
    --id new_hls \
    --packaging-group-id hls_chicken \
    --hls-package file://hls_pc.json

Contenuto di hls_pc.json.

{
    "HlsManifests":[
        {
            "AdMarkers":"NONE",
            "IncludeIframeOnlyStream":false,
            "ManifestName":"string",
            "ProgramDateTimeIntervalSeconds":60,
            "RepeatExtXKey":true,
            "StreamSelection":{
                "MaxVideoBitsPerSecond":1000,
                "MinVideoBitsPerSecond":0,
                "StreamOrder":"ORIGINAL"
            }
        }
    ],
    "SegmentDurationSeconds":6,
    "UseAudioRenditionGroup":false
}

Output:

{
    "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/new_hls",
    "Id":"new_hls",
    "PackagingGroupId":"hls_chicken",
    "HlsManifests":{
        "SegmentDurationSeconds":6,
        "UseAudioRenditionGroup":false,
        "HlsMarkers":[
            {
                "AdMarkers":"NONE",
                "IncludeIframeOnlyStream":false,
                "ManifestName":"string",
                "ProgramDateTimeIntervalSeconds":60,
                "RepeatExtXKey":true,
                "StreamSelection":{
                    "MaxVideoBitsPerSecond":1000,
                    "MinVideoBitsPerSecond":0,
                    "StreamOrder":"ORIGINAL"
                }
            }
        ]
    }
}

Per ulteriori informazioni, consulta Creazione di una configurazione di creazione pacchetti nella Guida per l’utente di AWS Elemental MediaPackage.

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

AWS CLI

Come creare un gruppo di creazione pacchetti

Nell’esempio seguente create-packaging-group elenca tutti i gruppi di pacchetti configurati nell’account AWS corrente.

aws mediapackage-vod create-packaging-group \
    --id hls_chicken

Output:

{
    "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/hls_chicken",
    "Id": "hls_chicken"
}

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

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

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

AWS CLI

Come eliminare un asset

L’esempio delete-asset seguente elimina l’asset denominato 30sec_chicken.

aws mediapackage-vod delete-asset \
    --id 30sec_chicken

Questo comando non produce alcun output.

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

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

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

AWS CLI

Come eliminare una configurazione di creazione pacchetti

Nell’esempio seguente delete-packaging-configuration elimina la configurazione di creazione dei pacchetti denominata CMAF.

aws mediapackage-vod delete-packaging-configuration \
    --id CMAF

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Eliminazione di una configurazione di creazione pacchetti nella Guida per l’utente di AWS Elemental MediaPackage.

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

AWS CLI

Come eliminare un gruppo di creazione pacchetti

Nell’esempio seguente delete-packaging-group elimina il gruppo di creazione dei pacchetti denominato Dash_widevine.

aws mediapackage-vod delete-packaging-group \
    --id Dash_widevine

Questo comando non produce alcun output.

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

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

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

AWS CLI

Come descrivere un asset

Nell’esempio seguente describe-asset mostra tutti i dettagli dell’asset denominato 30sec_chicken.

aws mediapackage-vod describe-asset \
    --id 30sec_chicken

Output:

{
    "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:assets/30sec_chicken",
    "Id":"30sec_chicken",
    "PackagingGroupId":"Packaging_group_1",
    "SourceArn":"arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil",
    "SourceRoleArn":"arn:aws:iam::111122223333:role/EMP_Vod",
    "EgressEndpoints":[
        {
            "PackagingConfigurationId":"DASH",
            "Url":"https://a5f46a44118ba3e3724ef39ef532e701.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/aad7962c569946119c2d5a691be5663c/66c25aff456d463aae0855172b3beb27/4ddfda6da17c4c279a1b8401cba31892/index.mpd"
        },
        {
            "PackagingConfigurationId":"HLS",
            "Url":"https://a5f46a44118ba3e3724ef39ef532e701.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/aad7962c569946119c2d5a691be5663c/6e5bf286a3414254a2bf0d22ae148d7e/06b5875b4d004c3cbdc4da2dc4d14638/index.m3u8"
        },
        {
            "PackagingConfigurationId":"CMAF",
            "Url":"https://a5f46a44118ba3e3724ef39ef532e701.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/aad7962c569946119c2d5a691be5663c/628fb5d8d89e4702958b020af27fde0e/05eb062214064238ad6330a443aff7f7/index.m3u8"
        }
    ]
}

Per ulteriori informazioni, consulta Visualizzazione dei dettagli asset nella Guida per l’utente di AWS Elemental MediaPackage.

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

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

AWS CLI

Come descrivere una configurazione di creazione pacchetti

Nell’esempio seguente describe-packaging-configuration visualizza tutti i dettagli della configurazione di creazione dei pacchetti denominata DASH.

aws mediapackage-vod describe-packaging-configuration \
    --id DASH

Output:

{
    "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/DASH",
    "Id":"DASH",
    "PackagingGroupId":"Packaging_group_1",
    "DashPackage":[
        {
            "SegmentDurationSeconds":"2"
        },
        {
            "DashManifests":{
                "ManifestName":"index",
                "MinBufferTimeSeconds":"30",
                "Profile":"NONE"
            }
        }
    ]
}

Per ulteriori informazioni, consulta Visualizzazione dei dettagli della configurazione di creazione pacchetti nella Guida per l’utente di AWS Elemental MediaPackage.

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

AWS CLI

Come descrivere un gruppo di creazione dei pacchetti

Nell’esempio seguente describe-packaging-group visualizza tutti i dettagli del gruppo di creazione pacchetti denominato Packaging_group_1.

aws mediapackage-vod describe-packaging-group \
    --id Packaging_group_1

Output:

{
    "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Packaging_group_1",
    "Id": "Packaging_group_1"
}

Per ulteriori informazioni, consulta Visualizzazione dei dettagli del gruppo di creazione pacchetti nella Guida per l’utente di AWS Elemental MediaPackage.

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

AWS CLI

Come elencare tutti gli asset

Nell’esempio seguente list-assets elenca tutti i gruppi di asset configurati nell’account AWS corrente.

aws mediapackage-vod list-assets

Output:

{
    "Assets": [
        "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:assets/30sec_chicken",
        "Id": "30sec_chicken",
        "PackagingGroupId": "Packaging_group_1",
        "SourceArn": "arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil",
        "SourceRoleArn": "arn:aws:iam::111122223333:role/EMP_Vod"
    ]
}

Per ulteriori informazioni, consulta Visualizzazione dei dettagli asset nella Guida per l’utente di AWS Elemental MediaPackage.

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

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

AWS CLI

Come elencare tutte le configurazioni di creazione pacchetti

Nell’esempio seguente list-packaging-configurations elenca tutte le configurazioni di creazione pacchetti configurate nel gruppo di creazione pacchetti denominato Packaging_group_1.

aws mediapackage-vod list-packaging-configurations \
    --packaging-group-id Packaging_group_1

Output:

{
    "PackagingConfigurations":[
        {
            "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/CMAF",
            "Id":"CMAF",
            "PackagingGroupId":"Packaging_group_1",
            "CmafPackage":[
                {
                    "SegmentDurationSeconds":"2"
                },
                {
                    "HlsManifests":{
                        "AdMarkers":"NONE",
                        "RepeatExtXKey":"False",
                        "ManifestName":"index",
                        "ProgramDateTimeIntervalSeconds":"0",
                        "IncludeIframeOnlyStream":"False"
                    }
                }
            ]
        },
        {
            "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/DASH",
            "Id":"DASH",
            "PackagingGroupId":"Packaging_group_1",
            "DashPackage":[
                {
                    "SegmentDurationSeconds":"2"
                },
                {
                    "DashManifests":{
                        "ManifestName":"index",
                        "MinBufferTimeSeconds":"30",
                        "Profile":"NONE"
                    }
                }
            ]
        },
        {
            "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/HLS",
            "Id":"HLS",
            "PackagingGroupId":"Packaging_group_1",
            "HlsPackage":[
                {
                    "SegmentDurationSeconds":"6",
                    "UseAudioRenditionGroup":"False"
                },
                {
                    "HlsManifests":{
                        "AdMarkers":"NONE",
                        "RepeatExtXKey":"False",
                        "ManifestName":"index",
                        "ProgramDateTimeIntervalSeconds":"0",
                        "IncludeIframeOnlyStream":"False"
                    }
                }
            ]
        },
        {
            "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/New_config_0_copy",
            "Id":"New_config_0_copy",
            "PackagingGroupId":"Packaging_group_1",
            "HlsPackage":[
                {
                    "SegmentDurationSeconds":"6",
                    "UseAudioRenditionGroup":"False"
                },
                {
                    "Encryption":{
                        "EncryptionMethod":"AWS_128",
                        "SpekeKeyProvider":{
                           "RoleArn":"arn:aws:iam:111122223333::role/SPEKERole",
                            "Url":"https://lfgubdvs97.execute-api.us-west-2.amazonaws.com/EkeStage/copyProtection/",
                            "SystemIds":[
                                "81376844-f976-481e-a84e-cc25d39b0b33"
                            ]
                        }
                    }
                },
                {
                    "HlsManifests":{
                        "AdMarkers":"NONE",
                        "RepeatExtXKey":"False",
                        "ManifestName":"index",
                        "ProgramDateTimeIntervalSeconds":"0",
                        "IncludeIframeOnlyStream":"False"
                    }
                }
            ]
        }
    ]
}

Per ulteriori informazioni, consulta Visualizzazione dei dettagli della configurazione di creazione pacchetti nella Guida per l’utente di AWS Elemental MediaPackage.

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

AWS CLI

Come elencare tutti i gruppi di creazione pacchetti

Nell’esempio seguente list-packaging-groups elenca tutti i gruppi di pacchetti configurati nell’account AWS corrente.

aws mediapackage-vod list-packaging-groups

Output:

{
    "PackagingGroups": [
        {
            "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Dash_widevine",
            "Id": "Dash_widevine"
        },
        {
            "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Encrypted_HLS",
            "Id": "Encrypted_HLS"
        },
        {
            "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Packaging_group_1",
            "Id": "Packaging_group_1"
        }
    ]
}

Per ulteriori informazioni, consulta Visualizzazione dei dettagli del gruppo di creazione pacchetti nella Guida per l’utente di AWS Elemental MediaPackage.

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