View a markdown version of this page

Contoh Amazon IVS menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh Amazon IVS menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface dengan Amazon IVS.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanbatch-get-channel.

AWS CLI

Untuk mendapatkan informasi konfigurasi saluran tentang beberapa saluran

batch-get-channelContoh berikut mencantumkan informasi tentang saluran yang ditentukan.

aws ivs batch-get-channel \
    --arns arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
        arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl

Output:

{
    "channels": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "authorized": false,
            "containerFormat": "TS",
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "insecureIngest": false,
            "latencyMode": "LOW",
            "multitrackInputConfiguration": {
                "enabled": false,
                "maximumResolution": "FULL_HD",
                "policy": "ALLOW"
            },
            "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,
            "containerFormat": "FRAGMENTED_MP4",
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "insecureIngest": false,
            "latencyMode": "LOW",
            "multitrackInputConfiguration": {
                "enabled": true,
                "maximumResolution": "FULL_HD",
                "policy": "ALLOW"
            },
            "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"
        }
    ]
}

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

Contoh kode berikut menunjukkan cara menggunakanbatch-get-stream-key.

AWS CLI

Untuk mendapatkan informasi tentang beberapa kunci aliran

batch-get-stream-keyContoh berikut mendapatkan informasi tentang kunci aliran yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

Contoh kode berikut menunjukkan cara menggunakanbatch-start-viewer-session-revocation.

AWS CLI

Untuk mencabut sesi penampil untuk beberapa pasangan Channel-ARN dan Viewer-ID

batch-start-viewer-session-revocationContoh berikut melakukan pencabutan sesi pada beberapa pasangan Channel-ARN dan Viewer-ID secara bersamaan. Permintaan dapat diselesaikan secara normal tetapi mengembalikan nilai di bidang kesalahan jika pemanggil tidak memiliki izin untuk mencabut sesi tertentu.

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}]'

Output:

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

Untuk informasi selengkapnya, lihat Menyiapkan Saluran Privat dalam Panduan Pengguna Amazon Interactive Video Service.

Contoh kode berikut menunjukkan cara menggunakancreate-channel.

AWS CLI

Contoh 1: Untuk membuat saluran tanpa rekaman

create-channelContoh berikut membuat saluran baru dan kunci aliran terkait untuk memulai streaming.

aws ivs create-channel \
    --name 'test-channel' \
    --no-insecure-ingest

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "authorized": false,
        "containerFormat": "TS",
        "name": "test-channel",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "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": {}
    }
}

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

Contoh 2: Untuk membuat saluran dengan perekaman diaktifkan, menggunakan RecordingConfiguration sumber daya yang ditentukan oleh ARN-nya

create-channelContoh berikut membuat saluran baru dan kunci aliran terkait untuk memulai streaming, dan menyiapkan perekaman untuk saluran tersebut:

aws ivs create-channel \
    --name test-channel-with-recording \
    --insecure-ingest \
    --recording-configuration-arn 'arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh'

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "containerFormat": "TS",
        "name": "test-channel-with-recording",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "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": {}
    }
}

Untuk informasi selengkapnya, lihat Rekam ke Amazon S3 di Panduan Low-Latency Pengguna IVS.

Contoh 3: Untuk membuat saluran dengan kebijakan pembatasan pemutaran yang ditentukan oleh ARN-nya

create-channelContoh berikut membuat saluran baru dan kunci aliran terkait untuk memulai streaming, dan menyiapkan kebijakan pembatasan pemutaran untuk saluran:

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'

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "containerFormat": "TS",
        "name": "test-channel-with-playback-restriction-policy",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "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": {}
    }
}

Untuk informasi selengkapnya, lihat Kon ten dan Pemirsa yang Tidak Di inginkan di Panduan Pengguna IVS Low-Latency .

Contoh 4: Untuk membuat saluran dengan multitrack diaktifkan

