ApiEventSource
- class aws_cdk.aws_lambda_event_sources.ApiEventSource(method, path, *, api_key_required=None, authorization_scopes=None, authorization_type=None, authorizer=None, method_responses=None, operation_name=None, request_models=None, request_parameters=None, request_validator=None, request_validator_options=None)
Bases:
object
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk import aws_apigateway as apigateway from aws_cdk import aws_lambda_event_sources as lambda_event_sources # authorizer: apigateway.Authorizer # model: apigateway.Model # request_validator: apigateway.RequestValidator api_event_source = lambda_event_sources.ApiEventSource("method", "path", api_key_required=False, authorization_scopes=["authorizationScopes"], authorization_type=apigateway.AuthorizationType.NONE, authorizer=authorizer, method_responses=[apigateway.MethodResponse( status_code="statusCode", # the properties below are optional response_models={ "response_models_key": model }, response_parameters={ "response_parameters_key": False } )], operation_name="operationName", request_models={ "request_models_key": model }, request_parameters={ "request_parameters_key": False }, request_validator=request_validator, request_validator_options=apigateway.RequestValidatorOptions( request_validator_name="requestValidatorName", validate_request_body=False, validate_request_parameters=False ) )
- Parameters:
method (
str
) –path (
str
) –api_key_required (
Optional
[bool
]) – Indicates whether the method requires clients to submit a valid API key. Default: falseauthorization_scopes (
Optional
[Sequence
[str
]]) – A list of authorization scopes configured on the method. The scopes are used with a COGNITO_USER_POOLS authorizer to authorize the method invocation. Default: - no authorization scopesauthorization_type (
Optional
[AuthorizationType
]) – Method authorization. If the value is set ofCustom
, anauthorizer
must also be specified. If you’re using one of the authorizers that are available via theAuthorizer
class, such asAuthorizer#token()
, it is recommended that this option not be specified. The authorizer will take care of setting the correct authorization type. However, specifying an authorization type using this property that conflicts with what is expected by theAuthorizer
will result in an error. Default: - open access unlessauthorizer
is specifiedauthorizer (
Optional
[IAuthorizer
]) – IfauthorizationType
isCustom
, this specifies the ID of the method authorizer resource. If specified, the value ofauthorizationType
must be set toCustom
method_responses (
Optional
[Sequence
[Union
[MethodResponse
,Dict
[str
,Any
]]]]) – The responses that can be sent to the client who calls the method. Default: None This property is not required, but if these are not supplied for a Lambda proxy integration, the Lambda function must return a value of the correct format, for the integration response to be correctly mapped to a response to the client.operation_name (
Optional
[str
]) – A friendly operation name for the method. For example, you can assign the OperationName of ListPets for the GET /pets method.request_models (
Optional
[Mapping
[str
,IModel
]]) – The models which describe data structure of request payload. When combined withrequestValidator
orrequestValidatorOptions
, the service will validate the API request payload before it reaches the API’s Integration (including proxies). SpecifyrequestModels
as key-value pairs, with a content type (e.g.'application/json'
) as the key and an API Gateway Model as the value.request_parameters (
Optional
[Mapping
[str
,bool
]]) – The request parameters that API Gateway accepts. Specify request parameters as key-value pairs (string-to-Boolean mapping), with a source as the key and a Boolean as the value. The Boolean specifies whether a parameter is required. A source must match the format method.request.location.name, where the location is querystring, path, or header, and name is a valid, unique parameter name. Default: Nonerequest_validator (
Optional
[IRequestValidator
]) – The ID of the associated request validator. Only one ofrequestValidator
orrequestValidatorOptions
must be specified. Works together withrequestModels
orrequestParameters
to validate the request before it reaches integration like Lambda Proxy Integration. Default: - No default validatorrequest_validator_options (
Union
[RequestValidatorOptions
,Dict
[str
,Any
],None
]) – Request validator options to create new validator Only one ofrequestValidator
orrequestValidatorOptions
must be specified. Works together withrequestModels
orrequestParameters
to validate the request before it reaches integration like Lambda Proxy Integration. Default: - No default validator
Methods