Skip to content

StreamUrlSummary

Source code in docs_src/capo_gameliftstreams/types/stream_url_summary.py
class StreamUrlSummary(TypedDict, closed=True):
    arn: "capo_gameliftstreams.types.arn.Arn"
    """<p>The <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon Resource Name (ARN)</a> that uniquely identifies the stream URL across all Amazon Web Services Regions. Format is <code>arn:aws:gameliftstreams:[AWS Region]:[AWS account]:streamurl/[stream group resource ID]/[stream URL resource ID]</code>.</p>"""
    stream_url_id: NotRequired["capo_gameliftstreams.types.id.Id"]
    """<p>The unique identifier for the stream URL resource, for example <code>su-1AB2C3De4</code>.</p>"""
    stream_url: NotRequired[
        "capo_gameliftstreams.types.stream_session_stream_url.StreamSessionStreamUrl"
    ]
    """<p>The shareable stream URL. Distribute this URL to end users so that they can start and play a stream session in a hosted web player. Treat the stream URL as a secret. Anyone who has it can start a stream session until the stream URL expires, is revoked, or reaches its usage limit.</p>"""
    status: NotRequired["capo_gameliftstreams.types.stream_url_status.StreamUrlStatus"]
    """<p>The current status of the stream URL. Possible statuses include the following:</p> <ul> <li> <p> <code>ACTIVE</code>: The stream URL is valid and can start stream sessions.</p> </li> <li> <p> <code>EXPIRED</code>: The stream URL has passed its expiration time and can no longer start stream sessions.</p> </li> <li> <p> <code>REVOKED</code>: The stream URL was revoked and can no longer start stream sessions.</p> </li> <li> <p> <code>LIMIT_REACHED</code>: The stream URL has been used the maximum number of times and can no longer start stream sessions.</p> </li> </ul>"""
    status_reason: NotRequired[
        "capo_gameliftstreams.types.stream_url_status_reason.StreamUrlStatusReason"
    ]
    """<p>Additional information about why the stream URL is in its current status. Amazon GameLift Streams populates this value when the status is <code>REVOKED</code>. Possible values include the following:</p> <ul> <li> <p> <code>userRevoked</code>: You revoked the stream URL.</p> </li> <li> <p> <code>revokedAndTerminatingSessions</code>: You revoked the stream URL and Amazon GameLift Streams is ending its running stream sessions.</p> </li> <li> <p> <code>revokedAndSessionsTerminated</code>: You revoked the stream URL and its running stream sessions have ended.</p> </li> <li> <p> <code>streamGroupDeleted</code>: The stream group was deleted, which revoked the stream URL.</p> </li> <li> <p> <code>applicationDeleted</code>: The application was deleted, which revoked the stream URL.</p> </li> </ul>"""
    expires_at: NotRequired["datetime.datetime"]
    """<p>The date and time when the stream URL expires and stops accepting new stream sessions. Timestamps are expressed using in ISO8601 format, such as: <code>2022-12-27T22:29:40+00:00</code> (UTC).</p>"""
    created_at: NotRequired["datetime.datetime"]
    """<p>A timestamp that indicates when this resource was created. Timestamps are expressed using in ISO8601 format, such as: <code>2022-12-27T22:29:40+00:00</code> (UTC).</p>"""
    usage_limit: NotRequired["capo_gameliftstreams.types.usage_limit.UsageLimit"]
    """<p>The maximum number of times the stream URL can start a stream session.</p>"""
    remaining_uses: NotRequired[
        "capo_gameliftstreams.types.remaining_uses.RemainingUses"
    ]
    """<p>The number of times the stream URL can still be used to start a stream session.</p>"""
    stream_group_arn: NotRequired["capo_gameliftstreams.types.arn.Arn"]
    """<p>The stream group that runs the stream sessions.</p> <p>This value is an <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon Resource Name (ARN)</a> that uniquely identifies the stream group resource. Example ARN: <code>arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4</code>. </p>"""
    application_arn: NotRequired["capo_gameliftstreams.types.arn.Arn"]
    """<p>The application that runs in the stream sessions.</p> <p>This value is an <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon Resource Name (ARN)</a> that uniquely identifies the application resource. Example ARN: <code>arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6</code>. </p>"""
    session_length_seconds: NotRequired[
        "capo_gameliftstreams.types.session_length_seconds.SessionLengthSeconds"
    ]
    """<p>The maximum length of time, in seconds, that a stream session started from this stream URL can run.</p>"""
    description: NotRequired["capo_gameliftstreams.types.description.Description"]
    """<p>The descriptive label for the stream URL.</p>"""

