Version 2.3

kf unmap-route

Name

kf unmap-route - Revoke an Apps'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.