List Workspaces
amp.list_workspaces
ActionAmazon Web Servicesconnection required
Calls the AWS amp API (SigV4).
Lists all of the Amazon Managed Service for Prometheus workspaces in your account. This includes workspaces being created or deleted.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Amazon Prometheus Service
- Secret shape
- {"access_key_id", "secret_access_key"}
- Config it needs
- region
- Resolved by
- config.connection_id, else node.connection_id
Configuration
4 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
region AWS region (overrides the connection). | string | No | — | — | — |
next_token Continues a previous run of this node: pass that run's paging token here. Leave blank to start at the first page. | string | No | — | — | — |
alias If this is included, it filters the results to only the workspaces with names that start… | string | No | — | — | — |
max_results Maximum items to return. | number | No | 50 | ≥ 1 | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"max_results": 50
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
workspaces | array | — |
nextToken | string | — |
{
"nextToken": "",
"workspaces": []
}Related Amazon Prometheus Service nodes
See List Workspaces run in a workflow.
In a technical demo we add the Amazon Prometheus Service connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.