aws-sdk-rekognition 1.58.0 → 1.62.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -252,7 +252,8 @@ module Aws::Rekognition
252
252
  #
253
253
  # @!attribute [rw] known_gender
254
254
  # The known gender identity for the celebrity that matches the
255
- # provided ID.
255
+ # provided ID. The known gender identity can be Male, Female,
256
+ # Nonbinary, or Unlisted.
256
257
  # @return [Types::KnownGender]
257
258
  #
258
259
  class Celebrity < Struct.new(
@@ -643,6 +644,61 @@ module Aws::Rekognition
643
644
  include Aws::Structure
644
645
  end
645
646
 
647
+ # @note When making an API call, you may pass CreateDatasetRequest
648
+ # data as a hash:
649
+ #
650
+ # {
651
+ # dataset_source: {
652
+ # ground_truth_manifest: {
653
+ # s3_object: {
654
+ # bucket: "S3Bucket",
655
+ # name: "S3ObjectName",
656
+ # version: "S3ObjectVersion",
657
+ # },
658
+ # },
659
+ # dataset_arn: "DatasetArn",
660
+ # },
661
+ # dataset_type: "TRAIN", # required, accepts TRAIN, TEST
662
+ # project_arn: "ProjectArn", # required
663
+ # }
664
+ #
665
+ # @!attribute [rw] dataset_source
666
+ # The source files for the dataset. You can specify the ARN of an
667
+ # existing dataset or specify the Amazon S3 bucket location of an
668
+ # Amazon Sagemaker format manifest file. If you don't specify
669
+ # `datasetSource`, an empty dataset is created. To add labeled images
670
+ # to the dataset, You can use the console or call
671
+ # UpdateDatasetEntries.
672
+ # @return [Types::DatasetSource]
673
+ #
674
+ # @!attribute [rw] dataset_type
675
+ # The type of the dataset. Specify `train` to create a training
676
+ # dataset. Specify `test` to create a test dataset.
677
+ # @return [String]
678
+ #
679
+ # @!attribute [rw] project_arn
680
+ # The ARN of the Amazon Rekognition Custom Labels project to which you
681
+ # want to asssign the dataset.
682
+ # @return [String]
683
+ #
684
+ class CreateDatasetRequest < Struct.new(
685
+ :dataset_source,
686
+ :dataset_type,
687
+ :project_arn)
688
+ SENSITIVE = []
689
+ include Aws::Structure
690
+ end
691
+
692
+ # @!attribute [rw] dataset_arn
693
+ # The ARN of the created Amazon Rekognition Custom Labels dataset.
694
+ # @return [String]
695
+ #
696
+ class CreateDatasetResponse < Struct.new(
697
+ :dataset_arn)
698
+ SENSITIVE = []
699
+ include Aws::Structure
700
+ end
701
+
646
702
  # @note When making an API call, you may pass CreateProjectRequest
647
703
  # data as a hash:
648
704
  #
@@ -681,7 +737,7 @@ module Aws::Rekognition
681
737
  # s3_bucket: "S3Bucket",
682
738
  # s3_key_prefix: "S3KeyPrefix",
683
739
  # },
684
- # training_data: { # required
740
+ # training_data: {
685
741
  # assets: [
686
742
  # {
687
743
  # ground_truth_manifest: {
@@ -694,7 +750,7 @@ module Aws::Rekognition
694
750
  # },
695
751
  # ],
696
752
  # },
697
- # testing_data: { # required
753
+ # testing_data: {
698
754
  # assets: [
699
755
  # {
700
756
  # ground_truth_manifest: {
@@ -730,11 +786,15 @@ module Aws::Rekognition
730
786
  # @return [Types::OutputConfig]
731
787
  #
732
788
  # @!attribute [rw] training_data
733
- # The dataset to use for training.
789
+ # Specifies an external manifest that the services uses to train the
790
+ # model. If you specify `TrainingData` you must also specify
791
+ # `TestingData`. The project must not have any associated datasets.
734
792
  # @return [Types::TrainingData]
735
793
  #
736
794
  # @!attribute [rw] testing_data
737
- # The dataset to use for testing.
795
+ # Specifies an external manifest that the service uses to test the
796
+ # model. If you specify `TestingData` you must also specify
797
+ # `TrainingData`. The project must not have any associated datasets.
738
798
  # @return [Types::TestingData]
739
799
  #
740
800
  # @!attribute [rw] tags
@@ -743,17 +803,16 @@ module Aws::Rekognition
743
803
  # @return [Hash<String,String>]
744
804
  #
745
805
  # @!attribute [rw] kms_key_id
746
- # The identifier for your AWS Key Management Service (AWS KMS)
747
- # customer master key (CMK). You can supply the Amazon Resource Name
748
- # (ARN) of your CMK, the ID of your CMK, an alias for your CMK, or an
749
- # alias ARN. The key is used to encrypt training and test images
750
- # copied into the service for model training. Your source images are
751
- # unaffected. The key is also used to encrypt training results and
752
- # manifest files written to the output Amazon S3 bucket
753
- # (`OutputConfig`).
754
- #
755
- # If you choose to use your own CMK, you need the following
756
- # permissions on the CMK.
806
+ # The identifier for your AWS Key Management Service key (AWS KMS
807
+ # key). You can supply the Amazon Resource Name (ARN) of your KMS key,
808
+ # the ID of your KMS key, an alias for your KMS key, or an alias ARN.
809
+ # The key is used to encrypt training and test images copied into the
810
+ # service for model training. Your source images are unaffected. The
811
+ # key is also used to encrypt training results and manifest files
812
+ # written to the output Amazon S3 bucket (`OutputConfig`).
813
+ #
814
+ # If you choose to use your own KMS key, you need the following
815
+ # permissions on the KMS key.
757
816
  #
758
817
  # * kms:CreateGrant
759
818
  #
@@ -900,6 +959,235 @@ module Aws::Rekognition
900
959
  include Aws::Structure
901
960
  end
902
961
 
962
+ # Describes updates or additions to a dataset. A Single update or
963
+ # addition is an entry (JSON Line) that provides information about a
964
+ # single image. To update an existing entry, you match the `source-ref`
965
+ # field of the update entry with the `source-ref` filed of the entry
966
+ # that you want to update. If the `source-ref` field doesn't match an
967
+ # existing entry, the entry is added to dataset as a new entry.
968
+ #
969
+ # @note When making an API call, you may pass DatasetChanges
970
+ # data as a hash:
971
+ #
972
+ # {
973
+ # ground_truth: "data", # required
974
+ # }
975
+ #
976
+ # @!attribute [rw] ground_truth
977
+ # A Base64-encoded binary data object containing one or JSON lines
978
+ # that either update the dataset or are additions to the dataset. You
979
+ # change a dataset by calling UpdateDatasetEntries. If you are using
980
+ # an AWS SDK to call `UpdateDatasetEntries`, you don't need to encode
981
+ # `Changes` as the SDK encodes the data for you.
982
+ #
983
+ # For example JSON lines, see Image-Level labels in manifest files and
984
+ # and Object localization in manifest files in the *Amazon Rekognition
985
+ # Custom Labels Developer Guide*.
986
+ # @return [String]
987
+ #
988
+ class DatasetChanges < Struct.new(
989
+ :ground_truth)
990
+ SENSITIVE = []
991
+ include Aws::Structure
992
+ end
993
+
994
+ # A description for a dataset. For more information, see
995
+ # DescribeDataset.
996
+ #
997
+ # The status fields `Status`, `StatusMessage`, and `StatusMessageCode`
998
+ # reflect the last operation on the dataset.
999
+ #
1000
+ # @!attribute [rw] creation_timestamp
1001
+ # The Unix timestamp for the time and date that the dataset was
1002
+ # created.
1003
+ # @return [Time]
1004
+ #
1005
+ # @!attribute [rw] last_updated_timestamp
1006
+ # The Unix timestamp for the date and time that the dataset was last
1007
+ # updated.
1008
+ # @return [Time]
1009
+ #
1010
+ # @!attribute [rw] status
1011
+ # The status of the dataset.
1012
+ # @return [String]
1013
+ #
1014
+ # @!attribute [rw] status_message
1015
+ # The status message for the dataset.
1016
+ # @return [String]
1017
+ #
1018
+ # @!attribute [rw] status_message_code
1019
+ # The status message code for the dataset operation. If a service
1020
+ # error occurs, try the API call again later. If a client error
1021
+ # occurs, check the input parameters to the dataset API call that
1022
+ # failed.
1023
+ # @return [String]
1024
+ #
1025
+ # @!attribute [rw] dataset_stats
1026
+ # The status message code for the dataset.
1027
+ # @return [Types::DatasetStats]
1028
+ #
1029
+ class DatasetDescription < Struct.new(
1030
+ :creation_timestamp,
1031
+ :last_updated_timestamp,
1032
+ :status,
1033
+ :status_message,
1034
+ :status_message_code,
1035
+ :dataset_stats)
1036
+ SENSITIVE = []
1037
+ include Aws::Structure
1038
+ end
1039
+
1040
+ # Describes a dataset label. For more information, see
1041
+ # ListDatasetLabels.
1042
+ #
1043
+ # @!attribute [rw] label_name
1044
+ # The name of the label.
1045
+ # @return [String]
1046
+ #
1047
+ # @!attribute [rw] label_stats
1048
+ # Statistics about the label.
1049
+ # @return [Types::DatasetLabelStats]
1050
+ #
1051
+ class DatasetLabelDescription < Struct.new(
1052
+ :label_name,
1053
+ :label_stats)
1054
+ SENSITIVE = []
1055
+ include Aws::Structure
1056
+ end
1057
+
1058
+ # Statistics about a label used in a dataset. For more information, see
1059
+ # DatasetLabelDescription.
1060
+ #
1061
+ # @!attribute [rw] entry_count
1062
+ # The total number of images that use the label.
1063
+ # @return [Integer]
1064
+ #
1065
+ # @!attribute [rw] bounding_box_count
1066
+ # The total number of images that have the label assigned to a
1067
+ # bounding box.
1068
+ # @return [Integer]
1069
+ #
1070
+ class DatasetLabelStats < Struct.new(
1071
+ :entry_count,
1072
+ :bounding_box_count)
1073
+ SENSITIVE = []
1074
+ include Aws::Structure
1075
+ end
1076
+
1077
+ # Summary information for an Amazon Rekognition Custom Labels dataset.
1078
+ # For more information, see ProjectDescription.
1079
+ #
1080
+ # @!attribute [rw] creation_timestamp
1081
+ # The Unix timestamp for the date and time that the dataset was
1082
+ # created.
1083
+ # @return [Time]
1084
+ #
1085
+ # @!attribute [rw] dataset_type
1086
+ # The type of the dataset.
1087
+ # @return [String]
1088
+ #
1089
+ # @!attribute [rw] dataset_arn
1090
+ # The Amazon Resource Name (ARN) for the dataset.
1091
+ # @return [String]
1092
+ #
1093
+ # @!attribute [rw] status
1094
+ # The status for the dataset.
1095
+ # @return [String]
1096
+ #
1097
+ # @!attribute [rw] status_message
1098
+ # The status message for the dataset.
1099
+ # @return [String]
1100
+ #
1101
+ # @!attribute [rw] status_message_code
1102
+ # The status message code for the dataset operation. If a service
1103
+ # error occurs, try the API call again later. If a client error
1104
+ # occurs, check the input parameters to the dataset API call that
1105
+ # failed.
1106
+ # @return [String]
1107
+ #
1108
+ class DatasetMetadata < Struct.new(
1109
+ :creation_timestamp,
1110
+ :dataset_type,
1111
+ :dataset_arn,
1112
+ :status,
1113
+ :status_message,
1114
+ :status_message_code)
1115
+ SENSITIVE = []
1116
+ include Aws::Structure
1117
+ end
1118
+
1119
+ # The source that Amazon Rekognition Custom Labels uses to create a
1120
+ # dataset. To use an Amazon Sagemaker format manifest file, specify the
1121
+ # S3 bucket location in the `GroundTruthManifest` field. The S3 bucket
1122
+ # must be in your AWS account. To create a copy of an existing dataset,
1123
+ # specify the Amazon Resource Name (ARN) of an existing dataset in
1124
+ # `DatasetArn`.
1125
+ #
1126
+ # You need to specify a value for `DatasetArn` or `GroundTruthManifest`,
1127
+ # but not both. if you supply both values, or if you don't specify any
1128
+ # values, an InvalidParameterException exception occurs.
1129
+ #
1130
+ # For more information, see CreateDataset.
1131
+ #
1132
+ # @note When making an API call, you may pass DatasetSource
1133
+ # data as a hash:
1134
+ #
1135
+ # {
1136
+ # ground_truth_manifest: {
1137
+ # s3_object: {
1138
+ # bucket: "S3Bucket",
1139
+ # name: "S3ObjectName",
1140
+ # version: "S3ObjectVersion",
1141
+ # },
1142
+ # },
1143
+ # dataset_arn: "DatasetArn",
1144
+ # }
1145
+ #
1146
+ # @!attribute [rw] ground_truth_manifest
1147
+ # The S3 bucket that contains an Amazon Sagemaker Ground Truth format
1148
+ # manifest file.
1149
+ # @return [Types::GroundTruthManifest]
1150
+ #
1151
+ # @!attribute [rw] dataset_arn
1152
+ # The ARN of an Amazon Rekognition Custom Labels dataset that you want
1153
+ # to copy.
1154
+ # @return [String]
1155
+ #
1156
+ class DatasetSource < Struct.new(
1157
+ :ground_truth_manifest,
1158
+ :dataset_arn)
1159
+ SENSITIVE = []
1160
+ include Aws::Structure
1161
+ end
1162
+
1163
+ # Provides statistics about a dataset. For more information, see
1164
+ # DescribeDataset.
1165
+ #
1166
+ # @!attribute [rw] labeled_entries
1167
+ # The total number of images in the dataset that have labels.
1168
+ # @return [Integer]
1169
+ #
1170
+ # @!attribute [rw] total_entries
1171
+ # The total number of images in the dataset.
1172
+ # @return [Integer]
1173
+ #
1174
+ # @!attribute [rw] total_labels
1175
+ # The total number of labels declared in the dataset.
1176
+ # @return [Integer]
1177
+ #
1178
+ # @!attribute [rw] error_entries
1179
+ # The total number of entries that contain at least one error.
1180
+ # @return [Integer]
1181
+ #
1182
+ class DatasetStats < Struct.new(
1183
+ :labeled_entries,
1184
+ :total_entries,
1185
+ :total_labels,
1186
+ :error_entries)
1187
+ SENSITIVE = []
1188
+ include Aws::Structure
1189
+ end
1190
+
903
1191
  # @note When making an API call, you may pass DeleteCollectionRequest
904
1192
  # data as a hash:
905
1193
  #
@@ -927,6 +1215,26 @@ module Aws::Rekognition
927
1215
  include Aws::Structure
928
1216
  end
929
1217
 
1218
+ # @note When making an API call, you may pass DeleteDatasetRequest
1219
+ # data as a hash:
1220
+ #
1221
+ # {
1222
+ # dataset_arn: "DatasetArn", # required
1223
+ # }
1224
+ #
1225
+ # @!attribute [rw] dataset_arn
1226
+ # The ARN of the Amazon Rekognition Custom Labels dataset that you
1227
+ # want to delete.
1228
+ # @return [String]
1229
+ #
1230
+ class DeleteDatasetRequest < Struct.new(
1231
+ :dataset_arn)
1232
+ SENSITIVE = []
1233
+ include Aws::Structure
1234
+ end
1235
+
1236
+ class DeleteDatasetResponse < Aws::EmptyStructure; end
1237
+
930
1238
  # @note When making an API call, you may pass DeleteFacesRequest
931
1239
  # data as a hash:
932
1240
  #
@@ -1084,6 +1392,34 @@ module Aws::Rekognition
1084
1392
  include Aws::Structure
1085
1393
  end
1086
1394
 
1395
+ # @note When making an API call, you may pass DescribeDatasetRequest
1396
+ # data as a hash:
1397
+ #
1398
+ # {
1399
+ # dataset_arn: "DatasetArn", # required
1400
+ # }
1401
+ #
1402
+ # @!attribute [rw] dataset_arn
1403
+ # The Amazon Resource Name (ARN) of the dataset that you want to
1404
+ # describe.
1405
+ # @return [String]
1406
+ #
1407
+ class DescribeDatasetRequest < Struct.new(
1408
+ :dataset_arn)
1409
+ SENSITIVE = []
1410
+ include Aws::Structure
1411
+ end
1412
+
1413
+ # @!attribute [rw] dataset_description
1414
+ # The description for the dataset.
1415
+ # @return [Types::DatasetDescription]
1416
+ #
1417
+ class DescribeDatasetResponse < Struct.new(
1418
+ :dataset_description)
1419
+ SENSITIVE = []
1420
+ include Aws::Structure
1421
+ end
1422
+
1087
1423
  # @note When making an API call, you may pass DescribeProjectVersionsRequest
1088
1424
  # data as a hash:
1089
1425
  #
@@ -1157,6 +1493,7 @@ module Aws::Rekognition
1157
1493
  # {
1158
1494
  # next_token: "ExtendedPaginationToken",
1159
1495
  # max_results: 1,
1496
+ # project_names: ["ProjectName"],
1160
1497
  # }
1161
1498
  #
1162
1499
  # @!attribute [rw] next_token
@@ -1173,9 +1510,16 @@ module Aws::Rekognition
1173
1510
  # 100.
1174
1511
  # @return [Integer]
1175
1512
  #
1513
+ # @!attribute [rw] project_names
1514
+ # A list of the projects that you want Amazon Rekognition Custom
1515
+ # Labels to describe. If you don't specify a value, the response
1516
+ # includes descriptions for all the projects in your AWS account.
1517
+ # @return [Array<String>]
1518
+ #
1176
1519
  class DescribeProjectsRequest < Struct.new(
1177
1520
  :next_token,
1178
- :max_results)
1521
+ :max_results,
1522
+ :project_names)
1179
1523
  SENSITIVE = []
