/AWS1/CL_LOV=>CREATEMODEL()
¶
About 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.
Method Signature¶
IMPORTING¶
Required arguments:¶
IV_PROJECTNAME
TYPE /AWS1/LOVPROJECTNAME
/AWS1/LOVPROJECTNAME
¶
The name of the project in which you want to create a model version.
IO_OUTPUTCONFIG
TYPE REF TO /AWS1/CL_LOVOUTPUTCONFIG
/AWS1/CL_LOVOUTPUTCONFIG
¶
The location where Amazon Lookout for Vision saves the training results.
Optional arguments:¶
IV_DESCRIPTION
TYPE /AWS1/LOVMODELDESCMESSAGE
/AWS1/LOVMODELDESCMESSAGE
¶
A description for the version of the model.
IV_CLIENTTOKEN
TYPE /AWS1/LOVCLIENTTOKEN
/AWS1/LOVCLIENTTOKEN
¶
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 fromCreateModel
. In this case, safely retry your call toCreateModel
by using the sameClientToken
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 forClientToken
is considered a new call toCreateModel
. An idempotency token is active for 8 hours.
IV_KMSKEYID
TYPE /AWS1/LOVKMSKEYID
/AWS1/LOVKMSKEYID
¶
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.
IT_TAGS
TYPE /AWS1/CL_LOVTAG=>TT_TAGLIST
TT_TAGLIST
¶
A set of tags (key-value pairs) that you want to attach to the model.