aws-sdk-rekognition 1.35.0 → 1.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 514bc86c1903620e2d258dffacb5941df5161419
-  data.tar.gz: c31c7c73c983110607191ded3b24d42aa0f836ab
+SHA256:
+  metadata.gz: 067f989aae540c670ca14e89b775e73fd60fb95440188dd5762dbd3302008dd4
+  data.tar.gz: 66aad6d16f260d976bfa277f75d8a1985dd315a468c90adeea324913c59590ba
 SHA512:
-  metadata.gz: 61594bbf3f3f369ae31d5b02edd99135ebe2ba510646c5bbfd72e49a9e5022ddce2cac777e285368e02aef64829cba3407bf49ed88493ca863ec13767f479f78
-  data.tar.gz: 0a5762441557512743ab9eb93b3953743db65aedafd908d5936ccf6376f568d59849ceda6cb567ac5b91a10feaeb6e52cb1b4957ac0fbad7ac21bf71d8162317
+  metadata.gz: 8f0e33c78279aba850dd790df5efdf3f0998e760d1d9a0cbaff53a49e6ee3c49e5077f236b6b99138e3e334484ee70dea9e469653e6b2c4345fdd838169d7ed7
+  data.tar.gz: 842bb403a8517f6a2cda864bfca3e297c76818c7af66c1cb87b536e78d4a3dc699653a395e23e546cf77573ce08319176b90f48c1081f26cfbc17a4e3bdaea13

data/lib/aws-sdk-rekognition.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -46,6 +48,6 @@ require_relative 'aws-sdk-rekognition/customizations'
 # @service
 module Aws::Rekognition
 
-  GEM_VERSION = '1.35.0'
+  GEM_VERSION = '1.40.0'
 
 end

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
+require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
@@ -32,11 +35,11 @@ Aws::Plugins::GlobalConfiguration.add_identifier(:rekognition)
 module Aws::Rekognition
   # An API client for Rekognition.  To construct a client, you need to configure a `:region` and `:credentials`.
   #
-  #   client = Aws::Rekognition::Client.new(
-  #     region: region_name,
-  #     credentials: credentials,
-  #     # ...
-  #   )
+  #     client = Aws::Rekognition::Client.new(
+  #       region: region_name,
+  #       credentials: credentials,
+  #       # ...
+  #     )
   #
   # For details on configuring region and credentials see
   # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
@@ -69,6 +72,7 @@ module Aws::Rekognition
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
+    add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -105,7 +109,7 @@ module Aws::Rekognition
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
     #     used to determine the service `:endpoint`. When not passed,
-    #     a default `:region` is search for in the following locations:
+    #     a default `:region` is searched for in the following locations:
     #
     #     * `Aws.config[:region]`
     #     * `ENV['AWS_REGION']`
@@ -161,7 +165,7 @@ module Aws::Rekognition
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be avalid HTTP(S) URI.
+    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -176,7 +180,7 @@ module Aws::Rekognition
     #     requests fetching endpoints information. Defaults to 60 sec.
     #
     #   @option options [Boolean] :endpoint_discovery (false)
-    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
@@ -229,15 +233,19 @@ module Aws::Rekognition
     #
     #   @option options [String] :retry_mode ("legacy")
     #     Specifies which retry algorithm to use. Values are:
-    #       * `legacy` - The pre-existing retry behavior.  This is default value if
-    #         no retry mode is provided.
-    #       * `standard` - A standardized set of retry rules across the AWS SDKs.
-    #         This includes support for retry quotas, which limit the number of
-    #         unsuccessful retries a client can make.
-    #       * `adaptive` - An experimental retry mode that includes all the
-    #         functionality of `standard` mode along with automatic client side
-    #         throttling.  This is a provisional mode that may change behavior
-    #         in the future.
+    #
+    #     * `legacy` - The pre-existing retry behavior.  This is default value if
+    #       no retry mode is provided.
+    #
+    #     * `standard` - A standardized set of retry rules across the AWS SDKs.
+    #       This includes support for retry quotas, which limit the number of
+    #       unsuccessful retries a client can make.
+    #
+    #     * `adaptive` - An experimental retry mode that includes all the
+    #       functionality of `standard` mode along with automatic client side
+    #       throttling.  This is a provisional mode that may change behavior
+    #       in the future.
+    #
     #
     #   @option options [String] :secret_access_key
     #
