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 | CUSTOMRequired: 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_OVERRIDERequired: 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:
