aws-sdk-rekognition 1.66.0 → 1.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a610d3a80b6fd1349aeb2d2c7c48042a7cd74dec4c2831959502a7d74bbbd76f
4
- data.tar.gz: 026ab7787798e52fb40aa0a0e8a4b92eb270d0890f7a44defeacae40210a90eb
3
+ metadata.gz: 9e33b541289489a725a30e9c137c81aee7df36598d26cd240db58d729465a370
4
+ data.tar.gz: 50186ab3f86c968da995e6d4b8645bc076113e260bfff700840935fa4597d47e
5
5
  SHA512:
6
- metadata.gz: 240372e558a7c409f08c3fadc7d6cb096844db1ec08988e98f0d3216986bce4e5a80d17ea853b7e684ddc2907cff0e7062d67f0ea1395b713a796d62e806e07c
7
- data.tar.gz: c22787cfcb6fcbee1cf5930a4c73c288dd5e9575406101be1ca8aafc9cd3ca6071b69fdd21ac11f9474f00b31647582f905d5e6a41fc00281f7075a159c77569
6
+ metadata.gz: 0b992dd954a41666d10dad67846195bb8783b64f254b98e69def6b08216f647bbd0408606ea925d55cd826b571cecaf767c5f4a94eed3e1d6e5a0ecc1c9af4a9
7
+ data.tar.gz: 54eac3ee8a26852af649aeb2a4cced177132bbfcaeae2097606b1a51c9e330ba4e8ebc827fd30ed57feff3bdabdacc26483d25fd65cf9fd424679b7608536efc
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.67.0 (2022-04-27)
5
+ ------------------
6
+
7
+ * Feature - This release adds support to configure stream-processor resources for label detections on streaming-videos. UpateStreamProcessor API is also launched with this release, which could be used to update an existing stream-processor.
8
+
4
9
  1.66.0 (2022-02-24)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.66.0
1
+ 1.67.0
@@ -930,23 +930,36 @@ module Aws::Rekognition
930
930
  end
931
931
 
932
932
  # Creates an Amazon Rekognition stream processor that you can use to
933
- # detect and recognize faces in a streaming video.
933
+ # detect and recognize faces or to detect labels in a streaming video.
934
934
  #
935
935
  # Amazon Rekognition Video is a consumer of live video from Amazon
936
- # Kinesis Video Streams. Amazon Rekognition Video sends analysis results
937
- # to Amazon Kinesis Data Streams.
938
- #
939
- # You provide as input a Kinesis video stream (`Input`) and a Kinesis
940
- # data stream (`Output`) stream. You also specify the face recognition
941
- # criteria in `Settings`. For example, the collection containing faces
942
- # that you want to recognize. Use `Name` to assign an identifier for the
943
- # stream processor. You use `Name` to manage the stream processor. For
944
- # example, you can start processing the source video by calling
945
- # StartStreamProcessor with the `Name` field.
946
- #
947
- # After you have finished analyzing a streaming video, use
948
- # StopStreamProcessor to stop processing. You can delete the stream
949
- # processor by calling DeleteStreamProcessor.
936
+ # Kinesis Video Streams. There are two different settings for stream
937
+ # processors in Amazon Rekognition: detecting faces and detecting
938
+ # labels.
939
+ #
940
+ # * If you are creating a stream processor for detecting faces, you
941
+ # provide as input a Kinesis video stream (`Input`) and a Kinesis data
942
+ # stream (`Output`) stream. You also specify the face recognition
943
+ # criteria in `Settings`. For example, the collection containing faces
944
+ # that you want to recognize. After you have finished analyzing a
945
+ # streaming video, use StopStreamProcessor to stop processing.
946
+ #
947
+ # * If you are creating a stream processor to detect labels, you provide
948
+ # as input a Kinesis video stream (`Input`), Amazon S3 bucket
949
+ # information (`Output`), and an Amazon SNS topic ARN
950
+ # (`NotificationChannel`). You can also provide a KMS key ID to
951
+ # encrypt the data sent to your Amazon S3 bucket. You specify what you
952
+ # want to detect in `ConnectedHomeSettings`, such as people, packages
953
+ # and people, or pets, people, and packages. You can also specify
954
+ # where in the frame you want Amazon Rekognition to monitor with
955
+ # `RegionsOfInterest`. When you run the StartStreamProcessor operation
956
+ # on a label detection stream processor, you input start and stop
957
+ # information to determine the length of the processing time.
958
+ #
959
+ # Use `Name` to assign an identifier for the stream processor. You use
960
+ # `Name` to manage the stream processor. For example, you can start
961
+ # processing the source video by calling StartStreamProcessor with the
962
+ # `Name` field.
950
963
  #
