@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.
- package/CHANGELOG.md +11 -0
- package/README.md +198 -1
- package/dist-cjs/Rekognition.js +15 -0
- package/dist-cjs/commands/UpdateStreamProcessorCommand.js +36 -0
- package/dist-cjs/commands/index.js +1 -0
- package/dist-cjs/models/models_0.js +89 -17
- package/dist-cjs/protocols/Aws_json1_1.js +291 -3
- package/dist-es/Rekognition.js +15 -0
- package/dist-es/commands/UpdateStreamProcessorCommand.js +39 -0
- package/dist-es/commands/index.js +1 -0
- package/dist-es/models/models_0.js +58 -8
- package/dist-es/protocols/Aws_json1_1.js +277 -9
- package/dist-types/Rekognition.d.ts +247 -24
- package/dist-types/RekognitionClient.d.ts +205 -3
- package/dist-types/commands/CreateStreamProcessorCommand.d.ts +17 -6
- package/dist-types/commands/DeleteCollectionCommand.d.ts +1 -1
- package/dist-types/commands/DetectLabelsCommand.d.ts +1 -1
- package/dist-types/commands/DetectTextCommand.d.ts +1 -1
- package/dist-types/commands/GetCelebrityInfoCommand.d.ts +1 -1
- package/dist-types/commands/GetContentModerationCommand.d.ts +1 -1
- package/dist-types/commands/GetSegmentDetectionCommand.d.ts +1 -1
- package/dist-types/commands/IndexFacesCommand.d.ts +2 -2
- package/dist-types/commands/ListCollectionsCommand.d.ts +1 -1
- package/dist-types/commands/RecognizeCelebritiesCommand.d.ts +2 -2
- package/dist-types/commands/SearchFacesCommand.d.ts +1 -1
- package/dist-types/commands/StartCelebrityRecognitionCommand.d.ts +1 -1
- package/dist-types/commands/StartContentModerationCommand.d.ts +1 -1
- package/dist-types/commands/StartFaceDetectionCommand.d.ts +1 -1
- package/dist-types/commands/StartFaceSearchCommand.d.ts +2 -1
- package/dist-types/commands/StartSegmentDetectionCommand.d.ts +1 -1
- package/dist-types/commands/StartStreamProcessorCommand.d.ts +1 -0
- package/dist-types/commands/UpdateStreamProcessorCommand.d.ts +37 -0
- package/dist-types/commands/index.d.ts +1 -0
- package/dist-types/models/models_0.d.ts +450 -84
- package/dist-types/protocols/Aws_json1_1.d.ts +3 -0
- package/dist-types/ts3.4/Rekognition.d.ts +5 -0
- package/dist-types/ts3.4/RekognitionClient.d.ts +3 -2
- package/dist-types/ts3.4/commands/UpdateStreamProcessorCommand.d.ts +17 -0
- package/dist-types/ts3.4/commands/index.d.ts +1 -0
- package/dist-types/ts3.4/models/models_0.d.ts +165 -21
- package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +3 -0
- 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.
|
|
12
|
-
* <
|
|
13
|
-
*
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
+
}
|