aws-sdk-rekognition 1.70.0 → 1.72.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,194 @@
1
+ # frozen_string_literal: true
2
+
3
+ # WARNING ABOUT GENERATED CODE
4
+ #
5
+ # This file is generated. See the contributing guide for more information:
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
+ #
8
+ # WARNING ABOUT GENERATED CODE
9
+
10
+
11
+ module Aws::Rekognition
12
+ module Plugins
13
+ class Endpoints < Seahorse::Client::Plugin
14
+ option(
15
+ :endpoint_provider,
16
+ doc_type: 'Aws::Rekognition::EndpointProvider',
17
+ docstring: 'The endpoint provider used to resolve endpoints. Any '\
18
+ 'object that responds to `#resolve_endpoint(parameters)` '\
19
+ 'where `parameters` is a Struct similar to '\
20
+ '`Aws::Rekognition::EndpointParameters`'
21
+ ) do |cfg|
22
+ Aws::Rekognition::EndpointProvider.new
23
+ end
24
+
25
+ # @api private
26
+ class Handler < Seahorse::Client::Handler
27
+ def call(context)
28
+ # If endpoint was discovered, do not resolve or apply the endpoint.
29
+ unless context[:discovered_endpoint]
30
+ params = parameters_for_operation(context)
31
+ endpoint = context.config.endpoint_provider.resolve_endpoint(params)
32
+
33
+ context.http_request.endpoint = endpoint.url
34
+ apply_endpoint_headers(context, endpoint.headers)
35
+ end
36
+
37
+ context[:endpoint_params] = params
38
+ context[:auth_scheme] =
39
+ Aws::Endpoints.resolve_auth_scheme(context, endpoint)
40
+
41
+ @handler.call(context)
42
+ end
43
+
44
+ private
45
+
46
+ def apply_endpoint_headers(context, headers)
47
+ headers.each do |key, values|
48
+ value = values
49
+ .compact
50
+ .map { |s| Seahorse::Util.escape_header_list_string(s.to_s) }
51
+ .join(',')
52
+
53
+ context.http_request.headers[key] = value
54
+ end
55
+ end
56
+
57
+ def parameters_for_operation(context)
58
+ case context.operation_name
59
+ when :compare_faces
60
+ Aws::Rekognition::Endpoints::CompareFaces.build(context)
61
+ when :copy_project_version
62
+ Aws::Rekognition::Endpoints::CopyProjectVersion.build(context)
63
+ when :create_collection
64
+ Aws::Rekognition::Endpoints::CreateCollection.build(context)
65
+ when :create_dataset
66
+ Aws::Rekognition::Endpoints::CreateDataset.build(context)
67
+ when :create_project
68
+ Aws::Rekognition::Endpoints::CreateProject.build(context)
69
+ when :create_project_version
70
+ Aws::Rekognition::Endpoints::CreateProjectVersion.build(context)
71
+ when :create_stream_processor
72
+ Aws::Rekognition::Endpoints::CreateStreamProcessor.build(context)
73
+ when :delete_collection
74
+ Aws::Rekognition::Endpoints::DeleteCollection.build(context)
75
+ when :delete_dataset
76
+ Aws::Rekognition::Endpoints::DeleteDataset.build(context)
77
+ when :delete_faces
78
+ Aws::Rekognition::Endpoints::DeleteFaces.build(context)
79
+ when :delete_project
80
+ Aws::Rekognition::Endpoints::DeleteProject.build(context)
81
+ when :delete_project_policy
82
+ Aws::Rekognition::Endpoints::DeleteProjectPolicy.build(context)
83
+ when :delete_project_version
84
+ Aws::Rekognition::Endpoints::DeleteProjectVersion.build(context)
85
+ when :delete_stream_processor
86
+ Aws::Rekognition::Endpoints::DeleteStreamProcessor.build(context)
87
+ when :describe_collection
88
+ Aws::Rekognition::Endpoints::DescribeCollection.build(context)
89
+ when :describe_dataset
90
+ Aws::Rekognition::Endpoints::DescribeDataset.build(context)
91
+ when :describe_project_versions
92
+ Aws::Rekognition::Endpoints::DescribeProjectVersions.build(context)
93
+ when :describe_projects
94
+ Aws::Rekognition::Endpoints::DescribeProjects.build(context)
95
+ when :describe_stream_processor
96
+ Aws::Rekognition::Endpoints::DescribeStreamProcessor.build(context)
97
+ when :detect_custom_labels
98
+ Aws::Rekognition::Endpoints::DetectCustomLabels.build(context)
99
+ when :detect_faces
100
+ Aws::Rekognition::Endpoints::DetectFaces.build(context)
101
+ when :detect_labels
102
+ Aws::Rekognition::Endpoints::DetectLabels.build(context)
103
+ when :detect_moderation_labels
104
+ Aws::Rekognition::Endpoints::DetectModerationLabels.build(context)
105
+ when :detect_protective_equipment
106
+ Aws::Rekognition::Endpoints::DetectProtectiveEquipment.build(context)
107
+ when :detect_text
108
+ Aws::Rekognition::Endpoints::DetectText.build(context)
109
+ when :distribute_dataset_entries
110
+ Aws::Rekognition::Endpoints::DistributeDatasetEntries.build(context)
111
+ when :get_celebrity_info
112
+ Aws::Rekognition::Endpoints::GetCelebrityInfo.build(context)
113
+ when :get_celebrity_recognition
114
+ Aws::Rekognition::Endpoints::GetCelebrityRecognition.build(context)
115
+ when :get_content_moderation
116
+ Aws::Rekognition::Endpoints::GetContentModeration.build(context)
117
+ when :get_face_detection
118
+ Aws::Rekognition::Endpoints::GetFaceDetection.build(context)
119
+ when :get_face_search
120
+ Aws::Rekognition::Endpoints::GetFaceSearch.build(context)
121
+ when :get_label_detection
122
+ Aws::Rekognition::Endpoints::GetLabelDetection.build(context)
123
+ when :get_person_tracking
124
+ Aws::Rekognition::Endpoints::GetPersonTracking.build(context)
125
+ when :get_segment_detection
126
+ Aws::Rekognition::Endpoints::GetSegmentDetection.build(context)
127
+ when :get_text_detection
128
+ Aws::Rekognition::Endpoints::GetTextDetection.build(context)
129
+ when :index_faces
130
+ Aws::Rekognition::Endpoints::IndexFaces.build(context)
131
+ when :list_collections
132
+ Aws::Rekognition::Endpoints::ListCollections.build(context)
133
+ when :list_dataset_entries
134
+ Aws::Rekognition::Endpoints::ListDatasetEntries.build(context)
135
+ when :list_dataset_labels
136
+ Aws::Rekognition::Endpoints::ListDatasetLabels.build(context)
137
+ when :list_faces
138
+ Aws::Rekognition::Endpoints::ListFaces.build(context)
139
+ when :list_project_policies
140
+ Aws::Rekognition::Endpoints::ListProjectPolicies.build(context)
141
+ when :list_stream_processors
142
+ Aws::Rekognition::Endpoints::ListStreamProcessors.build(context)
143
+ when :list_tags_for_resource
144
+ Aws::Rekognition::Endpoints::ListTagsForResource.build(context)
145
+ when :put_project_policy
146
+ Aws::Rekognition::Endpoints::PutProjectPolicy.build(context)
147
+ when :recognize_celebrities
148
+ Aws::Rekognition::Endpoints::RecognizeCelebrities.build(context)
149
+ when :search_faces
150
+ Aws::Rekognition::Endpoints::SearchFaces.build(context)
151
+ when :search_faces_by_image
152
+ Aws::Rekognition::Endpoints::SearchFacesByImage.build(context)
153
+ when :start_celebrity_recognition
154
+ Aws::Rekognition::Endpoints::StartCelebrityRecognition.build(context)
155
+ when :start_content_moderation
156
+ Aws::Rekognition::Endpoints::StartContentModeration.build(context)
157
+ when :start_face_detection
158
+ Aws::Rekognition::Endpoints::StartFaceDetection.build(context)
159
+ when :start_face_search
160
+ Aws::Rekognition::Endpoints::StartFaceSearch.build(context)
161
+ when :start_label_detection
162
+ Aws::Rekognition::Endpoints::StartLabelDetection.build(context)
163
+ when :start_person_tracking
164
+ Aws::Rekognition::Endpoints::StartPersonTracking.build(context)
165
+ when :start_project_version
166
+ Aws::Rekognition::Endpoints::StartProjectVersion.build(context)
167
+ when :start_segment_detection
168
+ Aws::Rekognition::Endpoints::StartSegmentDetection.build(context)
169
+ when :start_stream_processor
170
+ Aws::Rekognition::Endpoints::StartStreamProcessor.build(context)
171
+ when :start_text_detection
172
+ Aws::Rekognition::Endpoints::StartTextDetection.build(context)
173
+ when :stop_project_version
174
+ Aws::Rekognition::Endpoints::StopProjectVersion.build(context)
175
+ when :stop_stream_processor
176
+ Aws::Rekognition::Endpoints::StopStreamProcessor.build(context)
177
+ when :tag_resource
178
+ Aws::Rekognition::Endpoints::TagResource.build(context)
179
+ when :untag_resource
180
+ Aws::Rekognition::Endpoints::UntagResource.build(context)
181
+ when :update_dataset_entries
182
+ Aws::Rekognition::Endpoints::UpdateDatasetEntries.build(context)
183
+ when :update_stream_processor
184
+ Aws::Rekognition::Endpoints::UpdateStreamProcessor.build(context)
185
+ end
186
+ end
187
+ end
188
+
189
+ def add_handlers(handlers, _config)
190
+ handlers.add(Handler, step: :build, priority: 75)
191
+ end
192
+ end
193
+ end
194
+ end
@@ -316,7 +316,9 @@ module Aws::Rekognition
316
316
  #
