Manage cluster peering connections

$ consul peering listName        State    Imported Svcs  Exported Svcs  Metacluster-02  ACTIVE   0              2              env=productioncluster-03  PENDING  0              0

For more information, including optional flags and parameters, refer to the consul peering list CLI command reference.

The following example shows how to format an API request to list peering connections:

$ curl --header "X-Consul-Token: 0137db51-5895-4c25-b6cd-d9ed992f4a52" http://127.0.0.1:8500/v1/peerings

For more information, including optional parameters and sample responses, refer to the /peering endpoint reference.

In the Consul UI, click Peers.

The UI lists peering connections you created for clusters in a datacenter. The name that appears in the list is the name of the cluster in a different datacenter with an established peering connection.

The following example outputs information about a peering connection locally referred to as "cluster-02":

$ consul peering read -name cluster-02Name:         cluster-02ID:           3b001063-8079-b1a6-764c-738af5a39a97State:        ACTIVEMeta:    env=production Peer ID:               e83a315c-027e-bcb1-7c0c-a46650904a05Peer Server Name:      server.dc1.consulPeer CA Pems:          0Peer Server Addresses:    10.0.0.1:8300 Imported Services: 0Exported Services: 2 Create Index: 89Modify Index: 89

For more information, including optional flags and parameters, refer to the consul peering read CLI command reference.

$ curl --header "X-Consul-Token: b23b3cad-5ea1-4413-919e-c76884b9ad60" http://127.0.0.1:8500/v1/peering/cluster-02

For more information, including optional parameters and sample responses, refer to the /peering endpoint reference.

1. In the Consul UI, click Peers.

2. Click the name of a peered cluster to view additional details about the peering connection.

The following examples deletes a peering connection to a cluster locally referred to as "cluster-02":

$ consul peering delete -name cluster-02Successfully submitted peering connection, cluster-02, for deletion

For more information, including optional flags and parameters, refer to the consul peering delete CLI command reference.

$ curl --request DELETE --header "X-Consul-Token: b23b3cad-5ea1-4413-919e-c76884b9ad60" http://127.0.0.1:8500/v1/peering/cluster-02

This endpoint does not return a response. For more information, including optional parameters, refer to the /peering endpoint reference.

1. In the Consul UI, click Peers. The UI lists peering connections you created for clusters in that datacenter.
2. Next to the name of the peer, click More (three horizontal dots) and then Delete.
3. Click Delete to confirm and remove the peering connection.