create-channelContoh berikut membuat saluran baru dan kunci aliran terkait untuk memulai streaming, dan mengaktifkan multitrack.

aws ivs create-channel \
    --name 'test-channel' \
    --no-insecure-ingest \
    --container-format 'FRAGMENTED_MP4' \
    --multitrack-input-configuration '{"enabled": true,"maximumResolution": "FULL_HD","policy": "ALLOW"}'

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "authorized": false,
        "containerFormat": "FRAGMENTED_MP4",
        "name": "test-channel",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": true,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "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": {}
    }
}

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

Contoh kode berikut menunjukkan cara menggunakancreate-playback-restriction-policy.

AWS CLI

Untuk membuat kebijakan pembatasan pemutaran

create-playback-restriction-policyContoh berikut membuat kebijakan resriksi pemutaran baru.

aws ivs create-playback-restriction-policy \
    --name "test-playback-restriction-policy" \
    --enable-strict-origin-enforcement \
    --tags "key1=value1, key2=value2" \
    --allowed-countries US MX \
    --allowed-origins https://www.website1.com https://www.website2.com

Output:

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

Untuk informasi selengkapnya, lihat Kon ten dan Pemirsa yang Tidak Di inginkan di Panduan Pengguna IVS Low-Latency .

Contoh kode berikut menunjukkan cara menggunakancreate-recording-configuration.

AWS CLI

Untuk membuat sumber RecordingConfiguration daya

create-recording-configurationContoh berikut membuat sumber RecordingConfiguration daya untuk mengaktifkan perekaman ke Amazon S3.

aws ivs create-recording-configuration \
    --name "test-recording-config" \
    --recording-reconnect-window-seconds 60 \
    --tags "key1=value1, key2=value2" \
    --rendition-configuration renditionSelection="CUSTOM",renditions="HD" \
    --thumbnail-configuration recordingMode="INTERVAL",targetIntervalSeconds=1,storage="LATEST",resolution="LOWEST_RESOLUTION" \
    --destination-configuration s3={bucketName=demo-recording-bucket}

Output:

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

Untuk informasi selengkapnya, lihat Merekam ke Amazon S3 di Panduan Pengguna Layanan Video Interaktif Amazon.

Contoh kode berikut menunjukkan cara menggunakancreate-stream-key.

AWS CLI

Untuk membuat kunci aliran

create-stream-keyContoh berikut membuat kunci aliran untuk ARN tertentu (Nama Sumber Daya Amazon).

aws ivs create-stream-key \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh

Output:

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

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

Contoh kode berikut menunjukkan cara menggunakandelete-channel.

AWS CLI

Untuk menghapus saluran dan kunci aliran terkaitnya

delete-channelContoh berikut menghapus saluran dengan ARN (Nama Sumber Daya Amazon) yang ditentukan.

aws ivs delete-channel \
    --arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

Contoh kode berikut menunjukkan cara menggunakandelete-playback-key-pair.

AWS CLI

Untuk menghapus pasangan kunci pemutaran tertentu

delete-playback-key-pairContoh berikut mengembalikan sidik jari dari pasangan kunci yang ditentukan.

aws ivs delete-playback-key-pair \
    --arn arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menyiapkan Saluran Privat dalam Panduan Pengguna Amazon Interactive Video Service.

Contoh kode berikut menunjukkan cara menggunakandelete-playback-restriction-policy.

AWS CLI

Untuk menghapus kebijakan pembatasan pemutaran

delete-playback-restriction-policyContoh berikut menghapus kebijakan resriksi pemutaran dengan kebijakan tertentu ARN (Nama Sumber Daya Amazon).

aws ivs delete-playback-restriction-policy \
    --arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Kon ten dan Pemirsa yang Tidak Di inginkan di Panduan Pengguna IVS Low-Latency .

Contoh kode berikut menunjukkan cara menggunakandelete-recording-configuration.

AWS CLI

Untuk menghapus RecordingConfiguration sumber daya yang ditentukan oleh ARN-nya

