Contoh Amazon IVS menggunakan AWS CLI - AWS Contoh Kode SDK
Tindakan

Ada lebih banyak contoh AWS SDK yang tersedia di repo Contoh SDK AWS Doc. GitHub

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 kepada Anda cara melakukan tindakan dan mengimplementasikan skenario umum AWS Command Line Interface dengan menggunakan 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 Pengguna Latensi Rendah IVS.

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

AWS CLI

Untuk mendapatkan informasi tentang beberapa tombol aliran

batch-get-stream-keyContoh berikut mendapat 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 Pengguna Latensi Rendah 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 selesai 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 Pengguna Latensi Rendah 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 streaming terkait untuk memulai streaming, dan mengatur perekaman untuk saluran:

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 Merekam ke Amazon S3 di Panduan Pengguna Latensi Rendah IVS.

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

create-channelContoh berikut membuat saluran baru dan kunci streaming 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 Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna Latensi Rendah IVS.

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 Pengguna Latensi Rendah IVS.

  • Untuk detail API, lihat CreateChanneldi Referensi AWS CLI Perintah.

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

AWS CLI

Untuk membuat kebijakan pembatasan pemutaran

create-playback-restriction-policyContoh berikut membuat kebijakan resriction 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 Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna Latensi Rendah IVS.

Contoh kode berikut menunjukkan cara menggunakancreate-recording-configuration.

AWS CLI

Untuk membuat sumber RecordingConfiguration daya

create-recording-configurationContoh berikut membuat RecordingConfiguration sumber 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 (Amazon Resource Name).

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 Pengguna Latensi Rendah IVS.

Contoh kode berikut menunjukkan cara menggunakandelete-channel.

AWS CLI

Untuk menghapus saluran dan kunci aliran terkait

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

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 Pengguna Latensi Rendah IVS.

  • Untuk detail API, lihat DeleteChanneldi Referensi AWS CLI Perintah.

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

AWS CLI

Untuk menghapus key pair playback yang ditentukan

delete-playback-key-pairContoh berikut mengembalikan sidik jari dari key pair 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 pemutaran ulang dengan kebijakan yang ditentukan 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 Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna Latensi Rendah IVS.

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 RecordingConfiguration sumber 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 (Amazon Resource Name), 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 Pengguna Latensi Rendah 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 (Amazon Resource Name).

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 Pengguna Latensi Rendah IVS.

  • Untuk detail API, lihat GetChanneldi Referensi AWS CLI Perintah.

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

AWS CLI

Untuk mendapatkan key pair playback yang ditentukan

get-playback-key-pairContoh berikut mengembalikan sidik jari dari key pair 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 yang ditentukan 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 Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna Latensi Rendah IVS.

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 Pengguna Latensi Rendah IVS.

  • Untuk detail API, lihat GetStreamKeydi Referensi AWS CLI 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 yang ditentukan ARN (Nama Sumber Daya Amazon) dan aliran yang ditentukan; streamId jika 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 Pengguna Latensi Rendah 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 Pengguna Latensi Rendah IVS.

  • Untuk detail API, lihat GetStreamdi Referensi AWS CLI Perintah.

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

AWS CLI

Untuk mengimpor bagian publik dari key pair baru

import-playback-key-pairContoh berikut mengimpor kunci publik yang ditentukan (ditentukan sebagai string dalam format PEM) dan mengembalikan arn dan sidik jari dari key pair 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 Pengguna Latensi Rendah IVS.

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

list-channelsContoh berikut mencantumkan semua saluran untuk AWS akun Anda, yang terkait dengan RecordingConfiguration ARN yang 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 Merekam ke Amazon S3 di Panduan Pengguna Latensi Rendah IVS.

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

list-channelsContoh berikut mencantumkan semua saluran untuk AWS akun Anda, yang terkait dengan PlaybackRestrictionPolicy ARN yang 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 Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna Latensi Rendah IVS.

  • Untuk detail API, lihat ListChannelsdi Referensi AWS CLI 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 Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna Latensi Rendah IVS.

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 tombol aliran

list-stream-keysContoh berikut mencantumkan semua kunci aliran untuk ARN tertentu (Amazon Resource Name).

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

FFor selengkapnya, lihat Membuat Saluran di Panduan Pengguna Latensi Rendah IVS.

  • Untuk detail API, lihat ListStreamKeysdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-stream-sessions.

AWS CLI

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

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 Pengguna Latensi Rendah 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 Pengguna Latensi Rendah IVS.

  • Untuk detail API, lihat ListStreamsdi Referensi AWS CLI 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 ARN sumber daya tertentu (Amazon Resource Name).

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 Referensi 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 Pengguna Latensi Rendah IVS.

  • Untuk detail API, lihat PutMetadatadi Referensi AWS CLI Perintah.

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

AWS CLI

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

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 ke 0.

aws ivs batch-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 aliran 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 Pengguna Latensi Rendah IVS.

  • Untuk detail API, lihat StopStreamdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menambah atau memperbarui tag untuk AWS sumber daya (misalnya: channel, stream key)

tag-resourceContoh berikut menambahkan atau memperbarui tag untuk ARN sumber daya tertentu (Amazon Resource Name).

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 Referensi API Layanan Video Interaktif Amazon.

  • Untuk detail API, lihat TagResourcedi Referensi AWS CLI 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 ARN sumber daya tertentu (Amazon Resource Name).

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 Referensi API Layanan Video Interaktif Amazon.

  • Untuk detail API, lihat UntagResourcedi Referensi AWS CLI Perintah.

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 memengaruhi aliran saluran ini yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan diterapkan.

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 Pengguna Latensi Rendah 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 memengaruhi aliran saluran ini yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan diterapkan.

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 Merekam ke Amazon S3 di Panduan Pengguna Latensi Rendah IVS.

Contoh 3: Untuk memperbarui konfigurasi saluran untuk menonaktifkan perekaman

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

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 Merekam ke Amazon S3 di Panduan Pengguna Latensi Rendah 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 memengaruhi aliran saluran ini yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan diterapkan.

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 Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna Latensi Rendah IVS.

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 memengaruhi aliran saluran ini yang sedang berlangsung; Anda harus menghentikan dan memulai ulang aliran agar perubahan diterapkan.

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 Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna Latensi Rendah IVS.

Contoh 6: Untuk memperbarui konfigurasi saluran untuk mengaktifkan multitrack

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

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 Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna Latensi Rendah IVS.

Contoh 7: Untuk memperbarui konfigurasi saluran untuk menonaktifkan pembatasan pemutaran

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

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 Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna Latensi Rendah IVS.

  • Untuk detail API, lihat UpdateChanneldi Referensi AWS CLI Perintah.

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 diterapkan.

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 Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna Latensi Rendah IVS.