Beispiele für die Verwendung der AWS CLI mit MediaPackage VOD - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung der AWS CLI mit MediaPackage VOD

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit MediaPackage VOD nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie create-asset verwendet wird.

AWS CLI

So erstellen Sie eine Komponente

Im folgenden Beispiel für create-asset wird im aktuellen AWS-Konto eine Komponente mit dem Namen Chicken_Asset erstellt. Die Komponente nimmt die Datei 30sec_chicken.smil in MediaPackage auf.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Aufnehmen eines Assets im Benutzerhandbuch zu AWS Elemental MediaPackage.

  • Weitere Details zur API finden Sie unter CreateAsset in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-packaging-configuration verwendet wird.

AWS CLI

So erstellen Sie eine Packaging-Konfiguration

Im folgenden Beispiel für create-packaging-configuration wird eine Packaging-Konfigurationen mit dem Namen new_hls in der angegebenen Packaging-Gruppe hls_chicken erstellt. In diesem Beispiel wird eine Datei auf der Festplatte mit dem Namen hls_pc.json verwendet, um die Details bereitzustellen.

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

Inhalt von 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
}

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen einer Packaging-Konfiguration im Benutzerhandbuch zu AWS Elemental MediaPackage.

Das folgende Codebeispiel zeigt, wie create-packaging-group verwendet wird.

AWS CLI

So erstellen Sie eine Packaging-Gruppe

Im folgenden Beispiel für create-packaging-group werden alle Packaging-Gruppen aufgelistet, die im aktuellen AWS-Konto konfiguriert sind.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen einer Packaging-Gruppe im Benutzerhandbuch zu AWS Elemental MediaPackage.

Das folgende Codebeispiel zeigt, wie delete-asset verwendet wird.

AWS CLI

So löschen Sie ein Asset

Im folgenden Beispiel für delete-asset wird das Asset mit dem Namen 30sec_chicken gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen eines Assets im Benutzerhandbuch zu AWS Elemental MediaPackage.

  • Weitere Details zur API finden Sie unter DeleteAsset in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-packaging-configuration verwendet wird.

AWS CLI

So löschen Sie eine Packaging-Konfigurationen

Im folgenden Beispiel für delete-packaging-configuration wird die Packaging-Konfiguration mit dem Namen CMAF gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen einer Packaging-Konfiguration im Benutzerhandbuch zu AWS Elemental MediaPackage.

Das folgende Codebeispiel zeigt, wie delete-packaging-group verwendet wird.

AWS CLI

So löschen Sie eine Packaging-Gruppe

Im folgenden Beispiel für delete-packaging-group wird die Packaging-Gruppe mit dem Namen Dash_widevine gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen einer Packaging-Gruppe im Benutzerhandbuch zu AWS Elemental MediaPackage.

Das folgende Codebeispiel zeigt, wie describe-asset verwendet wird.

AWS CLI

So beschreiben Sie ein Asset

Im folgenden Beispiel für describe-asset werden alle Details des Assets mit dem Namen 30sec_chicken angezeigt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Anzeigen der Details eines Assets im Benutzerhandbuch zu AWS Elemental MediaPackage.

  • Weitere Details zur API finden Sie unter DescribeAsset in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-packaging-configuration verwendet wird.

AWS CLI

So beschreiben Sie eine Packaging-Konfiguration

Im folgenden Beispiel für describe-packaging-configuration werden alle Details der Packaging-Konfiguration mit dem Namen DASH angezeigt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Anzeigen der Details einer Packaging-Konfiguration im Benutzerhandbuch zu AWS Elemental MediaPackage.

Das folgende Codebeispiel zeigt, wie describe-packaging-group verwendet wird.

AWS CLI

So beschreiben Sie eine Packaging-Gruppe

Im folgenden Beispiel für describe-packaging-group werden alle Details der Packaging-Gruppe mit dem Namen Packaging_group_1 angezeigt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Anzeigen der Details einer Packaging-Gruppe im Benutzerhandbuch zu AWS Elemental MediaPackage.

Das folgende Codebeispiel zeigt, wie list-assets verwendet wird.

AWS CLI

So listen Sie alle Assets auf

Im folgenden Beispiel für list-assets werden alle Assets aufgelistet, die im aktuellen AWS-Konto konfiguriert sind.

aws mediapackage-vod list-assets

Ausgabe:

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

Weitere Informationen finden Sie unter Anzeigen der Details eines Assets im Benutzerhandbuch zu AWS Elemental MediaPackage.

  • Weitere Details zur API finden Sie unter ListAssets in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-packaging-configurations verwendet wird.

AWS CLI

So listen Sie alle Packaging-Konfigurationen auf

Im folgenden Beispiel für list-packaging-configurations werden alle Packaging-Konfigurationen aufgelistet, die in der aktuellen Packaging-Gruppe mit dem Namen Packaging_group_1 konfiguriert sind.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Anzeigen der Details einer Packaging-Konfiguration im Benutzerhandbuch zu AWS Elemental MediaPackage.

Das folgende Codebeispiel zeigt, wie list-packaging-groups verwendet wird.

AWS CLI

So listen Sie alle Packaging-Gruppen auf

Im folgenden Beispiel für list-packaging-groups werden alle Packaging-Gruppen aufgelistet, die im aktuellen AWS-Konto konfiguriert sind.

aws mediapackage-vod list-packaging-groups

Ausgabe:

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

Weitere Informationen finden Sie unter Anzeigen der Details einer Packaging-Konfiguration im Benutzerhandbuch zu AWS Elemental MediaPackage.