317
317
  # @!attribute [rw] timestamp
318
318
  # The time, in milliseconds from the start of the video, that the
319
- # celebrity was recognized.
319
+ # celebrity was recognized. Note that `Timestamp` is not guaranteed to
320
+ # be accurate to the individual frame where the celebrity first
321
+ # appears.
320
322
  # @return [Integer]
321
323
  #
322
324
  # @!attribute [rw] celebrity
@@ -629,7 +631,9 @@ module Aws::Rekognition
629
631
  #
630
632
  # @!attribute [rw] timestamp
631
633
  # Time, in milliseconds from the beginning of the video, that the
632
- # content moderation label was detected.
634
+ # content moderation label was detected. Note that `Timestamp` is not
635
+ # guaranteed to be accurate to the individual frame where the
636
+ # moderated content first appears.
633
637
  # @return [Integer]
634
638
  #
635
639
  # @!attribute [rw] moderation_label
@@ -2096,6 +2100,131 @@ module Aws::Rekognition
2096
2100
  include Aws::Structure
2097
2101
  end
2098
2102
 
2103
+ # The background of the image with regard to image quality and dominant
2104
+ # colors.
2105
+ #
2106
+ # @!attribute [rw] quality
2107
+ # The quality of the image background as defined by brightness and
2108
+ # sharpness.
2109
+ # @return [Types::DetectLabelsImageQuality]
2110
+ #
2111
+ # @!attribute [rw] dominant_colors
2112
+ # The dominant colors found in the background of an image, defined
2113
+ # with RGB values, CSS color name, simplified color name, and
2114
+ # PixelPercentage (the percentage of image pixels that have a
2115
+ # particular color).
2116
+ # @return [Array<Types::DominantColor>]
2117
+ #
2118
+ class DetectLabelsImageBackground < Struct.new(
2119
+ :quality,
2120
+ :dominant_colors)
2121
+ SENSITIVE = []
2122
+ include Aws::Structure
2123
+ end
2124
+
2125
+ # The foreground of the image with regard to image quality and dominant
2126
+ # colors.
2127
+ #
2128
+ # @!attribute [rw] quality
2129
+ # The quality of the image foreground as defined by brightness and
2130
+ # sharpness.
2131
+ # @return [Types::DetectLabelsImageQuality]
2132
+ #
2133
+ # @!attribute [rw] dominant_colors
2134
+ # The dominant colors found in the foreground of an image, defined
2135
+ # with RGB values, CSS color name, simplified color name, and
2136
+ # PixelPercentage (the percentage of image pixels that have a
2137
+ # particular color).
2138
+ # @return [Array<Types::DominantColor>]
2139
+ #
2140
+ class DetectLabelsImageForeground < Struct.new(
2141
+ :quality,
2142
+ :dominant_colors)
2143
+ SENSITIVE = []
2144
+ include Aws::Structure
2145
+ end
2146
+
2147
+ # Information about the quality and dominant colors of an input image.
2148
+ # Quality and color information is returned for the entire image,
2149
+ # foreground, and background.
2150
+ #
2151
+ # @!attribute [rw] quality
2152
+ # Information about the quality of the image foreground as defined by
2153
+ # brightness, sharpness, and contrast. The higher the value the
2154
+ # greater the brightness, sharpness, and contrast respectively.
2155
+ # @return [Types::DetectLabelsImageQuality]
2156
+ #
2157
+ # @!attribute [rw] dominant_colors
2158
+ # Information about the dominant colors found in an image, described
2159
+ # with RGB values, CSS color name, simplified color name, and
2160
+ # PixelPercentage (the percentage of image pixels that have a
2161
+ # particular color).
2162
+ # @return [Array<Types::DominantColor>]
2163
+ #
2164
+ # @!attribute [rw] foreground
2165
+ # Information about the properties of an image’s foreground, including
2166
+ # the foreground’s quality and dominant colors, including the quality
2167
+ # and dominant colors of the image.
2168
+ # @return [Types::DetectLabelsImageForeground]
2169
+ #
2170
+ # @!attribute [rw] background
2171
+ # Information about the properties of an image’s background, including
2172
+ # the background’s quality and dominant colors, including the quality
2173
+ # and dominant colors of the image.
2174
+ # @return [Types::DetectLabelsImageBackground]
2175
+ #
2176
+ class DetectLabelsImageProperties < Struct.new(
2177
+ :quality,
2178
+ :dominant_colors,
2179
+ :foreground,
2180
+ :background)
2181
+ SENSITIVE = []
2182
+ include Aws::Structure
2183
+ end
2184
+
2185
+ # Settings for the IMAGE\_PROPERTIES feature type.
2186
+ #
2187
+ # @note When making an API call, you may pass DetectLabelsImagePropertiesSettings
2188
+ # data as a hash:
2189
+ #
2190
+ # {
2191
+ # max_dominant_colors: 1,
2192
+ # }
2193
+ #
2194
+ # @!attribute [rw] max_dominant_colors
2195
+ # The maximum number of dominant colors to return when detecting
2196
+ # labels in an image. The default value is 10.
2197
+ # @return [Integer]
2198
+ #
2199
+ class DetectLabelsImagePropertiesSettings < Struct.new(
2200
+ :max_dominant_colors)
2201
+ SENSITIVE = []
2202
+ include Aws::Structure
2203
+ end
2204
+
2205
+ # The quality of an image provided for label detection, with regard to
2206
+ # brightness, sharpness, and contrast.
2207
+ #
2208
+ # @!attribute [rw] brightness
2209
+ # The brightness of an image provided for label detection.
2210
+ # @return [Float]
2211
+ #
2212
+ # @!attribute [rw] sharpness
2213
+ # The sharpness of an image provided for label detection.
2214
+ # @return [Float]
2215
+ #
2216
+ # @!attribute [rw] contrast
2217
+ # The contrast of an image provided for label detection.
2218
+ # @return [Float]
2219
+ #
2220
+ class DetectLabelsImageQuality < Struct.new(
2221
+ :brightness,
2222
+ :sharpness,
2223
+ :contrast)
2224
+ SENSITIVE = []
2225
+ include Aws::Structure
2226
+ end
2227
+
2099
2228
  # @note When making an API call, you may pass DetectLabelsRequest
