Skip to content

Commit 3ec9ad0

Browse files
author
awstools
committed
docs(client-kinesis-video): Docs only build to bring up-to-date with public docs.
1 parent 90a90eb commit 3ec9ad0

File tree

5 files changed

+31
-27
lines changed

5 files changed

+31
-27
lines changed

clients/client-kinesis-video/src/commands/DescribeMediaStorageConfigurationCommand.ts

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,10 +42,7 @@ export interface DescribeMediaStorageConfigurationCommandOutput
4242

4343
/**
4444
* @public
45-
* <important>
46-
* <p>This API is related to <a href="https://docs.aws.amazon.com/kinesisvideostreams-webrtc-dg/latest/devguide/webrtc-ingestion.html">WebRTC Ingestion</a> and is only available in the <code>us-west-2</code> region.</p>
47-
* </important>
48-
* <p>Returns the most current information about the channel. Specify the <code>ChannelName</code>
45+
* <p>Returns the most current information about the channel. Specify the <code>ChannelName</code>
4946
* or <code>ChannelARN</code> in the input.</p>
5047
* @example
5148
* Use a bare-bones client and the command you need to make an API call.

clients/client-kinesis-video/src/commands/UpdateDataRetentionCommand.ts

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,13 +37,10 @@ export interface UpdateDataRetentionCommandOutput extends UpdateDataRetentionOut
3737

3838
/**
3939
* @public
40-
* <p> Increases or decreases the stream's data retention period by the value that you
40+
* <p>Increases or decreases the stream's data retention period by the value that you
4141
* specify. To indicate whether you want to increase or decrease the data retention period,
4242
* specify the <code>Operation</code> parameter in the request body. In the request, you
4343
* must specify either the <code>StreamName</code> or the <code>StreamARN</code>. </p>
44-
* <note>
45-
* <p>The retention period that you specify replaces the current value.</p>
46-
* </note>
4744
* <p>This operation requires permission for the
4845
* <code>KinesisVideo:UpdateDataRetention</code> action.</p>
4946
* <p>Changing the data retention period affects the data in the stream as

clients/client-kinesis-video/src/commands/UpdateMediaStorageConfigurationCommand.ts

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -42,19 +42,17 @@ export interface UpdateMediaStorageConfigurationCommandOutput
4242

4343
/**
4444
* @public
45-
* <important>
46-
* <p>This API is related to <a href="https://docs.aws.amazon.com/kinesisvideostreams-webrtc-dg/latest/devguide/webrtc-ingestion.html">WebRTC Ingestion</a> and is only available in the <code>us-west-2</code> region.</p>
47-
* </important>
48-
* <p>Associates a <code>SignalingChannel</code> to a stream to store the media. There are two signaling modes that
49-
* can specified :</p>
45+
* <p>Associates a <code>SignalingChannel</code> to a stream to store the media. There are
46+
* two signaling modes that you can specify :</p>
5047
* <ul>
5148
* <li>
52-
* <p>If the <code>StorageStatus</code> is disabled, no data will be stored,
53-
* and the <code>StreamARN</code> parameter will not be needed. </p>
49+
* <p>If <code>StorageStatus</code> is enabled, the data will be stored in the
50+
* <code>StreamARN</code> provided. In order for WebRTC Ingestion to work, the stream must have data retention
51+
* enabled.</p>
5452
* </li>
5553
* <li>
56-
* <p>If the <code>StorageStatus</code> is enabled, the data will be stored in the
57-
* <code>StreamARN</code> provided. </p>
54+
* <p>If <code>StorageStatus</code> is disabled, no data will be stored, and the
55+
* <code>StreamARN</code> parameter will not be needed. </p>
5856
* </li>
5957
* </ul>
6058
* <important>

clients/client-kinesis-video/src/models/models_0.ts

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1375,12 +1375,24 @@ export type MediaStorageConfigurationStatus =
13751375

13761376
/**
13771377
* @public
1378-
* <p>A structure that encapsulates, or contains, the media storage configuration properties.</p>
1378+
* <p>A structure that encapsulates, or contains, the media storage configuration
1379+
* properties.</p>
1380+
* <ul>
1381+
* <li>
1382+
* <p>If <code>StorageStatus</code> is enabled, the data will be stored in the
1383+
* <code>StreamARN</code> provided. In order for WebRTC Ingestion to work, the stream must have data retention
1384+
* enabled.</p>
1385+
* </li>
1386+
* <li>
1387+
* <p>If <code>StorageStatus</code> is disabled, no data will be stored, and the
1388+
* <code>StreamARN</code> parameter will not be needed. </p>
1389+
* </li>
1390+
* </ul>
13791391
*/
13801392
export interface MediaStorageConfiguration {
13811393
/**
13821394
* @public
1383-
* <p>The Amazon Resource Name (ARN) of the stream </p>
1395+
* <p>The Amazon Resource Name (ARN) of the stream. </p>
13841396
*/
13851397
StreamARN?: string;
13861398

@@ -2254,8 +2266,8 @@ export interface UpdateDataRetentionInput {
22542266

22552267
/**
22562268
* @public
2257-
* <p>The retention period, in hours. The value you specify replaces the current value.
2258-
* The maximum value for this parameter is 87600 (ten years).</p>
2269+
* <p>The number of hours to adjust the current retention by. The value you specify is added to or subtracted from the current value, depending on the <code>operation</code>.</p>
2270+
* <p>The minimum value for data retention is 0 and the maximum value is 87600 (ten years).</p>
22592271
*/
22602272
DataRetentionChangeInHours: number | undefined;
22612273
}

codegen/sdk-codegen/aws-models/kinesis-video.json

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1014,7 +1014,7 @@
10141014
}
10151015
],
10161016
"traits": {
1017-
"smithy.api#documentation": "<important>\n <p>This API is related to <a href=\"https://docs.aws.amazon.com/kinesisvideostreams-webrtc-dg/latest/devguide/webrtc-ingestion.html\">WebRTC Ingestion</a> and is only available in the <code>us-west-2</code> region.</p>\n </important>\n <p>Returns the most current information about the channel. Specify the <code>ChannelName</code>\n or <code>ChannelARN</code> in the input.</p>",
1017+
"smithy.api#documentation": "<p>Returns the most current information about the channel. Specify the <code>ChannelName</code>\n or <code>ChannelARN</code> in the input.</p>",
10181018
"smithy.api#http": {
10191019
"method": "POST",
10201020
"uri": "/describeMediaStorageConfiguration",
@@ -3310,7 +3310,7 @@
33103310
"StreamARN": {
33113311
"target": "com.amazonaws.kinesisvideo#ResourceARN",
33123312
"traits": {
3313-
"smithy.api#documentation": "<p>The Amazon Resource Name (ARN) of the stream </p>"
3313+
"smithy.api#documentation": "<p>The Amazon Resource Name (ARN) of the stream. </p>"
33143314
}
33153315
},
33163316
"Status": {
@@ -3322,7 +3322,7 @@
33223322
}
33233323
},
33243324
"traits": {
3325-
"smithy.api#documentation": "<p>A structure that encapsulates, or contains, the media storage configuration properties.</p>"
3325+
"smithy.api#documentation": "<p>A structure that encapsulates, or contains, the media storage configuration\n properties.</p>\n <ul>\n <li>\n <p>If <code>StorageStatus</code> is enabled, the data will be stored in the\n <code>StreamARN</code> provided. In order for WebRTC Ingestion to work, the stream must have data retention\n enabled.</p>\n </li>\n <li>\n <p>If <code>StorageStatus</code> is disabled, no data will be stored, and the\n <code>StreamARN</code> parameter will not be needed. </p>\n </li>\n </ul>"
33263326
}
33273327
},
33283328
"com.amazonaws.kinesisvideo#MediaStorageConfigurationStatus": {
@@ -4361,7 +4361,7 @@
43614361
}
43624362
],
43634363
"traits": {
4364-
"smithy.api#documentation": "<p> Increases or decreases the stream's data retention period by the value that you\n specify. To indicate whether you want to increase or decrease the data retention period,\n specify the <code>Operation</code> parameter in the request body. In the request, you\n must specify either the <code>StreamName</code> or the <code>StreamARN</code>. </p>\n <note>\n <p>The retention period that you specify replaces the current value.</p>\n </note>\n <p>This operation requires permission for the\n <code>KinesisVideo:UpdateDataRetention</code> action.</p>\n <p>Changing the data retention period affects the data in the stream as\n follows:</p>\n <ul>\n <li>\n <p>If the data retention period is increased, existing data is retained for\n the new retention period. For example, if the data retention period is increased\n from one hour to seven hours, all existing data is retained for seven\n hours.</p>\n </li>\n <li>\n <p>If the data retention period is decreased, existing data is retained for\n the new retention period. For example, if the data retention period is decreased\n from seven hours to one hour, all existing data is retained for one hour, and\n any data older than one hour is deleted immediately.</p>\n </li>\n </ul>",
4364+
"smithy.api#documentation": "<p>Increases or decreases the stream's data retention period by the value that you\n specify. To indicate whether you want to increase or decrease the data retention period,\n specify the <code>Operation</code> parameter in the request body. In the request, you\n must specify either the <code>StreamName</code> or the <code>StreamARN</code>. </p>\n <p>This operation requires permission for the\n <code>KinesisVideo:UpdateDataRetention</code> action.</p>\n <p>Changing the data retention period affects the data in the stream as\n follows:</p>\n <ul>\n <li>\n <p>If the data retention period is increased, existing data is retained for\n the new retention period. For example, if the data retention period is increased\n from one hour to seven hours, all existing data is retained for seven\n hours.</p>\n </li>\n <li>\n <p>If the data retention period is decreased, existing data is retained for\n the new retention period. For example, if the data retention period is decreased\n from seven hours to one hour, all existing data is retained for one hour, and\n any data older than one hour is deleted immediately.</p>\n </li>\n </ul>",
43654365
"smithy.api#http": {
43664366
"method": "POST",
43674367
"uri": "/updateDataRetention",
@@ -4401,7 +4401,7 @@
44014401
"DataRetentionChangeInHours": {
44024402
"target": "com.amazonaws.kinesisvideo#DataRetentionChangeInHours",
44034403
"traits": {
4404-
"smithy.api#documentation": "<p>The retention period, in hours. The value you specify replaces the current value.\n The maximum value for this parameter is 87600 (ten years).</p>",
4404+
"smithy.api#documentation": "<p>The number of hours to adjust the current retention by. The value you specify is added to or subtracted from the current value, depending on the <code>operation</code>.</p>\n <p>The minimum value for data retention is 0 and the maximum value is 87600 (ten years).</p>",
44054405
"smithy.api#required": {}
44064406
}
44074407
}
@@ -4533,7 +4533,7 @@
45334533
}
45344534
],
45354535
"traits": {
4536-
"smithy.api#documentation": "<important>\n <p>This API is related to <a href=\"https://docs.aws.amazon.com/kinesisvideostreams-webrtc-dg/latest/devguide/webrtc-ingestion.html\">WebRTC Ingestion</a> and is only available in the <code>us-west-2</code> region.</p>\n </important>\n <p>Associates a <code>SignalingChannel</code> to a stream to store the media. There are two signaling modes that \n can specified :</p>\n <ul>\n <li>\n <p>If the <code>StorageStatus</code> is disabled, no data will be stored,\n and the <code>StreamARN</code> parameter will not be needed. </p>\n </li>\n <li>\n <p>If the <code>StorageStatus</code> is enabled, the data will be stored in the \n <code>StreamARN</code> provided. </p>\n </li>\n </ul>\n <important>\n <p>If <code>StorageStatus</code> is enabled, direct peer-to-peer (master-viewer) connections no\n longer occur. Peers connect directly to the storage session. You must call the\n <code>JoinStorageSession</code> API to trigger an SDP offer send and establish a\n connection between a peer and the storage session. </p>\n </important>",
4536+
"smithy.api#documentation": "<p>Associates a <code>SignalingChannel</code> to a stream to store the media. There are\n two signaling modes that you can specify :</p>\n <ul>\n <li>\n <p>If <code>StorageStatus</code> is enabled, the data will be stored in the\n <code>StreamARN</code> provided. In order for WebRTC Ingestion to work, the stream must have data retention\n enabled.</p>\n </li>\n <li>\n <p>If <code>StorageStatus</code> is disabled, no data will be stored, and the\n <code>StreamARN</code> parameter will not be needed. </p>\n </li>\n </ul>\n <important>\n <p>If <code>StorageStatus</code> is enabled, direct peer-to-peer (master-viewer) connections no\n longer occur. Peers connect directly to the storage session. You must call the\n <code>JoinStorageSession</code> API to trigger an SDP offer send and establish a\n connection between a peer and the storage session. </p>\n </important>",
45374537
"smithy.api#http": {
45384538
"method": "POST",
45394539
"uri": "/updateMediaStorageConfiguration",

0 commit comments

Comments
 (0)