951
964
  # This operation requires permissions to perform the
952
965
  # `rekognition:CreateStreamProcessor` action. If you want to tag your
@@ -956,31 +969,78 @@ module Aws::Rekognition
956
969
  # @option params [required, Types::StreamProcessorInput] :input
957
970
  # Kinesis video stream stream that provides the source streaming video.
958
971
  # If you are using the AWS CLI, the parameter name is
959
- # `StreamProcessorInput`.
972
+ # `StreamProcessorInput`. This is required for both face search and
973
+ # label detection stream processors.
960
974
  #
961
975
  # @option params [required, Types::StreamProcessorOutput] :output
962
- # Kinesis data stream stream to which Amazon Rekognition Video puts the
963
- # analysis results. If you are using the AWS CLI, the parameter name is
964
- # `StreamProcessorOutput`.
976
+ # Kinesis data stream stream or Amazon S3 bucket location to which
977
+ # Amazon Rekognition Video puts the analysis results. If you are using
978
+ # the AWS CLI, the parameter name is `StreamProcessorOutput`. This must
979
+ # be a S3Destination of an Amazon S3 bucket that you own for a label
980
+ # detection stream processor or a Kinesis data stream ARN for a face
981
+ # search stream processor.
965
982
  #
966
983
  # @option params [required, String] :name
967
984
  # An identifier you assign to the stream processor. You can use `Name`
968
985
  # to manage the stream processor. For example, you can get the current
969
986
  # status of the stream processor by calling DescribeStreamProcessor.
970
- # `Name` is idempotent.
987
+ # `Name` is idempotent. This is required for both face search and label
988
+ # detection stream processors.
971
989
  #
972
990
  # @option params [required, Types::StreamProcessorSettings] :settings
973
- # Face recognition input parameters to be used by the stream processor.
974
- # Includes the collection to use for face recognition and the face
975
- # attributes to detect.
991
+ # Input parameters used in a streaming video analyzed by a stream
992
+ # processor. You can use `FaceSearch` to recognize faces in a streaming
993
+ # video, or you can use `ConnectedHome` to detect labels.
976
994
  #
977
995
  # @option params [required, String] :role_arn
978
- # ARN of the IAM role that allows access to the stream processor.
996
+ # The Amazon Resource Number (ARN) of the IAM role that allows access to
997
+ # the stream processor. The IAM role provides Rekognition read
998
+ # permissions for a Kinesis stream. It also provides write permissions
999
+ # to an Amazon S3 bucket and Amazon Simple Notification Service topic
1000
+ # for a label detection stream processor. This is required for both face
1001
+ # search and label detection stream processors.
979
1002
  #
980
1003
  # @option params [Hash<String,String>] :tags
981
1004
  # A set of tags (key-value pairs) that you want to attach to the stream
982
1005
  # processor.
983
1006
  #