delete-recording-configurationContoh berikut menghapus sumber RecordingConfiguration daya dengan ARN yang ditentukan.

aws ivs delete-recording-configuration \
    --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Merekam ke Amazon S3 di Panduan Pengguna Layanan Video Interaktif Amazon.

Contoh kode berikut menunjukkan cara menggunakandelete-stream-key.

AWS CLI

Untuk menghapus kunci aliran

delete-stream-keyContoh berikut menghapus kunci aliran untuk ARN tertentu (Nama Sumber Daya Amazon), sehingga tidak dapat lagi digunakan untuk streaming.

aws ivs delete-stream-key \
    --arn arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

Contoh kode berikut menunjukkan cara menggunakanget-channel.

AWS CLI

Untuk mendapatkan informasi konfigurasi saluran

get-channelContoh berikut mendapatkan konfigurasi saluran untuk saluran tertentu ARN (Nama Sumber Daya Amazon).

aws ivs get-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh'

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "authorized": false,
        "containerFormat": "TS",
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "name": "channel-1",
        "playbackRestrictionPolicyArn": "",
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "tags": {}
        "type": "STANDARD",
    }
}

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

  • Untuk detail API, lihat GetChannel di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-playback-key-pair.

AWS CLI

Untuk mendapatkan pasangan kunci pemutaran tertentu

get-playback-key-pairContoh berikut mengembalikan sidik jari dari pasangan kunci yang ditentukan.

aws ivs get-playback-key-pair \
    --arn arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh

Output:

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

Untuk informasi selengkapnya, lihat Menyiapkan Saluran Privat dalam Panduan Pengguna Amazon Interactive Video Service.

Contoh kode berikut menunjukkan cara menggunakanget-playback-restriction-policy.

AWS CLI

Untuk mendapatkan informasi konfigurasi kebijakan pembatasan pemutaran

get-playback-restriction-policyContoh berikut mendapatkan konfigurasi kebijakan pembatasan pemutaran dengan kebijakan tertentu ARN (Nama Sumber Daya Amazon).

aws ivs get-playback-restriction-policy \
    --arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"

Output:

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

Untuk informasi selengkapnya, lihat Kon ten dan Pemirsa yang Tidak Di inginkan di Panduan Pengguna IVS Low-Latency .

Contoh kode berikut menunjukkan cara menggunakanget-recording-configuration.

AWS CLI

Untuk mendapatkan informasi tentang sumber RecordingConfiguration daya

get-recording-configurationContoh berikut mendapatkan informasi tentang RecordingConfiguration sumber daya untuk ARN yang ditentukan.

aws ivs get-recording-configuration \
    --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ"

Output:

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

Untuk informasi selengkapnya, lihat Merekam ke Amazon S3 di Panduan Pengguna Layanan Video Interaktif Amazon.

Contoh kode berikut menunjukkan cara menggunakanget-stream-key.

AWS CLI

Untuk mendapatkan informasi tentang aliran

get-stream-keyContoh berikut mendapatkan informasi tentang kunci aliran yang ditentukan.

aws ivs get-stream-key \
    --arn arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh --region=us-west-2

Output:

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

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

  • Untuk detail API, lihat GetStreamKey di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-stream-session.

AWS CLI

Untuk mendapatkan metadata untuk aliran tertentu

get-stream-sessionContoh berikut mendapatkan konfigurasi metadata untuk saluran tertentu ARN (Nama Sumber Daya Amazon) dan aliran yang ditentukan; jika streamId tidak disediakan, aliran terbaru untuk saluran dipilih.

aws ivs get-stream-session \
    --channel-arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --stream-id 'mystream'

Output:

