How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AWS Kinesis Amazon Kinesis API

The Amazon Kinesis API from AWS Kinesis — 28 operation(s) for amazon kinesis.

AWS Kinesis Amazon Kinesis API is one of 32 APIs that AWS Kinesis publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Amazon Kinesis. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, pricing, and a getting-started guide.

This API exposes 28 operations across 28 paths, and defines 127 schemas. It is described by OpenAPI 3.2.0, at version 2013-12-02.

Requests are made against 4 base URLs: http://kinesis.{region}.amazonaws.com, https://kinesis.{region}.amazonaws.com, http://kinesis.{region}.amazonaws.com.cn, https://kinesis.{region}.amazonaws.com.cn.

28 operations 28 paths 127 schemas 28 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2013-12-02
Base URL
https://kinesisanalytics.{region}.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

AWS Kinesis Amazon Kinesis API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 28

Across 28 paths, the API surfaces 28 operations — 28 POST. Each is listed below with its method, path, parameters, and response codes.

Amazon Kinesis 28
POST
/#X-Amz-Target=Kinesis_20131202.AddTagsToStream
Add tags to stream
AddTagsToStream 8 params body → 200480481482483484
POST
/#X-Amz-Target=Kinesis_20131202.CreateStream
Create stream
CreateStream 8 params body → 200480481482
POST
/#X-Amz-Target=Kinesis_20131202.DecreaseStreamRetentionPeriod
Decrease stream retention period
DecreaseStreamRetentionPeriod 8 params body → 200480481482483484
POST
/#X-Amz-Target=Kinesis_20131202.DeleteStream
Delete stream
DeleteStream 8 params body → 200480481482483484
POST
/#X-Amz-Target=Kinesis_20131202.DeregisterStreamConsumer
Deregister stream consumer
DeregisterStreamConsumer 8 params body → 200480481482
POST
/#X-Amz-Target=Kinesis_20131202.DescribeLimits
Describe limits
DescribeLimits 8 params body → 200480
POST
/#X-Amz-Target=Kinesis_20131202.DescribeStream
Describe stream
DescribeStream 10 params body → 200480481482483
POST
/#X-Amz-Target=Kinesis_20131202.DescribeStreamConsumer
Describe stream consumer
DescribeStreamConsumer 8 params body → 200480481482
POST
/#X-Amz-Target=Kinesis_20131202.DescribeStreamSummary
Describe stream summary
DescribeStreamSummary 8 params body → 200480481482483
POST
/#X-Amz-Target=Kinesis_20131202.DisableEnhancedMonitoring
Disable enhanced monitoring
DisableEnhancedMonitoring 8 params body → 200480481482483484
POST
/#X-Amz-Target=Kinesis_20131202.EnableEnhancedMonitoring
Enable enhanced monitoring
EnableEnhancedMonitoring 8 params body → 200480481482483484
POST
/#X-Amz-Target=Kinesis_20131202.GetRecords
Get records
GetRecords 8 params body → 200480481482483484485486
POST
/#X-Amz-Target=Kinesis_20131202.GetShardIterator
Get shard iterator
GetShardIterator 8 params body → 200480481482483
POST
/#X-Amz-Target=Kinesis_20131202.IncreaseStreamRetentionPeriod
Increase stream retention period
IncreaseStreamRetentionPeriod 8 params body → 200480481482483484
POST
/#X-Amz-Target=Kinesis_20131202.ListShards
List shards
ListShards 8 params body → 200480481482483484485
POST
/#X-Amz-Target=Kinesis_20131202.ListStreamConsumers
List stream consumers
ListStreamConsumers 10 params body → 200480481482483484
POST
/#X-Amz-Target=Kinesis_20131202.ListStreams
List streams
ListStreams 10 params body → 200480481482
POST
/#X-Amz-Target=Kinesis_20131202.ListTagsForStream
List tags for stream
ListTagsForStream 8 params body → 200480481482483
POST
/#X-Amz-Target=Kinesis_20131202.MergeShards
Merge shards
MergeShards 8 params body → 200480481482483484485
POST
/#X-Amz-Target=Kinesis_20131202.PutRecord
Put record
PutRecord 8 params body → 200480481482483484485486
POST
/#X-Amz-Target=Kinesis_20131202.PutRecords
Put records
PutRecords 8 params body → 200480481482483484485486
POST
/#X-Amz-Target=Kinesis_20131202.RegisterStreamConsumer
Register stream consumer
RegisterStreamConsumer 8 params body → 200480481482483
POST
/#X-Amz-Target=Kinesis_20131202.RemoveTagsFromStream
Remove tags from stream
RemoveTagsFromStream 8 params body → 200480481482483484
POST
/#X-Amz-Target=Kinesis_20131202.SplitShard
Split shard
SplitShard 8 params body → 200480481482483484485
POST
/#X-Amz-Target=Kinesis_20131202.StartStreamEncryption
Start stream encryption
StartStreamEncryption 8 params body → 200480481482483484485486
POST
/#X-Amz-Target=Kinesis_20131202.StopStreamEncryption
Stop stream encryption
StopStreamEncryption 8 params body → 200480481482483484
POST
/#X-Amz-Target=Kinesis_20131202.UpdateShardCount
Update shard count
UpdateShardCount 8 params body → 200480481482483484485
POST
/#X-Amz-Target=Kinesis_20131202.UpdateStreamMode
Update stream mode
UpdateStreamMode 8 params body → 200480481482483

