IvsrealtimeClient#
Index > Ivsrealtime > IvsrealtimeClient
Auto-generated documentation for Ivsrealtime type annotations stubs module mypy-boto3-ivs-realtime.
IvsrealtimeClient#
Type annotations and code completion for boto3.client("ivs-realtime")
.
boto3 documentation
# IvsrealtimeClient usage example
from boto3.session import Session
from mypy_boto3_ivs_realtime.client import IvsrealtimeClient
def get_ivs-realtime_client() -> IvsrealtimeClient:
return Session().client("ivs-realtime")
Exceptions#
boto3
client exceptions are generated in runtime.
This class provides code completion for boto3.client("ivs-realtime").exceptions
structure.
# Exceptions.exceptions usage example
client = boto3.client("ivs-realtime")
try:
do_something(client)
except (
client.exceptions.AccessDeniedException,
client.exceptions.ClientError,
client.exceptions.ConflictException,
client.exceptions.InternalServerException,
client.exceptions.PendingVerification,
client.exceptions.ResourceNotFoundException,
client.exceptions.ServiceQuotaExceededException,
client.exceptions.ValidationException,
) as e:
print(e)
# Exceptions.exceptions type checking example
from mypy_boto3_ivs_realtime.client import Exceptions
def handle_error(exc: Exceptions.AccessDeniedException) -> None:
...
Methods#
can_paginate#
Check if an operation can be paginated.
Type annotations and code completion for boto3.client("ivs-realtime").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-realtime").close
method.
boto3 documentation
# close method definition
def close(
self,
) -> None:
...
create_encoder_configuration#
Creates an EncoderConfiguration object.
Type annotations and code completion for boto3.client("ivs-realtime").create_encoder_configuration
method.
boto3 documentation
# create_encoder_configuration method definition
def create_encoder_configuration(
self,
*,
name: str = ...,
video: VideoTypeDef = ..., # (1)
tags: Mapping[str, str] = ...,
) -> CreateEncoderConfigurationResponseTypeDef: # (2)
...
# create_encoder_configuration method usage example with argument unpacking
kwargs: CreateEncoderConfigurationRequestRequestTypeDef = { # (1)
"name": ...,
}
parent.create_encoder_configuration(**kwargs)
create_ingest_configuration#
Creates a new IngestConfiguration resource, used to specify the ingest protocol for a stage.
Type annotations and code completion for boto3.client("ivs-realtime").create_ingest_configuration
method.
boto3 documentation
# create_ingest_configuration method definition
def create_ingest_configuration(
self,
*,
ingestProtocol: IngestProtocolType, # (1)
name: str = ...,
stageArn: str = ...,
userId: str = ...,
attributes: Mapping[str, str] = ...,
insecureIngest: bool = ...,
tags: Mapping[str, str] = ...,
) -> CreateIngestConfigurationResponseTypeDef: # (2)
...
# create_ingest_configuration method usage example with argument unpacking
kwargs: CreateIngestConfigurationRequestRequestTypeDef = { # (1)
"ingestProtocol": ...,
}
parent.create_ingest_configuration(**kwargs)
create_participant_token#
Creates an additional token for a specified stage.
Type annotations and code completion for boto3.client("ivs-realtime").create_participant_token
method.
boto3 documentation
# create_participant_token method definition
def create_participant_token(
self,
*,
stageArn: str,
duration: int = ...,
userId: str = ...,
attributes: Mapping[str, str] = ...,
capabilities: Sequence[ParticipantTokenCapabilityType] = ..., # (1)
) -> CreateParticipantTokenResponseTypeDef: # (2)
...
# create_participant_token method usage example with argument unpacking
kwargs: CreateParticipantTokenRequestRequestTypeDef = { # (1)
"stageArn": ...,
}
parent.create_participant_token(**kwargs)
create_stage#
Creates a new stage (and optionally participant tokens).
Type annotations and code completion for boto3.client("ivs-realtime").create_stage
method.
boto3 documentation
# create_stage method definition
def create_stage(
self,
*,
name: str = ...,
participantTokenConfigurations: Sequence[ParticipantTokenConfigurationTypeDef] = ..., # (1)
tags: Mapping[str, str] = ...,
autoParticipantRecordingConfiguration: AutoParticipantRecordingConfigurationTypeDef = ..., # (2)
) -> CreateStageResponseTypeDef: # (3)
...
- See ParticipantTokenConfigurationTypeDef
- See AutoParticipantRecordingConfigurationTypeDef
- See CreateStageResponseTypeDef
# create_stage method usage example with argument unpacking
kwargs: CreateStageRequestRequestTypeDef = { # (1)
"name": ...,
}
parent.create_stage(**kwargs)
create_storage_configuration#
Creates a new storage configuration, used to enable recording to Amazon S3.
Type annotations and code completion for boto3.client("ivs-realtime").create_storage_configuration
method.
boto3 documentation
# create_storage_configuration method definition
def create_storage_configuration(
self,
*,
s3: S3StorageConfigurationTypeDef, # (1)
name: str = ...,
tags: Mapping[str, str] = ...,
) -> CreateStorageConfigurationResponseTypeDef: # (2)
...
# create_storage_configuration method usage example with argument unpacking
kwargs: CreateStorageConfigurationRequestRequestTypeDef = { # (1)
"s3": ...,
}
parent.create_storage_configuration(**kwargs)
delete_encoder_configuration#
Deletes an EncoderConfiguration resource.
Type annotations and code completion for boto3.client("ivs-realtime").delete_encoder_configuration
method.
boto3 documentation
# delete_encoder_configuration method definition
def delete_encoder_configuration(
self,
*,
arn: str,
) -> Dict[str, Any]:
...
# delete_encoder_configuration method usage example with argument unpacking
kwargs: DeleteEncoderConfigurationRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.delete_encoder_configuration(**kwargs)
delete_ingest_configuration#
Deletes a specified IngestConfiguration, so it can no longer be used to broadcast.
Type annotations and code completion for boto3.client("ivs-realtime").delete_ingest_configuration
method.
boto3 documentation
# delete_ingest_configuration method definition
def delete_ingest_configuration(
self,
*,
arn: str,
force: bool = ...,
) -> Dict[str, Any]:
...
# delete_ingest_configuration method usage example with argument unpacking
kwargs: DeleteIngestConfigurationRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.delete_ingest_configuration(**kwargs)
delete_public_key#
Deletes the specified public key used to sign stage participant tokens.
Type annotations and code completion for boto3.client("ivs-realtime").delete_public_key
method.
boto3 documentation
# delete_public_key method definition
def delete_public_key(
self,
*,
arn: str,
) -> Dict[str, Any]:
...
# delete_public_key method usage example with argument unpacking
kwargs: DeletePublicKeyRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.delete_public_key(**kwargs)
delete_stage#
Shuts down and deletes the specified stage (disconnecting all participants).
Type annotations and code completion for boto3.client("ivs-realtime").delete_stage
method.
boto3 documentation
# delete_stage method definition
def delete_stage(
self,
*,
arn: str,
) -> Dict[str, Any]:
...
# delete_stage method usage example with argument unpacking
kwargs: DeleteStageRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.delete_stage(**kwargs)
delete_storage_configuration#
Deletes the storage configuration for the specified ARN.
Type annotations and code completion for boto3.client("ivs-realtime").delete_storage_configuration
method.
boto3 documentation
# delete_storage_configuration method definition
def delete_storage_configuration(
self,
*,
arn: str,
) -> Dict[str, Any]:
...
# delete_storage_configuration method usage example with argument unpacking
kwargs: DeleteStorageConfigurationRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.delete_storage_configuration(**kwargs)
disconnect_participant#
Disconnects a specified participant from a specified stage.
Type annotations and code completion for boto3.client("ivs-realtime").disconnect_participant
method.
boto3 documentation
# disconnect_participant method definition
def disconnect_participant(
self,
*,
stageArn: str,
participantId: str,
reason: str = ...,
) -> Dict[str, Any]:
...
# disconnect_participant method usage example with argument unpacking
kwargs: DisconnectParticipantRequestRequestTypeDef = { # (1)
"stageArn": ...,
"participantId": ...,
}
parent.disconnect_participant(**kwargs)
generate_presigned_url#
Generate a presigned url given a client, its method, and arguments.
Type annotations and code completion for boto3.client("ivs-realtime").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_composition#
Get information about the specified Composition resource.
Type annotations and code completion for boto3.client("ivs-realtime").get_composition
method.
boto3 documentation
# get_composition method definition
def get_composition(
self,
*,
arn: str,
) -> GetCompositionResponseTypeDef: # (1)
...
# get_composition method usage example with argument unpacking
kwargs: GetCompositionRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.get_composition(**kwargs)
get_encoder_configuration#
Gets information about the specified EncoderConfiguration resource.
Type annotations and code completion for boto3.client("ivs-realtime").get_encoder_configuration
method.
boto3 documentation
# get_encoder_configuration method definition
def get_encoder_configuration(
self,
*,
arn: str,
) -> GetEncoderConfigurationResponseTypeDef: # (1)
...
# get_encoder_configuration method usage example with argument unpacking
kwargs: GetEncoderConfigurationRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.get_encoder_configuration(**kwargs)
get_ingest_configuration#
Gets information about the specified IngestConfiguration.
Type annotations and code completion for boto3.client("ivs-realtime").get_ingest_configuration
method.
boto3 documentation
# get_ingest_configuration method definition
def get_ingest_configuration(
self,
*,
arn: str,
) -> GetIngestConfigurationResponseTypeDef: # (1)
...
# get_ingest_configuration method usage example with argument unpacking
kwargs: GetIngestConfigurationRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.get_ingest_configuration(**kwargs)
get_participant#
Gets information about the specified participant token.
Type annotations and code completion for boto3.client("ivs-realtime").get_participant
method.
boto3 documentation
# get_participant method definition
def get_participant(
self,
*,
stageArn: str,
sessionId: str,
participantId: str,
) -> GetParticipantResponseTypeDef: # (1)
...
# get_participant method usage example with argument unpacking
kwargs: GetParticipantRequestRequestTypeDef = { # (1)
"stageArn": ...,
"sessionId": ...,
"participantId": ...,
}
parent.get_participant(**kwargs)
get_public_key#
Gets information for the specified public key.
Type annotations and code completion for boto3.client("ivs-realtime").get_public_key
method.
boto3 documentation
# get_public_key method definition
def get_public_key(
self,
*,
arn: str,
) -> GetPublicKeyResponseTypeDef: # (1)
...
# get_public_key method usage example with argument unpacking
kwargs: GetPublicKeyRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.get_public_key(**kwargs)
get_stage#
Gets information for the specified stage.
Type annotations and code completion for boto3.client("ivs-realtime").get_stage
method.
boto3 documentation
# get_stage method definition
def get_stage(
self,
*,
arn: str,
) -> GetStageResponseTypeDef: # (1)
...
# get_stage method usage example with argument unpacking
kwargs: GetStageRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.get_stage(**kwargs)
get_stage_session#
Gets information for the specified stage session.
Type annotations and code completion for boto3.client("ivs-realtime").get_stage_session
method.
boto3 documentation
# get_stage_session method definition
def get_stage_session(
self,
*,
stageArn: str,
sessionId: str,
) -> GetStageSessionResponseTypeDef: # (1)
...
# get_stage_session method usage example with argument unpacking
kwargs: GetStageSessionRequestRequestTypeDef = { # (1)
"stageArn": ...,
"sessionId": ...,
}
parent.get_stage_session(**kwargs)
get_storage_configuration#
Gets the storage configuration for the specified ARN.
Type annotations and code completion for boto3.client("ivs-realtime").get_storage_configuration
method.
boto3 documentation
# get_storage_configuration method definition
def get_storage_configuration(
self,
*,
arn: str,
) -> GetStorageConfigurationResponseTypeDef: # (1)
...
# get_storage_configuration method usage example with argument unpacking
kwargs: GetStorageConfigurationRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.get_storage_configuration(**kwargs)
import_public_key#
Import a public key to be used for signing stage participant tokens.
Type annotations and code completion for boto3.client("ivs-realtime").import_public_key
method.
boto3 documentation
# import_public_key method definition
def import_public_key(
self,
*,
publicKeyMaterial: str,
name: str = ...,
tags: Mapping[str, str] = ...,
) -> ImportPublicKeyResponseTypeDef: # (1)
...
# import_public_key method usage example with argument unpacking
kwargs: ImportPublicKeyRequestRequestTypeDef = { # (1)
"publicKeyMaterial": ...,
}
parent.import_public_key(**kwargs)
list_compositions#
Gets summary information about all Compositions in your account, in the AWS region where the API request is processed.
Type annotations and code completion for boto3.client("ivs-realtime").list_compositions
method.
boto3 documentation
# list_compositions method definition
def list_compositions(
self,
*,
filterByStageArn: str = ...,
filterByEncoderConfigurationArn: str = ...,
nextToken: str = ...,
maxResults: int = ...,
) -> ListCompositionsResponseTypeDef: # (1)
...
# list_compositions method usage example with argument unpacking
kwargs: ListCompositionsRequestRequestTypeDef = { # (1)
"filterByStageArn": ...,
}
parent.list_compositions(**kwargs)
list_encoder_configurations#
Gets summary information about all EncoderConfigurations in your account, in the AWS region where the API request is processed.
Type annotations and code completion for boto3.client("ivs-realtime").list_encoder_configurations
method.
boto3 documentation
# list_encoder_configurations method definition
def list_encoder_configurations(
self,
*,
nextToken: str = ...,
maxResults: int = ...,
) -> ListEncoderConfigurationsResponseTypeDef: # (1)
...
# list_encoder_configurations method usage example with argument unpacking
kwargs: ListEncoderConfigurationsRequestRequestTypeDef = { # (1)
"nextToken": ...,
}
parent.list_encoder_configurations(**kwargs)
list_ingest_configurations#
Lists all IngestConfigurations in your account, in the AWS region where the API request is processed.
Type annotations and code completion for boto3.client("ivs-realtime").list_ingest_configurations
method.
boto3 documentation
# list_ingest_configurations method definition
def list_ingest_configurations(
self,
*,
filterByStageArn: str = ...,
filterByState: IngestConfigurationStateType = ..., # (1)
nextToken: str = ...,
maxResults: int = ...,
) -> ListIngestConfigurationsResponseTypeDef: # (2)
...
# list_ingest_configurations method usage example with argument unpacking
kwargs: ListIngestConfigurationsRequestRequestTypeDef = { # (1)
"filterByStageArn": ...,
}
parent.list_ingest_configurations(**kwargs)
list_participant_events#
Lists events for a specified participant that occurred during a specified stage session.
Type annotations and code completion for boto3.client("ivs-realtime").list_participant_events
method.
boto3 documentation
# list_participant_events method definition
def list_participant_events(
self,
*,
stageArn: str,
sessionId: str,
participantId: str,
nextToken: str = ...,
maxResults: int = ...,
) -> ListParticipantEventsResponseTypeDef: # (1)
...
# list_participant_events method usage example with argument unpacking
kwargs: ListParticipantEventsRequestRequestTypeDef = { # (1)
"stageArn": ...,
"sessionId": ...,
"participantId": ...,
}
parent.list_participant_events(**kwargs)
list_participants#
Lists all participants in a specified stage session.
Type annotations and code completion for boto3.client("ivs-realtime").list_participants
method.
boto3 documentation
# list_participants method definition
def list_participants(
self,
*,
stageArn: str,
sessionId: str,
filterByUserId: str = ...,
filterByPublished: bool = ...,
filterByState: ParticipantStateType = ..., # (1)
nextToken: str = ...,
maxResults: int = ...,
filterByRecordingState: ParticipantRecordingFilterByRecordingStateType = ..., # (2)
) -> ListParticipantsResponseTypeDef: # (3)
...
- See ParticipantStateType
- See ParticipantRecordingFilterByRecordingStateType
- See ListParticipantsResponseTypeDef
# list_participants method usage example with argument unpacking
kwargs: ListParticipantsRequestRequestTypeDef = { # (1)
"stageArn": ...,
"sessionId": ...,
}
parent.list_participants(**kwargs)
list_public_keys#
Gets summary information about all public keys in your account, in the AWS region where the API request is processed.
Type annotations and code completion for boto3.client("ivs-realtime").list_public_keys
method.
boto3 documentation
# list_public_keys method definition
def list_public_keys(
self,
*,
nextToken: str = ...,
maxResults: int = ...,
) -> ListPublicKeysResponseTypeDef: # (1)
...
# list_public_keys method usage example with argument unpacking
kwargs: ListPublicKeysRequestRequestTypeDef = { # (1)
"nextToken": ...,
}
parent.list_public_keys(**kwargs)
list_stage_sessions#
Gets all sessions for a specified stage.
Type annotations and code completion for boto3.client("ivs-realtime").list_stage_sessions
method.
boto3 documentation
# list_stage_sessions method definition
def list_stage_sessions(
self,
*,
stageArn: str,
nextToken: str = ...,
maxResults: int = ...,
) -> ListStageSessionsResponseTypeDef: # (1)
...
# list_stage_sessions method usage example with argument unpacking
kwargs: ListStageSessionsRequestRequestTypeDef = { # (1)
"stageArn": ...,
}
parent.list_stage_sessions(**kwargs)
list_stages#
Gets summary information about all stages in your account, in the AWS region where the API request is processed.
Type annotations and code completion for boto3.client("ivs-realtime").list_stages
method.
boto3 documentation
# list_stages method definition
def list_stages(
self,
*,
nextToken: str = ...,
maxResults: int = ...,
) -> ListStagesResponseTypeDef: # (1)
...
# list_stages method usage example with argument unpacking
kwargs: ListStagesRequestRequestTypeDef = { # (1)
"nextToken": ...,
}
parent.list_stages(**kwargs)
list_storage_configurations#
Gets summary information about all storage configurations in your account, in the AWS region where the API request is processed.
Type annotations and code completion for boto3.client("ivs-realtime").list_storage_configurations
method.
boto3 documentation
# list_storage_configurations method definition
def list_storage_configurations(
self,
*,
nextToken: str = ...,
maxResults: int = ...,
) -> ListStorageConfigurationsResponseTypeDef: # (1)
...
# list_storage_configurations method usage example with argument unpacking
kwargs: ListStorageConfigurationsRequestRequestTypeDef = { # (1)
"nextToken": ...,
}
parent.list_storage_configurations(**kwargs)
list_tags_for_resource#
Gets information about AWS tags for the specified ARN.
Type annotations and code completion for boto3.client("ivs-realtime").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)
start_composition#
Starts a Composition from a stage based on the configuration provided in the request.
Type annotations and code completion for boto3.client("ivs-realtime").start_composition
method.
boto3 documentation
# start_composition method definition
def start_composition(
self,
*,
stageArn: str,
destinations: Sequence[DestinationConfigurationUnionTypeDef], # (1)
idempotencyToken: str = ...,
layout: LayoutConfigurationTypeDef = ..., # (2)
tags: Mapping[str, str] = ...,
) -> StartCompositionResponseTypeDef: # (3)
...
- See DestinationConfigurationTypeDef DestinationConfigurationOutputTypeDef
- See LayoutConfigurationTypeDef
- See StartCompositionResponseTypeDef
# start_composition method usage example with argument unpacking
kwargs: StartCompositionRequestRequestTypeDef = { # (1)
"stageArn": ...,
"destinations": ...,
}
parent.start_composition(**kwargs)
stop_composition#
Stops and deletes a Composition resource.
Type annotations and code completion for boto3.client("ivs-realtime").stop_composition
method.
boto3 documentation
# stop_composition method definition
def stop_composition(
self,
*,
arn: str,
) -> Dict[str, Any]:
...
# stop_composition method usage example with argument unpacking
kwargs: StopCompositionRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.stop_composition(**kwargs)
tag_resource#
Adds or updates tags for the AWS resource with the specified ARN.
Type annotations and code completion for boto3.client("ivs-realtime").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-realtime").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_ingest_configuration#
Updates a specified IngestConfiguration.
Type annotations and code completion for boto3.client("ivs-realtime").update_ingest_configuration
method.
boto3 documentation
# update_ingest_configuration method definition
def update_ingest_configuration(
self,
*,
arn: str,
stageArn: str = ...,
) -> UpdateIngestConfigurationResponseTypeDef: # (1)
...
# update_ingest_configuration method usage example with argument unpacking
kwargs: UpdateIngestConfigurationRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.update_ingest_configuration(**kwargs)
update_stage#
Updates a stage's configuration.
Type annotations and code completion for boto3.client("ivs-realtime").update_stage
method.
boto3 documentation
# update_stage method definition
def update_stage(
self,
*,
arn: str,
name: str = ...,
autoParticipantRecordingConfiguration: AutoParticipantRecordingConfigurationTypeDef = ..., # (1)
) -> UpdateStageResponseTypeDef: # (2)
...
# update_stage method usage example with argument unpacking
kwargs: UpdateStageRequestRequestTypeDef = { # (1)
"arn": ...,
}
parent.update_stage(**kwargs)
get_paginator#
Type annotations and code completion for boto3.client("ivs-realtime").get_paginator
method with overloads.
client.get_paginator("list_ingest_configurations")
-> ListIngestConfigurationsPaginatorclient.get_paginator("list_public_keys")
-> ListPublicKeysPaginator