2100
2229
  # data as a hash:
2101
2230
  #
@@ -2110,6 +2239,18 @@ module Aws::Rekognition
2110
2239
  # },
2111
2240
  # max_labels: 1,
2112
2241
  # min_confidence: 1.0,
2242
+ # features: ["GENERAL_LABELS"], # accepts GENERAL_LABELS, IMAGE_PROPERTIES
2243
+ # settings: {
2244
+ # general_labels: {
2245
+ # label_inclusion_filters: ["GeneralLabelsFilterValue"],
2246
+ # label_exclusion_filters: ["GeneralLabelsFilterValue"],
2247
+ # label_category_inclusion_filters: ["GeneralLabelsFilterValue"],
2248
+ # label_category_exclusion_filters: ["GeneralLabelsFilterValue"],
2249
+ # },
2250
+ # image_properties: {
2251
+ # max_dominant_colors: 1,
2252
+ # },
2253
+ # },
2113
2254
  # }
2114
2255
  #
2115
2256
  # @!attribute [rw] image
@@ -2139,10 +2280,29 @@ module Aws::Rekognition
2139
2280
  # with a confidence values greater than or equal to 55 percent.
2140
2281
  # @return [Float]
2141
2282
  #
2283
+ # @!attribute [rw] features
2284
+ # A list of the types of analysis to perform. Specifying
2285
+ # GENERAL\_LABELS uses the label detection feature, while specifying
2286
+ # IMAGE\_PROPERTIES returns information regarding image color and
2287
+ # quality. If no option is specified GENERAL\_LABELS is used by
2288
+ # default.
2289
+ # @return [Array<String>]
2290
+ #
2291
+ # @!attribute [rw] settings
2292
+ # A list of the filters to be applied to returned detected labels and
2293
+ # image properties. Specified filters can be inclusive, exclusive, or
2294
+ # a combination of both. Filters can be used for individual labels or
2295
+ # label categories. The exact label names or label categories must be
2296
+ # supplied. For a full list of labels and label categories, see LINK
2297
+ # HERE.
2298
+ # @return [Types::DetectLabelsSettings]
2299
+ #
2142
2300
  class DetectLabelsRequest < Struct.new(
2143
2301
  :image,
2144
2302
  :max_labels,
2145
- :min_confidence)
2303
+ :min_confidence,
2304
+ :features,
2305
+ :settings)
2146
2306
  SENSITIVE = []
