AccessLogField

class aws_cdk.aws_apigateway.AccessLogField

Bases: object

$context variables that can be used to customize access log pattern.

Static Methods

classmethod context_account_id()

The API owner’s AWS account ID.

Return type

str

classmethod context_api_id()

The identifier API Gateway assigns to your API.

Return type

str

classmethod context_authorizer(property)

The stringified value of the specified key-value pair of the context map returned from an API Gateway Lambda authorizer function.

Parameters

property (str) – key of the context map.

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html

Return type

str

classmethod context_authorizer_claims(property)

A property of the claims returned from the Amazon Cognito user pool after the method caller is successfully authenticated.

Parameters

property (str) – A property key of the claims.

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-integrate-with-cognito.html

Return type

str

classmethod context_authorizer_integration_latency()

The authorizer latency in ms.

Return type

str

classmethod context_authorizer_principal_id()

The principal user identification associated with the token sent by the client and returned from an API Gateway Lambda authorizer (formerly known as a custom authorizer).

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html

Return type

str

classmethod context_aws_endpoint_request_id()

The AWS endpoint’s request ID.

Return type

str

classmethod context_domain_name()

The full domain name used to invoke the API.

This should be the same as the incoming Host header.

Return type

str

classmethod context_domain_prefix()

The first label of the $context.domainName. This is often used as a caller/customer identifier.

Return type

str

classmethod context_error_message()

A string containing an API Gateway error message.

Return type

str

classmethod context_error_message_string()

The quoted value of $context.error.message, namely “$context.error.message”.

Return type

str

classmethod context_error_response_type()

A type of GatewayResponse.

This variable can only be used for simple variable substitution in a GatewayResponse body-mapping template, which is not processed by the Velocity Template Language engine, and in access logging.

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/customize-gateway-responses.html

Return type

str

classmethod context_error_validation_error_string()

A string containing a detailed validation error message.

Return type

str

classmethod context_extended_request_id()

The extended ID that API Gateway assigns to the API request, which contains more useful information for debugging/troubleshooting.

Return type

str

classmethod context_http_method()

The HTTP method used.

Valid values include: DELETE, GET, HEAD, OPTIONS, PATCH, POST, and PUT.

Return type

str

classmethod context_identity_account_id()

The AWS account ID associated with the request.

Return type

str

classmethod context_identity_api_key()

For API methods that require an API key, this variable is the API key associated with the method request.

For methods that don’t require an API key, this variable is

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html

Return type

str

classmethod context_identity_api_key_id()

The API key ID associated with an API request that requires an API key.

Return type

str

classmethod context_identity_caller()

The principal identifier of the caller making the request.

Return type

str

classmethod context_identity_cognito_authentication_provider()

The Amazon Cognito authentication provider used by the caller making the request.

Available only if the request was signed with Amazon Cognito credentials.

See

https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-identity.html

Return type

str

classmethod context_identity_cognito_authentication_type()

The Amazon Cognito authentication type of the caller making the request.

Available only if the request was signed with Amazon Cognito credentials.

Return type

str

classmethod context_identity_cognito_identity_id()

The Amazon Cognito identity ID of the caller making the request.

Available only if the request was signed with Amazon Cognito credentials.

Return type

str

classmethod context_identity_cognito_identity_pool_id()

The Amazon Cognito identity pool ID of the caller making the request.

Available only if the request was signed with Amazon Cognito credentials.

Return type

str

classmethod context_identity_principal_org_id()

The AWS organization ID.

Return type

str

classmethod context_identity_source_ip()

The source IP address of the TCP connection making the request to API Gateway.

Warning: You should not trust this value if there is any chance that the X-Forwarded-For header could be forged.

Return type

str

classmethod context_identity_user()

The principal identifier of the user making the request.

Used in Lambda authorizers.

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-lambda-authorizer-output.html

Return type

str

classmethod context_identity_user_agent()

The User-Agent header of the API caller.

Return type

str

classmethod context_identity_user_arn()

The Amazon Resource Name (ARN) of the effective user identified after authentication.

See

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html

Return type

str

classmethod context_integration_latency()

The integration latency in ms.

Return type

str

classmethod context_integration_status()

For Lambda proxy integration, this parameter represents the status code returned from AWS Lambda, not from the backend Lambda function.

Return type

str

classmethod context_path()

The request path.

For example, for a non-proxy request URL of https://{rest-api-id.execute-api.{region}.amazonaws.com/{stage}/root/child, this value is /{stage}/root/child.

Return type

str

classmethod context_protocol()

The request protocol, for example, HTTP/1.1.

Return type

str

classmethod context_request_id()

The ID that API Gateway assigns to the API request.

Return type

str

classmethod context_request_override_header(header_name)

The request header override.

If this parameter is defined, it contains the headers to be used instead of the HTTP Headers that are defined in the Integration Request pane.

Parameters

header_name (str) –

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-override-request-response-parameters.html

Return type

str

classmethod context_request_override_path(path_name)

The request path override.

If this parameter is defined, it contains the request path to be used instead of the URL Path Parameters that are defined in the Integration Request pane.

Parameters

path_name (str) –

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-override-request-response-parameters.html

Return type

str

classmethod context_request_override_querystring(querystring_name)

The request query string override.

If this parameter is defined, it contains the request query strings to be used instead of the URL Query String Parameters that are defined in the Integration Request pane.

Parameters

querystring_name (str) –

Return type

str

classmethod context_request_time()

The CLF-formatted request time (dd/MMM/yyyy:HH:mm:ss +-hhmm).

Return type

str

classmethod context_request_time_epoch()

The Epoch-formatted request time.

Return type

str

classmethod context_resource_id()

The identifier that API Gateway assigns to your resource.

Return type

str

classmethod context_resource_path()

The path to your resource.

For example, for the non-proxy request URI of https://{rest-api-id.execute-api.{region}.amazonaws.com/{stage}/root/child, The $context.resourcePath value is /root/child.

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-create-api-step-by-step.html

Return type

str

classmethod context_response_latency()

The response latency in ms.

Return type

str

classmethod context_response_length()

The response payload length.

Return type

str

classmethod context_response_override_header(header_name)

The response header override.

If this parameter is defined, it contains the header to be returned instead of the Response header that is defined as the Default mapping in the Integration Response pane.

Parameters

header_name (str) –

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-override-request-response-parameters.html

Return type

str

classmethod context_response_override_status()

The response status code override.

If this parameter is defined, it contains the status code to be returned instead of the Method response status that is defined as the Default mapping in the Integration Response pane.

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-override-request-response-parameters.html

Return type

str

classmethod context_stage()

The deployment stage of the API request (for example, Beta or Prod).

Return type

str

classmethod context_status()

The method response status.

Return type

str

classmethod context_waf_response_code()

The response received from AWS WAF: WAF_ALLOW or WAF_BLOCK.

Will not be set if the stage is not associated with a web ACL.

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-control-access-aws-waf.html

Return type

str

classmethod context_webacl_arn()

The complete ARN of the web ACL that is used to decide whether to allow or block the request.

Will not be set if the stage is not associated with a web ACL.

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-control-access-aws-waf.html

Return type

str

classmethod context_xray_trace_id()

The trace ID for the X-Ray trace.

See

https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-enabling-xray.html

Return type

str