@@ -275,8 +283,7 @@ module Aws::Rekognition
     #
     #   @option options [Integer] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
-    #     safely be set
-    #     per-request on the session yielded by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
     #     seconds a connection is allowed to sit idle before it is
@@ -288,7 +295,7 @@ module Aws::Rekognition
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yielded by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -905,6 +912,72 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # Deletes an Amazon Rekognition Custom Labels project. To delete a
+    # project you must first delete all models associated with the project.
+    # To delete a model, see DeleteProjectVersion.
+    #
+    # This operation requires permissions to perform the
+    # `rekognition:DeleteProject` action.
+    #
+    # @option params [required, String] :project_arn
+    #   The Amazon Resource Name (ARN) of the project that you want to delete.
+    #
+    # @return [Types::DeleteProjectResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteProjectResponse#status #status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_project({
+    #     project_arn: "ProjectArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.status #=> String, one of "CREATING", "CREATED", "DELETING"
+    #
+    # @overload delete_project(params = {})
+    # @param [Hash] params ({})
+    def delete_project(params = {}, options = {})
+      req = build_request(:delete_project, params)
+      req.send_request(options)
+    end
+
+    # Deletes an Amazon Rekognition Custom Labels model.
+    #
+    # You can't delete a model if it is running or if it is training. To
+    # check the status of a model, use the `Status` field returned from
+    # DescribeProjectVersions. To stop a running model call
+    # StopProjectVersion. If the model is training, wait until it finishes.
+    #
+    # This operation requires permissions to perform the
+    # `rekognition:DeleteProjectVersion` action.
+    #
+    # @option params [required, String] :project_version_arn
+    #   The Amazon Resource Name (ARN) of the model version that you want to
+    #   delete.
+    #
+    # @return [Types::DeleteProjectVersionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteProjectVersionResponse#status #status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_project_version({
+    #     project_version_arn: "ProjectVersionArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.status #=> String, one of "TRAINING_IN_PROGRESS", "TRAINING_COMPLETED", "TRAINING_FAILED", "STARTING", "RUNNING", "FAILED", "STOPPING", "STOPPED", "DELETING"
+    #
+    # @overload delete_project_version(params = {})
+    # @param [Hash] params ({})
+    def delete_project_version(params = {}, options = {})
+      req = build_request(:delete_project_version, params)
+      req.send_request(options)
+    end
+
     # Deletes the stream processor identified by `Name`. You assign the
     # value for `Name` when you create the stream processor with
     # CreateStreamProcessor. You might not be able to use the same name for
@@ -982,7 +1055,11 @@ module Aws::Rekognition
     # @option params [Array<String>] :version_names
     #   A list of model version names that you want to describe. You can add
     #   up to 10 model version names to the list. If you don't specify a
-    #   value, all model descriptions are returned.
+    #   value, all model descriptions are returned. A version name is part of
+    #   a model (ProjectVersion) ARN. For example,
+    #   `my-model.2020-01-21T09.10.15` is the version name in the following
+    #   ARN.
+    #   `arn:aws:rekognition:us-east-1:123456789012:project/getting-started/version/my-model.2020-01-21T09.10.15/1234567890123`.
     #
     # @option params [String] :next_token
     #   If the previous response was incomplete (because there is more results
@@ -1001,6 +1078,8 @@ module Aws::Rekognition
     #   * {Types::DescribeProjectVersionsResponse#project_version_descriptions #project_version_descriptions} => Array&lt;Types::ProjectVersionDescription&gt;
     #   * {Types::DescribeProjectVersionsResponse#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_project_versions({
