Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1436208157.4 KB

Creates a routing rule for a link.

Routing rules use priority-based evaluation where lower priority numbers are evaluated first. Each rule specifies conditions that must all match for the rule to apply.

post/responder-gateway/{gatewayId}/link/{linkId}/routing-rule

Path parameters

gatewayIdstring required

The unique identifier of the gateway.

linkIdstring required

The unique identifier of the link.

Request body

clientTokenstring required
<p>Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a <a href="https://wikipedia.org/wiki/Universally_unique_identifier">UUID type of value</a>.</p> <p>If you don't provide this value, then Amazon Web Services generates a random one for you.</p> <p>If you retry the operation with the same <code>ClientToken</code>, but with different parameters, the retry fails with an <code>IdempotentParameterMismatch</code> error.</p>
priorityinteger required

WAF-style evaluation priority. Lower number = evaluated first (priority 1 before 10). Gaps are allowed (1, 10, 20 is valid). Must be between 1 and 1000 inclusive. Uniqueness per link among non-deleted rules is enforced at the API layer (HTTP 409 on conflict).

tagsobject

A map of the key-value pairs of the tag or tags to assign to the resource.

Response

Success

ruleIdstring required

The unique identifier of the routing rule.

status'CREATION_IN_PROGRESS' | 'ACTIVE' | 'UPDATE_IN_PROGRESS' | 'DELETION_IN_PROGRESS' | 'DELETED' | 'FAILED' required

The status of the routing rule.

createdAtstring date-time required

The timestamp of when the routing rule was created.