aws-sdk-ivs 1.14.0 → 1.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba7eb726875989991c09b86afa89b0269f8698b6989d057879d237bde53ab30b
-  data.tar.gz: 569ec79e8460ce0a0c82dfdde71c62531c80e949737111048f283c5dc1dc8d21
+  metadata.gz: c2defe36ffa387d4f983fa4f0f1cf59c232e24e81fa264e4659fa29774d19566
+  data.tar.gz: 1859df720ad5a7fe970e5f5ae332b1ddd0e6065fa9230a5b78f490e6462a272b
 SHA512:
-  metadata.gz: 82a6d67135d4a29c838384b703e90665a97e65b7d3aed493131403f8b2820784588b8260a057e4d6568c705f870863b755d7656d042e9e0a5ad239ddd3a1b2c8
-  data.tar.gz: 0346bcd4317a3a3ec988eb3c735dcf2c6efd874cac3572af2287f475e4cbd0127512988a942cd2958df2471b29bf9592d0e30d7dd19879e20c014a95c1667f12
+  metadata.gz: 68ce55d389cbc1fbbee903698078a095b1dae3c31b7d021f1fe0f669e66139bfb6f8ea8933236f7ddd0b7edcf06f314f5cb10fec5637d33865c95d792387c8aa
+  data.tar.gz: fce8de75293c409f5d288a76324d56803b713ced73a5213926ba75b022e18f1c480bbc7a9e2216e07d8076909065915b685ddf5fab67bab26bc811dcdae299a3

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.15.0 (2021-11-18)
+------------------
+
+* Feature - Add APIs for retrieving stream session information and support for filtering live streams by health.  For more information, see https://docs.aws.amazon.com/ivs/latest/userguide/stream-health.html
+
 1.14.0 (2021-11-04)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.14.0
+1.15.0

data/lib/aws-sdk-ivs/client.rb

@@ -853,6 +853,7 @@ module Aws::IVS
     #   resp.stream.playback_url #=> String
     #   resp.stream.start_time #=> Time
     #   resp.stream.state #=> String, one of "LIVE", "OFFLINE"
+    #   resp.stream.stream_id #=> String
     #   resp.stream.viewer_count #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/GetStream AWS API Documentation
@@ -896,6 +897,74 @@ module Aws::IVS
       req.send_request(options)
     end
 
