---
title: "GET /global-networks/{globalNetworkId}/route-analyses/{routeAnalysisId}"
method: GET
path: "/global-networks/{globalNetworkId}/route-analyses/{routeAnalysisId}"
---

# GET /global-networks/{globalNetworkId}/route-analyses/{routeAnalysisId}

`GET /global-networks/{globalNetworkId}/route-analyses/{routeAnalysisId}`

Gets information about the specified route analysis.

## Path parameters

- `globalNetworkId` string, required
- `routeAnalysisId` string, required

## Response `200`

Success

- GetRouteAnalysisResponse
  - `RouteAnalysis` object — The route analysis.
    - `GlobalNetworkId` string — The ID of the global network.
    - `OwnerAccountId` string — The ID of the AWS account that created the route analysis.
    - `RouteAnalysisId` string — The ID of the route analysis.
    - `StartTimestamp` string, date-time — The time that the analysis started.
    - `Status` 'RUNNING' | 'COMPLETED' | 'FAILED' — The status of the route analysis.
    - `Source` object — The source.
      - `TransitGatewayAttachmentArn` string — The ARN of the transit gateway attachment.
      - `TransitGatewayArn` string — The ARN of the transit gateway.
      - `IpAddress` string — The IP address.
    - `Destination` object — The destination.
      - `TransitGatewayAttachmentArn` string — The ARN of the transit gateway attachment.
      - `TransitGatewayArn` string — The ARN of the transit gateway.
      - `IpAddress` string — The IP address.
    - `IncludeReturnPath` boolean — Indicates whether to analyze the return path. The return path is not analyzed if the forward path analysis does not succeed.
    - `UseMiddleboxes` boolean — Indicates whether to include the location of middlebox appliances in the route analysis.
    - `ForwardPath` object — The forward path.
      - `CompletionStatus` object — The status of the analysis at completion.
        - `ResultCode` 'CONNECTED' | 'NOT_CONNECTED' — The result of the analysis. If the status is <code>NOT_CONNECTED</code>, check the reason code.
        - `ReasonCode` 'TRANSIT_GATEWAY_ATTACHMENT_NOT_FOUND' | 'TRANSIT_GATEWAY_ATTACHMENT_NOT_IN_TRANSIT_GATEWAY' | 'CYCLIC_PATH_DETECTED' | 'TRANSIT_GATEWAY_ATTACHMENT_STABLE_ROUTE_TABLE_NOT_FOUND' | 'ROUTE_NOT_FOUND' | 'BLACKHOLE_ROUTE_FOR_DESTINATION_FOUND' | 'INACTIVE_ROUTE_FOR_DESTINATION_FOUND' | 'TRANSIT_GATEWAY_ATTACHMENT_ATTACH_ARN_NO_MATCH' | 'MAX_HOPS_EXCEEDED' | 'POSSIBLE_MIDDLEBOX' | 'NO_DESTINATION_ARN_PROVIDED' — <p>The reason code. Available only if a connection is not found.</p> <ul> <li> <p> <code>BLACKHOLE_ROUTE_FOR_DESTINATION_FOUND</code> - Found a black hole route with the destination CIDR block.</p> </li> <li> <p> <code>CYCLIC_PATH_DETECTED</code> - Found the same resource multiple times while traversing the path.</p> </li> <li> <p> <code>INACTIVE_ROUTE_FOR_DESTINATION_FOUND</code> - Found an inactive route with the destination CIDR block.</p> </li> <li> <p> <code>MAX_HOPS_EXCEEDED</code> - Analysis exceeded 64 hops without finding the destination.</p> </li> <li> <p> <code>ROUTE_NOT_FOUND</code> - Cannot find a route table with the destination CIDR block.</p> </li> <li> <p> <code>TGW_ATTACH_ARN_NO_MATCH</code> - Found an attachment, but not with the correct destination ARN.</p> </li> <li> <p> <code>TGW_ATTACH_NOT_FOUND</code> - Cannot find an attachment.</p> </li> <li> <p> <code>TGW_ATTACH_NOT_IN_TGW</code> - Found an attachment, but not to the correct transit gateway.</p> </li> <li> <p> <code>TGW_ATTACH_STABLE_ROUTE_TABLE_NOT_FOUND</code> - The state of the route table association is not associated.</p> </li> </ul>
        - `ReasonContext` object — Additional information about the path. Available only if a connection is not found.
      - `Path` PathComponent[] — The route analysis path.
        - `Sequence` integer — The sequence number in the path. The destination is 0.
        - `Resource` object — The resource.
          - `RegisteredGatewayArn` string — The ARN of the gateway.
          - `ResourceArn` string — The ARN of the resource.
          - `ResourceType` string — The resource type.
          - `Definition` string — Information about the resource, in JSON format. Network Manager gets this information by describing the resource using its Describe API call.
          - `NameTag` string — The value for the Name tag.
          - `IsMiddlebox` boolean — Indicates whether this is a middlebox appliance.
        - `DestinationCidrBlock` string — The destination CIDR block in the route table.
    - `ReturnPath` object — The return path.
      - `CompletionStatus` object — The status of the analysis at completion.
        - `ResultCode` 'CONNECTED' | 'NOT_CONNECTED' — The result of the analysis. If the status is <code>NOT_CONNECTED</code>, check the reason code.
        - `ReasonCode` 'TRANSIT_GATEWAY_ATTACHMENT_NOT_FOUND' | 'TRANSIT_GATEWAY_ATTACHMENT_NOT_IN_TRANSIT_GATEWAY' | 'CYCLIC_PATH_DETECTED' | 'TRANSIT_GATEWAY_ATTACHMENT_STABLE_ROUTE_TABLE_NOT_FOUND' | 'ROUTE_NOT_FOUND' | 'BLACKHOLE_ROUTE_FOR_DESTINATION_FOUND' | 'INACTIVE_ROUTE_FOR_DESTINATION_FOUND' | 'TRANSIT_GATEWAY_ATTACHMENT_ATTACH_ARN_NO_MATCH' | 'MAX_HOPS_EXCEEDED' | 'POSSIBLE_MIDDLEBOX' | 'NO_DESTINATION_ARN_PROVIDED' — <p>The reason code. Available only if a connection is not found.</p> <ul> <li> <p> <code>BLACKHOLE_ROUTE_FOR_DESTINATION_FOUND</code> - Found a black hole route with the destination CIDR block.</p> </li> <li> <p> <code>CYCLIC_PATH_DETECTED</code> - Found the same resource multiple times while traversing the path.</p> </li> <li> <p> <code>INACTIVE_ROUTE_FOR_DESTINATION_FOUND</code> - Found an inactive route with the destination CIDR block.</p> </li> <li> <p> <code>MAX_HOPS_EXCEEDED</code> - Analysis exceeded 64 hops without finding the destination.</p> </li> <li> <p> <code>ROUTE_NOT_FOUND</code> - Cannot find a route table with the destination CIDR block.</p> </li> <li> <p> <code>TGW_ATTACH_ARN_NO_MATCH</code> - Found an attachment, but not with the correct destination ARN.</p> </li> <li> <p> <code>TGW_ATTACH_NOT_FOUND</code> - Cannot find an attachment.</p> </li> <li> <p> <code>TGW_ATTACH_NOT_IN_TGW</code> - Found an attachment, but not to the correct transit gateway.</p> </li> <li> <p> <code>TGW_ATTACH_STABLE_ROUTE_TABLE_NOT_FOUND</code> - The state of the route table association is not associated.</p> </li> </ul>
        - `ReasonContext` object — Additional information about the path. Available only if a connection is not found.
      - `Path` PathComponent[] — The route analysis path.
        - `Sequence` integer — The sequence number in the path. The destination is 0.
        - `Resource` object — The resource.
          - `RegisteredGatewayArn` string — The ARN of the gateway.
          - `ResourceArn` string — The ARN of the resource.
          - `ResourceType` string — The resource type.
          - `Definition` string — Information about the resource, in JSON format. Network Manager gets this information by describing the resource using its Describe API call.
          - `NameTag` string — The value for the Name tag.
          - `IsMiddlebox` boolean — Indicates whether this is a middlebox appliance.
        - `DestinationCidrBlock` string — The destination CIDR block in the route table.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — InternalServerException

---

[API](https://skmtc.net/aws/apis/networkmanager.md) · [All operations](https://skmtc.net/aws/apis/networkmanager/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/networkmanager/versions/4ea0acef56bf/schema)