aws-sdk-internetmonitor 1.10.0 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d8a846b18f6295cfe1efdd93af1fa38b856888156d9ba8c60aebc0d8e8f392f
-  data.tar.gz: 4b7de2a58db7ddf8c054e488d094abfd0e6a610bcda3f8d918159ac5fd73203d
+  metadata.gz: bd85642189b06def1f20e4a36cf0a50bf27198fd8b85edb28ad027f251e1c4f3
+  data.tar.gz: 3d97063bc5c945fb3c64f2e48cbd7892b8718a487fa820235e5e7a9848d3f3c5
 SHA512:
-  metadata.gz: b7b35f327cc2728f68f693cdeafa49ded6390513461490ed0865db6534790fc0d7073582f4cd9670952cdac5d69ce0a65a3519970795b9f4b8b0b668da992faa
-  data.tar.gz: 6089c568680ab6f7f395e97dab943a66ee9f4a5b6e28286457fda887f3fe33382dc7df65efd9414e6602ea0169d7c9f20d22c46dcd0c58f04a04583d3f930248
+  metadata.gz: 6ae6b11bb7e01536feb44d7e306ea6b461ca48a776d80b36bc56699a2c5a2c988e58a05377cd28d044349f7d0bcb3ff7dbd30c91cd7dfece756d11eb7c4bac88
+  data.tar.gz: 782135a27cb6e8db1ffe20733593bd01029418fd6bcdce694d3126d08ea2bedeb400bf6113e68f6c66ac96acd34c655f98f6511f4fa2e18e5e72a284b4a5d4f0

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.11.0 (2023-11-17)
+------------------
+
+* Feature - Adds new querying capabilities for running data queries on a monitor
+
 1.10.0 (2023-09-27)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.10.0
+1.11.0

data/lib/aws-sdk-internetmonitor/client.rb

@@ -583,7 +583,7 @@ module Aws::InternetMonitor
     #   The name of the monitor.
     #
     # @option params [required, String] :event_id
-    #   The internally generated identifier of a health event. Because
+    #   The internally-generated identifier of a health event. Because
     #   `EventID` contains the forward slash (“/”) character, you must
     #   URL-encode the `EventID` field in the request URL.
     #
@@ -725,6 +725,114 @@ module Aws::InternetMonitor
       req.send_request(options)
     end
 
+    # 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][1] in the Amazon CloudWatch Internet Monitor User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-view-cw-tools-cwim-query.html
+    #
+    # @option params [required, String] :monitor_name
+    #   The name of the monitor to return data for.
+    #
+    # @option params [required, String] :query_id
+    #   The ID of the query that you want to return data results for. A
+    #   `QueryId` is an internally-generated identifier for a specific query.
+    #
+    # @option params [String] :next_token
+    #   The token for the next set of results. You receive this token from a
+    #   previous call.
+    #
+    # @option params [Integer] :max_results
+    #   The number of query results that you want to return with this call.
+    #
+    # @return [Types::GetQueryResultsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetQueryResultsOutput#fields #fields} => Array<Types::QueryField>
+    #   * {Types::GetQueryResultsOutput#data #data} => Array<Array<String>>
+    #   * {Types::GetQueryResultsOutput#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_query_results({
+    #     monitor_name: "ResourceName", # required
+    #     query_id: "String", # required
+    #     next_token: "String",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.fields #=> Array
+    #   resp.fields[0].name #=> String
+    #   resp.fields[0].type #=> String
+    #   resp.data #=> Array
+    #   resp.data[0] #=> Array
+    #   resp.data[0][0] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetQueryResults AWS API Documentation
+    #
+    # @overload get_query_results(params = {})
+    # @param [Hash] params ({})
+    def get_query_results(params = {}, options = {})
+      req = build_request(:get_query_results, params)
+      req.send_request(options)
+    end
+
+    # 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.
+    #
+    # @option params [required, String] :monitor_name
+    #   The name of the monitor.
+    #
+    # @option params [required, String] :query_id
+    #   The ID of the query that you want to return the status for. A
+    #   `QueryId` is an internally-generated dentifier for a specific query.
+    #
+    # @return [Types::GetQueryStatusOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetQueryStatusOutput#status #status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_query_status({
+    #     monitor_name: "ResourceName", # required
+    #     query_id: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.status #=> String, one of "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELED"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetQueryStatus AWS API Documentation
+    #
+    # @overload get_query_status(params = {})
+    # @param [Hash] params ({})
+    def get_query_status(params = {}, options = {})
+      req = build_request(:get_query_status, params)
+      req.send_request(options)
+    end
+
     # Lists all health events for a monitor in Amazon CloudWatch Internet
     # Monitor. Returns information for health events including the event
     # start and end time and the status.
@@ -910,6 +1018,125 @@ module Aws::InternetMonitor
       req.send_request(options)
     end
 
+    # 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][1] in the Amazon CloudWatch Internet Monitor User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-view-cw-tools-cwim-query.html
+    #
+    # @option params [required, String] :monitor_name
+    #   The name of the monitor to query.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :start_time
+    #   The timestamp that is the beginning of the period that you want to
+    #   retrieve data for with your query.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :end_time
+    #   The timestamp that is the end of the period that you want to retrieve
+    #   data for with your query.
+    #
+    # @option params [required, String] :query_type
+    #   The type of query to run. The following are the three types of queries
+    #   that you can run using the Internet Monitor query interface:
+    #
+    #   * `MEASUREMENTS`: TBD definition
+    #
+    #   * `TOP_LOCATIONS`: TBD definition
+    #
+    #   * `TOP_LOCATION_DETAILS`: TBD definition
+    #
+    #   For lists of the fields returned with each query type and more
+    #   information about how each type of query is performed, see [ Using the
+    #   Amazon CloudWatch Internet Monitor query interface][1] in the Amazon
+    #   CloudWatch Internet Monitor User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-view-cw-tools-cwim-query.html
+    #
+    # @option params [Array<Types::FilterParameter>] :filter_parameters
+    #   The `FilterParameters` field that you use with Amazon CloudWatch
+    #   Internet Monitor queries is a string the defines how you want a query
+    #   to be filtered. The filter parameters that you can specify depend on
+    #   the query type, since each query type returns a different set of
+    #   Internet Monitor data.
+    #
+    #   For more information about specifying filter parameters, see [Using
+    #   the Amazon CloudWatch Internet Monitor query interface][1] in the
+    #   Amazon CloudWatch Internet Monitor User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-view-cw-tools-cwim-query.html
+    #
+    # @return [Types::StartQueryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartQueryOutput#query_id #query_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_query({
+    #     monitor_name: "ResourceName", # required
+    #     start_time: Time.now, # required
+    #     end_time: Time.now, # required
+    #     query_type: "MEASUREMENTS", # required, accepts MEASUREMENTS, TOP_LOCATIONS, TOP_LOCATION_DETAILS
+    #     filter_parameters: [
+    #       {
+    #         field: "String",
+    #         operator: "EQUALS", # accepts EQUALS, NOT_EQUALS
+    #         values: ["String"],
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.query_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/StartQuery AWS API Documentation
+    #
+    # @overload start_query(params = {})
+    # @param [Hash] params ({})
+    def start_query(params = {}, options = {})
+      req = build_request(:start_query, params)
+      req.send_request(options)
+    end
+
+    # Stop a query that is progress for a specific monitor.
+    #
+    # @option params [required, String] :monitor_name
+    #   The name of the monitor.
+    #
+    # @option params [required, String] :query_id
+    #   The ID of the query that you want to stop. A `QueryId` is an
+    #   internally-generated identifier for a specific query.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.stop_query({
+    #     monitor_name: "ResourceName", # required
+    #     query_id: "String", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/StopQuery AWS API Documentation
+    #
+    # @overload stop_query(params = {})
+    # @param [Hash] params ({})
+    def stop_query(params = {}, options = {})
+      req = build_request(:stop_query, params)
+      req.send_request(options)
+    end
+
     # 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.
