KinesisVideo / Client / tag_stream

tag_stream#

KinesisVideo.Client.tag_stream(**kwargs)#

Adds one or more tags to a stream. A tag is a key-value pair (the value is optional) that you can define and assign to Amazon Web Services resources. If you specify a tag that already exists, the tag value is replaced with the value that you specify in the request. For more information, see Using Cost Allocation Tags in the Billing and Cost Management and Cost Management User Guide.

You must provide either the StreamName or the StreamARN.

This operation requires permission for the KinesisVideo:TagStream action.

A Kinesis video stream can support up to 50 tags.

See also: AWS API Documentation

Request Syntax

response = client.tag_stream(
    StreamARN='string',
    StreamName='string',
    Tags={
        'string': 'string'
    }
)
Parameters:
  • StreamARN (string) – The Amazon Resource Name (ARN) of the resource that you want to add the tag or tags to.

  • StreamName (string) – The name of the stream that you want to add the tag or tags to.

  • Tags (dict) –

    [REQUIRED]

    A list of tags to associate with the specified stream. Each tag is a key-value pair (the value is optional).

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

  • (dict) –

Exceptions

  • KinesisVideo.Client.exceptions.ClientLimitExceededException

  • KinesisVideo.Client.exceptions.InvalidArgumentException

  • KinesisVideo.Client.exceptions.ResourceNotFoundException

  • KinesisVideo.Client.exceptions.NotAuthorizedException

  • KinesisVideo.Client.exceptions.InvalidResourceFormatException

  • KinesisVideo.Client.exceptions.TagsPerResourceExceededLimitException