1007
+ # @option params [Types::StreamProcessorNotificationChannel] :notification_channel
1008
+ # The Amazon Simple Notification Service topic to which Amazon
1009
+ # Rekognition publishes the object detection results and completion
1010
+ # status of a video analysis operation.
1011
+ #
1012
+ # Amazon Rekognition publishes a notification the first time an object
1013
+ # of interest or a person is detected in the video stream. For example,
1014
+ # if Amazon Rekognition detects a person at second 2, a pet at second 4,
1015
+ # and a person again at second 5, Amazon Rekognition sends 2 object
1016
+ # class detected notifications, one for a person at second 2 and one for
1017
+ # a pet at second 4.
1018
+ #
1019
+ # Amazon Rekognition also publishes an an end-of-session notification
1020
+ # with a summary when the stream processing session is complete.
1021
+ #
1022
+ # @option params [String] :kms_key_id
1023
+ # The identifier for your AWS Key Management Service key (AWS KMS key).
1024
+ # This is an optional parameter for label detection stream processors
1025
+ # and should not be used to create a face search stream processor. You
1026
+ # can supply the Amazon Resource Name (ARN) of your KMS key, the ID of
1027
+ # your KMS key, an alias for your KMS key, or an alias ARN. The key is
1028
+ # used to encrypt results and data published to your Amazon S3 bucket,
1029
+ # which includes image frames and hero images. Your source images are
1030
+ # unaffected.
1031
+ #
1032
+ # @option params [Array<Types::RegionOfInterest>] :regions_of_interest
1033
+ # Specifies locations in the frames where Amazon Rekognition checks for
1034
+ # objects or people. You can specify up to 10 regions of interest. This
1035
+ # is an optional parameter for label detection stream processors and
1036
+ # should not be used to create a face search stream processor.
1037
+ #
1038
+ # @option params [Types::StreamProcessorDataSharingPreference] :data_sharing_preference
1039
+ # Shows whether you are sharing data with Rekognition to improve model
1040
+ # performance. You can choose this option at the account level or on a
1041
+ # per-stream basis. Note that if you opt out at the account level this
1042
+ # setting is ignored on individual streams.
1043
+ #
984
1044
  # @return [Types::CreateStreamProcessorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
985
1045
  #
986
1046
  # * {Types::CreateStreamProcessorResponse#stream_processor_arn #stream_processor_arn} => String
@@ -997,6 +1057,10 @@ module Aws::Rekognition
997
1057
  # kinesis_data_stream: {
998
1058
  # arn: "KinesisDataArn",
999
1059
  # },
1060
+ # s3_destination: {
1061
+ # bucket: "S3Bucket",
1062
+ # key_prefix: "S3KeyPrefix",
1063
+ # },
1000
1064
  # },
1001
1065
  # name: "StreamProcessorName", # required
1002
1066
  # settings: { # required
@@ -1004,11 +1068,38 @@ module Aws::Rekognition
1004
1068
  # collection_id: "CollectionId",
1005
1069
  # face_match_threshold: 1.0,
1006
1070
  # },
1071
+ # connected_home: {
1072
+ # labels: ["ConnectedHomeLabel"], # required
1073
+ # min_confidence: 1.0,
1074
+ # },
1007
1075
  # },
1008
1076
  # role_arn: "RoleArn", # required
1009
1077
  # tags: {
1010
1078
  # "TagKey" => "TagValue",
1011
1079
  # },
1080
+ # notification_channel: {
1081
+ # sns_topic_arn: "SNSTopicArn", # required
1082
+ # },
1083
+ # kms_key_id: "KmsKeyId",
1084
+ # regions_of_interest: [
1085
+ # {
1086
+ # bounding_box: {
1087
+ # width: 1.0,
1088
+ # height: 1.0,
1089
+ # left: 1.0,
1090
+ # top: 1.0,
1091
+ # },
1092
+ # polygon: [
1093
+ # {
1094
+ # x: 1.0,
1095
+ # y: 1.0,
1096
+ # },
1097
+ # ],
1098
+ # },
1099
+ # ],
1100
+ # data_sharing_preference: {
1101
+ # opt_in: false, # required
1102
+ # },
1012
1103
  # })
1013
1104
  #
1014
1105
  # @example Response structure
@@ -1023,12 +1114,16 @@ module Aws::Rekognition
1023
1114
  end
1024
1115
 
1025
1116
  # Deletes the specified collection. Note that this operation removes all
1026
- # faces in the collection. For an example, see
1027
- # delete-collection-procedure.
1117
+ # faces in the collection. For an example, see [Deleting a
1118
+ # collection][1].
1028
1119
  #
1029
1120
  # This operation requires permissions to perform the
1030
1121
  # `rekognition:DeleteCollection` action.
1031
1122
  #
1123
+ #
1124
+ #
1125
+ # [1]: https://docs.aws.amazon.com/rekognition/latest/dg/delete-collection-procedure.html
1126
+ #
1032
1127
  # @option params [required, String] :collection_id
1033
1128
  # ID of the collection to delete.
1034
1129
  #
@@ -1514,6 +1609,10 @@ module Aws::Rekognition
1514
1609
  # * {Types::DescribeStreamProcessorResponse#output #output} => Types::StreamProcessorOutput
