---
title: "GET /2023-10-12/monitors"
method: GET
path: "/2023-10-12/monitors"
---

# GET /2023-10-12/monitors

`GET /2023-10-12/monitors`

Gets a list of your monitors in Deadline Cloud.

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListMonitorsResponse — Shared pagination field for List operation outputs (nextToken).
  - `monitors` MonitorSummary[], required — A list of <code>MonitorSummary</code> objects that describe your monitors in the Deadline Cloud.
    - `monitorId` string, required — The unique identifier for the monitor.
    - `displayName` string, required — <p>The name of the monitor that displays on the Deadline Cloud console.</p> <important> <p>This field can store any content. Escape or encode this content before displaying it on a webpage or any other system that might interpret the content of this field.</p> </important>
    - `subdomain` string, required — The subdomain used for the monitor URL. The full URL of the monitor is subdomain.Region.deadlinecloud.amazonaws.com.
    - `url` string, required — The complete URL of the monitor. The full URL of the monitor is subdomain.Region.deadlinecloud.amazonaws.com.
    - `roleArn` string, required — The Amazon Resource Name of the IAM role for the monitor. Users of the monitor use this role to access Deadline Cloud resources.
    - `identityCenterInstanceArn` string, required — The Amazon Resource Name of the IAM Identity Center instance responsible for authenticating monitor users.
    - `identityCenterRegion` string — The Region where IAM Identity Center is enabled.
    - `identityCenterApplicationArn` string, required — The Amazon Resource Name that the IAM Identity Center assigned to the monitor when it was created.
    - `createdAt` string, date-time, required — The UNIX timestamp of the date and time that the monitor was created.
    - `createdBy` string, required — The user name of the person that created the monitor.
    - `updatedAt` string, date-time — The UNIX timestamp of the date and time that the monitor was last updated.
    - `updatedBy` string — The user name of the person that last updated the monitor.
  - `nextToken` string — If Deadline Cloud returns <code>nextToken</code>, then there are more results available. The value of <code>nextToken</code> is a unique pagination token for each page. To retrieve the next page, call the operation again using the returned token. Keep all other arguments unchanged. If no results remain, then <code>nextToken</code> is set to <code>null</code>. Each pagination token expires after 24 hours. If you provide a token that isn't valid, then you receive an HTTP 400 <code>ValidationException</code> error.

## Other responses

- `480` — AccessDeniedException
- `481` — InternalServerErrorException
- `482` — ThrottlingException
- `483` — ValidationException

---

[API](https://skmtc.net/aws/apis/deadline.md) · [All operations](https://skmtc.net/aws/apis/deadline/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/deadline/versions/259a7ebfefa8/schema)