1180
1524
  include Aws::Structure
1181
1525
  end
@@ -1808,6 +2152,51 @@ module Aws::Rekognition
1808
2152
  include Aws::Structure
1809
2153
  end
1810
2154
 
2155
+ # A training dataset or a test dataset used in a dataset distribution
2156
+ # operation. For more information, see DistributeDatasetEntries.
2157
+ #
2158
+ # @note When making an API call, you may pass DistributeDataset
2159
+ # data as a hash:
2160
+ #
2161
+ # {
2162
+ # arn: "DatasetArn", # required
2163
+ # }
2164
+ #
2165
+ # @!attribute [rw] arn
2166
+ # The Amazon Resource Name (ARN) of the dataset that you want to use.
2167
+ # @return [String]
2168
+ #
2169
+ class DistributeDataset < Struct.new(
2170
+ :arn)
2171
+ SENSITIVE = []
2172
+ include Aws::Structure
2173
+ end
2174
+
2175
+ # @note When making an API call, you may pass DistributeDatasetEntriesRequest
2176
+ # data as a hash:
2177
+ #
2178
+ # {
2179
+ # datasets: [ # required
2180
+ # {
2181
+ # arn: "DatasetArn", # required
2182
+ # },
2183
+ # ],
2184
+ # }
2185
+ #
2186
+ # @!attribute [rw] datasets
2187
+ # The ARNS for the training dataset and test dataset that you want to
2188
+ # use. The datasets must belong to the same project. The test dataset
2189
+ # must be empty.
2190
+ # @return [Array<Types::DistributeDataset>]
2191
+ #
2192
+ class DistributeDatasetEntriesRequest < Struct.new(
2193
+ :datasets)
2194
+ SENSITIVE = []
2195
+ include Aws::Structure
2196
+ end
2197
+
2198
+ class DistributeDatasetEntriesResponse < Aws::EmptyStructure; end
2199
+
1811
2200
  # The emotions that appear to be expressed on the face, and the
1812
2201
  # confidence level in the determination. The API is only making a
1813
2202
  # determination of the physical appearance of a person's face. It is
@@ -2153,8 +2542,9 @@ module Aws::Rekognition
2153
2542
  #
2154
2543
  # @!attribute [rw] face_match_threshold
2155
2544
  # Minimum face match confidence score that must be met to return a
2156
- # result for a recognized face. Default is 80. 0 is the lowest
2157
- # confidence. 100 is the highest confidence.
2545
+ # result for a recognized face. The default is 80. 0 is the lowest
2546
+ # confidence. 100 is the highest confidence. Values between 0 and 100
2547
+ # are accepted, and values lower than 80 are set to 80.
2158
2548
  # @return [Float]
2159
2549
  #
2160
2550
  class FaceSearchSettings < Struct.new(
@@ -3401,7 +3791,8 @@ module Aws::Rekognition
3401
3791
  end
3402
3792
 
3403
3793
  # The known gender identity for the celebrity that matches the provided
3404
- # ID.
3794
+ # ID. The known gender identity can be Male, Female, Nonbinary, or
3795
+ # Unlisted.
3405
3796
  #
3406
3797
  # @!attribute [rw] type
3407
3798
  # A string value of the KnownGender info about the Celebrity.
@@ -3549,6 +3940,148 @@ module Aws::Rekognition
3549
3940
  include Aws::Structure
3550
3941
  end
3551
3942
 
3943
+ # @note When making an API call, you may pass ListDatasetEntriesRequest
3944
+ # data as a hash:
3945
+ #
3946
+ # {
3947
+ # dataset_arn: "DatasetArn", # required
3948
+ # contains_labels: ["DatasetLabel"],
3949
+ # labeled: false,
3950
+ # source_ref_contains: "QueryString",
3951
+ # has_errors: false,
3952
+ # next_token: "ExtendedPaginationToken",
3953
+ # max_results: 1,
3954
+ # }
3955
+ #
3956
+ # @!attribute [rw] dataset_arn
3957
+ # The Amazon Resource Name (ARN) for the dataset that you want to use.
3958
+ # @return [String]
3959
+ #
3960
+ # @!attribute [rw] contains_labels
3961
+ # Specifies a label filter for the response. The response includes an
3962
+ # entry only if one or more of the labels in `ContainsLabels` exist in
3963
+ # the entry.
3964
+ # @return [Array<String>]
3965
+ #
3966
+ # @!attribute [rw] labeled
3967
+ # Specify `true` to get only the JSON Lines where the image is
3968
+ # labeled. Specify `false` to get only the JSON Lines where the image
3969
+ # isn't labeled. If you don't specify `Labeled`,
3970
+ # `ListDatasetEntries` returns JSON Lines for labeled and unlabeled
3971
+ # images.
3972
+ # @return [Boolean]
3973
+ #
3974
+ # @!attribute [rw] source_ref_contains
3975
+ # If specified, `ListDatasetEntries` only returns JSON Lines where the
3976
+ # value of `SourceRefContains` is part of the `source-ref` field. The
3977
+ # `source-ref` field contains the Amazon S3 location of the image. You
3978
+ # can use `SouceRefContains` for tasks such as getting the JSON Line
3979
+ # for a single image, or gettting JSON Lines for all images within a
3980
+ # specific folder.
3981
+ # @return [String]
3982
+ #
3983
+ # @!attribute [rw] has_errors
3984
+ # Specifies an error filter for the response. Specify `True` to only
3985
+ # include entries that have errors.
3986
+ # @return [Boolean]
3987
+ #
3988
+ # @!attribute [rw] next_token
3989
+ # If the previous response was incomplete (because there is more
3990
+ # results to retrieve), Amazon Rekognition Custom Labels returns a
3991
+ # pagination token in the response. You can use this pagination token
3992
+ # to retrieve the next set of results.
3993
+ # @return [String]
3994
+ #
3995
+ # @!attribute [rw] max_results
3996
+ # The maximum number of results to return per paginated call. The
3997
+ # largest value you can specify is 100. If you specify a value greater
3998
+ # than 100, a ValidationException error occurs. The default value is
3999
+ # 100.
4000
+ # @return [Integer]
4001
+ #
4002
+ class ListDatasetEntriesRequest < Struct.new(
4003
+ :dataset_arn,
4004
+ :contains_labels,
4005
+ :labeled,
4006
+ :source_ref_contains,
4007
+ :has_errors,
4008
+ :next_token,
4009
+ :max_results)
4010
+ SENSITIVE = []
4011
+ include Aws::Structure
4012
+ end
4013
+
4014
+ # @!attribute [rw] dataset_entries
4015
+ # A list of entries (images) in the dataset.
4016
+ # @return [Array<String>]
4017
+ #
4018
+ # @!attribute [rw] next_token
4019
+ # If the previous response was incomplete (because there is more
4020
+ # results to retrieve), Amazon Rekognition Custom Labels returns a
4021
+ # pagination token in the response. You can use this pagination token
4022
+ # to retrieve the next set of results.
4023
+ # @return [String]
4024
+ #
4025
+ class ListDatasetEntriesResponse < Struct.new(
4026
+ :dataset_entries,
4027
+ :next_token)
4028
+ SENSITIVE = []
4029
+ include Aws::Structure
4030
+ end
4031
+
4032
+ # @note When making an API call, you may pass ListDatasetLabelsRequest
4033
+ # data as a hash:
4034
+ #
4035
+ # {
4036
+ # dataset_arn: "DatasetArn", # required
4037
+ # next_token: "ExtendedPaginationToken",
4038
+ # max_results: 1,
4039
+ # }
4040
+ #
4041
+ # @!attribute [rw] dataset_arn
4042
+ # The Amazon Resource Name (ARN) of the dataset that you want to use.
4043
+ # @return [String]
4044
+ #
4045
+ # @!attribute [rw] next_token
4046
+ # If the previous response was incomplete (because there is more
4047
+ # results to retrieve), Amazon Rekognition Custom Labels returns a
4048
+ # pagination token in the response. You can use this pagination token
4049
+ # to retrieve the next set of results.
4050
+ # @return [String]
4051
+ #
4052
+ # @!attribute [rw] max_results
4053
+ # The maximum number of results to return per paginated call. The
4054
+ # largest value you can specify is 100. If you specify a value greater
4055
+ # than 100, a ValidationException error occurs. The default value is
4056
+ # 100.
4057
+ # @return [Integer]
4058
+ #
4059
+ class ListDatasetLabelsRequest < Struct.new(
4060
+ :dataset_arn,
4061
+ :next_token,
4062
+ :max_results)
4063
+ SENSITIVE = []
4064
+ include Aws::Structure
4065
+ end
4066
+
4067
+ # @!attribute [rw] dataset_label_descriptions
4068
+ # A list of the labels in the dataset.
4069
+ # @return [Array<Types::DatasetLabelDescription>]
4070
+ #
4071
+ # @!attribute [rw] next_token
4072
+ # If the previous response was incomplete (because there is more
4073
+ # results to retrieve), Amazon Rekognition Custom Labels returns a
4074
+ # pagination token in the response. You can use this pagination token
4075
+ # to retrieve the next set of results.
4076
+ # @return [String]
4077
+ #
4078
+ class ListDatasetLabelsResponse < Struct.new(
4079
+ :dataset_label_descriptions,
4080
+ :next_token)
4081
+ SENSITIVE = []
4082
+ include Aws::Structure
4083
+ end
4084
+
3552
4085
  # @note When making an API call, you may pass ListFacesRequest
3553
4086
  # data as a hash:
3554
4087
  #
@@ -3944,7 +4477,8 @@ module Aws::Rekognition
3944
4477
  include Aws::Structure
3945
4478
  end
3946
4479
 
3947
- # A description of a Amazon Rekognition Custom Labels project.
4480
+ # A description of an Amazon Rekognition Custom Labels project. For more
4481
+ # information, see DescribeProjects.
3948
4482
  #
3949
4483
  # @!attribute [rw] project_arn
3950
4484
  # The Amazon Resource Name (ARN) of the project.
@@ -3959,15 +4493,21 @@ module Aws::Rekognition
3959
4493
  # The current status of the project.
3960
4494
  # @return [String]
3961
4495
  #
4496
+ # @!attribute [rw] datasets
4497
+ # Information about the training and test datasets in the project.
4498
+ # @return [Array<Types::DatasetMetadata>]
4499
+ #
3962
4500
  class ProjectDescription < Struct.new(
3963
4501
  :project_arn,
3964
4502
  :creation_timestamp,
3965
- :status)
4503
+ :status,
4504
+ :datasets)
3966
4505
  SENSITIVE = []
3967
4506
  include Aws::Structure
3968
4507
  end
3969
4508
 
3970
- # The description of a version of a model.
4509
+ # A description of a version of an Amazon Rekognition Custom Labels
4510
+ # model.
3971
4511
  #
3972
4512
  # @!attribute [rw] project_version_arn
3973
4513
  # The Amazon Resource Name (ARN) of the model version.
@@ -3991,9 +4531,9 @@ module Aws::Rekognition
3991
4531
  # @return [String]
3992
4532
  #
3993
4533
  # @!attribute [rw] billable_training_time_in_seconds
3994
- # The duration, in seconds, that the model version has been billed for
3995
- # training. This value is only returned if the model version has been
3996
- # successfully trained.
4534
+ # The duration, in seconds, that you were billed for a successful
4535
+ # training of the model version. This value is only returned if the
4536
+ # model version has been successfully trained.
3997
4537
  # @return [Integer]
3998
4538
  #
3999
4539
  # @!attribute [rw] training_end_timestamp
@@ -4024,8 +4564,8 @@ module Aws::Rekognition
4024
4564
  # @return [Types::GroundTruthManifest]
4025
4565
  #
4026
4566
  # @!attribute [rw] kms_key_id
4027
- # The identifer for the AWS Key Management Service (AWS KMS) customer
4028
- # master key that was used to encrypt the model during training.
4567
+ # The identifer for the AWS Key Management Service key (AWS KMS key)
4568
+ # that was used to encrypt the model during training.
4029
4569
  # @return [String]
4030
4570
  #
4031
4571
  class ProjectVersionDescription < Struct.new(
@@ -5747,8 +6287,8 @@ module Aws::Rekognition
5747
6287
  end
5748
6288
 
5749
6289
  # The dataset used for testing. Optionally, if `AutoCreate` is set,
5750
- # Amazon Rekognition Custom Labels creates a testing dataset using an
5751
- # 80/20 split of the training dataset.
6290
+ # Amazon Rekognition Custom Labels uses the training dataset to create a
6291
+ # test dataset with a temporary split of the training dataset.
5752
6292
  #
5753
6293
  # @note When making an API call, you may pass TestingData
5754
6294
  # data as a hash:
@@ -5773,8 +6313,10 @@ module Aws::Rekognition
5773
6313
  # @return [Array<Types::Asset>]
5774
6314
  #
5775
6315
  # @!attribute [rw] auto_create
5776
- # If specified, Amazon Rekognition Custom Labels creates a testing
5777
- # dataset with an 80/20 split of the training dataset.
6316
+ # If specified, Amazon Rekognition Custom Labels temporarily splits
6317
+ # the training dataset (80%) to create a test dataset (20%) for the
6318
+ # training job. After training completes, the test dataset is not
6319
+ # stored and the training dataset reverts to its previous size.
5778
6320
  # @return [Boolean]
5779
6321
  #
5780
6322
  class TestingData < Struct.new(
@@ -6006,12 +6548,40 @@ module Aws::Rekognition
6006
6548
 
6007
6549
  class UntagResourceResponse < Aws::EmptyStructure; end
6008
6550
 
6551
+ # @note When making an API call, you may pass UpdateDatasetEntriesRequest
6552
+ # data as a hash:
6553
+ #
6554
+ # {
6555
+ # dataset_arn: "DatasetArn", # required
6556
+ # changes: { # required
6557
+ # ground_truth: "data", # required
6558
+ # },
6559
+ # }
6560
+ #
6561
+ # @!attribute [rw] dataset_arn
6562
+ # The Amazon Resource Name (ARN) of the dataset that you want to
6563
+ # update.
6564
+ # @return [String]
6565
+ #
6566
+ # @!attribute [rw] changes
6567
+ # The changes that you want to make to the dataset.
6568
+ # @return [Types::DatasetChanges]
6569
+ #
6570
+ class UpdateDatasetEntriesRequest < Struct.new(
6571
+ :dataset_arn,
6572
+ :changes)
6573
+ SENSITIVE = []
6574
+ include Aws::Structure
6575
+ end
6576
+
6577
+ class UpdateDatasetEntriesResponse < Aws::EmptyStructure; end
6578
+
6009
6579
  # Contains the Amazon S3 bucket location of the validation data for a
6010
6580
  # model training job.
6011
6581
  #
6012
6582
  # The validation data includes error information for individual JSON
6013
- # lines in the dataset. For more information, see Debugging a Failed
6014
- # Model Training in the Amazon Rekognition Custom Labels Developer
6583
+ # Lines in the dataset. For more information, see *Debugging a Failed
6584
+ # Model Training* in the Amazon Rekognition Custom Labels Developer
6015
6585
  # Guide.
6016
6586
  #
6017
6587
  # You get the `ValidationData` object for the training dataset