1515
1610
  # * {Types::DescribeStreamProcessorResponse#role_arn #role_arn} => String
1516
1611
  # * {Types::DescribeStreamProcessorResponse#settings #settings} => Types::StreamProcessorSettings
1612
+ # * {Types::DescribeStreamProcessorResponse#notification_channel #notification_channel} => Types::StreamProcessorNotificationChannel
1613
+ # * {Types::DescribeStreamProcessorResponse#kms_key_id #kms_key_id} => String
1614
+ # * {Types::DescribeStreamProcessorResponse#regions_of_interest #regions_of_interest} => Array&lt;Types::RegionOfInterest&gt;
1615
+ # * {Types::DescribeStreamProcessorResponse#data_sharing_preference #data_sharing_preference} => Types::StreamProcessorDataSharingPreference
1517
1616
  #
1518
1617
  # @example Request syntax with placeholder values
1519
1618
  #
@@ -1525,15 +1624,31 @@ module Aws::Rekognition
1525
1624
  #
1526
1625
  # resp.name #=> String
1527
1626
  # resp.stream_processor_arn #=> String
1528
- # resp.status #=> String, one of "STOPPED", "STARTING", "RUNNING", "FAILED", "STOPPING"
1627
+ # resp.status #=> String, one of "STOPPED", "STARTING", "RUNNING", "FAILED", "STOPPING", "UPDATING"
1529
1628
  # resp.status_message #=> String
1530
1629
  # resp.creation_timestamp #=> Time
1531
1630
  # resp.last_update_timestamp #=> Time
1532
1631
  # resp.input.kinesis_video_stream.arn #=> String
1533
1632
  # resp.output.kinesis_data_stream.arn #=> String
1633
+ # resp.output.s3_destination.bucket #=> String
1634
+ # resp.output.s3_destination.key_prefix #=> String
1534
1635
  # resp.role_arn #=> String
1535
1636
  # resp.settings.face_search.collection_id #=> String
1536
1637
  # resp.settings.face_search.face_match_threshold #=> Float
1638
+ # resp.settings.connected_home.labels #=> Array
1639
+ # resp.settings.connected_home.labels[0] #=> String
1640
+ # resp.settings.connected_home.min_confidence #=> Float
1641
+ # resp.notification_channel.sns_topic_arn #=> String
1642
+ # resp.kms_key_id #=> String
1643
+ # resp.regions_of_interest #=> Array
1644
+ # resp.regions_of_interest[0].bounding_box.width #=> Float
1645
+ # resp.regions_of_interest[0].bounding_box.height #=> Float
1646
+ # resp.regions_of_interest[0].bounding_box.left #=> Float
1647
+ # resp.regions_of_interest[0].bounding_box.top #=> Float
1648
+ # resp.regions_of_interest[0].polygon #=> Array
1649
+ # resp.regions_of_interest[0].polygon[0].x #=> Float
1650
+ # resp.regions_of_interest[0].polygon[0].y #=> Float
1651
+ # resp.data_sharing_preference.opt_in #=> Boolean
1537
1652
  #
1538
1653
  # @overload describe_stream_processor(params = {})
1539
1654
  # @param [Hash] params ({})
@@ -1616,8 +1731,9 @@ module Aws::Rekognition
1616
1731
  # using the S3Object property.
1617
1732
  #
1618
1733
  # For Amazon Rekognition to process an S3 object, the user must have
1619
- # permission to access the S3 object. For more information, see Resource
1620
- # Based Policies in the Amazon Rekognition Developer Guide.
1734
+ # permission to access the S3 object. For more information, see How
1735
+ # Amazon Rekognition works with IAM in the Amazon Rekognition Developer
1736
+ # Guide.
1621
1737
  #
1622
1738
  # @option params [Integer] :max_results
1623
1739
  # Maximum number of results you want the service to return in the
@@ -1859,7 +1975,7 @@ module Aws::Rekognition
1859
1975
  # events like wedding, graduation, and birthday party; and concepts like
1860
1976
  # landscape, evening, and nature.
1861
1977
  #
1862
- # For an example, see Analyzing Images Stored in an Amazon S3 Bucket in
1978
+ # For an example, see Analyzing images stored in an Amazon S3 bucket in
1863
1979
  # the Amazon Rekognition Developer Guide.
1864
1980
  #
