AWS kinesisvideostreams documentation change
Summary
Removed entire API documentation content for CreateStream operation including parameters, examples, errors, and references.
Security assessment
The change deletes all technical documentation without adding or modifying security content. While the removed documentation included security parameters (KmsKeyId), the deletion itself doesn't address vulnerabilities nor provide evidence of security fixes.
Diff
diff --git a/kinesisvideostreams/latest/dg/API_CreateStream.md b/kinesisvideostreams/latest/dg/API_CreateStream.md index ac22b2c9d..8b1378917 100644 --- a//kinesisvideostreams/latest/dg/API_CreateStream.md +++ b//kinesisvideostreams/latest/dg/API_CreateStream.md @@ -1 +0,0 @@ -[View a markdown version of this page](API_CreateStream.md) @@ -3,294 +1,0 @@ -[](/pdfs/kinesisvideostreams/latest/dg/kinesisvideo-dg.pdf#API_CreateStream "Open PDF") - -[Documentation](/index.html)[Amazon Kinesis Video Streams](/kinesis/index.html)[Developer Guide](what-is-kinesis-video.html) - -Request SyntaxURI Request ParametersRequest BodyResponse SyntaxResponse ElementsErrorsSee Also - -# CreateStream - -Creates a new Kinesis video stream. - -When you create a new stream, Kinesis Video Streams assigns it a version number. When you change the stream's metadata, Kinesis Video Streams updates the version. - -`CreateStream` is an asynchronous operation. - -For information about how the service works, see [How it Works](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-it-works.html). - -You must have permissions for the `KinesisVideo:CreateStream` action. - -## Request Syntax - - - POST /createStream HTTP/1.1 - Content-type: application/json - - { - "DataRetentionInHours": number, - "DeviceName": "string", - "KmsKeyId": "string", - "MediaType": "string", - "StreamName": "string", - "StreamStorageConfiguration": { - "[DefaultStorageTier](./API_StreamStorageConfiguration.html#KinesisVideo-Type-StreamStorageConfiguration-DefaultStorageTier)": "string" - }, - "Tags": { - "string" : "string" - } - } - -## URI Request Parameters - -The request does not use any URI parameters. - -## Request Body - -The request accepts the following data in JSON format. - -**DataRetentionInHours ** - - -The number of hours that you want to retain the data in the stream. Kinesis Video Streams retains the data in a data store that is associated with the stream. - -The default value is 0, indicating that the stream does not persist data. The minimum is 1 hour. - -When the `DataRetentionInHours` value is 0, consumers can still consume the fragments that remain in the service host buffer, which has a retention time limit of 5 minutes and a retention memory limit of 200 MB. Fragments are removed from the buffer when either limit is reached. - -Type: Integer - -Valid Range: Minimum value of 0. - -Required: No - -**DeviceName ** - - -The name of the device that is writing to the stream. - -###### Note - -In the current implementation, Kinesis Video Streams doesn't use this name. - -Type: String - -Length Constraints: Minimum length of 1. Maximum length of 128. - -Pattern: `[a-zA-Z0-9_.-]+` - -Required: No - -**KmsKeyId ** - - -The ID of the AWS Key Management Service (AWS KMS) key that you want Kinesis Video Streams to use to encrypt stream data. - -If no key ID is specified, the default, Kinesis Video-managed key (`aws/kinesisvideo`) is used. - -For more information, see [DescribeKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters). - -Type: String - -Length Constraints: Minimum length of 1. Maximum length of 2048. - -Pattern: `.+` - -Required: No - -**MediaType ** - - -The media type of the stream. Consumers of the stream can use this information when processing the stream. For more information about media types, see [Media Types](http://www.iana.org/assignments/media-types/media-types.xhtml). If you choose to specify the `MediaType`, see [Naming Requirements](https://tools.ietf.org/html/rfc6838#section-4.2) for guidelines. - -Example valid values include "video/h264" and "video/h264,audio/aac". - -This parameter is optional; the default value is `null` (or empty in JSON). - -Type: String - -Length Constraints: Minimum length of 1. Maximum length of 128. - -Pattern: `[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*` - -Required: No - -**StreamName ** - - -A name for the stream that you are creating. - -The stream name is an identifier for the stream, and must be unique for each account and region. - -Type: String - -Length Constraints: Minimum length of 1. Maximum length of 256. - -Pattern: `[a-zA-Z0-9_.-]+` - -Required: Yes - -**StreamStorageConfiguration ** - - -The configuration for the stream's storage, including the default storage tier for stream data. This configuration determines how stream data is stored and accessed, with different tiers offering varying levels of performance and cost optimization. - -If not specified, the stream will use the default storage configuration with HOT tier for optimal performance. - -Type: [StreamStorageConfiguration](./API_StreamStorageConfiguration.html) object - -Required: No - -**Tags ** - - -A list of tags to associate with the specified stream. Each tag is a key-value pair (the value is optional). - -Type: String to string map - -Map Entries: Maximum number of 50 items. - -Key Length Constraints: Minimum length of 1. Maximum length of 128. - -Key Pattern: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` - -Value Length Constraints: Minimum length of 0. Maximum length of 256. - -Value Pattern: `[\p{L}\p{Z}\p{N}_.:/=+\-@]*` - -Required: No - -## Response Syntax - - - HTTP/1.1 200 - Content-type: application/json - - { - "StreamARN": "**_string_** " - } - -## Response Elements - -If the action is successful, the service sends back an HTTP 200 response. - -The following data is returned in JSON format by the service. - -**StreamARN ** - - -The Amazon Resource Name (ARN) of the stream. - -Type: String - -Length Constraints: Minimum length of 1. Maximum length of 1024. - -Pattern: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` - -## Errors - -For information about the errors that are common to all actions, see [Common Error Types](./CommonErrors.html). - -**AccountStreamLimitExceededException** - - -The number of streams created for the account is too high. -