@aws-sdk/client-kinesis-video-archived-media 3.382.0 → 3.386.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist-cjs/endpoint/ruleset.js +3 -3
- package/dist-es/endpoint/ruleset.js +3 -3
- package/dist-types/commands/GetClipCommand.d.ts +14 -16
- package/dist-types/commands/GetDASHStreamingSessionURLCommand.d.ts +54 -57
- package/dist-types/commands/GetHLSStreamingSessionURLCommand.d.ts +80 -74
- package/dist-types/commands/GetImagesCommand.d.ts +6 -6
- package/dist-types/commands/GetMediaForFragmentListCommand.d.ts +14 -17
- package/dist-types/commands/ListFragmentsCommand.d.ts +15 -16
- package/dist-types/models/models_0.d.ts +135 -134
- package/dist-types/ts3.4/models/models_0.d.ts +1 -1
- package/package.json +5 -5
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.ruleSet = void 0;
|
|
4
|
-
const
|
|
5
|
-
const a = "
|
|
6
|
-
const _data = { version: "1.0", parameters: { Region:
|
|
4
|
+
const q = "required", r = "fn", s = "argv", t = "ref";
|
|
5
|
+
const a = "isSet", b = "tree", c = "error", d = "endpoint", e = "PartitionResult", f = { [q]: false, "type": "String" }, g = { [q]: true, "default": false, "type": "Boolean" }, h = { [t]: "Endpoint" }, i = { [r]: "booleanEquals", [s]: [{ [t]: "UseFIPS" }, true] }, j = { [r]: "booleanEquals", [s]: [{ [t]: "UseDualStack" }, true] }, k = {}, l = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsFIPS"] }] }, m = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsDualStack"] }] }, n = [i], o = [j], p = [{ [t]: "Region" }];
|
|
6
|
+
const _data = { version: "1.0", parameters: { Region: f, UseDualStack: g, UseFIPS: g, Endpoint: f }, rules: [{ conditions: [{ [r]: a, [s]: [h] }], type: b, rules: [{ conditions: n, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { type: b, rules: [{ conditions: o, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: h, properties: k, headers: k }, type: d }] }] }, { type: b, rules: [{ conditions: [{ [r]: a, [s]: p }], type: b, rules: [{ conditions: [{ [r]: "aws.partition", [s]: p, assign: e }], type: b, rules: [{ conditions: [i, j], type: b, rules: [{ conditions: [l, m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://kinesisvideo-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: n, type: b, rules: [{ conditions: [l], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://kinesisvideo-fips.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: o, type: b, rules: [{ conditions: [m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://kinesisvideo.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { type: b, rules: [{ endpoint: { url: "https://kinesisvideo.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }] }, { error: "Invalid Configuration: Missing Region", type: c }] }] };
|
|
7
7
|
exports.ruleSet = _data;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
const
|
|
2
|
-
const a = "
|
|
3
|
-
const _data = { version: "1.0", parameters: { Region:
|
|
1
|
+
const q = "required", r = "fn", s = "argv", t = "ref";
|
|
2
|
+
const a = "isSet", b = "tree", c = "error", d = "endpoint", e = "PartitionResult", f = { [q]: false, "type": "String" }, g = { [q]: true, "default": false, "type": "Boolean" }, h = { [t]: "Endpoint" }, i = { [r]: "booleanEquals", [s]: [{ [t]: "UseFIPS" }, true] }, j = { [r]: "booleanEquals", [s]: [{ [t]: "UseDualStack" }, true] }, k = {}, l = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsFIPS"] }] }, m = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsDualStack"] }] }, n = [i], o = [j], p = [{ [t]: "Region" }];
|
|
3
|
+
const _data = { version: "1.0", parameters: { Region: f, UseDualStack: g, UseFIPS: g, Endpoint: f }, rules: [{ conditions: [{ [r]: a, [s]: [h] }], type: b, rules: [{ conditions: n, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { type: b, rules: [{ conditions: o, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: h, properties: k, headers: k }, type: d }] }] }, { type: b, rules: [{ conditions: [{ [r]: a, [s]: p }], type: b, rules: [{ conditions: [{ [r]: "aws.partition", [s]: p, assign: e }], type: b, rules: [{ conditions: [i, j], type: b, rules: [{ conditions: [l, m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://kinesisvideo-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: n, type: b, rules: [{ conditions: [l], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://kinesisvideo-fips.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: o, type: b, rules: [{ conditions: [m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://kinesisvideo.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { type: b, rules: [{ endpoint: { url: "https://kinesisvideo.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }] }, { error: "Invalid Configuration: Missing Region", type: c }] }] };
|
|
4
4
|
export const ruleSet = _data;
|
|
@@ -26,45 +26,43 @@ export interface GetClipCommandOutput extends Omit<GetClipOutput, "Payload">, __
|
|
|
26
26
|
* @public
|
|
27
27
|
* <p>Downloads an MP4 file (clip) containing the archived, on-demand media from the
|
|
28
28
|
* specified video stream over the specified time range. </p>
|
|
29
|
-
*
|
|
29
|
+
* <p>Both the StreamName and the StreamARN parameters are optional, but you must specify
|
|
30
30
|
* either the StreamName or the StreamARN when invoking this API operation. </p>
|
|
31
|
-
*
|
|
32
|
-
* <p>As a prerequisite to using GetCLip API, you must obtain an endpoint using
|
|
31
|
+
* <p>As a prerequisite to using GetCLip API, you must obtain an endpoint using
|
|
33
32
|
* <code>GetDataEndpoint</code>, specifying GET_CLIP for<code></code> the
|
|
34
33
|
* <code>APIName</code> parameter. </p>
|
|
35
|
-
*
|
|
34
|
+
* <p>An Amazon Kinesis video stream has the following requirements for providing data
|
|
36
35
|
* through MP4:</p>
|
|
37
|
-
*
|
|
36
|
+
* <ul>
|
|
38
37
|
* <li>
|
|
39
|
-
*
|
|
38
|
+
* <p>The media must contain h.264 or h.265 encoded video and, optionally, AAC or
|
|
40
39
|
* G.711 encoded audio. Specifically, the codec ID of track 1 should be
|
|
41
40
|
* <code>V_MPEG/ISO/AVC</code> (for h.264) or V_MPEGH/ISO/HEVC (for H.265).
|
|
42
41
|
* Optionally, the codec ID of track 2 should be <code>A_AAC</code> (for AAC) or
|
|
43
42
|
* A_MS/ACM (for G.711).</p>
|
|
44
43
|
* </li>
|
|
45
44
|
* <li>
|
|
46
|
-
*
|
|
45
|
+
* <p>Data retention must be greater than 0.</p>
|
|
47
46
|
* </li>
|
|
48
47
|
* <li>
|
|
49
|
-
*
|
|
48
|
+
* <p>The video track of each fragment must contain codec private data in the
|
|
50
49
|
* Advanced Video Coding (AVC) for H.264 format and HEVC for H.265 format. For more
|
|
51
50
|
* information, see <a href="https://www.iso.org/standard/55980.html">MPEG-4
|
|
52
51
|
* specification ISO/IEC 14496-15</a>. For information about adapting
|
|
53
52
|
* stream data to a given format, see <a href="http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html">NAL Adaptation Flags</a>.</p>
|
|
54
53
|
* </li>
|
|
55
54
|
* <li>
|
|
56
|
-
*
|
|
55
|
+
* <p>The audio track (if present) of each fragment must contain codec private data
|
|
57
56
|
* in the AAC format (<a href="https://www.iso.org/standard/43345.html">AAC
|
|
58
57
|
* specification ISO/IEC 13818-7</a>) or the <a href="http://www-mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html">MS
|
|
59
58
|
* Wave format</a>.</p>
|
|
60
59
|
* </li>
|
|
61
60
|
* </ul>
|
|
62
|
-
*
|
|
63
|
-
* <p>You can monitor the amount of outgoing data by monitoring the
|
|
61
|
+
* <p>You can monitor the amount of outgoing data by monitoring the
|
|
64
62
|
* <code>GetClip.OutgoingBytes</code> Amazon CloudWatch metric. For information about
|
|
65
63
|
* using CloudWatch to monitor Kinesis Video Streams, see <a href="http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html">Monitoring Kinesis Video Streams</a>. For pricing information, see <a href="https://aws.amazon.com/kinesis/video-streams/pricing/">Amazon Kinesis Video
|
|
66
|
-
*
|
|
67
|
-
* Pricing</a>. Charges for outgoing
|
|
64
|
+
* Streams Pricing</a> and <a href="https://aws.amazon.com/pricing/"> Amazon Web Services
|
|
65
|
+
* Pricing</a>. Charges for outgoing Amazon Web Services data apply.</p>
|
|
68
66
|
* @example
|
|
69
67
|
* Use a bare-bones client and the command you need to make an API call.
|
|
70
68
|
* ```javascript
|
|
@@ -75,7 +73,7 @@ export interface GetClipCommandOutput extends Omit<GetClipOutput, "Payload">, __
|
|
|
75
73
|
* StreamName: "STRING_VALUE",
|
|
76
74
|
* StreamARN: "STRING_VALUE",
|
|
77
75
|
* ClipFragmentSelector: { // ClipFragmentSelector
|
|
78
|
-
* FragmentSelectorType: "
|
|
76
|
+
* FragmentSelectorType: "PRODUCER_TIMESTAMP" || "SERVER_TIMESTAMP", // required
|
|
79
77
|
* TimestampRange: { // ClipTimestampRange
|
|
80
78
|
* StartTimestamp: new Date("TIMESTAMP"), // required
|
|
81
79
|
* EndTimestamp: new Date("TIMESTAMP"), // required
|
|
@@ -125,9 +123,9 @@ export interface GetClipCommandOutput extends Omit<GetClipOutput, "Payload">, __
|
|
|
125
123
|
*
|
|
126
124
|
* @throws {@link ResourceNotFoundException} (client fault)
|
|
127
125
|
* <p>
|
|
128
|
-
* <code>
|
|
126
|
+
* <code>GetImages</code> will throw this error when Kinesis Video Streams can't find the stream
|
|
129
127
|
* that you specified.</p>
|
|
130
|
-
*
|
|
128
|
+
* <p>
|
|
131
129
|
* <code>GetHLSStreamingSessionURL</code> and <code>GetDASHStreamingSessionURL</code> throw
|
|
132
130
|
* this error if a session with a <code>PlaybackMode</code> of <code>ON_DEMAND</code> or
|
|
133
131
|
* <code>LIVE_REPLAY</code>is requested for a stream that has no fragments within the
|
|
@@ -25,64 +25,62 @@ export interface GetDASHStreamingSessionURLCommandOutput extends GetDASHStreamin
|
|
|
25
25
|
* @public
|
|
26
26
|
* <p>Retrieves an MPEG Dynamic Adaptive Streaming over HTTP (DASH) URL for the stream. You
|
|
27
27
|
* can then open the URL in a media player to view the stream contents.</p>
|
|
28
|
-
*
|
|
29
|
-
* <p>Both the <code>StreamName</code> and the <code>StreamARN</code> parameters are
|
|
28
|
+
* <p>Both the <code>StreamName</code> and the <code>StreamARN</code> parameters are
|
|
30
29
|
* optional, but you must specify either the <code>StreamName</code> or the
|
|
31
30
|
* <code>StreamARN</code> when invoking this API operation.</p>
|
|
32
|
-
*
|
|
31
|
+
* <p>An Amazon Kinesis video stream has the following requirements for providing data
|
|
33
32
|
* through MPEG-DASH:</p>
|
|
34
|
-
*
|
|
33
|
+
* <ul>
|
|
35
34
|
* <li>
|
|
36
|
-
*
|
|
35
|
+
* <p>The media must contain h.264 or h.265 encoded video and, optionally, AAC or
|
|
37
36
|
* G.711 encoded audio. Specifically, the codec ID of track 1 should be
|
|
38
37
|
* <code>V_MPEG/ISO/AVC</code> (for h.264) or V_MPEGH/ISO/HEVC (for H.265).
|
|
39
38
|
* Optionally, the codec ID of track 2 should be <code>A_AAC</code> (for AAC) or
|
|
40
39
|
* A_MS/ACM (for G.711).</p>
|
|
41
40
|
* </li>
|
|
42
41
|
* <li>
|
|
43
|
-
*
|
|
42
|
+
* <p>Data retention must be greater than 0.</p>
|
|
44
43
|
* </li>
|
|
45
44
|
* <li>
|
|
46
|
-
*
|
|
45
|
+
* <p>The video track of each fragment must contain codec private data in the
|
|
47
46
|
* Advanced Video Coding (AVC) for H.264 format and HEVC for H.265 format. For more
|
|
48
47
|
* information, see <a href="https://www.iso.org/standard/55980.html">MPEG-4
|
|
49
48
|
* specification ISO/IEC 14496-15</a>. For information about adapting
|
|
50
49
|
* stream data to a given format, see <a href="http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html">NAL Adaptation Flags</a>.</p>
|
|
51
50
|
* </li>
|
|
52
51
|
* <li>
|
|
53
|
-
*
|
|
52
|
+
* <p>The audio track (if present) of each fragment must contain codec private data
|
|
54
53
|
* in the AAC format (<a href="https://www.iso.org/standard/43345.html">AAC
|
|
55
54
|
* specification ISO/IEC 13818-7</a>) or the <a href="http://www-mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html">MS
|
|
56
55
|
* Wave format</a>.</p>
|
|
57
56
|
* </li>
|
|
58
57
|
* </ul>
|
|
59
|
-
*
|
|
60
|
-
*
|
|
61
|
-
* <ol>
|
|
58
|
+
* <p>The following procedure shows how to use MPEG-DASH with Kinesis Video Streams:</p>
|
|
59
|
+
* <ol>
|
|
62
60
|
* <li>
|
|
63
|
-
*
|
|
61
|
+
* <p>Get an endpoint using <a href="http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_GetDataEndpoint.html">GetDataEndpoint</a>, specifying
|
|
64
62
|
* <code>GET_DASH_STREAMING_SESSION_URL</code> for the <code>APIName</code>
|
|
65
63
|
* parameter.</p>
|
|
66
64
|
* </li>
|
|
67
65
|
* <li>
|
|
68
|
-
*
|
|
66
|
+
* <p>Retrieve the MPEG-DASH URL using <code>GetDASHStreamingSessionURL</code>.
|
|
69
67
|
* Kinesis Video Streams creates an MPEG-DASH streaming session to be used for
|
|
70
68
|
* accessing content in a stream using the MPEG-DASH protocol.
|
|
71
69
|
* <code>GetDASHStreamingSessionURL</code> returns an authenticated URL (that
|
|
72
70
|
* includes an encrypted session token) for the session's MPEG-DASH
|
|
73
71
|
* <i>manifest</i> (the root resource needed for streaming with
|
|
74
72
|
* MPEG-DASH).</p>
|
|
75
|
-
*
|
|
76
|
-
*
|
|
73
|
+
* <note>
|
|
74
|
+
* <p>Don't share or store this token where an unauthorized entity can access
|
|
77
75
|
* it. The token provides access to the content of the stream. Safeguard the
|
|
78
|
-
* token with the same measures that you use with your
|
|
79
|
-
*
|
|
80
|
-
*
|
|
76
|
+
* token with the same measures that you use with your Amazon Web Services credentials.</p>
|
|
77
|
+
* </note>
|
|
78
|
+
* <p>The media that is made available through the manifest consists only of the
|
|
81
79
|
* requested stream, time range, and format. No other media data (such as frames
|
|
82
80
|
* outside the requested window or alternate bitrates) is made available.</p>
|
|
83
81
|
* </li>
|
|
84
82
|
* <li>
|
|
85
|
-
*
|
|
83
|
+
* <p>Provide the URL (containing the encrypted session token) for the MPEG-DASH
|
|
86
84
|
* manifest to a media player that supports the MPEG-DASH protocol. Kinesis Video
|
|
87
85
|
* Streams makes the initialization fragment and media fragments available through
|
|
88
86
|
* the manifest URL. The initialization fragment contains the codec private data
|
|
@@ -91,76 +89,75 @@ export interface GetDASHStreamingSessionURLCommandOutput extends GetDASHStreamin
|
|
|
91
89
|
* samples.</p>
|
|
92
90
|
* </li>
|
|
93
91
|
* <li>
|
|
94
|
-
*
|
|
92
|
+
* <p>The media player receives the authenticated URL and requests stream metadata
|
|
95
93
|
* and media data normally. When the media player requests data, it calls the
|
|
96
94
|
* following actions:</p>
|
|
97
|
-
*
|
|
95
|
+
* <ul>
|
|
98
96
|
* <li>
|
|
99
|
-
*
|
|
100
|
-
*
|
|
97
|
+
* <p>
|
|
98
|
+
* <b>GetDASHManifest:</b> Retrieves an MPEG DASH
|
|
101
99
|
* manifest, which contains the metadata for the media that you want to
|
|
102
100
|
* playback.</p>
|
|
103
|
-
*
|
|
101
|
+
* </li>
|
|
104
102
|
* <li>
|
|
105
|
-
*
|
|
106
|
-
*
|
|
103
|
+
* <p>
|
|
104
|
+
* <b>GetMP4InitFragment:</b> Retrieves the MP4
|
|
107
105
|
* initialization fragment. The media player typically loads the
|
|
108
106
|
* initialization fragment before loading any media fragments. This
|
|
109
107
|
* fragment contains the "<code>fytp</code>" and "<code>moov</code>" MP4
|
|
110
108
|
* atoms, and the child atoms that are needed to initialize the media
|
|
111
109
|
* player decoder.</p>
|
|
112
|
-
*
|
|
110
|
+
* <p>The initialization fragment does not correspond to a fragment in a
|
|
113
111
|
* Kinesis video stream. It contains only the codec private data for the
|
|
114
112
|
* stream and respective track, which the media player needs to decode the
|
|
115
113
|
* media frames.</p>
|
|
116
|
-
*
|
|
114
|
+
* </li>
|
|
117
115
|
* <li>
|
|
118
|
-
*
|
|
119
|
-
*
|
|
116
|
+
* <p>
|
|
117
|
+
* <b>GetMP4MediaFragment:</b> Retrieves MP4
|
|
120
118
|
* media fragments. These fragments contain the "<code>moof</code>" and
|
|
121
119
|
* "<code>mdat</code>" MP4 atoms and their child atoms, containing the
|
|
122
120
|
* encoded fragment's media frames and their timestamps. </p>
|
|
123
|
-
*
|
|
124
|
-
*
|
|
121
|
+
* <note>
|
|
122
|
+
* <p>After the first media fragment is made available in a streaming
|
|
125
123
|
* session, any fragments that don't contain the same codec private
|
|
126
124
|
* data cause an error to be returned when those different media
|
|
127
125
|
* fragments are loaded. Therefore, the codec private data should not
|
|
128
126
|
* change between fragments in a session. This also means that the
|
|
129
127
|
* session fails if the fragments in a stream change from having only
|
|
130
128
|
* video to having both audio and video.</p>
|
|
131
|
-
*
|
|
132
|
-
*
|
|
133
|
-
*
|
|
129
|
+
* </note>
|
|
130
|
+
* <p>Data retrieved with this action is billable. See <a href="https://aws.amazon.com/kinesis/video-streams/pricing/">Pricing</a> for details.</p>
|
|
131
|
+
* </li>
|
|
134
132
|
* </ul>
|
|
135
133
|
* </li>
|
|
136
134
|
* </ol>
|
|
137
|
-
*
|
|
135
|
+
* <note>
|
|
138
136
|
* <p>For restrictions that apply to MPEG-DASH sessions, see <a href="http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html">Kinesis Video Streams Limits</a>.</p>
|
|
139
|
-
*
|
|
140
|
-
*
|
|
137
|
+
* </note>
|
|
138
|
+
* <p>You can monitor the amount of data that the media player consumes by monitoring the
|
|
141
139
|
* <code>GetMP4MediaFragment.OutgoingBytes</code> Amazon CloudWatch metric. For
|
|
142
140
|
* information about using CloudWatch to monitor Kinesis Video Streams, see <a href="http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html">Monitoring Kinesis Video Streams</a>. For pricing information, see <a href="https://aws.amazon.com/kinesis/video-streams/pricing/">Amazon Kinesis Video
|
|
143
|
-
* Streams Pricing</a> and <a href="https://aws.amazon.com/pricing/">
|
|
144
|
-
* Pricing</a>. Charges for both HLS sessions and outgoing
|
|
145
|
-
*
|
|
141
|
+
* Streams Pricing</a> and <a href="https://aws.amazon.com/pricing/">Amazon Web Services
|
|
142
|
+
* Pricing</a>. Charges for both HLS sessions and outgoing Amazon Web Services data apply.</p>
|
|
143
|
+
* <p>For more information about HLS, see <a href="https://developer.apple.com/streaming/">HTTP Live Streaming</a> on the
|
|
146
144
|
* <a href="https://developer.apple.com">Apple Developer site</a>.</p>
|
|
147
|
-
*
|
|
148
|
-
* <important>
|
|
145
|
+
* <important>
|
|
149
146
|
* <p>If an error is thrown after invoking a Kinesis Video Streams archived media API,
|
|
150
147
|
* in addition to the HTTP status code and the response body, it includes the following
|
|
151
148
|
* pieces of information: </p>
|
|
152
149
|
* <ul>
|
|
153
150
|
* <li>
|
|
154
|
-
*
|
|
155
|
-
*
|
|
151
|
+
* <p>
|
|
152
|
+
* <code>x-amz-ErrorType</code> HTTP header – contains a more specific error
|
|
156
153
|
* type in addition to what the HTTP status code provides. </p>
|
|
157
|
-
*
|
|
154
|
+
* </li>
|
|
158
155
|
* <li>
|
|
159
|
-
*
|
|
160
|
-
*
|
|
161
|
-
*
|
|
156
|
+
* <p>
|
|
157
|
+
* <code>x-amz-RequestId</code> HTTP header – if you want to report an issue to
|
|
158
|
+
* Amazon Web Services the support team can better diagnose the problem if given the Request
|
|
162
159
|
* Id.</p>
|
|
163
|
-
*
|
|
160
|
+
* </li>
|
|
164
161
|
* </ul>
|
|
165
162
|
* <p>Both the HTTP status code and the ErrorType header can be utilized to make
|
|
166
163
|
* programmatic decisions about whether errors are retry-able and under what
|
|
@@ -169,7 +166,7 @@ export interface GetDASHStreamingSessionURLCommandOutput extends GetDASHStreamin
|
|
|
169
166
|
* <p>For more information, see the <b>Errors</b> section at
|
|
170
167
|
* the bottom of this topic, as well as <a href="https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html">Common Errors</a>.
|
|
171
168
|
* </p>
|
|
172
|
-
*
|
|
169
|
+
* </important>
|
|
173
170
|
* @example
|
|
174
171
|
* Use a bare-bones client and the command you need to make an API call.
|
|
175
172
|
* ```javascript
|
|
@@ -179,11 +176,11 @@ export interface GetDASHStreamingSessionURLCommandOutput extends GetDASHStreamin
|
|
|
179
176
|
* const input = { // GetDASHStreamingSessionURLInput
|
|
180
177
|
* StreamName: "STRING_VALUE",
|
|
181
178
|
* StreamARN: "STRING_VALUE",
|
|
182
|
-
* PlaybackMode: "
|
|
183
|
-
* DisplayFragmentTimestamp: "
|
|
184
|
-
* DisplayFragmentNumber: "
|
|
179
|
+
* PlaybackMode: "LIVE" || "LIVE_REPLAY" || "ON_DEMAND",
|
|
180
|
+
* DisplayFragmentTimestamp: "ALWAYS" || "NEVER",
|
|
181
|
+
* DisplayFragmentNumber: "ALWAYS" || "NEVER",
|
|
185
182
|
* DASHFragmentSelector: { // DASHFragmentSelector
|
|
186
|
-
* FragmentSelectorType: "
|
|
183
|
+
* FragmentSelectorType: "PRODUCER_TIMESTAMP" || "SERVER_TIMESTAMP",
|
|
187
184
|
* TimestampRange: { // DASHTimestampRange
|
|
188
185
|
* StartTimestamp: new Date("TIMESTAMP"),
|
|
189
186
|
* EndTimestamp: new Date("TIMESTAMP"),
|
|
@@ -230,9 +227,9 @@ export interface GetDASHStreamingSessionURLCommandOutput extends GetDASHStreamin
|
|
|
230
227
|
*
|
|
231
228
|
* @throws {@link ResourceNotFoundException} (client fault)
|
|
232
229
|
* <p>
|
|
233
|
-
* <code>
|
|
230
|
+
* <code>GetImages</code> will throw this error when Kinesis Video Streams can't find the stream
|
|
234
231
|
* that you specified.</p>
|
|
235
|
-
*
|
|
232
|
+
* <p>
|
|
236
233
|
* <code>GetHLSStreamingSessionURL</code> and <code>GetDASHStreamingSessionURL</code> throw
|
|
237
234
|
* this error if a session with a <code>PlaybackMode</code> of <code>ON_DEMAND</code> or
|
|
238
235
|
* <code>LIVE_REPLAY</code>is requested for a stream that has no fragments within the
|