1865
1981
  # <note markdown="1"> `DetectLabels` does not support the detection of activities. However,
@@ -2256,7 +2372,7 @@ module Aws::Rekognition
2256
2372
  # To be detected, text must be within +/- 90 degrees orientation of the
2257
2373
  # horizontal axis.
2258
2374
  #
2259
- # For more information, see DetectText in the Amazon Rekognition
2375
+ # For more information, see Detecting text in the Amazon Rekognition
2260
2376
  # Developer Guide.
2261
2377
  #
2262
2378
  # @option params [required, Types::Image] :image
@@ -2303,6 +2419,12 @@ module Aws::Rekognition
2303
2419
  # left: 1.0,
2304
2420
  # top: 1.0,
2305
2421
  # },
2422
+ # polygon: [
2423
+ # {
2424
+ # x: 1.0,
2425
+ # y: 1.0,
2426
+ # },
2427
+ # ],
2306
2428
  # },
2307
2429
  # ],
2308
2430
  # },
@@ -2381,7 +2503,7 @@ module Aws::Rekognition
2381
2503
  # an array of URLs. If there is no additional information about the
2382
2504
  # celebrity, this list is empty.
2383
2505
  #
2384
- # For more information, see Recognizing Celebrities in an Image in the
2506
+ # For more information, see Getting information about a celebrity in the
2385
2507
  # Amazon Rekognition Developer Guide.
2386
2508
  #
2387
2509
  # This operation requires permissions to perform the
@@ -2617,7 +2739,7 @@ module Aws::Rekognition
2617
2739
  # and populate the `NextToken` request parameter with the value of
2618
2740
  # `NextToken` returned from the previous call to `GetContentModeration`.
2619
2741
  #
2620
- # For more information, see Content moderation in the Amazon Rekognition
2742
+ # For more information, see moderating content in the Amazon Rekognition
2621
2743
  # Developer Guide.
2622
2744
  #
2623
2745
  #
@@ -3244,7 +3366,7 @@ module Aws::Rekognition
3244
3366
  # the `NextToken` request parameter with the token value returned from
3245
3367
  # the previous call to `GetSegmentDetection`.
3246
3368
  #
3247
- # For more information, see Detecting Video Segments in Stored Video in
3369
+ # For more information, see Detecting video segments in stored video in
3248
3370
  # the Amazon Rekognition Developer Guide.
3249
3371
  #
3250
3372
  # @option params [required, String] :job_id
@@ -3436,7 +3558,7 @@ module Aws::Rekognition
3436
3558
  # search operations using the SearchFaces and SearchFacesByImage
3437
3559
  # operations.
3438
3560
  #
3439
- # For more information, see Adding Faces to a Collection in the Amazon
3561
+ # For more information, see Adding faces to a collection in the Amazon
3440
3562
  # Rekognition Developer Guide.
3441
3563
  #
3442
3564
  # To get the number of faces in a collection, call DescribeCollection.
@@ -3517,9 +3639,9 @@ module Aws::Rekognition
3517
3639
  # `detectionAttributes` parameter), Amazon Rekognition returns detailed
3518
3640
  # facial attributes, such as facial landmarks (for example, location of
3519
3641
  # eye and mouth) and other facial attributes. If you provide the same
3520
- # image, specify the same collection, use the same external ID, and use
3521
- # the same model version in the `IndexFaces` operation, Amazon
3522
- # Rekognition doesn't save duplicate face metadata.
3642
+ # image, specify the same collection, and use the same external ID in
3643
+ # the `IndexFaces` operation, Amazon Rekognition doesn't save duplicate
3644
+ # face metadata.
3523
3645
  #
3524
3646
  #
3525
3647
  #
@@ -3860,7 +3982,7 @@ module Aws::Rekognition
3860
3982
  # truncated, the response also provides a `NextToken` that you can use
3861
3983
  # in the subsequent request to fetch the next set of collection IDs.
3862
3984
  #
3863
- # For an example, see Listing Collections in the Amazon Rekognition
3985
+ # For an example, see Listing collections in the Amazon Rekognition
3864
3986
  # Developer Guide.
3865
3987
  #
3866
3988
  # This operation requires permissions to perform the
@@ -4294,7 +4416,7 @@ module Aws::Rekognition
4294
4416
  # resp.next_token #=> String
