aws-sdk-kinesisvideo 1.43.0 → 1.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edae8ea702f288ac6a37e4b57c0af6bddefc3ba6469fa7757763406e50f73a30
-  data.tar.gz: 3cd0714a129d3b0e696a4ec5bb3a19eabdde13b5eeb55424c4a3d6ed4e94f8ef
+  metadata.gz: bb1a047e8cdd6883439bed052d6e30e7e4ee9969511b7da4520d559b098fb645
+  data.tar.gz: d704725ae45c332407a5ee42fc5e3d3764e8c0aeacfa9f941cd5ea8958a2fc54
 SHA512:
-  metadata.gz: cb7ad3cef59e7838fea3ab5aa7fb9e6e74f97319e5d19f3d7844ab128d8ebb7362ce8c86e8f39c5e21e3356500156e522d73c19fd7b9e4a1566f74971ea14f1d
-  data.tar.gz: 127ce2221fe82c1fe07ef29dd74e9ab3e2fe2bdbaee1b075c1b4fc1633e95e905b976697b8be615cbf2cf483a3da84f3d0a0e14860df9f3e53196815f28c37f3
+  metadata.gz: 8fc0f077c248c79507f8072e5e209a113ed7d8ad7abd828c9e0bdb5a1a5d3699db917e9b4e2e6a2961fff1367c6683fc2fce4dfe3e667c451596b792ff7a762b
+  data.tar.gz: 710bdf14328642ed192f6bb0ceebfb52f8e03bbfe88f0a020ae6106abe00cd211aad2974cb3df687efcf763d81cb36e8cb471c56397b5aeaccfcc77284f2ceff

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.45.0 (2022-12-19)
+------------------
+
+* Feature - Amazon Kinesis Video Streams offers capabilities to stream video and audio in real-time via WebRTC to the cloud for storage, playback, and analytical processing. Customers can use our enhanced WebRTC SDK and cloud APIs to enable real-time streaming, as well as media ingestion to the cloud.
+
+1.44.0 (2022-12-12)
+------------------
+
+* Feature - This release adds support for public preview of Kinesis Video Stream at Edge enabling customers to provide configuration for the Kinesis Video Stream EdgeAgent running on an on-premise IoT device. Customers can now locally record from cameras and stream videos to the cloud on configured schedule.
+
 1.43.0 (2022-10-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.43.0
+1.45.0

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

@@ -608,6 +608,64 @@ module Aws::KinesisVideo
       req.send_request(options)
     end
 
+    # Describes a stream’s edge configuration that was set using the
+    # `StartEdgeConfigurationUpdate` API. Use this API to get the status of
+    # the configuration if the configuration is in sync with the Edge Agent.
+    #
+    # @option params [String] :stream_name
+    #   The name of the stream whose edge configuration you want to update.
+    #   Specify either the `StreamName` or the `StreamARN`.
+    #
+    # @option params [String] :stream_arn
+    #   The Amazon Resource Name (ARN) of the stream. Specify either the
+    #   `StreamName`or the `StreamARN`.
+    #
+    # @return [Types::DescribeEdgeConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeEdgeConfigurationOutput#stream_name #stream_name} => String
+    #   * {Types::DescribeEdgeConfigurationOutput#stream_arn #stream_arn} => String
+    #   * {Types::DescribeEdgeConfigurationOutput#creation_time #creation_time} => Time
+    #   * {Types::DescribeEdgeConfigurationOutput#last_updated_time #last_updated_time} => Time
+    #   * {Types::DescribeEdgeConfigurationOutput#sync_status #sync_status} => String
+    #   * {Types::DescribeEdgeConfigurationOutput#failed_status_details #failed_status_details} => String
+    #   * {Types::DescribeEdgeConfigurationOutput#edge_config #edge_config} => Types::EdgeConfig
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_edge_configuration({
+    #     stream_name: "StreamName",
+    #     stream_arn: "ResourceARN",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.stream_name #=> String
+    #   resp.stream_arn #=> String
+    #   resp.creation_time #=> Time
+    #   resp.last_updated_time #=> Time
+    #   resp.sync_status #=> String, one of "SYNCING", "ACKNOWLEDGED", "IN_SYNC", "SYNC_FAILED", "DELETING", "DELETE_FAILED"
+    #   resp.failed_status_details #=> String
+    #   resp.edge_config.hub_device_arn #=> String
+    #   resp.edge_config.recorder_config.media_source_config.media_uri_secret_arn #=> String
+    #   resp.edge_config.recorder_config.media_source_config.media_uri_type #=> String, one of "RTSP_URI", "FILE_URI"
+    #   resp.edge_config.recorder_config.schedule_config.schedule_expression #=> String
+    #   resp.edge_config.recorder_config.schedule_config.duration_in_seconds #=> Integer
+    #   resp.edge_config.uploader_config.schedule_config.schedule_expression #=> String
+    #   resp.edge_config.uploader_config.schedule_config.duration_in_seconds #=> Integer
+    #   resp.edge_config.deletion_config.edge_retention_in_hours #=> Integer
+    #   resp.edge_config.deletion_config.local_size_config.max_local_media_size_in_mb #=> Integer
+    #   resp.edge_config.deletion_config.local_size_config.strategy_on_full_size #=> String, one of "DELETE_OLDEST_MEDIA", "DENY_NEW_MEDIA"
+    #   resp.edge_config.deletion_config.delete_after_upload #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/DescribeEdgeConfiguration AWS API Documentation
+    #
+    # @overload describe_edge_configuration(params = {})
+    # @param [Hash] params ({})
+    def describe_edge_configuration(params = {}, options = {})
+      req = build_request(:describe_edge_configuration, params)
+      req.send_request(options)
+    end
+
     # Gets the `ImageGenerationConfiguration` for a given Kinesis video
     # stream.
     #
@@ -654,6 +712,91 @@ module Aws::KinesisVideo
       req.send_request(options)
     end
 
+    # Returns the most current information about the stream. Either
+    # streamName or streamARN should be provided in the input.
+    #
+    # Returns the most current information about the stream. The
+    # `streamName` or `streamARN` should be provided in the input.
+    #
+    # @option params [String] :stream_name
+    #   The name of the stream.
+    #
+    # @option params [String] :stream_arn
+    #   The Amazon Resource Name (ARN) of the stream.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return in the response.
+    #
+    # @option params [String] :next_token
+    #   The token to provide in your next request, to get another batch of
+    #   results.
+    #
+    # @return [Types::DescribeMappedResourceConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeMappedResourceConfigurationOutput#mapped_resource_configuration_list #mapped_resource_configuration_list} => Array<Types::MappedResourceConfigurationListItem>
+    #   * {Types::DescribeMappedResourceConfigurationOutput#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.describe_mapped_resource_configuration({
+    #     stream_name: "StreamName",
+    #     stream_arn: "ResourceARN",
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.mapped_resource_configuration_list #=> Array
+    #   resp.mapped_resource_configuration_list[0].type #=> String
+    #   resp.mapped_resource_configuration_list[0].arn #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/DescribeMappedResourceConfiguration AWS API Documentation
+    #
+    # @overload describe_mapped_resource_configuration(params = {})
+    # @param [Hash] params ({})
+    def describe_mapped_resource_configuration(params = {}, options = {})
+      req = build_request(:describe_mapped_resource_configuration, params)
+      req.send_request(options)
+    end
+
+    # Returns the most current information about the channel. Specify the
+    # `ChannelName` or `ChannelARN` in the input.
+    #
+    # @option params [String] :channel_name
+    #   The name of the channel.
+    #
+    # @option params [String] :channel_arn
+    #   The Amazon Resource Name (ARN) of the channel.
+    #
+    # @return [Types::DescribeMediaStorageConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeMediaStorageConfigurationOutput#media_storage_configuration #media_storage_configuration} => Types::MediaStorageConfiguration
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_media_storage_configuration({
+    #     channel_name: "ChannelName",
+    #     channel_arn: "ResourceARN",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.media_storage_configuration.stream_arn #=> String
+    #   resp.media_storage_configuration.status #=> String, one of "ENABLED", "DISABLED"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/DescribeMediaStorageConfiguration AWS API Documentation
+    #
+    # @overload describe_media_storage_configuration(params = {})
+    # @param [Hash] params ({})
+    def describe_media_storage_configuration(params = {}, options = {})
+      req = build_request(:describe_media_storage_configuration, params)
+      req.send_request(options)
+    end
+
     # Gets the `NotificationConfiguration` for a given Kinesis video stream.
     #
     # @option params [String] :stream_name
@@ -855,7 +998,7 @@ module Aws::KinesisVideo
     #   resp = client.get_signaling_channel_endpoint({
     #     channel_arn: "ResourceARN", # required
     #     single_master_channel_endpoint_configuration: {
-    #       protocols: ["WSS"], # accepts WSS, HTTPS
+    #       protocols: ["WSS"], # accepts WSS, HTTPS, WEBRTC
     #       role: "MASTER", # accepts MASTER, VIEWER
     #     },
     #   })
@@ -863,7 +1006,7 @@ module Aws::KinesisVideo
     # @example Response structure
     #
     #   resp.resource_endpoint_list #=> Array
-    #   resp.resource_endpoint_list[0].protocol #=> String, one of "WSS", "HTTPS"
+    #   resp.resource_endpoint_list[0].protocol #=> String, one of "WSS", "HTTPS", "WEBRTC"
     #   resp.resource_endpoint_list[0].resource_endpoint #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint AWS API Documentation
@@ -1075,6 +1218,108 @@ module Aws::KinesisVideo
       req.send_request(options)
     end
 
+    # An asynchronous API that updates a stream’s existing edge
+    # configuration. The Kinesis Video Stream will sync the stream’s edge
+    # configuration with the Edge Agent IoT Greengrass component that runs
+    # on an IoT Hub Device, setup at your premise. The time to sync can vary
+    # and depends on the connectivity of the Hub Device. The `SyncStatus`
+    # will be updated as the edge configuration is acknowledged, and synced
+    # with the Edge Agent.
+    #
+    # If this API is invoked for the first time, a new edge configuration
+    # will be created for the stream, and the sync status will be set to
+    # `SYNCING`. You will have to wait for the sync status to reach a
+    # terminal state such as: `IN_SYNC`, or `SYNC_FAILED`, before using this
+    # API again. If you invoke this API during the syncing process, a
+    # `ResourceInUseException` will be thrown. The connectivity of the
+    # stream’s edge configuration and the Edge Agent will be retried for 15
+    # minutes. After 15 minutes, the status will transition into the
+    # `SYNC_FAILED` state.
+    #
+    # @option params [String] :stream_name
+    #   The name of the stream whose edge configuration you want to update.
+    #   Specify either the `StreamName` or the `StreamARN`.
+    #
+    # @option params [String] :stream_arn
+    #   The Amazon Resource Name (ARN) of the stream. Specify either the
+    #   `StreamName` or the `StreamARN`.
+    #
+    # @option params [required, Types::EdgeConfig] :edge_config
+    #   The edge configuration details required to invoke the update process.
+    #
+    # @return [Types::StartEdgeConfigurationUpdateOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartEdgeConfigurationUpdateOutput#stream_name #stream_name} => String
+    #   * {Types::StartEdgeConfigurationUpdateOutput#stream_arn #stream_arn} => String
+    #   * {Types::StartEdgeConfigurationUpdateOutput#creation_time #creation_time} => Time
+    #   * {Types::StartEdgeConfigurationUpdateOutput#last_updated_time #last_updated_time} => Time
+    #   * {Types::StartEdgeConfigurationUpdateOutput#sync_status #sync_status} => String
+    #   * {Types::StartEdgeConfigurationUpdateOutput#failed_status_details #failed_status_details} => String
+    #   * {Types::StartEdgeConfigurationUpdateOutput#edge_config #edge_config} => Types::EdgeConfig
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_edge_configuration_update({
+    #     stream_name: "StreamName",
+    #     stream_arn: "ResourceARN",
+    #     edge_config: { # required
+    #       hub_device_arn: "HubDeviceArn", # required
+    #       recorder_config: { # required
+    #         media_source_config: { # required
+    #           media_uri_secret_arn: "MediaUriSecretArn", # required
+    #           media_uri_type: "RTSP_URI", # required, accepts RTSP_URI, FILE_URI
+    #         },
+    #         schedule_config: {
+    #           schedule_expression: "ScheduleExpression", # required
+    #           duration_in_seconds: 1, # required
+    #         },
+    #       },
+    #       uploader_config: {
+    #         schedule_config: { # required
+    #           schedule_expression: "ScheduleExpression", # required
+    #           duration_in_seconds: 1, # required
+    #         },
+    #       },
+    #       deletion_config: {
+    #         edge_retention_in_hours: 1,
+    #         local_size_config: {
+    #           max_local_media_size_in_mb: 1,
+    #           strategy_on_full_size: "DELETE_OLDEST_MEDIA", # accepts DELETE_OLDEST_MEDIA, DENY_NEW_MEDIA
+    #         },
+    #         delete_after_upload: false,
+    #       },
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.stream_name #=> String
+    #   resp.stream_arn #=> String
+    #   resp.creation_time #=> Time
+    #   resp.last_updated_time #=> Time
+    #   resp.sync_status #=> String, one of "SYNCING", "ACKNOWLEDGED", "IN_SYNC", "SYNC_FAILED", "DELETING", "DELETE_FAILED"
+    #   resp.failed_status_details #=> String
+    #   resp.edge_config.hub_device_arn #=> String
+    #   resp.edge_config.recorder_config.media_source_config.media_uri_secret_arn #=> String
+    #   resp.edge_config.recorder_config.media_source_config.media_uri_type #=> String, one of "RTSP_URI", "FILE_URI"
+    #   resp.edge_config.recorder_config.schedule_config.schedule_expression #=> String
+    #   resp.edge_config.recorder_config.schedule_config.duration_in_seconds #=> Integer
+    #   resp.edge_config.uploader_config.schedule_config.schedule_expression #=> String
+    #   resp.edge_config.uploader_config.schedule_config.duration_in_seconds #=> Integer
+    #   resp.edge_config.deletion_config.edge_retention_in_hours #=> Integer
+    #   resp.edge_config.deletion_config.local_size_config.max_local_media_size_in_mb #=> Integer
+    #   resp.edge_config.deletion_config.local_size_config.strategy_on_full_size #=> String, one of "DELETE_OLDEST_MEDIA", "DENY_NEW_MEDIA"
+    #   resp.edge_config.deletion_config.delete_after_upload #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/StartEdgeConfigurationUpdate AWS API Documentation
+    #
+    # @overload start_edge_configuration_update(params = {})
+    # @param [Hash] params ({})
+    def start_edge_configuration_update(params = {}, options = {})
+      req = build_request(:start_edge_configuration_update, params)
+      req.send_request(options)
+    end
+
     # Adds one or more tags to a signaling channel. 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
@@ -1350,6 +1595,43 @@ module Aws::KinesisVideo
       req.send_request(options)
     end
 
+    # Associates a `SignalingChannel` to a stream to store the media. There
+    # are two signaling modes that can specified :
+    #
+    # * If the `StorageStatus` is disabled, no data will be stored, and the
+    #   `StreamARN` parameter will not be needed.
+    #
+    # * If the `StorageStatus` is enabled, the data will be stored in the
+    #   `StreamARN` provided.
+    #
+    # @option params [required, String] :channel_arn
+    #   The Amazon Resource Name (ARN) of the channel.
+    #
+    # @option params [required, Types::MediaStorageConfiguration] :media_storage_configuration
+    #   A structure that encapsulates, or contains, the media storage
+    #   configuration properties.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_media_storage_configuration({
+    #     channel_arn: "ResourceARN", # required
+    #     media_storage_configuration: { # required
+    #       stream_arn: "ResourceARN",
+    #       status: "ENABLED", # required, accepts ENABLED, DISABLED
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration AWS API Documentation
+    #
+    # @overload update_media_storage_configuration(params = {})
+    # @param [Hash] params ({})
+    def update_media_storage_configuration(params = {}, options = {})
+      req = build_request(:update_media_storage_configuration, params)
+      req.send_request(options)
+    end
+
     # Updates the notification information for a stream.
     #
     # @option params [String] :stream_name
@@ -1514,7 +1796,7 @@ module Aws::KinesisVideo
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kinesisvideo'
-      context[:gem_version] = '1.43.0'
+      context[:gem_version] = '1.45.0'
       Seahorse::Client::Request.new(handlers, context)
     end