@@ -1046,6 +1125,12 @@ module Aws::Rekognition
     #   resp.project_version_descriptions[0].evaluation_result.summary.s3_object.version #=> String
     #   resp.next_token #=> String
     #
+    #
+    # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
+    #
+    #   * project_version_running
+    #   * project_version_training_completed
+    #
     # @overload describe_project_versions(params = {})
     # @param [Hash] params ({})
     def describe_project_versions(params = {}, options = {})
@@ -1076,6 +1161,8 @@ module Aws::Rekognition
     #   * {Types::DescribeProjectsResponse#project_descriptions #project_descriptions} => Array&lt;Types::ProjectDescription&gt;
     #   * {Types::DescribeProjectsResponse#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_projects({
@@ -1937,6 +2024,8 @@ module Aws::Rekognition
     #   * {Types::GetCelebrityRecognitionResponse#next_token #next_token} => String
     #   * {Types::GetCelebrityRecognitionResponse#celebrities #celebrities} => Array&lt;Types::CelebrityRecognition&gt;
     #
+    # 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.get_celebrity_recognition({
@@ -2080,6 +2169,8 @@ module Aws::Rekognition
     #   * {Types::GetContentModerationResponse#next_token #next_token} => String
     #   * {Types::GetContentModerationResponse#moderation_model_version #moderation_model_version} => 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.get_content_moderation({
@@ -2162,6 +2253,8 @@ module Aws::Rekognition
     #   * {Types::GetFaceDetectionResponse#next_token #next_token} => String
     #   * {Types::GetFaceDetectionResponse#faces #faces} => Array&lt;Types::FaceDetection&gt;
     #
+    # 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.get_face_detection({
@@ -2291,6 +2384,8 @@ module Aws::Rekognition
     #   * {Types::GetFaceSearchResponse#video_metadata #video_metadata} => Types::VideoMetadata
     #   * {Types::GetFaceSearchResponse#persons #persons} => Array&lt;Types::PersonMatch&gt;
     #
+    # 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.get_face_search({
@@ -2437,6 +2532,8 @@ module Aws::Rekognition
     #   * {Types::GetLabelDetectionResponse#labels #labels} => Array&lt;Types::LabelDetection&gt;
     #   * {Types::GetLabelDetectionResponse#label_model_version #label_model_version} => 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.get_label_detection({
@@ -2548,6 +2645,8 @@ module Aws::Rekognition
     #   * {Types::GetPersonTrackingResponse#next_token #next_token} => String
     #   * {Types::GetPersonTrackingResponse#persons #persons} => Array&lt;Types::PersonDetection&gt;
     #
