AWS cli documentation change
Summary
Updated AWS CLI version reference, added HTTP response header fields (CORS, security headers), reordered and restructured channel output fields, updated field patterns and constraints, and added adConfigurationArn field.
Security assessment
The change adds documentation for security-related HTTP response headers (Content-Security-Policy, Strict-Transport-Security, X-Content-Type-Options, X-Frame-Options) which are security features for web applications. However, there is no evidence this addresses a specific security vulnerability or incident - it appears to be routine documentation updates and feature additions.
Diff
diff --git a/cli/latest/reference/ivs/batch-get-channel.md b/cli/latest/reference/ivs/batch-get-channel.md index 2ecd30000..c0969eb01 100644 --- a//cli/latest/reference/ivs/batch-get-channel.md +++ b//cli/latest/reference/ivs/batch-get-channel.md @@ -15 +15 @@ - * [AWS CLI 2.34.34 Command Reference](../../index.html) » + * [AWS CLI 2.34.37 Command Reference](../../index.html) » @@ -111 +111 @@ 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-]+` @@ -310,0 +311,28 @@ For more information, see [Create a Channel](https://docs.aws.amazon.com/ivs/lat +accessControlAllowOrigin -> (string) + +> See [Access-Control-Allow-Origin](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Access-Control-Allow-Origin) in the MDN Web Docs. + +accessControlExposeHeaders -> (string) + +> See [Access-Control-Expose-Headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Access-Control-Expose-Headers) in the MDN Web Docs. + +cacheControl -> (string) + +> See [Cache-Control](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control) in the MDN Web Docs. + +contentSecurityPolicy -> (string) + +> See [Content-Security-Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy) in the MDN Web Docs. + +strictTransportSecurity -> (string) + +> See [Strict-Transport-Security](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Strict-Transport-Security) in the MDN Web Docs. + +xContentTypeOptions -> (string) + +> See [X-Content-Type-Options](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Content-Type-Options) in the MDN Web Docs. + +xFrameOptions -> (string) + +> See [X-Frame-Options](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Frame-Options) in the MDN Web Docs. + @@ -325 +353 @@ channels -> (list) ->>> * 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-]+` @@ -329,5 +357 @@ channels -> (list) ->> authorized -> (boolean) ->> ->>> Whether the channel is private (enabled for playback authorization). Default: `false` . ->> ->> containerFormat -> (string) +>> name -> (string) @@ -335 +359 @@ channels -> (list) ->>> 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. @@ -337 +361 @@ channels -> (list) ->>> Possible values: +>>> Constraints: @@ -339,2 +363,3 @@ channels -> (list) ->>> * `TS` ->>> * `FRAGMENTED_MP4` +>>> * min: `0` +>>> * max: `128` +>>> * pattern: `[a-zA-Z0-9-_]*` @@ -343,8 +367,0 @@ channels -> (list) ->> ->> 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` . @@ -363 +380 @@ channels -> (list) ->> multitrackInputConfiguration -> (structure) +>> type -> (string) @@ -365,7 +382 @@ channels -> (list) ->>> 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) . @@ -373,9 +384 @@ channels -> (list) ->>>> Maximum resolution for multitrack input. Required if `enabled` is `true` . ->>>> ->>>> Possible values: ->>>> ->>>> * `SD` ->>>> * `HD` ->>>> * `FULL_HD` ->>>> - +>>> Possible values: @@ -383 +386,4 @@ channels -> (list) ->>> policy -> (string) +>>> * `BASIC` +>>> * `STANDARD` +>>> * `ADVANCED_SD` +>>> * `ADVANCED_HD` @@ -385,7 +390,0 @@ channels -> (list) ->>>> Indicates whether multitrack input is allowed or required. Required if `enabled` is `true` . ->>>> ->>>> Possible values: ->>>> ->>>> * `ALLOW` ->>>> * `REQUIRE` ->>>> @@ -394 +393 @@ channels -> (list) ->> name -> (string) +>> recordingConfigurationArn -> (string) @@ -396 +395 @@ channels -> (list) ->>> Channel name. +>>> Recording-configuration ARN. A valid ARN value here both specifies the ARN and enables recording. Default: “” (empty string, recording is disabled). @@ -402 +401 @@ channels -> (list) ->>> * pattern: `^[a-zA-Z0-9-_]*$` +>>> * pattern: `^$|^arn:aws:ivs:[a-z0-9-]+:[0-9]+:recording-configuration/[a-zA-Z0-9-]+$` @@ -406 +405 @@ channels -> (list) ->> playbackRestrictionPolicyArn -> (string) +>> ingestEndpoint -> (string) @@ -408 +407,13 @@ channels -> (list) ->>> 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. @@ -413,2 +424,14 @@ channels -> (list) ->>> * max: `128` ->>> * pattern: `^^$|^arn:aws:ivs:[a-z0-9-]+:[0-9]+:playback-restriction-policy/[a-zA-Z0-9-]+$$` +>>> * max: `50` +>>> + +>>> +>>> key -> (string) +>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * max: `128` +>>>> + +>>> +>>> value -> (string) @@ -415,0 +439,5 @@ channels -> (list) +>>>> Constraints: +>>>> +>>>> * min: `0` +>>>> * max: `256` +>>>> @@ -418 +446 @@ channels -> (list) ->> playbackUrl -> (string) +>> insecureIngest -> (boolean) @@ -420 +448 @@ channels -> (list) ->>> Channel playback URL. +>>> Whether the channel allows insecure RTMP ingest. Default: `false` . @@ -432,12 +459,0 @@ channels -> (list) ->> ->> 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-]+$$` ->>> - @@ -457 +473 @@ channels -> (list) ->> tags -> (map) +>> playbackRestrictionPolicyArn -> (string) @@ -459 +475 @@ channels -> (list) ->>> 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). @@ -464 +480,2 @@ channels -> (list) ->>> * max: `50` +>>> * max: `128` +>>> * pattern: `^$|^arn:aws:ivs:[a-z0-9-]+:[0-9]+:playback-restriction-policy/[a-zA-Z0-9-]+$` @@ -466,0 +484,4 @@ channels -> (list) +>> +>> multitrackInputConfiguration -> (structure) +>> +>>> Object specifying multitrack input configuration. Default: no multitrack input configuration is specified. @@ -468 +489 @@ channels -> (list) ->>> key -> (string) +>>> enabled -> (boolean) @@ -470 +491,5 @@ channels -> (list) ->>>> 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) +>>>