get_route

get_route(**kwargs)

Gets an Amazon Web Services Migration Hub Refactor Spaces route.

See also: AWS API Documentation

Request Syntax

response = client.get_route(
    ApplicationIdentifier='string',
    EnvironmentIdentifier='string',
    RouteIdentifier='string'
)

Parameters

• ApplicationIdentifier (string) --

  [REQUIRED]

  The ID of the application.

• EnvironmentIdentifier (string) --

  [REQUIRED]

  The ID of the environment.

• RouteIdentifier (string) --

  [REQUIRED]

  The ID of the route.

Return type

dict

Returns

Response Syntax

{
    'ApplicationId': 'string',
    'Arn': 'string',
    'CreatedByAccountId': 'string',
    'CreatedTime': datetime(2015, 1, 1),
    'EnvironmentId': 'string',
    'Error': {
        'AccountId': 'string',
        'AdditionalDetails': {
            'string': 'string'
        },
        'Code': 'INVALID_RESOURCE_STATE'|'RESOURCE_LIMIT_EXCEEDED'|'RESOURCE_CREATION_FAILURE'|'RESOURCE_UPDATE_FAILURE'|'SERVICE_ENDPOINT_HEALTH_CHECK_FAILURE'|'RESOURCE_DELETION_FAILURE'|'RESOURCE_RETRIEVAL_FAILURE'|'RESOURCE_IN_USE'|'RESOURCE_NOT_FOUND'|'STATE_TRANSITION_FAILURE'|'REQUEST_LIMIT_EXCEEDED'|'NOT_AUTHORIZED',
        'Message': 'string',
        'ResourceIdentifier': 'string',
        'ResourceType': 'ENVIRONMENT'|'APPLICATION'|'ROUTE'|'SERVICE'|'TRANSIT_GATEWAY'|'TRANSIT_GATEWAY_ATTACHMENT'|'API_GATEWAY'|'NLB'|'TARGET_GROUP'|'LOAD_BALANCER_LISTENER'|'VPC_LINK'|'LAMBDA'|'VPC'|'SUBNET'|'ROUTE_TABLE'|'SECURITY_GROUP'|'VPC_ENDPOINT_SERVICE_CONFIGURATION'|'RESOURCE_SHARE'|'IAM_ROLE'
    },
    'IncludeChildPaths': True|False,
    'LastUpdatedTime': datetime(2015, 1, 1),
    'Methods': [
        'DELETE'|'GET'|'HEAD'|'OPTIONS'|'PATCH'|'POST'|'PUT',
    ],
    'OwnerAccountId': 'string',
    'PathResourceToId': {
        'string': 'string'
    },
    'RouteId': 'string',
    'RouteType': 'DEFAULT'|'URI_PATH',
    'ServiceId': 'string',
    'SourcePath': 'string',
    'State': 'CREATING'|'ACTIVE'|'DELETING'|'FAILED'|'UPDATING'|'INACTIVE',
    'Tags': {
        'string': 'string'
    }
}

Response Structure

• (dict) --

  • ApplicationId (string) --

    The ID of the application that the route belongs to.

  • Arn (string) --

    The Amazon Resource Name (ARN) of the route.

  • CreatedByAccountId (string) --

    The Amazon Web Services account ID of the route creator.

  • CreatedTime (datetime) --

    The timestamp of when the route is created.

  • EnvironmentId (string) --

    Unique identifier of the environment.

  • Error (dict) --

    Any error associated with the route resource.

    • AccountId (string) --

      The Amazon Web Services account ID of the resource owner.

    • AdditionalDetails (dict) --

      Additional details about the error.

      • (string) --
        • (string) --

    • Code (string) --

      The error code associated with the error.

    • Message (string) --

      The message associated with the error.

    • ResourceIdentifier (string) --

      The ID of the resource.

    • ResourceType (string) --

      The type of resource.

  • IncludeChildPaths (boolean) --

    Indicates whether to match all subpaths of the given source path. If this value is false , requests must match the source path exactly before they are forwarded to this route's service.

  • LastUpdatedTime (datetime) --

    A timestamp that indicates when the route was last updated.

  • Methods (list) --

    A list of HTTP methods to match. An empty list matches all values. If a method is present, only HTTP requests using that method are forwarded to this route’s service.

    • (string) --

  • OwnerAccountId (string) --

    The Amazon Web Services account ID of the route owner.

  • PathResourceToId (dict) --

    A mapping of Amazon API Gateway path resources to resource IDs.

    • (string) --
      • (string) --

  • RouteId (string) --

    The unique identifier of the route.

    DEFAULT : All traffic that does not match another route is forwarded to the default route. Applications must have a default route before any other routes can be created.

    URI_PATH : A route that is based on a URI path.

  • RouteType (string) --

    The type of route.

  • ServiceId (string) --

    The unique identifier of the service.

  • SourcePath (string) --

    The path to use to match traffic. Paths must start with / and are relative to the base of the application.

  • State (string) --

    The current state of the route.

  • Tags (dict) --

    The tags assigned to the route. A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key-value pair.

    • (string) --
      • (string) --

Exceptions

• MigrationHubRefactorSpaces.Client.exceptions.ResourceNotFoundException
• MigrationHubRefactorSpaces.Client.exceptions.InternalServerException
• MigrationHubRefactorSpaces.Client.exceptions.ValidationException
• MigrationHubRefactorSpaces.Client.exceptions.ThrottlingException
• MigrationHubRefactorSpaces.Client.exceptions.AccessDeniedException