Struct RequestContext 

pub struct RequestContext {
    pub account_id: String,
    pub region: String,
    pub service: String,
    pub access_key: Option<String>,
    pub request_id: String,
    pub method: String,
    pub uri: String,
    pub event_bus: Option<EventBus>,
    pub source_ip: Option<String>,
    pub is_secure: bool,
}

Context extracted from an incoming AWS API request.

Contains the account ID, region, service, and request metadata needed by service handlers to process the request.

Fields

account_id: String

AWS account ID (default: “000000000000” in bypass mode)

region: String

AWS region (e.g., “us-east-1”)

service: String

Service name extracted from the request

access_key: Option<String>

Access key ID (if present in Authorization header)

request_id: String

Unique request ID for this API call

method: String

HTTP method of the original request

uri: String

URI path of the original request

event_bus: Option<EventBus>

Internal event bus — present for requests routed through the gateway; None in unit tests or any context where no bus was configured.

source_ip: Option<String>

Source IP of the caller, if recoverable from X-Forwarded-For (or any future axum-side wiring of ConnectInfo). Surfaced into aws:SourceIp for IAM condition evaluation.

is_secure: bool

Whether the original request reached us over TLS, recovered from X-Forwarded-Proto when present. Surfaced as aws:SecureTransport.

Implementations

impl RequestContext

pub fn new(service: impl Into<String>, region: impl Into<String>) -> Self

pub fn new_with_account( service: impl Into<String>, region: impl Into<String>, account_id: impl Into<String>, ) -> Self

Like [new] but with an explicit account id — used by background pollers that fan out across every (account, region) pair.

pub fn arn_prefix(&self, service: &str) -> String

Returns an ARN prefix for this account and region. e.g., “arn:aws:s3:us-east-1:000000000000”

Trait Implementations

impl Clone for RequestContext

fn clone(&self) -> RequestContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RequestContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RequestContext

fn default() -> RequestContext

Returns the “default value” for a type.