2147
2307
  include Aws::Structure
2148
2308
  end
@@ -2173,10 +2333,52 @@ module Aws::Rekognition
2173
2333
  # labels.
2174
2334
  # @return [String]
2175
2335
  #
2336
+ # @!attribute [rw] image_properties
2337
+ # Information about the properties of the input image, such as
2338
+ # brightness, sharpness, contrast, and dominant colors.
2339
+ # @return [Types::DetectLabelsImageProperties]
2340
+ #
2176
2341
  class DetectLabelsResponse < Struct.new(
2177
2342
  :labels,
2178
2343
  :orientation_correction,
2179
- :label_model_version)
2344
+ :label_model_version,
2345
+ :image_properties)
2346
+ SENSITIVE = []
2347
+ include Aws::Structure
2348
+ end
2349
+
2350
+ # Settings for the DetectLabels request. Settings can include filters
2351
+ # for both GENERAL\_LABELS and IMAGE\_PROPERTIES. GENERAL\_LABELS
2352
+ # filters can be inclusive or exclusive and applied to individual labels
2353
+ # or label categories. IMAGE\_PROPERTIES filters allow specification of
2354
+ # a maximum number of dominant colors.
2355
+ #
2356
+ # @note When making an API call, you may pass DetectLabelsSettings
2357
+ # data as a hash:
2358
+ #
2359
+ # {
2360
+ # general_labels: {
2361
+ # label_inclusion_filters: ["GeneralLabelsFilterValue"],
2362
+ # label_exclusion_filters: ["GeneralLabelsFilterValue"],
2363
+ # label_category_inclusion_filters: ["GeneralLabelsFilterValue"],
2364
+ # label_category_exclusion_filters: ["GeneralLabelsFilterValue"],
2365
+ # },
2366
+ # image_properties: {
2367
+ # max_dominant_colors: 1,
2368
+ # },
2369
+ # }
2370
+ #
2371
+ # @!attribute [rw] general_labels
2372
+ # Contains the specified filters for GENERAL\_LABELS.
2373
+ # @return [Types::GeneralLabelsSettings]
2374
+ #
2375
+ # @!attribute [rw] image_properties
2376
+ # Contains the chosen number of maximum dominant colors in an image.
2377
+ # @return [Types::DetectLabelsImagePropertiesSettings]
2378
+ #
2379
+ class DetectLabelsSettings < Struct.new(
2380
+ :general_labels,
2381
+ :image_properties)
2180
2382
  SENSITIVE = []
