---
title: "POST /monitors/{monitorName}/probes"
method: POST
path: "/monitors/{monitorName}/probes"
---

# POST /monitors/{monitorName}/probes

`POST /monitors/{monitorName}/probes`

Create a probe within a monitor. Once you create a probe, and it begins monitoring your network traffic, you'll incur billing charges for that probe. This action requires the <code>monitorName</code> parameter. Run <code>ListMonitors</code> to get a list of monitor names. Note the name of the <code>monitorName</code> you want to create the probe for.

## Path parameters

- `monitorName` string, required

## Request body

- object
  - `probe` object, required — Defines a probe when creating a probe or monitor.
    - `sourceArn` string — The ARN of the subnet.
    - `destination` string — The destination IP address. This must be either <code>IPV4</code> or <code>IPV6</code>.
    - `destinationPort` integer — The port associated with the <code>destination</code>. 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' — The protocol used for the network traffic between the <code>source</code> and <code>destination</code>. This must be either <code>TCP</code> or <code>ICMP</code>.
    - `packetSize` integer — The size of the packets sent between the source and destination. This must be a number between <code>56</code> and <code>8500</code>.
    - `tags` object — The list of key-value pairs created and assigned to the monitor.
  - `clientToken` string — Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.
  - `tags` object — The list of key-value pairs created and assigned to the probe.

## Response `200`

Success

- CreateProbeOutput
  - `probeId` string — The ID of the probe for which details are returned.
  - `probeArn` string — The ARN of the probe.
  - `sourceArn` string, required — The ARN of the probe.
  - `destination` string, required — The destination IP address for the monitor. This must be either an IPv4 or IPv6 address.
  - `destinationPort` integer — The port associated with the <code>destination</code>. 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 protocol used for the network traffic between the <code>source</code> and <code>destination</code>. This must be either <code>TCP</code> or <code>ICMP</code>.
  - `packetSize` integer — The size of the packets sent between the source and destination. This must be a number between <code>56</code> and <code>8500</code>.
  - `addressFamily` 'IPV4' | 'IPV6' — Indicates whether the IP address is <code>IPV4</code> or <code>IPV6</code>.
  - `vpcId` string — The ID of the source VPC or subnet.
  - `state` 'PENDING' | 'ACTIVE' | 'INACTIVE' | 'ERROR' | 'DELETING' | 'DELETED' — The state of the probe.
  - `createdAt` string, date-time — The time and date that the probe was created.
  - `modifiedAt` string, date-time — The time and date when the probe was last modified.
  - `tags` object — The list of key-value pairs assigned to the probe.

## Other responses

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

---

[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)