cdk-comprehend-s3olap 2.0.69 → 2.0.70

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.
@@ -76,6 +76,12 @@
76
76
  "output_token": "NextToken",
77
77
  "result_key": "Faces"
78
78
  },
79
+ "ListProjectPolicies": {
80
+ "input_token": "NextToken",
81
+ "limit_key": "MaxResults",
82
+ "output_token": "NextToken",
83
+ "result_key": "ProjectPolicies"
84
+ },
79
85
  "ListStreamProcessors": {
80
86
  "input_token": "NextToken",
81
87
  "limit_key": "MaxResults",
@@ -20,6 +20,14 @@ declare class Rekognition extends Service {
20
20
  * Compares a face in the source input image with each of the 100 largest faces detected in the target input image. If the source image contains multiple faces, the service detects the largest face and compares it with each face detected in the target image. CompareFaces uses machine learning algorithms, which are probabilistic. A false negative is an incorrect prediction that a face in the target image has a low similarity confidence score when compared to the face in the source image. To reduce the probability of false negatives, we recommend that you compare the target image against multiple source images. If you plan to use CompareFaces to make a decision that impacts an individual's rights, privacy, or access to services, we recommend that you pass the result to a human for review and further validation before taking action. You pass the input and target images either as base64-encoded image bytes or as references to images in an Amazon S3 bucket. If you use the AWS CLI to call Amazon Rekognition operations, passing image bytes isn't supported. The image must be formatted as a PNG or JPEG file. In response, the operation returns an array of face matches ordered by similarity score in descending order. For each face match, the response provides a bounding box of the face, facial landmarks, pose details (pitch, roll, and yaw), quality (brightness and sharpness), and confidence value (indicating the level of confidence that the bounding box contains a face). The response also provides a similarity score, which indicates how closely the faces match. By default, only faces with a similarity score of greater than or equal to 80% are returned in the response. You can change this value by specifying the SimilarityThreshold parameter. CompareFaces also returns an array of faces that don't match the source image. For each face, it returns a bounding box, confidence value, landmarks, pose details, and quality. The response also returns information about the face in the source image, including the bounding box of the face and confidence value. The QualityFilter input parameter allows you to filter out detected faces that don’t meet a required quality bar. The quality bar is based on a variety of common use cases. Use QualityFilter to set the quality bar by specifying LOW, MEDIUM, or HIGH. If you do not want to filter detected faces, specify NONE. The default value is NONE. If the image doesn't contain Exif metadata, CompareFaces returns orientation information for the source and target images. Use these values to display the images with the correct image orientation. If no faces are detected in the source or target images, CompareFaces returns an InvalidParameterException error. This is a stateless API operation. That is, data returned by this operation doesn't persist. For an example, see Comparing Faces in Images in the Amazon Rekognition Developer Guide. This operation requires permissions to perform the rekognition:CompareFaces action.
21
21
  */
22
22
  compareFaces(callback?: (err: AWSError, data: Rekognition.Types.CompareFacesResponse) => void): Request<Rekognition.Types.CompareFacesResponse, AWSError>;
23
+ /**
24
+ * Copies a version of an Amazon Rekognition Custom Labels model from a source project to a destination project. The source and destination projects can be in different AWS accounts but must be in the same AWS Region. You can't copy a model to another AWS service. To copy a model version to a different AWS account, you need to create a resource-based policy known as a project policy. You attach the project policy to the source project by calling PutProjectPolicy. The project policy gives permission to copy the model version from a trusting AWS account to a trusted account. For more information creating and attaching a project policy, see Attaching a project policy (SDK) in the Amazon Rekognition Custom Labels Developer Guide. If you are copying a model version to a project in the same AWS account, you don't need to create a project policy. To copy a model, the destination project, source project, and source model version must already exist. Copying a model version takes a while to complete. To get the current status, call DescribeProjectVersions and check the value of Status in the ProjectVersionDescription object. The copy operation has finished when the value of Status is COPYING_COMPLETED.
25
+ */
26
+ copyProjectVersion(params: Rekognition.Types.CopyProjectVersionRequest, callback?: (err: AWSError, data: Rekognition.Types.CopyProjectVersionResponse) => void): Request<Rekognition.Types.CopyProjectVersionResponse, AWSError>;
27
+ /**
28
+ * Copies a version of an Amazon Rekognition Custom Labels model from a source project to a destination project. The source and destination projects can be in different AWS accounts but must be in the same AWS Region. You can't copy a model to another AWS service. To copy a model version to a different AWS account, you need to create a resource-based policy known as a project policy. You attach the project policy to the source project by calling PutProjectPolicy. The project policy gives permission to copy the model version from a trusting AWS account to a trusted account. For more information creating and attaching a project policy, see Attaching a project policy (SDK) in the Amazon Rekognition Custom Labels Developer Guide. If you are copying a model version to a project in the same AWS account, you don't need to create a project policy. To copy a model, the destination project, source project, and source model version must already exist. Copying a model version takes a while to complete. To get the current status, call DescribeProjectVersions and check the value of Status in the ProjectVersionDescription object. The copy operation has finished when the value of Status is COPYING_COMPLETED.
29
+ */
30
+ copyProjectVersion(callback?: (err: AWSError, data: Rekognition.Types.CopyProjectVersionResponse) => void): Request<Rekognition.Types.CopyProjectVersionResponse, AWSError>;
23
31
  /**
24
32
  * Creates a collection in an AWS Region. You can add faces to the collection using the IndexFaces operation. For example, you might create collections, one for each of your application users. A user can then index faces using the IndexFaces operation and persist results in a specific collection. Then, a user can search the collection for faces in the user-specific container. When you create a collection, it is associated with the latest version of the face model version. Collection names are case-sensitive. This operation requires permissions to perform the rekognition:CreateCollection action. If you want to tag your collection, you also require permission to perform the rekognition:TagResource operation.
25
33
  */
@@ -85,13 +93,21 @@ declare class Rekognition extends Service {
85
93
  */
86
94
  deleteFaces(callback?: (err: AWSError, data: Rekognition.Types.DeleteFacesResponse) => void): Request<Rekognition.Types.DeleteFacesResponse, AWSError>;
87
95
  /**
88
- * Deletes an Amazon Rekognition Custom Labels project. To delete a project you must first delete all models associated with the project. To delete a model, see DeleteProjectVersion. DeleteProject is an asynchronous operation. To check if the project is deleted, call DescribeProjects. The project is deleted when the project no longer appears in the response. This operation requires permissions to perform the rekognition:DeleteProject action.
96
+ * Deletes an Amazon Rekognition Custom Labels project. To delete a project you must first delete all models associated with the project. To delete a model, see DeleteProjectVersion. DeleteProject is an asynchronous operation. To check if the project is deleted, call DescribeProjects. The project is deleted when the project no longer appears in the response. Be aware that deleting a given project will also delete any ProjectPolicies associated with that project. This operation requires permissions to perform the rekognition:DeleteProject action.
89
97
  */
90
98
  deleteProject(params: Rekognition.Types.DeleteProjectRequest, callback?: (err: AWSError, data: Rekognition.Types.DeleteProjectResponse) => void): Request<Rekognition.Types.DeleteProjectResponse, AWSError>;
91
99
  /**
92
- * Deletes an Amazon Rekognition Custom Labels project. To delete a project you must first delete all models associated with the project. To delete a model, see DeleteProjectVersion. DeleteProject is an asynchronous operation. To check if the project is deleted, call DescribeProjects. The project is deleted when the project no longer appears in the response. This operation requires permissions to perform the rekognition:DeleteProject action.
100
+ * Deletes an Amazon Rekognition Custom Labels project. To delete a project you must first delete all models associated with the project. To delete a model, see DeleteProjectVersion. DeleteProject is an asynchronous operation. To check if the project is deleted, call DescribeProjects. The project is deleted when the project no longer appears in the response. Be aware that deleting a given project will also delete any ProjectPolicies associated with that project. This operation requires permissions to perform the rekognition:DeleteProject action.
93
101
  */
94
102
  deleteProject(callback?: (err: AWSError, data: Rekognition.Types.DeleteProjectResponse) => void): Request<Rekognition.Types.DeleteProjectResponse, AWSError>;
103
+ /**
104
+ * Deletes an existing project policy. To get a list of project policies attached to a project, call ListProjectPolicies. To attach a project policy to a project, call PutProjectPolicy.
105
+ */
106
+ deleteProjectPolicy(params: Rekognition.Types.DeleteProjectPolicyRequest, callback?: (err: AWSError, data: Rekognition.Types.DeleteProjectPolicyResponse) => void): Request<Rekognition.Types.DeleteProjectPolicyResponse, AWSError>;
107
+ /**
108
+ * Deletes an existing project policy. To get a list of project policies attached to a project, call ListProjectPolicies. To attach a project policy to a project, call PutProjectPolicy.
109
+ */
110
+ deleteProjectPolicy(callback?: (err: AWSError, data: Rekognition.Types.DeleteProjectPolicyResponse) => void): Request<Rekognition.Types.DeleteProjectPolicyResponse, AWSError>;
95
111
  /**
96
112
  * Deletes an Amazon Rekognition Custom Labels model. You can't delete a model if it is running or if it is training. To check the status of a model, use the Status field returned from DescribeProjectVersions. To stop a running model call StopProjectVersion. If the model is training, wait until it finishes. This operation requires permissions to perform the rekognition:DeleteProjectVersion action.
97
113
  */
@@ -316,6 +332,14 @@ declare class Rekognition extends Service {
316
332
  * Returns metadata for faces in the specified collection. This metadata includes information such as the bounding box coordinates, the confidence (that the bounding box contains a face), and face ID. For an example, see Listing Faces in a Collection in the Amazon Rekognition Developer Guide. This operation requires permissions to perform the rekognition:ListFaces action.
317
333
  */
318
334
  listFaces(callback?: (err: AWSError, data: Rekognition.Types.ListFacesResponse) => void): Request<Rekognition.Types.ListFacesResponse, AWSError>;
335
+ /**
336
+ * Gets a list of the project policies attached to a project. To attach a project policy to a project, call PutProjectPolicy. To remove a project policy from a project, call DeleteProjectPolicy.
337
+ */
338
+ listProjectPolicies(params: Rekognition.Types.ListProjectPoliciesRequest, callback?: (err: AWSError, data: Rekognition.Types.ListProjectPoliciesResponse) => void): Request<Rekognition.Types.ListProjectPoliciesResponse, AWSError>;
339
+ /**
340
+ * Gets a list of the project policies attached to a project. To attach a project policy to a project, call PutProjectPolicy. To remove a project policy from a project, call DeleteProjectPolicy.
341
+ */
342
+ listProjectPolicies(callback?: (err: AWSError, data: Rekognition.Types.ListProjectPoliciesResponse) => void): Request<Rekognition.Types.ListProjectPoliciesResponse, AWSError>;
319
343
  /**
320
344
  * Gets a list of stream processors that you have created with CreateStreamProcessor.
321
345
  */
@@ -332,6 +356,14 @@ declare class Rekognition extends Service {
332
356
  * Returns a list of tags in an Amazon Rekognition collection, stream processor, or Custom Labels model. This operation requires permissions to perform the rekognition:ListTagsForResource action.
333
357
  */
334
358
  listTagsForResource(callback?: (err: AWSError, data: Rekognition.Types.ListTagsForResourceResponse) => void): Request<Rekognition.Types.ListTagsForResourceResponse, AWSError>;
359
+ /**
360
+ * Attaches a project policy to a Amazon Rekognition Custom Labels project in a trusting AWS account. A project policy specifies that a trusted AWS account can copy a model version from a trusting AWS account to a project in the trusted AWS account. To copy a model version you use the CopyProjectVersion operation. For more information about the format of a project policy document, see Attaching a project policy (SDK) in the Amazon Rekognition Custom Labels Developer Guide. The response from PutProjectPolicy is a revision ID for the project policy. You can attach multiple project policies to a project. You can also update an existing project policy by specifying the policy revision ID of the existing policy. To remove a project policy from a project, call DeleteProjectPolicy. To get a list of project policies attached to a project, call ListProjectPolicies. You copy a model version by calling CopyProjectVersion.
361
+ */
362
+ putProjectPolicy(params: Rekognition.Types.PutProjectPolicyRequest, callback?: (err: AWSError, data: Rekognition.Types.PutProjectPolicyResponse) => void): Request<Rekognition.Types.PutProjectPolicyResponse, AWSError>;
363
+ /**
364
+ * Attaches a project policy to a Amazon Rekognition Custom Labels project in a trusting AWS account. A project policy specifies that a trusted AWS account can copy a model version from a trusting AWS account to a project in the trusted AWS account. To copy a model version you use the CopyProjectVersion operation. For more information about the format of a project policy document, see Attaching a project policy (SDK) in the Amazon Rekognition Custom Labels Developer Guide. The response from PutProjectPolicy is a revision ID for the project policy. You can attach multiple project policies to a project. You can also update an existing project policy by specifying the policy revision ID of the existing policy. To remove a project policy from a project, call DeleteProjectPolicy. To get a list of project policies attached to a project, call ListProjectPolicies. You copy a model version by calling CopyProjectVersion.
365
+ */
366
+ putProjectPolicy(callback?: (err: AWSError, data: Rekognition.Types.PutProjectPolicyResponse) => void): Request<Rekognition.Types.PutProjectPolicyResponse, AWSError>;
335
367
  /**
336
368
  * Returns an array of celebrities recognized in the input image. For more information, see Recognizing celebrities in the Amazon Rekognition Developer Guide. RecognizeCelebrities returns the 64 largest faces in the image. It lists the recognized celebrities in the CelebrityFaces array and any unrecognized faces in the UnrecognizedFaces array. RecognizeCelebrities doesn't return celebrities whose faces aren't among the largest 64 faces in the image. For each celebrity recognized, RecognizeCelebrities returns a Celebrity object. The Celebrity object contains the celebrity name, ID, URL links to additional information, match confidence, and a ComparedFace object that you can use to locate the celebrity's face on the image. Amazon Rekognition doesn't retain information about which images a celebrity has been recognized in. Your application must store this information and use the Celebrity ID property as a unique identifier for the celebrity. If you don't store the celebrity name or additional information URLs returned by RecognizeCelebrities, you will need the ID to identify the celebrity in a call to the GetCelebrityInfo operation. You pass the input image either as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket. If you use the AWS CLI to call Amazon Rekognition operations, passing image bytes is not supported. The image must be either a PNG or JPEG formatted file. For an example, see Recognizing celebrities in an image in the Amazon Rekognition Developer Guide. This operation requires permissions to perform the rekognition:RecognizeCelebrities operation.
337
369
  */
@@ -778,6 +810,42 @@ declare namespace Rekognition {
778
810
  }
779
811
  export type ContentModerationDetections = ContentModerationDetection[];
780
812
  export type ContentModerationSortBy = "NAME"|"TIMESTAMP"|string;
813
+ export interface CopyProjectVersionRequest {
814
+ /**
815
+ * The ARN of the source project in the trusting AWS account.
816
+ */
817
+ SourceProjectArn: ProjectArn;
818
+ /**
819
+ * The ARN of the model version in the source project that you want to copy to a destination project.
820
+ */
821
+ SourceProjectVersionArn: ProjectVersionArn;
822
+ /**
823
+ * The ARN of the project in the trusted AWS account that you want to copy the model version to.
824
+ */
825
+ DestinationProjectArn: ProjectArn;
826
+ /**
827
+ * A name for the version of the model that's copied to the destination project.
828
+ */
829
+ VersionName: VersionName;
830
+ /**
831
+ * The S3 bucket and folder location where the training output for the source model version is placed.
832
+ */
833
+ OutputConfig: OutputConfig;
834
+ /**
835
+ * The key-value tags to assign to the model version.
836
+ */
837
+ Tags?: TagMap;
838
+ /**
839
+ * The identifier for your AWS Key Management Service key (AWS KMS key). You can supply the Amazon Resource Name (ARN) of your KMS key, the ID of your KMS key, an alias for your KMS key, or an alias ARN. The key is used to encrypt training results and manifest files written to the output Amazon S3 bucket (OutputConfig). If you choose to use your own KMS key, you need the following permissions on the KMS key. kms:CreateGrant kms:DescribeKey kms:GenerateDataKey kms:Decrypt If you don't specify a value for KmsKeyId, images copied into the service are encrypted using a key that AWS owns and manages.
840
+ */
841
+ KmsKeyId?: KmsKeyId;
842
+ }
843
+ export interface CopyProjectVersionResponse {
844
+ /**
845
+ * The ARN of the copied model version in the destination project.
846
+ */
847
+ ProjectVersionArn?: ProjectVersionArn;
848
+ }
781
849
  export interface CoversBodyPart {
782
850
  /**
783
851
  * The confidence that Amazon Rekognition has in the value of Value.
@@ -1091,6 +1159,22 @@ declare namespace Rekognition {
1091
1159
  */
1092
1160
  DeletedFaces?: FaceIdList;
1093
1161
  }
1162
+ export interface DeleteProjectPolicyRequest {
1163
+ /**
1164
+ * The Amazon Resource Name (ARN) of the project that the project policy you want to delete is attached to.
1165
+ */
1166
+ ProjectArn: ProjectArn;
1167
+ /**
1168
+ * The name of the policy that you want to delete.
1169
+ */
1170
+ PolicyName: ProjectPolicyName;
1171
+ /**
1172
+ * The ID of the project policy revision that you want to delete.
1173
+ */
1174
+ PolicyRevisionId?: ProjectPolicyRevisionId;
1175
+ }
1176
+ export interface DeleteProjectPolicyResponse {
1177
+ }
1094
1178
  export interface DeleteProjectRequest {
1095
1179
  /**
1096
1180
  * The Amazon Resource Name (ARN) of the project that you want to delete.
@@ -2342,6 +2426,31 @@ declare namespace Rekognition {
2342
2426
  */
2343
2427
  FaceModelVersion?: String;
2344
2428
  }
2429
+ export type ListProjectPoliciesPageSize = number;
2430
+ export interface ListProjectPoliciesRequest {
2431
+ /**
2432
+ * The ARN of the project for which you want to list the project policies.
2433
+ */
2434
+ ProjectArn: ProjectArn;
2435
+ /**
2436
+ * If the previous response was incomplete (because there is more results to retrieve), Amazon Rekognition Custom Labels returns a pagination token in the response. You can use this pagination token to retrieve the next set of results.
2437
+ */
2438
+ NextToken?: ExtendedPaginationToken;
2439
+ /**
2440
+ * The maximum number of results to return per paginated call. The largest value you can specify is 5. If you specify a value greater than 5, a ValidationException error occurs. The default value is 5.
2441
+ */
2442
+ MaxResults?: ListProjectPoliciesPageSize;
2443
+ }
2444
+ export interface ListProjectPoliciesResponse {
2445
+ /**
2446
+ * A list of project policies attached to the project.
2447
+ */
2448
+ ProjectPolicies?: ProjectPolicies;
2449
+ /**
2450
+ * If the response is truncated, Amazon Rekognition returns this token that you can use in the subsequent request to retrieve the next set of project policies.
2451
+ */
2452
+ NextToken?: ExtendedPaginationToken;
2453
+ }
2345
2454
  export interface ListStreamProcessorsRequest {
2346
2455
  /**
2347
2456
  * If the previous response was incomplete (because there are more stream processors to retrieve), Amazon Rekognition Video returns a pagination token in the response. You can use this pagination token to retrieve the next set of stream processors.
@@ -2535,6 +2644,36 @@ declare namespace Rekognition {
2535
2644
  export type ProjectDescriptions = ProjectDescription[];
2536
2645
  export type ProjectName = string;
2537
2646
  export type ProjectNames = ProjectName[];
2647
+ export type ProjectPolicies = ProjectPolicy[];
2648
+ export interface ProjectPolicy {
2649
+ /**
2650
+ * The Amazon Resource Name (ARN) of the project to which the project policy is attached.
2651
+ */
2652
+ ProjectArn?: ProjectArn;
2653
+ /**
2654
+ * The name of the project policy.
2655
+ */
2656
+ PolicyName?: ProjectPolicyName;
2657
+ /**
2658
+ * The revision ID of the project policy.
2659
+ */
2660
+ PolicyRevisionId?: ProjectPolicyRevisionId;
2661
+ /**
2662
+ * The JSON document for the project policy.
2663
+ */
2664
+ PolicyDocument?: ProjectPolicyDocument;
2665
+ /**
2666
+ * The Unix datetime for the creation of the project policy.
2667
+ */
2668
+ CreationTimestamp?: DateTime;
2669
+ /**
2670
+ * The Unix datetime for when the project policy was last updated.
2671
+ */
2672
+ LastUpdatedTimestamp?: DateTime;
2673
+ }
2674
+ export type ProjectPolicyDocument = string;
2675
+ export type ProjectPolicyName = string;
2676
+ export type ProjectPolicyRevisionId = string;
2538
2677
  export type ProjectStatus = "CREATING"|"CREATED"|"DELETING"|string;
2539
2678
  export type ProjectVersionArn = string;
2540
2679
  export interface ProjectVersionDescription {
@@ -2594,9 +2733,13 @@ declare namespace Rekognition {
2594
2733
  * The maximum number of inference units Amazon Rekognition Custom Labels uses to auto-scale the model. For more information, see StartProjectVersion.
2595
2734
  */
2596
2735
  MaxInferenceUnits?: InferenceUnits;
2736
+ /**
2737
+ * If the model version was copied from a different project, SourceProjectVersionArn contains the ARN of the source model version.
2738
+ */
2739
+ SourceProjectVersionArn?: ProjectVersionArn;
2597
2740
  }
2598
2741
  export type ProjectVersionDescriptions = ProjectVersionDescription[];
2599
- export type ProjectVersionStatus = "TRAINING_IN_PROGRESS"|"TRAINING_COMPLETED"|"TRAINING_FAILED"|"STARTING"|"RUNNING"|"FAILED"|"STOPPING"|"STOPPED"|"DELETING"|string;
2742
+ export type ProjectVersionStatus = "TRAINING_IN_PROGRESS"|"TRAINING_COMPLETED"|"TRAINING_FAILED"|"STARTING"|"RUNNING"|"FAILED"|"STOPPING"|"STOPPED"|"DELETING"|"COPYING_IN_PROGRESS"|"COPYING_COMPLETED"|"COPYING_FAILED"|string;
2600
2743
  export type ProjectVersionsPageSize = number;
2601
2744
  export type ProjectsPageSize = number;
2602
2745
  export interface ProtectiveEquipmentBodyPart {
@@ -2659,6 +2802,30 @@ declare namespace Rekognition {
2659
2802
  }
2660
2803
  export type ProtectiveEquipmentType = "FACE_COVER"|"HAND_COVER"|"HEAD_COVER"|string;
2661
2804
  export type ProtectiveEquipmentTypes = ProtectiveEquipmentType[];
2805
+ export interface PutProjectPolicyRequest {
2806
+ /**
2807
+ * The Amazon Resource Name (ARN) of the project that the project policy is attached to.
2808
+ */
2809
+ ProjectArn: ProjectArn;
2810
+ /**
2811
+ * A name for the policy.
2812
+ */
2813
+ PolicyName: ProjectPolicyName;
2814
+ /**
2815
+ * The revision ID for the Project Policy. Each time you modify a policy, Amazon Rekognition Custom Labels generates and assigns a new PolicyRevisionId and then deletes the previous version of the policy.
2816
+ */
2817
+ PolicyRevisionId?: ProjectPolicyRevisionId;
2818
+ /**
2819
+ * A resource policy to add to the model. The policy is a JSON structure that contains one or more statements that define the policy. The policy must follow the IAM syntax. For more information about the contents of a JSON policy document, see IAM JSON policy reference.
2820
+ */
2821
+ PolicyDocument: ProjectPolicyDocument;
2822
+ }
2823
+ export interface PutProjectPolicyResponse {
2824
+ /**
2825
+ * The ID of the project policy.
2826
+ */
2827
+ PolicyRevisionId?: ProjectPolicyRevisionId;
2828
+ }
2662
2829
  export type QualityFilter = "NONE"|"AUTO"|"LOW"|"MEDIUM"|"HIGH"|string;
2663
2830
  export type QueryString = string;
2664
2831
  export type Reason = "EXCEEDS_MAX_FACES"|"EXTREME_POSE"|"LOW_BRIGHTNESS"|"LOW_SHARPNESS"|"LOW_CONFIDENCE"|"SMALL_BOUNDING_BOX"|"LOW_FACE_QUALITY"|string;