The information in this doc is based on Juju version 3.5.4, and may not accurately reflect other versions of Juju.
See also: integrate, remove-application
Summary
Removes an existing relation between two applications.
Usage
juju remove-relation [options] <application1>[:<relation name1>] <application2>[:<relation name2>] | <relation-id>
Options
Flag | Default | Usage |
---|---|---|
-B , --no-browser-login |
false | Do not use web browser for authentication |
--force |
false | Force remove a relation |
-m , --model |
Model to operate in. Accepts [<controller name>:]<model name>|<model UUID> |
Examples
juju remove-relation mysql wordpress
juju remove-relation 4
juju remove-relation 4 --force
In the case of multiple relations, the relation name should be specified at least once - the following examples will all have the same effect:
juju remove-relation mediawiki:db mariadb:db
juju remove-relation mediawiki mariadb:db
juju remove-relation mediawiki:db mariadb
Details
An existing relation between the two specified applications will be removed.
This should not result in either of the applications entering an error state,
but may result in either or both of the applications being unable to continue
normal operation. In the case that there is more than one relation between
two applications it is necessary to specify which is to be removed (see
examples). Relations will automatically be removed when using thejuju remove-application
command.
The relation is specified using the relation endpoint names, eg mysql wordpress, or mediawiki:db mariadb:db
It is also possible to specify the relation ID, if known. This is useful to terminate a relation originating from a different model, where only the ID is known.
Sometimes, the removal of the relation may fail as Juju encounters errors and failures that need to be dealt with before a relation can be removed. However, at times, there is a need to remove a relation ignoring all operational errors. In these rare cases, use --force option but note that --force will remove a relation without giving it the opportunity to be removed cleanly.