Interface LookoutVisionAsyncClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder() method.The asynchronous client performs non-blocking I/O when configured with any
SdkAsyncHttpClient supported in the SDK. However, full non-blocking is not guaranteed as the async client may
perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API
call.
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
FieldsModifier and TypeFieldDescriptionstatic final StringValue 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 LookoutVisionAsyncClientcreate()Create aLookoutVisionAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand 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 ListDatasetEntriesPublisherlistDatasetEntriesPaginator(Consumer<ListDatasetEntriesRequest.Builder> listDatasetEntriesRequest) This is a variant oflistDatasetEntries(software.amazon.awssdk.services.lookoutvision.model.ListDatasetEntriesRequest)operation.default ListDatasetEntriesPublisherlistDatasetEntriesPaginator(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 ListModelPackagingJobsPublisherlistModelPackagingJobsPaginator(Consumer<ListModelPackagingJobsRequest.Builder> listModelPackagingJobsRequest) This is a variant oflistModelPackagingJobs(software.amazon.awssdk.services.lookoutvision.model.ListModelPackagingJobsRequest)operation.default ListModelPackagingJobsPublisherlistModelPackagingJobsPaginator(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 ListModelsPublisherlistModelsPaginator(Consumer<ListModelsRequest.Builder> listModelsRequest) This is a variant oflistModels(software.amazon.awssdk.services.lookoutvision.model.ListModelsRequest)operation.default ListModelsPublisherlistModelsPaginator(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 ListProjectsPublisherlistProjectsPaginator(Consumer<ListProjectsRequest.Builder> listProjectsRequest) This is a variant oflistProjects(software.amazon.awssdk.services.lookoutvision.model.ListProjectsRequest)operation.default ListProjectsPublisherlistProjectsPaginator(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
closeMethods 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.
CreateDatasetcan create a training or a test dataset from a valid dataset source (DatasetSource).If you want a single dataset project, specify
trainfor the value ofDatasetType.To have a project with separate training and test datasets, call
CreateDatasettwice. On the first call, specifytrainfor the value ofDatasetType. On the second call, specifytestfor the value ofDatasetType.This operation requires permissions to perform the
lookoutvision:CreateDatasetoperation.- 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.
CreateDatasetcan create a training or a test dataset from a valid dataset source (DatasetSource).If you want a single dataset project, specify
trainfor the value ofDatasetType.To have a project with separate training and test datasets, call
CreateDatasettwice. On the first call, specifytrainfor the value ofDatasetType. On the second call, specifytestfor the value ofDatasetType.This operation requires permissions to perform the
lookoutvision:CreateDatasetoperation.
This is a convenience which creates an instance of the
CreateDatasetRequest.Builderavoiding the need to create one manually viaCreateDatasetRequest.builder()- Parameters:
createDatasetRequest- AConsumerthat will call methods onCreateDatasetRequest.Builderto 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.
CreateModelis 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
Statusfield 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:CreateModeloperation. If you want to tag your model, you also require permission to thelookoutvision:TagResourceoperation.- 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.
CreateModelis 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
Statusfield 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:CreateModeloperation. If you want to tag your model, you also require permission to thelookoutvision:TagResourceoperation.
This is a convenience which creates an instance of the
CreateModelRequest.Builderavoiding the need to create one manually viaCreateModelRequest.builder()- Parameters:
createModelRequest- AConsumerthat will call methods onCreateModelRequest.Builderto 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:CreateProjectoperation.- 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:CreateProjectoperation.
This is a convenience which creates an instance of the
CreateProjectRequest.Builderavoiding the need to create one manually viaCreateProjectRequest.builder()- Parameters:
createProjectRequest- AConsumerthat will call methods onCreateProjectRequest.Builderto 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:DeleteDatasetoperation.- 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:DeleteDatasetoperation.
This is a convenience which creates an instance of the
DeleteDatasetRequest.Builderavoiding the need to create one manually viaDeleteDatasetRequest.builder()- Parameters:
deleteDatasetRequest- AConsumerthat will call methods onDeleteDatasetRequest.Builderto 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 theModelsarray.This operation requires permissions to perform the
lookoutvision:DeleteModeloperation.- 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 theModelsarray.This operation requires permissions to perform the
lookoutvision:DeleteModeloperation.
This is a convenience which creates an instance of the
DeleteModelRequest.Builderavoiding the need to create one manually viaDeleteModelRequest.builder()- Parameters:
deleteModelRequest- AConsumerthat will call methods onDeleteModelRequest.Builderto 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:DeleteProjectoperation.- 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:DeleteProjectoperation.
This is a convenience which creates an instance of the
DeleteProjectRequest.Builderavoiding the need to create one manually viaDeleteProjectRequest.builder()- Parameters:
deleteProjectRequest- AConsumerthat will call methods onDeleteProjectRequest.Builderto 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:DescribeDatasetoperation.- 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:DescribeDatasetoperation.
This is a convenience which creates an instance of the
DescribeDatasetRequest.Builderavoiding the need to create one manually viaDescribeDatasetRequest.builder()- Parameters:
describeDatasetRequest- AConsumerthat will call methods onDescribeDatasetRequest.Builderto 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:DescribeModeloperation.- 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:DescribeModeloperation.
This is a convenience which creates an instance of the
DescribeModelRequest.Builderavoiding the need to create one manually viaDescribeModelRequest.builder()- Parameters:
describeModelRequest- AConsumerthat will call methods onDescribeModelRequest.Builderto 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:DescribeModelPackagingJoboperation.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:DescribeModelPackagingJoboperation.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.Builderavoiding the need to create one manually viaDescribeModelPackagingJobRequest.builder()- Parameters:
describeModelPackagingJobRequest- AConsumerthat will call methods onDescribeModelPackagingJobRequest.Builderto 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:DescribeProjectoperation.- 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:DescribeProjectoperation.
This is a convenience which creates an instance of the
DescribeProjectRequest.Builderavoiding the need to create one manually viaDescribeProjectRequest.builder()- Parameters:
describeProjectRequest- AConsumerthat will call methods onDescribeProjectRequest.Builderto 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
DetectAnomaliesincludes 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:DetectAnomaliesoperation.- 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. SeeAsyncRequestBodyfor 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
DetectAnomaliesincludes 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:DetectAnomaliesoperation.
This is a convenience which creates an instance of the
DetectAnomaliesRequest.Builderavoiding the need to create one manually viaDetectAnomaliesRequest.builder()- Parameters:
detectAnomaliesRequest- AConsumerthat will call methods onDetectAnomaliesRequest.Builderto 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. SeeAsyncRequestBodyfor 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
DetectAnomaliesincludes 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:DetectAnomaliesoperation.- Parameters:
detectAnomaliesRequest-sourcePath-Pathto 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
DetectAnomaliesincludes 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:DetectAnomaliesoperation.
This is a convenience which creates an instance of the
DetectAnomaliesRequest.Builderavoiding the need to create one manually viaDetectAnomaliesRequest.builder()- Parameters:
detectAnomaliesRequest- AConsumerthat will call methods onDetectAnomaliesRequest.Builderto create a request.sourcePath-Pathto 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:ListDatasetEntriesoperation.- 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:ListDatasetEntriesoperation.
This is a convenience which creates an instance of the
ListDatasetEntriesRequest.Builderavoiding the need to create one manually viaListDatasetEntriesRequest.builder()- Parameters:
listDatasetEntriesRequest- AConsumerthat will call methods onListDatasetEntriesRequest.Builderto 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 newSubscriptioni.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 method
2) Using a custom subscribersoftware.amazon.awssdk.services.lookoutvision.paginators.ListDatasetEntriesPublisher publisher = client.listDatasetEntriesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.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 newSubscriptioni.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 method
2) Using a custom subscribersoftware.amazon.awssdk.services.lookoutvision.paginators.ListDatasetEntriesPublisher publisher = client.listDatasetEntriesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.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.Builderavoiding the need to create one manually viaListDatasetEntriesRequest.builder()- Parameters:
listDatasetEntriesRequest- AConsumerthat will call methods onListDatasetEntriesRequest.Builderto 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:ListModelPackagingJobsoperation.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:ListModelPackagingJobsoperation.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.Builderavoiding the need to create one manually viaListModelPackagingJobsRequest.builder()- Parameters:
listModelPackagingJobsRequest- AConsumerthat will call methods onListModelPackagingJobsRequest.Builderto 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 newSubscriptioni.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 method
2) Using a custom subscribersoftware.amazon.awssdk.services.lookoutvision.paginators.ListModelPackagingJobsPublisher publisher = client.listModelPackagingJobsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.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 newSubscriptioni.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 method
2) Using a custom subscribersoftware.amazon.awssdk.services.lookoutvision.paginators.ListModelPackagingJobsPublisher publisher = client.listModelPackagingJobsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.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.Builderavoiding the need to create one manually viaListModelPackagingJobsRequest.builder()- Parameters:
listModelPackagingJobsRequest- AConsumerthat will call methods onListModelPackagingJobsRequest.Builderto 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
ListModelsoperation is eventually consistent. Recent calls toCreateModelmight take a while to appear in the response fromListProjects.This operation requires permissions to perform the
lookoutvision:ListModelsoperation.- 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
ListModelsoperation is eventually consistent. Recent calls toCreateModelmight take a while to appear in the response fromListProjects.This operation requires permissions to perform the
lookoutvision:ListModelsoperation.
This is a convenience which creates an instance of the
ListModelsRequest.Builderavoiding the need to create one manually viaListModelsRequest.builder()- Parameters:
listModelsRequest- AConsumerthat will call methods onListModelsRequest.Builderto 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 newSubscriptioni.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 method
2) Using a custom subscribersoftware.amazon.awssdk.services.lookoutvision.paginators.ListModelsPublisher publisher = client.listModelsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.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 newSubscriptioni.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 method
2) Using a custom subscribersoftware.amazon.awssdk.services.lookoutvision.paginators.ListModelsPublisher publisher = client.listModelsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.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.Builderavoiding the need to create one manually viaListModelsRequest.builder()- Parameters:
listModelsRequest- AConsumerthat will call methods onListModelsRequest.Builderto 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
ListProjectsoperation is eventually consistent. Recent calls toCreateProjectandDeleteProjectmight take a while to appear in the response fromListProjects.This operation requires permissions to perform the
lookoutvision:ListProjectsoperation.- 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
ListProjectsoperation is eventually consistent. Recent calls toCreateProjectandDeleteProjectmight take a while to appear in the response fromListProjects.This operation requires permissions to perform the
lookoutvision:ListProjectsoperation.
This is a convenience which creates an instance of the
ListProjectsRequest.Builderavoiding the need to create one manually viaListProjectsRequest.builder()- Parameters:
listProjectsRequest- AConsumerthat will call methods onListProjectsRequest.Builderto 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 newSubscriptioni.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 method
2) Using a custom subscribersoftware.amazon.awssdk.services.lookoutvision.paginators.ListProjectsPublisher publisher = client.listProjectsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.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 newSubscriptioni.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 method
2) Using a custom subscribersoftware.amazon.awssdk.services.lookoutvision.paginators.ListProjectsPublisher publisher = client.listProjectsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.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.Builderavoiding the need to create one manually viaListProjectsRequest.builder()- Parameters:
listProjectsRequest- AConsumerthat will call methods onListProjectsRequest.Builderto 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:ListTagsForResourceoperation.- 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:ListTagsForResourceoperation.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto 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:StartModeloperation.- 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:StartModeloperation.
This is a convenience which creates an instance of the
StartModelRequest.Builderavoiding the need to create one manually viaStartModelRequest.builder()- Parameters:
startModelRequest- AConsumerthat will call methods onStartModelRequest.Builderto 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
StatusisSUCCEEDED.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
StatusisSUCCEEDED.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.Builderavoiding the need to create one manually viaStartModelPackagingJobRequest.builder()- Parameters:
startModelPackagingJobRequest- AConsumerthat will call methods onStartModelPackagingJobRequest.Builderto 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
Statusof the model isTRAINED.This operation requires permissions to perform the
lookoutvision:StopModeloperation.- 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
Statusof the model isTRAINED.This operation requires permissions to perform the
lookoutvision:StopModeloperation.
This is a convenience which creates an instance of the
StopModelRequest.Builderavoiding the need to create one manually viaStopModelRequest.builder()- Parameters:
stopModelRequest- AConsumerthat will call methods onStopModelRequest.Builderto 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:TagResourceoperation.- 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:TagResourceoperation.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto 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:UntagResourceoperation.- 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:UntagResourceoperation.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto 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-reffield 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-reffield 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
Statusfield in the response.This operation requires permissions to perform the
lookoutvision:UpdateDatasetEntriesoperation.- 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-reffield 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-reffield 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
Statusfield in the response.This operation requires permissions to perform the
lookoutvision:UpdateDatasetEntriesoperation.
This is a convenience which creates an instance of the
UpdateDatasetEntriesRequest.Builderavoiding the need to create one manually viaUpdateDatasetEntriesRequest.builder()- Parameters:
updateDatasetEntriesRequest- AConsumerthat will call methods onUpdateDatasetEntriesRequest.Builderto 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:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-
create
Create aLookoutVisionAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aLookoutVisionAsyncClient.
-