com.amazonaws.services.bedrockruntime

Class AmazonBedrockRuntimeClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.bedrockruntime.AmazonBedrockRuntimeClient

All Implemented Interfaces:

AmazonBedrockRuntime

Direct Known Subclasses:

AmazonBedrockRuntimeAsyncClient

@ThreadSafe
 @Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class AmazonBedrockRuntimeClient
extends AmazonWebServiceClient
implements AmazonBedrockRuntime

Client for accessing Amazon Bedrock Runtime. All service calls made using this client are blocking, and will not return until the service call completes.

Describes the API operations for running inference using Amazon Bedrock models.

Field Summary

Fields

Modifier and Type	Field and Description
protected static ClientConfigurationFactory	configFactory Client configuration factory providing ClientConfigurations tailored to this client

Fields inherited from class com.amazonaws.AmazonWebServiceClient

client, clientConfiguration, endpoint, isEndpointOverridden, LOGGING_AWS_REQUEST_METRIC, requestHandler2s, timeOffset

Fields inherited from interface com.amazonaws.services.bedrockruntime.AmazonBedrockRuntime

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
static AmazonBedrockRuntimeClientBuilder	builder()
ConverseResult	converse(ConverseRequest request) Sends messages to the specified Amazon Bedrock model.
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected.
InvokeModelResult	invokeModel(InvokeModelRequest request) Invokes the specified Amazon Bedrock model to run inference using the prompt and inference parameters provided in the request body.
void	shutdown() Shuts down this client object, releasing any resources that might be held open.

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, beforeClientExecution, beforeMarshalling, calculateCRC32FromCompressedData, checkMutability, configureRegion, createExecutionContext, createExecutionContext, createExecutionContext, createSignerProvider, endClientExecution, endClientExecution, getClientConfiguration, getClientId, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceAbbreviation, getServiceName, getServiceNameIntern, getSigner, getSignerByURI, getSignerOverride, getSignerProvider, getSignerRegionOverride, getSigningRegion, getTimeOffset, isCsmEnabled, isEndpointOverridden, isProfilingEnabled, isRequestMetricsEnabled, makeImmutable, removeRequestHandler, removeRequestHandler, requestMetricCollector, setEndpoint, setEndpoint, setEndpointPrefix, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shouldGenerateClientSideMonitoringEvents, useStrictHostNameVerification, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

configFactory

protected static final ClientConfigurationFactory configFactory

Client configuration factory providing ClientConfigurations tailored to this client

Method Detail

builder

public static AmazonBedrockRuntimeClientBuilder builder()

converse

public ConverseResult converse(ConverseRequest request)

Sends messages to the specified Amazon Bedrock model. Converse provides a consistent interface that works with all models that support messages. This allows you to write code once and use it with different models. Should a model have unique inference parameters, you can also pass those unique parameters to the model. For more information, see Run inference in the Bedrock User Guide.

This operation requires permission for the bedrock:InvokeModel action.

Specified by:

converse in interface AmazonBedrockRuntime

Parameters:

converseRequest -

Returns:

Result of the Converse operation returned by the service.

Throws:

AccessDeniedException - The request is denied because of missing access permissions.

ResourceNotFoundException - The specified resource ARN was not found. Check the ARN and try your request again.

ThrottlingException - The number of requests exceeds the limit. Resubmit your request later.

ModelTimeoutException - The request took too long to process. Processing time exceeded the model timeout length.

InternalServerException - An internal server error occurred. Retry your request.

ValidationException - Input validation failed. Check your request parameters and retry the request.

ModelNotReadyException - The model specified in the request is not ready to serve inference requests.

ModelErrorException - The request failed due to an error while processing the model.

See Also:

AWS API Documentation

invokeModel

public InvokeModelResult invokeModel(InvokeModelRequest request)

Invokes the specified Amazon Bedrock model to run inference using the prompt and inference parameters provided in the request body. You use model inference to generate text, images, and embeddings.

For example code, see Invoke model code examples in the Amazon Bedrock User Guide.

This operation requires permission for the bedrock:InvokeModel action.

Specified by:

invokeModel in interface AmazonBedrockRuntime

Parameters:

invokeModelRequest -

Returns:

Result of the InvokeModel operation returned by the service.

Throws:

AccessDeniedException - The request is denied because of missing access permissions.

ResourceNotFoundException - The specified resource ARN was not found. Check the ARN and try your request again.

ThrottlingException - The number of requests exceeds the limit. Resubmit your request later.

ModelTimeoutException - The request took too long to process. Processing time exceeded the model timeout length.

InternalServerException - An internal server error occurred. Retry your request.

ValidationException - Input validation failed. Check your request parameters and retry the request.

ModelNotReadyException - The model specified in the request is not ready to serve inference requests.

ServiceQuotaExceededException - The number of requests exceeds the service quota. Resubmit your request later.

ModelErrorException - The request failed due to an error while processing the model.

See Also:

AWS API Documentation

getCachedResponseMetadata

public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.

Specified by:

getCachedResponseMetadata in interface AmazonBedrockRuntime

Parameters:

request - The originally executed request

Returns:

The response metadata for the specified request, or null if none is available.

shutdown

public void shutdown()

Description copied from interface: AmazonBedrockRuntime

Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.

Specified by:

shutdown in interface AmazonBedrockRuntime

Overrides:

shutdown in class AmazonWebServiceClient