+    # 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.get_person_tracking({
@@ -2618,6 +2717,116 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # Gets the segment detection results of a Amazon Rekognition Video
+    # analysis started by StartSegmentDetection.
+    #
+    # Segment detection with Amazon Rekognition Video is an asynchronous
+    # operation. You start segment detection by calling
+    # StartSegmentDetection which returns a job identifier (`JobId`). When
+    # the segment detection operation finishes, Amazon Rekognition publishes
+    # a completion status to the Amazon Simple Notification Service topic
+    # registered in the initial call to `StartSegmentDetection`. To get the
+    # results of the segment detection operation, first check that the
+    # status value published to the Amazon SNS topic is `SUCCEEDED`. if so,
+    # call `GetSegmentDetection` and pass the job identifier (`JobId`) from
+    # the initial call of `StartSegmentDetection`.
+    #
+    # `GetSegmentDetection` returns detected segments in an array
+    # (`Segments`) of SegmentDetection objects. `Segments` is sorted by the
+    # segment types specified in the `SegmentTypes` input parameter of
+    # `StartSegmentDetection`. Each element of the array includes the
+    # detected segment, the precentage confidence in the acuracy of the
+    # detected segment, the type of the segment, and the frame in which the
+    # segment was detected.
+    #
+    # Use `SelectedSegmentTypes` to find out the type of segment detection
+    # requested in the call to `StartSegmentDetection`.
+    #
+    # Use the `MaxResults` parameter to limit the number of segment
+    # detections returned. If there are more results than specified in
+    # `MaxResults`, the value of `NextToken` in the operation response
+    # contains a pagination token for getting the next set of results. To
+    # get the next page of results, call `GetSegmentDetection` and populate
+    # the `NextToken` request parameter with the token value returned from
+    # the previous call to `GetSegmentDetection`.
+    #
+    # For more information, see Detecting Video Segments in Stored Video in
+    # the Amazon Rekognition Developer Guide.
+    #
+    # @option params [required, String] :job_id
+    #   Job identifier for the text detection operation for which you want
+    #   results returned. You get the job identifer from an initial call to
+    #   `StartSegmentDetection`.
+    #
+    # @option params [Integer] :max_results
+    #   Maximum number of results to return per paginated call. The largest
+    #   value you can specify is 1000.
+    #
+    # @option params [String] :next_token
+    #   If the response is truncated, Amazon Rekognition Video returns this
+    #   token that you can use in the subsequent request to retrieve the next
+    #   set of text.
+    #
+    # @return [Types::GetSegmentDetectionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetSegmentDetectionResponse#job_status #job_status} => String
+    #   * {Types::GetSegmentDetectionResponse#status_message #status_message} => String
+    #   * {Types::GetSegmentDetectionResponse#video_metadata #video_metadata} => Array&lt;Types::VideoMetadata&gt;
+    #   * {Types::GetSegmentDetectionResponse#audio_metadata #audio_metadata} => Array&lt;Types::AudioMetadata&gt;
+    #   * {Types::GetSegmentDetectionResponse#next_token #next_token} => String
+    #   * {Types::GetSegmentDetectionResponse#segments #segments} => Array&lt;Types::SegmentDetection&gt;
+    #   * {Types::GetSegmentDetectionResponse#selected_segment_types #selected_segment_types} => Array&lt;Types::SegmentTypeInfo&gt;
+    #
+    # 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.get_segment_detection({
+    #     job_id: "JobId", # required
+    #     max_results: 1,
+    #     next_token: "PaginationToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.job_status #=> String, one of "IN_PROGRESS", "SUCCEEDED", "FAILED"
+    #   resp.status_message #=> String
+    #   resp.video_metadata #=> Array
+    #   resp.video_metadata[0].codec #=> String
+    #   resp.video_metadata[0].duration_millis #=> Integer
+    #   resp.video_metadata[0].format #=> String
+    #   resp.video_metadata[0].frame_rate #=> Float
+    #   resp.video_metadata[0].frame_height #=> Integer
+    #   resp.video_metadata[0].frame_width #=> Integer
+    #   resp.audio_metadata #=> Array
+    #   resp.audio_metadata[0].codec #=> String
+    #   resp.audio_metadata[0].duration_millis #=> Integer
+    #   resp.audio_metadata[0].sample_rate #=> Integer
+    #   resp.audio_metadata[0].number_of_channels #=> Integer
+    #   resp.next_token #=> String
+    #   resp.segments #=> Array
+    #   resp.segments[0].type #=> String, one of "TECHNICAL_CUE", "SHOT"
+    #   resp.segments[0].start_timestamp_millis #=> Integer
+    #   resp.segments[0].end_timestamp_millis #=> Integer
+    #   resp.segments[0].duration_millis #=> Integer
+    #   resp.segments[0].start_timecode_smpte #=> String
+    #   resp.segments[0].end_timecode_smpte #=> String
+    #   resp.segments[0].duration_smpte #=> String
+    #   resp.segments[0].technical_cue_segment.type #=> String, one of "ColorBars", "EndCredits", "BlackFrames"
+    #   resp.segments[0].technical_cue_segment.confidence #=> Float
+    #   resp.segments[0].shot_segment.index #=> Integer
+    #   resp.segments[0].shot_segment.confidence #=> Float
+    #   resp.selected_segment_types #=> Array
+    #   resp.selected_segment_types[0].type #=> String, one of "TECHNICAL_CUE", "SHOT"
+    #   resp.selected_segment_types[0].model_version #=> String
+    #
+    # @overload get_segment_detection(params = {})
+    # @param [Hash] params ({})
+    def get_segment_detection(params = {}, options = {})
+      req = build_request(:get_segment_detection, params)
+      req.send_request(options)
+    end
+
     # Gets the text detection results of a Amazon Rekognition Video analysis
     # started by StartTextDetection.
     #
