aws-sdk-rekognition 1.70.0 → 1.72.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.
@@ -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