Struct aws_sdk_rekognition::client::fluent_builders::UpdateDatasetEntries

pub struct UpdateDatasetEntries { /* private fields */ }

Fluent builder constructing a request to UpdateDatasetEntries.

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.

Implementations

impl UpdateDatasetEntries

pub async fn customize(
    self
) -> Result<CustomizableOperation<UpdateDatasetEntries, AwsResponseRetryClassifier>, SdkError<UpdateDatasetEntriesError>>

Consume this builder, creating a customizable operation that can be modified before being sent. The operation’s inner http::Request can be modified as well.

pub async fn send(
    self
) -> Result<UpdateDatasetEntriesOutput, SdkError<UpdateDatasetEntriesError>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn dataset_arn(self, input: impl Into<String>) -> Self

The Amazon Resource Name (ARN) of the dataset that you want to update.

pub fn set_dataset_arn(self, input: Option<String>) -> Self

The Amazon Resource Name (ARN) of the dataset that you want to update.

pub fn changes(self, input: DatasetChanges) -> Self

The changes that you want to make to the dataset.

pub fn set_changes(self, input: Option<DatasetChanges>) -> Self

The changes that you want to make to the dataset.

Trait Implementations

impl Clone for UpdateDatasetEntries

fn clone(&self) -> UpdateDatasetEntries

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UpdateDatasetEntries

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.