amazonka-apigatewayv2-2.0: Amazon ApiGatewayV2 SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.ApiGatewayV2.Types.Route

Description

 
Synopsis

Documentation

data Route Source #

Represents a route.

See: newRoute smart constructor.

Constructors

Route' 

Fields

  • apiGatewayManaged :: Maybe Bool

    Specifies whether a route is managed by API Gateway. If you created an API using quick create, the $default route is managed by API Gateway. You can't modify the $default route key.

  • apiKeyRequired :: Maybe Bool

    Specifies whether an API key is required for this route. Supported only for WebSocket APIs.

  • authorizationScopes :: Maybe [Text]

    A list of authorization scopes configured on a route. The scopes are used with a JWT authorizer to authorize the method invocation. The authorization works by matching the route scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any route scope matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the route scope is configured, the client must provide an access token instead of an identity token for authorization purposes.

  • authorizationType :: Maybe AuthorizationType

    The authorization type for the route. For WebSocket APIs, valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer For HTTP APIs, valid values are NONE for open access, JWT for using JSON Web Tokens, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer.

  • authorizerId :: Maybe Text

    The identifier of the Authorizer resource to be associated with this route. The authorizer identifier is generated by API Gateway when you created the authorizer.

  • modelSelectionExpression :: Maybe Text

    The model selection expression for the route. Supported only for WebSocket APIs.

  • operationName :: Maybe Text

    The operation name for the route.

  • requestModels :: Maybe (HashMap Text Text)

    The request models for the route. Supported only for WebSocket APIs.

  • requestParameters :: Maybe (HashMap Text ParameterConstraints)

    The request parameters for the route. Supported only for WebSocket APIs.

  • routeId :: Maybe Text

    The route ID.

  • routeResponseSelectionExpression :: Maybe Text

    The route response selection expression for the route. Supported only for WebSocket APIs.

  • target :: Maybe Text

    The target for the route.

  • routeKey :: Text

    The route key for the route.

Instances

Instances details
FromJSON Route Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.Types.Route

Generic Route Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.Types.Route

Associated Types

type Rep Route :: Type -> Type #

Methods

from :: Route -> Rep Route x #

to :: Rep Route x -> Route #

Read Route Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.Types.Route

Show Route Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.Types.Route

Methods

showsPrec :: Int -> Route -> ShowS #

show :: Route -> String #

showList :: [Route] -> ShowS #

NFData Route Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.Types.Route

Methods

rnf :: Route -> () #

Eq Route Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.Types.Route

Methods

(==) :: Route -> Route -> Bool #

(/=) :: Route -> Route -> Bool #

Hashable Route Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.Types.Route

Methods

hashWithSalt :: Int -> Route -> Int #

hash :: Route -> Int #

type Rep Route Source # 
Instance details

Defined in Amazonka.ApiGatewayV2.Types.Route

type Rep Route = D1 ('MetaData "Route" "Amazonka.ApiGatewayV2.Types.Route" "amazonka-apigatewayv2-2.0-4MZ8oueToeLOWomgegceF" 'False) (C1 ('MetaCons "Route'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "apiGatewayManaged") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: (S1 ('MetaSel ('Just "apiKeyRequired") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "authorizationScopes") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])))) :*: (S1 ('MetaSel ('Just "authorizationType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe AuthorizationType)) :*: (S1 ('MetaSel ('Just "authorizerId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "modelSelectionExpression") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))) :*: ((S1 ('MetaSel ('Just "operationName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "requestModels") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text))) :*: S1 ('MetaSel ('Just "requestParameters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text ParameterConstraints))))) :*: ((S1 ('MetaSel ('Just "routeId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "routeResponseSelectionExpression") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "target") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "routeKey") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))))

newRoute Source #

Create a value of Route with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:apiGatewayManaged:Route', route_apiGatewayManaged - Specifies whether a route is managed by API Gateway. If you created an API using quick create, the $default route is managed by API Gateway. You can't modify the $default route key.

$sel:apiKeyRequired:Route', route_apiKeyRequired - Specifies whether an API key is required for this route. Supported only for WebSocket APIs.

$sel:authorizationScopes:Route', route_authorizationScopes - A list of authorization scopes configured on a route. The scopes are used with a JWT authorizer to authorize the method invocation. The authorization works by matching the route scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any route scope matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the route scope is configured, the client must provide an access token instead of an identity token for authorization purposes.

$sel:authorizationType:Route', route_authorizationType - The authorization type for the route. For WebSocket APIs, valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer For HTTP APIs, valid values are NONE for open access, JWT for using JSON Web Tokens, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer.

$sel:authorizerId:Route', route_authorizerId - The identifier of the Authorizer resource to be associated with this route. The authorizer identifier is generated by API Gateway when you created the authorizer.

$sel:modelSelectionExpression:Route', route_modelSelectionExpression - The model selection expression for the route. Supported only for WebSocket APIs.

$sel:operationName:Route', route_operationName - The operation name for the route.

$sel:requestModels:Route', route_requestModels - The request models for the route. Supported only for WebSocket APIs.

$sel:requestParameters:Route', route_requestParameters - The request parameters for the route. Supported only for WebSocket APIs.

$sel:routeId:Route', route_routeId - The route ID.

$sel:routeResponseSelectionExpression:Route', route_routeResponseSelectionExpression - The route response selection expression for the route. Supported only for WebSocket APIs.

$sel:target:Route', route_target - The target for the route.

$sel:routeKey:Route', route_routeKey - The route key for the route.

route_apiGatewayManaged :: Lens' Route (Maybe Bool) Source #

Specifies whether a route is managed by API Gateway. If you created an API using quick create, the $default route is managed by API Gateway. You can't modify the $default route key.

route_apiKeyRequired :: Lens' Route (Maybe Bool) Source #

Specifies whether an API key is required for this route. Supported only for WebSocket APIs.

route_authorizationScopes :: Lens' Route (Maybe [Text]) Source #

A list of authorization scopes configured on a route. The scopes are used with a JWT authorizer to authorize the method invocation. The authorization works by matching the route scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any route scope matches a claimed scope in the access token. Otherwise, the invocation is not authorized. When the route scope is configured, the client must provide an access token instead of an identity token for authorization purposes.

route_authorizationType :: Lens' Route (Maybe AuthorizationType) Source #

The authorization type for the route. For WebSocket APIs, valid values are NONE for open access, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer For HTTP APIs, valid values are NONE for open access, JWT for using JSON Web Tokens, AWS_IAM for using AWS IAM permissions, and CUSTOM for using a Lambda authorizer.

route_authorizerId :: Lens' Route (Maybe Text) Source #

The identifier of the Authorizer resource to be associated with this route. The authorizer identifier is generated by API Gateway when you created the authorizer.

route_modelSelectionExpression :: Lens' Route (Maybe Text) Source #

The model selection expression for the route. Supported only for WebSocket APIs.

route_operationName :: Lens' Route (Maybe Text) Source #

The operation name for the route.

route_requestModels :: Lens' Route (Maybe (HashMap Text Text)) Source #

The request models for the route. Supported only for WebSocket APIs.

route_requestParameters :: Lens' Route (Maybe (HashMap Text ParameterConstraints)) Source #

The request parameters for the route. Supported only for WebSocket APIs.

route_routeResponseSelectionExpression :: Lens' Route (Maybe Text) Source #

The route response selection expression for the route. Supported only for WebSocket APIs.

route_target :: Lens' Route (Maybe Text) Source #

The target for the route.

route_routeKey :: Lens' Route Text Source #

The route key for the route.