@@ -2650,7 +2859,7 @@ module Aws::Rekognition
     # to `GetTextDetection`.
     #
     # @option params [required, String] :job_id
-    #   Job identifier for the label detection operation for which you want
+    #   Job identifier for the text detection operation for which you want
     #   results returned. You get the job identifer from an initial call to
     #   `StartTextDetection`.
     #
@@ -2673,6 +2882,8 @@ module Aws::Rekognition
     #   * {Types::GetTextDetectionResponse#next_token #next_token} => String
     #   * {Types::GetTextDetectionResponse#text_model_version #text_model_version} => 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.get_text_detection({
@@ -2747,7 +2958,7 @@ module Aws::Rekognition
     # For more information, see Model Versioning in the Amazon Rekognition
     # Developer Guide.
     #
-    # If you provide the optional `ExternalImageID` for the input image you
+    # If you provide the optional `ExternalImageId` for the input image you
     # provided, Amazon Rekognition associates this ID with all faces that it
     # detects. When you call the ListFaces operation, the response returns
     # the external ID. You can use this external image ID to create a
@@ -3167,6 +3378,8 @@ module Aws::Rekognition
     #   * {Types::ListCollectionsResponse#next_token #next_token} => String
     #   * {Types::ListCollectionsResponse#face_model_versions #face_model_versions} => Array&lt;String&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list the collections
     #
@@ -3231,6 +3444,8 @@ module Aws::Rekognition
     #   * {Types::ListFacesResponse#next_token #next_token} => String
     #   * {Types::ListFacesResponse#face_model_version #face_model_version} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list the faces in a collection
     #
@@ -3415,6 +3630,8 @@ module Aws::Rekognition
     #   * {Types::ListStreamProcessorsResponse#next_token #next_token} => String
     #   * {Types::ListStreamProcessorsResponse#stream_processors #stream_processors} => Array&lt;Types::StreamProcessor&gt;
     #
