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