Home Original page

Client — AWS SDK for Ruby V3

Class: Aws::InternetMonitor::Client

Overview

An API client for InternetMonitor. To construct a client, you need to configure a :region and :credentials.

client = Aws::InternetMonitor::Client.new(
  region: region_name,
  credentials: credentials,
  # ...
)

For details on configuring region and credentials see the developer guide.

See #initialize for a full list of supported configuration options.

Instance Attribute Summary

Attributes inherited from Seahorse::Client::Base

#config, #handlers

API Operations collapse

Instance Method Summary collapse

Methods included from ClientStubs

#api_requests, #stub_data, #stub_responses

Methods inherited from Seahorse::Client::Base

add_plugin, api, clear_plugins, define, new, #operation_names, plugins, remove_plugin, set_api, set_plugins

Methods included from Seahorse::Client::HandlerBuilder

#handle, #handle_request, #handle_response

Constructor Details

#initialize(options) ⇒ Client

Returns a new instance of Client.


473
474
475
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 473

def initialize(*args)
  super
end

Instance Method Details

#create_monitor(params = {}) ⇒ Types::CreateMonitorOutput

Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built based on information from the application resources that you add: VPCs, Network Load Balancers (NLBs), Amazon CloudFront distributions, and Amazon WorkSpaces directories. Internet Monitor then publishes internet measurements from Amazon Web Services that are specific to the city-networks. That is, the locations and ASNs (typically internet service providers or ISPs), where clients access your application. For more information, see Using Amazon CloudWatch Internet Monitor in the Amazon CloudWatch User Guide.

When you create a monitor, you choose the percentage of traffic that you want to monitor. You can also set a maximum limit for the number of city-networks where client traffic is monitored, that caps the total traffic that Internet Monitor monitors. A city-network maximum is the limit of city-networks, but you only pay for the number of city-networks that are actually monitored. You can update your monitor at any time to change the percentage of traffic to monitor or the city-networks maximum. For more information, see Choosing a city-network maximum value in the Amazon CloudWatch User Guide.


631
632
633
634
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 631

def create_monitor(params = {}, options = {})
  req = build_request(:create_monitor, params)
  req.send_request(options)
end

#delete_monitor(params = {}) ⇒ Struct

Deletes a monitor in Amazon CloudWatch Internet Monitor.


653
654
655
656
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 653

def delete_monitor(params = {}, options = {})
  req = build_request(:delete_monitor, params)
  req.send_request(options)
end

#get_health_event(params = {}) ⇒ Types::GetHealthEventOutput

Gets information that Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor. This information includes the impacted locations, and all the information related to the event, by location.

The information returned includes the impact on performance, availability, and round-trip time, information about the network providers (ASNs), the event type, and so on.

Information rolled up at the global traffic level is also returned, including the impact type and total traffic impact.


760
761
762
763
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 760

def get_health_event(params = {}, options = {})
  req = build_request(:get_health_event, params)
  req.send_request(options)
end

#get_internet_event(params = {}) ⇒ Types::GetInternetEventOutput

Gets information that Amazon CloudWatch Internet Monitor has generated about an internet event. Internet Monitor displays information about recent global health events, called internet events, on a global outages map that is available to all Amazon Web Services customers.

The information returned here includes the impacted location, when the event started and (if the event is over) ended, the type of event (PERFORMANCE or AVAILABILITY), and the status (ACTIVE or RESOLVED).


815
816
817
818
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 815

def get_internet_event(params = {}, options = {})
  req = build_request(:get_internet_event, params)
  req.send_request(options)
end

#get_monitor(params = {}) ⇒ Types::GetMonitorOutput

Gets information about a monitor in Amazon CloudWatch Internet Monitor based on a monitor name. The information returned includes the Amazon Resource Name (ARN), create time, modified time, resources included in the monitor, and status information.


894
895
896
897
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 894

def get_monitor(params = {}, options = {})
  req = build_request(:get_monitor, params)
  req.send_request(options)
end

#get_query_results(params = {}) ⇒ Types::GetQueryResultsOutput

Return the data for a query with the Amazon CloudWatch Internet Monitor query interface. Specify the query that you want to return results for by providing a QueryId and a monitor name.

For more information about using the query interface, including examples, see Using the Amazon CloudWatch Internet Monitor query interface in the Amazon CloudWatch Internet Monitor User Guide.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.


956
957
958
959
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 956

def get_query_results(params = {}, options = {})
  req = build_request(:get_query_results, params)
  req.send_request(options)
end

#get_query_status(params = {}) ⇒ Types::GetQueryStatusOutput

