View a markdown version of this page

MediaConnect exemples utilisant AWS CLI - AWS Exemples de code SDK
Actions

D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples GitHub .

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

MediaConnect exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Command Line Interface with 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 utiliseradd-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 la section Ajouter des sorties à un flux dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

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

L'exemple de code suivant montre comment utilisercreate-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 la section Création d'un flux dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

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

L'exemple de code suivant montre comment utiliserdelete-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 la section Supprimer un flux dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

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

L'exemple de code suivant montre comment utiliserdescribe-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 la section Affichage des détails d'un flux dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

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

L'exemple de code suivant montre comment utilisergrant-flow-entitlements.

AWS CLI

Pour octroyer des droits sur un flux

L'grant-flow-entitlementsexemple suivant accorde un droit au flux existant spécifié pour partager votre contenu avec un autre AWS compte.

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 la section Octroi d'un droit sur un flux dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

L'exemple de code suivant montre comment utiliserlist-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 la référence ListEntitlements de l' MediaConnect API AWS Elemental.

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

L'exemple de code suivant montre comment utiliserlist-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 la section Affichage d'une liste de flux dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

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

L'exemple de code suivant montre comment utiliserlist-tags-for-resource.

AWS CLI

Pour répertorier les balises d'une MediaConnect ressource

L'list-tags-for-resourceexemple suivant affiche les clés de balise et les valeurs associées à la MediaConnect ressource 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 de l' MediaConnect API AWS Elemental.

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

L'exemple de code suivant montre comment utiliserremove-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 la section Supprimer des sorties d'un flux dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

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

L'exemple de code suivant montre comment utiliserrevoke-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 la section Révocation d'un droit dans le guide de l'utilisateur d'AWS Elemental. MediaConnect

L'exemple de code suivant montre comment utiliserstart-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 la section Démarrage d'un flux dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

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

L'exemple de code suivant montre comment utiliserstop-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 la section Arrêter un flux dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

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

L'exemple de code suivant montre comment utilisertag-resource.

AWS CLI

Pour ajouter des balises à une MediaConnect ressource

L'tag-resourceexemple suivant ajoute une balise avec un nom de clé et une valeur à la MediaConnect ressource 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 de l' MediaConnect API AWS Elemental.

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

L'exemple de code suivant montre comment utiliseruntag-resource.

AWS CLI

Pour supprimer des balises d'une MediaConnect ressource

L'untag-resourceexemple suivant supprime la balise avec le nom de clé spécifié et sa valeur associée d'une MediaConnect ressource.

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 de l' MediaConnect API AWS Elemental.

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

L'exemple de code suivant montre comment utiliserupdate-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 la section Mettre à jour un droit dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

L'exemple de code suivant montre comment utiliserupdate-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 la section Mettre à jour les sorties d'un flux dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

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

L'exemple de code suivant montre comment utiliserupdate-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 la section Mise à jour de la source d'un flux dans le guide de l' MediaConnect utilisateur d'AWS Elemental.

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