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

Beispiele für die Verwendung der AWS CLI mit MediaConnect

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

AWS CLI

So fügen Sie Ausgaben zu einem Flow hinzu

Im folgenden Beispiel für add-flow-outputs werden Ausgaben zum angegebenen Flow hinzugefügt.

aws mediaconnect add-flow-outputs \
--flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \
--outputs Description='NYC stream',Destination=192.0.2.12,Name=NYC,Port=3333,Protocol=rtp-fec,SmoothingLatency=100 Description='LA stream',Destination=203.0.113.9,Name=LA,Port=4444,Protocol=rtp-fec,SmoothingLatency=100

Ausgabe:

{
    "Outputs": [
        {
            "Port": 3333,
            "OutputArn": "arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC",
            "Name": "NYC",
            "Description": "NYC stream",
            "Destination": "192.0.2.12",
            "Transport": {
                "Protocol": "rtp-fec",
                "SmoothingLatency": 100
            }
        },
        {
            "Port": 4444,
            "OutputArn": "arn:aws:mediaconnect:us-east-1:111122223333:output:2-987655dEF67hiJ89-c34de5fG678h:LA",
            "Name": "LA",
            "Description": "LA stream",
            "Destination": "203.0.113.9",
            "Transport": {
                "Protocol": "rtp-fec",
                "SmoothingLatency": 100
            }
        }
    ],
    "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame"
}

Weitere Informationen finden Sie unter Hinzufügen von Ausgaben zu einem Flow im Benutzerhandbuch zu AWS Elemental MediaConnect.

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

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

AWS CLI

So erstellen Sie einen Flow

Im folgenden Beispiel für create-flow wird ein Flow mit der angegebenen Konfiguration erstellt.

aws mediaconnect create-flow \
    --availability-zone us-west-2c \
    --name ExampleFlow \
    --source Description='Example source, backup',IngestPort=1055,Name=BackupSource,Protocol=rtp,WhitelistCidr=10.24.34.0/23

Ausgabe:

{
    "Flow": {
        "FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:ExampleFlow",
        "AvailabilityZone": "us-west-2c",
        "EgressIp": "54.245.71.21",
        "Source": {
            "IngestPort": 1055,
            "SourceArn": "arn:aws:mediaconnect:us-east-1:123456789012:source:2-3aBC45dEF67hiJ89-c34de5fG678h:BackupSource",
            "Transport": {
                "Protocol": "rtp",
                "MaxBitrate": 80000000
            },
            "Description": "Example source, backup",
            "IngestIp": "54.245.71.21",
            "WhitelistCidr": "10.24.34.0/23",
            "Name": "mySource"
        },
        "Entitlements": [],
        "Name": "ExampleFlow",
        "Outputs": [],
        "Status": "STANDBY",
        "Description": "Example source, backup"
    }
}

Weitere Informationen finden Sie unter Erstellen eines Flows im Benutzerhandbuch zu AWS Elemental MediaConnect.

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

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

AWS CLI

So löschen Sie einen Flow

Im folgenden Beispiel zu delete-flow wird das angegebene Flow-Protokoll gelöscht.

aws mediaconnect delete-flow \
    --flow-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow

Ausgabe:

{
    "FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow",
    "Status": "DELETING"
}

Weitere Informationen finden Sie unter Löschen eines Flows im Benutzerhandbuch zu AWS Elemental MediaConnect.

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

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

AWS CLI

So zeigen Sie die Details eines Flows an

Im folgenden Beispiel für describe-flow werden die Details des angegebenen Flows angezeigt, z. B. ARN, Availability Zone, Status, Quelle, Berechtigungen und Ausgaben.

aws mediaconnect describe-flow \
    --flow-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow

Ausgabe:

