IVSClient#
Auto-generated documentation for IVS type annotations stubs module mypy-boto3-ivs.
IVSClient#
Type annotations and code completion for boto3.client("ivs")
.
boto3 documentation
# IVSClient usage example
from boto3.session import Session
from mypy_boto3_ivs.client import IVSClient
def get_ivs_client() -> IVSClient:
return Session().client("ivs")
Exceptions#
boto3
client exceptions are generated in runtime.
This class provides code completion for boto3.client("ivs").exceptions
structure.
# Exceptions.exceptions usage example
client = boto3.client("ivs")
try:
do_something(client)
except (
client.exceptions.AccessDeniedException,
client.exceptions.ChannelNotBroadcasting,
client.exceptions.ClientError,
client.exceptions.ConflictException,
client.exceptions.InternalServerException,
client.exceptions.PendingVerification,
client.exceptions.ResourceNotFoundException,
client.exceptions.ServiceQuotaExceededException,
client.exceptions.StreamUnavailable,
client.exceptions.ThrottlingException,
client.exceptions.ValidationException,
) as e:
print(e)
# Exceptions.exceptions type checking example
from mypy_boto3_ivs.client import Exceptions
def handle_error(exc: Exceptions.AccessDeniedException) -> None:
...
Methods#
batch_get_channel#
Performs GetChannel on multiple ARNs simultaneously.
Type annotations and code completion for boto3.client("ivs").batch_get_channel
method.
boto3 documentation
# batch_get_channel method definition
def batch_get_channel(
self,
*,
arns: Sequence[str],
) -> BatchGetChannelResponseTypeDef: # (1)
...
# batch_get_channel method usage example with argument unpacking
kwargs: BatchGetChannelRequestRequestTypeDef = { # (1)
"arns": ...,
}
parent.batch_get_channel(**kwargs)
batch_get_stream_key#
Performs GetStreamKey on multiple ARNs simultaneously.
Type annotations and code completion for boto3.client("ivs").batch_get_stream_key
method.
boto3 documentation
# batch_get_stream_key method definition
def batch_get_stream_key(
self,
*,
arns: Sequence[str],
) -> BatchGetStreamKeyResponseTypeDef: # (1)
...
# batch_get_stream_key method usage example with argument unpacking
kwargs: BatchGetStreamKeyRequestRequestTypeDef = { # (1)
"arns": ...,
}
parent.batch_get_stream_key(**kwargs)
batch_start_viewer_session_revocation#
Performs StartViewerSessionRevocation on multiple channel ARN and viewer ID pairs simultaneously.
Type annotations and code completion for boto3.client("ivs").batch_start_viewer_session_revocation
method.
boto3 documentation
# batch_start_viewer_session_revocation method definition
def batch_start_viewer_session_revocation(
self,
*,
viewerSessions: Sequence[BatchStartViewerSessionRevocationViewerSessionTypeDef], # (1)
) -> BatchStartViewerSessionRevocationResponseTypeDef: # (2)
...
- See BatchStartViewerSessionRevocationViewerSessionTypeDef
- See BatchStartViewerSessionRevocationResponseTypeDef
# batch_start_viewer_session_revocation method usage example with argument unpacking
kwargs: BatchStartViewerSessionRevocationRequestRequestTypeDef = { # (1)
"viewerSessions": ...,
}
parent.batch_start_viewer_session_revocation(**kwargs)
can_paginate#
Check if an operation can be paginated.
Type annotations and code completion for boto3.client("ivs").can_paginate
method.
boto3 documentation
# can_paginate method definition
def can_paginate(
self,
operation_name: str,
) -> bool:
...
close#
Closes underlying endpoint connections.
Type annotations and code completion for boto3.client("ivs").close
method.
boto3 documentation
# close method definition
def close(
self,
) -> None:
...
create_channel#
Creates a new channel and an associated stream key to start streaming.
Type annotations and code completion for boto3.client("ivs").create_channel
method.
boto3 documentation
# create_channel method definition
def create_channel(
self,
*,
authorized: bool = ...,
containerFormat: ContainerFormatType = ..., # (1)
insecureIngest: bool = ...,
latencyMode: ChannelLatencyModeType = ..., # (2)
multitrackInputConfiguration: MultitrackInputConfigurationTypeDef = ..., # (3)
name: str = ...,
playbackRestrictionPolicyArn: str = ...,
preset: TranscodePresetType = ..., # (4)
recordingConfigurationArn: str = ...,
tags: Mapping[str, str] = ...,
type: ChannelTypeType = ..., # (5)
) -> CreateChannelResponseTypeDef: # (6)
...
- See ContainerFormatType
- See ChannelLatencyModeType
- See MultitrackInputConfigurationTypeDef
- See TranscodePresetType
- See ChannelTypeType
- See CreateChannelResponseTypeDef
# create_channel method usage example with argument unpacking
kwargs: CreateChannelRequestRequestTypeDef = { # (1)
"authorized": ...,
}
parent.create_channel(**kwargs)
create_playback_restriction_policy#
Creates a new playback restriction policy, for constraining playback by countries and/or origins.
Type annotations and code completion for boto3.client("ivs").create_playback_restriction_policy
method.
boto3 documentation
# create_playback_restriction_policy method definition
def create_playback_restriction_policy(
self,
*,
allowedCountries: Sequence[str] = ...,
allowedOrigins: Sequence[str] = ...,
enableStrictOriginEnforcement: bool = ...,
name: str = ...,
tags: Mapping[str, str] = ...,
) -> CreatePlaybackRestrictionPolicyResponseTypeDef: # (1)
...
# create_playback_restriction_policy method usage example with argument unpacking
kwargs: CreatePlaybackRestrictionPolicyRequestRequestTypeDef = { # (1)
"allowedCountries": ...,
}
parent.create_playback_restriction_policy(**kwargs)
create_recording_configuration#
Creates a new recording configuration, used to enable recording to Amazon S3.
Type annotations and code completion for boto3.client("ivs").create_recording_configuration
method.
boto3 documentation
# create_recording_configuration method definition
def create_recording_configuration(
self,
*,
destinationConfiguration: DestinationConfigurationTypeDef, # (1)
name: str = ...,
recordingReconnectWindowSeconds: int = ...,
renditionConfiguration: RenditionConfigurationTypeDef = ..., # (2)
tags: Mapping[str, str] = ...,
thumbnailConfiguration: ThumbnailConfigurationTypeDef = ..., # (3)
) -> CreateRecordingConfigurationResponseTypeDef: # (4)
...
- See DestinationConfigurationTypeDef
- See RenditionConfigurationTypeDef
- See ThumbnailConfigurationTypeDef
- See CreateRecordingConfigurationResponseTypeDef
# create_recording_configuration method usage example with argument unpacking
kwargs: CreateRecordingConfigurationRequestRequestTypeDef = { # (1)
"destinationConfiguration": ...,
}
parent.create_recording_configuration(**kwargs)
create_stream_key#
Creates a stream key, used to initiate a stream, for the specified channel ARN.
Type annotations and code completion for boto3.client("ivs").create_stream_key
method.
boto3 documentation
# create_stream_key method definition
def create_stream_key(
self,
*,
channelArn: str,
tags: Mapping[str, str] = ...,
) -> CreateStreamKeyResponseTypeDef: # (1)
...
# create_stream_key method usage example with argument unpacking
kwargs: CreateStreamKeyRequestRequestTypeDef = { # (1)
"channelArn": ...,
}
parent.create_stream_key(**kwargs)
delete_channel#
Deletes the specified channel and its associated stream keys.
Type annotations and code completion for boto3.client("ivs").delete_channel
method.
boto3 documentation
# delete_channel method definition
def delete_channel(
self,
*,
arn: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# delete_channel method usage example with argument unpacking
kwargs: DeleteChannelRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.delete_channel(**kwargs)
delete_playback_key_pair#
Deletes a specified authorization key pair.
Type annotations and code completion for boto3.client("ivs").delete_playback_key_pair
method.
boto3 documentation
# delete_playback_key_pair method definition
def delete_playback_key_pair(
self,
*,
arn: str,
) -> Dict[str, Any]:
...
# delete_playback_key_pair method usage example with argument unpacking
kwargs: DeletePlaybackKeyPairRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.delete_playback_key_pair(**kwargs)
delete_playback_restriction_policy#
Deletes the specified playback restriction policy.
Type annotations and code completion for boto3.client("ivs").delete_playback_restriction_policy
method.
boto3 documentation
# delete_playback_restriction_policy method definition
def delete_playback_restriction_policy(
self,
*,
arn: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# delete_playback_restriction_policy method usage example with argument unpacking
kwargs: DeletePlaybackRestrictionPolicyRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.delete_playback_restriction_policy(**kwargs)
delete_recording_configuration#
Deletes the recording configuration for the specified ARN.
Type annotations and code completion for boto3.client("ivs").delete_recording_configuration
method.
boto3 documentation
# delete_recording_configuration method definition
def delete_recording_configuration(
self,
*,
arn: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# delete_recording_configuration method usage example with argument unpacking
kwargs: DeleteRecordingConfigurationRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.delete_recording_configuration(**kwargs)
delete_stream_key#
Deletes the stream key for the specified ARN, so it can no longer be used to stream.
Type annotations and code completion for boto3.client("ivs").delete_stream_key
method.
boto3 documentation
# delete_stream_key method definition
def delete_stream_key(
self,
*,
arn: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# delete_stream_key method usage example with argument unpacking
kwargs: DeleteStreamKeyRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.delete_stream_key(**kwargs)
generate_presigned_url#
Generate a presigned url given a client, its method, and arguments.
Type annotations and code completion for boto3.client("ivs").generate_presigned_url
method.
boto3 documentation
# generate_presigned_url method definition
def generate_presigned_url(
self,
ClientMethod: str,
Params: Mapping[str, Any] = ...,
ExpiresIn: int = 3600,
HttpMethod: str = ...,
) -> str:
...
get_channel#
Gets the channel configuration for the specified channel ARN.
Type annotations and code completion for boto3.client("ivs").get_channel
method.
boto3 documentation
# get_channel method definition
def get_channel(
self,
*,
arn: str,
) -> GetChannelResponseTypeDef: # (1)
...
# get_channel method usage example with argument unpacking
kwargs: GetChannelRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.get_channel(**kwargs)
get_playback_key_pair#
Gets a specified playback authorization key pair and returns the arn
and
fingerprint
.
Type annotations and code completion for boto3.client("ivs").get_playback_key_pair
method.
boto3 documentation
# get_playback_key_pair method definition
def get_playback_key_pair(
self,
*,
arn: str,
) -> GetPlaybackKeyPairResponseTypeDef: # (1)
...
# get_playback_key_pair method usage example with argument unpacking
kwargs: GetPlaybackKeyPairRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.get_playback_key_pair(**kwargs)
get_playback_restriction_policy#
Gets the specified playback restriction policy.
Type annotations and code completion for boto3.client("ivs").get_playback_restriction_policy
method.
boto3 documentation
# get_playback_restriction_policy method definition
def get_playback_restriction_policy(
self,
*,
arn: str,
) -> GetPlaybackRestrictionPolicyResponseTypeDef: # (1)
...
# get_playback_restriction_policy method usage example with argument unpacking
kwargs: GetPlaybackRestrictionPolicyRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.get_playback_restriction_policy(**kwargs)
get_recording_configuration#
Gets the recording configuration for the specified ARN.
Type annotations and code completion for boto3.client("ivs").get_recording_configuration
method.
boto3 documentation
# get_recording_configuration method definition
def get_recording_configuration(
self,
*,
arn: str,
) -> GetRecordingConfigurationResponseTypeDef: # (1)
...
# get_recording_configuration method usage example with argument unpacking
kwargs: GetRecordingConfigurationRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.get_recording_configuration(**kwargs)
get_stream#
Gets information about the active (live) stream on a specified channel.
Type annotations and code completion for boto3.client("ivs").get_stream
method.
boto3 documentation
# get_stream method definition
def get_stream(
self,
*,
channelArn: str,
) -> GetStreamResponseTypeDef: # (1)
...
# get_stream method usage example with argument unpacking
kwargs: GetStreamRequestRequestTypeDef = { # (1)
"channelArn": ...,
}
parent.get_stream(**kwargs)
get_stream_key#
Gets stream-key information for a specified ARN.
Type annotations and code completion for boto3.client("ivs").get_stream_key
method.
boto3 documentation
# get_stream_key method definition
def get_stream_key(
self,
*,
arn: str,
) -> GetStreamKeyResponseTypeDef: # (1)
...
# get_stream_key method usage example with argument unpacking
kwargs: GetStreamKeyRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.get_stream_key(**kwargs)
get_stream_session#
Gets metadata on a specified stream.
Type annotations and code completion for boto3.client("ivs").get_stream_session
method.
boto3 documentation
# get_stream_session method definition
def get_stream_session(
self,
*,
channelArn: str,
streamId: str = ...,
) -> GetStreamSessionResponseTypeDef: # (1)
...
# get_stream_session method usage example with argument unpacking
kwargs: GetStreamSessionRequestRequestTypeDef = { # (1)
"channelArn": ...,
}
parent.get_stream_session(**kwargs)
import_playback_key_pair#
Imports the public portion of a new key pair and returns its arn
and
fingerprint
.
Type annotations and code completion for boto3.client("ivs").import_playback_key_pair
method.
boto3 documentation
# import_playback_key_pair method definition
def import_playback_key_pair(
self,
*,
publicKeyMaterial: str,
name: str = ...,
tags: Mapping[str, str] = ...,
) -> ImportPlaybackKeyPairResponseTypeDef: # (1)
...
# import_playback_key_pair method usage example with argument unpacking
kwargs: ImportPlaybackKeyPairRequestRequestTypeDef = { # (1)
"publicKeyMaterial": ...,
}
parent.import_playback_key_pair(**kwargs)
list_channels#
Gets summary information about all channels in your account, in the Amazon Web Services region where the API request is processed.
Type annotations and code completion for boto3.client("ivs").list_channels
method.
boto3 documentation
# list_channels method definition
def list_channels(
self,
*,
filterByName: str = ...,
filterByPlaybackRestrictionPolicyArn: str = ...,
filterByRecordingConfigurationArn: str = ...,
maxResults: int = ...,
nextToken: str = ...,
) -> ListChannelsResponseTypeDef: # (1)
...
# list_channels method usage example with argument unpacking
kwargs: ListChannelsRequestRequestTypeDef = { # (1)
"filterByName": ...,
}
parent.list_channels(**kwargs)
list_playback_key_pairs#
Gets summary information about playback key pairs.
Type annotations and code completion for boto3.client("ivs").list_playback_key_pairs
method.
boto3 documentation
# list_playback_key_pairs method definition
def list_playback_key_pairs(
self,
*,
maxResults: int = ...,
nextToken: str = ...,
) -> ListPlaybackKeyPairsResponseTypeDef: # (1)
...
# list_playback_key_pairs method usage example with argument unpacking
kwargs: ListPlaybackKeyPairsRequestRequestTypeDef = { # (1)
"maxResults": ...,
}
parent.list_playback_key_pairs(**kwargs)
list_playback_restriction_policies#
Gets summary information about playback restriction policies.
Type annotations and code completion for boto3.client("ivs").list_playback_restriction_policies
method.
boto3 documentation
# list_playback_restriction_policies method definition
def list_playback_restriction_policies(
self,
*,
maxResults: int = ...,
nextToken: str = ...,
) -> ListPlaybackRestrictionPoliciesResponseTypeDef: # (1)
...
# list_playback_restriction_policies method usage example with argument unpacking
kwargs: ListPlaybackRestrictionPoliciesRequestRequestTypeDef = { # (1)
"maxResults": ...,
}
parent.list_playback_restriction_policies(**kwargs)
list_recording_configurations#
Gets summary information about all recording configurations in your account, in the Amazon Web Services region where the API request is processed.
Type annotations and code completion for boto3.client("ivs").list_recording_configurations
method.
boto3 documentation
# list_recording_configurations method definition
def list_recording_configurations(
self,
*,
maxResults: int = ...,
nextToken: str = ...,
) -> ListRecordingConfigurationsResponseTypeDef: # (1)
...
# list_recording_configurations method usage example with argument unpacking
kwargs: ListRecordingConfigurationsRequestRequestTypeDef = { # (1)
"maxResults": ...,
}
parent.list_recording_configurations(**kwargs)
list_stream_keys#
Gets summary information about stream keys for the specified channel.
Type annotations and code completion for boto3.client("ivs").list_stream_keys
method.
boto3 documentation
# list_stream_keys method definition
def list_stream_keys(
self,
*,
channelArn: str,
maxResults: int = ...,
nextToken: str = ...,
) -> ListStreamKeysResponseTypeDef: # (1)
...
# list_stream_keys method usage example with argument unpacking
kwargs: ListStreamKeysRequestRequestTypeDef = { # (1)
"channelArn": ...,
}
parent.list_stream_keys(**kwargs)
list_stream_sessions#
Gets a summary of current and previous streams for a specified channel in your account, in the AWS region where the API request is processed.
Type annotations and code completion for boto3.client("ivs").list_stream_sessions
method.
boto3 documentation
# list_stream_sessions method definition
def list_stream_sessions(
self,
*,
channelArn: str,
maxResults: int = ...,
nextToken: str = ...,
) -> ListStreamSessionsResponseTypeDef: # (1)
...
# list_stream_sessions method usage example with argument unpacking
kwargs: ListStreamSessionsRequestRequestTypeDef = { # (1)
"channelArn": ...,
}
parent.list_stream_sessions(**kwargs)
list_streams#
Gets summary information about live streams in your account, in the Amazon Web Services region where the API request is processed.
Type annotations and code completion for boto3.client("ivs").list_streams
method.
boto3 documentation
# list_streams method definition
def list_streams(
self,
*,
filterBy: StreamFiltersTypeDef = ..., # (1)
maxResults: int = ...,
nextToken: str = ...,
) -> ListStreamsResponseTypeDef: # (2)
...
# list_streams method usage example with argument unpacking
kwargs: ListStreamsRequestRequestTypeDef = { # (1)
"filterBy": ...,
}
parent.list_streams(**kwargs)
list_tags_for_resource#
Gets information about Amazon Web Services tags for the specified ARN.
Type annotations and code completion for boto3.client("ivs").list_tags_for_resource
method.
boto3 documentation
# list_tags_for_resource method definition
def list_tags_for_resource(
self,
*,
resourceArn: str,
) -> ListTagsForResourceResponseTypeDef: # (1)
...
# list_tags_for_resource method usage example with argument unpacking
kwargs: ListTagsForResourceRequestRequestTypeDef = { # (1)
"resourceArn": ...,
}
parent.list_tags_for_resource(**kwargs)
put_metadata#
Inserts metadata into the active stream of the specified channel.
Type annotations and code completion for boto3.client("ivs").put_metadata
method.
boto3 documentation
# put_metadata method definition
def put_metadata(
self,
*,
channelArn: str,
metadata: str,
) -> EmptyResponseMetadataTypeDef: # (1)
...
# put_metadata method usage example with argument unpacking
kwargs: PutMetadataRequestRequestTypeDef = { # (1)
"channelArn": ...,
"metadata": ...,
}
parent.put_metadata(**kwargs)
start_viewer_session_revocation#
Starts the process of revoking the viewer session associated with a specified channel ARN and viewer ID.
Type annotations and code completion for boto3.client("ivs").start_viewer_session_revocation
method.
boto3 documentation
# start_viewer_session_revocation method definition
def start_viewer_session_revocation(
self,
*,
channelArn: str,
viewerId: str,
viewerSessionVersionsLessThanOrEqualTo: int = ...,
) -> Dict[str, Any]:
...
# start_viewer_session_revocation method usage example with argument unpacking
kwargs: StartViewerSessionRevocationRequestRequestTypeDef = { # (1)
"channelArn": ...,
"viewerId": ...,
}
parent.start_viewer_session_revocation(**kwargs)
stop_stream#
Disconnects the incoming RTMPS stream for the specified channel.
Type annotations and code completion for boto3.client("ivs").stop_stream
method.
boto3 documentation
# stop_stream method definition
def stop_stream(
self,
*,
channelArn: str,
) -> Dict[str, Any]:
...
# stop_stream method usage example with argument unpacking
kwargs: StopStreamRequestRequestTypeDef = { # (1)
"channelArn": ...,
}
parent.stop_stream(**kwargs)
tag_resource#
Adds or updates tags for the Amazon Web Services resource with the specified ARN.
Type annotations and code completion for boto3.client("ivs").tag_resource
method.
boto3 documentation
# tag_resource method definition
def tag_resource(
self,
*,
resourceArn: str,
tags: Mapping[str, str],
) -> Dict[str, Any]:
...
# tag_resource method usage example with argument unpacking
kwargs: TagResourceRequestRequestTypeDef = { # (1)
"resourceArn": ...,
"tags": ...,
}
parent.tag_resource(**kwargs)
untag_resource#
Removes tags from the resource with the specified ARN.
Type annotations and code completion for boto3.client("ivs").untag_resource
method.
boto3 documentation
# untag_resource method definition
def untag_resource(
self,
*,
resourceArn: str,
tagKeys: Sequence[str],
) -> Dict[str, Any]:
...
# untag_resource method usage example with argument unpacking
kwargs: UntagResourceRequestRequestTypeDef = { # (1)
"resourceArn": ...,
"tagKeys": ...,
}
parent.untag_resource(**kwargs)
update_channel#
Updates a channel's configuration.
Type annotations and code completion for boto3.client("ivs").update_channel
method.
boto3 documentation
# update_channel method definition
def update_channel(
self,
*,
arn: str,
authorized: bool = ...,
containerFormat: ContainerFormatType = ..., # (1)
insecureIngest: bool = ...,
latencyMode: ChannelLatencyModeType = ..., # (2)
multitrackInputConfiguration: MultitrackInputConfigurationTypeDef = ..., # (3)
name: str = ...,
playbackRestrictionPolicyArn: str = ...,
preset: TranscodePresetType = ..., # (4)
recordingConfigurationArn: str = ...,
type: ChannelTypeType = ..., # (5)
) -> UpdateChannelResponseTypeDef: # (6)
...
- See ContainerFormatType
- See ChannelLatencyModeType
- See MultitrackInputConfigurationTypeDef
- See TranscodePresetType
- See ChannelTypeType
- See UpdateChannelResponseTypeDef
# update_channel method usage example with argument unpacking
kwargs: UpdateChannelRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.update_channel(**kwargs)
update_playback_restriction_policy#
Updates a specified playback restriction policy.
Type annotations and code completion for boto3.client("ivs").update_playback_restriction_policy
method.
boto3 documentation
# update_playback_restriction_policy method definition
def update_playback_restriction_policy(
self,
*,
arn: str,
allowedCountries: Sequence[str] = ...,
allowedOrigins: Sequence[str] = ...,
enableStrictOriginEnforcement: bool = ...,
name: str = ...,
) -> UpdatePlaybackRestrictionPolicyResponseTypeDef: # (1)
...
# update_playback_restriction_policy method usage example with argument unpacking
kwargs: UpdatePlaybackRestrictionPolicyRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.update_playback_restriction_policy(**kwargs)
get_paginator#
Type annotations and code completion for boto3.client("ivs").get_paginator
method with overloads.
client.get_paginator("list_channels")
-> ListChannelsPaginatorclient.get_paginator("list_playback_key_pairs")
-> ListPlaybackKeyPairsPaginatorclient.get_paginator("list_recording_configurations")
-> ListRecordingConfigurationsPaginatorclient.get_paginator("list_stream_keys")
-> ListStreamKeysPaginatorclient.get_paginator("list_streams")
-> ListStreamsPaginator