@aws-sdk/client-rekognition 3.78.0 → 3.79.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.
Files changed (42) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/README.md +198 -1
  3. package/dist-cjs/Rekognition.js +15 -0
  4. package/dist-cjs/commands/UpdateStreamProcessorCommand.js +36 -0
  5. package/dist-cjs/commands/index.js +1 -0
  6. package/dist-cjs/models/models_0.js +89 -17
  7. package/dist-cjs/protocols/Aws_json1_1.js +291 -3
  8. package/dist-es/Rekognition.js +15 -0
  9. package/dist-es/commands/UpdateStreamProcessorCommand.js +39 -0
  10. package/dist-es/commands/index.js +1 -0
  11. package/dist-es/models/models_0.js +58 -8
  12. package/dist-es/protocols/Aws_json1_1.js +277 -9
  13. package/dist-types/Rekognition.d.ts +247 -24
  14. package/dist-types/RekognitionClient.d.ts +205 -3
  15. package/dist-types/commands/CreateStreamProcessorCommand.d.ts +17 -6
  16. package/dist-types/commands/DeleteCollectionCommand.d.ts +1 -1
  17. package/dist-types/commands/DetectLabelsCommand.d.ts +1 -1
  18. package/dist-types/commands/DetectTextCommand.d.ts +1 -1
  19. package/dist-types/commands/GetCelebrityInfoCommand.d.ts +1 -1
  20. package/dist-types/commands/GetContentModerationCommand.d.ts +1 -1
  21. package/dist-types/commands/GetSegmentDetectionCommand.d.ts +1 -1
  22. package/dist-types/commands/IndexFacesCommand.d.ts +2 -2
  23. package/dist-types/commands/ListCollectionsCommand.d.ts +1 -1
  24. package/dist-types/commands/RecognizeCelebritiesCommand.d.ts +2 -2
  25. package/dist-types/commands/SearchFacesCommand.d.ts +1 -1
  26. package/dist-types/commands/StartCelebrityRecognitionCommand.d.ts +1 -1
  27. package/dist-types/commands/StartContentModerationCommand.d.ts +1 -1
  28. package/dist-types/commands/StartFaceDetectionCommand.d.ts +1 -1
  29. package/dist-types/commands/StartFaceSearchCommand.d.ts +2 -1
  30. package/dist-types/commands/StartSegmentDetectionCommand.d.ts +1 -1
  31. package/dist-types/commands/StartStreamProcessorCommand.d.ts +1 -0
  32. package/dist-types/commands/UpdateStreamProcessorCommand.d.ts +37 -0
  33. package/dist-types/commands/index.d.ts +1 -0
  34. package/dist-types/models/models_0.d.ts +450 -84
  35. package/dist-types/protocols/Aws_json1_1.d.ts +3 -0
  36. package/dist-types/ts3.4/Rekognition.d.ts +5 -0
  37. package/dist-types/ts3.4/RekognitionClient.d.ts +3 -2
  38. package/dist-types/ts3.4/commands/UpdateStreamProcessorCommand.d.ts +17 -0
  39. package/dist-types/ts3.4/commands/index.d.ts +1 -0
  40. package/dist-types/ts3.4/models/models_0.d.ts +165 -21
  41. package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +3 -0
  42. package/package.json +8 -8
@@ -7,15 +7,26 @@ export interface CreateStreamProcessorCommandInput extends CreateStreamProcessor
7
7
  export interface CreateStreamProcessorCommandOutput extends CreateStreamProcessorResponse, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Creates an Amazon Rekognition stream processor that you can use to detect and recognize faces in a streaming video.</p>
