IVSContoh Amazon 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.

IVSContoh Amazon menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface with AmazonIVS.

Tindakan adalah 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,
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "insecureIngest": false,
            "latencyMode": "LOW",
            "name": "channel-1",
            "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel-1.abcdEFGH.m3u8",
            "preset": "",
            "playbackRestrictionPolicyArn": "",
            "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
            "srt": {
                "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
                "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
            },
            "tags": {},
            "type": "STANDARD"
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl",
            "authorized": false,
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "insecureIngest": true,
            "latencyMode": "LOW",
            "name": "channel-2",
            "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel-2.abcdEFGH.m3u8",
            "preset": "",
            "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"",
            "recordingConfigurationArn": "",
            "srt": {
                "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
                "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
            },
            "tags": {},
            "type": "STANDARD"
        }
    ]
}

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

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

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,
        "name": "test-channel",
        "latencyMode": "LOW",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "tags": {},
        "type": "STANDARD"
    },
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}

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

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

create-channelContoh berikut membuat saluran baru dan kunci streaming terkait untuk memulai streaming, dan mengatur 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",
        "name": "test-channel-with-recording",
        "latencyMode": "LOW",
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": true,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {},
        "type": "STANDARD"
    },
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}

Untuk informasi selengkapnya, lihat Merekam ke Amazon S3 di Panduan Pengguna IVSLatensi Rendah.

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

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

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",
        "name": "test-channel-with-playback-restriction-policy",
        "latencyMode": "LOW",
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2edfGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": true,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {},
        "type": "STANDARD"
    },
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}

Untuk informasi selengkapnya, lihat Konten dan Pemirsa yang Tidak Diinginkan di Panduan Pengguna IVSLatensi Rendah.

  • Untuk API detailnya, 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 IVSLatensi Rendah.

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 yang ditentukan ARN (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 IVS Latensi Rendah.

Contoh kode berikut menunjukkan cara menggunakandelete-channel.

AWS CLI

Untuk menghapus saluran dan kunci aliran terkait

delete-channelContoh berikut menghapus saluran dengan yang ditentukan ARN (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 IVS Latensi Rendah.

  • Untuk API detailnya, 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 (ARNAmazon Resource Name).

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 IVSLatensi Rendah.

Contoh kode berikut menunjukkan cara menggunakandelete-recording-configuration.

AWS CLI

Untuk menghapus RecordingConfiguration sumber daya yang ditentukan oleh ARN

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

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 yang ditentukan ARN (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 Pengguna IVS Latensi Rendah.

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",
        "name": "channel-1",
        "latencyMode": "LOW",
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "preset": "",
        "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "tags": {}
    }
}

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

  • Untuk API detailnya, 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 (ARNAmazon Resource Name).

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 IVSLatensi Rendah.

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 yang ditentukanARN.

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

  • Untuk API detailnya, 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 tertentu (Nama Sumber Daya ARN 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",
            "srt": {
                "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
                "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
            },
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "playbackUrl": "url-string",
            "authorized": false,
            "insecureIngest": false,
            "preset": ""
        },
        "ingestConfiguration": {
            "video": {
                "avcProfile": "Baseline",
                "avcLevel": "4.2",
                "codec": "avc1.42C02A",
                "encoder": "Lavf58.45.100",
                "targetBitrate": 8789062,
                "targetFramerate": 60,
                "videoHeight": 1080,
                "videoWidth": 1920
            },
            "audio": {
                "codec": "mp4a.40.2",
                "targetBitrate": 46875,
                "sampleRate": 8000,
                "channels": 2
            }
        },
        "recordingConfiguration": {
            "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ",
            "name": "test-recording-config",
            "destinationConfiguration": {
                "s3": {
                    "bucketName": "demo-recording-bucket"
                }
            },
            "state": "ACTIVE",
            "tags": {
                "key1": "value1",
                "key2": "value2"
            },
            "thumbnailConfiguration": {
                "recordingMode": "INTERVAL",
                "targetIntervalSeconds": 1,
                "resolution": "LOWEST_RESOLUTION",
                "storage": [
                    "LATEST"
                ]
            },
            "recordingReconnectWindowSeconds": 60,
            "renditionConfiguration": {
                "renditionSelection": "CUSTOM",
                "renditions": [
                    "HD"
                ]
            }
        },
        "truncatedEvents": [
            {
                "name": "Recording Start",
                "type": "IVS Recording State Change",
                "eventTime": "2023-06-26T19:09:35+00:00"
            },
            {
                "name": "Stream Start",
                "type": "IVS Stream State Change",
                "eventTime": "2023-06-26T19:09:34+00:00"
            },
            {
                "name": "Session Created",
                "type": "IVS Stream State Change",
                "eventTime": "2023-06-26T19:09:28+00:00"
            }
        ]
    }
}

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

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

  • Untuk API detailnya, 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 PEM format) 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 IVS Latensi Rendah.

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

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

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 IVSLatensi Rendah.

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

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

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 IVSLatensi Rendah.

  • Untuk API detailnya, 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 IVSLatensi Rendah.

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 yang ditentukan ARN (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": {}
        }
    ]
}

FForselengkapnya, lihat Membuat Saluran di Panduan Pengguna IVS Latensi Rendah.

  • Untuk API detailnya, 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 IVS Latensi Rendah.

Contoh kode berikut menunjukkan cara menggunakanlist-streams.

AWS CLI

Untuk mendapatkan daftar streaming langsung dan negara bagiannya

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

  • Untuk API detailnya, 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 sumber daya tertentu ARN (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 APIReferensi 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 IVS Latensi Rendah.

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

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

AWS CLI

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

start-viewer-session-revocationContoh berikut memulai proses pencabutan sesi penampil yang terkait dengan saluran ARN dan ID penampil tertentu, 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 IVS Latensi Rendah.

  • Untuk API detailnya, 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 sumber daya tertentu ARN (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 APIReferensi Layanan Video Interaktif Amazon.

  • Untuk API detailnya, 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 sumber daya tertentu ARN (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 APIReferensi Layanan Video Interaktif Amazon.

  • Untuk API detailnya, 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 saluran tertentu ARN 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",
        "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 IVS Latensi Rendah.

Contoh 2: Untuk memperbarui konfigurasi saluran untuk mengaktifkan perekaman

update-channelContoh berikut memperbarui konfigurasi saluran untuk saluran tertentu ARN 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",
        "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 IVSLatensi Rendah.

Contoh 3: Untuk memperbarui konfigurasi saluran untuk menonaktifkan perekaman

update-channelContoh berikut memperbarui konfigurasi saluran untuk saluran tertentu ARN 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",
        "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 IVSLatensi Rendah.

Contoh 4: Untuk memperbarui konfigurasi saluran untuk mengaktifkan pembatasan pemutaran

update-channelContoh berikut memperbarui konfigurasi saluran untuk saluran tertentu ARN 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",
        "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 IVSLatensi Rendah.

Contoh 5: Untuk memperbarui konfigurasi saluran untuk menonaktifkan pembatasan pemutaran

update-channelContoh berikut memperbarui konfigurasi saluran untuk saluran tertentu ARN 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",
        "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 IVSLatensi Rendah.

  • Untuk API detailnya, 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 yang ditentukan ARN 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 IVSLatensi Rendah.