@@ -1125,7 +1352,7 @@ module Aws::InternetMonitor
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-internetmonitor'
-      context[:gem_version] = '1.10.0'
+      context[:gem_version] = '1.11.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-internetmonitor/client_api.rb

@@ -23,10 +23,17 @@ module Aws::InternetMonitor
     DeleteMonitorInput = Shapes::StructureShape.new(name: 'DeleteMonitorInput')
     DeleteMonitorOutput = Shapes::StructureShape.new(name: 'DeleteMonitorOutput')
     Double = Shapes::FloatShape.new(name: 'Double')
+    FilterList = Shapes::ListShape.new(name: 'FilterList')
+    FilterParameter = Shapes::StructureShape.new(name: 'FilterParameter')
+    FilterParameters = Shapes::ListShape.new(name: 'FilterParameters')
     GetHealthEventInput = Shapes::StructureShape.new(name: 'GetHealthEventInput')
     GetHealthEventOutput = Shapes::StructureShape.new(name: 'GetHealthEventOutput')
     GetMonitorInput = Shapes::StructureShape.new(name: 'GetMonitorInput')
     GetMonitorOutput = Shapes::StructureShape.new(name: 'GetMonitorOutput')
+    GetQueryResultsInput = Shapes::StructureShape.new(name: 'GetQueryResultsInput')
+    GetQueryResultsOutput = Shapes::StructureShape.new(name: 'GetQueryResultsOutput')
+    GetQueryStatusInput = Shapes::StructureShape.new(name: 'GetQueryStatusInput')
+    GetQueryStatusOutput = Shapes::StructureShape.new(name: 'GetQueryStatusOutput')
     HealthEvent = Shapes::StructureShape.new(name: 'HealthEvent')
     HealthEventImpactType = Shapes::StringShape.new(name: 'HealthEventImpactType')
     HealthEventList = Shapes::ListShape.new(name: 'HealthEventList')
@@ -61,14 +68,26 @@ module Aws::InternetMonitor
     NetworkImpairment = Shapes::StructureShape.new(name: 'NetworkImpairment')
     NetworkList = Shapes::ListShape.new(name: 'NetworkList')
     NotFoundException = Shapes::StructureShape.new(name: 'NotFoundException')
+    Operator = Shapes::StringShape.new(name: 'Operator')
     Percentage = Shapes::FloatShape.new(name: 'Percentage')
     PerformanceMeasurement = Shapes::StructureShape.new(name: 'PerformanceMeasurement')
+    QueryData = Shapes::ListShape.new(name: 'QueryData')
+    QueryField = Shapes::StructureShape.new(name: 'QueryField')
+    QueryFields = Shapes::ListShape.new(name: 'QueryFields')
+    QueryMaxResults = Shapes::IntegerShape.new(name: 'QueryMaxResults')
+    QueryRow = Shapes::ListShape.new(name: 'QueryRow')
+    QueryStatus = Shapes::StringShape.new(name: 'QueryStatus')
+    QueryType = Shapes::StringShape.new(name: 'QueryType')
     ResourceName = Shapes::StringShape.new(name: 'ResourceName')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     RoundTripTime = Shapes::StructureShape.new(name: 'RoundTripTime')
     S3Config = Shapes::StructureShape.new(name: 'S3Config')
     S3ConfigBucketNameString = Shapes::StringShape.new(name: 'S3ConfigBucketNameString')
     SetOfARNs = Shapes::ListShape.new(name: 'SetOfARNs')
+    StartQueryInput = Shapes::StructureShape.new(name: 'StartQueryInput')
+    StartQueryOutput = Shapes::StructureShape.new(name: 'StartQueryOutput')
+    StopQueryInput = Shapes::StructureShape.new(name: 'StopQueryInput')
+    StopQueryOutput = Shapes::StructureShape.new(name: 'StopQueryOutput')
     String = Shapes::StringShape.new(name: 'String')
     SyntheticTimestamp_date_time = Shapes::TimestampShape.new(name: 'SyntheticTimestamp_date_time', timestampFormat: "iso8601")
     TagKey = Shapes::StringShape.new(name: 'TagKey')
@@ -120,6 +139,15 @@ module Aws::InternetMonitor
 
     DeleteMonitorOutput.struct_class = Types::DeleteMonitorOutput
 
+    FilterList.member = Shapes::ShapeRef.new(shape: String)
+
+    FilterParameter.add_member(:field, Shapes::ShapeRef.new(shape: String, location_name: "Field"))
+    FilterParameter.add_member(:operator, Shapes::ShapeRef.new(shape: Operator, location_name: "Operator"))
+    FilterParameter.add_member(:values, Shapes::ShapeRef.new(shape: FilterList, location_name: "Values"))
+    FilterParameter.struct_class = Types::FilterParameter
+
+    FilterParameters.member = Shapes::ShapeRef.new(shape: FilterParameter)
+
     GetHealthEventInput.add_member(:monitor_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location: "uri", location_name: "MonitorName"))
     GetHealthEventInput.add_member(:event_id, Shapes::ShapeRef.new(shape: HealthEventName, required: true, location: "uri", location_name: "EventId"))
     GetHealthEventInput.struct_class = Types::GetHealthEventInput
@@ -155,6 +183,24 @@ module Aws::InternetMonitor
     GetMonitorOutput.add_member(:health_events_config, Shapes::ShapeRef.new(shape: HealthEventsConfig, location_name: "HealthEventsConfig"))
     GetMonitorOutput.struct_class = Types::GetMonitorOutput
 
+    GetQueryResultsInput.add_member(:monitor_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location: "uri", location_name: "MonitorName"))
+    GetQueryResultsInput.add_member(:query_id, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "QueryId"))
+    GetQueryResultsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location: "querystring", location_name: "NextToken"))
+    GetQueryResultsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: QueryMaxResults, location: "querystring", location_name: "MaxResults"))
+    GetQueryResultsInput.struct_class = Types::GetQueryResultsInput
+
+    GetQueryResultsOutput.add_member(:fields, Shapes::ShapeRef.new(shape: QueryFields, required: true, location_name: "Fields"))
+    GetQueryResultsOutput.add_member(:data, Shapes::ShapeRef.new(shape: QueryData, required: true, location_name: "Data"))
+    GetQueryResultsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
+    GetQueryResultsOutput.struct_class = Types::GetQueryResultsOutput
+
+    GetQueryStatusInput.add_member(:monitor_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location: "uri", location_name: "MonitorName"))
+    GetQueryStatusInput.add_member(:query_id, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "QueryId"))
+    GetQueryStatusInput.struct_class = Types::GetQueryStatusInput
+
+    GetQueryStatusOutput.add_member(:status, Shapes::ShapeRef.new(shape: QueryStatus, required: true, location_name: "Status"))
+    GetQueryStatusOutput.struct_class = Types::GetQueryStatusOutput
+
     HealthEvent.add_member(:event_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "EventArn"))
     HealthEvent.add_member(:event_id, Shapes::ShapeRef.new(shape: HealthEventName, required: true, location_name: "EventId"))
     HealthEvent.add_member(:started_at, Shapes::ShapeRef.new(shape: SyntheticTimestamp_date_time, required: true, location_name: "StartedAt"))
@@ -270,6 +316,16 @@ module Aws::InternetMonitor
     PerformanceMeasurement.add_member(:round_trip_time, Shapes::ShapeRef.new(shape: RoundTripTime, location_name: "RoundTripTime"))
     PerformanceMeasurement.struct_class = Types::PerformanceMeasurement
 