+    # 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_processors({
@@ -4376,6 +4593,103 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # Starts asynchronous detection of segment detection in a stored video.
+    #
+    # Amazon Rekognition Video can detect segments in a video stored in an
+    # Amazon S3 bucket. Use Video to specify the bucket name and the
+    # filename of the video. `StartSegmentDetection` returns a job
+    # identifier (`JobId`) which you use to get the results of the
+    # operation. When segment detection is finished, Amazon Rekognition
+    # Video publishes a completion status to the Amazon Simple Notification
+    # Service topic that you specify in `NotificationChannel`.
+    #
+    # You can use the `Filters` (StartSegmentDetectionFilters) input
+    # parameter to specify the minimum detection confidence returned in the
+    # response. Within `Filters`, use `ShotFilter`
+    # (StartShotDetectionFilter) to filter detected shots. Use
+    # `TechnicalCueFilter` (StartTechnicalCueDetectionFilter) to filter
+    # technical cues.
+    #
+    # To get the results of the segment detection operation, first check
+    # that the status value published to the Amazon SNS topic is
+    # `SUCCEEDED`. if so, call GetSegmentDetection and pass the job
+    # identifier (`JobId`) from the initial call to `StartSegmentDetection`.
+    #
+    # For more information, see Detecting Video Segments in Stored Video in
+    # the Amazon Rekognition Developer Guide.
+    #
+    # @option params [required, Types::Video] :video
+    #   Video file stored in an Amazon S3 bucket. Amazon Rekognition video
+    #   start operations such as StartLabelDetection use `Video` to specify a
+    #   video for analysis. The supported file formats are .mp4, .mov and
+    #   .avi.
+    #
+    # @option params [String] :client_request_token
+    #   Idempotent token used to identify the start request. If you use the
+    #   same token with multiple `StartSegmentDetection` requests, the same
+    #   `JobId` is returned. Use `ClientRequestToken` to prevent the same job
+    #   from being accidently started more than once.
+    #
+    # @option params [Types::NotificationChannel] :notification_channel
+    #   The ARN of the Amazon SNS topic to which you want Amazon Rekognition
+    #   Video to publish the completion status of the segment detection
+    #   operation.
+    #
+    # @option params [String] :job_tag
+    #   An identifier you specify that's returned in the completion
+    #   notification that's published to your Amazon Simple Notification
+    #   Service topic. For example, you can use `JobTag` to group related jobs
+    #   and identify them in the completion notification.
+    #
+    # @option params [Types::StartSegmentDetectionFilters] :filters
+    #   Filters for technical cue or shot detection.
+    #
+    # @option params [required, Array<String>] :segment_types
+    #   An array of segment types to detect in the video. Valid values are
+    #   TECHNICAL\_CUE and SHOT.
+    #
+    # @return [Types::StartSegmentDetectionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartSegmentDetectionResponse#job_id #job_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_segment_detection({
+    #     video: { # required
+    #       s3_object: {
+    #         bucket: "S3Bucket",
+    #         name: "S3ObjectName",
+    #         version: "S3ObjectVersion",
+    #       },
+    #     },
+    #     client_request_token: "ClientRequestToken",
+    #     notification_channel: {
+    #       sns_topic_arn: "SNSTopicArn", # required
+    #       role_arn: "RoleArn", # required
+    #     },
+    #     job_tag: "JobTag",
+    #     filters: {
+    #       technical_cue_filter: {
+    #         min_segment_confidence: 1.0,
+    #       },
+    #       shot_filter: {
+    #         min_segment_confidence: 1.0,
+    #       },
+    #     },
+    #     segment_types: ["TECHNICAL_CUE"], # required, accepts TECHNICAL_CUE, SHOT
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.job_id #=> String
+    #
+    # @overload start_segment_detection(params = {})
+    # @param [Hash] params ({})
+    def start_segment_detection(params = {}, options = {})
+      req = build_request(:start_segment_detection, params)
+      req.send_request(options)
+    end
+
     # Starts processing a stream processor. You create a stream processor by
     # calling CreateStreamProcessor. To tell `StartStreamProcessor` which
     # stream processor to start, use the value of the `Name` field specified
@@ -4556,7 +4870,7 @@ module Aws::Rekognition
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rekognition'
-      context[:gem_version] = '1.35.0'
+      context[:gem_version] = '1.40.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 
@@ -4622,10 +4936,10 @@ module Aws::Rekognition
     # The following table lists the valid waiter names, the operations they call,
     # and the default `:delay` and `:max_attempts` values.
     #
-    # | waiter_name                        | params                       | :delay   | :max_attempts |
-    # | ---------------------------------- | ---------------------------- | -------- | ------------- |
-    # | project_version_running            | {#describe_project_versions} | 30       | 40            |
-    # | project_version_training_completed | {#describe_project_versions} | 120      | 360           |
+    # | waiter_name                        | params                             | :delay   | :max_attempts |
+    # | ---------------------------------- | ---------------------------------- | -------- | ------------- |
+    # | project_version_running            | {Client#describe_project_versions} | 30       | 40            |
+    # | project_version_training_completed | {Client#describe_project_versions} | 120      | 360           |
     #
     # @raise [Errors::FailureStateError] Raised when the waiter terminates
     #   because the waiter has entered a state that it will not transition