List placement groups

Returns a paginated list of placement groups you have permission to view.

📘

Your user needs at least read-only permission to all Linodes included in a placement group to view it. Placement groups that contain Linodes that you don't have this permission for are left out of the response. If all placement groups contain Linodes that lack this permission, the API returns a 403 error. Talk to your local account administrator about managing permissions.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: placement:read_only

CLI

linode-cli placement groups-list

Learn more

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
Query Params
integer
≥ 1
Defaults to 1

The page of a collection to return.

integer
25 to 500
Defaults to 100

The number of items to return per page.

Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json