+    QueryData.member = Shapes::ShapeRef.new(shape: QueryRow)
+
+    QueryField.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
+    QueryField.add_member(:type, Shapes::ShapeRef.new(shape: String, location_name: "Type"))
+    QueryField.struct_class = Types::QueryField
+
+    QueryFields.member = Shapes::ShapeRef.new(shape: QueryField)
+
+    QueryRow.member = Shapes::ShapeRef.new(shape: String)
+
     ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "message"))
     ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
 
@@ -285,6 +341,22 @@ module Aws::InternetMonitor
 
     SetOfARNs.member = Shapes::ShapeRef.new(shape: Arn)
 
+    StartQueryInput.add_member(:monitor_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location: "uri", location_name: "MonitorName"))
+    StartQueryInput.add_member(:start_time, Shapes::ShapeRef.new(shape: SyntheticTimestamp_date_time, required: true, location_name: "StartTime"))
+    StartQueryInput.add_member(:end_time, Shapes::ShapeRef.new(shape: SyntheticTimestamp_date_time, required: true, location_name: "EndTime"))
+    StartQueryInput.add_member(:query_type, Shapes::ShapeRef.new(shape: QueryType, required: true, location_name: "QueryType"))
+    StartQueryInput.add_member(:filter_parameters, Shapes::ShapeRef.new(shape: FilterParameters, location_name: "FilterParameters"))
+    StartQueryInput.struct_class = Types::StartQueryInput
+
+    StartQueryOutput.add_member(:query_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "QueryId"))
+    StartQueryOutput.struct_class = Types::StartQueryOutput
+
+    StopQueryInput.add_member(:monitor_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location: "uri", location_name: "MonitorName"))
+    StopQueryInput.add_member(:query_id, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "QueryId"))
+    StopQueryInput.struct_class = Types::StopQueryInput
+
+    StopQueryOutput.struct_class = Types::StopQueryOutput
+
     TagKeys.member = Shapes::ShapeRef.new(shape: TagKey)
 
     TagMap.key = Shapes::ShapeRef.new(shape: TagKey)
@@ -394,6 +466,38 @@ module Aws::InternetMonitor
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
       end)
 
