Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

GetProbe

Returns the details about a probe. This action requires both the monitorName and probeId parameters. Run ListMonitors to get a list of monitor names. Run GetMonitor to get a list of probes and probe IDs.

Request Syntax


GET /monitors/monitorName/probes/probeId HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

monitorName

The name of the monitor associated with the probe. Run ListMonitors to get a list of monitor names.

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [a-zA-Z0-9_-]+

Required: Yes

probeId

The ID of the probe to get information about. Run GetMonitor action to get a list of probes and probe IDs for the monitor.

Pattern: probe-[a-z0-9A-Z-]{21,64}

Required: Yes

Request Body

The request does not have a request body.

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "addressFamily": "string",
   "createdAt": number,
   "destination": "string",
   "destinationPort": number,
   "modifiedAt": number,
   "packetSize": number,
   "probeArn": "string",
   "probeId": "string",
   "protocol": "string",
   "sourceArn": "string",
   "state": "string",
   "tags": { 
      "string" : "string" 
   },
   "vpcId": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

addressFamily

Indicates whether the IP address is IPV4 or IPV6.

Type: String

Valid Values: IPV4 | IPV6

createdAt

The time and date that the probe was created.

Type: Timestamp

destination

The destination IP address for the monitor. This must be either an IPv4 or IPv6 address.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

destinationPort

The port associated with the destination. This is required only if the protocol is TCP and must be a number between 1 and 65536.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 65536.

modifiedAt

The time and date that the probe was last modified.

Type: Timestamp

packetSize

The size of the packets sent between the source and destination. This must be a number between 56 and 8500.

Type: Integer

Valid Range: Minimum value of 56. Maximum value of 8500.

probeArn

The ARN of the probe.

Type: String

Length Constraints: Minimum length of 20. Maximum length of 2048.

Pattern: arn:.*

probeId

The ID of the probe for which details are returned.

Type: String

Pattern: probe-[a-z0-9A-Z-]{21,64}

protocol

The protocol used for the network traffic between the source and destination. This must be either TCP or ICMP.

Type: String

Valid Values: TCP | ICMP

sourceArn

The ARN of the probe.

Type: String

Length Constraints: Minimum length of 20. Maximum length of 2048.

Pattern: arn:.*

state

The state of the probe.

Type: String

tags

The list of key-value pairs assigned to the probe.

Type: String to string map

Map Entries: Minimum number of 0 items. Maximum number of 200 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Value Length Constraints: Minimum length of 0. Maximum length of 256.

vpcId

The ID of the source VPC or subnet.

Type: String

Pattern: vpc-[a-zA-Z0-9]{8,32}

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

InternalServerException

The request processing has failed because of an unknown error, exception or failure.

HTTP Status Code: 500

ResourceNotFoundException

The specified resource does not exist.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling

HTTP Status Code: 429

ValidationException

One of the parameters for the request is not valid.

HTTP Status Code: 400