Skip to content

Bedrock AgentCore Control  >  Structures  >  PassthroughTargetConfiguration

PassthroughTargetConfiguration

Structure Class

PassthroughTargetConfiguration dataclass

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

Attributes

endpoint instance-attribute 
endpoint: str

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

protocol_type instance-attribute 
protocol_type: PassthroughProtocolType

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.

schema class-attribute instance-attribute 
schema: HttpApiSchemaConfiguration | None = None

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

static_query_parameter_conflict_resolution class-attribute instance-attribute 
static_query_parameter_conflict_resolution: StaticQueryParameterConflictResolution | None = None

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.

static_query_parameters class-attribute instance-attribute 
static_query_parameters: dict[str, str] | None = None

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.

stickiness_configuration class-attribute instance-attribute 
stickiness_configuration: StickinessConfiguration | None = None

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