4295
4417
  # resp.stream_processors #=> Array
4296
4418
  # resp.stream_processors[0].name #=> String
4297
- # resp.stream_processors[0].status #=> String, one of "STOPPED", "STARTING", "RUNNING", "FAILED", "STOPPING"
4419
+ # resp.stream_processors[0].status #=> String, one of "STOPPED", "STARTING", "RUNNING", "FAILED", "STOPPING", "UPDATING"
4298
4420
  #
4299
4421
  # @overload list_stream_processors(params = {})
4300
4422
  # @param [Hash] params ({})
@@ -4336,7 +4458,7 @@ module Aws::Rekognition
4336
4458
  end
4337
4459
 
4338
4460
  # Returns an array of celebrities recognized in the input image. For
4339
- # more information, see Recognizing Celebrities in the Amazon
4461
+ # more information, see Recognizing celebrities in the Amazon
4340
4462
  # Rekognition Developer Guide.
4341
4463
  #
4342
4464
  # `RecognizeCelebrities` returns the 64 largest faces in the image. It
@@ -4364,7 +4486,7 @@ module Aws::Rekognition
4364
4486
  # to call Amazon Rekognition operations, passing image bytes is not
4365
4487
  # supported. The image must be either a PNG or JPEG formatted file.
4366
4488
  #
4367
- # For an example, see Recognizing Celebrities in an Image in the Amazon
4489
+ # For an example, see Recognizing celebrities in an image in the Amazon
4368
4490
  # Rekognition Developer Guide.
4369
4491
  #
4370
4492
  # This operation requires permissions to perform the
@@ -4474,7 +4596,7 @@ module Aws::Rekognition
4474
4596
  # `confidence` value for each face match, indicating the confidence that
4475
4597
  # the specific face matches the input face.
4476
4598
  #
4477
- # For an example, see Searching for a Face Using Its Face ID in the
4599
+ # For an example, see Searching for a face using its face ID in the
4478
4600
  # Amazon Rekognition Developer Guide.
4479
4601
  #
4480
4602
  # This operation requires permissions to perform the
@@ -4792,7 +4914,7 @@ module Aws::Rekognition
4792
4914
  # identifier (`JobId`) from the initial call to
4793
4915
  # `StartCelebrityRecognition`.
4794
4916
  #
4795
- # For more information, see Recognizing Celebrities in the Amazon
4917
+ # For more information, see Recognizing celebrities in the Amazon
4796
4918
  # Rekognition Developer Guide.
4797
4919
  #
4798
4920
  # @option params [required, Types::Video] :video
@@ -4868,7 +4990,7 @@ module Aws::Rekognition
4868
4990
  # call GetContentModeration and pass the job identifier (`JobId`) from
4869
4991
  # the initial call to `StartContentModeration`.
4870
4992
  #
4871
- # For more information, see Content moderation in the Amazon Rekognition
4993
+ # For more information, see Moderating content in the Amazon Rekognition
4872
4994
  # Developer Guide.
4873
4995
  #
4874
4996
  #
@@ -4956,7 +5078,7 @@ module Aws::Rekognition
4956
5078
  # pass the job identifier (`JobId`) from the initial call to
4957
5079
  # `StartFaceDetection`.
4958
5080
  #
4959
- # For more information, see Detecting Faces in a Stored Video in the
5081
+ # For more information, see Detecting faces in a stored video in the
4960
5082
  # Amazon Rekognition Developer Guide.
4961
5083
  #
4962
5084
  # @option params [required, Types::Video] :video
@@ -5037,7 +5159,11 @@ module Aws::Rekognition
5037
5159
  # status value published to the Amazon SNS topic is `SUCCEEDED`. If so,
5038
5160
  # call GetFaceSearch and pass the job identifier (`JobId`) from the
5039
5161
  # initial call to `StartFaceSearch`. For more information, see
5040
- # procedure-person-search-videos.
5162
+ # [Searching stored videos for faces][1].
5163
+ #
5164
+ #
5165
+ #
5166
+ # [1]: https://docs.aws.amazon.com/rekognition/latest/dg/procedure-person-search-videos.html
5041
5167
  #
5042
5168
  # @option params [required, Types::Video] :video
5043
5169
  # The video you want to search. The video must be stored in an Amazon S3