2181
2383
  include Aws::Structure
2182
2384
  end
@@ -2523,6 +2725,48 @@ module Aws::Rekognition
2523
2725
 
2524
2726
  class DistributeDatasetEntriesResponse < Aws::EmptyStructure; end
2525
2727
 
2728
+ # A description of the dominant colors in an image.
2729
+ #
2730
+ # @!attribute [rw] red
2731
+ # The Red RGB value for a dominant color.
2732
+ # @return [Integer]
2733
+ #
2734
+ # @!attribute [rw] blue
2735
+ # The Blue RGB value for a dominant color.
2736
+ # @return [Integer]
2737
+ #
2738
+ # @!attribute [rw] green
2739
+ # The Green RGB value for a dominant color.
2740
+ # @return [Integer]
2741
+ #
2742
+ # @!attribute [rw] hex_code
2743
+ # The Hex code equivalent of the RGB values for a dominant color.
2744
+ # @return [String]
2745
+ #
2746
+ # @!attribute [rw] css_color
2747
+ # The CSS color name of a dominant color.
2748
+ # @return [String]
2749
+ #
2750
+ # @!attribute [rw] simplified_color
2751
+ # One of 12 simplified color names applied to a dominant color.
2752
+ # @return [String]
2753
+ #
2754
+ # @!attribute [rw] pixel_percent
2755
+ # The percentage of image pixels that have a given dominant color.
2756
+ # @return [Float]
2757
+ #
2758
+ class DominantColor < Struct.new(
2759
+ :red,
2760
+ :blue,
2761
+ :green,
2762
+ :hex_code,
2763
+ :css_color,
2764
+ :simplified_color,
2765
+ :pixel_percent)
2766
+ SENSITIVE = []
2767
+ include Aws::Structure
2768
+ end
2769
+
2526
2770
  # The emotions that appear to be expressed on the face, and the
