Give Feedback

pydo.autoscalepools.list_members()

Generated on 8 May 2026 from pydo version v0.34.0

Copy page as Markdown View page as Markdown

Usage

client.autoscalepools.list_members(
    per_page=20,
    page=1,
    autoscale_pool_id="0d3db13e-a604-4944-9827-7ec2642d32ac",
)

Returns JSONRaises HttpResponseError

Description

To list the Droplets in an autoscale pool, send a GET request to /v2/droplets/autoscale/{autoscale_pool_id}/members.

The response body will be a JSON object with a key of droplets. This will be set to an array containing information about each of the Droplets in the autoscale pool.

Parameters

per_page integer optional

Number of items returned per page

Min: 1

Max: 200

Default: 20

page integer optional

Which 'page' of paginated results to return.

Min: 1

Default: 1

autoscale_pool_id string required

A unique identifier for an autoscale pool.

Pagination

This method returns paginated results. The response includes a links.pages object with URLs for navigating between pages. To retrieve the next page, parse the next URL and pass the page parameter:

from urllib.parse import urlparse, parse_qs

resp = client.autoscalepools.list_members(autoscale_pool_id="0d3db13e-a604-4944-9827-7ec2642d32ac", )
pages = resp.get("links", {}).get("pages", {})

while "next" in pages:
    parsed = urlparse(pages["next"])
    page = int(parse_qs(parsed.query)["page"][0])
    resp = client.autoscalepools.list_members(autoscale_pool_id="0d3db13e-a604-4944-9827-7ec2642d32ac", page=page)
    pages = resp.get("links", {}).get("pages", {})

Response Example

Show Response Example

{
  "droplets": [
    {
      "droplet_id": 123456,
      "created_at": "2020-11-19T20:27:18Z",
      "updated_at": "2020-12-01T00:42:16Z",
      "health_status": "healthy",
      "status": "active",
      "current_utilization": {
        "memory": 0.3588531587713522,
        "cpu": 0.0007338008770232183
      }
    }
  ],
  "links": {
    "pages": null
  },
  "meta": {
    "total": 1
  }
}

More Information

See /v2/droplets/autoscale/{autoscale_pool_id}/members in the API reference for additional detail on responses, headers, parameters, and more.