Skip to content

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 = ...,
    tags: Mapping[str, str] = ...,
    video: VideoTypeDef = ...,  # (1)
) -> CreateEncoderConfigurationResponseTypeDef:  # (2)
    ...
  1. See VideoTypeDef
  2. See CreateEncoderConfigurationResponseTypeDef
# create_encoder_configuration method usage example with argument unpacking

kwargs: CreateEncoderConfigurationRequestRequestTypeDef = {  # (1)
    "name": ...,
}

parent.create_encoder_configuration(**kwargs)
  1. See CreateEncoderConfigurationRequestRequestTypeDef

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,
    attributes: Mapping[str, str] = ...,
    capabilities: Sequence[ParticipantTokenCapabilityType] = ...,  # (1)
    duration: int = ...,
    userId: str = ...,
) -> CreateParticipantTokenResponseTypeDef:  # (2)
    ...
  1. See ParticipantTokenCapabilityType
  2. See CreateParticipantTokenResponseTypeDef
# create_participant_token method usage example with argument unpacking

kwargs: CreateParticipantTokenRequestRequestTypeDef = {  # (1)
    "stageArn": ...,
}

parent.create_participant_token(**kwargs)
  1. See CreateParticipantTokenRequestRequestTypeDef

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] = ...,
) -> CreateStageResponseTypeDef:  # (2)
    ...
  1. See ParticipantTokenConfigurationTypeDef
  2. See CreateStageResponseTypeDef
# create_stage method usage example with argument unpacking

kwargs: CreateStageRequestRequestTypeDef = {  # (1)
    "name": ...,
}

parent.create_stage(**kwargs)
  1. See CreateStageRequestRequestTypeDef

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)
    ...
  1. See S3StorageConfigurationTypeDef
  2. See CreateStorageConfigurationResponseTypeDef
# create_storage_configuration method usage example with argument unpacking

kwargs: CreateStorageConfigurationRequestRequestTypeDef = {  # (1)
    "s3": ...,
}

parent.create_storage_configuration(**kwargs)
  1. See CreateStorageConfigurationRequestRequestTypeDef

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)
  1. See DeleteEncoderConfigurationRequestRequestTypeDef

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)
  1. See DeleteStageRequestRequestTypeDef

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)
  1. See DeleteStorageConfigurationRequestRequestTypeDef

disconnect_participant#

Disconnects a specified participant and revokes the participant permanently 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,
    *,
    participantId: str,
    stageArn: str,
    reason: str = ...,
) -> Dict[str, Any]:
    ...
# disconnect_participant method usage example with argument unpacking

kwargs: DisconnectParticipantRequestRequestTypeDef = {  # (1)
    "participantId": ...,
    "stageArn": ...,
}

parent.disconnect_participant(**kwargs)
  1. See DisconnectParticipantRequestRequestTypeDef

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)
    ...
  1. See GetCompositionResponseTypeDef
# get_composition method usage example with argument unpacking

kwargs: GetCompositionRequestRequestTypeDef = {  # (1)
    "arn": ...,
}

parent.get_composition(**kwargs)
  1. See GetCompositionRequestRequestTypeDef

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)
    ...
  1. See GetEncoderConfigurationResponseTypeDef
# get_encoder_configuration method usage example with argument unpacking

kwargs: GetEncoderConfigurationRequestRequestTypeDef = {  # (1)
    "arn": ...,
}

parent.get_encoder_configuration(**kwargs)
  1. See GetEncoderConfigurationRequestRequestTypeDef

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,
    *,
    participantId: str,
    sessionId: str,
    stageArn: str,
) -> GetParticipantResponseTypeDef:  # (1)
    ...
  1. See GetParticipantResponseTypeDef
# get_participant method usage example with argument unpacking

kwargs: GetParticipantRequestRequestTypeDef = {  # (1)
    "participantId": ...,
    "sessionId": ...,
    "stageArn": ...,
}

parent.get_participant(**kwargs)
  1. See GetParticipantRequestRequestTypeDef

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)
    ...
  1. See GetStageResponseTypeDef
# get_stage method usage example with argument unpacking

kwargs: GetStageRequestRequestTypeDef = {  # (1)
    "arn": ...,
}

parent.get_stage(**kwargs)
  1. See GetStageRequestRequestTypeDef

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,
    *,
    sessionId: str,
    stageArn: str,
) -> GetStageSessionResponseTypeDef:  # (1)
    ...
  1. See GetStageSessionResponseTypeDef
# get_stage_session method usage example with argument unpacking

kwargs: GetStageSessionRequestRequestTypeDef = {  # (1)
    "sessionId": ...,
    "stageArn": ...,
}

parent.get_stage_session(**kwargs)
  1. See GetStageSessionRequestRequestTypeDef

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)
    ...
  1. See GetStorageConfigurationResponseTypeDef
# get_storage_configuration method usage example with argument unpacking

kwargs: GetStorageConfigurationRequestRequestTypeDef = {  # (1)
    "arn": ...,
}

