☰
Navigation :

aws.proto

Package: aws.options.gloo.solo.io

Types:

Source File: github.com/solo-io/gloo/projects/gloo/api/v1/options/aws/aws.proto

UpstreamSpec

Upstream Spec for AWS Lambda Upstreams AWS Upstreams represent a collection of Lambda Functions for a particular AWS Account (IAM Role or User account) in a particular region

"region": string
"secretRef": .core.solo.io.ResourceRef
"lambdaFunctions": []aws.options.gloo.solo.io.LambdaFunctionSpec
"roleArn": string
"awsAccountId": string
"disableRoleChaining": bool
"destinationOverrides": .aws.options.gloo.solo.io.DestinationSpec
Field Type Description
region string The AWS Region where the desired Lambda Functions exist.
secretRef .core.solo.io.ResourceRef A Gloo Secret Ref to an AWS Secret AWS Secrets can be created with glooctl secret create aws ... If the secret is created manually, it must conform to the following structure: access_key: <aws access key> secret_key: <aws secret key> session_token: <(optional) aws session token>.
lambdaFunctions []aws.options.gloo.solo.io.LambdaFunctionSpec The list of Lambda Functions contained within this region. This list will be automatically populated by Gloo if discovery is enabled for AWS Lambda Functions.
roleArn string (Optional): role_arn to use when assuming a role for a given request via STS. If set this role_arn will override the value found in AWS_ROLE_ARN This option will only be respected if STS credentials are enabled. To enable STS credential fetching see Settings.Gloo.AwsOptions in settings.proto.
awsAccountId string (Optional): The AWS Account ID to use while calling if using resource based access.
disableRoleChaining bool Optional override to disable role chaining;.
destinationOverrides .aws.options.gloo.solo.io.DestinationSpec Specifies AWS DestinationSpec configuration overrides for any route targeting this upstream. Note that the route in question must have an AWS DestinationSpec to be affected and this will only set things that are non-falsey as overrides.

LambdaFunctionSpec

Each Lambda Function Spec contains data necessary for Gloo to invoke Lambda functions:

"logicalName": string
"lambdaFunctionName": string
"qualifier": string
Field Type Description
logicalName string the logical name gloo should associate with this function. if left empty, it will default to lambda_function_name+qualifier.
lambdaFunctionName string The Name of the Lambda Function as it appears in the AWS Lambda Portal.
qualifier string The Qualifier for the Lambda Function. Qualifiers act as a kind of version for Lambda Functions. See https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html for more info.

DestinationSpec

Each Lambda Function Spec contains data necessary for Gloo to invoke Lambda functions [#next-free-field: 8]

"logicalName": string
"invocationStyle": .aws.options.gloo.solo.io.DestinationSpec.InvocationStyle
"requestTransformation": bool
"responseTransformation": bool
"unwrapAsAlb": bool
"unwrapAsApiGateway": bool
"wrapAsApiGateway": bool
Field Type Description
logicalName string The Logical Name of the LambdaFunctionSpec to be invoked.
invocationStyle .aws.options.gloo.solo.io.DestinationSpec.InvocationStyle Can be either Sync or Async.
requestTransformation bool Include headers, querystring, request path, and request method in the event payload sent to aws lambda.
responseTransformation bool de-jsonify response bodies returned from aws lambda.
unwrapAsAlb bool Unwrap the response as if the proxy was an ALB. Intended to ease migration when previously using alb to invoke Lambdas. For further information see below link for the expected format when true. https://docs.aws.amazon.com/elasticloadbalancing/latest/application/lambda-functions.html Only one of unwrapAsAlb or unwrapAsApiGateway should be provided. If more than one is provided only one will be checked with priority unwrapAsAlb, unwrapAsApiGateway.
unwrapAsApiGateway bool Enterprise-Only Unwrap the response as if the proxy was an AWS API Gateway. Intended to ease migration when previously using API Gateway to invoke Lambdas. Only one of unwrapAsAlb or unwrapAsApiGateway should be provided. If more than one is provided only one will be checked with priority unwrapAsAlb, unwrapAsApiGateway.
wrapAsApiGateway bool Enterprise-Only Wrap the request into AWS API Gateway event format. Intended to ease migration when previously using API Gateway to invoke Lambdas.

InvocationStyle

Name Description
SYNC
ASYNC