{
    "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",
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "playbackUrl": "url-string",
            "authorized": false,
            "insecureIngest": false,
            "preset": ""
        },
        "ingestConfiguration": {
            "audio": {
                "channels": 2,
                "codec": "mp4a.40.2",
                "sampleRate": 8000,
                "targetBitrate": 46875,
                "track": "Track0"
            },
            "video": {
                "avcProfile": "Baseline",
                "avcLevel": "4.2",
                "codec": "avc1.42C02A",
                "encoder": "Lavf58.45.100",
                "level": "4.2",
                "profile": "Baseline",
                "targetBitrate": 8789062,
                "targetFramerate": 60,
                "track": "Track0",
                "videoHeight": 1080,
                "videoWidth": 1920
            }
        },
        "ingestConfigurations": {
            "audioConfigurations": [
                {
                    "channels": 2,
                    "codec": "mp4a.40.2",
                    "sampleRate": 8000,
                    "targetBitrate": 46875,
                    "track": "Track0"
                }
            ],
            "videoConfigurations": [
                {
                    "codec": "avc1.42C02A",
                    "encoder": "Lavf58.45.100",
                    "level": "4.2",
                    "profile": "Baseline",
                    "targetBitrate": 8789062,
                    "targetFramerate": 60,
                    "track": "Track0",
                    "videoHeight": 1080,
                    "videoWidth": 1920
                }
            ]
        },
        "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": [
            {
                "code": "StreamTakeoverInvalidPriority",
                "name": "Stream Takeover Failure",
                "type": "IVS Stream State Change",
                "eventTime": "2023-06-26T19:09:48+00:00"
            },
            {
                "name": "Stream Takeover",
                "type": "IVS Stream State Change",
                "eventTime": "2023-06-26T19:09:47+00:00"
            },
            {
                "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"
            }
        ]
    }
}

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

Contoh kode berikut menunjukkan cara menggunakanget-stream.

AWS CLI

Untuk mendapatkan informasi tentang aliran

get-streamContoh berikut mendapatkan informasi tentang aliran untuk saluran yang ditentukan.

aws ivs get-stream \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh

Output:

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

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

  • Untuk detail API, lihat GetStream di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanimport-playback-key-pair.

AWS CLI

Untuk mengimpor bagian publik dari pasangan kunci baru

import-playback-key-pairContoh berikut mengimpor kunci publik yang ditentukan (ditentukan sebagai string dalam format PEM) dan mengembalikan arn dan sidik jari dari pasangan kunci baru.

aws ivs import-playback-key-pair \
    --name "my-playback-key" \
    --public-key-material "G1lbnQxOTA3BgNVBAMMMFdoeSBhcmUgeW91IGRl..."

Output:

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

Untuk informasi selengkapnya, lihat Menyiapkan Saluran Privat dalam Panduan Pengguna Amazon Interactive Video Service.

Contoh kode berikut menunjukkan cara menggunakanlist-channels.

AWS CLI

Contoh 1: Untuk mendapatkan informasi ringkasan tentang semua saluran

list-channelsContoh berikut mencantumkan semua saluran untuk AWS akun Anda.

aws ivs list-channels

Output:

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

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

Contoh 2: Untuk mendapatkan informasi ringkasan tentang semua saluran, disaring oleh ARN yang RecordingConfiguration ditentukan

list-channelsContoh berikut mencantumkan semua saluran untuk AWS akun Anda, yang terkait dengan ARN yang RecordingConfiguration ditentukan.

aws ivs list-channels \
    --filter-by-recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh"

Output:

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

Untuk informasi selengkapnya, lihat Rekam ke Amazon S3 di Panduan Low-Latency Pengguna IVS.

Contoh 3: Untuk mendapatkan informasi ringkasan tentang semua saluran, disaring oleh ARN yang PlaybackRestrictionPolicy ditentukan

list-channelsContoh berikut mencantumkan semua saluran untuk AWS akun Anda, yang terkait dengan ARN yang PlaybackRestrictionPolicy ditentukan.

aws ivs list-channels \
    --filter-by-playback-restriction-policy-arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"

Output:

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