+      api.add_operation(:get_query_results, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetQueryResults"
+        o.http_method = "GET"
+        o.http_request_uri = "/v20210603/Monitors/{MonitorName}/Queries/{QueryId}/Results"
+        o.input = Shapes::ShapeRef.new(shape: GetQueryResultsInput)
+        o.output = Shapes::ShapeRef.new(shape: GetQueryResultsOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
+      api.add_operation(:get_query_status, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetQueryStatus"
+        o.http_method = "GET"
+        o.http_request_uri = "/v20210603/Monitors/{MonitorName}/Queries/{QueryId}/Status"
+        o.input = Shapes::ShapeRef.new(shape: GetQueryStatusInput)
+        o.output = Shapes::ShapeRef.new(shape: GetQueryStatusOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+      end)
+
       api.add_operation(:list_health_events, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListHealthEvents"
         o.http_method = "GET"
@@ -443,6 +547,32 @@ module Aws::InternetMonitor
         o.errors << Shapes::ShapeRef.new(shape: InternalServerErrorException)
       end)
 
+      api.add_operation(:start_query, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "StartQuery"
+        o.http_method = "POST"
+        o.http_request_uri = "/v20210603/Monitors/{MonitorName}/Queries"
+        o.input = Shapes::ShapeRef.new(shape: StartQueryInput)
+        o.output = Shapes::ShapeRef.new(shape: StartQueryOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+      end)
+
+      api.add_operation(:stop_query, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "StopQuery"
+        o.http_method = "DELETE"
+        o.http_request_uri = "/v20210603/Monitors/{MonitorName}/Queries/{QueryId}"
+        o.input = Shapes::ShapeRef.new(shape: StopQueryInput)
+        o.output = Shapes::ShapeRef.new(shape: StopQueryOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+      end)
+
       api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|
         o.name = "TagResource"
         o.http_method = "POST"

data/lib/aws-sdk-internetmonitor/endpoint_provider.rb

@@ -32,7 +32,7 @@ module Aws::InternetMonitor
             raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
           end
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+            if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
               return Aws::Endpoints::Endpoint.new(url: "https://internetmonitor-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"

data/lib/aws-sdk-internetmonitor/endpoints.rb

@@ -68,6 +68,34 @@ module Aws::InternetMonitor
       end
     end
 
+    class GetQueryResults
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::InternetMonitor::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
+    class GetQueryStatus
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::InternetMonitor::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class ListHealthEvents
       def self.build(context)
         unless context.config.regional_endpoint
@@ -110,6 +138,34 @@ module Aws::InternetMonitor
       end
     end
 
+    class StartQuery
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::InternetMonitor::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
+    class StopQuery
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::InternetMonitor::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class TagResource
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-internetmonitor/plugins/endpoints.rb

@@ -64,12 +64,20 @@ module Aws::InternetMonitor
             Aws::InternetMonitor::Endpoints::GetHealthEvent.build(context)
           when :get_monitor
             Aws::InternetMonitor::Endpoints::GetMonitor.build(context)
+          when :get_query_results
+            Aws::InternetMonitor::Endpoints::GetQueryResults.build(context)
+          when :get_query_status
+            Aws::InternetMonitor::Endpoints::GetQueryStatus.build(context)
           when :list_health_events
             Aws::InternetMonitor::Endpoints::ListHealthEvents.build(context)
           when :list_monitors
             Aws::InternetMonitor::Endpoints::ListMonitors.build(context)
           when :list_tags_for_resource
             Aws::InternetMonitor::Endpoints::ListTagsForResource.build(context)
+          when :start_query
+            Aws::InternetMonitor::Endpoints::StartQuery.build(context)
+          when :stop_query
+            Aws::InternetMonitor::Endpoints::StopQuery.build(context)
           when :tag_resource
             Aws::InternetMonitor::Endpoints::TagResource.build(context)
           when :untag_resource

data/lib/aws-sdk-internetmonitor/types.rb

@@ -275,12 +275,64 @@ module Aws::InternetMonitor
     #
     class DeleteMonitorOutput < Aws::EmptyStructure; end
 
+    # A filter that you use with the results of a Amazon CloudWatch Internet
+    # Monitor query that you created and ran. The query sets up a repository
+    # of data that is a subset of your application's Internet Monitor data.
+    # `FilterParameter` is a string that defines how you want to filter the
+    # repository of data to return a set of results, based on your criteria.
+    #
+    # The filter parameters that you can specify depend on the query type
+    # that you used to create the repository, since each query type returns
+    # a different set of Internet Monitor data.
+    #
+    # For each filter, you specify a field (such as `city`), an operator
+    # (such as `not_equals`, and a value or array of values (such as
+    # `["Seattle", "Redmond"]`). Separate values in the array with commas.
+    #
+    # For more information about specifying filter parameters, see [Using
+    # the Amazon CloudWatch Internet Monitor query interface][1] in the
+    # Amazon CloudWatch Internet Monitor User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-view-cw-tools-cwim-query.html
+    #
+    # @!attribute [rw] field
+    #   A data field that you want to filter, to further scope your
+    #   application's Internet Monitor data in a repository that you
+    #   created by running a query. A field might be `city`, for example.
+    #   The field must be one of the fields that was returned by the
+    #   specific query that you used to create the repository.
+    #   @return [String]
+    #
+    # @!attribute [rw] operator
+    #   The operator to use with the filter field and a value, such as
+    #   `not_equals`.
+    #   @return [String]
+    #
+    # @!attribute [rw] values
+    #   One or more values to be used, together with the specified operator,
+    #   to filter data for a query. For example, you could specify an array
+    #   of values such as `["Seattle", "Redmond"]`. Values in the array are
+    #   separated by commas.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/FilterParameter AWS API Documentation
+    #
+    class FilterParameter < Struct.new(
+      :field,
+      :operator,
+      :values)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] monitor_name
     #   The name of the monitor.
     #   @return [String]
     #
     # @!attribute [rw] event_id
-    #   The internally generated identifier of a health event. Because
+    #   The internally-generated identifier of a health event. Because
     #   `EventID` contains the forward slash (“/”) character, you must
     #   URL-encode the `EventID` field in the request URL.
     #   @return [String]
@@ -299,7 +351,7 @@ module Aws::InternetMonitor
     #   @return [String]
     #
     # @!attribute [rw] event_id
-    #   The internally generated identifier of a health event.
+    #   The internally-generated identifier of a health event.
     #   @return [String]
     #
     # @!attribute [rw] started_at
@@ -486,6 +538,94 @@ module Aws::InternetMonitor
       include Aws::Structure
     end
 
+    # @!attribute [rw] monitor_name
+    #   The name of the monitor to return data for.
+    #   @return [String]
+    #
+    # @!attribute [rw] query_id
+    #   The ID of the query that you want to return data results for. A
+    #   `QueryId` is an internally-generated identifier for a specific
+    #   query.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   The token for the next set of results. You receive this token from a
+    #   previous call.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The number of query results that you want to return with this call.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetQueryResultsInput AWS API Documentation
+    #
+    class GetQueryResultsInput < Struct.new(
+      :monitor_name,
+      :query_id,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] fields
+    #   The fields that the query returns data for. Fields are name-data
+    #   type pairs, such as `availability_score`-`float`.
+    #   @return [Array<Types::QueryField>]
+    #
+    # @!attribute [rw] data
+    #   The data results that the query returns. Data is returned in arrays,
+    #   aligned with the `Fields` for the query, which creates a repository
+    #   of Amazon CloudWatch Internet Monitor information for your
+    #   application. Then, you can filter the information in the repository
+    #   by using `FilterParameters` that you define.
+    #   @return [Array<Array<String>>]
+    #
+    # @!attribute [rw] next_token
+    #   The token for the next set of results. You receive this token from a
+    #   previous call.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetQueryResultsOutput AWS API Documentation
+    #
+    class GetQueryResultsOutput < Struct.new(
+      :fields,
+      :data,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] monitor_name
+    #   The name of the monitor.
+    #   @return [String]
+    #
+    # @!attribute [rw] query_id
+    #   The ID of the query that you want to return the status for. A
+    #   `QueryId` is an internally-generated dentifier for a specific query.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetQueryStatusInput AWS API Documentation
+    #
+    class GetQueryStatusInput < Struct.new(
+      :monitor_name,
+      :query_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] status
+    #   The current status for a query.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetQueryStatusOutput AWS API Documentation
+    #
+    class GetQueryStatusOutput < Struct.new(
+      :status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Information about a health event created in a monitor in Amazon
     # CloudWatch Internet Monitor.
     #
@@ -494,7 +634,7 @@ module Aws::InternetMonitor
     #   @return [String]
     #
     # @!attribute [rw] event_id
-    #   The internally generated identifier of a specific network traffic
+    #   The internally-generated identifier of a specific network traffic
     #   impairment health event.
     #   @return [String]
     #
@@ -977,6 +1117,9 @@ module Aws::InternetMonitor
     # Monitor creates an event when a threshold is crossed for a local
     # health score.
     #
+    # If you don't set a local health event threshold, the default value is
+    # 60%.
+    #
     # For more information, see [ Change health event thresholds][1] in the
     # Internet Monitor section of the *CloudWatch User Guide*.
     #
@@ -998,6 +1141,9 @@ module Aws::InternetMonitor
     #   The minimum percentage of overall traffic for an application that
     #   must be impacted by an issue before Internet Monitor creates an
     #   event when a threshold is crossed for a local health score.
+    #
+    #   If you don't set a minimum traffic impact threshold, the default
+    #   value is 0.01%.
     #   @return [Float]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/LocalHealthEventsConfig AWS API Documentation
@@ -1205,6 +1351,31 @@ module Aws::InternetMonitor
       include Aws::Structure
     end
 
+    # Defines a field to query for your application's Amazon CloudWatch
+    # Internet Monitor data. You create a data repository by running a query
+    # of a specific type. Each `QueryType` includes a specific set of fields
+    # and datatypes to retrieve data for.
+    #
+    # @!attribute [rw] name
+    #   The name of a field to query your application's Amazon CloudWatch
+    #   Internet Monitor data for, such as `availability_score`.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   The data type for a query field, which must correspond to the field
+    #   you're defining for `QueryField`. For example, if the query field
+    #   name is `availability_score`, the data type is `float`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/QueryField AWS API Documentation
+    #
+    class QueryField < Struct.new(
+      :name,
+      :type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The request specifies a resource that doesn't exist.
     #
     # @!attribute [rw] message
@@ -1274,6 +1445,102 @@ module Aws::InternetMonitor
       include Aws::Structure
     end
 
+    # @!attribute [rw] monitor_name
+    #   The name of the monitor to query.
+    #   @return [String]
+    #
+    # @!attribute [rw] start_time
+    #   The timestamp that is the beginning of the period that you want to
+    #   retrieve data for with your query.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_time
+    #   The timestamp that is the end of the period that you want to
+    #   retrieve data for with your query.
+    #   @return [Time]
+    #
+    # @!attribute [rw] query_type
+    #   The type of query to run. The following are the three types of
+    #   queries that you can run using the Internet Monitor query interface:
+    #
+    #   * `MEASUREMENTS`: TBD definition
+    #
+    #   * `TOP_LOCATIONS`: TBD definition
+    #
+    #   * `TOP_LOCATION_DETAILS`: TBD definition
+    #
+    #   For lists of the fields returned with each query type and more
+    #   information about how each type of query is performed, see [ Using
+    #   the Amazon CloudWatch Internet Monitor query interface][1] in the
+    #   Amazon CloudWatch Internet Monitor User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-view-cw-tools-cwim-query.html
+    #   @return [String]
+    #
+    # @!attribute [rw] filter_parameters
+    #   The `FilterParameters` field that you use with Amazon CloudWatch
+    #   Internet Monitor queries is a string the defines how you want a
+    #   query to be filtered. The filter parameters that you can specify
+    #   depend on the query type, since each query type returns a different
+    #   set of Internet Monitor data.
+    #
+    #   For more information about specifying filter parameters, see [Using
+    #   the Amazon CloudWatch Internet Monitor query interface][1] in the
+    #   Amazon CloudWatch Internet Monitor User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-view-cw-tools-cwim-query.html
+    #   @return [Array<Types::FilterParameter>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/StartQueryInput AWS API Documentation
+    #
+    class StartQueryInput < Struct.new(
+      :monitor_name,
+      :start_time,
+      :end_time,
+      :query_type,
+      :filter_parameters)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] query_id
+    #   The internally-generated identifier of a specific query.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/StartQueryOutput AWS API Documentation
+    #
+    class StartQueryOutput < Struct.new(
+      :query_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] monitor_name
+    #   The name of the monitor.
+    #   @return [String]
+    #
+    # @!attribute [rw] query_id
+    #   The ID of the query that you want to stop. A `QueryId` is an
+    #   internally-generated identifier for a specific query.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/StopQueryInput AWS API Documentation
+    #
+    class StopQueryInput < Struct.new(
+      :monitor_name,
+      :query_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/StopQueryOutput AWS API Documentation
+    #
+    class StopQueryOutput < Aws::EmptyStructure; end
+
     # @!attribute [rw] resource_arn
     #   The Amazon Resource Name (ARN) for a tag that you add to a resource.
     #   Tags are supported only for monitors in Amazon CloudWatch Internet

data/lib/aws-sdk-internetmonitor.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-internetmonitor/customizations'
 # @!group service
 module Aws::InternetMonitor
 
-  GEM_VERSION = '1.10.0'
+  GEM_VERSION = '1.11.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-internetmonitor
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.11.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-27 00:00:00.000000000 Z
+date: 2023-11-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core