7.2. Managing subscriptions

Prerequisites

• You have installed the Knative (kn) CLI.
• You have created a subscription in your cluster.

Procedure

• Describe a subscription:

  $ kn subscription describe <subscription_name>

  Example output

  Name:            my-subscription
  Namespace:       default
  Annotations:     messaging.knative.dev/creator=openshift-user, messaging.knative.dev/lastModifier=min ...
  Age:             43s
  Channel:         Channel:my-channel (messaging.knative.dev/v1)
  Subscriber:
    URI:           http://edisplay.default.example.com
  Reply:
    Name:          default
    Resource:      Broker (eventing.knative.dev/v1)
  DeadLetterSink:
    Name:          my-sink
    Resource:      Service (serving.knative.dev/v1)
  
  Conditions:
    OK TYPE                  AGE REASON
    ++ Ready                 43s
    ++ AddedToChannel        43s
    ++ ChannelReady          43s
    ++ ReferencesResolved    43s

Prerequisites

• You have installed the Knative (kn) CLI.

Procedure

• List subscriptions on your cluster:

  $ kn subscription list

  Example output

  NAME             CHANNEL             SUBSCRIBER           REPLY   DEAD LETTER SINK   READY   REASON
  mysubscription   Channel:mychannel   ksvc:event-display                              True

Prerequisites

• You have installed the Knative (kn) CLI.
• You have created a subscription.

Procedure

• Update a subscription:

  $ kn subscription update <subscription_name> \
    --sink <sink_prefix>:<sink_name> \ 

  1

  
    --sink-dead-letter <sink_prefix>:<sink_name> 

  2

  1

  --sink specifies the updated target destination to which the event should be delivered. You can specify the type of the sink by using one of the following prefixes:

  ksvc

  A Knative service.

  channel

  A channel that should be used as destination. Only default channel types can be referenced here.

  broker

  An Eventing broker.

  2

  Optional: --sink-dead-letter is an optional flag that can be used to specify a sink which events should be sent to in cases where events fail to be delivered. For more information, see the OpenShift Serverless Event delivery documentation.

  Example command

  $ kn subscription update mysubscription --sink ksvc:event-display