@@ -5333,7 +5459,7 @@ module Aws::Rekognition
5333
5459
  # `SUCCEEDED`. if so, call GetSegmentDetection and pass the job
5334
5460
  # identifier (`JobId`) from the initial call to `StartSegmentDetection`.
5335
5461
  #
5336
- # For more information, see Detecting Video Segments in Stored Video in
5462
+ # For more information, see Detecting video segments in stored video in
5337
5463
  # the Amazon Rekognition Developer Guide.
5338
5464
  #
5339
5465
  # @option params [required, Types::Video] :video
@@ -5419,17 +5545,55 @@ module Aws::Rekognition
5419
5545
  # stream processor to start, use the value of the `Name` field specified
5420
5546
  # in the call to `CreateStreamProcessor`.
5421
5547
  #
5548
+ # If you are using a label detection stream processor to detect labels,
5549
+ # you need to provide a `Start selector` and a `Stop selector` to
5550
+ # determine the length of the stream processing time.
5551
+ #
5422
5552
  # @option params [required, String] :name
5423
5553
  # The name of the stream processor to start processing.
5424
5554
  #
5425
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
5555
+ # @option params [Types::StreamProcessingStartSelector] :start_selector
5556
+ # Specifies the starting point in the Kinesis stream to start
5557
+ # processing. You can use the producer timestamp or the fragment number.
5558
+ # For more information, see [Fragment][1].
5559
+ #
5560
+ # This is a required parameter for label detection stream processors and
5561
+ # should not be used to start a face search stream processor.
5562
+ #
5563
+ #
5564
+ #
5565
+ # [1]: https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_Fragment.html
5566
+ #
5567
+ # @option params [Types::StreamProcessingStopSelector] :stop_selector
5568
+ # Specifies when to stop processing the stream. You can specify a
5569
+ # maximum amount of time to process the video.
5570
+ #
5571
+ # This is a required parameter for label detection stream processors and
5572
+ # should not be used to start a face search stream processor.
5573
+ #
5574
+ # @return [Types::StartStreamProcessorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5575
+ #
5576
+ # * {Types::StartStreamProcessorResponse#session_id #session_id} => String
5426
5577
  #
5427
5578
  # @example Request syntax with placeholder values
5428
5579
  #
5429
5580
  # resp = client.start_stream_processor({
5430
5581
  # name: "StreamProcessorName", # required
5582
+ # start_selector: {
5583
+ # kvs_stream_start_selector: {
5584
+ # producer_timestamp: 1,
5585
+ # fragment_number: "KinesisVideoStreamFragmentNumber",
5586
+ # },
5587
+ # },
5588
+ # stop_selector: {
5589
+ # max_duration_in_seconds: 1,
5590
+ # },
5431
5591
  # })
5432
5592
  #
5593
+ # @example Response structure
5594
+ #
5595
+ # resp.session_id #=> String
5596
+ #
5433
5597
  # @overload start_stream_processor(params = {})
5434
5598
  # @param [Hash] params ({})
5435
5599
  def start_stream_processor(params = {}, options = {})
@@ -5467,15 +5631,17 @@ module Aws::Rekognition
5467
5631
  # @option params [Types::NotificationChannel] :notification_channel
5468
5632
  # The Amazon Simple Notification Service topic to which Amazon
5469
5633
  # Rekognition publishes the completion status of a video analysis
5470
- # operation. For more information, see api-video. Note that the Amazon
5471
- # SNS topic must have a topic name that begins with *AmazonRekognition*
5472
- # if you are using the AmazonRekognitionServiceRole permissions policy
5473
- # to access the topic. For more information, see [Giving access to
5474
- # multiple Amazon SNS topics][1].
5634
+ # operation. For more information, see [Calling Amazon Rekognition Video
5635
+ # operations][1]. Note that the Amazon SNS topic must have a topic name
5636
+ # that begins with *AmazonRekognition* if you are using the
5637
+ # AmazonRekognitionServiceRole permissions policy to access the topic.
5638
+ # For more information, see [Giving access to multiple Amazon SNS
5639
+ # topics][2].
5475
5640
  #
5476
5641
  #
5477
5642
  #
