blob: e5f860fbd1b46bc820036d762dfe020e70ea5820 [file] [log] [blame]
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)]