MediaPackage Beispiele mit AWS CLI - AWS Command Line Interface
Aktionen

Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von. Dokumentation zu Version 2 von finden Sie im Benutzerhandbuch für Version 2. AWS CLI

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

MediaPackage Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren MediaPackage.

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 Siecreate-channel.

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 Einen Kanal erstellen im AWS MediaPackage Elemental-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie CreateChannelin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-origin-endpoint.

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 AWS Elemental MediaPackage User Guide.

Das folgende Codebeispiel zeigt die Verwendungdelete-channel.

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 AWS MediaPackage Elemental-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie DeleteChannelin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-origin-endpoint.

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 AWS Elemental MediaPackage User Guide.

Das folgende Codebeispiel zeigt die Verwendungdescribe-channel.

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 Kanaldetails anzeigen< https://docs.aws.amazon.com/mediapackage/ latest/ug/channels -view.html> im Elemental User Guide AWS MediaPackage

  • Einzelheiten zur API finden Sie in der Befehlsreferenz. DescribeChannelAWS CLI

Das folgende Codebeispiel zeigt die Verwendungdescribe-origin-endpoint.

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 AWS Elemental MediaPackage User Guide.

Das folgende Codebeispiel zeigt die Verwendunglist-channels.

AWS CLI

So listen Sie alle Kanäle auf

Der folgende list-channels Befehl listet alle Kanäle auf, 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 Kanaldetails anzeigen im AWS Elemental MediaPackage User Guide.

  • Einzelheiten zur API finden Sie ListChannelsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-origin-endpoints.

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 im AWS Elemental MediaPackage User Guide unter Alle Endpoints anzeigen, die einem Channel zugeordnet sind.

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

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 Tagging Resources in AWS Elemental MediaPackage im AWS Elemental User Guide MediaPackage .

Das folgende Codebeispiel zeigt die Verwendungrotate-ingest-endpoint-credentials.

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 Rotation von Anmeldeinformationen auf einer Eingabe-URL im AWS Elemental MediaPackage User Guide.

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

So fügen Sie einer Ressource ein 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 Tagging Resources in AWS Elemental MediaPackage im AWS Elemental User Guide MediaPackage .

  • Einzelheiten zur API finden Sie TagResourcein AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

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 Tagging Resources in AWS Elemental MediaPackage im AWS Elemental User Guide MediaPackage .

  • Einzelheiten zur API finden Sie UntagResourcein AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-channel.

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 AWS MediaPackage Elemental-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie UpdateChannelin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-origin-endpoint.

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 AWS Elemental MediaPackage User Guide.