v61

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-018131,3812.6 MB

Targets

List all Targets associated with an Upstream

get/v2/control-planes/{controlPlaneId}/core-entities/upstreams/{UpstreamIdForTarget}/targets

Path parameters

UpstreamIdForTargetstring required

ID or target of the Target to lookup

Query parameters

sizeinteger

Number of resources to be returned.

offsetstring

Offset from which to return the next set of resources. Use the value of the 'offset' field from the response of a list operation as input here to paginate through all the resources

tagsstring

A list of tags to filter the list of resources on. Multiple tags can be concatenated using ',' to mean AND or using '/' to mean OR.

Response

A successful response listing Targets

nextstring

URI to the next page (may be null)

offsetstring

Offset is used to paginate through the API. Provide this value to the next list operation to fetch the next page

Example response

{
  "data": [
    {
      "id": "089292a7-ba3d-4d88-acf0-97b4b2e2621a",
      "target": "203.0.113.42",
      "upstream": {
        "id": "5f1d7e76-2fed-4806-a6af-869984f025cb"
      },
      "weight": 100
    }
  ]
}