翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
を使用した Amazon IVSの例 AWS CLI
次のコード例は、Amazon AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示していますIVS。
アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
各例には、完全なソースコードへのリンクが含まれています。このリンクには、コンテキスト内でコードをセットアップして実行する方法の手順が記載されています。
トピック
アクション
次の例は、batch-get-channel
を使用する方法を説明しています。
- AWS CLI
-
複数のチャネルに関するチャネル設定情報を取得するには
次の
batch-get-channel
例では、指定されたチャネルに関する情報を一覧表示します。aws ivs batch-get-channel \ --arns
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
\arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl
出力:
{ "channels": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "authorized": false, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "latencyMode": "LOW", "name": "channel-1", "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel-1.abcdEFGH.m3u8", "preset": "", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "tags": {}, "type": "STANDARD" }, { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl", "authorized": false, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": true, "latencyMode": "LOW", "name": "channel-2", "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel-2.abcdEFGH.m3u8", "preset": "", "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "tags": {}, "type": "STANDARD" } ] }
詳細については、「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。 IVS
-
API 詳細については、「 コマンドリファレンスBatchGetChannel
」の「」を参照してください。 AWS CLI
-
次のコード例は、batch-get-stream-key
を使用する方法を示しています。
- AWS CLI
-
複数のストリームキーに関する情報を取得するには
次の
batch-get-stream-key
例では、指定されたストリームキーに関する情報を取得します。aws ivs batch-get-stream-key \ --arns
arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh
\arn:aws:ivs:us-west-2:123456789012:stream-key/skSKIJKLmnop
出力:
{ "streamKeys": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} }, { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKIJKLmnop", "value": "sk_us-west-2_abcdABCDefgh_567890ghijkl", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } ] }
詳細については、IVS「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。
-
API 詳細については、「 コマンドリファレンスBatchGetStreamKey
」の「」を参照してください。 AWS CLI
-
次の例は、batch-start-viewer-session-revocation
を使用する方法を説明しています。
- AWS CLI
-
複数のチャネルARN ID ペアとビューワー ID ペアのビューワーセッションを取り消すには
次の
batch-start-viewer-session-revocation
例では、複数のチャネルARN ID ペアとビューワー ID ペアでセッション失効を同時に実行します。リクエストは正常に完了しますが、呼び出し元に指定されたセッションを取り消すアクセス許可がない場合、エラーフィールドに値を返します。aws ivs batch-start-viewer-session-revocation \ --viewer-sessions '
[{"channelArn":"arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh1","viewerId":"abcdefg1","viewerSessionVersionsLessThanOrEqualTo":1234567890}, \ {"channelArn":"arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh2","viewerId":"abcdefg2","viewerSessionVersionsLessThanOrEqualTo":1234567890}]
'出力:
{ "errors": [ { "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh1", "viewerId": "abcdefg1", "code": "403", "message": "not authorized", }, { "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh2", "viewerId": "abcdefg2", "code": "403", "message": "not authorized", } ] }
詳細については、「Amazon Interactive Video Service ユーザーガイド」の「プライベートチャネルの設定」を参照してください。
-
API 詳細については、「 コマンドリファレンスBatchStartViewerSessionRevocation
」の「」を参照してください。 AWS CLI
-
次のコード例は、create-channel
を使用する方法を示しています。
- AWS CLI
-
例 1: 録画なしでチャンネルを作成するには
次の
create-channel
例では、ストリーミングを開始するための新しいチャネルと関連付けられたストリームキーを作成します。aws ivs create-channel \ --name
"test-channel"
\ --no-insecure-ingest出力:
{ "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "authorized": false, "name": "test-channel", "latencyMode": "LOW", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "tags": {}, "type": "STANDARD" }, "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } }
詳細については、IVS「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。
例 2: 録画を有効にしてチャンネルを作成するには、そのチャンネルで指定された RecordingConfiguration リソースを使用します。 ARN
次の
create-channel
例では、ストリーミングを開始するための新しいチャンネルと関連付けられたストリームキーを作成し、チャンネルの録画を設定します。aws ivs create-channel \ --name
test-channel-with-recording
\ --insecure-ingest \ --recording-configuration-arn"arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh"
出力:
{ "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "test-channel-with-recording", "latencyMode": "LOW", "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": true, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {}, "type": "STANDARD" }, "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } }
詳細については、IVS「低レイテンシーユーザーガイドAmazon S3 への記録」を参照してください。
例 3: で指定された再生制限ポリシーを持つチャンネルを作成するには ARN
次の
create-channel
例では、ストリーミングを開始するための新しいチャネルと関連するストリームキーを作成し、チャネルの再生制限ポリシーを設定します。aws ivs create-channel \ --name
test-channel-with-playback-restriction-policy
\ --insecure-ingest \ --playback-restriction-policy-arn"arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"
出力:
{ "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "test-channel-with-playback-restriction-policy", "latencyMode": "LOW", "type": "STANDARD", "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2edfGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": true, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {}, "type": "STANDARD" }, "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } }
詳細については、IVS「低レイテンシーユーザーガイド」の「望ましくないコンテンツとビューワー」を参照してください。
-
API 詳細については、「 コマンドリファレンスCreateChannel
」の「」を参照してください。 AWS CLI
-
次の例は、create-playback-restriction-policy
を使用する方法を説明しています。
- AWS CLI
-
再生制限ポリシーを作成するには
次の
create-playback-restriction-policy
例では、新しい再生リスリクションポリシーを作成します。aws ivs create-playback-restriction-policy \ --name
"test-playback-restriction-policy"
\ --enable-strict-origin-enforcement \ --tags"key1=value1, key2=value2"
\ --allowed-countriesUS
MX
\ --allowed-originshttps://www.website1.com
https://www.website2.com
出力:
{ "playbackRestrictionPolicy": { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "allowedCountries": [ "US", "MX" ], "allowedOrigins": [ "https://www.website1.com", "https://www.website2.com" ], "enableStrictOriginEnforcement": true, "name": "test-playback-restriction-policy", "tags": { "key1": "value1", "key2": "value2" } } }
詳細については、IVS「低レイテンシーユーザーガイド」の「望ましくないコンテンツとビューワー」を参照してください。
-
API 詳細については、「 コマンドリファレンスCreatePlaybackRestrictionPolicy
」の「」を参照してください。 AWS CLI
-
次のコード例は、create-recording-configuration
を使用する方法を示しています。
- AWS CLI
-
RecordingConfiguration リソースを作成するには
次の
create-recording-configuration
例では、Amazon S3 への記録を有効にする RecordingConfiguration リソースを作成します。aws ivs create-recording-configuration \ --name
"test-recording-config"
\ --recording-reconnect-window-seconds60
\ --tags"key1=value1, key2=value2"
\ --rendition-configuration renditionSelection="CUSTOM",renditions="HD" \ --thumbnail-configuration recordingMode="INTERVAL",targetIntervalSeconds=1,storage="LATEST",resolution="LOWEST_RESOLUTION" \ --destination-configurations3={bucketName=demo-recording-bucket}
出力:
{ "recordingConfiguration": { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ", "name": "test-recording-config", "destinationConfiguration": { "s3": { "bucketName": "demo-recording-bucket" } }, "state": "CREATING", "tags": { "key1": "value1", "key2": "value2" }, "thumbnailConfiguration": { "recordingMode": "INTERVAL", "targetIntervalSeconds": 1, "resolution": "LOWEST_RESOLUTION", "storage": [ "LATEST" ] }, "recordingReconnectWindowSeconds": 60, "renditionConfiguration": { "renditionSelection": "CUSTOM", "renditions": [ "HD" ] } } }
詳細については、Amazon S3 への録画」を参照してください。
-
API 詳細については、「 コマンドリファレンスCreateRecordingConfiguration
」の「」を参照してください。 AWS CLI
-
次のコード例は、create-stream-key
を使用する方法を示しています。
- AWS CLI
-
ストリームキーを作成するには
次の
create-stream-key
例では、指定された ARN (Amazon リソースネーム) のストリームキーを作成します。aws ivs create-stream-key \ --channel-arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
出力:
{ "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } }
詳細については、IVS「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。
-
API 詳細については、「 コマンドリファレンスCreateStreamKey
」の「」を参照してください。 AWS CLI
-
次のコード例は、delete-channel
を使用する方法を示しています。
- AWS CLI
-
チャネルとそれに関連するストリームキーを削除するには
次の
delete-channel
例では、指定された ARN (Amazon リソースネーム) を持つチャンネルを削除します。aws ivs delete-channel \ --arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
このコマンドでは何も出力されません。
詳細については、「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。 IVS
-
API 詳細については、「 コマンドリファレンスDeleteChannel
」の「」を参照してください。 AWS CLI
-
次の例は、delete-playback-key-pair
を使用する方法を説明しています。
- AWS CLI
-
指定された再生キーペアを削除するには
次の
delete-playback-key-pair
例では、指定されたキーペアのフィンガープリントを返します。aws ivs delete-playback-key-pair \ --arn
arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh
このコマンドでは何も出力されません。
詳細については、「Amazon Interactive Video Service ユーザーガイド」の「プライベートチャネルの設定」を参照してください。
-
API 詳細については、「 コマンドリファレンスDeletePlaybackKeyPair
」の「」を参照してください。 AWS CLI
-
次の例は、delete-playback-restriction-policy
を使用する方法を説明しています。
- AWS CLI
-
再生制限ポリシーを削除するには
次の
delete-playback-restriction-policy
例では、指定されたポリシー ARN (Amazon リソースネーム) を持つ再生リスリクションポリシーを削除します。aws ivs delete-playback-restriction-policy \ --arn
"arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"
このコマンドでは何も出力されません。
詳細については、IVS「低レイテンシーユーザーガイド」の「望ましくないコンテンツとビューワー」を参照してください。
-
API 詳細については、「 コマンドリファレンスDeletePlaybackRestrictionPolicy
」の「」を参照してください。 AWS CLI
-
次の例は、delete-recording-configuration
を使用する方法を説明しています。
- AWS CLI
-
で指定された RecordingConfiguration リソースを削除するには ARN
次の
delete-recording-configuration
例では、指定された を持つ RecordingConfiguration リソースを削除しますARN。aws ivs delete-recording-configuration \ --arn
"arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ"
このコマンドでは何も出力されません。
詳細については、Amazon S3 への録画」を参照してください。
-
API 詳細については、「 コマンドリファレンスDeleteRecordingConfiguration
」の「」を参照してください。 AWS CLI
-
次の例は、delete-stream-key
を使用する方法を説明しています。
- AWS CLI
-
ストリームキーを削除するには
次の
delete-stream-key
例では、指定した ARN (Amazon リソースネーム) のストリームキーを削除するため、ストリーミングに使用することはできません。aws ivs delete-stream-key \ --arn
arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6
このコマンドでは何も出力されません。
詳細については、IVS「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。
-
API 詳細については、「 コマンドリファレンスDeleteStreamKey
」の「」を参照してください。 AWS CLI
-
次の例は、get-channel
を使用する方法を説明しています。
- AWS CLI
-
チャネルの設定情報を取得するには
次の
get-channel
例では、指定されたチャネル ARN (Amazon リソースネーム) のチャネル設定を取得します。aws ivs get-channel \ --arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
出力:
{ "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "channel-1", "latencyMode": "LOW", "type": "STANDARD", "playbackRestrictionPolicyArn": "", "preset": "", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "tags": {} } }
詳細については、IVS「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。
-
API 詳細については、「 コマンドリファレンスGetChannel
」の「」を参照してください。 AWS CLI
-
次の例は、get-playback-key-pair
を使用する方法を説明しています。
- AWS CLI
-
指定された再生キーペアを取得するには
次の
get-playback-key-pair
例では、指定されたキーペアのフィンガープリントを返します。aws ivs get-playback-key-pair \ --arn
arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh
出力:
{ "keyPair": { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh", "name": "my-playback-key", "fingerprint": "0a:1b:2c:ab:cd:ef:34:56:70:b1:b2:71:01:2a:a3:72", "tags": {} } }
詳細については、「Amazon Interactive Video Service ユーザーガイド」の「プライベートチャネルの設定」を参照してください。
-
API 詳細については、「 コマンドリファレンスGetPlaybackKeyPair
」の「」を参照してください。 AWS CLI
-
次の例は、get-playback-restriction-policy
を使用する方法を説明しています。
- AWS CLI
-
再生制限ポリシーの設定情報を取得するには
次の
get-playback-restriction-policy
例では、指定されたポリシー ARN (Amazon リソースネーム) を使用して再生レストリコンポリシー設定を取得します。aws ivs get-playback-restriction-policy \ --arn
"arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"
出力:
{ "playbackRestrictionPolicy": { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "allowedCountries": [ "US", "MX" ], "allowedOrigins": [ "https://www.website1.com", "https://www.website2.com" ], "enableStrictOriginEnforcement": true, "name": "test-playback-restriction-policy", "tags": { "key1": "value1", "key2": "value2" } } }
詳細については、IVS「低レイテンシーユーザーガイド」の「望ましくないコンテンツとビューワー」を参照してください。
-
API 詳細については、「 コマンドリファレンスGetPlaybackRestrictionPolicy
」の「」を参照してください。 AWS CLI
-
次のコード例は、get-recording-configuration
を使用する方法を示しています。
- AWS CLI
-
RecordingConfiguration リソースに関する情報を取得するには
次の
get-recording-configuration
例では、指定された の RecordingConfiguration リソースに関する情報を取得しますARN。aws ivs get-recording-configuration \ --arn
"arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ"
出力:
{ "recordingConfiguration": { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ", "destinationConfiguration": { "s3": { "bucketName": "demo-recording-bucket" } }, "name": "test-recording-config", "recordingReconnectWindowSeconds": 60, "state": "ACTIVE", "tags": { "key1" : "value1", "key2" : "value2" }, "thumbnailConfiguration": { "recordingMode": "INTERVAL", "targetIntervalSeconds": 1, "resolution": "LOWEST_RESOLUTION", "storage": [ "LATEST" ] }, "renditionConfiguration": { "renditionSelection": "CUSTOM", "renditions": [ "HD" ] } } }
詳細については、Amazon S3 への記録」を参照してください。
-
API 詳細については、「 コマンドリファレンスGetRecordingConfiguration
」の「」を参照してください。 AWS CLI
-
次のコード例は、get-stream-key
を使用する方法を示しています。
- AWS CLI
-
ストリームに関する情報を取得するには
次の
get-stream-key
例では、指定されたストリームキーに関する情報を取得します。aws ivs get-stream-key \ --arn
arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh
--region=us-west-2出力:
{ "streamKey": { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh", "value": "sk_us-west-2_abcdABCDefgh_567890abcdef", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } }
詳細については、IVS「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。
-
API 詳細については、「 コマンドリファレンスGetStreamKey
」の「」を参照してください。 AWS CLI
-
次の例は、get-stream-session
を使用する方法を説明しています。
- AWS CLI
-
指定されたストリームのメタデータを取得するには
次の
get-stream-session
例では、指定されたチャネル ARN (Amazon リソースネーム) と指定されたストリームのメタデータ設定を取得します。 が指定され streamId ていない場合、チャネルの最新のストリームが選択されます。aws ivs get-stream-session \ --channel-arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
\ --stream-id"mystream"
出力:
{ "streamSession": { "streamId": "mystream1", "startTime": "2023-06-26T19:09:28+00:00", "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "mychannel", "latencyMode": "LOW", "type": "STANDARD", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "playbackUrl": "url-string", "authorized": false, "insecureIngest": false, "preset": "" }, "ingestConfiguration": { "video": { "avcProfile": "Baseline", "avcLevel": "4.2", "codec": "avc1.42C02A", "encoder": "Lavf58.45.100", "targetBitrate": 8789062, "targetFramerate": 60, "videoHeight": 1080, "videoWidth": 1920 }, "audio": { "codec": "mp4a.40.2", "targetBitrate": 46875, "sampleRate": 8000, "channels": 2 } }, "recordingConfiguration": { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ", "name": "test-recording-config", "destinationConfiguration": { "s3": { "bucketName": "demo-recording-bucket" } }, "state": "ACTIVE", "tags": { "key1": "value1", "key2": "value2" }, "thumbnailConfiguration": { "recordingMode": "INTERVAL", "targetIntervalSeconds": 1, "resolution": "LOWEST_RESOLUTION", "storage": [ "LATEST" ] }, "recordingReconnectWindowSeconds": 60, "renditionConfiguration": { "renditionSelection": "CUSTOM", "renditions": [ "HD" ] } }, "truncatedEvents": [ { "name": "Recording Start", "type": "IVS Recording State Change", "eventTime": "2023-06-26T19:09:35+00:00" }, { "name": "Stream Start", "type": "IVS Stream State Change", "eventTime": "2023-06-26T19:09:34+00:00" }, { "name": "Session Created", "type": "IVS Stream State Change", "eventTime": "2023-06-26T19:09:28+00:00" } ] } }
詳細については、IVS「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。
-
API 詳細については、「 コマンドリファレンスGetStreamSession
」の「」を参照してください。 AWS CLI
-
次のコード例は、get-stream
を使用する方法を示しています。
- AWS CLI
-
ストリームに関する情報を取得するには
次の
get-stream
例では、指定されたチャネルのストリームに関する情報を取得します。aws ivs get-stream \ --channel-arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
出力:
{ "stream": { "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "startTime": "2020-05-05T21:55:38Z", "state": "LIVE", "health": "HEALTHY", "streamId": "st-ABCDEfghij01234KLMN5678", "viewerCount": 1 } }
詳細については、「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。 IVS
-
API 詳細については、「 コマンドリファレンスGetStream
」の「」を参照してください。 AWS CLI
-
次の例は、import-playback-key-pair
を使用する方法を説明しています。
- AWS CLI
-
新しいキーペアのパブリック部分をインポートするには
次の
import-playback-key-pair
例では、指定されたパブリックキー ( PEM 形式の文字列として指定) をインポートし、新しいキーペアの arn とフィンガープリントを返します。aws ivs import-playback-key-pair \ --name
"my-playback-key"
\ --public-key-material"G1lbnQxOTA3BgNVBAMMMFdoeSBhcmUgeW91IGRl..."
出力:
{ "keyPair": { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh", "name": "my-playback-key", "fingerprint": "0a:1b:2c:ab:cd:ef:34:56:70:b1:b2:71:01:2a:a3:72", "tags": {} } }
詳細については、「Amazon Interactive Video Service ユーザーガイド」の「プライベートチャネルの設定」を参照してください。
-
API 詳細については、「 コマンドリファレンスImportPlaybackKeyPair
」の「」を参照してください。 AWS CLI
-
次のコード例は、list-channels
を使用する方法を示しています。
- AWS CLI
-
例 1: すべてのチャネルに関する概要情報を取得するには
次の
list-channels
例では、 AWS アカウントのすべてのチャネルを一覧表示します。aws ivs list-channels
出力:
{ "channels": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "channel-1", "latencyMode": "LOW", "authorized": false, "insecureIngest": false, "preset": "", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh", "tags": {}, "type": "STANDARD" }, { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl", "name": "channel-2", "latencyMode": "LOW", "authorized": false, "preset": "", "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "recordingConfigurationArn": "", "tags": {}, "type": "STANDARD" } ] }
詳細については、IVS「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。
例 2: 指定した でフィルタリングされたすべてのチャネルに関する概要情報を取得するには RecordingConfiguration ARN
次の
list-channels
例では、指定した に関連付けられている AWS アカウントのすべてのチャネルを一覧表示します RecordingConfiguration ARN。aws ivs list-channels \ --filter-by-recording-configuration-arn
"arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh"
出力:
{ "channels": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "channel-1", "latencyMode": "LOW", "authorized": false, "insecureIngest": false, "preset": "", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh", "tags": {}, "type": "STANDARD" } ] }
詳細については、IVS「低レイテンシーユーザーガイドAmazon S3 への記録」を参照してください。
例 3: 指定した でフィルタリングされたすべてのチャネルに関する概要情報を取得するには PlaybackRestrictionPolicy ARN
次の
list-channels
例では、指定した に関連付けられている AWS アカウントのすべてのチャネルを一覧表示します PlaybackRestrictionPolicy ARN。aws ivs list-channels \ --filter-by-playback-restriction-policy-arn
"arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"
出力:
{ "channels": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl", "name": "channel-2", "latencyMode": "LOW", "authorized": false, "preset": "", "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "recordingConfigurationArn": "", "tags": {}, "type": "STANDARD" } ] }
詳細については、IVS「低レイテンシーユーザーガイド」の「望ましくないコンテンツとビューワー」を参照してください。
-
API 詳細については、「 コマンドリファレンスListChannels
」の「」を参照してください。 AWS CLI
-
次の例は、list-playback-key-pairs
を使用する方法を説明しています。
- AWS CLI
-
すべての再生キーペアに関する概要情報を取得するには
次の
list-playback-key-pairs
例では、すべてのキーペアに関する情報を返します。aws ivs list-playback-key-pairs
出力:
{ "keyPairs": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh", "name": "test-key-0", "tags": {} }, { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/ijkl5678mnop", "name": "test-key-1", "tags": {} } ] }
詳細については、「Amazon Interactive Video Service ユーザーガイド」の「プライベートチャネルの設定」を参照してください。
-
API 詳細については、「 コマンドリファレンスListPlaybackKeyPairs
」の「」を参照してください。 AWS CLI
-
次のコード例は、list-playback-restriction-policies
を使用する方法を示しています。
- AWS CLI
-
すべての再生制限ポリシーに関する概要情報を取得するには
次の
list-playback-restriction-policies
例では、 AWS アカウントのすべての再生制限ポリシーを一覧表示します。aws ivs list-playback-restriction-policies
出力:
{ "playbackRestrictionPolicies": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "allowedCountries": [ "US", "MX" ], "allowedOrigins": [ "https://www.website1.com", "https://www.website2.com" ], "enableStrictOriginEnforcement": true, "name": "test-playback-restriction-policy", "tags": { "key1": "value1", "key2": "value2" } } ] }
詳細については、IVS「低レイテンシーユーザーガイド」の「望ましくないコンテンツとビューワー」を参照してください。
-
API 詳細については、「 コマンドリファレンスListPlaybackRestrictionPolicies
」の「」を参照してください。 AWS CLI
-
次のコード例は、list-recording-configurations
を使用する方法を示しています。
- AWS CLI
-
このアカウントで作成されたすべての RecordingConfiguration リソースを一覧表示するには
次の
list-recording-configurations
例では、アカウント内のすべての RecordingConfiguration リソースに関する情報を取得します。aws ivs list-recording-configurations
出力:
{ "recordingConfigurations": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ", "name": "test-recording-config-1", "destinationConfiguration": { "s3": { "bucketName": "demo-recording-bucket-1" } }, "state": "ACTIVE", "tags": {} }, { "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/CD12abcdGHIJ", "name": "test-recording-config-2", "destinationConfiguration": { "s3": { "bucketName": "demo-recording-bucket-2" } }, "state": "ACTIVE", "tags": {} } ] }
詳細については、Amazon S3 への録画」を参照してください。
-
API 詳細については、「 コマンドリファレンスListRecordingConfigurations
」の「」を参照してください。 AWS CLI
-
次のコード例は、list-stream-keys
を使用する方法を示しています。
- AWS CLI
-
ストリームキーのリストを取得するには
次の
list-stream-keys
例では、指定された ARN (Amazon リソースネーム) のすべてのストリームキーを一覧表示します。aws ivs list-stream-keys \ --channel-arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
出力:
{ "streamKeys": [ { "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh", "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "tags": {} } ] }
FFor 詳細については、「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。 IVS
-
API 詳細については、「 コマンドリファレンスListStreamKeys
」の「」を参照してください。 AWS CLI
-
次のコード例は、list-stream-sessions
を使用する方法を示しています。
- AWS CLI
-
現在の AWS リージョンで指定されたチャネルの現在および以前のストリームの概要を取得するには
次の
list-stream-sessions
例では、指定されたチャネル ARN (Amazon リソースネーム) のストリームの概要情報をレポートします。aws ivs list-stream-sessions \ --channel-arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
\ --max-results25
\ --next-token ""出力:
{ "nextToken": "set-2", "streamSessions": [ { "startTime": 1641578182, "endTime": 1641579982, "hasErrorEvent": false, "streamId": "mystream" } ... ] }
詳細については、IVS「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。
-
API 詳細については、「 コマンドリファレンスListStreamSessions
」の「」を参照してください。 AWS CLI
-
次のコード例は、list-streams
を使用する方法を示しています。
- AWS CLI
-
ライブストリームとその状態のリストを取得するには
次の
list-streams
例では、 AWS アカウントのすべてのライブストリームを一覧表示します。aws ivs list-streams
出力:
{ "streams": [ { "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "state": "LIVE", "health": "HEALTHY", "streamId": "st-ABCDEfghij01234KLMN5678", "viewerCount": 1 } ] }
詳細については、「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。 IVS
-
API 詳細については、「 コマンドリファレンスListStreams
」の「」を参照してください。 AWS CLI
-
次のコード例は、list-tags-for-resource
を使用する方法を示しています。
- AWS CLI
-
AWS リソースのすべてのタグを一覧表示するには (チャネル、ストリームキーなど)
次の
list-tags-for-resource
例では、指定されたリソース ARN (Amazon リソースネーム) のすべてのタグを一覧表示します。aws ivs list-tags-for-resource \ --resource-arn
arn:aws:ivs:us-west-2:12345689012:channel/abcdABCDefgh
出力:
{ "tags": { "key1": "value1", "key2": "value2" } }
詳細については、「Amazon Interactive Video Service APIリファレンスhttps://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html」の「タグ付け」を参照してください。
-
API 詳細については、「 コマンドリファレンスListTagsForResource
」の「」を参照してください。 AWS CLI
-
次のコード例は、put-metadata
を使用する方法を示しています。
- AWS CLI
-
指定したチャネルのアクティブなストリームにメタデータを挿入するには
次の
put-metadata
例では、指定されたメタデータを指定されたチャネルのストリームに挿入します。aws ivs put-metadata \ --channel-arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
\ --metadata '{"my": "metadata"}
'このコマンドでは何も出力されません。
詳細については、「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。 IVS
-
API 詳細については、「 コマンドリファレンスPutMetadata
」の「」を参照してください。 AWS CLI
-
次の例は、start-viewer-session-revocation
を使用する方法を説明しています。
- AWS CLI
-
特定の複数のチャネル ID ペアとビューワー ID ARNペアのビューワーセッションを取り消すには
次の
start-viewer-session-revocation
例では、指定したチャネルARNとビューワー ID に関連付けられたビューワーセッションを、指定したセッションバージョン番号まで取り消すプロセスを開始します。バージョンが指定されていない場合、デフォルトは 0 です。aws ivs batch-start-viewer-session-revocation \ --channel-arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
\ --viewer-idabcdefg
\ --viewer-session-versions-less-than-or-equal-to1234567890
このコマンドでは何も出力されません。
詳細については、「Amazon Interactive Video Service ユーザーガイド」の「プライベートチャネルの設定」を参照してください。
-
API 詳細については、「 コマンドリファレンスStartViewerSessionRevocation
」の「」を参照してください。 AWS CLI
-
次のコード例は、stop-stream
を使用する方法を示しています。
- AWS CLI
-
指定されたストリームを停止するには
次の
stop-stream
例では、指定されたチャネルのストリームを停止します。aws ivs stop-stream \ --channel-arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
このコマンドでは何も出力されません。
詳細については、IVS「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。
-
API 詳細については、「 コマンドリファレンスStopStream
」の「」を参照してください。 AWS CLI
-
次のコード例は、tag-resource
を使用する方法を示しています。
- AWS CLI
-
AWS リソースのタグを追加または更新するには (チャネル、ストリームキーなど)
次の
tag-resource
例では、指定されたリソース ARN (Amazon リソースネーム) のタグを追加または更新します。aws ivs tag-resource \ --resource-arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
\ --tags"tagkey1=tagvalue1, tagkey2=tagvalue2"
このコマンドでは何も出力されません。
詳細については、「Amazon Interactive Video Service APIリファレンスhttps://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html」の「タグ付け」を参照してください。
-
API 詳細については、「 コマンドリファレンスTagResource
」の「」を参照してください。 AWS CLI
-
次のコード例は、untag-resource
を使用する方法を示しています。
- AWS CLI
-
AWS リソースのタグを削除するには (チャンネル、ストリームキーなど)
次の
untag-resource
例では、指定されたリソース ARN (Amazon リソースネーム) の指定されたタグを削除します。aws ivs untag-resource \ --resource-arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
\ --tag-keys"tagkey1, tagkey2"
このコマンドでは何も出力されません。
詳細については、「Amazon Interactive Video Service APIリファレンスhttps://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html」の「タグ付け」を参照してください。
-
API 詳細については、「 コマンドリファレンスUntagResource
」の「」を参照してください。 AWS CLI
-
次のコード例は、update-channel
を使用する方法を示しています。
- AWS CLI
-
例 1: チャネルの設定情報を更新するには
次の
update-channel
例では、指定されたチャネルのチャネル設定を更新ARNして、チャネル名を変更します。これは、このチャネルの進行中のストリームには影響しません。変更を有効にするには、ストリームを停止して再起動する必要があります。aws ivs update-channel \ --arn
arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
\ --name"channel-1"
\ --insecure-ingest出力:
{ "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "channel-1", "latencyMode": "LOW", "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": true, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} }
詳細については、IVS「低レイテンシーユーザーガイド」の「チャネルの作成」を参照してください。
例 2: チャネルの設定を更新して記録を有効にするには
次の
update-channel
例では、指定したチャネルのチャネル設定を更新ARNして、録画を有効にします。これは、このチャネルの進行中のストリームには影響しません。変更を有効にするには、ストリームを停止して再起動する必要があります。aws ivs update-channel \ --arn
"arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh"
\ --no-insecure-ingest \ --recording-configuration-arn"arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh"
出力:
{ "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "test-channel-with-recording", "latencyMode": "LOW", "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} } }
詳細については、「低レイテンシーユーザーガイドAmazon S3 への記録」を参照してください。 IVS
例 3: チャネルの設定を更新して記録を無効にするには
次の
update-channel
例では、指定したチャネルのチャネル設定を更新ARNして、録画を無効にします。これは、このチャネルの進行中のストリームには影響しません。変更を有効にするには、ストリームを停止して再起動する必要があります。aws ivs update-channel \ --arn
"arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh"
\ --recording-configuration-arn ""出力:
{ "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "test-channel-with-recording", "latencyMode": "LOW", "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2edfGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} } }
詳細については、「低レイテンシーユーザーガイドAmazon S3 への記録」を参照してください。 IVS
例 4: チャンネルの設定を更新して再生制限を有効にするには
次の
update-channel
例では、指定されたチャネルのチャネル設定を更新ARNして、再生制限ポリシーを適用します。これは、このチャネルの進行中のストリームには影響しません。変更を有効にするには、ストリームを停止して再起動する必要があります。aws ivs update-channel \ --arn
"arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh"
\ --no-insecure-ingest \ --playback-restriction-policy-arn"arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"
出力:
{ "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "test-channel-with-playback-restriction-policy", "latencyMode": "LOW", "type": "STANDARD", "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaCBDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} } }
詳細については、IVS「低レイテンシーユーザーガイド」の「望ましくないコンテンツとビューワー」を参照してください。
例 5: チャンネルの設定を更新して再生制限を無効にするには
次の
update-channel
例では、指定したチャンネルのチャンネル設定を更新ARNして、再生制限を無効にします。これは、このチャネルの進行中のストリームには影響しません。変更を有効にするには、ストリームを停止して再起動する必要があります。aws ivs update-channel \ --arn
"arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh"
\ --playback-restriction-policy-arn ""出力:
{ "channel": { "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh", "name": "test-channel-with-playback-restriction-policy", "latencyMode": "LOW", "type": "STANDARD", "playbackRestrictionPolicyArn": "", "recordingConfigurationArn": "", "srt": { "endpoint": "a1b2c3d4e5f6.srt.live-video.net", "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDeFghh4ijklMN5opqrStuVWxyzAbCDEfghIJ" }, "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net", "insecureIngest": false, "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8", "preset": "", "authorized": false, "tags": {} } }
詳細については、IVS「低レイテンシーユーザーガイド」の「望ましくないコンテンツとビューワー」を参照してください。
-
API 詳細については、「 コマンドリファレンスUpdateChannel
」の「」を参照してください。 AWS CLI
-
次のコード例は、update-playback-restriction-policy
を使用する方法を示しています。
- AWS CLI
-
再生制限ポリシーを更新するには
次の
update-playback-restriction-policy
例では、指定されたポリシーで再生制限ポリシーを更新ARNして、厳密なオリジン適用を無効にします。これは、関連付けられたチャネルの進行中のストリームには影響しません。変更を有効にするには、ストリームを停止して再起動する必要があります。aws ivs update-playback-restriction-policy \ --arn
"arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"
\ --no-enable-strict-origin-enforcement出力:
{ "playbackRestrictionPolicy": { "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ", "allowedCountries": [ "US", "MX" ], "allowedOrigins": [ "https://www.website1.com", "https://www.website2.com" ], "enableStrictOriginEnforcement": false, "name": "test-playback-restriction-policy", "tags": { "key1": "value1", "key2": "value2" } } }
詳細については、IVS「低レイテンシーユーザーガイド」の「望ましくないコンテンツとビューワー」を参照してください。
-
API 詳細については、「 コマンドリファレンスUpdatePlaybackRestrictionPolicy
」の「」を参照してください。 AWS CLI
-