+    # Gets metadata on a specified stream.
+    #
+    # @option params [required, String] :channel_arn
+    #   ARN of the channel resource
+    #
+    # @option params [String] :stream_id
+    #   Unique identifier for a live or previously live stream in the
+    #   specified channel. If no `streamId` is provided, this returns the most
+    #   recent stream session for the channel, if it exists.
+    #
+    # @return [Types::GetStreamSessionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetStreamSessionResponse#stream_session #stream_session} => Types::StreamSession
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_stream_session({
+    #     channel_arn: "ChannelArn", # required
+    #     stream_id: "StreamId",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.stream_session.channel.arn #=> String
+    #   resp.stream_session.channel.authorized #=> Boolean
+    #   resp.stream_session.channel.ingest_endpoint #=> String
+    #   resp.stream_session.channel.latency_mode #=> String, one of "NORMAL", "LOW"
+    #   resp.stream_session.channel.name #=> String
+    #   resp.stream_session.channel.playback_url #=> String
+    #   resp.stream_session.channel.recording_configuration_arn #=> String
+    #   resp.stream_session.channel.tags #=> Hash
+    #   resp.stream_session.channel.tags["TagKey"] #=> String
+    #   resp.stream_session.channel.type #=> String, one of "BASIC", "STANDARD"
+    #   resp.stream_session.end_time #=> Time
+    #   resp.stream_session.ingest_configuration.audio.channels #=> Integer
+    #   resp.stream_session.ingest_configuration.audio.codec #=> String
+    #   resp.stream_session.ingest_configuration.audio.sample_rate #=> Integer
+    #   resp.stream_session.ingest_configuration.audio.target_bitrate #=> Integer
+    #   resp.stream_session.ingest_configuration.video.avc_level #=> String
+    #   resp.stream_session.ingest_configuration.video.avc_profile #=> String
+    #   resp.stream_session.ingest_configuration.video.codec #=> String
+    #   resp.stream_session.ingest_configuration.video.encoder #=> String
+    #   resp.stream_session.ingest_configuration.video.target_bitrate #=> Integer
+    #   resp.stream_session.ingest_configuration.video.target_framerate #=> Integer
+    #   resp.stream_session.ingest_configuration.video.video_height #=> Integer
+    #   resp.stream_session.ingest_configuration.video.video_width #=> Integer
+    #   resp.stream_session.recording_configuration.arn #=> String
+    #   resp.stream_session.recording_configuration.destination_configuration.s3.bucket_name #=> String
+    #   resp.stream_session.recording_configuration.name #=> String
+    #   resp.stream_session.recording_configuration.state #=> String, one of "CREATING", "CREATE_FAILED", "ACTIVE"
+    #   resp.stream_session.recording_configuration.tags #=> Hash
+    #   resp.stream_session.recording_configuration.tags["TagKey"] #=> String
+    #   resp.stream_session.start_time #=> Time
+    #   resp.stream_session.stream_id #=> String
+    #   resp.stream_session.truncated_events #=> Array
+    #   resp.stream_session.truncated_events[0].event_time #=> Time
+    #   resp.stream_session.truncated_events[0].name #=> String
+    #   resp.stream_session.truncated_events[0].type #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/GetStreamSession AWS API Documentation
+    #
+    # @overload get_stream_session(params = {})
+    # @param [Hash] params ({})
+    def get_stream_session(params = {}, options = {})
+      req = build_request(:get_stream_session, params)
+      req.send_request(options)
+    end
+
     # Imports the public portion of a new key pair and returns its `arn` and
     # `fingerprint`. The `privateKey` can then be used to generate viewer
     # authorization tokens, to grant viewers access to private channels. For
@@ -1142,9 +1211,58 @@ module Aws::IVS
       req.send_request(options)
     end
 
+    # 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.
+    #
+    # @option params [required, String] :channel_arn
+    #   Channel ARN used to filter the list.
+    #
+    # @option params [Integer] :max_results
+    #   Maximum number of streams to return. Default: 50.
+    #
+    # @option params [String] :next_token
+    #   The first stream to retrieve. This is used for pagination; see the
+    #   `nextToken` response field.
+    #
+    # @return [Types::ListStreamSessionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListStreamSessionsResponse#next_token #next_token} => String
+    #   * {Types::ListStreamSessionsResponse#stream_sessions #stream_sessions} => Array<Types::StreamSessionSummary>
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_stream_sessions({
+    #     channel_arn: "ChannelArn", # required
+    #     max_results: 1,
+    #     next_token: "PaginationToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.stream_sessions #=> Array
+    #   resp.stream_sessions[0].end_time #=> Time
+    #   resp.stream_sessions[0].has_error_event #=> Boolean
+    #   resp.stream_sessions[0].start_time #=> Time
+    #   resp.stream_sessions[0].stream_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/ListStreamSessions AWS API Documentation
+    #
+    # @overload list_stream_sessions(params = {})
+    # @param [Hash] params ({})
+    def list_stream_sessions(params = {}, options = {})
+      req = build_request(:list_stream_sessions, params)
+      req.send_request(options)
+    end
+
     # Gets summary information about live streams in your account, in the
     # Amazon Web Services region where the API request is processed.
     #
+    # @option params [Types::StreamFilters] :filter_by
+    #   Filters the stream list to match the specified criterion.
+    #
     # @option params [Integer] :max_results
     #   Maximum number of streams to return. Default: 50.
     #
@@ -1162,6 +1280,9 @@ module Aws::IVS
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_streams({
+    #     filter_by: {
+    #       health: "HEALTHY", # accepts HEALTHY, STARVING, UNKNOWN
+    #     },
     #     max_results: 1,
     #     next_token: "PaginationToken",
     #   })
@@ -1174,6 +1295,7 @@ module Aws::IVS
     #   resp.streams[0].health #=> String, one of "HEALTHY", "STARVING", "UNKNOWN"
     #   resp.streams[0].start_time #=> Time
     #   resp.streams[0].state #=> String, one of "LIVE", "OFFLINE"
+    #   resp.streams[0].stream_id #=> String
     #   resp.streams[0].viewer_count #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/ListStreams AWS API Documentation
@@ -1424,7 +1546,7 @@ module Aws::IVS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ivs'
-      context[:gem_version] = '1.14.0'
+      context[:gem_version] = '1.15.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-ivs/client_api.rb

@@ -14,6 +14,7 @@ module Aws::IVS
     include Seahorse::Model
 
     AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
+    AudioConfiguration = Shapes::StructureShape.new(name: 'AudioConfiguration')
     BatchError = Shapes::StructureShape.new(name: 'BatchError')
     BatchErrors = Shapes::ListShape.new(name: 'BatchErrors')
     BatchGetChannelRequest = Shapes::StructureShape.new(name: 'BatchGetChannelRequest')
@@ -55,9 +56,13 @@ module Aws::IVS
     GetStreamKeyResponse = Shapes::StructureShape.new(name: 'GetStreamKeyResponse')
     GetStreamRequest = Shapes::StructureShape.new(name: 'GetStreamRequest')
     GetStreamResponse = Shapes::StructureShape.new(name: 'GetStreamResponse')
+    GetStreamSessionRequest = Shapes::StructureShape.new(name: 'GetStreamSessionRequest')
+    GetStreamSessionResponse = Shapes::StructureShape.new(name: 'GetStreamSessionResponse')
     ImportPlaybackKeyPairRequest = Shapes::StructureShape.new(name: 'ImportPlaybackKeyPairRequest')
     ImportPlaybackKeyPairResponse = Shapes::StructureShape.new(name: 'ImportPlaybackKeyPairResponse')
+    IngestConfiguration = Shapes::StructureShape.new(name: 'IngestConfiguration')
     IngestEndpoint = Shapes::StringShape.new(name: 'IngestEndpoint')
+    Integer = Shapes::IntegerShape.new(name: 'Integer')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
     IsAuthorized = Shapes::BooleanShape.new(name: 'IsAuthorized')
     ListChannelsRequest = Shapes::StructureShape.new(name: 'ListChannelsRequest')
@@ -68,6 +73,8 @@ module Aws::IVS
     ListRecordingConfigurationsResponse = Shapes::StructureShape.new(name: 'ListRecordingConfigurationsResponse')
     ListStreamKeysRequest = Shapes::StructureShape.new(name: 'ListStreamKeysRequest')
     ListStreamKeysResponse = Shapes::StructureShape.new(name: 'ListStreamKeysResponse')
+    ListStreamSessionsRequest = Shapes::StructureShape.new(name: 'ListStreamSessionsRequest')
+    ListStreamSessionsResponse = Shapes::StructureShape.new(name: 'ListStreamSessionsResponse')
     ListStreamsRequest = Shapes::StructureShape.new(name: 'ListStreamsRequest')
     ListStreamsResponse = Shapes::StructureShape.new(name: 'ListStreamsResponse')
     ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest')
@@ -102,7 +109,11 @@ module Aws::IVS
     StopStreamRequest = Shapes::StructureShape.new(name: 'StopStreamRequest')
     StopStreamResponse = Shapes::StructureShape.new(name: 'StopStreamResponse')
     Stream = Shapes::StructureShape.new(name: 'Stream')
+    StreamEvent = Shapes::StructureShape.new(name: 'StreamEvent')
+    StreamEvents = Shapes::ListShape.new(name: 'StreamEvents')
+    StreamFilters = Shapes::StructureShape.new(name: 'StreamFilters')
     StreamHealth = Shapes::StringShape.new(name: 'StreamHealth')
+    StreamId = Shapes::StringShape.new(name: 'StreamId')
     StreamKey = Shapes::StructureShape.new(name: 'StreamKey')
     StreamKeyArn = Shapes::StringShape.new(name: 'StreamKeyArn')
     StreamKeyArnList = Shapes::ListShape.new(name: 'StreamKeyArnList')
@@ -112,11 +123,15 @@ module Aws::IVS
     StreamKeys = Shapes::ListShape.new(name: 'StreamKeys')
     StreamList = Shapes::ListShape.new(name: 'StreamList')
     StreamMetadata = Shapes::StringShape.new(name: 'StreamMetadata')
+    StreamSession = Shapes::StructureShape.new(name: 'StreamSession')
+    StreamSessionList = Shapes::ListShape.new(name: 'StreamSessionList')
+    StreamSessionSummary = Shapes::StructureShape.new(name: 'StreamSessionSummary')
     StreamStartTime = Shapes::TimestampShape.new(name: 'StreamStartTime', timestampFormat: "iso8601")
     StreamState = Shapes::StringShape.new(name: 'StreamState')
     StreamSummary = Shapes::StructureShape.new(name: 'StreamSummary')
     StreamUnavailable = Shapes::StructureShape.new(name: 'StreamUnavailable')
     StreamViewerCount = Shapes::IntegerShape.new(name: 'StreamViewerCount')
+    String = Shapes::StringShape.new(name: 'String')
     TagKey = Shapes::StringShape.new(name: 'TagKey')
     TagKeyList = Shapes::ListShape.new(name: 'TagKeyList')
     TagResourceRequest = Shapes::StructureShape.new(name: 'TagResourceRequest')
@@ -124,17 +139,25 @@ module Aws::IVS
     TagValue = Shapes::StringShape.new(name: 'TagValue')
     Tags = Shapes::MapShape.new(name: 'Tags')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
+    Time = Shapes::TimestampShape.new(name: 'Time', timestampFormat: "iso8601")
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
     UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
     UpdateChannelRequest = Shapes::StructureShape.new(name: 'UpdateChannelRequest')
     UpdateChannelResponse = Shapes::StructureShape.new(name: 'UpdateChannelResponse')
     ValidationException = Shapes::StructureShape.new(name: 'ValidationException')
+    VideoConfiguration = Shapes::StructureShape.new(name: 'VideoConfiguration')
     errorCode = Shapes::StringShape.new(name: 'errorCode')
     errorMessage = Shapes::StringShape.new(name: 'errorMessage')
 
     AccessDeniedException.add_member(:exception_message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "exceptionMessage"))
     AccessDeniedException.struct_class = Types::AccessDeniedException
 
+    AudioConfiguration.add_member(:channels, Shapes::ShapeRef.new(shape: Integer, location_name: "channels"))
+    AudioConfiguration.add_member(:codec, Shapes::ShapeRef.new(shape: String, location_name: "codec"))
+    AudioConfiguration.add_member(:sample_rate, Shapes::ShapeRef.new(shape: Integer, location_name: "sampleRate"))
+    AudioConfiguration.add_member(:target_bitrate, Shapes::ShapeRef.new(shape: Integer, location_name: "targetBitrate"))
+    AudioConfiguration.struct_class = Types::AudioConfiguration
+
     BatchError.add_member(:arn, Shapes::ShapeRef.new(shape: ResourceArn, location_name: "arn"))
     BatchError.add_member(:code, Shapes::ShapeRef.new(shape: errorCode, location_name: "code"))
     BatchError.add_member(:message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "message"))
@@ -261,6 +284,13 @@ module Aws::IVS
     GetStreamResponse.add_member(:stream, Shapes::ShapeRef.new(shape: Stream, location_name: "stream"))
     GetStreamResponse.struct_class = Types::GetStreamResponse
 
+    GetStreamSessionRequest.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, required: true, location_name: "channelArn"))
+    GetStreamSessionRequest.add_member(:stream_id, Shapes::ShapeRef.new(shape: StreamId, location_name: "streamId"))
+    GetStreamSessionRequest.struct_class = Types::GetStreamSessionRequest
+
+    GetStreamSessionResponse.add_member(:stream_session, Shapes::ShapeRef.new(shape: StreamSession, location_name: "streamSession"))
+    GetStreamSessionResponse.struct_class = Types::GetStreamSessionResponse
+
     ImportPlaybackKeyPairRequest.add_member(:name, Shapes::ShapeRef.new(shape: PlaybackKeyPairName, location_name: "name"))
     ImportPlaybackKeyPairRequest.add_member(:public_key_material, Shapes::ShapeRef.new(shape: PlaybackPublicKeyMaterial, required: true, location_name: "publicKeyMaterial"))
     ImportPlaybackKeyPairRequest.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
@@ -269,6 +299,10 @@ module Aws::IVS
     ImportPlaybackKeyPairResponse.add_member(:key_pair, Shapes::ShapeRef.new(shape: PlaybackKeyPair, location_name: "keyPair"))
     ImportPlaybackKeyPairResponse.struct_class = Types::ImportPlaybackKeyPairResponse
 
+    IngestConfiguration.add_member(:audio, Shapes::ShapeRef.new(shape: AudioConfiguration, location_name: "audio"))
+    IngestConfiguration.add_member(:video, Shapes::ShapeRef.new(shape: VideoConfiguration, location_name: "video"))
+    IngestConfiguration.struct_class = Types::IngestConfiguration
+
     InternalServerException.add_member(:exception_message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "exceptionMessage"))
     InternalServerException.struct_class = Types::InternalServerException
 
@@ -307,6 +341,16 @@ module Aws::IVS
     ListStreamKeysResponse.add_member(:stream_keys, Shapes::ShapeRef.new(shape: StreamKeyList, required: true, location_name: "streamKeys"))
     ListStreamKeysResponse.struct_class = Types::ListStreamKeysResponse
 
+    ListStreamSessionsRequest.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, required: true, location_name: "channelArn"))
+    ListStreamSessionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxStreamResults, location_name: "maxResults"))
+    ListStreamSessionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken"))
+    ListStreamSessionsRequest.struct_class = Types::ListStreamSessionsRequest
+
+    ListStreamSessionsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken"))
+    ListStreamSessionsResponse.add_member(:stream_sessions, Shapes::ShapeRef.new(shape: StreamSessionList, required: true, location_name: "streamSessions"))
+    ListStreamSessionsResponse.struct_class = Types::ListStreamSessionsResponse
+
+    ListStreamsRequest.add_member(:filter_by, Shapes::ShapeRef.new(shape: StreamFilters, location_name: "filterBy"))
     ListStreamsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxStreamResults, location_name: "maxResults"))
     ListStreamsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken"))
     ListStreamsRequest.struct_class = Types::ListStreamsRequest