Untuk informasi selengkapnya, lihat Kon ten dan Pemirsa yang Tidak Di inginkan di Panduan Pengguna IVS Low-Latency .

  • Untuk detail API, lihat ListChannels di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-playback-key-pairs.

AWS CLI

Untuk mendapatkan informasi ringkasan tentang semua pasangan kunci pemutaran

list-playback-key-pairsContoh berikut mengembalikan informasi tentang semua pasangan kunci.

aws ivs list-playback-key-pairs

Output:

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

Untuk informasi selengkapnya, lihat Menyiapkan Saluran Privat dalam Panduan Pengguna Amazon Interactive Video Service.

Contoh kode berikut menunjukkan cara menggunakanlist-playback-restriction-policies.

AWS CLI

Untuk mendapatkan informasi ringkasan tentang semua kebijakan pembatasan pemutaran

list-playback-restriction-policiesContoh berikut mencantumkan semua kebijakan pembatasan pemutaran untuk AWS akun Anda.

aws ivs list-playback-restriction-policies

Output:

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

Untuk informasi selengkapnya, lihat Kon ten dan Pemirsa yang Tidak Di inginkan di Panduan Pengguna IVS Low-Latency .

Contoh kode berikut menunjukkan cara menggunakanlist-recording-configurations.

AWS CLI

Untuk membuat daftar semua RecordingConfiguration sumber daya yang dibuat di akun ini

list-recording-configurationsContoh berikut mendapatkan informasi tentang semua RecordingConfiguration sumber daya di akun Anda.

aws ivs list-recording-configurations

Output:

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

Untuk informasi selengkapnya, lihat Merekam ke Amazon S3 di Panduan Pengguna Layanan Video Interaktif Amazon.

Contoh kode berikut menunjukkan cara menggunakanlist-stream-keys.

AWS CLI

Untuk mendapatkan daftar kunci streaming

list-stream-keysContoh berikut mencantumkan semua kunci aliran untuk ARN tertentu (Nama Sumber Daya Amazon).

aws ivs list-stream-keys \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh

Output:

{
    "streamKeys": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh",
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "tags": {}
        }
    ]
}

fUntuk informasi selengkapnya, lihat Membuat Saluran di Panduan Pengguna IVS Low-Latency .

Contoh kode berikut menunjukkan cara menggunakanlist-stream-sessions.

AWS CLI

Untuk mendapatkan ringkasan streaming saat ini dan sebelumnya untuk saluran tertentu di AWS wilayah saat ini

list-stream-sessionsContoh berikut melaporkan informasi ringkasan untuk aliran untuk saluran tertentu ARN (Nama Sumber Daya Amazon).

aws ivs list-stream-sessions \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --max-results 25 \
    --next-token ""

Output:

{
    "nextToken": "set-2",
    "streamSessions": [
        {
            "startTime": 1641578182,
            "endTime": 1641579982,
            "hasErrorEvent": false,
            "streamId": "mystream"
        }
        ...
    ]
}

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

Contoh kode berikut menunjukkan cara menggunakanlist-streams.

AWS CLI

Untuk mendapatkan daftar streaming langsung dan statusnya

list-streamsContoh berikut mencantumkan semua streaming langsung untuk AWS akun Anda.

aws ivs list-streams

Output:

{
   "streams": [
        {
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "state": "LIVE",
            "health": "HEALTHY",
            "streamId": "st-ABCDEfghij01234KLMN5678",
            "viewerCount": 1
        }
    ]
}

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

  • Untuk detail API, lihat ListStreams di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk mencantumkan semua tag untuk AWS sumber daya (misalnya: saluran, kunci aliran)

list-tags-for-resourceContoh berikut mencantumkan semua tag untuk sumber daya tertentu ARN (Nama Sumber Daya Amazon).

aws ivs list-tags-for-resource \
    --resource-arn arn:aws:ivs:us-west-2:12345689012:channel/abcdABCDefgh

