# pubsub/node/affiliations: nodes subscriptions management

`subscriptions` is a subcommand handling the subscription to a node.

Those commands can only be used by an owner of the node.

## get

Retrieve subscriptions to a node.

If `--public` is used, only public subscriptions are retrieved (if target service supports XEP-0465 Public Pubsub Subscriptions). Public subscriptions are accessible to anybody, thus you can use this on a node even if you are not an owner of it (and thus would not normally be allowed to retrieve subscriptions).

### example

Get subscription from `some_node`:

    $ li pubsub node subscriptions get -n some_node

Retrieve public subscribers to the blog of Louise:

    $ li pubsub node subscriptions get --public -s louise@example.org -n urn:xmpp:microblog:0

## set

Set subscriptions to a node. Subscriptions are specified with `-S JID [SUSBSCRIPTION] [JID [SUSBSCRIPTION] ...], --subscription JID [SUSBSCRIPTION] [JID [SUSBSCRIPTION] ...]` where `JID` is the jid of the entity to change subscription state, and `SUBSCRIPTION` is a subscription state (on of `subscribed`, `pending`, `none`) as specified in XEP-0060 Subscription State. If `SUBSCRIPTION` is not specified, it default to `subscribed`.

### example

Subscribe Louise with her new address at `louise@example.org` and remove her subscription from old `louise@example.com`:

    $ li pubsub node subscriptions set -n some_node -S louise@example.org subscribed louise@example.com none