Kinesis¶
Installation¶
To install the Kinesis client:
Client¶
AsyncKinesisClient
¶
Bases: AsyncClient[AsyncKinesisConfig]
Amazon Kinesis Data Streams is a managed service that scales elastically for real-time processing of streaming big data.
Operations¶
add_tags_to_streamcreate_channelcreate_streamdecrease_stream_retention_perioddelete_channeldelete_resource_policydelete_streamderegister_stream_consumerdescribe_account_settingsdescribe_channeldescribe_limitsdescribe_streamdescribe_stream_consumerdescribe_stream_summarydisable_enhanced_monitoringenable_enhanced_monitoringget_recordsget_resource_policyget_shard_iteratorincrease_stream_retention_periodlist_channelslist_shardslist_stream_consumerslist_streamslist_tags_for_resourcelist_tags_for_streammerge_shardsput_recordput_recordsput_resource_policyregister_stream_consumerremove_tags_from_streamsplit_shardstart_stream_encryptionstop_stream_encryptionsubscribe_to_shardtag_resourceuntag_resourceupdate_account_settingsupdate_channelupdate_max_record_sizeupdate_shard_countupdate_stream_modeupdate_stream_record_distribution_strategyupdate_stream_warm_throughput
Configuration¶
AsyncKinesisConfig
dataclass
¶
Bases: AsyncAwsConfig
Kinesis configuration (async-resolved).
Attributes¶
account_id_endpoint_mode
class-attribute
instance-attribute
¶
account_id_endpoint_mode: str | None = None
The AccountId Endpoint Mode. Defaults to preferred.
auth_scheme_resolver
class-attribute
instance-attribute
¶
An auth scheme resolver that determines the auth scheme for each operation.
auth_schemes
class-attribute
instance-attribute
¶
A map of auth scheme ids to auth schemes.
aws_access_key_id
class-attribute
instance-attribute
¶
aws_access_key_id: str | None = None
The identifier for a secret access key.
aws_credentials_identity_resolver
class-attribute
instance-attribute
¶
aws_credentials_identity_resolver: AsyncIdentityResolver[AWSCredentialsIdentity, AWSIdentityProperties] | None = None
Resolves AWS Credentials. Required for operations that use Sigv4 Auth.
aws_secret_access_key
class-attribute
instance-attribute
¶
aws_secret_access_key: str | None = None
A secret access key that can be used to sign requests.
aws_session_token
class-attribute
instance-attribute
¶
aws_session_token: str | None = None
The session token used with temporary AWS credentials.
endpoint_resolver
class-attribute
instance-attribute
¶
The endpoint resolver used to resolve the final endpoint per-operation based on the configuration.
interceptors
class-attribute
instance-attribute
¶
The list of interceptors, which are hooks that are called during the execution of a request.
protocol
class-attribute
instance-attribute
¶
Pass a protocol class reference from smithy_aws_core.aio.protocols to select the protocol, e.g. protocol=AsyncAwsJson10ClientProtocol. For custom protocols a protocol instance may also be passed.
region
class-attribute
instance-attribute
¶
region: str | None = None
The AWS region to connect to. The configured region is used to determine the service endpoint.
sdk_ua_app_id
class-attribute
instance-attribute
¶
sdk_ua_app_id: str | None = None
A unique and opaque application ID that is appended to the User-Agent header.
use_dualstack_endpoint
class-attribute
instance-attribute
¶
use_dualstack_endpoint: bool | None = None
When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
use_fips_endpoint
class-attribute
instance-attribute
¶
use_fips_endpoint: bool | None = None
When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.
user_agent_extra
class-attribute
instance-attribute
¶
user_agent_extra: str | None = None
Additional suffix to be added to the User-Agent header.
Methods:¶
resolve
async
classmethod
¶
resolve(*, profile: str | None = None, fs: AsyncFileSystem | None = None, config_file_path: str | None = None, credentials_file_path: str | None = None, **overrides: Unpack[_AsyncKinesisConfigOverrides]) -> Self
Resolve config from environment, config files, defaults, and explicit overrides.
Plugin
module-attribute
¶
Plugin: TypeAlias = Callable[[AsyncKinesisConfig], None]
A callable that customizes a client configuration. Service-level plugins are applied once to the base configuration inherited by every operation. Operation-level plugins apply only to a single operation invocation.
Structures¶
ChannelDescriptionChannelEncryptionConfigurationChannelLoggingConfigurationChannelLoggingUpdateInputChannelStreamConfigurationChannelStreamDescriptionChannelStreamIdentifierChannelSummaryChildShardCloudWatchLogsCloudWatchLogsUpdateInputConsumerConsumerDescriptionDeadLetterQueueS3ConfigurationEnhancedMetricsHashKeyRangeMinimumThroughputBillingCommitmentInputMinimumThroughputBillingCommitmentOutputPartitionFieldPartitionSpecPutRecordsRequestEntryPutRecordsResultEntryRecordRecordConfigurationS3DestinationConfigurationS3DestinationDescriptionS3DestinationUpdateInputS3StorageConfigurationS3TablesConfigurationS3TablesDestinationConfigurationS3TablesDestinationDescriptionS3TablesDestinationUpdateInputSequenceNumberRangeShardShardFilterStartingPositionStreamDescriptionStreamDescriptionSummaryStreamFilterStreamModeDetailsStreamSummarySubscribeToShardEventTagWarmThroughputObject
Errors¶
AccessDeniedExceptionDryRunOperationExceptionExpiredIteratorExceptionExpiredNextTokenExceptionInternalFailureExceptionInvalidArgumentExceptionKMSAccessDeniedExceptionKMSDisabledExceptionKMSInvalidStateExceptionKMSNotFoundExceptionKMSOptInRequiredKMSThrottlingExceptionLimitExceededExceptionProvisionedThroughputExceededExceptionResourceInUseExceptionResourceNotFoundExceptionServiceErrorValidationException
Unions¶
Enums¶
ChannelDestinationTypeChannelEncryptionTypeChannelStatusConsumerStatusEncryptionTypeMetricsNameMinimumThroughputBillingCommitmentInputStatusMinimumThroughputBillingCommitmentOutputStatusPartitionTransformRecordDistributionStrategyRecordFormatTypeS3CompressionTypeS3StorageClassS3TablesCompressionTypeScalingTypeShardFilterTypeShardIteratorTypeStreamModeStreamStatus