11
- * <p>Amazon Rekognition Video is a consumer of live video from Amazon Kinesis Video Streams. Amazon Rekognition Video sends analysis results to Amazon Kinesis Data Streams.</p>
12
- * <p>You provide as input a Kinesis video stream (<code>Input</code>) and a Kinesis data stream (<code>Output</code>) stream. You also specify the
13
- * face recognition criteria in <code>Settings</code>. For example, the collection containing faces that you want to recognize.
10
+ * <p>Creates an Amazon Rekognition stream processor that you can use to detect and recognize faces or to detect labels in a streaming video.</p>
11
+ * <p>Amazon Rekognition Video is a consumer of live video from Amazon Kinesis Video Streams. There are two different settings for stream processors in Amazon Rekognition: detecting faces and detecting labels.</p>
12
+ * <ul>
13
+ * <li>
14
+ * <p>If you are creating a stream processor for detecting faces, you provide as input a Kinesis video stream (<code>Input</code>) and a Kinesis data stream (<code>Output</code>) stream. You also specify the
15
+ * face recognition criteria in <code>Settings</code>. For example, the collection containing faces that you want to recognize. After you have finished analyzing a streaming video, use <a>StopStreamProcessor</a> to
16
+ * stop processing.</p>
17
+ * </li>
18
+ * <li>
19
+ * <p>If you are creating a stream processor to detect labels, you provide as input a Kinesis video stream (<code>Input</code>), Amazon S3 bucket information (<code>Output</code>), and an
20
+ * Amazon SNS topic ARN (<code>NotificationChannel</code>). You can also provide a KMS key ID to encrypt the data sent to your Amazon S3 bucket.
21
+ * You specify what you want to detect in <code>ConnectedHomeSettings</code>, such as people, packages and people, or pets, people, and packages. You can also specify where in the frame you want Amazon Rekognition to monitor with <code>RegionsOfInterest</code>.
22
+ * When you run the <a>StartStreamProcessor</a> operation on a label detection stream processor, you input start and stop information to determine the length of the processing time.</p>
23
+ * </li>
24
+ * </ul>
25
+ *
26
+ * <p>
14
27
  * Use <code>Name</code> to assign an identifier for the stream processor. You use <code>Name</code>
15
28
  * to manage the stream processor. For example, you can start processing the source video by calling <a>StartStreamProcessor</a> with
16
29
  * the <code>Name</code> field. </p>
17
- * <p>After you have finished analyzing a streaming video, use <a>StopStreamProcessor</a> to
18
- * stop processing. You can delete the stream processor by calling <a>DeleteStreamProcessor</a>.</p>
19
30
  * <p>This operation requires permissions to perform the
20
31
  * <code>rekognition:CreateStreamProcessor</code> action. If you want to tag your stream processor, you also require permission to perform the <code>rekognition:TagResource</code> operation.</p>
21
32
  * @example
@@ -8,7 +8,7 @@ export interface DeleteCollectionCommandOutput extends DeleteCollectionResponse,
8
8
  }
