2023/12/22 - Amazon CloudWatch Network Monitor - 12 new api methods
Changes CloudWatch Network Monitor is a new service within CloudWatch that will help network administrators and operators continuously monitor network performance metrics such as round-trip-time and packet loss between their AWS-hosted applications and their on-premises locations.
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.
See also: AWS API Documentation
Request Syntax
client.create_probe(
monitorName='string',
probe={
'sourceArn': 'string',
'destination': 'string',
'destinationPort': 123,
'protocol': 'TCP'|'ICMP',
'packetSize': 123,
'tags': {
'string': 'string'
}
},
clientToken='string',
tags={
'string': 'string'
}
)
string
[REQUIRED]
The name of the monitor to associated with the probe. To get a list of available monitors, use ListMonitors .
dict
[REQUIRED]
Describes the details of an individual probe for a monitor.
sourceArn (string) -- [REQUIRED]
The ARN of the subnet.
destination (string) -- [REQUIRED]
The destination IP address. This will be either IPV4 or IPV6 .
destinationPort (integer) --
The port associated with the destination . This is required only if the protocol is TCP and must be a number between 1 and 65536 .
protocol (string) -- [REQUIRED]
The protocol used for the network traffic between the source and destination . This will be either TCP or ICMP .
packetSize (integer) --
The size of the packets sent between the source and destination. This will be a number between 56 and 8500 .
tags (dict) --
The list of key-value pairs created and assigned to the monitor.
(string) --
(string) --
string
Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.
This field is autopopulated if not provided.
dict
The list of key-value pairs created and assigned to the probe.
(string) --
(string) --
dict
Response Syntax
{
'probeId': 'string',
'probeArn': 'string',
'sourceArn': 'string',
'destination': 'string',
'destinationPort': 123,
'protocol': 'TCP'|'ICMP',
'packetSize': 123,
'addressFamily': 'IPV4'|'IPV6',
'vpcId': 'string',
'state': 'PENDING'|'ACTIVE'|'INACTIVE'|'ERROR'|'DELETING'|'DELETED',
'createdAt': datetime(2015, 1, 1),
'modifiedAt': datetime(2015, 1, 1),
'tags': {
'string': 'string'
}
}
Response Structure
(dict) --
probeId (string) --
The ID of the probe for which details are returned.
probeArn (string) --
The ARN of the probe.
sourceArn (string) --
The ARN of the probe.
destination (string) --
The destination IP address for the monitor. This will be either an IPv4 or IPv6 address.
destinationPort (integer) --
The port associated with the destination . This is required only if the protocol is TCP and must be a number between 1 and 65536 .
protocol (string) --
The protocol used for the network traffic between the source and destination . This will be either TCP or ICMP .
packetSize (integer) --
The size of the packets sent between the source and destination. This will be a number between 56 and 8500 .
addressFamily (string) --
Indicates whether the IP address is IPV4 or IPV6 .
vpcId (string) --
The ID of the source VPC or subnet.
state (string) --
The state of the probe.
createdAt (datetime) --
The time and date that the probe was created.
modifiedAt (datetime) --
The time and date when the probe was last modified.
tags (dict) --
The list of key-value pairs assigned to the probe.
(string) --
(string) --
Deletes a specified monitor.
See also: AWS API Documentation
Request Syntax
client.delete_monitor(
monitorName='string'
)
string
[REQUIRED]
The name of the monitor to delete. Use the ListMonitors action to get a list of your current monitors.
dict
Response Syntax
{}
Response Structure
(dict) --
Removes a key-value pair from a monitor or probe.
See also: AWS API Documentation
Request Syntax
client.untag_resource(
resourceArn='string',
tagKeys=[
'string',
]
)
string
[REQUIRED]
The ARN of the monitor or probe that the tag should be removed from.
list
[REQUIRED]
The key-value pa
(string) --
dict
Response Syntax
{}
Response Structure
(dict) --
Deletes the specified monitor. Once a probe is deleted you'll no longer incur any billing fees for that probe.
See also: AWS API Documentation
Request Syntax
client.delete_probe(
monitorName='string',
probeId='string'
)
string
[REQUIRED]
The name of the monitor to delete. For a list of the available monitors, use the ListMonitors action.
string
[REQUIRED]
The ID of the probe to delete. Run GetMonitor to get a lst of all probes and probe IDs associated with the monitor.
dict
Response Syntax
{}
Response Structure
(dict) --
Adds key-value pairs to a monitor or probe.
See also: AWS API Documentation
Request Syntax
client.tag_resource(
resourceArn='string',
tags={
'string': 'string'
}
)
string
[REQUIRED]
The ARN of the monitor or probe to tag.
dict
[REQUIRED]
The list of key-value pairs assigned to the monitor or probe.
(string) --
(string) --
dict
Response Syntax
{}
Response Structure
(dict) --
Updates the aggregationPeriod for a monitor. Monitors support an aggregationPeriod of either 30 or 60 seconds.
See also: AWS API Documentation
Request Syntax
client.update_monitor(
monitorName='string',
aggregationPeriod=123
)
string
[REQUIRED]
The name of the monitor to update. Run ListMonitors to get a list of monitor names.
integer
[REQUIRED]
The aggregation time, in seconds, to change to. This must be either 30 or 60 .
dict
Response Syntax
{
'monitorArn': 'string',
'monitorName': 'string',
'state': 'PENDING'|'ACTIVE'|'INACTIVE'|'ERROR'|'DELETING',
'aggregationPeriod': 123,
'tags': {
'string': 'string'
}
}
Response Structure
(dict) --
monitorArn (string) --
The ARN of the monitor that was updated.
monitorName (string) --
The name of the monitor that was updated.
state (string) --
The state of the updated monitor.
aggregationPeriod (integer) --
The changed aggregation period.
tags (dict) --
The list of key-value pairs associated with the monitor.
(string) --
(string) --
Lists the tags assigned to this resource.
See also: AWS API Documentation
Request Syntax
client.list_tags_for_resource(
resourceArn='string'
)
string
[REQUIRED]
The
dict
Response Syntax
{
'tags': {
'string': 'string'
}
}
Response Structure
(dict) --
tags (dict) --
Lists the tags assigned to the resource.
(string) --
(string) --
Creates a monitor between a source subnet and destination IP address. Within a monitor you'll create one or more probes that monitor network traffic between your source Amazon Web Services VPC subnets and your destination IP addresses. Each probe then aggregates and sends metrics to Amazon CloudWatch.
See also: AWS API Documentation
Request Syntax
client.create_monitor(
monitorName='string',
probes=[
{
'sourceArn': 'string',
'destination': 'string',
'destinationPort': 123,
'protocol': 'TCP'|'ICMP',
'packetSize': 123,
'probeTags': {
'string': 'string'
}
},
],
aggregationPeriod=123,
clientToken='string',
tags={
'string': 'string'
}
)
string
[REQUIRED]
The name identifying the monitor. It can contain only letters, underscores (_), or dashes (-), and can be up to 255 characters.
list
Displays a list of all of the probes created for a monitor.
(dict) --
Creates a monitor probe.
sourceArn (string) -- [REQUIRED]
The ARN of the subnet.
destination (string) -- [REQUIRED]
The destination IP address. This will be either IPV4 or IPV6 .
destinationPort (integer) --
The port associated with the destination . This is required only if the protocol is TCP and must be a number between 1 and 65536 .
protocol (string) -- [REQUIRED]
The protocol used for the network traffic between the source and destination . This will be either TCP or ICMP .
packetSize (integer) --
The size of the packets sent between the source and destination. This will be a number between 56 and 8500 .
probeTags (dict) --
The list of key-value pairs created and assigned to the monitor.
(string) --
(string) --
integer
The time, in seconds, that metrics are aggregated and sent to Amazon CloudWatch. Valid values are either 30 or 60 .
string
Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.
This field is autopopulated if not provided.
dict
The list of key-value pairs created and assigned to the monitor.
(string) --
(string) --
dict
Response Syntax
{
'monitorArn': 'string',
'monitorName': 'string',
'state': 'PENDING'|'ACTIVE'|'INACTIVE'|'ERROR'|'DELETING',
'aggregationPeriod': 123,
'tags': {
'string': 'string'
}
}
Response Structure
(dict) --
monitorArn (string) --
The ARN of the monitor.
monitorName (string) --
The name of the monitor.
state (string) --
The state of the monitor.
aggregationPeriod (integer) --
The number of seconds that metrics are aggregated by and sent to Amazon CloudWatch. This will be either 30 or 60 .
tags (dict) --
The list of key-value pairs assigned to the monitor.
(string) --
(string) --
Returns details about a specific monitor.
See also: AWS API Documentation
Request Syntax
client.get_monitor(
monitorName='string'
)
string
[REQUIRED]
The name of the monitor that details are returned for.
dict
Response Syntax
{
'monitorArn': 'string',
'monitorName': 'string',
'state': 'PENDING'|'ACTIVE'|'INACTIVE'|'ERROR'|'DELETING',
'aggregationPeriod': 123,
'tags': {
'string': 'string'
},
'probes': [
{
'probeId': 'string',
'probeArn': 'string',
'sourceArn': 'string',
'destination': 'string',
'destinationPort': 123,
'protocol': 'TCP'|'ICMP',
'packetSize': 123,
'addressFamily': 'IPV4'|'IPV6',
'vpcId': 'string',
'state': 'PENDING'|'ACTIVE'|'INACTIVE'|'ERROR'|'DELETING'|'DELETED',
'createdAt': datetime(2015, 1, 1),
'modifiedAt': datetime(2015, 1, 1),
'tags': {
'string': 'string'
}
},
],
'createdAt': datetime(2015, 1, 1),
'modifiedAt': datetime(2015, 1, 1)
}
Response Structure
(dict) --
monitorArn (string) --
The ARN of the selected monitor.
monitorName (string) --
The name of the monitor. To get a list of the current monitors and their names, use the ListMonitors action.
state (string) --
Returns a list of the state of each monitor.
aggregationPeriod (integer) --
The aggregation period for the specified monitor.
tags (dict) --
The list of key-value pairs assigned to the monitor.
(string) --
(string) --
probes (list) --
The details about each probe associated with that monitor.
(dict) --
Describes information about a monitor probe.
probeId (string) --
The ID of the probe.
probeArn (string) --
The ARN of the probe.
sourceArn (string) --
The ARN of the probe source subnet.
destination (string) --
The destination for the probe. This should be either an IPV4 or IPV6 .
destinationPort (integer) --
The destination port for the probe. This is required only if the protocol is TCP and must be a number between 1 and 65536 .
protocol (string) --
The network protocol for the destination. This can be either TCP or ICMP . If the protocol is TCP , then port is also required.
packetSize (integer) --
The size of the packets traveling between the source and destination . This must be a number between 56 and
addressFamily (string) --
The IPv4 or IPv6 address for the probe.
vpcId (string) --
The ID of the source VPC subnet.
state (string) --
The state of the probe.
createdAt (datetime) --
The time and date the probe was created.
modifiedAt (datetime) --
The time and date that the probe was last modified.
tags (dict) --
The list of key-value pairs created and assigned to the probe.
(string) --
(string) --
createdAt (datetime) --
The time and date when the monitor was created.
modifiedAt (datetime) --
The time and date when the monitor was last modified.
Returns a list of all of your monitors.
See also: AWS API Documentation
Request Syntax
client.list_monitors(
nextToken='string',
maxResults=123,
state='string'
)
string
The token for the next page of results.
integer
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.
If MaxResults is given a value larger than 100, only 100 results are returned.
string
The list of all monitors and their states.
dict
Response Syntax
{
'monitors': [
{
'monitorArn': 'string',
'monitorName': 'string',
'state': 'PENDING'|'ACTIVE'|'INACTIVE'|'ERROR'|'DELETING',
'aggregationPeriod': 123,
'tags': {
'string': 'string'
}
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
monitors (list) --
Lists individual details about each of your monitors.
(dict) --
Displays summary information about a monitor.
monitorArn (string) --
The ARN of the monitor.
monitorName (string) --
The name of the monitor.
state (string) --
The state of the monitor.
aggregationPeriod (integer) --
The time, in seconds, that metrics are collected and sent to Amazon CloudWatch. Valid values are either 30 or 60 .
tags (dict) --
The list of key-value pairs assigned to the monitor.
(string) --
(string) --
nextToken (string) --
The token for the next page of results.
Updates a monitor 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.
See also: AWS API Documentation
Request Syntax
client.update_probe(
monitorName='string',
probeId='string',
state='PENDING'|'ACTIVE'|'INACTIVE'|'ERROR'|'DELETING'|'DELETED',
destination='string',
destinationPort=123,
protocol='TCP'|'ICMP',
packetSize=123
)
string
[REQUIRED]
The name of the monitor that the probe was updated for.
string
[REQUIRED]
Run GetMonitor to get a list of probes and probe IDs.
string
The state of the probe update.
string
The updated IP address for the probe destination. This must be either an IPv4 or IPv6 address.
integer
The updated port for the probe destination. This is required only if the protocol is TCP and must be a number between 1 and 65536 .
string
The updated network protocol for the destination. This can be either TCP or ICMP . If the protocol is TCP , then port is also required.
integer
he updated packets size for network traffic between the source and destination. This must be a number between 56 and 8500 .
dict
Response Syntax
{
'probeId': 'string',
'probeArn': 'string',
'sourceArn': 'string',
'destination': 'string',
'destinationPort': 123,
'protocol': 'TCP'|'ICMP',
'packetSize': 123,
'addressFamily': 'IPV4'|'IPV6',
'vpcId': 'string',
'state': 'PENDING'|'ACTIVE'|'INACTIVE'|'ERROR'|'DELETING'|'DELETED',
'createdAt': datetime(2015, 1, 1),
'modifiedAt': datetime(2015, 1, 1),
'tags': {
'string': 'string'
}
}
Response Structure
(dict) --
probeId (string) --
The updated ID of the probe.
probeArn (string) --
The updated ARN of the probe.
sourceArn (string) --
The updated ARN of the source subnet.
destination (string) --
The updated destination IP address for the probe.
destinationPort (integer) --
The updated destination port. This will be a number between 1 and 65536 .
protocol (string) --
The updated protocol for the probe.
packetSize (integer) --
The updated packet size for the probe.
addressFamily (string) --
The updated IP address family. This will be either IPV4 or IPV6 .
vpcId (string) --
The updated ID of the source VPC subnet ID.
state (string) --
The state of the updated probe.
createdAt (datetime) --
The time and date that the probe was created.
modifiedAt (datetime) --
The time and date that the probe was last updated.
tags (dict) --
Update tags for a probe.
(string) --
(string) --
Returns the details about a probe. You'll need both the monitorName and probeId .
See also: AWS API Documentation
Request Syntax
client.get_probe(
monitorName='string',
probeId='string'
)
string
[REQUIRED]
The name of the monitor associated with the probe. Run ListMonitors to get a list of monitor names.
string
[REQUIRED]
The ID of the probe to get information about. Run GetMonitor action to get a list of probes and probe IDs for the monitor.
dict
Response Syntax
{
'probeId': 'string',
'probeArn': 'string',
'sourceArn': 'string',
'destination': 'string',
'destinationPort': 123,
'protocol': 'TCP'|'ICMP',
'packetSize': 123,
'addressFamily': 'IPV4'|'IPV6',
'vpcId': 'string',
'state': 'PENDING'|'ACTIVE'|'INACTIVE'|'ERROR'|'DELETING'|'DELETED',
'createdAt': datetime(2015, 1, 1),
'modifiedAt': datetime(2015, 1, 1),
'tags': {
'string': 'string'
}
}
Response Structure
(dict) --
probeId (string) --
The ID of the probe for which details are returned.
probeArn (string) --
The ARN of the probe.
sourceArn (string) --
The ARN of the probe.
destination (string) --
The destination IP address for the monitor. This will be either an IPv4 or IPv6 address.
destinationPort (integer) --
The port associated with the destination . This is required only if the protocol is TCP and must be a number between 1 and 65536 .
protocol (string) --
The protocol used for the network traffic between the source and destination . This will be either TCP or ICMP .
packetSize (integer) --
The size of the packets sent between the source and destination. This will be a number between 56 and 8500 .
addressFamily (string) --
Indicates whether the IP address is IPV4 or IPV6 .
vpcId (string) --
The ID of the source VPC or subnet.
state (string) --
The state of the probe.
createdAt (datetime) --
The time and date that the probe was created.
modifiedAt (datetime) --
The time and date that the probe was last modified.
tags (dict) --
The list of key-value pairs assigned to the probe.
(string) --
(string) --