aws ivs get-stream-session

Gets metadata on a specified stream. AWS CLI reference

1 example 2 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To get metadata for a specified stream

The following get-stream-session example gets the metadata configuration for the specified channel ARN (Amazon Resource Name) and the specified stream; if streamId is not provided, the most recent stream for the channel is selected.

aws ivs get-stream-session --channel-arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' --stream-id 'st-1A2b3C4d5E6f7G8h9I0j1K2l'

Identify

--channel-arnARN of the channel resource

--stream-idUnique identifier for a live or previously live stream in the specified channel.

Its output, shortened

{
    "streamSession": {
        "streamId": "st-1A2b3C4d5E6f7G8h9I0j1K2l",
        "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",
… 91 more lines

For more information, see Create a Channel in the IVS Low-Latency User Guide.

Options

2 in the AWS CLI reference

--channel-arnARN of the channel resource

--stream-idUnique identifier for a live or previously live stream in the specified channel.