---
title: "GET /monitors/{monitorName}"
method: GET
path: "/monitors/{monitorName}"
---

# GET /monitors/{monitorName}

`GET /monitors/{monitorName}`

Returns details about a specific monitor.

This action requires the `monitorName` parameter. Run `ListMonitors` to get a list of monitor names.

## Path parameters

- `monitorName` string, required

## Response `200`

Success

- GetMonitorOutput
  - `monitorArn` string, required — The ARN of the selected monitor.
  - `monitorName` string, required — The name of the monitor.
  - `state` 'PENDING' | 'ACTIVE' | 'INACTIVE' | 'ERROR' | 'DELETING', required — Lists the status of the <code>state</code> of each monitor.
  - `aggregationPeriod` integer, required — The aggregation period for the specified monitor.
  - `tags` object — The list of key-value pairs assigned to the monitor.
  - `probes` Probe[] — The details about each probe associated with that monitor.
    - `probeId` string — The ID of the probe.
    - `probeArn` string — The ARN of the probe.
    - `sourceArn` string, required — The ARN of the probe source subnet.
    - `destination` string, required — The destination for the probe. This should be either an <code>IPV4</code> or <code>IPV6</code>.
    - `destinationPort` integer — The destination port for the probe. This is required only if the <code>protocol</code> is <code>TCP</code> and must be a number between <code>1</code> and <code>65536</code>.
    - `protocol` 'TCP' | 'ICMP', required — The network protocol for the destination. This can be either <code>TCP</code> or <code>ICMP</code>. If the protocol is <code>TCP</code>, then <code>port</code> is also required.
    - `packetSize` integer — The size of the packets traveling between the <code>source</code> and <code>destination</code>. This must be a number between <code>56</code> and
    - `addressFamily` 'IPV4' | 'IPV6' — The IPv4 or IPv6 address for the probe.
    - `vpcId` string — The ID of the source VPC subnet.
    - `state` 'PENDING' | 'ACTIVE' | 'INACTIVE' | 'ERROR' | 'DELETING' | 'DELETED' — The state of the probe.
    - `createdAt` string, date-time — The time and date the probe was created.
    - `modifiedAt` string, date-time — The time and date that the probe was last modified.
    - `tags` object — The list of key-value pairs created and assigned to the probe.
  - `createdAt` string, date-time, required — The time and date when the monitor was created.
  - `modifiedAt` string, date-time, required — The time and date when the monitor was last modified.

## Other responses

- `480` — AccessDeniedException
- `481` — ResourceNotFoundException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — InternalServerException

---

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