Returns the current status of a query for the Amazon CloudWatch Internet Monitor query interface, for a specified query ID and monitor. When you run a query, check the status to make sure that the query has SUCCEEDED before you review the results.

  • QUEUED: The query is scheduled to run.

  • RUNNING: The query is in progress but not complete.

  • SUCCEEDED: The query completed sucessfully.

  • FAILED: The query failed due to an error.

  • CANCELED: The query was canceled.


1002
1003
1004
1005
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 1002

def get_query_status(params = {}, options = {})
  req = build_request(:get_query_status, params)
  req.send_request(options)
end

#list_health_events(params = {}) ⇒ Types::ListHealthEventsOutput

Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. Returns information for health events including the event start and end times, and the status.

Health events that have start times during the time frame that is requested are not included in the list of health events.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.


1118
1119
1120
1121
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 1118

def list_health_events(params = {}, options = {})
  req = build_request(:list_health_events, params)
  req.send_request(options)
end

#list_internet_events(params = {}) ⇒ Types::ListInternetEventsOutput

Lists internet events that cause performance or availability issues for client locations. Amazon CloudWatch Internet Monitor displays information about recent global health events, called internet events, on a global outages map that is available to all Amazon Web Services customers.

You can constrain the list of internet events returned by providing a start time and end time to define a total time frame for events you want to list. Both start time and end time specify the time when an event started. End time is optional. If you don't include it, the default end time is the current time.

You can also limit the events returned to a specific status (ACTIVE or RESOLVED) or type (PERFORMANCE or AVAILABILITY).

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.


1200
1201
1202
1203
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 1200

def list_internet_events(params = {}, options = {})
  req = build_request(:list_internet_events, params)
  req.send_request(options)
end

#list_monitors(params = {}) ⇒ Types::ListMonitorsOutput

Lists all of your monitors for Amazon CloudWatch Internet Monitor and their statuses, along with the Amazon Resource Name (ARN) and name of each monitor.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.


1268
1269
1270
1271
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 1268

def list_monitors(params = {}, options = {})
  req = build_request(:list_monitors, params)
  req.send_request(options)
end

#list_tags_for_resource(params = {}) ⇒ Types::ListTagsForResourceOutput

Lists the tags for a resource. Tags are supported only for monitors in Amazon CloudWatch Internet Monitor.


1298
1299
1300
1301
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 1298

def list_tags_for_resource(params = {}, options = {})
  req = build_request(:list_tags_for_resource, params)
  req.send_request(options)
end

#start_query(params = {}) ⇒ Types::StartQueryOutput

Start a query to return data for a specific query type for the Amazon CloudWatch Internet Monitor query interface. Specify a time period for the data that you want returned by using StartTime and EndTime. You filter the query results to return by providing parameters that you specify with FilterParameters.

For more information about using the query interface, including examples, see Using the Amazon CloudWatch Internet Monitor query interface in the Amazon CloudWatch Internet Monitor User Guide.


1423
1424
1425
1426
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 1423

def start_query(params = {}, options = {})
  req = build_request(:start_query, params)
  req.send_request(options)
end

#stop_query(params = {}) ⇒ Struct

Stop a query that is progress for a specific monitor.


1450
1451
1452
1453
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 1450

def stop_query(params = {}, options = {})
  req = build_request(:stop_query, params)
  req.send_request(options)
end

#tag_resource(params = {}) ⇒ Struct

Adds a tag to a resource. Tags are supported only for monitors in Amazon CloudWatch Internet Monitor. You can add a maximum of 50 tags in Internet Monitor.

A minimum of one tag is required for this call. It returns an error if you use the TagResource request with 0 tags.


1486
1487
1488
1489
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 1486

def tag_resource(params = {}, options = {})
  req = build_request(:tag_resource, params)
  req.send_request(options)
end

#untag_resource(params = {}) ⇒ Struct

Removes a tag from a resource.


1512
1513
1514
1515
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 1512

def untag_resource(params = {}, options = {})
  req = build_request(:untag_resource, params)
  req.send_request(options)
end

#update_monitor(params = {}) ⇒ Types::UpdateMonitorOutput

Updates a monitor. You can update a monitor to change the percentage of traffic to monitor or the maximum number of city-networks (locations and ASNs), to add or remove resources, or to change the status of the monitor. Note that you can't change the name of a monitor.

The city-network maximum that you choose is the limit, but you only pay for the number of city-networks that are actually monitored. For more information, see Choosing a city-network maximum value in the Amazon CloudWatch User Guide.


1652
1653
1654
1655
 
# File 'gems/aws-sdk-internetmonitor/lib/aws-sdk-internetmonitor/client.rb', line 1652

def update_monitor(params = {}, options = {})
  req = build_request(:update_monitor, params)
  req.send_request(options)
end