Schemas 127

The contract defines 127 schemas that model the data the API accepts and returns. The most detailed are StreamDescriptionSummary (11 properties), StreamDescription (11 properties), ListShardsInput (7 properties), PutRecordInput (6 properties). Each schema is shown below with its type and property counts.

PutRecordsResultEntry
object
Represents the result of an individual record from a PutRecords request. A record that is successfully added to a stream includes SequenceNumber and ShardId in…
4 properties
ShardId
string
KMSOptInRequired
ChildShardList
array
StreamMode
string
KeyId
string
StreamName
string
ResourceInUseException
ListTagsForStreamInput
object
Represents the input for ListTagsForStream .
4 properties
ListTagsForStreamInputLimit
integer
Tag
object
Metadata assigned to the stream, consisting of a key-value pair.
2 properties 1 required
EnableEnhancedMonitoringInput
object
Represents the input for EnableEnhancedMonitoring .
3 properties 1 required
ListShardsOutput
object
2 properties
GetShardIteratorOutput
object
Represents the output for GetShardIterator .
1 property
ShardFilter
object
The request parameter used to filter out the response of the ListShards API.
3 properties 1 required
PutRecordOutput
object
Represents the output for PutRecord .
3 properties 2 required
RegisterStreamConsumerInput
object
2 properties 2 required
DescribeStreamSummaryInput
object
2 properties
ListStreamConsumersInputLimit
integer
DescribeLimitsOutput
object
4 properties 4 required
PartitionKey
string
RecordList
array
EnhancedMetrics
object
Represents enhanced metrics types.
1 property
ShardIterator
string
Consumer
object
An object that represents the details of the consumer you registered. This type of object is returned by RegisterStreamConsumer .
4 properties 4 required
ListShardsInputLimit
integer
ListStreamConsumersOutput
object
2 properties
TagValue
string
ShardList
array
PutRecordsRequestEntry
object
Represents the output for PutRecords .
3 properties 2 required
ConsumerARN
string
StartStreamEncryptionInput
object
4 properties 2 required
ConsumerStatus
string
SequenceNumberRange
object
The range of possible sequence numbers for the shard.
2 properties 1 required
TagMap
object
StreamDescriptionSummary
object
Represents the output for DescribeStreamSummary
11 properties 7 required
Record
object
The unit of data of the Kinesis data stream, which is composed of a sequence number, a partition key, and a data blob.
5 properties 3 required
KMSInvalidStateException
RemoveTagsFromStreamInput
object
Represents the input for RemoveTagsFromStream .
3 properties 1 required
DeregisterStreamConsumerInput
object
3 properties
PutRecordsResultEntryList
array
ExpiredNextTokenException
DescribeStreamInput
object
Represents the input for DescribeStream .
4 properties
SplitShardInput
object
Represents the input for SplitShard .
4 properties 2 required
GetRecordsInput
object
Represents the input for GetRecords .
3 properties 1 required
ConsumerName
string
UpdateShardCountInput
object
4 properties 2 required
ScalingType
string
ListStreamsInput
object
Represents the input for ListStreams .
3 properties
ShardIteratorType
string
EncryptionType
string
NextToken
string
ConsumerCountObject
integer
CreateStreamInput
object
Represents the input for CreateStream .
3 properties 1 required
StreamSummary
object
The summary of a stream.
5 properties 3 required
ConsumerDescription
object
An object that represents the details of a registered consumer. This type of object is returned by DescribeStreamConsumer .
5 properties 5 required
StreamARN
string
GetRecordsInputLimit
integer
StreamDescription
object
Represents the output for DescribeStream .
11 properties 8 required
BooleanObject
boolean
EnhancedMonitoringOutput
object
Represents the output for EnableEnhancedMonitoring and DisableEnhancedMonitoring .
4 properties
SequenceNumber
string
InvalidArgumentException
UpdateShardCountOutput
object
4 properties
DescribeStreamOutput
object
Represents the output for DescribeStream .
1 property 1 required
ShardFilterType
string
ErrorCode
string
ConsumerList
array
ProvisionedThroughputExceededException
RegisterStreamConsumerOutput
object
1 property 1 required
TagKey
string
MergeShardsInput
object
Represents the input for MergeShards .
4 properties 2 required
ErrorMessage
string
TagList
array
DescribeStreamConsumerInput
object
3 properties
ValidationException
DecreaseStreamRetentionPeriodInput
object
Represents the input for DecreaseStreamRetentionPeriod .
3 properties 1 required
PutRecordsOutput
object
PutRecords results.
3 properties 1 required
DeleteStreamInput
object
Represents the input for DeleteStream .
3 properties
TagKeyList
array
MetricsNameList
array
GetShardIteratorInput
object
Represents the input for GetShardIterator .
6 properties 2 required
ListTagsForStreamOutput
object
Represents the output for ListTagsForStream .
2 properties 2 required
MillisBehindLatest
integer
Data
string
KMSAccessDeniedException
DescribeStreamConsumerOutput
object
1 property 1 required
ShardCountObject
integer
HashKeyRange
object
The range of possible hash key values for the shard, which is a set of ordered contiguous positive integers.
2 properties 2 required
Timestamp
string
LimitExceededException
OnDemandStreamCountObject
integer
PutRecordInput
object
Represents the input for PutRecord .
6 properties 2 required
ListStreamConsumersInput
object
4 properties 1 required
KMSNotFoundException
KMSDisabledException
StopStreamEncryptionInput
object
4 properties 2 required
DescribeStreamSummaryOutput
object
1 property 1 required
Shard
object
A uniquely identified group of data records in a Kinesis data stream.
5 properties 3 required
ResourceNotFoundException
PutRecordsInput
object
A PutRecords request.
3 properties 1 required
AccessDeniedException
ChildShard
object
Output parameter of the GetRecords API. The existing child shard of the current shard.
3 properties 3 required
ShardIdList
array
StreamStatus
string
ListStreamsInputLimit
integer
RetentionPeriodHours
integer
PositiveIntegerObject
integer
ExpiredIteratorException
IncreaseStreamRetentionPeriodInput
object
Represents the input for IncreaseStreamRetentionPeriod .
3 properties 1 required
StreamNameList
array
UpdateStreamModeInput
object
2 properties 2 required
AddTagsToStreamInput
object
Represents the input for AddTagsToStream .
3 properties 1 required
MetricsName
string
EnhancedMonitoringList
array
OnDemandStreamCountLimitObject
integer
GetRecordsOutput
object
Represents the output for GetRecords .
4 properties 1 required
StreamModeDetails
object
Specifies the capacity mode to which you want to set your data stream. Currently, in Kinesis Data Streams, you can choose between an on-demand capacity mode an…
1 property 1 required
ListShardsInput
object
7 properties
HashKey
string
DescribeStreamInputLimit
integer
DisableEnhancedMonitoringInput
object
Represents the input for DisableEnhancedMonitoring .
3 properties 1 required
StreamSummaryList
array
PutRecordsRequestEntryList
array
KMSThrottlingException
DescribeLimitsInput
object
ListStreamsOutput
object
Represents the output for ListStreams .
4 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kinesis-amazon-kinesis-api-openapi.yml Raw ↑

Other APIs AWS Kinesis publishes across the network.

Amazon Managed Service for Apache Flink API
AWS Kinesis ListStreams API
AWS Kinesis Amazon Kinesis Analytics API
AWS Kinesis Amazon Kinesis Firehose API
AWS Kinesis Create Signaling Channel API
AWS Kinesis Create Stream API
AWS Kinesis Delete Signaling Channel API
AWS Kinesis Delete Stream API
AWS Kinesis Describe Edge Configuration API
AWS Kinesis Describe Image Generation Configuration API
AWS Kinesis Describe Mapped Resource Configuration API
AWS Kinesis Describe Media Storage Configuration API
Where this information came from

This is an independent, third-party profile of AWS Kinesis Amazon Kinesis API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.