Exported Services HTTP Endpoint

Note

The exported services HTTP API endpoint requires Consul v1.17.3 or newer.

The /exported-services endpoint returns a list of exported services, as well as the admin partitions and cluster peers that consume the services.

This list consists of the services that were exported using an exported-services configuration entry. Sameness groups and wildcards in the configuration entry are expanded in the response.

List Exported Services

This endpoint returns a list of exported services.

Method	Path	Produces
`GET`	`/exported-services`	`application/json`

The table below shows this endpoint's support for blocking queries, consistency modes, agent caching, and required ACLs.

Blocking Queries	Consistency Modes	Agent Caching	ACL Required
`YES`	`none`	`none`	`mesh:read` or `operator:read`

Query Parameters

partition (string: "") Enterprise - The admin partition to use. If not provided, the partition is inferred from the request's ACL token, or defaults to the default partition.

Sample Request

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

Sample Response

[    {        "Service": "frontend",        "Consumers": {            "Peers": [                "east",                "west",            ]        }    },    {        "Service": "db",        "Consumers": {            "Peers": [                "east",            ]        }    },    {        "Service": "web",        "Consumers": {            "Peers": [                "east",                "west"            ]        }    }]

[    {        "Service": "frontend",        "Partition": "default",        "Namespace": "default",        "Consumers": {            "Peers": [                "east",                "west"            ],            "Partitions": [                "part1"            ]        }    },    {        "Service": "frontend",        "Partition": "default",        "Namespace": "ns",        "Consumers": {            "Peers": [                "east",            ]        }    },    {        "Service": "web",        "Partition": "default",        "Namespace": "default",        "Consumers": {            "Peers": [                "west"            ],            "Partitions": [                "part1"            ]        }    },    {        "Service": "db",        "Partition": "default",        "Namespace": "default",        "Consumers": {            "Partitions": [                "part1"            ]        }    }]