5478
- # [1]: https://docs.aws.amazon.com/rekognition/latest/dg/api-video-roles.html#api-video-roles-all-topics
5643
+ # [1]: https://docs.aws.amazon.com/rekognition/latest/dg/api-video.html
5644
+ # [2]: https://docs.aws.amazon.com/rekognition/latest/dg/api-video-roles.html#api-video-roles-all-topics
5479
5645
  #
5480
5646
  # @option params [String] :job_tag
5481
5647
  # An identifier returned in the completion status published by your
@@ -5521,6 +5687,12 @@ module Aws::Rekognition
5521
5687
  # left: 1.0,
5522
5688
  # top: 1.0,
5523
5689
  # },
5690
+ # polygon: [
5691
+ # {
5692
+ # x: 1.0,
5693
+ # y: 1.0,
5694
+ # },
5695
+ # ],
5524
5696
  # },
5525
5697
  # ],
5526
5698
  # },
@@ -5709,6 +5881,72 @@ module Aws::Rekognition
5709
5881
  req.send_request(options)
5710
5882
  end
5711
5883
 
5884
+ # Allows you to update a stream processor. You can change some settings
5885
+ # and regions of interest and delete certain parameters.
5886
+ #
5887
+ # @option params [required, String] :name
5888
+ # Name of the stream processor that you want to update.
5889
+ #
5890
+ # @option params [Types::StreamProcessorSettingsForUpdate] :settings_for_update
5891
+ # The stream processor settings that you want to update. Label detection
5892
+ # settings can be updated to detect different labels with a different
5893
+ # minimum confidence.
5894
+ #
5895
+ # @option params [Array<Types::RegionOfInterest>] :regions_of_interest_for_update
5896
+ # Specifies locations in the frames where Amazon Rekognition checks for
5897
+ # objects or people. This is an optional parameter for label detection
5898
+ # stream processors.
5899
+ #
5900
+ # @option params [Types::StreamProcessorDataSharingPreference] :data_sharing_preference_for_update
5901
+ # Shows whether you are sharing data with Rekognition to improve model
5902
+ # performance. You can choose this option at the account level or on a
5903
+ # per-stream basis. Note that if you opt out at the account level this
5904
+ # setting is ignored on individual streams.
5905
+ #
5906
+ # @option params [Array<String>] :parameters_to_delete
5907
+ # A list of parameters you want to delete from the stream processor.
5908
+ #
5909
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
5910
+ #
5911
+ # @example Request syntax with placeholder values
5912
+ #
5913
+ # resp = client.update_stream_processor({
5914
+ # name: "StreamProcessorName", # required
5915
+ # settings_for_update: {
5916
+ # connected_home_for_update: {
5917
+ # labels: ["ConnectedHomeLabel"],
5918
+ # min_confidence: 1.0,
5919
+ # },
5920
+ # },
5921
+ # regions_of_interest_for_update: [
5922
+ # {
5923
+ # bounding_box: {
5924
+ # width: 1.0,
5925
+ # height: 1.0,
5926
+ # left: 1.0,
5927
+ # top: 1.0,
5928
+ # },
5929
+ # polygon: [
5930
+ # {
5931
+ # x: 1.0,
5932
+ # y: 1.0,
5933
+ # },
5934
+ # ],
5935
+ # },
5936
+ # ],
5937
+ # data_sharing_preference_for_update: {
5938
+ # opt_in: false, # required
5939
+ # },
5940
+ # parameters_to_delete: ["ConnectedHomeMinConfidence"], # accepts ConnectedHomeMinConfidence, RegionsOfInterest
5941
+ # })
5942
+ #
5943
+ # @overload update_stream_processor(params = {})
5944
+ # @param [Hash] params ({})
5945
+ def update_stream_processor(params = {}, options = {})
5946
+ req = build_request(:update_stream_processor, params)
5947
+ req.send_request(options)
5948
+ end
5949
+
5712
5950
  # @!endgroup
5713
5951
 
5714
5952
  # @param params ({})
@@ -5722,7 +5960,7 @@ module Aws::Rekognition
5722
5960
  params: params,
5723
5961
  config: config)
5724
5962
  context[:gem_name] = 'aws-sdk-rekognition'
5725
- context[:gem_version] = '1.66.0'
5963
+ context[:gem_version] = '1.67.0'
5726
5964
  Seahorse::Client::Request.new(handlers, context)
5727
5965
  end
5728
5966