com.amazonaws.services.sagemakerruntime

Interface AmazonSageMakerRuntimeAsync

All Superinterfaces:

AmazonSageMakerRuntime

All Known Implementing Classes:

AmazonSageMakerRuntimeAsyncClient

public interface AmazonSageMakerRuntimeAsync
extends AmazonSageMakerRuntime

Interface for accessing Amazon SageMaker Runtime Service asynchronously.

The Amazon SageMaker runtime API.

Method Summary

Modifier and Type	Method and Description
java.util.concurrent.Future<InvokeEndpointResult>	invokeEndpointAsync(InvokeEndpointRequest invokeEndpointRequest) After you deploy a model into production using Amazon SageMaker hosting services, your client applications use this API to get inferences from the model hosted at the specified endpoint.
java.util.concurrent.Future<InvokeEndpointResult>	invokeEndpointAsync(InvokeEndpointRequest invokeEndpointRequest, AsyncHandler<InvokeEndpointRequest,InvokeEndpointResult> asyncHandler) After you deploy a model into production using Amazon SageMaker hosting services, your client applications use this API to get inferences from the model hosted at the specified endpoint.

Methods inherited from interface com.amazonaws.services.sagemakerruntime.AmazonSageMakerRuntime

getCachedResponseMetadata, invokeEndpoint, setEndpoint, setRegion, shutdown

Method Detail

invokeEndpointAsync

java.util.concurrent.Future<InvokeEndpointResult> invokeEndpointAsync(InvokeEndpointRequest invokeEndpointRequest)
                                                               throws AmazonServiceException,
                                                                      AmazonClientException

After you deploy a model into production using Amazon SageMaker hosting services, your client applications use this API to get inferences from the model hosted at the specified endpoint.

For an overview of Amazon SageMaker, see How It Works.

Amazon SageMaker strips all POST headers except those supported by the API. Amazon SageMaker might add additional headers. You should not rely on the behavior of headers outside those enumerated in the request syntax.

Cals to InvokeEndpoint are authenticated by using AWS Signature Version 4. For information, see Authenticating Requests (AWS Signature Version 4) in the Amazon S3 API Reference.

Endpoints are scoped to an individual account, and are not public. The URL does not contain the account ID, but Amazon SageMaker determines the account ID from the authentication token that is supplied by the caller.

Parameters:

invokeEndpointRequest -

Returns:

A Java Future object containing the response from the InvokeEndpoint service method, as returned by Amazon SageMaker Runtime Service.

Throws:

InternalFailureException

ServiceUnavailableException

ValidationErrorException

ModelErrorException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon SageMaker Runtime Service indicating either a problem with the data in the request, or a server side issue.

invokeEndpointAsync

java.util.concurrent.Future<InvokeEndpointResult> invokeEndpointAsync(InvokeEndpointRequest invokeEndpointRequest,
                                                                      AsyncHandler<InvokeEndpointRequest,InvokeEndpointResult> asyncHandler)
                                                               throws AmazonServiceException,
                                                                      AmazonClientException

After you deploy a model into production using Amazon SageMaker hosting services, your client applications use this API to get inferences from the model hosted at the specified endpoint.

For an overview of Amazon SageMaker, see How It Works.

Amazon SageMaker strips all POST headers except those supported by the API. Amazon SageMaker might add additional headers. You should not rely on the behavior of headers outside those enumerated in the request syntax.

Cals to InvokeEndpoint are authenticated by using AWS Signature Version 4. For information, see Authenticating Requests (AWS Signature Version 4) in the Amazon S3 API Reference.

Endpoints are scoped to an individual account, and are not public. The URL does not contain the account ID, but Amazon SageMaker determines the account ID from the authentication token that is supplied by the caller.

Parameters:

invokeEndpointRequest -

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the InvokeEndpoint service method, as returned by Amazon SageMaker Runtime Service.

Throws:

InternalFailureException

ServiceUnavailableException

ValidationErrorException

ModelErrorException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon SageMaker Runtime Service indicating either a problem with the data in the request, or a server side issue.