2527
2771
  # confidence level in the determination. The API is only making a
2528
2772
  # determination of the physical appearance of a person's face. It is
@@ -2799,7 +3043,8 @@ module Aws::Rekognition
2799
3043
  #
2800
3044
  # @!attribute [rw] timestamp
2801
3045
  # Time, in milliseconds from the start of the video, that the face was
2802
- # detected.
3046
+ # detected. Note that `Timestamp` is not guaranteed to be accurate to
3047
+ # the individual frame where the face first appears.
2803
3048
  # @return [Integer]
2804
3049
  #
2805
3050
  # @!attribute [rw] face
@@ -2920,6 +3165,48 @@ module Aws::Rekognition
2920
3165
  include Aws::Structure
2921
3166
  end
2922
3167
 
3168
+ # Contains filters for the object labels returned by DetectLabels.
3169
+ # Filters can be inclusive, exclusive, or a combination of both and can
3170
+ # be applied to individual l abels or entire label categories.
3171
+ #
3172
+ # @note When making an API call, you may pass GeneralLabelsSettings
3173
+ # data as a hash:
3174
+ #
3175
+ # {
3176
+ # label_inclusion_filters: ["GeneralLabelsFilterValue"],
3177
+ # label_exclusion_filters: ["GeneralLabelsFilterValue"],
3178
+ # label_category_inclusion_filters: ["GeneralLabelsFilterValue"],
3179
+ # label_category_exclusion_filters: ["GeneralLabelsFilterValue"],
3180
+ # }
3181
+ #
3182
+ # @!attribute [rw] label_inclusion_filters
3183
+ # The labels that should be included in the return from DetectLabels.
3184
+ # @return [Array<String>]
3185
+ #
3186
+ # @!attribute [rw] label_exclusion_filters
3187
+ # The labels that should be excluded from the return from
3188
+ # DetectLabels.
3189
+ # @return [Array<String>]
3190
+ #
3191
+ # @!attribute [rw] label_category_inclusion_filters
3192
+ # The label categories that should be included in the return from
3193
+ # DetectLabels.
3194
+ # @return [Array<String>]
3195
+ #
3196
+ # @!attribute [rw] label_category_exclusion_filters
3197
+ # The label categories that should be excluded from the return from
3198
+ # DetectLabels.
3199
+ # @return [Array<String>]
3200
+ #
3201
+ class GeneralLabelsSettings < Struct.new(
3202
+ :label_inclusion_filters,
3203
+ :label_exclusion_filters,
3204
+ :label_category_inclusion_filters,
3205
+ :label_category_exclusion_filters)
3206
+ SENSITIVE = []
3207
+ include Aws::Structure
3208
+ end
3209
+
2923
3210
  # Information about where an object (DetectCustomLabels) or text
