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

Beispiele für die Verwendung der AWS CLI mit MediaPackage

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit MediaPackage 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-channel verwendet wird.

AWS CLI

So erstellen Sie einen Kanal

Mit dem folgenden create-channel-Befehl wird im aktuellen Konto ein Kanal mit dem Namen sportschannel erstellt.

aws mediapackage create-channel --id sportschannel

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu AWS Elemental MediaPackage.

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

Das folgende Codebeispiel zeigt, wie create-origin-endpoint verwendet wird.

AWS CLI

So erstellen Sie einen Ursprungsendpunkt

Mit dem folgenden create-origin-endpoint Befehl wird ein Ursprungsendpunkt mit dem Namen cmafsports, den in einer JSON-Datei bereitgestellten Paketeinstellungen und den angegebenen Endpunkteinstellungen erstellt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Endpunkts im Benutzerhandbuch zu AWS Elemental MediaPackage.

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

AWS CLI

So löschen Sie einen Kanal

Mit dem folgenden delete-channel-Befehl wird der Kanal mit dem Namen test gelöscht.

aws mediapackage delete-channel \
    --id test

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

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

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

Das folgende Codebeispiel zeigt, wie delete-origin-endpoint verwendet wird.

AWS CLI

So löschen Sie einen Ursprungsendpunkt

Mit dem folgenden Befehl delete-origin-endpoint wird der Ursprungsendpunkt mit dem Namen tester2 gelöscht.

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

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

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

AWS CLI

So beschreiben Sie einen Kanal

Mit dem folgenden describe-channel-Befehl werden alle Details des Kanals mit dem Namen test angezeigt.

aws mediapackage describe-channel \
    --id test

Ausgabe:

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

Weitere Informationen finden Sie unter „Anzeigen der Details eines Kanals“ <https://docs.aws.amazon.com/mediapackage/latest/ug/channels-view.html> im Benutzerhandbuch zu AWS Elemental MediaPackage.

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

Das folgende Codebeispiel zeigt, wie describe-origin-endpoint verwendet wird.

AWS CLI

So beschreiben Sie einen Ursprungsendpunkt

Mit dem folgenden describe-origin-endpoint-Befehl werden alle Details des Ursprungsendpunkts mit dem Namen cmaf_sports angezeigt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Anzeigen eines einzelnen Endpunkts im Benutzerhandbuch zu AWS Elemental MediaPackage.

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

AWS CLI

So listen Sie alle Kanäle auf

Mit dem folgenden list-channels-Befehl werden alle Kanäle aufgelistet, die für das aktuelle AWS-Konto konfiguriert sind.

aws mediapackage list-channels

Ausgabe:

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

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

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

Das folgende Codebeispiel zeigt, wie list-origin-endpoints verwendet wird.

AWS CLI

So listen Sie Ursprungsendpunkte in einem Kanal auf

Mit dem folgenden list-origin-endpoints-Befehl werden alle Ursprungsendpunkte aufgelistet, die für den aktuellen Kanal mit dem Namen test konfiguriert sind.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Anzeigen aller Endpunkt, die einem Kanal zugeordnet sind im Benutzerhandbuch zu AWS Elemental MediaPackage.

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie Tags auf, die einer Ressource zugewiesen sind

Mit dem folgenden list-tags-for-resource-Befehl werden die Tags aufgelistet, die der angegebenen Resource zugeordnet sind.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Markieren von Ressourcen in AWS Elemental MediaPackage im Benutzerhandbuch zu AWS Elemental MediaPackage.

Das folgende Codebeispiel zeigt, wie rotate-ingest-endpoint-credentials verwendet wird.

AWS CLI

So rotieren Sie die Ingest-Anmeldeinformationen

Mit dem folgenden rotate-ingest-endpoint-credentials-Befehl werden der WebDAV-Benutzername und das WebDAV-Kennwort für den angegebenen Ingest-Endpunkt rotiert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Rotieren von Anmeldeinformationen für eine Eingabe-URL im Benutzerhandbuch zu AWS Elemental MediaPackage.

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

So fügen Sie einer Ressource einen Tag hinzu

Mit den folgenden tag-resource-Befehlen wird der angegebenen Ressource ein Schlüssel-Wert-Paar für region=west hinzugefügt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Markieren von Ressourcen in AWS Elemental MediaPackage im Benutzerhandbuch zu AWS Elemental MediaPackage.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie ein Tag aus einer Ressource

Mit dem folgenden untag-resource-Befehl wird das Tag mit dem Schlüssel region aus dem angegebenen Kanal entfernt.

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

Weitere Informationen finden Sie unter Markieren von Ressourcen in AWS Elemental MediaPackage im Benutzerhandbuch zu AWS Elemental MediaPackage.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-channel verwendet wird.

AWS CLI

So aktualisieren Sie einen Kanal

Mit dem folgenden update-channel-Befehl wird der Kanal mit dem Namen sportschannel durch die Beschreibung 24x7 sports aktualisiert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Bearbeiten eines Kanals im Benutzerhandbuch zu AWS Elemental MediaPackage.

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

Das folgende Codebeispiel zeigt, wie update-origin-endpoint verwendet wird.

AWS CLI

So aktualisieren Sie einen Ursprungsendpunkt

Mit dem folgenden update-origin-endpoint-Befehl wird der Ursprungsendpunkt mit dem Namen cmaf_sports aktualisiert. Die Zeitverzögerung wird in 0 Sekunden geändert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Bearbeiten eines Endpunkts im Benutzerhandbuch zu AWS Elemental MediaPackage.