@@ -376,9 +420,20 @@ module Aws::IVS
     Stream.add_member(:playback_url, Shapes::ShapeRef.new(shape: PlaybackURL, location_name: "playbackUrl"))
     Stream.add_member(:start_time, Shapes::ShapeRef.new(shape: StreamStartTime, location_name: "startTime"))
     Stream.add_member(:state, Shapes::ShapeRef.new(shape: StreamState, location_name: "state"))
+    Stream.add_member(:stream_id, Shapes::ShapeRef.new(shape: StreamId, location_name: "streamId"))
     Stream.add_member(:viewer_count, Shapes::ShapeRef.new(shape: StreamViewerCount, location_name: "viewerCount"))
     Stream.struct_class = Types::Stream
 
+    StreamEvent.add_member(:event_time, Shapes::ShapeRef.new(shape: Time, location_name: "eventTime"))
+    StreamEvent.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
+    StreamEvent.add_member(:type, Shapes::ShapeRef.new(shape: String, location_name: "type"))
+    StreamEvent.struct_class = Types::StreamEvent
+
+    StreamEvents.member = Shapes::ShapeRef.new(shape: StreamEvent)
+
+    StreamFilters.add_member(:health, Shapes::ShapeRef.new(shape: StreamHealth, location_name: "health"))
+    StreamFilters.struct_class = Types::StreamFilters
+
     StreamKey.add_member(:arn, Shapes::ShapeRef.new(shape: StreamKeyArn, location_name: "arn"))
     StreamKey.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, location_name: "channelArn"))
     StreamKey.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
