docs/reference-manual/src/main/asciidoc/delete-http-listener.adoc

type=page
status=published
title=delete-http-listener
next=delete-http-redirect.html
prev=delete-http-lb-ref.html
~~~~~~

= delete-http-listener

[[delete-http-listener-1]][[GSRFM00082]][[delete-http-listener]]

== delete-http-listener

Removes a network listener

[[sthref731]]

=== Synopsis

[source]
----
asadmin [asadmin-options] delete-http-listener [--help]
[--target target]
listener-id
----

[[sthref732]]

=== Description

The `delete-http-listener` subcommand removes the specified network
listener.

This subcommand is supported in remote mode only.

[[sthref733]]

=== Options

asadmin-options::
  Options for the `asadmin` utility. For information about these
  options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
  Displays the help text for the subcommand.
`--target`::
  Deletes the network listener only from the specified target. Valid
  values are as follows:

  `server`;;
    Deletes the network listener from the default server instance. This
    is the default value.
  configuration-name;;
    Deletes the network listener from the specified configuration.
  cluster-name;;
    Deletes the network listener from all server instances in the
    specified cluster.
  standalone-instance-name;;
    Deletes the network listener from the specified standalone server
    instance.

[[sthref734]]

=== Operands

listener-id::
  The unique identifier for the network listener to be deleted.

[[sthref735]]

=== Examples

[[GSRFM551]][[sthref736]]

==== Example 1   Using the delete-http-listener subcommand

The following command deletes the network listener named
`sampleListener`:

[source]
----
asadmin> delete-http-listener sampleListener
Command delete-http-listener executed successfully.
----

[[sthref737]]

=== Exit Status

0::
  command executed successfully
1::
  error in executing the command

[[sthref738]]

=== See Also

link:asadmin.html#asadmin-1m[`asadmin`(1M)]

link:create-http-listener.html#create-http-listener-1[`create-http-listener`(1)],
link:list-http-listeners.html#list-http-listeners-1[`list-http-listeners`(1)]