@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAmazonLookoutforVision extends Object implements AmazonLookoutforVision
AmazonLookoutforVision
. Convenient method forms pass through to the corresponding
overload that takes a request object, which throws an UnsupportedOperationException
.ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
CreateDatasetResult |
createDataset(CreateDatasetRequest request)
Creates a new dataset in an Amazon Lookout for Vision project.
|
CreateModelResult |
createModel(CreateModelRequest request)
Creates a new version of a model within an an Amazon Lookout for Vision project.
|
CreateProjectResult |
createProject(CreateProjectRequest request)
Creates an empty Amazon Lookout for Vision project.
|
DeleteDatasetResult |
deleteDataset(DeleteDatasetRequest request)
Deletes an existing Amazon Lookout for Vision
dataset . |
DeleteModelResult |
deleteModel(DeleteModelRequest request)
Deletes an Amazon Lookout for Vision model.
|
DeleteProjectResult |
deleteProject(DeleteProjectRequest request)
Deletes an Amazon Lookout for Vision project.
|
DescribeDatasetResult |
describeDataset(DescribeDatasetRequest request)
Describe an Amazon Lookout for Vision dataset.
|
DescribeModelResult |
describeModel(DescribeModelRequest request)
Describes a version of an Amazon Lookout for Vision model.
|
DescribeModelPackagingJobResult |
describeModelPackagingJob(DescribeModelPackagingJobRequest request)
Describes an Amazon Lookout for Vision model packaging job.
|
DescribeProjectResult |
describeProject(DescribeProjectRequest request)
Describes an Amazon Lookout for Vision project.
|
DetectAnomaliesResult |
detectAnomalies(DetectAnomaliesRequest request)
Detects anomalies in an image that you supply.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
ListDatasetEntriesResult |
listDatasetEntries(ListDatasetEntriesRequest request)
Lists the JSON Lines within a dataset.
|
ListModelPackagingJobsResult |
listModelPackagingJobs(ListModelPackagingJobsRequest request)
Lists the model packaging jobs created for an Amazon Lookout for Vision project.
|
ListModelsResult |
listModels(ListModelsRequest request)
Lists the versions of a model in an Amazon Lookout for Vision project.
|
ListProjectsResult |
listProjects(ListProjectsRequest request)
Lists the Amazon Lookout for Vision projects in your AWS account that are in the AWS Region in which you call
ListProjects . |
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest request)
Returns a list of tags attached to the specified Amazon Lookout for Vision model.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
StartModelResult |
startModel(StartModelRequest request)
Starts the running of the version of an Amazon Lookout for Vision model.
|
StartModelPackagingJobResult |
startModelPackagingJob(StartModelPackagingJobRequest request)
Starts an Amazon Lookout for Vision model packaging job.
|
StopModelResult |
stopModel(StopModelRequest request)
Stops the hosting of a running model.
|
TagResourceResult |
tagResource(TagResourceRequest request)
Adds one or more key-value tags to an Amazon Lookout for Vision model.
|
UntagResourceResult |
untagResource(UntagResourceRequest request)
Removes one or more tags from an Amazon Lookout for Vision model.
|
UpdateDatasetEntriesResult |
updateDatasetEntries(UpdateDatasetEntriesRequest request)
Adds or updates one or more JSON Line entries in a dataset.
|
public CreateDatasetResult createDataset(CreateDatasetRequest request)
AmazonLookoutforVision
Creates a new dataset in an Amazon Lookout for Vision project. CreateDataset
can create a training
or a test dataset from a valid dataset source (DatasetSource
).
If you want a single dataset project, specify train
for the value of DatasetType
.
To have a project with separate training and test datasets, call CreateDataset
twice. On the first
call, specify train
for the value of DatasetType
. On the second call, specify
test
for the value of DatasetType
.
This operation requires permissions to perform the lookoutvision:CreateDataset
operation.
createDataset
in interface AmazonLookoutforVision
public CreateModelResult createModel(CreateModelRequest request)
AmazonLookoutforVision
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.
createModel
in interface AmazonLookoutforVision
public CreateProjectResult createProject(CreateProjectRequest request)
AmazonLookoutforVision
Creates an empty Amazon Lookout for Vision project. After you create the project, add a dataset by calling CreateDataset.
This operation requires permissions to perform the lookoutvision:CreateProject
operation.
createProject
in interface AmazonLookoutforVision
public DeleteDatasetResult deleteDataset(DeleteDatasetRequest request)
AmazonLookoutforVision
Deletes an existing Amazon Lookout for Vision dataset
.
If your the project has a single dataset, you must create a new dataset before you can create a model.
If you project has a training dataset and a test dataset consider the following.
If you delete the test dataset, your project reverts to a single dataset project. If you then train the model, Amazon Lookout for Vision internally splits the remaining dataset into a training and test dataset.
If you delete the training dataset, you must create a training dataset before you can create a model.
This operation requires permissions to perform the lookoutvision:DeleteDataset
operation.
deleteDataset
in interface AmazonLookoutforVision
public DeleteModelResult deleteModel(DeleteModelRequest request)
AmazonLookoutforVision
Deletes an Amazon Lookout for Vision model. You can't delete a running model. To stop a running model, use the StopModel operation.
It might take a few seconds to delete a model. To determine if a model has been deleted, call ListModels
and check if the version of the model (ModelVersion
) is in the Models
array.
This operation requires permissions to perform the lookoutvision:DeleteModel
operation.
deleteModel
in interface AmazonLookoutforVision
public DeleteProjectResult deleteProject(DeleteProjectRequest request)
AmazonLookoutforVision
Deletes an Amazon Lookout for Vision project.
To delete a project, you must first delete each version of the model associated with the project. To delete a model use the DeleteModel operation.
You also have to delete the dataset(s) associated with the model. For more information, see DeleteDataset. The images referenced by the training and test datasets aren't deleted.
This operation requires permissions to perform the lookoutvision:DeleteProject
operation.
deleteProject
in interface AmazonLookoutforVision
public DescribeDatasetResult describeDataset(DescribeDatasetRequest request)
AmazonLookoutforVision
Describe an Amazon Lookout for Vision dataset.
This operation requires permissions to perform the lookoutvision:DescribeDataset
operation.
describeDataset
in interface AmazonLookoutforVision
public DescribeModelResult describeModel(DescribeModelRequest request)
AmazonLookoutforVision
Describes a version of an Amazon Lookout for Vision model.
This operation requires permissions to perform the lookoutvision:DescribeModel
operation.
describeModel
in interface AmazonLookoutforVision
public DescribeModelPackagingJobResult describeModelPackagingJob(DescribeModelPackagingJobRequest request)
AmazonLookoutforVision
Describes an Amazon Lookout for Vision model packaging job.
This operation requires permissions to perform the lookoutvision:DescribeModelPackagingJob
operation.
For more information, see Using your Amazon Lookout for Vision model on an edge device in the Amazon Lookout for Vision Developer Guide.
describeModelPackagingJob
in interface AmazonLookoutforVision
public DescribeProjectResult describeProject(DescribeProjectRequest request)
AmazonLookoutforVision
Describes an Amazon Lookout for Vision project.
This operation requires permissions to perform the lookoutvision:DescribeProject
operation.
describeProject
in interface AmazonLookoutforVision
public DetectAnomaliesResult detectAnomalies(DetectAnomaliesRequest request)
AmazonLookoutforVision
Detects anomalies in an image that you supply.
The response from DetectAnomalies
includes a boolean prediction that the image contains one or more
anomalies and a confidence value for the prediction. If the model is an image segmentation model, the response
also includes segmentation information for each type of anomaly found in the image.
Before calling DetectAnomalies
, you must first start your model with the StartModel
operation. You are charged for the amount of time, in minutes, that a model runs and for the number of anomaly
detection units that your model uses. If you are not using a model, use the StopModel operation to stop
your model.
For more information, see Detecting anomalies in an image in the Amazon Lookout for Vision developer guide.
This operation requires permissions to perform the lookoutvision:DetectAnomalies
operation.
detectAnomalies
in interface AmazonLookoutforVision
public ListDatasetEntriesResult listDatasetEntries(ListDatasetEntriesRequest request)
AmazonLookoutforVision
Lists the JSON Lines within a dataset. An Amazon Lookout for Vision JSON Line contains the anomaly information for a single image, including the image location and the assigned label.
This operation requires permissions to perform the lookoutvision:ListDatasetEntries
operation.
listDatasetEntries
in interface AmazonLookoutforVision
public ListModelPackagingJobsResult listModelPackagingJobs(ListModelPackagingJobsRequest request)
AmazonLookoutforVision
Lists the model packaging jobs created for an Amazon Lookout for Vision project.
This operation requires permissions to perform the lookoutvision:ListModelPackagingJobs
operation.
For more information, see Using your Amazon Lookout for Vision model on an edge device in the Amazon Lookout for Vision Developer Guide.
listModelPackagingJobs
in interface AmazonLookoutforVision
public ListModelsResult listModels(ListModelsRequest request)
AmazonLookoutforVision
Lists the versions of a model in an Amazon Lookout for Vision project.
The ListModels
operation is eventually consistent. Recent calls to CreateModel
might
take a while to appear in the response from ListProjects
.
This operation requires permissions to perform the lookoutvision:ListModels
operation.
listModels
in interface AmazonLookoutforVision
public ListProjectsResult listProjects(ListProjectsRequest request)
AmazonLookoutforVision
Lists the Amazon Lookout for Vision projects in your AWS account that are in the AWS Region in which you call
ListProjects
.
The ListProjects
operation is eventually consistent. Recent calls to CreateProject
and
DeleteProject
might take a while to appear in the response from ListProjects
.
This operation requires permissions to perform the lookoutvision:ListProjects
operation.
listProjects
in interface AmazonLookoutforVision
public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
AmazonLookoutforVision
Returns a list of tags attached to the specified Amazon Lookout for Vision model.
This operation requires permissions to perform the lookoutvision:ListTagsForResource
operation.
listTagsForResource
in interface AmazonLookoutforVision
public StartModelResult startModel(StartModelRequest request)
AmazonLookoutforVision
Starts the running of the version of an Amazon Lookout for Vision model. Starting a model takes a while to complete. To check the current state of the model, use DescribeModel.
A model is ready to use when its status is HOSTED
.
Once the model is running, you can detect custom labels in new images by calling DetectAnomalies.
You are charged for the amount of time that the model is running. To stop a running model, call StopModel.
This operation requires permissions to perform the lookoutvision:StartModel
operation.
startModel
in interface AmazonLookoutforVision
public StartModelPackagingJobResult startModelPackagingJob(StartModelPackagingJobRequest request)
AmazonLookoutforVision
Starts an Amazon Lookout for Vision model packaging job. A model packaging job creates an AWS IoT Greengrass component for a Lookout for Vision model. You can use the component to deploy your model to an edge device managed by Greengrass.
Use the DescribeModelPackagingJob API to determine the current status of the job. The model packaging job
is complete if the value of Status
is SUCCEEDED
.
To deploy the component to the target device, use the component name and component version with the AWS IoT Greengrass CreateDeployment API.
This operation requires the following permissions:
lookoutvision:StartModelPackagingJob
s3:PutObject
s3:GetBucketLocation
kms:GenerateDataKey
greengrass:CreateComponentVersion
greengrass:DescribeComponent
(Optional) greengrass:TagResource
. Only required if you want to tag the component.
For more information, see Using your Amazon Lookout for Vision model on an edge device in the Amazon Lookout for Vision Developer Guide.
startModelPackagingJob
in interface AmazonLookoutforVision
public StopModelResult stopModel(StopModelRequest request)
AmazonLookoutforVision
Stops the hosting of a running model. The operation might take a while to complete. To check the current status, call DescribeModel.
After the model hosting stops, the Status
of the model is TRAINED
.
This operation requires permissions to perform the lookoutvision:StopModel
operation.
stopModel
in interface AmazonLookoutforVision
public TagResourceResult tagResource(TagResourceRequest request)
AmazonLookoutforVision
Adds one or more key-value tags to an Amazon Lookout for Vision model. For more information, see Tagging a model in the Amazon Lookout for Vision Developer Guide.
This operation requires permissions to perform the lookoutvision:TagResource
operation.
tagResource
in interface AmazonLookoutforVision
public UntagResourceResult untagResource(UntagResourceRequest request)
AmazonLookoutforVision
Removes one or more tags from an Amazon Lookout for Vision model. For more information, see Tagging a model in the Amazon Lookout for Vision Developer Guide.
This operation requires permissions to perform the lookoutvision:UntagResource
operation.
untagResource
in interface AmazonLookoutforVision
public UpdateDatasetEntriesResult updateDatasetEntries(UpdateDatasetEntriesRequest request)
AmazonLookoutforVision
Adds or updates one or more JSON Line entries in a dataset. A JSON Line includes information about an image used for training or testing an Amazon Lookout for Vision model.
To update an existing JSON Line, use the source-ref
field to identify the JSON Line. The JSON line
that you supply replaces the existing JSON line. Any existing annotations that are not in the new JSON line are
removed from the dataset.
For more information, see Defining JSON lines for anomaly classification in the Amazon Lookout for Vision Developer Guide.
The images you reference in the source-ref
field of a JSON line, must be in the same S3 bucket as
the existing images in the dataset.
Updating a dataset might take a while to complete. To check the current status, call DescribeDataset and
check the Status
field in the response.
This operation requires permissions to perform the lookoutvision:UpdateDatasetEntries
operation.
updateDatasetEntries
in interface AmazonLookoutforVision
public void shutdown()
AmazonLookoutforVision
shutdown
in interface AmazonLookoutforVision
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AmazonLookoutforVision
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
getCachedResponseMetadata
in interface AmazonLookoutforVision
request
- The originally executed request.