aws-sdk-ivsrealtime 1.26.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7837229d1ef371694ee811281327204a4dc9497a27a1bfbdad56bf19db1e265d
-  data.tar.gz: d8fe560600bea180a1f015971225c8191f836d107cd3141ed422a4b05e2a2807
+  metadata.gz: 662e519299034296d19947169e061c2b72aa36f0920daa4b49c2a6d71d6a3066
+  data.tar.gz: '08446d6e3835fd3b619d85f659ac28ca599552c1b5068ee42298551dbbf34a2d'
 SHA512:
-  metadata.gz: 98c9e2d3afeef8ae6825bc1967d35c5a79b45090c9aa593dbd11bbc514ba717f008127f5b5d2916ed103f53a394e81c6685705d6f960c45a0b9d247646398162
-  data.tar.gz: d16b08bd84eafacc30edeb1cb6c867465eca30d8ae3147170ec980381fd147878597006ea34f3c7f2035e4d8a19c729256b56c246cf1abcf8d2d3af53642804d
+  metadata.gz: e97ef51242cf205dbd37d1395829a29816a723865b839ad3794c0d927432acb0afd186bdcf04a79ba04f021b9b03bb3430a82c606e61ba02a0f5e7df8a51ffe9
+  data.tar.gz: 03f6ba8e03f9723426440dd17cdc50844fd7b5f0405d9412560f9f518618f7b48ee3b39be137b89c98e25ab54146499ba9839b2585f1648ac5be46739c1a7954

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.27.0 (2024-09-09)
+------------------
+
+* Feature - IVS Real-Time now offers customers the ability to broadcast to Stages using RTMP(S).
+
 1.26.0 (2024-09-03)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.26.0
+1.27.0

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

@@ -448,14 +448,15 @@ module Aws::IVSRealTime
     #
     # @option params [Hash<String,String>] :tags
     #   Tags attached to the resource. Array of maps, each of the form
-    #   `string:string (key:value)`. See [Tagging AWS Resources][1] for
-    #   details, including restrictions that apply to tags and "Tag naming
-    #   limits and requirements"; Amazon IVS has no constraints on tags
-    #   beyond what is documented there.
+    #   `string:string (key:value)`. See [Best practices and strategies][1] in
+    #   *Tagging AWS Resources and Tag Editor* for details, including
+    #   restrictions that apply to tags and "Tag naming limits and
+    #   requirements"; Amazon IVS has no constraints on tags beyond what is
+    #   documented there.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
+    #   [1]: https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html
     #
     # @return [Types::CreateEncoderConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -496,6 +497,95 @@ module Aws::IVSRealTime
       req.send_request(options)
     end
 
