View a markdown version of this page

PassthroughTargetConfiguration - Amazon Bedrock AgentCore Control Plane
ContentsSee Also

PassthroughTargetConfiguration

The configuration for an HTTP passthrough target. A passthrough target forwards requests directly to an external HTTP endpoint.

Contents

endpoint

The HTTPS endpoint that the gateway forwards requests to for this passthrough target.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: https://[a-zA-Z0-9\-\.]+(:[0-9]{1,5})?(/.*)?

Required: Yes

protocolType

The application protocol that the passthrough target implements. This value is required for passthrough targets:

  • MCP - The Model Context Protocol.

  • A2A - The Agent-to-Agent protocol.

  • INFERENCE - The protocol for routing requests to a large language model (LLM) provider.

  • CUSTOM - A custom application protocol.

Type: String

Valid Values: MCP | A2A | INFERENCE | CUSTOM

Required: Yes

schema

The API schema configuration that defines the structure of the passthrough target's API.

Type: HttpApiSchemaConfiguration object

Required: No

staticQueryParameterConflictResolution

Controls precedence when a client request supplies a query parameter whose name matches a configured static query parameter. If not set, defaults to CLIENT_OVERRIDE:

  • CLIENT_OVERRIDE - The client-supplied value overrides the configured static value for that parameter name.

  • STATIC_OVERRIDE - The configured static value is retained, overriding the client-supplied value for that parameter name.

Type: String

Valid Values: CLIENT_OVERRIDE | STATIC_OVERRIDE

Required: No

staticQueryParameters

A map of static query parameters that the gateway always appends to the outbound URL when forwarding requests to the target. The total outbound URL length, which includes the endpoint and the percent-encoded query parameters, is enforced by the service.

Type: String to string map

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Key Pattern: [a-zA-Z0-9_.-]+

Value Pattern: [^\x00-\x1F\x7F]*

Required: No

stickinessConfiguration

The session stickiness configuration for the passthrough target. This configuration routes requests within the same session to the same target.

Type: StickinessConfiguration object

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: