MediaConnect exemples utilisant AWS CLI - AWS Command Line Interface
Actions

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

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 du 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 AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous 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 AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous 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 Suppression d'un flux dans le guide de l' MediaConnect utilisateur AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous 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 AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous 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 donne le droit au flux existant spécifié de 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 AWS élémentaire.

  • Pour plus de détails sur l'API, reportez-vous GrantFlowEntitlementsà la section Référence des AWS CLI commandes.

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 ListEntitlementsle manuel AWS Elemental MediaConnect API Reference.

  • Pour plus de détails sur l'API, reportez-vous 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 AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous 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, voir ListTagsForResource TagResource, UntagResource dans le manuel AWS Elemental MediaConnect API Reference.

  • Pour plus de détails sur l'API, reportez-vous 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 Suppression des sorties d'un flux dans le Guide de MediaConnect l'utilisateur AWS élémentaire.

  • Pour plus de détails sur l'API, reportez-vous 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 AWS Elemental MediaConnect .

  • Pour plus de détails sur l'API, reportez-vous RevokeFlowEntitlementà la section Référence des AWS CLI commandes.

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

  • Pour plus de détails sur l'API, reportez-vous 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 Stopping a Flow dans le Guide de MediaConnect l'utilisateur AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous 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 et une valeur de clé à 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, voir ListTagsForResource TagResource, UntagResource dans le manuel AWS Elemental MediaConnect API Reference.

  • Pour plus de détails sur l'API, reportez-vous 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 portant le nom de clé spécifié et la 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, voir ListTagsForResource TagResource, UntagResource dans le manuel AWS Elemental MediaConnect API Reference.

  • Pour plus de détails sur l'API, reportez-vous 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 Mise à jour d'un droit dans le guide de l' MediaConnect utilisateur AWS Elemental.

  • Pour plus de détails sur l'API, reportez-vous UpdateFlowEntitlementà la section Référence des AWS CLI commandes.

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 Mise à jour des sorties d'un flux dans le Guide de MediaConnect l'utilisateur AWS élémentaire.

  • Pour plus de détails sur l'API, reportez-vous 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 MediaConnect l'utilisateur AWS élémentaire.

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