@@ -398,10 +453,28 @@ module Aws::IVS
 
     StreamList.member = Shapes::ShapeRef.new(shape: StreamSummary)
 
+    StreamSession.add_member(:channel, Shapes::ShapeRef.new(shape: Channel, location_name: "channel"))
+    StreamSession.add_member(:end_time, Shapes::ShapeRef.new(shape: Time, location_name: "endTime"))
+    StreamSession.add_member(:ingest_configuration, Shapes::ShapeRef.new(shape: IngestConfiguration, location_name: "ingestConfiguration"))
+    StreamSession.add_member(:recording_configuration, Shapes::ShapeRef.new(shape: RecordingConfiguration, location_name: "recordingConfiguration"))
+    StreamSession.add_member(:start_time, Shapes::ShapeRef.new(shape: Time, location_name: "startTime"))
+    StreamSession.add_member(:stream_id, Shapes::ShapeRef.new(shape: StreamId, location_name: "streamId"))
+    StreamSession.add_member(:truncated_events, Shapes::ShapeRef.new(shape: StreamEvents, location_name: "truncatedEvents"))
+    StreamSession.struct_class = Types::StreamSession
+
+    StreamSessionList.member = Shapes::ShapeRef.new(shape: StreamSessionSummary)
+
+    StreamSessionSummary.add_member(:end_time, Shapes::ShapeRef.new(shape: Time, location_name: "endTime"))
+    StreamSessionSummary.add_member(:has_error_event, Shapes::ShapeRef.new(shape: Boolean, location_name: "hasErrorEvent"))
+    StreamSessionSummary.add_member(:start_time, Shapes::ShapeRef.new(shape: Time, location_name: "startTime"))
+    StreamSessionSummary.add_member(:stream_id, Shapes::ShapeRef.new(shape: StreamId, location_name: "streamId"))
+    StreamSessionSummary.struct_class = Types::StreamSessionSummary
+
     StreamSummary.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, location_name: "channelArn"))
     StreamSummary.add_member(:health, Shapes::ShapeRef.new(shape: StreamHealth, location_name: "health"))
     StreamSummary.add_member(:start_time, Shapes::ShapeRef.new(shape: StreamStartTime, location_name: "startTime"))
     StreamSummary.add_member(:state, Shapes::ShapeRef.new(shape: StreamState, location_name: "state"))
