Exemples d’utilisation de l’AWS CLI avec MediaConnect - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec MediaConnect

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec MediaConnect.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser add-flow-outputs.

AWS CLI

Pour ajouter des sorties à un flux

L’exemple add-flow-outputs suivant ajoute des sorties au flux spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Ajout de sorties à un flux dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez AddFlowOutputs dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-flow.

AWS CLI

Pour créer un flux

L’exemple create-flow suivant crée un flux avec la configuration spécifiée.

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

Sortie :

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

Pour plus d’informations, consultez Creating a Flow dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez CreateFlow dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-flow.

AWS CLI

Pour supprimer un flux

L’exemple delete-flow suivant supprime le flux spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Deleting a Flow dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez DeleteFlow dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-flow.

AWS CLI

Pour afficher les détails d’un flux

L’exemple describe-flow suivant affiche des détails sur le flux spécifié, tels que l’ARN, la zone de disponibilité, le statut, la source, les droits d’accès et les sorties.

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

Sortie :

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

Pour plus d’informations, consultez Affichage des détails d’un flux dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez DescribeFlow dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser grant-flow-entitlements.

AWS CLI

Pour octroyer des droits sur un flux

L’exemple grant-flow-entitlements suivant autorise le flux existant spécifié à partager votre contenu avec un autre compte AWS.

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

Sortie :

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

Pour plus d’informations, consultez Octroi d’un droit sur un flux dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez GrantFlowEntitlements dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-entitlements.

AWS CLI

Pour afficher la liste des droits

L’exemple list-entitlements suivant affiche une liste de tous les droits qui ont été octroyés au compte.

aws mediaconnect list-entitlements

Sortie :

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

Pour plus d’informations, consultez ListEntitlements dans la Référence des API d’AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez ListEntitlements dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-flows.

AWS CLI

Pour afficher une liste de flux

L’exemple list-flows suivant affiche une liste de flux.

aws mediaconnect list-flows

Sortie :

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

Pour plus d’informations, consultez Viewing a List of Flows dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez ListFlows dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-tags-for-resource.

AWS CLI

Pour répertorier les balises d’une ressource MediaConnect

L’exemple list-tags-for-resource suivant affiche les clés et les valeurs de balise associées à la ressource MediaConnect spécifiée.

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

Sortie :

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

Pour plus d’informations, consultez ListTagsForResource, TagResource, UntagResource dans la Référence des API d’AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez ListTagsForResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser remove-flow-output.

AWS CLI

Pour supprimer une sortie d’un flux

L’exemple remove-flow-output suivant supprime une sortie du flux spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Removing Outputs from a Flow dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez RemoveFlowOutput dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser revoke-flow-entitlement.

AWS CLI

Pour révoquer un droit

L’exemple revoke-flow-entitlement suivant révoque un droit sur le flux spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Revoking an Entitlement dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez RevokeFlowEntitlement dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser start-flow.

AWS CLI

Pour démarrer un flux

L’exemple start-flow suivant démarre le flux spécifié.

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

Cette commande ne produit aucune sortie. Sortie :

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

Pour plus d’informations, consultez Starting a Flow dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez StartFlow dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser stop-flow.

AWS CLI

Pour arrêter un flux

L’exemple stop-flow suivant arrête le flux spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Stopping a Flow dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez StopFlow dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser tag-resource.

AWS CLI

Pour ajouter des balises à une ressource MediaConnect

L’exemple tag-resource suivant ajoute une balise avec un nom et une valeur de clé à la ressource MediaConnect spécifiée.

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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez ListTagsForResource, TagResource, UntagResource dans la Référence des API d’AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez TagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser untag-resource.

AWS CLI

Pour supprimer des balises d’une ressource MediaConnect

L’exemple untag-resource suivant supprime la balise portant le nom et la valeur de clé spécifiés et sa valeur associée d’une ressource MediaConnect.

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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez ListTagsForResource, TagResource, UntagResource dans la Référence des API d’AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez UntagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-flow-entitlement.

AWS CLI

Pour mettre à jour un droit

L’exemple update-flow-entitlement suivant met à jour le droit spécifié avec une nouvelle description et un nouvel abonné.

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

Sortie :

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

Pour plus d’informations, consultez Updating an Entitlement dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez UpdateFlowEntitlement dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-flow-output.

AWS CLI

Pour mettre à jour une sortie sur un flux

L’exemple update-flow-output suivant met à jour une sortie sur le flux spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Updating Outputs on a Flow dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez UpdateFlowOutput dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-flow-source.

AWS CLI

Pour mettre à jour la source d’un flux existant

L’exemple update-flow-source suivant met à jour la source d’un flux existant.

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

Sortie :

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

Pour plus d’informations, consultez Updating the Source of a Flow dans le Guide de l’utilisateur AWS Elemental MediaConnect.

  • Pour plus de détails sur l’API, consultez UpdateFlowSource dans la Référence des commandes de l’AWS CLI.