Struct aws_sdk_lookoutvision::client::fluent_builders::CreateModel

pub struct CreateModel { /* private fields */ }

Fluent builder constructing a request to CreateModel.

Creates a new version of a model within an an Amazon Lookout for Vision project. CreateModel is an asynchronous operation in which Amazon Lookout for Vision trains, tests, and evaluates a new version of a model.

To get the current status, check the Status field returned in the response from DescribeModel.

If the project has a single dataset, Amazon Lookout for Vision internally splits the dataset to create a training and a test dataset. If the project has a training and a test dataset, Lookout for Vision uses the respective datasets to train and test the model.

After training completes, the evaluation metrics are stored at the location specified in OutputConfig.

This operation requires permissions to perform the lookoutvision:CreateModel operation. If you want to tag your model, you also require permission to the lookoutvision:TagResource operation.

Implementations

impl CreateModel

pub async fn send(self) -> Result<CreateModelOutput, SdkError<CreateModelError>>

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 project_name(self, input: impl Into<String>) -> Self

The name of the project in which you want to create a model version.

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

The name of the project in which you want to create a model version.

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

A description for the version of the model.

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

A description for the version of the model.

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

ClientToken is an idempotency token that ensures a call to CreateModel completes only once. You choose the value to pass. For example, An issue might prevent you from getting a response from CreateModel. In this case, safely retry your call to CreateModel by using the same ClientToken parameter value.

If you don't supply a value for ClientToken, the AWS SDK you are using inserts a value for you. This prevents retries after a network error from starting multiple training jobs. You'll need to provide your own value for other use cases.

An error occurs if the other input parameters are not the same as in the first request. Using a different value for ClientToken is considered a new call to CreateModel. An idempotency token is active for 8 hours.

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

ClientToken is an idempotency token that ensures a call to CreateModel completes only once. You choose the value to pass. For example, An issue might prevent you from getting a response from CreateModel. In this case, safely retry your call to CreateModel by using the same ClientToken parameter value.

If you don't supply a value for ClientToken, the AWS SDK you are using inserts a value for you. This prevents retries after a network error from starting multiple training jobs. You'll need to provide your own value for other use cases.

An error occurs if the other input parameters are not the same as in the first request. Using a different value for ClientToken is considered a new call to CreateModel. An idempotency token is active for 8 hours.

pub fn output_config(self, input: OutputConfig) -> Self

The location where Amazon Lookout for Vision saves the training results.

pub fn set_output_config(self, input: Option<OutputConfig>) -> Self

The location where Amazon Lookout for Vision saves the training results.

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

The identifier for your AWS KMS key. The key is used to encrypt training and test images copied into the service for model training. Your source images are unaffected. If this parameter is not specified, the copied images are encrypted by a key that AWS owns and manages.

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

The identifier for your AWS KMS key. The key is used to encrypt training and test images copied into the service for model training. Your source images are unaffected. If this parameter is not specified, the copied images are encrypted by a key that AWS owns and manages.

pub fn tags(self, input: Tag) -> Self

Appends an item to Tags.

To override the contents of this collection use set_tags.

A set of tags (key-value pairs) that you want to attach to the model.

pub fn set_tags(self, input: Option<Vec<Tag>>) -> Self

A set of tags (key-value pairs) that you want to attach to the model.

Trait Implementations

impl Clone for CreateModel

fn clone(&self) -> CreateModel

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CreateModel

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

Formats the value using the given formatter.