+    StreamSummary.add_member(:stream_id, Shapes::ShapeRef.new(shape: StreamId, location_name: "streamId"))
     StreamSummary.add_member(:viewer_count, Shapes::ShapeRef.new(shape: StreamViewerCount, location_name: "viewerCount"))
     StreamSummary.struct_class = Types::StreamSummary
 
@@ -442,6 +515,16 @@ module Aws::IVS
     ValidationException.add_member(:exception_message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "exceptionMessage"))
     ValidationException.struct_class = Types::ValidationException
 
+    VideoConfiguration.add_member(:avc_level, Shapes::ShapeRef.new(shape: String, location_name: "avcLevel"))
+    VideoConfiguration.add_member(:avc_profile, Shapes::ShapeRef.new(shape: String, location_name: "avcProfile"))
+    VideoConfiguration.add_member(:codec, Shapes::ShapeRef.new(shape: String, location_name: "codec"))
+    VideoConfiguration.add_member(:encoder, Shapes::ShapeRef.new(shape: String, location_name: "encoder"))
+    VideoConfiguration.add_member(:target_bitrate, Shapes::ShapeRef.new(shape: Integer, location_name: "targetBitrate"))
+    VideoConfiguration.add_member(:target_framerate, Shapes::ShapeRef.new(shape: Integer, location_name: "targetFramerate"))
+    VideoConfiguration.add_member(:video_height, Shapes::ShapeRef.new(shape: Integer, location_name: "videoHeight"))
+    VideoConfiguration.add_member(:video_width, Shapes::ShapeRef.new(shape: Integer, location_name: "videoWidth"))
+    VideoConfiguration.struct_class = Types::VideoConfiguration
+
 
     # @api private
     API = Seahorse::Model::Api.new.tap do |api|
