aws-sdk-rekognition 1.66.0 → 1.67.0

Sign up to get free protection for your applications and to get access to all the features.
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