を使用したMediaConnect の例 AWS CLI - AWS SDKコードの例
アクション

Doc AWS SDK ExamplesWord リポジトリには、さらに多くの GitHub の例があります。 AWS SDK

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用したMediaConnect の例 AWS CLI

次のコード例は、 MediaConnect AWS Command Line Interface を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

次の例は、add-flow-outputs を使用する方法を説明しています。

AWS CLI

フローに出力を追加するには

次のadd-flow-outputs例では、指定されたフローに出力を追加します。

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

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「フローへの出力の追加」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のAddFlowOutputs」を参照してください。

次のコード例は、create-flow を使用する方法を示しています。

AWS CLI

フローを作成するには

次のcreate-flow例では、指定された設定でフローを作成します。

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

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「フローの作成」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のCreateFlow」を参照してください。

次の例は、delete-flow を使用する方法を説明しています。

AWS CLI

フローを削除するには

次のdelete-flow例では、指定されたフローを削除します。

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

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「フローの削除」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDeleteFlow」を参照してください。

次の例は、describe-flow を使用する方法を説明しています。

AWS CLI

フローの詳細を表示するには

次のdescribe-flow例では、ARN、アベイラビリティーゾーン、ステータス、ソース、エンタイトルメント、出力など、指定されたフローの詳細を表示します。

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

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「フローの詳細の表示」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeFlow」を参照してください。

次のコード例は、grant-flow-entitlements を使用する方法を示しています。

AWS CLI

フローにエンタイトルメントを付与するには

次のgrant-flow-entitlements例では、指定された既存のフローに、コンテンツを別の 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

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「フローに対するエンタイトルメントの付与」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のGrantFlowEntitlements」を参照してください。

次のコード例は、list-entitlements を使用する方法を示しています。

AWS CLI

エンタイトルメントのリストを表示するには

次のlist-entitlements例では、アカウントに付与されたすべてのエンタイトルメントのリストを表示します。

aws mediaconnect list-entitlements

出力:

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

詳細については、ElementalListEntitlements リファレンスの Word を参照してください。 AWS MediaConnect API

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のListEntitlements」を参照してください。

次のコード例は、list-flows を使用する方法を示しています。

AWS CLI

フローのリストを表示するには

次のlist-flows例では、フローのリストを表示します。

aws mediaconnect list-flows

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「フローのリストの表示」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のListFlows」を参照してください。

次のコード例は、list-tags-for-resource を使用する方法を示しています。

AWS CLI

a MediaConnect リソースのタグを一覧表示するには

次のlist-tags-for-resource例では、指定された MediaConnect リソースに関連付けられたタグキーと値を表示します。

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

出力:

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

詳細については、Elemental TagResourceWord リファレンス UntagResourceの ListTagsForResource、Word、Word を参照してください。 AWS MediaConnect API

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のListTagsForResource」を参照してください。

次のコード例は、remove-flow-output を使用する方法を示しています。

AWS CLI

フローから出力を削除するには

次のremove-flow-output例では、指定されたフローから出力を削除します。

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

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「フローからの出力の削除」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のRemoveFlowOutput」を参照してください。

次のコード例は、revoke-flow-entitlement を使用する方法を示しています。

AWS CLI

エンタイトルメントを取り消すには

次のrevoke-flow-entitlement例では、指定されたフローのエンタイトルメントを取り消します。

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

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「エンタイトルメントの取り消し」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のRevokeFlowEntitlement」を参照してください。

次のコード例は、start-flow を使用する方法を示しています。

AWS CLI

フローを開始するには

次のstart-flow例では、指定されたフローを開始します。

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

このコマンドでは何も出力されません。出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「フローの開始」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のStartFlow」を参照してください。

次のコード例は、stop-flow を使用する方法を示しています。

AWS CLI

フローを停止するには

次のstop-flow例では、指定されたフローを停止します。

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

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「フローの停止」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のStopFlow」を参照してください。

次の例は、tag-resource を使用する方法を説明しています。

AWS CLI

MediaConnect リソースにタグを追加するには

次のtag-resource例では、指定された MediaConnect リソースにキー名と値を持つタグを追加します。

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

このコマンドでは何も出力されません。

詳細については、 TagResource リファレンス UntagResourceの ListTagsForResource、Word、Word を参照してください。 AWS MediaConnect API

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のTagResource」を参照してください。

次の例は、untag-resource を使用する方法を説明しています。

AWS CLI

a MediaConnect リソースからタグを削除するには

次のuntag-resource例では、指定されたキー名と関連付けられた値のタグを a MediaConnect リソースから削除します。

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

このコマンドでは何も出力されません。

詳細については、Elemental TagResource リファレンス UntagResourceの ListTagsForResource、Word、Word を参照してください。 AWS MediaConnect API

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のUntagResource」を参照してください。

次のコード例は、update-flow-entitlement を使用する方法を示しています。

AWS CLI

エンタイトルメントを更新するには

次のupdate-flow-entitlement例では、指定されたエンタイトルメントを新しい説明とサブスクライバーで更新します。

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

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「エンタイトルメントの更新」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のUpdateFlowEntitlement」を参照してください。

次のコード例は、update-flow-output を使用する方法を示しています。

AWS CLI

フローの出力を更新するには

次のupdate-flow-output例では、指定されたフローの出力を更新します。

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

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「フローの出力の更新」を参照してください。

  • API の詳細については、 AWS CLI コマンドリファレンスの UpdateFlowOutput を参照してください。

次のコード例は、update-flow-source を使用する方法を示しています。

AWS CLI

既存のフローのソースを更新するには

次のupdate-flow-source例では、既存のフローのソースを更新します。

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

出力:

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

詳細については、AWS Elemental MediaConnect ユーザーガイドの「フローのソースの更新」を参照してください。

  • API の詳細については、 AWS CLI コマンドリファレンスの UpdateFlowSource を参照してください。