+    # Creates a new IngestConfiguration resource, used to specify the ingest
+    # protocol for a stage.
+    #
+    # @option params [String] :name
+    #   Optional name that can be specified for the IngestConfiguration being
+    #   created.
+    #
+    # @option params [String] :stage_arn
+    #   ARN of the stage with which the IngestConfiguration is associated.
+    #
+    # @option params [String] :user_id
+    #   Customer-assigned name to help identify the participant using the
+    #   IngestConfiguration; this can be used to link a participant to a user
+    #   in the customer’s own systems. This can be any UTF-8 encoded text.
+    #   *This field is exposed to all stage participants and should not be
+    #   used for personally identifying, confidential, or sensitive
+    #   information.*
+    #
+    # @option params [Hash<String,String>] :attributes
+    #   Application-provided attributes to store in the IngestConfiguration
+    #   and attach to a stage. Map keys and values can contain UTF-8 encoded
+    #   text. The maximum length of this field is 1 KB total. *This field is
+    #   exposed to all stage participants and should not be used for
+    #   personally identifying, confidential, or sensitive information.*
+    #
+    # @option params [required, String] :ingest_protocol
+    #   Type of ingest protocol that the user employs to broadcast. If this is
+    #   set to `RTMP`, `insecureIngest` must be set to `true`.
+    #
+    # @option params [Boolean] :insecure_ingest
+    #   Whether the stage allows insecure RTMP ingest. This must be set to
+    #   `true`, if `ingestProtocol` is set to `RTMP`. Default: `false`.
+    #
+    # @option params [Hash<String,String>] :tags
+    #   Tags attached to the resource. Array of maps, each of the form
+    #   `string:string (key:value)`. See [Best practices and strategies][1] in
+    #   *Tagging AWS Resources and Tag Editor* for details, including
+    #   restrictions that apply to tags and "Tag naming limits and
+    #   requirements"; Amazon IVS has no constraints on tags beyond what is
+    #   documented there.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html
+    #
+    # @return [Types::CreateIngestConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateIngestConfigurationResponse#ingest_configuration #ingest_configuration} => Types::IngestConfiguration
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_ingest_configuration({
+    #     name: "IngestConfigurationName",
+    #     stage_arn: "IngestConfigurationStageArn",
+    #     user_id: "UserId",
+    #     attributes: {
+    #       "String" => "String",
+    #     },
+    #     ingest_protocol: "RTMP", # required, accepts RTMP, RTMPS
+    #     insecure_ingest: false,
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.ingest_configuration.name #=> String
+    #   resp.ingest_configuration.arn #=> String
+    #   resp.ingest_configuration.ingest_protocol #=> String, one of "RTMP", "RTMPS"
+    #   resp.ingest_configuration.stream_key #=> String
+    #   resp.ingest_configuration.stage_arn #=> String
+    #   resp.ingest_configuration.participant_id #=> String
+    #   resp.ingest_configuration.state #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.ingest_configuration.user_id #=> String
+    #   resp.ingest_configuration.attributes #=> Hash
+    #   resp.ingest_configuration.attributes["String"] #=> String
+    #   resp.ingest_configuration.tags #=> Hash
+    #   resp.ingest_configuration.tags["TagKey"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/CreateIngestConfiguration AWS API Documentation
+    #
+    # @overload create_ingest_configuration(params = {})
+    # @param [Hash] params ({})
+    def create_ingest_configuration(params = {}, options = {})
+      req = build_request(:create_ingest_configuration, params)
+      req.send_request(options)
+    end
+
     # Creates an additional token for a specified stage. This can be done
     # after stage creation or when tokens expire. Tokens always are scoped
     # to the stage for which they are created.
@@ -575,14 +665,15 @@ module Aws::IVSRealTime
     #
     # @option params [Hash<String,String>] :tags
     #   Tags attached to the resource. Array of maps, each of the form
-    #   `string:string (key:value)`. See [Tagging AWS Resources][1] for
-    #   details, including restrictions that apply to tags and "Tag naming
-    #   limits and requirements"; Amazon IVS has no constraints on tags
-    #   beyond what is documented there.
+    #   `string:string (key:value)`. See [Best practices and strategies][1] in
+    #   *Tagging AWS Resources and Tag Editor* for details, including
+    #   restrictions that apply to tags and "Tag naming limits and
+    #   requirements"; Amazon IVS has no constraints on tags beyond what is
+    #   documented there.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
+    #   [1]: https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html
     #
     # @option params [Types::AutoParticipantRecordingConfiguration] :auto_participant_recording_configuration
     #   Configuration object for individual participant recording, to attach
@@ -628,6 +719,8 @@ module Aws::IVSRealTime
     #   resp.stage.auto_participant_recording_configuration.media_types[0] #=> String, one of "AUDIO_VIDEO", "AUDIO_ONLY"
     #   resp.stage.endpoints.events #=> String
     #   resp.stage.endpoints.whip #=> String
+    #   resp.stage.endpoints.rtmp #=> String
+    #   resp.stage.endpoints.rtmps #=> String
     #   resp.participant_tokens #=> Array
     #   resp.participant_tokens[0].participant_id #=> String
     #   resp.participant_tokens[0].token #=> String
@@ -662,14 +755,15 @@ module Aws::IVSRealTime
     #
     # @option params [Hash<String,String>] :tags
     #   Tags attached to the resource. Array of maps, each of the form
-    #   `string:string (key:value)`. See [Tagging AWS Resources][1] for
-    #   details, including restrictions that apply to tags and "Tag naming
-    #   limits and requirements"; Amazon IVS has no constraints on tags
-    #   beyond what is documented there.
+    #   `string:string (key:value)`. See [Best practices and strategies][1] in
+    #   *Tagging AWS Resources and Tag Editor* for details, including
+    #   restrictions that apply to tags and "Tag naming limits and
+    #   requirements"; Amazon IVS has no constraints on tags beyond what is
+    #   documented there.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
+    #   [1]: https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html
     #
     # @return [Types::CreateStorageConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -727,6 +821,38 @@ module Aws::IVSRealTime
       req.send_request(options)
     end
 
+    # Deletes a specified IngestConfiguration, so it can no longer be used
+    # to broadcast. An IngestConfiguration cannot be deleted if the
+    # publisher is actively streaming to a stage, unless `force` is set to
+    # `true`.
+    #
+    # @option params [required, String] :arn
+    #   ARN of the IngestConfiguration.
+    #
+    # @option params [Boolean] :force
+    #   Optional field to force deletion of the IngestConfiguration. If this
+    #   is set to `true` when a participant is actively publishing, the
+    #   participant is disconnected from the stage, followed by deletion of
+    #   the IngestConfiguration. Default: `false`.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_ingest_configuration({
+    #     arn: "IngestConfigurationArn", # required
+    #     force: false,
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/DeleteIngestConfiguration AWS API Documentation
+    #
+    # @overload delete_ingest_configuration(params = {})
+    # @param [Hash] params ({})
+    def delete_ingest_configuration(params = {}, options = {})
+      req = build_request(:delete_ingest_configuration, params)
+      req.send_request(options)
+    end
+
     # Deletes the specified public key used to sign stage participant
     # tokens. This invalidates future participant tokens generated using the
     # key pair’s private key.
@@ -752,7 +878,9 @@ module Aws::IVSRealTime
     end
 
     # Shuts down and deletes the specified stage (disconnecting all
-    # participants).
+    # participants). This operation also removes the `stageArn` from the
+    # associated IngestConfiguration, if there are participants using the
+    # IngestConfiguration to publish to the stage.
     #
     # @option params [required, String] :arn
     #   ARN of the stage to be deleted.
@@ -802,15 +930,18 @@ module Aws::IVSRealTime
       req.send_request(options)
     end
 
-    # Disconnects a specified participant and revokes the participant
-    # permanently from a specified stage.
+    # Disconnects a specified participant from a specified stage. If the
+    # participant is publishing using an IngestConfiguration,
+    # DisconnectParticipant also updates the `stageArn` in the
+    # IngestConfiguration to be an empty string.
     #
     # @option params [required, String] :stage_arn
     #   ARN of the stage to which the participant is attached.
     #
     # @option params [required, String] :participant_id
-    #   Identifier of the participant to be disconnected. This is assigned by
-    #   IVS and returned by CreateParticipantToken.
+    #   Identifier of the participant to be disconnected. IVS assigns this; it
+    #   is returned by CreateParticipantToken (for streams using WebRTC
+    #   ingest) or CreateIngestConfiguration (for streams using RTMP ingest).
     #
     # @option params [String] :reason
     #   Description of why this participant is being disconnected.
@@ -931,6 +1062,45 @@ module Aws::IVSRealTime
       req.send_request(options)
     end
 
+    # Gets information about the specified IngestConfiguration.
+    #
+    # @option params [required, String] :arn
+    #   ARN of the ingest for which the information is to be retrieved.
+    #
+    # @return [Types::GetIngestConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetIngestConfigurationResponse#ingest_configuration #ingest_configuration} => Types::IngestConfiguration
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_ingest_configuration({
+    #     arn: "IngestConfigurationArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.ingest_configuration.name #=> String
+    #   resp.ingest_configuration.arn #=> String
+    #   resp.ingest_configuration.ingest_protocol #=> String, one of "RTMP", "RTMPS"
+    #   resp.ingest_configuration.stream_key #=> String
+    #   resp.ingest_configuration.stage_arn #=> String
+    #   resp.ingest_configuration.participant_id #=> String
+    #   resp.ingest_configuration.state #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.ingest_configuration.user_id #=> String
+    #   resp.ingest_configuration.attributes #=> Hash
+    #   resp.ingest_configuration.attributes["String"] #=> String
+    #   resp.ingest_configuration.tags #=> Hash
+    #   resp.ingest_configuration.tags["TagKey"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/GetIngestConfiguration AWS API Documentation
+    #
+    # @overload get_ingest_configuration(params = {})
+    # @param [Hash] params ({})
+    def get_ingest_configuration(params = {}, options = {})
+      req = build_request(:get_ingest_configuration, params)
+      req.send_request(options)
+    end
+
     # Gets information about the specified participant token.
     #
     # @option params [required, String] :stage_arn
@@ -973,6 +1143,7 @@ module Aws::IVSRealTime
     #   resp.participant.recording_s3_bucket_name #=> String
     #   resp.participant.recording_s3_prefix #=> String
     #   resp.participant.recording_state #=> String, one of "STARTING", "ACTIVE", "STOPPING", "STOPPED", "FAILED", "DISABLED"
+    #   resp.participant.protocol #=> String, one of "UNKNOWN", "WHIP", "RTMP", "RTMPS"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/GetParticipant AWS API Documentation
     #
@@ -1043,6 +1214,8 @@ module Aws::IVSRealTime
     #   resp.stage.auto_participant_recording_configuration.media_types[0] #=> String, one of "AUDIO_VIDEO", "AUDIO_ONLY"
     #   resp.stage.endpoints.events #=> String
     #   resp.stage.endpoints.whip #=> String
+    #   resp.stage.endpoints.rtmp #=> String
+    #   resp.stage.endpoints.rtmps #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/GetStage AWS API Documentation
     #
@@ -1129,14 +1302,15 @@ module Aws::IVSRealTime
     #
     # @option params [Hash<String,String>] :tags
     #   Tags attached to the resource. Array of maps, each of the form
-    #   `string:string (key:value)`. See [Tagging AWS Resources][1] for
-    #   details, including restrictions that apply to tags and "Tag naming
-    #   limits and requirements"; Amazon IVS has no constraints on tags
-    #   beyond what is documented there.
+    #   `string:string (key:value)`. See [Best practices and strategies][1] in
+    #   *Tagging AWS Resources and Tag Editor* for details, including
+    #   restrictions that apply to tags and "Tag naming limits and
+    #   requirements"; Amazon IVS has no constraints on tags beyond what is
+    #   documented there.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
+    #   [1]: https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html
     #
     # @return [Types::ImportPublicKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1271,6 +1445,61 @@ module Aws::IVSRealTime
       req.send_request(options)
     end
 
+    # Lists all IngestConfigurations in your account, in the AWS region
+    # where the API request is processed.
+    #
+    # @option params [String] :filter_by_stage_arn
+    #   Filters the response list to match the specified stage ARN. Only one
+    #   filter (by stage ARN or by state) can be used at a time.
+    #
+    # @option params [String] :filter_by_state
+    #   Filters the response list to match the specified state. Only one
+    #   filter (by stage ARN or by state) can be used at a time.
+    #
+    # @option params [String] :next_token
+    #   The first IngestConfiguration to retrieve. This is used for
+    #   pagination; see the `nextToken` response field.
+    #
+    # @option params [Integer] :max_results
+    #   Maximum number of results to return. Default: 50.
+    #
+    # @return [Types::ListIngestConfigurationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListIngestConfigurationsResponse#ingest_configurations #ingest_configurations} => Array&lt;Types::IngestConfigurationSummary&gt;
+    #   * {Types::ListIngestConfigurationsResponse#next_token #next_token} => String
+    #
+    # 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_ingest_configurations({
+    #     filter_by_stage_arn: "StageArn",
+    #     filter_by_state: "ACTIVE", # accepts ACTIVE, INACTIVE
+    #     next_token: "PaginationToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.ingest_configurations #=> Array
+    #   resp.ingest_configurations[0].name #=> String
+    #   resp.ingest_configurations[0].arn #=> String
+    #   resp.ingest_configurations[0].ingest_protocol #=> String, one of "RTMP", "RTMPS"
+    #   resp.ingest_configurations[0].stage_arn #=> String
+    #   resp.ingest_configurations[0].participant_id #=> String
+    #   resp.ingest_configurations[0].state #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.ingest_configurations[0].user_id #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ListIngestConfigurations AWS API Documentation
+    #
+    # @overload list_ingest_configurations(params = {})
+    # @param [Hash] params ({})
+    def list_ingest_configurations(params = {}, options = {})
+      req = build_request(:list_ingest_configurations, params)
+      req.send_request(options)
+    end
+
     # Lists events for a specified participant that occurred during a
     # specified stage session.
     #
@@ -1315,7 +1544,7 @@ module Aws::IVSRealTime
     #   resp.events[0].participant_id #=> String
     #   resp.events[0].event_time #=> Time
     #   resp.events[0].remote_participant_id #=> String
-    #   resp.events[0].error_code #=> String, one of "INSUFFICIENT_CAPABILITIES", "QUOTA_EXCEEDED", "PUBLISHER_NOT_FOUND"
+    #   resp.events[0].error_code #=> String, one of "INSUFFICIENT_CAPABILITIES", "QUOTA_EXCEEDED", "PUBLISHER_NOT_FOUND", "BITRATE_EXCEEDED", "RESOLUTION_EXCEEDED", "STREAM_DURATION_EXCEEDED", "INVALID_AUDIO_CODEC", "INVALID_VIDEO_CODEC", "INVALID_PROTOCOL", "INVALID_STREAM_KEY", "REUSE_OF_STREAM_KEY"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ListParticipantEvents AWS API Documentation
@@ -1612,8 +1841,9 @@ module Aws::IVSRealTime
     # Starts a Composition from a stage based on the configuration provided
     # in the request.
     #
-    # A Composition is an ephemeral resource that exists after this endpoint
-    # returns successfully. Composition stops and the resource is deleted:
+    # A Composition is an ephemeral resource that exists after this
+    # operation returns successfully. Composition stops and the resource is
+    # deleted:
     #
     # * When StopComposition is called.
     #
@@ -1646,14 +1876,15 @@ module Aws::IVSRealTime
     #
     # @option params [Hash<String,String>] :tags
     #   Tags attached to the resource. Array of maps, each of the form
-    #   `string:string (key:value)`. See [Tagging AWS Resources][1] for
-    #   details, including restrictions that apply to tags and "Tag naming
-    #   limits and requirements"; Amazon IVS has no constraints on tags
-    #   beyond what is documented there.
+    #   `string:string (key:value)`. See [Best practices and strategies][1] in
+    #   *Tagging AWS Resources and Tag Editor* for details, including
+    #   restrictions that apply to tags and "Tag naming limits and
+    #   requirements"; Amazon IVS has no constraints on tags beyond what is
+    #   documented there.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
+    #   [1]: https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html
     #
     # @return [Types::StartCompositionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1783,14 +2014,15 @@ module Aws::IVSRealTime
     #
     # @option params [required, Hash<String,String>] :tags
     #   Array of tags to be added or updated. Array of maps, each of the form
-    #   `string:string (key:value)`. See [Tagging AWS Resources][1] for
-    #   details, including restrictions that apply to tags and "Tag naming
-    #   limits and requirements"; Amazon IVS has no constraints beyond what
-    #   is documented there.
+    #   `string:string (key:value)`. See [Best practices and strategies][1] in
+    #   *Tagging AWS Resources and Tag Editor* for details, including
+    #   restrictions that apply to tags and "Tag naming limits and
+    #   requirements"; Amazon IVS has no constraints on tags beyond what is
+    #   documented there.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
+    #   [1]: https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1819,14 +2051,15 @@ module Aws::IVSRealTime
     #
     # @option params [required, Array<String>] :tag_keys
     #   Array of tags to be removed. Array of maps, each of the form
-    #   `string:string (key:value)`. See [Tagging AWS Resources][1] for
-    #   details, including restrictions that apply to tags and "Tag naming
-    #   limits and requirements"; Amazon IVS has no constraints beyond what
-    #   is documented there.
+    #   `string:string (key:value)`. See [Best practices and strategies][1] in
+    #   *Tagging AWS Resources and Tag Editor* for details, including
+    #   restrictions that apply to tags and "Tag naming limits and
+    #   requirements"; Amazon IVS has no constraints on tags beyond what is
+    #   documented there.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
+    #   [1]: https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1846,6 +2079,52 @@ module Aws::IVSRealTime
       req.send_request(options)
     end
 
+    # Updates a specified IngestConfiguration. Only the stage ARN attached
+    # to the IngestConfiguration can be updated. An IngestConfiguration that
+    # is active cannot be updated.
+    #
+    # @option params [required, String] :arn
+    #   ARN of the IngestConfiguration, for which the related stage ARN needs
+    #   to be updated.
+    #
+    # @option params [String] :stage_arn
+    #   Stage ARN that needs to be updated.
+    #
+    # @return [Types::UpdateIngestConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateIngestConfigurationResponse#ingest_configuration #ingest_configuration} => Types::IngestConfiguration
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_ingest_configuration({
+    #     arn: "IngestConfigurationArn", # required
+    #     stage_arn: "IngestConfigurationStageArn",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.ingest_configuration.name #=> String
+    #   resp.ingest_configuration.arn #=> String
+    #   resp.ingest_configuration.ingest_protocol #=> String, one of "RTMP", "RTMPS"
+    #   resp.ingest_configuration.stream_key #=> String
+    #   resp.ingest_configuration.stage_arn #=> String
+    #   resp.ingest_configuration.participant_id #=> String
+    #   resp.ingest_configuration.state #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.ingest_configuration.user_id #=> String
+    #   resp.ingest_configuration.attributes #=> Hash
+    #   resp.ingest_configuration.attributes["String"] #=> String
+    #   resp.ingest_configuration.tags #=> Hash
+    #   resp.ingest_configuration.tags["TagKey"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/UpdateIngestConfiguration AWS API Documentation
+    #
+    # @overload update_ingest_configuration(params = {})
+    # @param [Hash] params ({})
+    def update_ingest_configuration(params = {}, options = {})
+      req = build_request(:update_ingest_configuration, params)
+      req.send_request(options)
+    end
+
     # Updates a stage’s configuration.
     #
     # @option params [required, String] :arn
@@ -1886,6 +2165,8 @@ module Aws::IVSRealTime
     #   resp.stage.auto_participant_recording_configuration.media_types[0] #=> String, one of "AUDIO_VIDEO", "AUDIO_ONLY"
     #   resp.stage.endpoints.events #=> String
     #   resp.stage.endpoints.whip #=> String
+    #   resp.stage.endpoints.rtmp #=> String
+    #   resp.stage.endpoints.rtmps #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/UpdateStage AWS API Documentation
     #
@@ -1914,7 +2195,7 @@ module Aws::IVSRealTime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-ivsrealtime'
-      context[:gem_version] = '1.26.0'
+      context[:gem_version] = '1.27.0'
       Seahorse::Client::Request.new(handlers, context)
     end