9
9
  /**
10
10
  * <p>Deletes the specified collection. Note that this operation
11
- * removes all faces in the collection. For an example, see <a>delete-collection-procedure</a>.</p>
11
+ * removes all faces in the collection. For an example, see <a href="https://docs.aws.amazon.com/rekognition/latest/dg/delete-collection-procedure.html">Deleting a collection</a>.</p>
12
12
  *
13
13
  * <p>This operation requires permissions to perform the
14
14
  * <code>rekognition:DeleteCollection</code> action.</p>
@@ -12,7 +12,7 @@ export interface DetectLabelsCommandOutput extends DetectLabelsResponse, __Metad
12
12
  * wedding, graduation, and birthday party; and concepts like landscape, evening, and nature.
13
13
  * </p>
14
14
  *
15
- * <p>For an example, see Analyzing Images Stored in an Amazon S3 Bucket in the Amazon Rekognition Developer Guide.</p>
15
+ * <p>For an example, see Analyzing images stored in an Amazon S3 bucket in the Amazon Rekognition Developer Guide.</p>
16
16
  * <note>
17
17
  * <p>
18
18
  * <code>DetectLabels</code> does not support the detection of activities. However, activity detection
@@ -28,7 +28,7 @@ export interface DetectTextCommandOutput extends DetectTextResponse, __MetadataB
28
28
  * use the <code>TextDetection</code> object <code>Type</code> field. </p>
29
29
  * <p>To be detected, text must be within +/- 90 degrees orientation of the horizontal axis.</p>
30
30
  *
31
- * <p>For more information, see DetectText in the Amazon Rekognition Developer Guide.</p>
31
+ * <p>For more information, see Detecting text in the Amazon Rekognition Developer Guide.</p>
32
32
  * @example
33
33
  * Use a bare-bones client and the command you need to make an API call.
34
34
  * ```javascript
@@ -11,7 +11,7 @@ export interface GetCelebrityInfoCommandOutput extends GetCelebrityInfoResponse,
11
11
  * The additional information is returned as an array of URLs. If there is no additional
12
12
  * information about the celebrity, this list is empty.</p>
13
13
  *
14
- * <p>For more information, see Recognizing Celebrities in an Image in
14
+ * <p>For more information, see Getting information about a celebrity in
15
15
  * the Amazon Rekognition Developer Guide.</p>
16
16
  * <p>This operation requires permissions to perform the
17
17
  * <code>rekognition:GetCelebrityInfo</code> action. </p>
@@ -36,7 +36,7 @@ export interface GetContentModerationCommandOutput extends GetContentModerationR
36
36
  * and populate the <code>NextToken</code> request parameter with the value of <code>NextToken</code>
37
37
  * returned from the previous call to <code>GetContentModeration</code>.</p>
38
38
  *
39
- * <p>For more information, see Content moderation in the Amazon Rekognition Developer Guide.</p>
39
+ * <p>For more information, see moderating content in the Amazon Rekognition Developer Guide.</p>
40
40
  * @example
41
41
  * Use a bare-bones client and the command you need to make an API call.
42
42
  * ```javascript
@@ -29,7 +29,7 @@ export interface GetSegmentDetectionCommandOutput extends GetSegmentDetectionRes
29
29
  * and populate the <code>NextToken</code> request parameter with the token value returned from the previous
30
30
  * call to <code>GetSegmentDetection</code>.</p>
31
31
  *
32
- * <p>For more information, see Detecting Video Segments in Stored Video in the Amazon Rekognition Developer Guide.</p>
32
+ * <p>For more information, see Detecting video segments in stored video in the Amazon Rekognition Developer Guide.</p>
33
33
  * @example
34
34
  * Use a bare-bones client and the command you need to make an API call.
35
35
  * ```javascript
@@ -15,7 +15,7 @@ export interface IndexFacesCommandOutput extends IndexFacesResponse, __MetadataB
15
15
  * <a>SearchFaces</a> and <a>SearchFacesByImage</a>
16
16
  * operations.</p>
17
17
  *
18
- * <p>For more information, see Adding Faces to a Collection in the Amazon Rekognition
18
+ * <p>For more information, see Adding faces to a collection in the Amazon Rekognition
19
19
  * Developer Guide.</p>
20
20
  * <p>To get the number of faces in a collection, call <a>DescribeCollection</a>. </p>
21
21
  *
@@ -95,7 +95,7 @@ export interface IndexFacesCommandOutput extends IndexFacesResponse, __MetadataB
95
95
  * <p>If you request all facial attributes (by using the <code>detectionAttributes</code>
96
96
  * parameter), Amazon Rekognition returns detailed facial attributes, such as facial landmarks (for
97
97
  * example, location of eye and mouth) and other facial attributes. If you provide
98
- * the same image, specify the same collection, use the same external ID, and use the same model version in the
98
+ * the same image, specify the same collection, and use the same external ID in the
99
99
  * <code>IndexFaces</code> operation, Amazon Rekognition doesn't save duplicate face metadata.</p>
100
100
  *
101
101
  *
@@ -11,7 +11,7 @@ export interface ListCollectionsCommandOutput extends ListCollectionsResponse, _
11
11
  * If the result is truncated, the response also provides a <code>NextToken</code>
12
12
  * that you can use in the subsequent request to fetch the next set of collection IDs.</p>
13
13
  *
14
- * <p>For an example, see Listing Collections in the Amazon Rekognition Developer Guide.</p>
14
+ * <p>For an example, see Listing collections in the Amazon Rekognition Developer Guide.</p>
15
15
  * <p>This operation requires permissions to perform the <code>rekognition:ListCollections</code> action.</p>
16
16
  * @example
17
17
  * Use a bare-bones client and the command you need to make an API call.
@@ -7,7 +7,7 @@ export interface RecognizeCelebritiesCommandInput extends RecognizeCelebritiesRe
7
7
  export interface RecognizeCelebritiesCommandOutput extends RecognizeCelebritiesResponse, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Returns an array of celebrities recognized in the input image. For more information, see Recognizing Celebrities
10
+ * <p>Returns an array of celebrities recognized in the input image. For more information, see Recognizing celebrities
11
11
  * in the Amazon Rekognition Developer Guide. </p>
12
12
  * <p>
13
13
  * <code>RecognizeCelebrities</code> returns the 64 largest faces in the image. It lists the
@@ -35,7 +35,7 @@ export interface RecognizeCelebritiesCommandOutput extends RecognizeCelebritiesR
35
35
  *
36
36
  *
37
37
  *
38
- * <p>For an example, see Recognizing Celebrities in an Image in the Amazon Rekognition Developer Guide.</p>
38
+ * <p>For an example, see Recognizing celebrities in an image in the Amazon Rekognition Developer Guide.</p>
39
39
  * <p>This operation requires permissions to perform the
40
40
  * <code>rekognition:RecognizeCelebrities</code> operation.</p>
41
41
  * @example
@@ -24,7 +24,7 @@ export interface SearchFacesCommandOutput extends SearchFacesResponse, __Metadat
24
24
  * that the specific face matches the input face.
25
25
  * </p>
26
26
  *
27
- * <p>For an example, see Searching for a Face Using Its Face ID in the Amazon Rekognition Developer Guide.</p>
27
+ * <p>For an example, see Searching for a face using its face ID in the Amazon Rekognition Developer Guide.</p>
28
28
  *
29
29
  * <p>This operation requires permissions to perform the <code>rekognition:SearchFaces</code>
30
30
  * action.</p>
@@ -18,7 +18,7 @@ export interface StartCelebrityRecognitionCommandOutput extends StartCelebrityRe
18
18
  * topic is <code>SUCCEEDED</code>. If so, call <a>GetCelebrityRecognition</a> and pass the job identifier
19
19
  * (<code>JobId</code>) from the initial call to <code>StartCelebrityRecognition</code>. </p>
20
20
  *
21
- * <p>For more information, see Recognizing Celebrities in the Amazon Rekognition Developer Guide.</p>
21
+ * <p>For more information, see Recognizing celebrities in the Amazon Rekognition Developer Guide.</p>
22
22
  * @example
23
23
  * Use a bare-bones client and the command you need to make an API call.
24
24
  * ```javascript
@@ -18,7 +18,7 @@ export interface StartContentModerationCommandOutput extends StartContentModerat
18
18
  * topic is <code>SUCCEEDED</code>. If so, call <a>GetContentModeration</a> and pass the job identifier
19
19
  * (<code>JobId</code>) from the initial call to <code>StartContentModeration</code>. </p>
20
20
  *
21
- * <p>For more information, see Content moderation in the Amazon Rekognition Developer Guide.</p>
21
+ * <p>For more information, see Moderating content in the Amazon Rekognition Developer Guide.</p>
22
22
  * @example
23
23
  * Use a bare-bones client and the command you need to make an API call.
24
24
  * ```javascript
@@ -18,7 +18,7 @@ export interface StartFaceDetectionCommandOutput extends StartFaceDetectionRespo
18
18
  * topic is <code>SUCCEEDED</code>. If so, call <a>GetFaceDetection</a> and pass the job identifier
19
19
  * (<code>JobId</code>) from the initial call to <code>StartFaceDetection</code>.</p>
20
20
  *
21
- * <p>For more information, see Detecting Faces in a Stored Video in the
21
+ * <p>For more information, see Detecting faces in a stored video in the
22
22
  * Amazon Rekognition Developer Guide.</p>
23
23
  * @example
24
24
  * Use a bare-bones client and the command you need to make an API call.
@@ -16,7 +16,8 @@ export interface StartFaceSearchCommandOutput extends StartFaceSearchResponse, _
16
16
  * To get the search results, first check that the status value published to the Amazon SNS
17
17
  * topic is <code>SUCCEEDED</code>. If so, call <a>GetFaceSearch</a> and pass the job identifier
18
18
  * (<code>JobId</code>) from the initial call to <code>StartFaceSearch</code>. For more information, see
19
- * <a>procedure-person-search-videos</a>.</p>
19
+ * <a href="https://docs.aws.amazon.com/rekognition/latest/dg/procedure-person-search-videos.html">Searching stored videos for faces</a>.
20
+ * </p>
20
21
  * @example
21
22
  * Use a bare-bones client and the command you need to make an API call.
22
23
  * ```javascript
@@ -22,7 +22,7 @@ export interface StartSegmentDetectionCommandOutput extends StartSegmentDetectio
22
22
  * from the initial call to <code>StartSegmentDetection</code>. </p>
23
23
  *
24
24
  *
25
- * <p>For more information, see Detecting Video Segments in Stored Video in the Amazon Rekognition Developer Guide.</p>
25
+ * <p>For more information, see Detecting video segments in stored video in the Amazon Rekognition Developer Guide.</p>
26
26
  * @example
27
27
  * Use a bare-bones client and the command you need to make an API call.
28
28
  * ```javascript
@@ -10,6 +10,7 @@ export interface StartStreamProcessorCommandOutput extends StartStreamProcessorR
10
10
  * <p>Starts processing a stream processor. You create a stream processor by calling <a>CreateStreamProcessor</a>.
11
11
  * To tell <code>StartStreamProcessor</code> which stream processor to start, use the value of the <code>Name</code> field specified in the call to
12
12
  * <code>CreateStreamProcessor</code>.</p>
13
+ * <p>If you are using a label detection stream processor to detect labels, you need to provide a <code>Start selector</code> and a <code>Stop selector</code> to determine the length of the stream processing time.</p>
13
14
  * @example
14
15
  * Use a bare-bones client and the command you need to make an API call.
15
16
  * ```javascript
@@ -0,0 +1,37 @@
1
+ import { Command as $Command } from "@aws-sdk/smithy-client";
2
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
3
+ import { UpdateStreamProcessorRequest, UpdateStreamProcessorResponse } from "../models/models_0";
4
+ import { RekognitionClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RekognitionClient";
5
+ export interface UpdateStreamProcessorCommandInput extends UpdateStreamProcessorRequest {
6
+ }
7
+ export interface UpdateStreamProcessorCommandOutput extends UpdateStreamProcessorResponse, __MetadataBearer {
8
+ }
9
+ /**
10
+ * <p>
11
+ * Allows you to update a stream processor. You can change some settings and regions of interest and delete certain parameters.
12
+ * </p>
13
+ * @example
14
+ * Use a bare-bones client and the command you need to make an API call.
15
+ * ```javascript
16
+ * import { RekognitionClient, UpdateStreamProcessorCommand } from "@aws-sdk/client-rekognition"; // ES Modules import
17
+ * // const { RekognitionClient, UpdateStreamProcessorCommand } = require("@aws-sdk/client-rekognition"); // CommonJS import
18
+ * const client = new RekognitionClient(config);
19
+ * const command = new UpdateStreamProcessorCommand(input);
20
+ * const response = await client.send(command);
21
+ * ```
22
+ *
23
+ * @see {@link UpdateStreamProcessorCommandInput} for command's `input` shape.
24
+ * @see {@link UpdateStreamProcessorCommandOutput} for command's `response` shape.
25
+ * @see {@link RekognitionClientResolvedConfig | config} for RekognitionClient's `config` shape.
26
+ *
27
+ */
28
+ export declare class UpdateStreamProcessorCommand extends $Command<UpdateStreamProcessorCommandInput, UpdateStreamProcessorCommandOutput, RekognitionClientResolvedConfig> {
29
+ readonly input: UpdateStreamProcessorCommandInput;
30
+ constructor(input: UpdateStreamProcessorCommandInput);
31
+ /**
32
+ * @internal
33
+ */
34
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: RekognitionClientResolvedConfig, options?: __HttpHandlerOptions): Handler<UpdateStreamProcessorCommandInput, UpdateStreamProcessorCommandOutput>;
35
+ private serialize;
36
+ private deserialize;
37
+ }
@@ -56,3 +56,4 @@ export * from "./StopStreamProcessorCommand";
56
56
  export * from "./TagResourceCommand";
57
57
  export * from "./UntagResourceCommand";
58
58
  export * from "./UpdateDatasetEntriesCommand";
59
+ export * from "./UpdateStreamProcessorCommand";