2924
3211
  # (DetectText) is located on an image.
2925
3212
  #
@@ -4052,9 +4339,14 @@ module Aws::Rekognition
4052
4339
  # bounding box.
4053
4340
  # @return [Float]
4054
4341
  #
4342
+ # @!attribute [rw] dominant_colors
4343
+ # The dominant colors found in an individual instance of a label.
4344
+ # @return [Array<Types::DominantColor>]
4345
+ #
4055
4346
  class Instance < Struct.new(
4056
4347
  :bounding_box,
4057
- :confidence)
4348
+ :confidence,
4349
+ :dominant_colors)
4058
4350
  SENSITIVE = []
4059
4351
  include Aws::Structure
4060
4352
  end
@@ -4130,8 +4422,10 @@ module Aws::Rekognition
4130
4422
  end
4131
4423
 
4132
4424
  # Specifies the starting point in a Kinesis stream to start processing.
4133
- # You can use the producer timestamp or the fragment number. For more
4134
- # information, see [Fragment][1].
4425
+ # You can use the producer timestamp or the fragment number. One of
4426
+ # either producer timestamp or fragment number is required. If you use
4427
+ # the producer timestamp, you must put the time in milliseconds. For
4428
+ # more information about fragment numbers, see [Fragment][1].
4135
4429
  #
4136
4430
  #
4137
4431
  #
@@ -4146,7 +4440,8 @@ module Aws::Rekognition
4146
4440
  # }
4147
4441
  #
4148
4442
  # @!attribute [rw] producer_timestamp
4149
- # The timestamp from the producer corresponding to the fragment.
4443
+ # The timestamp from the producer corresponding to the fragment, in
4444
+ # milliseconds, expressed in unix time format.
4150
4445
  # @return [Integer]
4151
4446
  #
4152
4447
  # @!attribute [rw] fragment_number
@@ -4198,11 +4493,45 @@ module Aws::Rekognition
4198
4493
  # labels.
4199
4494
  # @return [Array<Types::Parent>]
4200
4495
  #