@@ -624,6 +707,17 @@ module Aws::IVS
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
       end)
 
+      api.add_operation(:get_stream_session, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetStreamSession"
+        o.http_method = "POST"
+        o.http_request_uri = "/GetStreamSession"
+        o.input = Shapes::ShapeRef.new(shape: GetStreamSessionRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetStreamSessionResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+      end)
+
       api.add_operation(:import_playback_key_pair, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ImportPlaybackKeyPair"
         o.http_method = "POST"
@@ -704,6 +798,23 @@ module Aws::IVS
         )
       end)
 
+      api.add_operation(:list_stream_sessions, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListStreamSessions"
+        o.http_method = "POST"
+        o.http_request_uri = "/ListStreamSessions"
+        o.input = Shapes::ShapeRef.new(shape: ListStreamSessionsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListStreamSessionsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_streams, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListStreams"
         o.http_method = "POST"

data/lib/aws-sdk-ivs/types.rb

@@ -22,6 +22,36 @@ module Aws::IVS
       include Aws::Structure
     end
 
+    # Object specifying a stream’s audio configuration.
+    #
+    # @!attribute [rw] channels
+    #   Number of audio channels.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] codec
+    #   Codec used for the audio encoding.
+    #   @return [String]
+    #
+    # @!attribute [rw] sample_rate
+    #   Number of audio samples recorded per second.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] target_bitrate
+    #   The expected ingest bitrate (bits per second). This is configured in
+    #   the encoder.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/AudioConfiguration AWS API Documentation
+    #
+    class AudioConfiguration < Struct.new(
+      :channels,
+      :codec,
+      :sample_rate,
+      :target_bitrate)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Error related to a specific channel, specified by its ARN.
     #
     # @!attribute [rw] arn
@@ -699,6 +729,45 @@ module Aws::IVS
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetStreamSessionRequest
+    #   data as a hash:
+    #
+    #       {
+    #         channel_arn: "ChannelArn", # required
+    #         stream_id: "StreamId",
+    #       }
+    #
+    # @!attribute [rw] channel_arn
+    #   ARN of the channel resource
+    #   @return [String]
+    #
+    # @!attribute [rw] stream_id
+    #   Unique identifier for a live or previously live stream in the
+    #   specified channel. If no `streamId` is provided, this returns the
+    #   most recent stream session for the channel, if it exists.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/GetStreamSessionRequest AWS API Documentation
+    #
+    class GetStreamSessionRequest < Struct.new(
+      :channel_arn,
+      :stream_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] stream_session
+    #   List of stream details.
+    #   @return [Types::StreamSession]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/GetStreamSessionResponse AWS API Documentation
+    #
+    class GetStreamSessionResponse < Struct.new(
+      :stream_session)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ImportPlaybackKeyPairRequest
     #   data as a hash:
     #
@@ -744,6 +813,26 @@ module Aws::IVS
       include Aws::Structure
     end
 
+    # Object specifying the ingest configuration set up by the broadcaster,
+    # usually in an encoder.
+    #
+    # @!attribute [rw] audio
+    #   Encoder settings for audio.
+    #   @return [Types::AudioConfiguration]
+    #
+    # @!attribute [rw] video
+    #   Encoder settings for video.
+    #   @return [Types::VideoConfiguration]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/IngestConfiguration AWS API Documentation
+    #
+    class IngestConfiguration < Struct.new(
+      :audio,
+      :video)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] exception_message
     #   Unexpected error during processing of request.
     #   @return [String]
@@ -951,14 +1040,70 @@ module Aws::IVS
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ListStreamSessionsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         channel_arn: "ChannelArn", # required
+    #         max_results: 1,
+    #         next_token: "PaginationToken",
+    #       }
+    #
+    # @!attribute [rw] channel_arn
+    #   Channel ARN used to filter the list.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   Maximum number of streams to return. Default: 50.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The first stream to retrieve. This is used for pagination; see the
+    #   `nextToken` response field.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/ListStreamSessionsRequest AWS API Documentation
+    #
+    class ListStreamSessionsRequest < Struct.new(
+      :channel_arn,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] next_token
+    #   If there are more streams than `maxResults`, use `nextToken` in the
+    #   request to get the next set.
+    #   @return [String]
+    #
+    # @!attribute [rw] stream_sessions
+    #   @return [Array<Types::StreamSessionSummary>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/ListStreamSessionsResponse AWS API Documentation
+    #
+    class ListStreamSessionsResponse < Struct.new(
+      :next_token,
+      :stream_sessions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListStreamsRequest
     #   data as a hash:
     #
     #       {
+    #         filter_by: {
+    #           health: "HEALTHY", # accepts HEALTHY, STARVING, UNKNOWN
+    #         },
     #         max_results: 1,
     #         next_token: "PaginationToken",
     #       }
     #
+    # @!attribute [rw] filter_by
+    #   Filters the stream list to match the specified criterion.
+    #   @return [Types::StreamFilters]
+    #
     # @!attribute [rw] max_results
     #   Maximum number of streams to return. Default: 50.
     #   @return [Integer]
@@ -971,6 +1116,7 @@ module Aws::IVS
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/ListStreamsRequest AWS API Documentation
     #
     class ListStreamsRequest < Struct.new(
+      :filter_by,
       :max_results,
       :next_token)
       SENSITIVE = []
@@ -1283,6 +1429,11 @@ module Aws::IVS
     #   The stream’s state.
     #   @return [String]
     #
+    # @!attribute [rw] stream_id
+    #   Unique identifier for a live or previously live stream in the
+    #   specified channel.
+    #   @return [String]
+    #
     # @!attribute [rw] viewer_count
     #   A count of concurrent views of the stream. Typically, a new view
     #   appears in `viewerCount` within 15 seconds of when video playback
@@ -1299,11 +1450,62 @@ module Aws::IVS
       :playback_url,
       :start_time,
       :state,
+      :stream_id,
       :viewer_count)
       SENSITIVE = []
       include Aws::Structure
     end
 
+    # Object specifying a stream’s events. For a list of events, see [Using
+    # Amazon EventBridge with Amazon IVS][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/ivs/latest/userguide/eventbridge.html
+    #
+    # @!attribute [rw] event_time
+    #   UTC ISO-8601 formatted timestamp of when the event occurred.
+    #   @return [Time]
+    #
+    # @!attribute [rw] name
+    #   Name that identifies the stream event within a `type`.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   Logical group for certain events.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/StreamEvent AWS API Documentation
+    #
+    class StreamEvent < Struct.new(
+      :event_time,
+      :name,
+      :type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Object specifying the stream attribute on which to filter.
+    #
+    # @note When making an API call, you may pass StreamFilters
+    #   data as a hash:
+    #
+    #       {
+    #         health: "HEALTHY", # accepts HEALTHY, STARVING, UNKNOWN
+    #       }
+    #
+    # @!attribute [rw] health
+    #   The stream’s health.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/StreamFilters AWS API Documentation
+    #
+    class StreamFilters < Struct.new(
+      :health)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Object specifying a stream key.
     #
     # @!attribute [rw] arn
@@ -1357,6 +1559,92 @@ module Aws::IVS
       include Aws::Structure
     end
 
+    # Object that captures the Amazon IVS configuration that the customer
+    # provisioned, the ingest configurations that the broadcaster used, and
+    # the most recent Amazon IVS stream events it encountered.
+    #
+    # @!attribute [rw] channel
+    #   The properties of the channel at the time of going live.
+    #   @return [Types::Channel]
+    #
+    # @!attribute [rw] end_time
+    #   UTC ISO-8601 formatted timestamp of when the channel went offline.
+    #   For live streams, this is `NULL`.
+    #   @return [Time]
+    #
+    # @!attribute [rw] ingest_configuration
+    #   The properties of the incoming RTMP stream for the stream.
+    #   @return [Types::IngestConfiguration]
+    #
+    # @!attribute [rw] recording_configuration
+    #   The properties of recording the live stream.
+    #   @return [Types::RecordingConfiguration]
+    #
+    # @!attribute [rw] start_time
+    #   UTC ISO-8601 formatted timestamp of when the channel went live.
+    #   @return [Time]
+    #
+    # @!attribute [rw] stream_id
+    #   Unique identifier for a live or previously live stream in the
+    #   specified channel.
+    #   @return [String]
+    #
+    # @!attribute [rw] truncated_events
+    #   List of Amazon IVS events that the stream encountered. The list is
+    #   sorted by most recent events and contains up to 500 events. For
+    #   Amazon IVS events, see [Using Amazon EventBridge with Amazon
+    #   IVS][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/ivs/latest/userguide/eventbridge.html
+    #   @return [Array<Types::StreamEvent>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/StreamSession AWS API Documentation
+    #
+    class StreamSession < Struct.new(
+      :channel,
+      :end_time,
+      :ingest_configuration,
+      :recording_configuration,
+      :start_time,
+      :stream_id,
+      :truncated_events)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Summary information about a stream session.
+    #
+    # @!attribute [rw] end_time
+    #   UTC ISO-8601 formatted timestamp of when the channel went offline.
+    #   For live streams, this is `NULL`.
+    #   @return [Time]
+    #
+    # @!attribute [rw] has_error_event
+    #   If `true`, this stream encountered a quota breach or failure.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] start_time
+    #   UTC ISO-8601 formatted timestamp of when the channel went live.
+    #   @return [Time]
+    #
+    # @!attribute [rw] stream_id
+    #   Unique identifier for a live or previously live stream in the
+    #   specified channel.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/StreamSessionSummary AWS API Documentation
+    #
+    class StreamSessionSummary < Struct.new(
+      :end_time,
+      :has_error_event,
+      :start_time,
+      :stream_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Summary information about a stream.
     #
     # @!attribute [rw] channel_arn
@@ -1376,6 +1664,11 @@ module Aws::IVS
     #   The stream’s state.
     #   @return [String]
     #
+    # @!attribute [rw] stream_id
+    #   Unique identifier for a live or previously live stream in the
+    #   specified channel.
+    #   @return [String]
+    #
     # @!attribute [rw] viewer_count
     #   A count of concurrent views of the stream. Typically, a new view
     #   appears in `viewerCount` within 15 seconds of when video playback
@@ -1391,6 +1684,7 @@ module Aws::IVS
       :health,
       :start_time,
       :state,
+      :stream_id,
       :viewer_count)
       SENSITIVE = []
       include Aws::Structure
@@ -1571,5 +1865,58 @@ module Aws::IVS
       include Aws::Structure
     end
 
+    # Object specifying a stream’s video configuration.
+    #
+    # @!attribute [rw] avc_level
+    #   Indicates the degree of required decoder performance for a profile.
+    #   Normally this is set automatically by the encoder. For details, see
+    #   the H.264 specification.
+    #   @return [String]
+    #
+    # @!attribute [rw] avc_profile
+    #   Indicates to the decoder the requirements for decoding the stream.
+    #   For definitions of the valid values, see the H.264 specification.
+    #   @return [String]
+    #
+    # @!attribute [rw] codec
+    #   Codec used for the video encoding.
+    #   @return [String]
+    #
+    # @!attribute [rw] encoder
+    #   Software or hardware used to encode the video.
+    #   @return [String]
+    #
+    # @!attribute [rw] target_bitrate
+    #   The expected ingest bitrate (bits per second). This is configured in
+    #   the encoder.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] target_framerate
+    #   The expected ingest framerate. This is configured in the encoder.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] video_height
+    #   Video-resolution height in pixels.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] video_width
+    #   Video-resolution width in pixels.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/VideoConfiguration AWS API Documentation
+    #
+    class VideoConfiguration < Struct.new(
+      :avc_level,
+      :avc_profile,
+      :codec,
+      :encoder,
+      :target_bitrate,
+      :target_framerate,
+      :video_height,
+      :video_width)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
   end
 end

data/lib/aws-sdk-ivs.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-ivs/customizations'
 # @!group service
 module Aws::IVS
 
-  GEM_VERSION = '1.14.0'
+  GEM_VERSION = '1.15.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ivs
 version: !ruby/object:Gem::Version
-  version: 1.14.0
+  version: 1.15.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-04 00:00:00.000000000 Z
+date: 2021-11-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core