1. Packages
  2. AWS Native
  3. API Docs
  4. apigatewayv2
  5. getRoute

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.105.0 published on Thursday, May 2, 2024 by Pulumi

aws-native.apigatewayv2.getRoute

Explore with Pulumi AI

aws-native logo

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.105.0 published on Thursday, May 2, 2024 by Pulumi

    The AWS::ApiGatewayV2::Route resource creates a route for an API.

    Using getRoute

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getRoute(args: GetRouteArgs, opts?: InvokeOptions): Promise<GetRouteResult>
    function getRouteOutput(args: GetRouteOutputArgs, opts?: InvokeOptions): Output<GetRouteResult>
    def get_route(api_id: Optional[str] = None,
                  route_id: Optional[str] = None,
                  opts: Optional[InvokeOptions] = None) -> GetRouteResult
    def get_route_output(api_id: Optional[pulumi.Input[str]] = None,
                  route_id: Optional[pulumi.Input[str]] = None,
                  opts: Optional[InvokeOptions] = None) -> Output[GetRouteResult]
    func LookupRoute(ctx *Context, args *LookupRouteArgs, opts ...InvokeOption) (*LookupRouteResult, error)
    func LookupRouteOutput(ctx *Context, args *LookupRouteOutputArgs, opts ...InvokeOption) LookupRouteResultOutput

    > Note: This function is named LookupRoute in the Go SDK.

    public static class GetRoute 
    {
        public static Task<GetRouteResult> InvokeAsync(GetRouteArgs args, InvokeOptions? opts = null)
        public static Output<GetRouteResult> Invoke(GetRouteInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetRouteResult> getRoute(GetRouteArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: aws-native:apigatewayv2:getRoute
      arguments:
        # arguments dictionary

    The following arguments are supported:

    ApiId string
    The API identifier.
    RouteId string
    ApiId string
    The API identifier.
    RouteId string
    apiId String
    The API identifier.
    routeId String
    apiId string
    The API identifier.
    routeId string
    api_id str
    The API identifier.
    route_id str
    apiId String
    The API identifier.
    routeId String

    getRoute Result

    The following output properties are available:

    ApiKeyRequired bool
    Specifies whether an API key is required for the route. Supported only for WebSocket APIs.
    AuthorizationScopes List<string>
    The authorization scopes supported by this route.
    AuthorizationType string
    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.
    ModelSelectionExpression string
    The model selection expression for the route. Supported only for WebSocket APIs.
    OperationName string
    The operation name for the route.
    RequestModels object

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

    Search the CloudFormation User Guide for AWS::ApiGatewayV2::Route for more information about the expected schema for this property.

    RouteId string
    RouteKey string
    The route key for the route. For HTTP APIs, the route key can be either $default, or a combination of an HTTP method and resource path, for example, GET /pets.
    RouteResponseSelectionExpression string
    The route response selection expression for the route. Supported only for WebSocket APIs.
    Target string
    The target for the route.
    ApiKeyRequired bool
    Specifies whether an API key is required for the route. Supported only for WebSocket APIs.
    AuthorizationScopes []string
    The authorization scopes supported by this route.
    AuthorizationType string
    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.
    ModelSelectionExpression string
    The model selection expression for the route. Supported only for WebSocket APIs.
    OperationName string
    The operation name for the route.
    RequestModels interface{}

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

    Search the CloudFormation User Guide for AWS::ApiGatewayV2::Route for more information about the expected schema for this property.

    RouteId string
    RouteKey string
    The route key for the route. For HTTP APIs, the route key can be either $default, or a combination of an HTTP method and resource path, for example, GET /pets.
    RouteResponseSelectionExpression string
    The route response selection expression for the route. Supported only for WebSocket APIs.
    Target string
    The target for the route.
    apiKeyRequired Boolean
    Specifies whether an API key is required for the route. Supported only for WebSocket APIs.
    authorizationScopes List<String>
    The authorization scopes supported by this route.
    authorizationType String
    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.
    modelSelectionExpression String
    The model selection expression for the route. Supported only for WebSocket APIs.
    operationName String
    The operation name for the route.
    requestModels Object

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

    Search the CloudFormation User Guide for AWS::ApiGatewayV2::Route for more information about the expected schema for this property.

    routeId String
    routeKey String
    The route key for the route. For HTTP APIs, the route key can be either $default, or a combination of an HTTP method and resource path, for example, GET /pets.
    routeResponseSelectionExpression String
    The route response selection expression for the route. Supported only for WebSocket APIs.
    target String
    The target for the route.
    apiKeyRequired boolean
    Specifies whether an API key is required for the route. Supported only for WebSocket APIs.
    authorizationScopes string[]
    The authorization scopes supported by this route.
    authorizationType string
    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.
    modelSelectionExpression string
    The model selection expression for the route. Supported only for WebSocket APIs.
    operationName string
    The operation name for the route.
    requestModels any

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

    Search the CloudFormation User Guide for AWS::ApiGatewayV2::Route for more information about the expected schema for this property.

    routeId string
    routeKey string
    The route key for the route. For HTTP APIs, the route key can be either $default, or a combination of an HTTP method and resource path, for example, GET /pets.
    routeResponseSelectionExpression string
    The route response selection expression for the route. Supported only for WebSocket APIs.
    target string
    The target for the route.
    api_key_required bool
    Specifies whether an API key is required for the route. Supported only for WebSocket APIs.
    authorization_scopes Sequence[str]
    The authorization scopes supported by this route.
    authorization_type str
    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.
    model_selection_expression str
    The model selection expression for the route. Supported only for WebSocket APIs.
    operation_name str
    The operation name for the route.
    request_models Any

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

    Search the CloudFormation User Guide for AWS::ApiGatewayV2::Route for more information about the expected schema for this property.

    route_id str
    route_key str
    The route key for the route. For HTTP APIs, the route key can be either $default, or a combination of an HTTP method and resource path, for example, GET /pets.
    route_response_selection_expression str
    The route response selection expression for the route. Supported only for WebSocket APIs.
    target str
    The target for the route.
    apiKeyRequired Boolean
    Specifies whether an API key is required for the route. Supported only for WebSocket APIs.
    authorizationScopes List<String>
    The authorization scopes supported by this route.
    authorizationType String
    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.
    modelSelectionExpression String
    The model selection expression for the route. Supported only for WebSocket APIs.
    operationName String
    The operation name for the route.
    requestModels Any

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

    Search the CloudFormation User Guide for AWS::ApiGatewayV2::Route for more information about the expected schema for this property.

    routeId String
    routeKey String
    The route key for the route. For HTTP APIs, the route key can be either $default, or a combination of an HTTP method and resource path, for example, GET /pets.
    routeResponseSelectionExpression String
    The route response selection expression for the route. Supported only for WebSocket APIs.
    target String
    The target for the route.

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    AWS Native is in preview. AWS Classic is fully supported.

    AWS Native v0.105.0 published on Thursday, May 2, 2024 by Pulumi