AWS cli documentation change
Summary
Updated AWS CLI version reference from 2.34.34 to 2.34.37 and extensively restructured the documentation for the get-stream-session command response fields. Major changes include reordering of fields in the streamSession structure, addition of new fields (streamId, startTime, endTime, adConfigurationArn), removal of regex pattern anchors (^ and $) from several ARN and ID patterns, restructuring of ingestConfiguration and ingestConfigurations objects, and reorganization of recording configuration details.
Security assessment
The changes are primarily documentation restructuring, field reordering, and pattern syntax updates (removing regex anchors). There is no evidence of addressing a specific security vulnerability or incident. The pattern changes (removing ^ and $) are likely documentation corrections to reflect actual API behavior but don't indicate security fixes. The addition of adConfigurationArn is a feature addition, not security-related. No security features like authentication, authorization, or encryption are documented.
Diff
diff --git a/cli/latest/reference/ivs/get-stream-session.md b/cli/latest/reference/ivs/get-stream-session.md index 740952edd..2b764e320 100644 --- a//cli/latest/reference/ivs/get-stream-session.md +++ b//cli/latest/reference/ivs/get-stream-session.md @@ -15 +15 @@ - * [AWS CLI 2.34.34 Command Reference](../../index.html) » + * [AWS CLI 2.34.37 Command Reference](../../index.html) » @@ -103 +103 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/ivs-20 -> * pattern: `^arn:aws:ivs:[a-z0-9-]+:[0-9]+:channel/[a-zA-Z0-9-]+$` +> * pattern: `arn:aws:ivs:[a-z0-9-]+:[0-9]+:channel/[a-zA-Z0-9-]+` @@ -115 +115 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/ivs-20 -> * pattern: `^st-[a-zA-Z0-9]+$` +> * pattern: `st-[a-zA-Z0-9]+` @@ -381,0 +382,20 @@ streamSession -> (structure) +> streamId -> (string) +> +>> Unique identifier for a live or previously live stream in the specified channel. +>> +>> Constraints: +>> +>> * min: `26` +>> * max: `26` +>> * pattern: `st-[a-zA-Z0-9]+` +>> + +> +> startTime -> (timestamp) +> +>> Time when the channel went live. This is an ISO 8601 timestamp; _note that this is returned as a string_ . +> +> endTime -> (timestamp) +> +>> Time when the channel went offline. This is an ISO 8601 timestamp; _note that this is returned as a string_ . For live streams, this is `NULL` . +> @@ -394 +414 @@ streamSession -> (structure) ->>> * pattern: `^arn:aws:ivs:[a-z0-9-]+:[0-9]+:channel/[a-zA-Z0-9-]+$` +>>> * pattern: `arn:aws:ivs:[a-z0-9-]+:[0-9]+:channel/[a-zA-Z0-9-]+` @@ -398,5 +418 @@ streamSession -> (structure) ->> authorized -> (boolean) ->> ->>> Whether the channel is private (enabled for playback authorization). Default: `false` . ->> ->> containerFormat -> (string) +>> name -> (string) @@ -404 +420 @@ streamSession -> (structure) ->>> Indicates which content-packaging format is used (MPEG-TS or fMP4). If `multitrackInputConfiguration` is specified and `enabled` is `true` , then `containerFormat` is required and must be set to `FRAGMENTED_MP4` . Otherwise, `containerFormat` may be set to `TS` or `FRAGMENTED_MP4` . Default: `TS` . +>>> Channel name. @@ -406 +422 @@ streamSession -> (structure) ->>> Possible values: +>>> Constraints: @@ -408,2 +424,3 @@ streamSession -> (structure) ->>> * `TS` ->>> * `FRAGMENTED_MP4` +>>> * min: `0` +>>> * max: `128` +>>> * pattern: `[a-zA-Z0-9-_]*` @@ -412,8 +428,0 @@ streamSession -> (structure) ->> ->> ingestEndpoint -> (string) ->> ->>> Channel ingest endpoint, part of the definition of an ingest server, used when you set up streaming software. ->> ->> insecureIngest -> (boolean) ->> ->>> Whether the channel allows insecure RTMP ingest. Default: `false` . @@ -432 +441 @@ streamSession -> (structure) ->> multitrackInputConfiguration -> (structure) +>> type -> (string) @@ -434,7 +443 @@ streamSession -> (structure) ->>> Object specifying multitrack input configuration. Default: no multitrack input configuration is specified. ->>> ->>> enabled -> (boolean) ->>> ->>>> Indicates whether multitrack input is enabled. Can be set to `true` only if channel type is `STANDARD` . Setting `enabled` to `true` with any other channel type will cause an exception. If `true` , then `policy` , `maximumResolution` , and `containerFormat` are required, and `containerFormat` must be set to `FRAGMENTED_MP4` . Default: `false` . ->>> ->>> maximumResolution -> (string) +>>> Channel type, which determines the allowable resolution and bitrate. _If you exceed the allowable input resolution or bitrate, the stream probably will disconnect immediately._ Default: `STANDARD` . For details, see [Channel Types](https://docs.aws.amazon.com/ivs/latest/LowLatencyAPIReference/channel-types.html) . @@ -442,9 +445 @@ streamSession -> (structure) ->>>> Maximum resolution for multitrack input. Required if `enabled` is `true` . ->>>> ->>>> Possible values: ->>>> ->>>> * `SD` ->>>> * `HD` ->>>> * `FULL_HD` ->>>> - +>>> Possible values: @@ -452 +447,4 @@ streamSession -> (structure) ->>> policy -> (string) +>>> * `BASIC` +>>> * `STANDARD` +>>> * `ADVANCED_SD` +>>> * `ADVANCED_HD` @@ -454,7 +451,0 @@ streamSession -> (structure) ->>>> Indicates whether multitrack input is allowed or required. Required if `enabled` is `true` . ->>>> ->>>> Possible values: ->>>> ->>>> * `ALLOW` ->>>> * `REQUIRE` ->>>> @@ -463 +454 @@ streamSession -> (structure) ->> name -> (string) +>> recordingConfigurationArn -> (string) @@ -465 +456 @@ streamSession -> (structure) ->>> Channel name. +>>> Recording-configuration ARN. A valid ARN value here both specifies the ARN and enables recording. Default: “” (empty string, recording is disabled). @@ -471 +462 @@ streamSession -> (structure) ->>> * pattern: `^[a-zA-Z0-9-_]*$` +>>> * pattern: `^$|^arn:aws:ivs:[a-z0-9-]+:[0-9]+:recording-configuration/[a-zA-Z0-9-]+$` @@ -475 +466 @@ streamSession -> (structure) ->> playbackRestrictionPolicyArn -> (string) +>> ingestEndpoint -> (string) @@ -477 +468,13 @@ streamSession -> (structure) ->>> Playback-restriction-policy ARN. A valid ARN value here both specifies the ARN and enables playback restriction. Default: “” (empty string, no playback restriction policy is applied). +>>> Channel ingest endpoint, part of the definition of an ingest server, used when you set up streaming software. +>> +>> playbackUrl -> (string) +>> +>>> Channel playback URL. +>> +>> authorized -> (boolean) +>> +>>> Whether the channel is private (enabled for playback authorization). Default: `false` . +>> +>> tags -> (map) +>> +>>> Tags attached to the resource. Array of 1-50 maps, each of the form `string:string (key:value)` . See [Best practices and strategies](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html) in _Tagging Amazon Web Services Resources and Tag Editor_ for details, including restrictions that apply to tags and “Tag naming limits and requirements”; Amazon IVS has no service-specific constraints beyond what is documented there. @@ -482,2 +485 @@ streamSession -> (structure) ->>> * max: `128` ->>> * pattern: `^^$|^arn:aws:ivs:[a-z0-9-]+:[0-9]+:playback-restriction-policy/[a-zA-Z0-9-]+$$` +>>> * max: `50` @@ -485,0 +488,18 @@ streamSession -> (structure) +>>> +>>> key -> (string) +>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * max: `128` +>>>> + +>>> +>>> value -> (string) +>>> +>>>> Constraints: +>>>> +>>>> * min: `0` +>>>> * max: `256` +>>>> + @@ -487 +507 @@ streamSession -> (structure) ->> playbackUrl -> (string) +>> insecureIngest -> (boolean) @@ -489 +509 @@ streamSession -> (structure) ->>> Channel playback URL. +>>> Whether the channel allows insecure RTMP ingest. Default: `false` . @@ -501,12 +520,0 @@ streamSession -> (structure) ->> ->> recordingConfigurationArn -> (string) ->> ->>> Recording-configuration ARN. A valid ARN value here both specifies the ARN and enables recording. Default: “” (empty string, recording is disabled). ->>> ->>> Constraints: ->>> ->>> * min: `0` ->>> * max: `128` ->>> * pattern: `^^$|^arn:aws:ivs:[a-z0-9-]+:[0-9]+:recording-configuration/[a-zA-Z0-9-]+$$` ->>> - @@ -526 +534 @@ streamSession -> (structure) ->> tags -> (map) +>> playbackRestrictionPolicyArn -> (string) @@ -528 +536 @@ streamSession -> (structure) ->>> Tags attached to the resource. Array of 1-50 maps, each of the form `string:string (key:value)` . See [Best practices and strategies](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html) in _Tagging Amazon Web Services Resources and Tag Editor_ for details, including restrictions that apply to tags and “Tag naming limits and requirements”; Amazon IVS has no service-specific constraints beyond what is documented there. +>>> Playback-restriction-policy ARN. A valid ARN value here both specifies the ARN and enables playback restriction. Default: “” (empty string, no playback restriction policy is applied). @@ -533 +541,2 @@ streamSession -> (structure) ->>> * max: `50` +>>> * max: `128` +>>> * pattern: `^$|^arn:aws:ivs:[a-z0-9-]+:[0-9]+:playback-restriction-policy/[a-zA-Z0-9-]+$` @@ -535,0 +545,4 @@ streamSession -> (structure) +>> +>> multitrackInputConfiguration -> (structure) +>> +>>> Object specifying multitrack input configuration. Default: no multitrack input configuration is specified. @@ -537 +550 @@ streamSession -> (structure) ->>> key -> (string) +>>> enabled -> (boolean) @@ -539 +552,5 @@ streamSession -> (structure) ->>>> Constraints: +>>>> Indicates whether multitrack input is enabled. Can be set to `true` only if channel type is `STANDARD` . Setting `enabled` to `true` with any other channel type will cause an exception. If `true` , then `policy` , `maximumResolution` , and `containerFormat` are required, and `containerFormat` must be set to `FRAGMENTED_MP4` . Default: `false` . +>>> +>>> policy -> (string) +>>> +>>>> Indicates whether multitrack input is allowed or required. Required if `enabled` is `true` . @@ -541,2 +558,4 @@ streamSession -> (structure) ->>>> * min: `1` ->>>> * max: `128` +>>>> Possible values: