Container for the parameters to the UpdateDatasetEntries operation.
This operation applies only to Amazon Rekognition Custom Labels.
Adds or updates one or more entries (images) in a dataset. An entry is a JSON Line which contains the information for a single image, including the image location, assigned labels, and object location bounding boxes. For more information, see Image-Level labels in manifest files and Object localization in manifest files in the Amazon Rekognition Custom Labels Developer Guide.
If the source-ref field in the JSON line references an existing image, the
existing image in the dataset is updated. If source-ref field doesn't reference
an existing image, the image is added as a new image to the dataset.
You specify the changes that you want to make in the Changes input parameter.
There isn't a limit to the number JSON Lines that you can change, but the size of
Changes must be less than 5MB.
UpdateDatasetEntries returns immediatly, but the dataset update might take
a while to complete. Use DescribeDataset to check the current status. The dataset
updated successfully if the value of Status is UPDATE_COMPLETE.
To check if any non-terminal errors occured, call ListDatasetEntries and check
for the presence of errors lists in the JSON Lines.
Dataset update fails if a terminal error occurs (Status = UPDATE_FAILED).
Currently, you can't access the terminal error information from the Amazon Rekognition
Custom Labels SDK.
This operation requires permissions to perform the rekognition:UpdateDatasetEntries
action.
Inheritance Hierarchy
Amazon.Runtime.AmazonWebServiceRequest
Amazon.Rekognition.AmazonRekognitionRequest
Amazon.Rekognition.Model.UpdateDatasetEntriesRequest
Namespace: Amazon.Rekognition.Model
Assembly: AWSSDK.Rekognition.dll
Version: 3.x.y.z
Syntax
public class UpdateDatasetEntriesRequest : AmazonRekognitionRequest IAmazonWebServiceRequest
The UpdateDatasetEntriesRequest type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
UpdateDatasetEntriesRequest() |
Properties
| Name | Type | Description | |
|---|---|---|---|
|
|
Changes | Amazon.Rekognition.Model.DatasetChanges |
Gets and sets the property Changes. The changes that you want to make to the dataset. |
|
|
DatasetArn | System.String |
Gets and sets the property DatasetArn. The Amazon Resource Name (ARN) of the dataset that you want to update. |
Examples
Adds dataset entries to an Amazon Rekognition Custom Labels dataset.
To-add dataset entries to an Amazon Rekognition Custom Labels dataset
var client = new AmazonRekognitionClient();
var response = client.UpdateDatasetEntries(new UpdateDatasetEntriesRequest
{
Changes = new DatasetChanges { GroundTruth = new MemoryStream({"source-ref":"s3://custom-labels-console-us-east-1-111111111/assets/flowers_1_test_dataset/mediterranean_spurge4.jpg","mediterranean_spurge":1,"mediterranean_spurge-metadata":{"confidence":1,"job-name":"labeling-job/mediterranean_spurge","class-name":"mediterranean_spurge","human-annotated":"yes","creation-date":"2021-07-11T03:33:42.025Z","type":"groundtruth/image-classification"},"with_leaves":1,"with_leaves-metadata":{"confidence":1,"job-name":"labeling-job/with_leaves","class-name":"with_leaves","human-annotated":"yes","creation-date":"2021-07-11T03:33:42.025Z","type":"groundtruth/image-classification"}}) },
DatasetArn = "arn:aws:rekognition:us-east-1:111122223333:project/my-proj-2/dataset/train/1690564858106"
});
Version Information
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer, 3.5