Version 2.5

kf unmap-route

Name

kf unmap-route - Revoke an App's access to receive traffic from the Route.

Synopsis

kf unmap-route APP_NAME DOMAIN [--hostname HOSTNAME] [--path PATH] [flags]

Description

Unmapping an App from a Route will cause traffic matching the Route to no longer be forwarded to the App.

The App may still receive traffic from an unmapped Route for a small period of time while the traffic rules on the gateways are propagated.

The Route will re-balance its routing weights so other Apps mapped to it will receive the traffic. If no other Apps are bound the Route will return a 404 HTTP status code.

Examples

# Unmap myapp.example.com from myapp in the targeted Space
kf unmap-route myapp example.com --hostname myapp

# Unmap the Route in a specific Space
kf unmap-route --space myspace myapp example.com --hostname myapp

# Unmap a Route with a path
kf unmap-route myapp example.com --hostname myapp --path /mypath

Flags

--async

Do not wait for the action to complete on the server before returning.

--destination-port=int32

Port on the App the Route will connect to.

-h, --help

help for unmap-route

--hostname=string

Hostname for the Route.

--path=string

URL path for the Route.

Inherited flags

These flags are inherited from parent commands.

--as=string

Username to impersonate for the operation.

--as-group=strings

Group to impersonate for the operation. Include this flag multiple times to specify multiple groups.

--config=string

Path to the Kf config file to use for CLI requests.

--kubeconfig=string

Path to the kubeconfig file to use for CLI requests.

--log-http

Log HTTP requests to standard error.

--space=string

Space to run the command against. This flag overrides the currently targeted Space.