application_arn instance-attribute

application_arn: NotRequired[Arn]

The application that runs in the stream sessions.

This value is an Amazon Resource Name (ARN) that uniquely identifies the application resource. Example ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6.

arn instance-attribute

arn: Arn

The Amazon Resource Name (ARN) that uniquely identifies the stream URL across all Amazon Web Services Regions. Format is arn:aws:gameliftstreams:[AWS Region]:[AWS account]:streamurl/[stream group resource ID]/[stream URL resource ID].

created_at instance-attribute

created_at: NotRequired[datetime]

A timestamp that indicates when this resource was created. Timestamps are expressed using in ISO8601 format, such as: 2022-12-27T22:29:40+00:00 (UTC).

description instance-attribute

description: NotRequired[Description]

The descriptive label for the stream URL.

expires_at instance-attribute

expires_at: NotRequired[datetime]

The date and time when the stream URL expires and stops accepting new stream sessions. Timestamps are expressed using in ISO8601 format, such as: 2022-12-27T22:29:40+00:00 (UTC).

remaining_uses instance-attribute

remaining_uses: NotRequired[RemainingUses]

The number of times the stream URL can still be used to start a stream session.

session_length_seconds instance-attribute

session_length_seconds: NotRequired[SessionLengthSeconds]

The maximum length of time, in seconds, that a stream session started from this stream URL can run.

status instance-attribute

status: NotRequired[StreamUrlStatus]

The current status of the stream URL. Possible statuses include the following:

  • ACTIVE: The stream URL is valid and can start stream sessions.

  • EXPIRED: The stream URL has passed its expiration time and can no longer start stream sessions.

  • REVOKED: The stream URL was revoked and can no longer start stream sessions.

  • LIMIT_REACHED: The stream URL has been used the maximum number of times and can no longer start stream sessions.

status_reason instance-attribute

status_reason: NotRequired[StreamUrlStatusReason]

Additional information about why the stream URL is in its current status. Amazon GameLift Streams populates this value when the status is REVOKED. Possible values include the following:

  • userRevoked: You revoked the stream URL.

  • revokedAndTerminatingSessions: You revoked the stream URL and Amazon GameLift Streams is ending its running stream sessions.

  • revokedAndSessionsTerminated: You revoked the stream URL and its running stream sessions have ended.

  • streamGroupDeleted: The stream group was deleted, which revoked the stream URL.

  • applicationDeleted: The application was deleted, which revoked the stream URL.

stream_group_arn instance-attribute

stream_group_arn: NotRequired[Arn]

The stream group that runs the stream sessions.

This value is an Amazon Resource Name (ARN) that uniquely identifies the stream group resource. Example ARN: arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4.

stream_url instance-attribute

stream_url: NotRequired[StreamSessionStreamUrl]

The shareable stream URL. Distribute this URL to end users so that they can start and play a stream session in a hosted web player. Treat the stream URL as a secret. Anyone who has it can start a stream session until the stream URL expires, is revoked, or reaches its usage limit.

stream_url_id instance-attribute

stream_url_id: NotRequired[Id]

The unique identifier for the stream URL resource, for example su-1AB2C3De4.

usage_limit instance-attribute

usage_limit: NotRequired[UsageLimit]

The maximum number of times the stream URL can start a stream session.