4496
+ # @!attribute [rw] aliases
4497
+ # A list of potential aliases for a given label.
4498
+ # @return [Array<Types::LabelAlias>]
4499
+ #
4500
+ # @!attribute [rw] categories
4501
+ # A list of the categories associated with a given label.
4502
+ # @return [Array<Types::LabelCategory>]
4503
+ #
4201
4504
  class Label < Struct.new(
4202
4505
  :name,
4203
4506
  :confidence,
4204
4507
  :instances,
4205
- :parents)
4508
+ :parents,
4509
+ :aliases,
4510
+ :categories)
4511
+ SENSITIVE = []
4512
+ include Aws::Structure
4513
+ end
4514
+
4515
+ # A potential alias of for a given label.
4516
+ #
4517
+ # @!attribute [rw] name
4518
+ # The name of an alias for a given label.
4519
+ # @return [String]
4520
+ #
4521
+ class LabelAlias < Struct.new(
4522
+ :name)
4523
+ SENSITIVE = []
4524
+ include Aws::Structure
4525
+ end
4526
+
4527
+ # The category that applies to a given label.
4528
+ #
4529
+ # @!attribute [rw] name
4530
+ # The name of a category that applies to a given label.
4531
+ # @return [String]
4532
+ #
4533
+ class LabelCategory < Struct.new(
4534
+ :name)
4206
4535
  SENSITIVE = []
4207
4536
  include Aws::Structure
4208
4537
  end
@@ -4212,7 +4541,8 @@ module Aws::Rekognition
4212
4541
  #
4213
4542
  # @!attribute [rw] timestamp
4214
4543
  # Time, in milliseconds from the start of the video, that the label
4215
- # was detected.
4544
+ # was detected. Note that `Timestamp` is not guaranteed to be accurate
4545
+ # to the individual frame where the label first appears.
4216
4546
  # @return [Integer]
4217
4547
  #
4218
4548
  # @!attribute [rw] label
@@ -4816,7 +5146,9 @@ module Aws::Rekognition
4816
5146
  #
4817
5147
  # @!attribute [rw] timestamp
4818
5148
  # The time, in milliseconds from the start of the video, that the
4819
- # person's path was tracked.
5149
+ # person's path was tracked. Note that `Timestamp` is not guaranteed
5150
+ # to be accurate to the individual frame where the person's path
5151
+ # first appears.
4820
5152
  # @return [Integer]
4821
5153
  #
4822
5154
  # @!attribute [rw] person
@@ -6487,7 +6819,9 @@ module Aws::Rekognition
6487
6819
  # @!attribute [rw] start_selector
6488
6820
  # Specifies the starting point in the Kinesis stream to start
6489
6821
  # processing. You can use the producer timestamp or the fragment
6490
- # number. For more information, see [Fragment][1].
6822
+ # number. If you use the producer timestamp, you must put the time in
6823
+ # milliseconds. For more information about fragment numbers, see
6824
+ # [Fragment][1].
6491
6825
  #
6492
6826
  # This is a required parameter for label detection stream processors
6493
6827
  # and should not be used to start a face search stream processor.
@@ -6769,6 +7103,9 @@ module Aws::Rekognition
6769
7103
 
6770
7104
  class StopStreamProcessorResponse < Aws::EmptyStructure; end
6771
7105
 
7106
+ # This is a required parameter for label detection stream processors and
7107
+ # should not be used to start a face search stream processor.
7108
+ #
6772
7109
  # @note When making an API call, you may pass StreamProcessingStartSelector
6773
7110
  # data as a hash:
6774
7111
  #
@@ -6781,8 +7118,8 @@ module Aws::Rekognition
6781
7118
  #
6782
7119
  # @!attribute [rw] kvs_stream_start_selector
6783
7120
  # Specifies the starting point in the stream to start processing. This
6784
- # can be done with a timestamp or a fragment number in a Kinesis
6785
- # stream.
7121
+ # can be done with a producer timestamp or a fragment number in a
7122
+ # Kinesis stream.
6786
7123
  # @return [Types::KinesisVideoStreamStartSelector]
6787
7124
  #
6788
7125
  class StreamProcessingStartSelector < Struct.new(
@@ -7235,7 +7572,8 @@ module Aws::Rekognition
7235
7572
  #
7236
7573
  # @!attribute [rw] timestamp
7237
7574
  # The time, in milliseconds from the start of the video, that the text
7238
- # was detected.
7575
+ # was detected. Note that `Timestamp` is not guaranteed to be accurate
7576
+ # to the individual frame where the text first appears.
7239
7577
  # @return [Integer]
7240
7578
  #
7241
7579
  # @!attribute [rw] text_detection