Bedrock Runtime  >  Operations  >  start_async_invoke

start_async_invoke

Operation

start_async_invoke async

start_async_invoke(input: StartAsyncInvokeInput, plugins: list[Plugin] | None = None) -> StartAsyncInvokeOutput

Starts an asynchronous invocation.

This operation requires permission for the bedrock:InvokeModel action.

Warning

To deny all inference access to resources that you specify in the modelId field, you need to deny access to the bedrock:InvokeModel and bedrock:InvokeModelWithResponseStream actions. Doing this also denies access to the resource through the Converse API actions (Converse and ConverseStream). For more information see Deny access for inference on specific models.

Parameters:

Name	Type	Description	Default
input	StartAsyncInvokeInput	An instance of StartAsyncInvokeInput.	required
plugins	list[Plugin] | None	A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.	None

Returns:

Type	Description
StartAsyncInvokeOutput	An instance of StartAsyncInvokeOutput.

Input

StartAsyncInvokeInput dataclass

Dataclass for StartAsyncInvokeInput structure.

Attributes

client_request_token class-attribute instance-attribute

client_request_token: str | None = None

Specify idempotency token to ensure that requests are not duplicated.

model_id class-attribute instance-attribute

model_id: str | None = None

The model to invoke.

model_input class-attribute instance-attribute

model_input: Document | None = field(repr=False, default=None)

Input to send to the model.

output_data_config class-attribute instance-attribute

output_data_config: AsyncInvokeOutputDataConfig | None = None

Where to store the output.

tags class-attribute instance-attribute

tags: list[Tag] | None = None

Tags to apply to the invocation.

Output

StartAsyncInvokeOutput dataclass

Dataclass for StartAsyncInvokeOutput structure.

Attributes

invocation_arn instance-attribute

invocation_arn: str

The ARN of the invocation.