Interface LookoutVisionAsyncClient
- All Superinterfaces:
AutoCloseable
,AwsClient
,SdkAutoCloseable
,SdkClient
builder()
method.The asynchronous client performs non-blocking I/O when configured with any
invalid reference
SdkAsyncHttpClient
This is the Amazon Lookout for Vision API Reference. It provides descriptions of actions, data types, common parameters, and common errors.
Amazon Lookout for Vision enables you to find visual defects in industrial products, accurately and at scale. It uses computer vision to identify missing components in an industrial product, damage to vehicles or structures, irregularities in production lines, and even minuscule defects in silicon wafers — or any other physical item where quality is important such as a missing capacitor on printed circuit boards.
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Value for looking up the service's metadata from theServiceMetadataProvider
.static final String
-
Method Summary
Modifier and TypeMethodDescriptionbuilder()
Create a builder that can be used to configure and create aLookoutVisionAsyncClient
.static LookoutVisionAsyncClient
create()
Create aLookoutVisionAsyncClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
.default CompletableFuture
<CreateDatasetResponse> createDataset
(Consumer<CreateDatasetRequest.Builder> createDatasetRequest) Creates a new dataset in an Amazon Lookout for Vision project.default CompletableFuture
<CreateDatasetResponse> createDataset
(CreateDatasetRequest createDatasetRequest) Creates a new dataset in an Amazon Lookout for Vision project.default CompletableFuture
<CreateModelResponse> createModel
(Consumer<CreateModelRequest.Builder> createModelRequest) Creates a new version of a model within an an Amazon Lookout for Vision project.default CompletableFuture
<CreateModelResponse> createModel
(CreateModelRequest createModelRequest) Creates a new version of a model within an an Amazon Lookout for Vision project.default CompletableFuture
<CreateProjectResponse> createProject
(Consumer<CreateProjectRequest.Builder> createProjectRequest) Creates an empty Amazon Lookout for Vision project.default CompletableFuture
<CreateProjectResponse> createProject
(CreateProjectRequest createProjectRequest) Creates an empty Amazon Lookout for Vision project.default CompletableFuture
<DeleteDatasetResponse> deleteDataset
(Consumer<DeleteDatasetRequest.Builder> deleteDatasetRequest) Deletes an existing Amazon Lookout for Visiondataset
.default CompletableFuture
<DeleteDatasetResponse> deleteDataset
(DeleteDatasetRequest deleteDatasetRequest) Deletes an existing Amazon Lookout for Visiondataset
.default CompletableFuture
<DeleteModelResponse> deleteModel
(Consumer<DeleteModelRequest.Builder> deleteModelRequest) Deletes an Amazon Lookout for Vision model.default CompletableFuture
<DeleteModelResponse> deleteModel
(DeleteModelRequest deleteModelRequest) Deletes an Amazon Lookout for Vision model.default CompletableFuture
<DeleteProjectResponse> deleteProject
(Consumer<DeleteProjectRequest.Builder> deleteProjectRequest) Deletes an Amazon Lookout for Vision project.default CompletableFuture
<DeleteProjectResponse> deleteProject
(DeleteProjectRequest deleteProjectRequest) Deletes an Amazon Lookout for Vision project.default CompletableFuture
<DescribeDatasetResponse> describeDataset
(Consumer<DescribeDatasetRequest.Builder> describeDatasetRequest) Describe an Amazon Lookout for Vision dataset.default CompletableFuture
<DescribeDatasetResponse> describeDataset
(DescribeDatasetRequest describeDatasetRequest) Describe an Amazon Lookout for Vision dataset.default CompletableFuture
<DescribeModelResponse> describeModel
(Consumer<DescribeModelRequest.Builder> describeModelRequest) Describes a version of an Amazon Lookout for Vision model.default CompletableFuture
<DescribeModelResponse> describeModel
(DescribeModelRequest describeModelRequest) Describes a version of an Amazon Lookout for Vision model.describeModelPackagingJob
(Consumer<DescribeModelPackagingJobRequest.Builder> describeModelPackagingJobRequest) Describes an Amazon Lookout for Vision model packaging job.describeModelPackagingJob
(DescribeModelPackagingJobRequest describeModelPackagingJobRequest) Describes an Amazon Lookout for Vision model packaging job.default CompletableFuture
<DescribeProjectResponse> describeProject
(Consumer<DescribeProjectRequest.Builder> describeProjectRequest) Describes an Amazon Lookout for Vision project.default CompletableFuture
<DescribeProjectResponse> describeProject
(DescribeProjectRequest describeProjectRequest) Describes an Amazon Lookout for Vision project.default CompletableFuture
<DetectAnomaliesResponse> detectAnomalies
(Consumer<DetectAnomaliesRequest.Builder> detectAnomaliesRequest, Path sourcePath) Detects anomalies in an image that you supply.default CompletableFuture
<DetectAnomaliesResponse> detectAnomalies
(Consumer<DetectAnomaliesRequest.Builder> detectAnomaliesRequest, AsyncRequestBody requestBody) Detects anomalies in an image that you supply.default CompletableFuture
<DetectAnomaliesResponse> detectAnomalies
(DetectAnomaliesRequest detectAnomaliesRequest, Path sourcePath) Detects anomalies in an image that you supply.default CompletableFuture
<DetectAnomaliesResponse> detectAnomalies
(DetectAnomaliesRequest detectAnomaliesRequest, AsyncRequestBody requestBody) Detects anomalies in an image that you supply.listDatasetEntries
(Consumer<ListDatasetEntriesRequest.Builder> listDatasetEntriesRequest) Lists the JSON Lines within a dataset.listDatasetEntries
(ListDatasetEntriesRequest listDatasetEntriesRequest) Lists the JSON Lines within a dataset.default ListDatasetEntriesPublisher
listDatasetEntriesPaginator
(Consumer<ListDatasetEntriesRequest.Builder> listDatasetEntriesRequest) This is a variant oflistDatasetEntries(software.amazon.awssdk.services.lookoutvision.model.ListDatasetEntriesRequest)
operation.default ListDatasetEntriesPublisher
listDatasetEntriesPaginator
(ListDatasetEntriesRequest listDatasetEntriesRequest) This is a variant oflistDatasetEntries(software.amazon.awssdk.services.lookoutvision.model.ListDatasetEntriesRequest)
operation.listModelPackagingJobs
(Consumer<ListModelPackagingJobsRequest.Builder> listModelPackagingJobsRequest) Lists the model packaging jobs created for an Amazon Lookout for Vision project.listModelPackagingJobs
(ListModelPackagingJobsRequest listModelPackagingJobsRequest) Lists the model packaging jobs created for an Amazon Lookout for Vision project.default ListModelPackagingJobsPublisher
listModelPackagingJobsPaginator
(Consumer<ListModelPackagingJobsRequest.Builder> listModelPackagingJobsRequest) This is a variant oflistModelPackagingJobs(software.amazon.awssdk.services.lookoutvision.model.ListModelPackagingJobsRequest)
operation.default ListModelPackagingJobsPublisher
listModelPackagingJobsPaginator
(ListModelPackagingJobsRequest listModelPackagingJobsRequest) This is a variant oflistModelPackagingJobs(software.amazon.awssdk.services.lookoutvision.model.ListModelPackagingJobsRequest)
operation.default CompletableFuture
<ListModelsResponse> listModels
(Consumer<ListModelsRequest.Builder> listModelsRequest) Lists the versions of a model in an Amazon Lookout for Vision project.default CompletableFuture
<ListModelsResponse> listModels
(ListModelsRequest listModelsRequest) Lists the versions of a model in an Amazon Lookout for Vision project.default ListModelsPublisher
listModelsPaginator
(Consumer<ListModelsRequest.Builder> listModelsRequest) This is a variant oflistModels(software.amazon.awssdk.services.lookoutvision.model.ListModelsRequest)
operation.default ListModelsPublisher
listModelsPaginator
(ListModelsRequest listModelsRequest) This is a variant oflistModels(software.amazon.awssdk.services.lookoutvision.model.ListModelsRequest)
operation.default CompletableFuture
<ListProjectsResponse> listProjects
(Consumer<ListProjectsRequest.Builder> listProjectsRequest) Lists the Amazon Lookout for Vision projects in your AWS account that are in the AWS Region in which you callListProjects
.default CompletableFuture
<ListProjectsResponse> listProjects
(ListProjectsRequest listProjectsRequest) Lists the Amazon Lookout for Vision projects in your AWS account that are in the AWS Region in which you callListProjects
.default ListProjectsPublisher
listProjectsPaginator
(Consumer<ListProjectsRequest.Builder> listProjectsRequest) This is a variant oflistProjects(software.amazon.awssdk.services.lookoutvision.model.ListProjectsRequest)
operation.default ListProjectsPublisher
listProjectsPaginator
(ListProjectsRequest listProjectsRequest) This is a variant oflistProjects(software.amazon.awssdk.services.lookoutvision.model.ListProjectsRequest)
operation.listTagsForResource
(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Returns a list of tags attached to the specified Amazon Lookout for Vision model.listTagsForResource
(ListTagsForResourceRequest listTagsForResourceRequest) Returns a list of tags attached to the specified Amazon Lookout for Vision model.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationdefault CompletableFuture
<StartModelResponse> startModel
(Consumer<StartModelRequest.Builder> startModelRequest) Starts the running of the version of an Amazon Lookout for Vision model.default CompletableFuture
<StartModelResponse> startModel
(StartModelRequest startModelRequest) Starts the running of the version of an Amazon Lookout for Vision model.startModelPackagingJob
(Consumer<StartModelPackagingJobRequest.Builder> startModelPackagingJobRequest) Starts an Amazon Lookout for Vision model packaging job.startModelPackagingJob
(StartModelPackagingJobRequest startModelPackagingJobRequest) Starts an Amazon Lookout for Vision model packaging job.default CompletableFuture
<StopModelResponse> stopModel
(Consumer<StopModelRequest.Builder> stopModelRequest) Stops the hosting of a running model.default CompletableFuture
<StopModelResponse> stopModel
(StopModelRequest stopModelRequest) Stops the hosting of a running model.default CompletableFuture
<TagResourceResponse> tagResource
(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds one or more key-value tags to an Amazon Lookout for Vision model.default CompletableFuture
<TagResourceResponse> tagResource
(TagResourceRequest tagResourceRequest) Adds one or more key-value tags to an Amazon Lookout for Vision model.default CompletableFuture
<UntagResourceResponse> untagResource
(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes one or more tags from an Amazon Lookout for Vision model.default CompletableFuture
<UntagResourceResponse> untagResource
(UntagResourceRequest untagResourceRequest) Removes one or more tags from an Amazon Lookout for Vision model.updateDatasetEntries
(Consumer<UpdateDatasetEntriesRequest.Builder> updateDatasetEntriesRequest) Adds or updates one or more JSON Line entries in a dataset.updateDatasetEntries
(UpdateDatasetEntriesRequest updateDatasetEntriesRequest) Adds or updates one or more JSON Line entries in a dataset.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close
Methods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider
.- See Also:
-
-
Method Details
-
createDataset
default CompletableFuture<CreateDatasetResponse> createDataset(CreateDatasetRequest createDatasetRequest) 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 ofDatasetType
.To have a project with separate training and test datasets, call
CreateDataset
twice. On the first call, specifytrain
for the value ofDatasetType
. On the second call, specifytest
for the value ofDatasetType
.This operation requires permissions to perform the
lookoutvision:CreateDataset
operation.- Parameters:
createDatasetRequest
-- Returns:
- A Java Future containing the result of the CreateDataset operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createDataset
default CompletableFuture<CreateDatasetResponse> createDataset(Consumer<CreateDatasetRequest.Builder> createDatasetRequest) 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 ofDatasetType
.To have a project with separate training and test datasets, call
CreateDataset
twice. On the first call, specifytrain
for the value ofDatasetType
. On the second call, specifytest
for the value ofDatasetType
.This operation requires permissions to perform the
lookoutvision:CreateDataset
operation.
This is a convenience which creates an instance of the
CreateDatasetRequest.Builder
avoiding the need to create one manually viaCreateDatasetRequest.builder()
- Parameters:
createDatasetRequest
- AConsumer
that will call methods onCreateDatasetRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the CreateDataset operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
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 thelookoutvision:TagResource
operation.- Parameters:
createModelRequest
-- Returns:
- A Java Future containing the result of the CreateModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createModel
default CompletableFuture<CreateModelResponse> createModel(Consumer<CreateModelRequest.Builder> createModelRequest) 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 thelookoutvision:TagResource
operation.
This is a convenience which creates an instance of the
CreateModelRequest.Builder
avoiding the need to create one manually viaCreateModelRequest.builder()
- Parameters:
createModelRequest
- AConsumer
that will call methods onCreateModelRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the CreateModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createProject
default CompletableFuture<CreateProjectResponse> createProject(CreateProjectRequest createProjectRequest) 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.- Parameters:
createProjectRequest
-- Returns:
- A Java Future containing the result of the CreateProject operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createProject
default CompletableFuture<CreateProjectResponse> createProject(Consumer<CreateProjectRequest.Builder> createProjectRequest) 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.
This is a convenience which creates an instance of the
CreateProjectRequest.Builder
avoiding the need to create one manually viaCreateProjectRequest.builder()
- Parameters:
createProjectRequest
- AConsumer
that will call methods onCreateProjectRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the CreateProject operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteDataset
default CompletableFuture<DeleteDatasetResponse> deleteDataset(DeleteDatasetRequest deleteDatasetRequest) 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.- Parameters:
deleteDatasetRequest
-- Returns:
- A Java Future containing the result of the DeleteDataset operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
-
deleteDataset
default CompletableFuture<DeleteDatasetResponse> deleteDataset(Consumer<DeleteDatasetRequest.Builder> deleteDatasetRequest) 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.
This is a convenience which creates an instance of the
DeleteDatasetRequest.Builder
avoiding the need to create one manually viaDeleteDatasetRequest.builder()
- Parameters:
deleteDatasetRequest
- AConsumer
that will call methods onDeleteDatasetRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DeleteDataset operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
-
deleteModel
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 theModels
array.This operation requires permissions to perform the
lookoutvision:DeleteModel
operation.- Parameters:
deleteModelRequest
-- Returns:
- A Java Future containing the result of the DeleteModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteModel
default CompletableFuture<DeleteModelResponse> deleteModel(Consumer<DeleteModelRequest.Builder> deleteModelRequest) 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 theModels
array.This operation requires permissions to perform the
lookoutvision:DeleteModel
operation.
This is a convenience which creates an instance of the
DeleteModelRequest.Builder
avoiding the need to create one manually viaDeleteModelRequest.builder()
- Parameters:
deleteModelRequest
- AConsumer
that will call methods onDeleteModelRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DeleteModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteProject
default CompletableFuture<DeleteProjectResponse> deleteProject(DeleteProjectRequest deleteProjectRequest) 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.- Parameters:
deleteProjectRequest
-- Returns:
- A Java Future containing the result of the DeleteProject operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteProject
default CompletableFuture<DeleteProjectResponse> deleteProject(Consumer<DeleteProjectRequest.Builder> deleteProjectRequest) 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.
This is a convenience which creates an instance of the
DeleteProjectRequest.Builder
avoiding the need to create one manually viaDeleteProjectRequest.builder()
- Parameters:
deleteProjectRequest
- AConsumer
that will call methods onDeleteProjectRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DeleteProject operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeDataset
default CompletableFuture<DescribeDatasetResponse> describeDataset(DescribeDatasetRequest describeDatasetRequest) Describe an Amazon Lookout for Vision dataset.
This operation requires permissions to perform the
lookoutvision:DescribeDataset
operation.- Parameters:
describeDatasetRequest
-- Returns:
- A Java Future containing the result of the DescribeDataset operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeDataset
default CompletableFuture<DescribeDatasetResponse> describeDataset(Consumer<DescribeDatasetRequest.Builder> describeDatasetRequest) Describe an Amazon Lookout for Vision dataset.
This operation requires permissions to perform the
lookoutvision:DescribeDataset
operation.
This is a convenience which creates an instance of the
DescribeDatasetRequest.Builder
avoiding the need to create one manually viaDescribeDatasetRequest.builder()
- Parameters:
describeDatasetRequest
- AConsumer
that will call methods onDescribeDatasetRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeDataset operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeModel
default CompletableFuture<DescribeModelResponse> describeModel(DescribeModelRequest describeModelRequest) Describes a version of an Amazon Lookout for Vision model.
This operation requires permissions to perform the
lookoutvision:DescribeModel
operation.- Parameters:
describeModelRequest
-- Returns:
- A Java Future containing the result of the DescribeModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeModel
default CompletableFuture<DescribeModelResponse> describeModel(Consumer<DescribeModelRequest.Builder> describeModelRequest) Describes a version of an Amazon Lookout for Vision model.
This operation requires permissions to perform the
lookoutvision:DescribeModel
operation.
This is a convenience which creates an instance of the
DescribeModelRequest.Builder
avoiding the need to create one manually viaDescribeModelRequest.builder()
- Parameters:
describeModelRequest
- AConsumer
that will call methods onDescribeModelRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeModelPackagingJob
default CompletableFuture<DescribeModelPackagingJobResponse> describeModelPackagingJob(DescribeModelPackagingJobRequest describeModelPackagingJobRequest) 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.
- Parameters:
describeModelPackagingJobRequest
-- Returns:
- A Java Future containing the result of the DescribeModelPackagingJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeModelPackagingJob
default CompletableFuture<DescribeModelPackagingJobResponse> describeModelPackagingJob(Consumer<DescribeModelPackagingJobRequest.Builder> describeModelPackagingJobRequest) 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.
This is a convenience which creates an instance of the
DescribeModelPackagingJobRequest.Builder
avoiding the need to create one manually viaDescribeModelPackagingJobRequest.builder()
- Parameters:
describeModelPackagingJobRequest
- AConsumer
that will call methods onDescribeModelPackagingJobRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeModelPackagingJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeProject
default CompletableFuture<DescribeProjectResponse> describeProject(DescribeProjectRequest describeProjectRequest) Describes an Amazon Lookout for Vision project.
This operation requires permissions to perform the
lookoutvision:DescribeProject
operation.- Parameters:
describeProjectRequest
-- Returns:
- A Java Future containing the result of the DescribeProject operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeProject
default CompletableFuture<DescribeProjectResponse> describeProject(Consumer<DescribeProjectRequest.Builder> describeProjectRequest) Describes an Amazon Lookout for Vision project.
This operation requires permissions to perform the
lookoutvision:DescribeProject
operation.
This is a convenience which creates an instance of the
DescribeProjectRequest.Builder
avoiding the need to create one manually viaDescribeProjectRequest.builder()
- Parameters:
describeProjectRequest
- AConsumer
that will call methods onDescribeProjectRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeProject operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
detectAnomalies
default CompletableFuture<DetectAnomaliesResponse> detectAnomalies(DetectAnomaliesRequest detectAnomaliesRequest, AsyncRequestBody requestBody) 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.- Parameters:
detectAnomaliesRequest
-requestBody
- Functional interface that can be implemented to produce the request content in a non-blocking manner. The size of the content is expected to be known up front. SeeAsyncRequestBody
for specific details on implementing this interface as well as links to precanned implementations for common scenarios like uploading from a file. The service documentation for the request content is as follows 'The unencrypted image bytes that you want to analyze.
'- Returns:
- A Java Future containing the result of the DetectAnomalies operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
detectAnomalies
default CompletableFuture<DetectAnomaliesResponse> detectAnomalies(Consumer<DetectAnomaliesRequest.Builder> detectAnomaliesRequest, AsyncRequestBody requestBody) 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.
This is a convenience which creates an instance of the
DetectAnomaliesRequest.Builder
avoiding the need to create one manually viaDetectAnomaliesRequest.builder()
- Parameters:
detectAnomaliesRequest
- AConsumer
that will call methods onDetectAnomaliesRequest.Builder
to create a request.requestBody
- Functional interface that can be implemented to produce the request content in a non-blocking manner. The size of the content is expected to be known up front. SeeAsyncRequestBody
for specific details on implementing this interface as well as links to precanned implementations for common scenarios like uploading from a file. The service documentation for the request content is as follows 'The unencrypted image bytes that you want to analyze.
'- Returns:
- A Java Future containing the result of the DetectAnomalies operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
detectAnomalies
default CompletableFuture<DetectAnomaliesResponse> detectAnomalies(DetectAnomaliesRequest detectAnomaliesRequest, Path sourcePath) 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.- Parameters:
detectAnomaliesRequest
-sourcePath
-Path
to file containing data to send to the service. File will be read entirely and may be read multiple times in the event of a retry. If the file does not exist or the current user does not have access to read it then an exception will be thrown. The service documentation for the request content is as follows 'The unencrypted image bytes that you want to analyze.
'- Returns:
- A Java Future containing the result of the DetectAnomalies operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
detectAnomalies
default CompletableFuture<DetectAnomaliesResponse> detectAnomalies(Consumer<DetectAnomaliesRequest.Builder> detectAnomaliesRequest, Path sourcePath) 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.
This is a convenience which creates an instance of the
DetectAnomaliesRequest.Builder
avoiding the need to create one manually viaDetectAnomaliesRequest.builder()
- Parameters:
detectAnomaliesRequest
- AConsumer
that will call methods onDetectAnomaliesRequest.Builder
to create a request.sourcePath
-Path
to file containing data to send to the service. File will be read entirely and may be read multiple times in the event of a retry. If the file does not exist or the current user does not have access to read it then an exception will be thrown. The service documentation for the request content is as follows 'The unencrypted image bytes that you want to analyze.
'- Returns:
- A Java Future containing the result of the DetectAnomalies operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listDatasetEntries
default CompletableFuture<ListDatasetEntriesResponse> listDatasetEntries(ListDatasetEntriesRequest listDatasetEntriesRequest) 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.- Parameters:
listDatasetEntriesRequest
-- Returns:
- A Java Future containing the result of the ListDatasetEntries operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listDatasetEntries
default CompletableFuture<ListDatasetEntriesResponse> listDatasetEntries(Consumer<ListDatasetEntriesRequest.Builder> listDatasetEntriesRequest) 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.
This is a convenience which creates an instance of the
ListDatasetEntriesRequest.Builder
avoiding the need to create one manually viaListDatasetEntriesRequest.builder()
- Parameters:
listDatasetEntriesRequest
- AConsumer
that will call methods onListDatasetEntriesRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListDatasetEntries operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listDatasetEntriesPaginator
default ListDatasetEntriesPublisher listDatasetEntriesPaginator(ListDatasetEntriesRequest listDatasetEntriesRequest) This is a variant of
listDatasetEntries(software.amazon.awssdk.services.lookoutvision.model.ListDatasetEntriesRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.lookoutvision.paginators.ListDatasetEntriesPublisher publisher = client.listDatasetEntriesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.lookoutvision.paginators.ListDatasetEntriesPublisher publisher = client.listDatasetEntriesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lookoutvision.model.ListDatasetEntriesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lookoutvision.model.ListDatasetEntriesResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listDatasetEntries(software.amazon.awssdk.services.lookoutvision.model.ListDatasetEntriesRequest)
operation.- Parameters:
listDatasetEntriesRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listDatasetEntriesPaginator
default ListDatasetEntriesPublisher listDatasetEntriesPaginator(Consumer<ListDatasetEntriesRequest.Builder> listDatasetEntriesRequest) This is a variant of
listDatasetEntries(software.amazon.awssdk.services.lookoutvision.model.ListDatasetEntriesRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.lookoutvision.paginators.ListDatasetEntriesPublisher publisher = client.listDatasetEntriesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.lookoutvision.paginators.ListDatasetEntriesPublisher publisher = client.listDatasetEntriesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lookoutvision.model.ListDatasetEntriesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lookoutvision.model.ListDatasetEntriesResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listDatasetEntries(software.amazon.awssdk.services.lookoutvision.model.ListDatasetEntriesRequest)
operation.
This is a convenience which creates an instance of the
ListDatasetEntriesRequest.Builder
avoiding the need to create one manually viaListDatasetEntriesRequest.builder()
- Parameters:
listDatasetEntriesRequest
- AConsumer
that will call methods onListDatasetEntriesRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listModelPackagingJobs
default CompletableFuture<ListModelPackagingJobsResponse> listModelPackagingJobs(ListModelPackagingJobsRequest listModelPackagingJobsRequest) 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.
- Parameters:
listModelPackagingJobsRequest
-- Returns:
- A Java Future containing the result of the ListModelPackagingJobs operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listModelPackagingJobs
default CompletableFuture<ListModelPackagingJobsResponse> listModelPackagingJobs(Consumer<ListModelPackagingJobsRequest.Builder> listModelPackagingJobsRequest) 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.
This is a convenience which creates an instance of the
ListModelPackagingJobsRequest.Builder
avoiding the need to create one manually viaListModelPackagingJobsRequest.builder()
- Parameters:
listModelPackagingJobsRequest
- AConsumer
that will call methods onListModelPackagingJobsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListModelPackagingJobs operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listModelPackagingJobsPaginator
default ListModelPackagingJobsPublisher listModelPackagingJobsPaginator(ListModelPackagingJobsRequest listModelPackagingJobsRequest) This is a variant of
listModelPackagingJobs(software.amazon.awssdk.services.lookoutvision.model.ListModelPackagingJobsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.lookoutvision.paginators.ListModelPackagingJobsPublisher publisher = client.listModelPackagingJobsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.lookoutvision.paginators.ListModelPackagingJobsPublisher publisher = client.listModelPackagingJobsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lookoutvision.model.ListModelPackagingJobsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lookoutvision.model.ListModelPackagingJobsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listModelPackagingJobs(software.amazon.awssdk.services.lookoutvision.model.ListModelPackagingJobsRequest)
operation.- Parameters:
listModelPackagingJobsRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listModelPackagingJobsPaginator
default ListModelPackagingJobsPublisher listModelPackagingJobsPaginator(Consumer<ListModelPackagingJobsRequest.Builder> listModelPackagingJobsRequest) This is a variant of
listModelPackagingJobs(software.amazon.awssdk.services.lookoutvision.model.ListModelPackagingJobsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.lookoutvision.paginators.ListModelPackagingJobsPublisher publisher = client.listModelPackagingJobsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.lookoutvision.paginators.ListModelPackagingJobsPublisher publisher = client.listModelPackagingJobsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lookoutvision.model.ListModelPackagingJobsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lookoutvision.model.ListModelPackagingJobsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listModelPackagingJobs(software.amazon.awssdk.services.lookoutvision.model.ListModelPackagingJobsRequest)
operation.
This is a convenience which creates an instance of the
ListModelPackagingJobsRequest.Builder
avoiding the need to create one manually viaListModelPackagingJobsRequest.builder()
- Parameters:
listModelPackagingJobsRequest
- AConsumer
that will call methods onListModelPackagingJobsRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listModels
Lists the versions of a model in an Amazon Lookout for Vision project.
The
ListModels
operation is eventually consistent. Recent calls toCreateModel
might take a while to appear in the response fromListProjects
.This operation requires permissions to perform the
lookoutvision:ListModels
operation.- Parameters:
listModelsRequest
-- Returns:
- A Java Future containing the result of the ListModels operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listModels
default CompletableFuture<ListModelsResponse> listModels(Consumer<ListModelsRequest.Builder> listModelsRequest) Lists the versions of a model in an Amazon Lookout for Vision project.
The
ListModels
operation is eventually consistent. Recent calls toCreateModel
might take a while to appear in the response fromListProjects
.This operation requires permissions to perform the
lookoutvision:ListModels
operation.
This is a convenience which creates an instance of the
ListModelsRequest.Builder
avoiding the need to create one manually viaListModelsRequest.builder()
- Parameters:
listModelsRequest
- AConsumer
that will call methods onListModelsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListModels operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listModelsPaginator
This is a variant of
listModels(software.amazon.awssdk.services.lookoutvision.model.ListModelsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.lookoutvision.paginators.ListModelsPublisher publisher = client.listModelsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.lookoutvision.paginators.ListModelsPublisher publisher = client.listModelsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lookoutvision.model.ListModelsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lookoutvision.model.ListModelsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listModels(software.amazon.awssdk.services.lookoutvision.model.ListModelsRequest)
operation.- Parameters:
listModelsRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listModelsPaginator
default ListModelsPublisher listModelsPaginator(Consumer<ListModelsRequest.Builder> listModelsRequest) This is a variant of
listModels(software.amazon.awssdk.services.lookoutvision.model.ListModelsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.lookoutvision.paginators.ListModelsPublisher publisher = client.listModelsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.lookoutvision.paginators.ListModelsPublisher publisher = client.listModelsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lookoutvision.model.ListModelsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lookoutvision.model.ListModelsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listModels(software.amazon.awssdk.services.lookoutvision.model.ListModelsRequest)
operation.
This is a convenience which creates an instance of the
ListModelsRequest.Builder
avoiding the need to create one manually viaListModelsRequest.builder()
- Parameters:
listModelsRequest
- AConsumer
that will call methods onListModelsRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listProjects
default CompletableFuture<ListProjectsResponse> listProjects(ListProjectsRequest listProjectsRequest) 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 toCreateProject
andDeleteProject
might take a while to appear in the response fromListProjects
.This operation requires permissions to perform the
lookoutvision:ListProjects
operation.- Parameters:
listProjectsRequest
-- Returns:
- A Java Future containing the result of the ListProjects operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listProjects
default CompletableFuture<ListProjectsResponse> listProjects(Consumer<ListProjectsRequest.Builder> listProjectsRequest) 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 toCreateProject
andDeleteProject
might take a while to appear in the response fromListProjects
.This operation requires permissions to perform the
lookoutvision:ListProjects
operation.
This is a convenience which creates an instance of the
ListProjectsRequest.Builder
avoiding the need to create one manually viaListProjectsRequest.builder()
- Parameters:
listProjectsRequest
- AConsumer
that will call methods onListProjectsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListProjects operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listProjectsPaginator
This is a variant of
listProjects(software.amazon.awssdk.services.lookoutvision.model.ListProjectsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.lookoutvision.paginators.ListProjectsPublisher publisher = client.listProjectsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.lookoutvision.paginators.ListProjectsPublisher publisher = client.listProjectsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lookoutvision.model.ListProjectsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lookoutvision.model.ListProjectsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listProjects(software.amazon.awssdk.services.lookoutvision.model.ListProjectsRequest)
operation.- Parameters:
listProjectsRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listProjectsPaginator
default ListProjectsPublisher listProjectsPaginator(Consumer<ListProjectsRequest.Builder> listProjectsRequest) This is a variant of
listProjects(software.amazon.awssdk.services.lookoutvision.model.ListProjectsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.lookoutvision.paginators.ListProjectsPublisher publisher = client.listProjectsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.lookoutvision.paginators.ListProjectsPublisher publisher = client.listProjectsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.lookoutvision.model.ListProjectsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.lookoutvision.model.ListProjectsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listProjects(software.amazon.awssdk.services.lookoutvision.model.ListProjectsRequest)
operation.
This is a convenience which creates an instance of the
ListProjectsRequest.Builder
avoiding the need to create one manually viaListProjectsRequest.builder()
- Parameters:
listProjectsRequest
- AConsumer
that will call methods onListProjectsRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Returns a list of tags attached to the specified Amazon Lookout for Vision model.
This operation requires permissions to perform the
lookoutvision:ListTagsForResource
operation.- Parameters:
listTagsForResourceRequest
-- Returns:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Returns a list of tags attached to the specified Amazon Lookout for Vision model.
This operation requires permissions to perform the
lookoutvision:ListTagsForResource
operation.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builder
avoiding the need to create one manually viaListTagsForResourceRequest.builder()
- Parameters:
listTagsForResourceRequest
- AConsumer
that will call methods onListTagsForResourceRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
startModel
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.- Parameters:
startModelRequest
-- Returns:
- A Java Future containing the result of the StartModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
startModel
default CompletableFuture<StartModelResponse> startModel(Consumer<StartModelRequest.Builder> startModelRequest) 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.
This is a convenience which creates an instance of the
StartModelRequest.Builder
avoiding the need to create one manually viaStartModelRequest.builder()
- Parameters:
startModelRequest
- AConsumer
that will call methods onStartModelRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the StartModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
startModelPackagingJob
default CompletableFuture<StartModelPackagingJobResponse> startModelPackagingJob(StartModelPackagingJobRequest startModelPackagingJobRequest) 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
isSUCCEEDED
.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.
- Parameters:
startModelPackagingJobRequest
-- Returns:
- A Java Future containing the result of the StartModelPackagingJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
-
startModelPackagingJob
default CompletableFuture<StartModelPackagingJobResponse> startModelPackagingJob(Consumer<StartModelPackagingJobRequest.Builder> startModelPackagingJobRequest) 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
isSUCCEEDED
.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.
This is a convenience which creates an instance of the
StartModelPackagingJobRequest.Builder
avoiding the need to create one manually viaStartModelPackagingJobRequest.builder()
- Parameters:
startModelPackagingJobRequest
- AConsumer
that will call methods onStartModelPackagingJobRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the StartModelPackagingJob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
-
stopModel
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 isTRAINED
.This operation requires permissions to perform the
lookoutvision:StopModel
operation.- Parameters:
stopModelRequest
-- Returns:
- A Java Future containing the result of the StopModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
stopModel
default CompletableFuture<StopModelResponse> stopModel(Consumer<StopModelRequest.Builder> stopModelRequest) 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 isTRAINED
.This operation requires permissions to perform the
lookoutvision:StopModel
operation.
This is a convenience which creates an instance of the
StopModelRequest.Builder
avoiding the need to create one manually viaStopModelRequest.builder()
- Parameters:
stopModelRequest
- AConsumer
that will call methods onStopModelRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the StopModel operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
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.- Parameters:
tagResourceRequest
-- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) 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.
This is a convenience which creates an instance of the
TagResourceRequest.Builder
avoiding the need to create one manually viaTagResourceRequest.builder()
- Parameters:
tagResourceRequest
- AConsumer
that will call methods onTagResourceRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- ServiceQuotaExceededException A service quota was exceeded the allowed limit. For more information, see Limits in Amazon Lookout for Vision in the Amazon Lookout for Vision Developer Guide.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) 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.- Parameters:
untagResourceRequest
-- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) 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.
This is a convenience which creates an instance of the
UntagResourceRequest.Builder
avoiding the need to create one manually viaUntagResourceRequest.builder()
- Parameters:
untagResourceRequest
- AConsumer
that will call methods onUntagResourceRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateDatasetEntries
default CompletableFuture<UpdateDatasetEntriesResponse> updateDatasetEntries(UpdateDatasetEntriesRequest updateDatasetEntriesRequest) 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.- Parameters:
updateDatasetEntriesRequest
-- Returns:
- A Java Future containing the result of the UpdateDatasetEntries operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateDatasetEntries
default CompletableFuture<UpdateDatasetEntriesResponse> updateDatasetEntries(Consumer<UpdateDatasetEntriesRequest.Builder> updateDatasetEntriesRequest) 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.
This is a convenience which creates an instance of the
UpdateDatasetEntriesRequest.Builder
avoiding the need to create one manually viaUpdateDatasetEntriesRequest.builder()
- Parameters:
updateDatasetEntriesRequest
- AConsumer
that will call methods onUpdateDatasetEntriesRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateDatasetEntries operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You are not authorized to perform the action.
- InternalServerException Amazon Lookout for Vision experienced a service issue. Try your call again.
- ValidationException An input validation error occured. For example, invalid characters in a project name, or if a pagination token is invalid.
- ConflictException The update or deletion of a resource caused an inconsistent state.
- ResourceNotFoundException The resource could not be found.
- ThrottlingException Amazon Lookout for Vision is temporarily unable to process the request. Try your call again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- LookoutVisionException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
serviceClientConfiguration
Description copied from interface:SdkClient
The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfiguration
in interfaceAwsClient
- Specified by:
serviceClientConfiguration
in interfaceSdkClient
- Returns:
- SdkServiceClientConfiguration
-
create
Create aLookoutVisionAsyncClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
. -
builder
Create a builder that can be used to configure and create aLookoutVisionAsyncClient
.
-