Output:

{
    "tags":
    {
        "key1": "value1",
        "key2": "value2"
    }
}

Untuk informasi selengkapnya, lihat Menandai di Refer ensi API Layanan Video Interaktif Amazon.

Contoh kode berikut menunjukkan cara menggunakanput-metadata.

AWS CLI

Untuk menyisipkan metadata ke aliran aktif untuk saluran tertentu

put-metadataContoh berikut menyisipkan metadata yang diberikan ke dalam aliran untuk saluran yang ditentukan.

aws ivs put-metadata \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --metadata '{"my": "metadata"}'

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

  • Untuk detail API, lihat PutMetadata di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanstart-viewer-session-revocation.

AWS CLI

Untuk mencabut sesi pemirsa untuk beberapa pasangan Channel-ARN dan Viewer-ID tertentu

start-viewer-session-revocationContoh berikut memulai proses pencabutan sesi penampil yang terkait dengan ARN saluran tertentu dan ID penampil, hingga dan termasuk nomor versi sesi yang ditentukan. Jika versi tidak disediakan, defaultnya adalah 0.

aws ivs start-viewer-session-revocation \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --viewer-id abcdefg \
    --viewer-session-versions-less-than-or-equal-to 1234567890

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menyiapkan Saluran Privat dalam Panduan Pengguna Amazon Interactive Video Service.

Contoh kode berikut menunjukkan cara menggunakanstop-stream.

AWS CLI

Untuk menghentikan aliran tertentu

stop-streamContoh berikut menghentikan streaming pada saluran yang ditentukan.

aws ivs stop-stream \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

  • Untuk detail API, lihat StopStream di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menambahkan atau memperbarui tag untuk AWS sumber daya (misalnya: saluran, kunci aliran)

tag-resourceContoh berikut menambahkan atau memperbarui tag untuk sumber daya tertentu ARN (Nama Sumber Daya Amazon).

aws ivs tag-resource \
    --resource-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --tags "tagkey1=tagvalue1, tagkey2=tagvalue2"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai di Refer ensi API Layanan Video Interaktif Amazon.

  • Untuk detail API, lihat TagResource di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag untuk AWS sumber daya (misalnya: saluran, kunci aliran)

untag-resourceContoh berikut menghapus tag yang ditentukan untuk sumber daya tertentu ARN (Nama Sumber Daya Amazon).

aws ivs untag-resource \
    --resource-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --tag-keys "tagkey1, tagkey2"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai di Refer ensi API Layanan Video Interaktif Amazon.

Contoh kode berikut menunjukkan cara menggunakanupdate-channel.

AWS CLI

Contoh 1: Untuk memperbarui informasi konfigurasi saluran

update-channelContoh berikut memperbarui konfigurasi saluran untuk ARN saluran tertentu untuk mengubah nama saluran. Ini tidak mempengaruhi aliran saluran yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan berlaku.

aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --name 'channel-1' \
    --insecure-ingest

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "channel-1",
        "latencyMode": "LOW",
        "containerFormat": "TS",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "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": {}
}

Untuk informasi selengkapnya, lihat Membuat Saluran di Panduan Low-Latency Pengguna IVS.

Contoh 2: Untuk memperbarui konfigurasi saluran untuk mengaktifkan perekaman

update-channelContoh berikut memperbarui konfigurasi saluran untuk ARN saluran tertentu untuk mengaktifkan perekaman. Ini tidak mempengaruhi aliran saluran yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan berlaku.

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'

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-recording",
        "latencyMode": "LOW",
        "containerFormat": "TS",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "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": {}
    }
}

Untuk informasi selengkapnya, lihat Rekam ke Amazon S3 di Panduan Low-Latency Pengguna IVS.

Contoh 3: Untuk memperbarui konfigurasi saluran untuk menonaktifkan perekaman