{
    "Flow": {
        "EgressIp": "54.201.4.39",
        "AvailabilityZone": "us-west-2c",
        "Status": "ACTIVE",
        "FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow",
        "Entitlements": [
            {
                "EntitlementArn": "arn:aws:mediaconnect:us-west-2:123456789012:entitlement:1-AaBb11CcDd22EeFf-34DE5fG12AbC:MyEntitlement",
                "Description": "Assign to this account",
                "Name": "MyEntitlement",
                "Subscribers": [
                    "444455556666"
                ]
            }
        ],
        "Description": "NYC awards show",
        "Name": "AwardsShow",
        "Outputs": [
            {
                "Port": 2355,
                "Name": "NYC",
                "Transport": {
                    "SmoothingLatency": 0,
                    "Protocol": "rtp-fec"
                },
                "OutputArn": "arn:aws:mediaconnect:us-east-1:123456789012:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC",
                "Destination": "192.0.2.0"
            },
            {
                "Port": 3025,
                "Name": "LA",
                "Transport": {
                    "SmoothingLatency": 0,
                    "Protocol": "rtp-fec"
                },
                "OutputArn": "arn:aws:mediaconnect:us-east-1:123456789012:output:2-987655dEF67hiJ89-c34de5fG678h:LA",
                "Destination": "192.0.2.0"
            }
        ],
        "Source": {
            "IngestIp": "54.201.4.39",
            "SourceArn": "arn:aws:mediaconnect:us-east-1:123456789012:source:3-4aBC56dEF78hiJ90-4de5fG6Hi78Jk:ShowSource",
            "Transport": {
                "MaxBitrate": 80000000,
                "Protocol": "rtp"
            },
            "IngestPort": 1069,
            "Description": "Saturday night show",
            "Name": "ShowSource",
            "WhitelistCidr": "10.24.34.0/23"
        }
    }
}

Weitere Informationen finden Sie unter Anzeigen der Details eines Flows im Benutzerhandbuch zu AWS Elemental MediaConnect.

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

Das folgende Codebeispiel zeigt, wie grant-flow-entitlements verwendet wird.

AWS CLI

So gewähren Sie eine Berechtigung für einen Flow

Im folgenden Beispiel für grant-flow-entitlements wird dem angegebenen vorhandenen Flow die Berechtigung erteilt, Inhalte mit einem anderen AWS-Konto zu teilen.

aws mediaconnect grant-flow-entitlements \
    --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \
    --entitlements Description='For AnyCompany',Encryption={"Algorithm=aes128,KeyType=static-key,RoleArn=arn:aws:iam::111122223333:role/MediaConnect-ASM,SecretArn=arn:aws:secretsmanager:us-west-2:111122223333:secret:mySecret1"},Name=AnyCompany_Entitlement,Subscribers=444455556666 Description='For Example Corp',Name=ExampleCorp,Subscribers=777788889999

Ausgabe:

{
    "Entitlements": [
        {
            "Name": "AnyCompany_Entitlement",
            "EntitlementArn": "arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:AnyCompany_Entitlement",
            "Subscribers": [
                "444455556666"
            ],
            "Description": "For AnyCompany",
            "Encryption": {
                "SecretArn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:mySecret1",
                "Algorithm": "aes128",
                "RoleArn": "arn:aws:iam::111122223333:role/MediaConnect-ASM",
                "KeyType": "static-key"
            }
        },
        {
            "Name": "ExampleCorp",
            "EntitlementArn": "arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-3333cccc4444dddd-1111aaaa2222:ExampleCorp",
            "Subscribers": [
                "777788889999"
            ],
            "Description": "For Example Corp"
        }
    ],
    "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame"
}

Weitere Informationen finden Sie unter Gewährung einer Berechtigung für einen Flow im Benutzerhandbuch zu AWS Elemental MediaConnect.

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

AWS CLI

So zeigen Sie eine Liste von Berechtigungen an

Im folgenden Beispiel für list-entitlements wird eine Liste aller Berechtigungen angezeigt, die dem Konto gewährt wurden.

aws mediaconnect list-entitlements

Ausgabe:

{
    "Entitlements": [
        {
            "EntitlementArn": "arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:MyEntitlement",
            "EntitlementName": "MyEntitlement"
        }
    ]
}

Weitere Informationen finden Sie unter ListEntitlements in der API-Referenz zu AWS Elemental MediaConnect.

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

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

