# cf-lookup-route

**Repository Path**: mirrors_cloudfoundry/cf-lookup-route

## Basic Information

- **Project Name**: cf-lookup-route
- **Description**: A plugin for the CF-CLI to quickly identify the application a certain route is pointing to.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-07-04
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cloud Foundry Route Lookup Plugin

This is a Cloud Foundry CLI plugin to quickly identify applications, a given route is pointing to.
Note this will only show applications in organizations and spaces, that the logged-in user has permissions to view.
The plugin also supports targeting to the organization and space of the applications, a given route is pointing to.

## Installation

Run

```
cf install-plugin -r CF-Community cf-lookup-route
```
    
Alternatively:

1. Download the appropriate binary from [the Releases page](https://github.com/cloudfoundry/cf-lookup-route/releases).
2. Run

    ```
    cf install-plugin PATH_TO_ROUTE_LOOKUP_BINARY
    ```

## Usage

OPTIONS:

-t: Target the org/space containing the route

EXAMPLES:

```
$ cf lookup-route <https://my.example.com>
Bound to:
Organization: <org> (<org_guid>)
Space       : <space> (<space_guid>)
App         : <app1> (<app_guid_1>)
App         : <app2> (<app_guid_2>)

# use -t to target the org/space containing the route
$ cf lookup-route -t <https://my.example.com>

Bound to:
Organization: <org> (<org_guid>)
Space       : <space> (<space_guid>)
App         : <app> (<app_guid>)

Targeting an app's organization and space...
<cf target command output>
Targeting an app's organization and space successful.

$ cf lookup-route <https://unknown.example.com>
Error retrieving apps: Route <unknown.example.com> not found.
```
## Uninstallation

```
cf uninstall-plugin lookup-route
```