update-channelContoh berikut memperbarui konfigurasi saluran untuk saluran tertentu ARN untuk menonaktifkan perekaman. Ini tidak mempengaruhi aliran saluran yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan berlaku.

aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --recording-configuration-arn ''

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-recording",
        "latencyMode": "LOW",
        "containerFormat": "TS",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "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": {}
    }
}

Untuk informasi selengkapnya, lihat Rekam ke Amazon S3 di Panduan Low-Latency Pengguna IVS.

Contoh 4: Untuk memperbarui konfigurasi saluran untuk mengaktifkan pembatasan pemutaran

update-channelContoh berikut memperbarui konfigurasi saluran untuk ARN saluran tertentu untuk menerapkan kebijakan pembatasan pemutaran. Ini tidak mempengaruhi aliran saluran yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan berlaku.

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'

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-playback-restriction-policy",
        "latencyMode": "LOW",
        "containerFormat": "TS",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "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": {}
    }
}

Untuk informasi selengkapnya, lihat Kon ten dan Pemirsa yang Tidak Di inginkan di Panduan Pengguna IVS Low-Latency .

Contoh 5: Untuk memperbarui konfigurasi saluran untuk menonaktifkan pembatasan pemutaran

update-channelContoh berikut memperbarui konfigurasi saluran untuk ARN saluran tertentu untuk menonaktifkan pembatasan pemutaran. Ini tidak mempengaruhi aliran saluran yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan berlaku.

aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --playback-restriction-policy-arn ''

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-playback-restriction-policy",
        "latencyMode": "LOW",
        "containerFormat": "TS",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "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": {}
    }
}

Untuk informasi selengkapnya, lihat Kon ten dan Pemirsa yang Tidak Di inginkan di Panduan Pengguna IVS Low-Latency .

Contoh 6: Untuk memperbarui konfigurasi saluran untuk mengaktifkan multitrack

update-channelContoh berikut memperbarui konfigurasi saluran untuk ARN saluran tertentu untuk mengaktifkan multitrack. Ini tidak mempengaruhi aliran saluran yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan berlaku.

aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --container-format 'FRAGMENTED_MP4' \
    --multitrack-input-configuration '{"enabled": true,"maximumResolution": "FULL_HD","policy": "ALLOW"}'

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "containerFormat": "FRAGMENTED_MP4",
        "name": "test-channel-with-multitrack",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": true,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "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": {}
    }
}

Untuk informasi selengkapnya, lihat Kon ten dan Pemirsa yang Tidak Di inginkan di Panduan Pengguna IVS Low-Latency .

Contoh 7: Untuk memperbarui konfigurasi saluran untuk menonaktifkan pembatasan pemutaran

update-channelContoh berikut memperbarui konfigurasi saluran untuk saluran tertentu ARN untuk menonaktifkan multitrack. Ini tidak mempengaruhi aliran saluran yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan berlaku.

aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --container-format 'TS' \
    --multitrack-input-configuration '{"enabled": false}'

Output:

{
    "channel": {
        ""arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "containerFormat": "TS",
        "name": "test-channel-with-multitrack",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "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": {}
    }
}

Untuk informasi selengkapnya, lihat Kon ten dan Pemirsa yang Tidak Di inginkan di Panduan Pengguna IVS Low-Latency .

Contoh kode berikut menunjukkan cara menggunakanupdate-playback-restriction-policy.

AWS CLI

Untuk memperbarui kebijakan pembatasan pemutaran

update-playback-restriction-policyContoh berikut memperbarui kebijakan pembatasan pemutaran dengan kebijakan ARN yang ditentukan untuk menonaktifkan penegakan asal yang ketat. Ini tidak memengaruhi aliran saluran terkait yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan berlaku.

aws ivs update-playback-restriction-policy \
    --arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ" \
    --no-enable-strict-origin-enforcement

Output:

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

Untuk informasi selengkapnya, lihat Kon ten dan Pemirsa yang Tidak Di inginkan di Panduan Pengguna IVS Low-Latency .