AWS CLI

So zeigen Sie eine Liste von Flows an

Im folgenden Beispiel für list-flows wird eine Liste der Flows angezeigt.

aws mediaconnect list-flows

Ausgabe:

{
    "Flows": [
        {
            "Status": "STANDBY",
            "SourceType": "OWNED",
            "AvailabilityZone": "us-west-2a",
            "Description": "NYC awards show",
            "Name": "AwardsShow",
            "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow"
        },
        {
            "Status": "STANDBY",
            "SourceType": "OWNED",
            "AvailabilityZone": "us-west-2c",
            "Description": "LA basketball game",
            "Name": "BasketballGame",
            "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BasketballGame"
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen einer Liste von Flows im Benutzerhandbuch zu AWS Elemental MediaConnect.

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

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

AWS CLI

So listen Sie Tags für eine MediaConnect-Ressource auf

Im folgenden Beispiel für list-tags-for-resource werden die Tag-Schlüssel und -Werte angezeigt, die der angegebenen MediaConnect-Ressource zugeordnet wurden.

aws mediaconnect list-tags-for-resource \
    --resource-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BasketballGame

Ausgabe:

{
    "Tags": {
        "region": "west",
        "stage": "prod"
    }
}

Weitere Informationen finden Sie unter ListTagsForResource, TagResource, UntagResource in der API-Referenz zu AWS Elemental MediaConnect.

Das folgende Codebeispiel zeigt, wie remove-flow-output verwendet wird.

AWS CLI

So entfernen Sie eine Ausgabe aus einem Flow

Im folgenden Beispiel für remove-flow-output wird eine Ausgabe aus dem angegebenen Flow entfernt.

aws mediaconnect remove-flow-output \
    --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \
    --output-arn arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC

Ausgabe:

{
    "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame",
    "OutputArn": "arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC"
}

Weitere Informationen finden Sie unter Entfernen von Ausgaben aus einem Flow im AWSBenutzerhandbuch zu AWS Elemental MediaConnect.

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

Das folgende Codebeispiel zeigt, wie revoke-flow-entitlement verwendet wird.

AWS CLI

So widerrufen Sie eine Berechtigung

Im folgenden Beispiel für revoke-flow-entitlement wird eine Berechtigung für den angegebenen Flow widerrufen.

aws mediaconnect revoke-flow-entitlement \
    --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \
    --entitlement-arn arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:AnyCompany_Entitlement

Ausgabe:

{
    "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame",
    "EntitlementArn": "arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:AnyCompany_Entitlement"
}

Weitere Informationen finden Sie unter Widerrufen einer Berechtigung im Benutzerhandbuch zu AWS Elemental MediaConnect.

Das folgende Codebeispiel zeigt, wie start-flow verwendet wird.

AWS CLI

So starten Sie einen Flow

Im folgenden Beispiel für start-flow wird der angegebene Flow neu gestartet.

aws mediaconnect start-flow \
    --flow-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe:

{
    "FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow",
    "Status": "STARTING"
}

Weitere Informationen finden Sie unter Starten eines Flows im Benutzerhandbuch zu AWS Elemental MediaConnect.

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

Das folgende Codebeispiel zeigt, wie stop-flow verwendet wird.

AWS CLI

So halten Sie einen Flow an

Im folgenden Beispiel für stop-flow wird der angegebene Flow angehalten.

aws mediaconnect stop-flow \
    --flow-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow

Ausgabe:

{
    "Status": "STOPPING",
    "FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow"
}

Weitere Informationen finden Sie unter Beenden eines Flows im Benutzerhandbuch zu AWS Elemental MediaConnect.

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

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

AWS CLI

So fügen einer MediaConnect-Ressource Tags hinzu

Im folgenden Beispiel für tag-resource wird der MediaConnect-Ressource ein Tag mit einem Schlüsselnamen und -wert hinzugefügt.

aws mediaconnect tag-resource \
    --resource-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BasketballGame
    --tags region=west

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter ListTagsForResource, TagResource, UntagResource in der API-Referenz zu AWS Elemental MediaConnect.

  • 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 aus einer MediaConnect-Ressource

Mit dem folgenden untag-resource-Befehl wird der Tag mit dem angegebenen Schlüsselnamen und dem zugehörigen Wert aus der MediaConnect-Ressource entfernt.

aws mediaconnect untag-resource \
    --resource-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BasketballGame \
    --tag-keys region

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter ListTagsForResource, TagResource, UntagResource in der API-Referenz zu AWS Elemental MediaConnect.

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

Das folgende Codebeispiel zeigt, wie update-flow-entitlement verwendet wird.

AWS CLI

So aktualisieren Sie eine Berechtigung

Im folgenden Beispiel für update-flow-entitlement wird die angegebene Berechtigung mit einer neuen Beschreibung und einem neuen Subscriber aktualisiert.

aws mediaconnect update-flow-entitlement \
    --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \
    --entitlement-arn arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:AnyCompany_Entitlement \
    --description 'For AnyCompany Affiliate' \
    --subscribers 777788889999

Ausgabe:

{
    "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame",
    "Entitlement": {
        "Name": "AnyCompany_Entitlement",
        "Description": "For AnyCompany Affiliate",
        "EntitlementArn": "arn:aws:mediaconnect:us-west-2:111122223333:entitlement:1-11aa22bb11aa22bb-3333cccc4444:AnyCompany_Entitlement",
        "Encryption": {
            "KeyType": "static-key",
            "Algorithm": "aes128",
            "RoleArn": "arn:aws:iam::111122223333:role/MediaConnect-ASM",
            "SecretArn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:mySecret1"
        },
        "Subscribers": [
            "777788889999"
        ]
    }
}

Weitere Informationen finden Sie unter Aktualisieren einer Berechtigung im Benutzerhandbuch zu AWS Elemental MediaConnect.

Das folgende Codebeispiel zeigt, wie update-flow-output verwendet wird.

AWS CLI

So aktualisieren Sie eine Ausgabe in einem Flow

Im folgenden Beispiel für update-flow-output wird eine Ausgabe im angegebenen Flow aktualisiert.

aws mediaconnect update-flow-output \
    --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \
    --output-arn arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC \
    --port 3331

Ausgabe:

{
    "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame",
    "Output": {
        "Name": "NYC",
        "Port": 3331,
        "Description": "NYC stream",
        "Transport": {
            "Protocol": "rtp-fec",
            "SmoothingLatency": 100
        },
        "OutputArn": "arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC",
        "Destination": "192.0.2.12"
    }
}

Weitere Informationen finden Sie unter Aktualisieren von Ausgaben in einem Flow im Benutzerhandbuch zu AWS Elemental MediaConnect.

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

Das folgende Codebeispiel zeigt, wie update-flow-source verwendet wird.

AWS CLI

So aktualisieren Sie die Quelle eines vorhandenen Flows

Im folgenden Beispiel für update-flow-source wird die Quelle eines vorhandenen Flows aktualisiert.

aws mediaconnect update-flow-source \
    --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow \
    --source-arn arn:aws:mediaconnect:us-east-1:111122223333:source:3-4aBC56dEF78hiJ90-4de5fG6Hi78Jk:ShowSource \
    --description 'Friday night show' \
    --ingest-port 3344 \
    --protocol rtp-fec \
    --whitelist-cidr 10.24.34.0/23

Ausgabe:

{
    "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow",
    "Source": {
        "IngestIp": "34.210.136.56",
        "WhitelistCidr": "10.24.34.0/23",
        "Transport": {
            "Protocol": "rtp-fec"
        },
        "IngestPort": 3344,
        "Name": "ShowSource",
        "Description": "Friday night show",
        "SourceArn": "arn:aws:mediaconnect:us-east-1:111122223333:source:3-4aBC56dEF78hiJ90-4de5fG6Hi78Jk:ShowSource"
    }
}

Weitere Informationen finden Sie unter Aktualisieren der Quelle eines Flows im Benutzerhandbuch zu AWS Elemental MediaConnect.

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