parent.get_storage_configuration(**kwargs)
  1. See GetStorageConfigurationRequestRequestTypeDef

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,
    *,
    filterByEncoderConfigurationArn: str = ...,
    filterByStageArn: str = ...,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListCompositionsResponseTypeDef:  # (1)
    ...
  1. See ListCompositionsResponseTypeDef
# list_compositions method usage example with argument unpacking

kwargs: ListCompositionsRequestRequestTypeDef = {  # (1)
    "filterByEncoderConfigurationArn": ...,
}

parent.list_compositions(**kwargs)
  1. See ListCompositionsRequestRequestTypeDef

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,
    *,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListEncoderConfigurationsResponseTypeDef:  # (1)
    ...
  1. See ListEncoderConfigurationsResponseTypeDef
# list_encoder_configurations method usage example with argument unpacking

kwargs: ListEncoderConfigurationsRequestRequestTypeDef = {  # (1)
    "maxResults": ...,
}

parent.list_encoder_configurations(**kwargs)
  1. See ListEncoderConfigurationsRequestRequestTypeDef

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,
    *,
    participantId: str,
    sessionId: str,
    stageArn: str,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListParticipantEventsResponseTypeDef:  # (1)
    ...
  1. See ListParticipantEventsResponseTypeDef
# list_participant_events method usage example with argument unpacking

kwargs: ListParticipantEventsRequestRequestTypeDef = {  # (1)
    "participantId": ...,
    "sessionId": ...,
    "stageArn": ...,
}

parent.list_participant_events(**kwargs)
  1. See ListParticipantEventsRequestRequestTypeDef

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,
    *,
    sessionId: str,
    stageArn: str,
    filterByPublished: bool = ...,
    filterByState: ParticipantStateType = ...,  # (1)
    filterByUserId: str = ...,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListParticipantsResponseTypeDef:  # (2)
    ...
  1. See ParticipantStateType
  2. See ListParticipantsResponseTypeDef
# list_participants method usage example with argument unpacking

kwargs: ListParticipantsRequestRequestTypeDef = {  # (1)
    "sessionId": ...,
    "stageArn": ...,
}

parent.list_participants(**kwargs)
  1. See ListParticipantsRequestRequestTypeDef

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,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListStageSessionsResponseTypeDef:  # (1)
    ...
  1. See ListStageSessionsResponseTypeDef
# list_stage_sessions method usage example with argument unpacking

kwargs: ListStageSessionsRequestRequestTypeDef = {  # (1)
    "stageArn": ...,
}

parent.list_stage_sessions(**kwargs)
  1. See ListStageSessionsRequestRequestTypeDef

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,
    *,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListStagesResponseTypeDef:  # (1)
    ...
  1. See ListStagesResponseTypeDef
# list_stages method usage example with argument unpacking

kwargs: ListStagesRequestRequestTypeDef = {  # (1)
    "maxResults": ...,
}

parent.list_stages(**kwargs)
  1. See ListStagesRequestRequestTypeDef

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,
    *,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListStorageConfigurationsResponseTypeDef:  # (1)
    ...
  1. See ListStorageConfigurationsResponseTypeDef
# list_storage_configurations method usage example with argument unpacking

kwargs: ListStorageConfigurationsRequestRequestTypeDef = {  # (1)
    "maxResults": ...,
}

parent.list_storage_configurations(**kwargs)
  1. See ListStorageConfigurationsRequestRequestTypeDef

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)
    ...
  1. See ListTagsForResourceResponseTypeDef
# list_tags_for_resource method usage example with argument unpacking

kwargs: ListTagsForResourceRequestRequestTypeDef = {  # (1)
    "resourceArn": ...,
}

parent.list_tags_for_resource(**kwargs)
  1. See ListTagsForResourceRequestRequestTypeDef

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,
    *,
    destinations: Sequence[DestinationConfigurationTypeDef],  # (1)
    stageArn: str,
    idempotencyToken: str = ...,
    layout: LayoutConfigurationTypeDef = ...,  # (2)
    tags: Mapping[str, str] = ...,
) -> StartCompositionResponseTypeDef:  # (3)
    ...
  1. See DestinationConfigurationTypeDef
  2. See LayoutConfigurationTypeDef
  3. See StartCompositionResponseTypeDef
# start_composition method usage example with argument unpacking

kwargs: StartCompositionRequestRequestTypeDef = {  # (1)
    "destinations": ...,
    "stageArn": ...,
}

parent.start_composition(**kwargs)
  1. See StartCompositionRequestRequestTypeDef

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)
  1. See StopCompositionRequestRequestTypeDef

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)
  1. See TagResourceRequestRequestTypeDef

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)
  1. See UntagResourceRequestRequestTypeDef

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 = ...,
) -> UpdateStageResponseTypeDef:  # (1)
    ...
  1. See UpdateStageResponseTypeDef
# update_stage method usage example with argument unpacking

kwargs: UpdateStageRequestRequestTypeDef = {  # (1)
    "arn": ...,
}

parent.update_stage(**kwargs)
  1. See UpdateStageRequestRequestTypeDef