aws-sdk-cloudwatch 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9e80bd151aaa83bbf7f5672165f2c5ff474f935c
-  data.tar.gz: e3c4961ff6cb356a55818a885986e3c078aa42ec
+  metadata.gz: 388deaaf8d21a67a8086a7286c70a8a558c6a8a1
+  data.tar.gz: 0bb705c87d45bfb2034e90f65cad8b6e8e3df6ea
 SHA512:
-  metadata.gz: '0846295c0e8add1a89a19e8059ed6ff428051f4c0df723929fb950d526a55e95d93c4868f904197ad638236202b64cc399cabe8a5572f2af109daddfb7f26d4e'
-  data.tar.gz: 8fb4423604ed589a9d2da38cbabf5e805fa4d843443c4f08a8b724bdaa42ad13fe5c4d843c60e9f2074a175f39d89396e8bd0d5cdd6b54171e57e3a92da9620c
+  metadata.gz: a652578241dc0540d5c4c3f621efaa4708c0a8448f6a92195b3a93c08e9feba7b2a0728252ac9abc203e98b1f99c7ba91fb29a10bdb6b660658b0fa51e195dc9
+  data.tar.gz: b5740d08e5e33ae7516ff51bc6ebbd465b0cd19d8584e48560c5a59b7c81082e7ccc41dc08ba553ad8a7f4f72ca014a28f59f5fd0ae367ee9829d8ee865bbdb8

data/lib/aws-sdk-cloudwatch.rb

@@ -45,6 +45,6 @@ require_relative 'aws-sdk-cloudwatch/customizations'
 # @service
 module Aws::CloudWatch
 
-  GEM_VERSION = '1.9.0'
+  GEM_VERSION = '1.10.0'
 
 end

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

@@ -898,6 +898,95 @@ module Aws::CloudWatch
       req.send_request(options)
     end
 
+    # You can use the `GetMetricWidgetImage` API to retrieve a snapshot
+    # graph of one or more Amazon CloudWatch metrics as a bitmap image. You
+    # can then embed this image into your services and products, such as
+    # wiki pages, reports, and documents. You could also retrieve images
+    # regularly, such as every minute, and create your own custom live
+    # dashboard.
+    #
+    # The graph you retrieve can include all CloudWatch metric graph
+    # features, including metric math and horizontal and vertical
+    # annotations.
+    #
+    # There is a limit of 20 transactions per second for this API. Each
+    # `GetMetricWidgetImage` action has the following limits:
+    #
+    # * As many as 100 metrics in the graph.
+    #
+    # * Up to 100 KB uncompressed payload.
+    #
+    # @option params [required, String] :metric_widget
+    #   A JSON string that defines the bitmap graph to be retrieved. The
+    #   string includes the metrics to include in the graph, statistics,
+    #   annotations, title, axis limits, and so on. You can include only one
+    #   `MetricWidget` parameter in each `GetMetricWidgetImage` call.
+    #
+    #   For more information about the syntax of `MetricWidget` see
+    #   CloudWatch-Metric-Widget-Structure.
+    #
+    #   If any metric on the graph could not load all the requested data
+    #   points, an orange triangle with an exclamation point appears next to
+    #   the graph legend.
+    #
+    # @option params [String] :output_format
+    #   The format of the resulting image. Only PNG images are supported.
+    #
+    #   The default is `png`. If you specify `png`, the API returns an HTTP
+    #   response with the content-type set to `text/xml`. The image data is in
+    #   a `MetricWidgetImage` field. For example:
+    #
+    #   ` <GetMetricWidgetImageResponse
+    #   xmlns="http://monitoring.amazonaws.com/doc/2010-08-01/">`
+    #
+    #   ` <GetMetricWidgetImageResult>`
+    #
+    #   ` <MetricWidgetImage>`
+    #
+    #   ` iVBORw0KGgoAAAANSUhEUgAAAlgAAAGQEAYAAAAip...`
+    #
+    #   ` </MetricWidgetImage>`
+    #
+    #   ` </GetMetricWidgetImageResult>`
+    #
+    #   ` <ResponseMetadata>`
+    #
+    #   ` <RequestId>6f0d4192-4d42-11e8-82c1-f539a07e0e3b</RequestId>`
+    #
+    #   ` </ResponseMetadata>`
+    #
+    #   `</GetMetricWidgetImageResponse>`
+    #
+    #   The `image/png` setting is intended only for custom HTTP requests. For
+    #   most use cases, and all actions using an AWS SDK, you should use
+    #   `png`. If you specify `image/png`, the HTTP response has a
+    #   content-type set to `image/png`, and the body of the response is a PNG
+    #   image.
+    #
+    # @return [Types::GetMetricWidgetImageOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetMetricWidgetImageOutput#metric_widget_image #metric_widget_image} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_metric_widget_image({
+    #     metric_widget: "MetricWidget", # required
+    #     output_format: "OutputFormat",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.metric_widget_image #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricWidgetImage AWS API Documentation
+    #
+    # @overload get_metric_widget_image(params = {})
+    # @param [Hash] params ({})
+    def get_metric_widget_image(params = {}, options = {})
+      req = build_request(:get_metric_widget_image, params)
+      req.send_request(options)
+    end
+
     # Returns a list of the dashboards for your account. If you include
     # `DashboardNamePrefix`, only those dashboards with names starting with
     # the prefix are listed. Otherwise, all dashboards in your account are
@@ -1502,7 +1591,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.9.0'
+      context[:gem_version] = '1.10.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -72,6 +72,8 @@ module Aws::CloudWatch
     GetMetricDataOutput = Shapes::StructureShape.new(name: 'GetMetricDataOutput')
     GetMetricStatisticsInput = Shapes::StructureShape.new(name: 'GetMetricStatisticsInput')
     GetMetricStatisticsOutput = Shapes::StructureShape.new(name: 'GetMetricStatisticsOutput')
+    GetMetricWidgetImageInput = Shapes::StructureShape.new(name: 'GetMetricWidgetImageInput')
+    GetMetricWidgetImageOutput = Shapes::StructureShape.new(name: 'GetMetricWidgetImageOutput')
     HistoryData = Shapes::StringShape.new(name: 'HistoryData')
     HistoryItemType = Shapes::StringShape.new(name: 'HistoryItemType')
     HistorySummary = Shapes::StringShape.new(name: 'HistorySummary')
@@ -106,10 +108,13 @@ module Aws::CloudWatch
     MetricLabel = Shapes::StringShape.new(name: 'MetricLabel')
     MetricName = Shapes::StringShape.new(name: 'MetricName')
     MetricStat = Shapes::StructureShape.new(name: 'MetricStat')
+    MetricWidget = Shapes::StringShape.new(name: 'MetricWidget')
+    MetricWidgetImage = Shapes::BlobShape.new(name: 'MetricWidgetImage')
     Metrics = Shapes::ListShape.new(name: 'Metrics')
     MissingRequiredParameterException = Shapes::StructureShape.new(name: 'MissingRequiredParameterException')
     Namespace = Shapes::StringShape.new(name: 'Namespace')
     NextToken = Shapes::StringShape.new(name: 'NextToken')
+    OutputFormat = Shapes::StringShape.new(name: 'OutputFormat')
     Period = Shapes::IntegerShape.new(name: 'Period')
     PutDashboardInput = Shapes::StructureShape.new(name: 'PutDashboardInput')
     PutDashboardOutput = Shapes::StructureShape.new(name: 'PutDashboardOutput')
@@ -283,6 +288,13 @@ module Aws::CloudWatch
     GetMetricStatisticsOutput.add_member(:datapoints, Shapes::ShapeRef.new(shape: Datapoints, location_name: "Datapoints"))
     GetMetricStatisticsOutput.struct_class = Types::GetMetricStatisticsOutput
 
+    GetMetricWidgetImageInput.add_member(:metric_widget, Shapes::ShapeRef.new(shape: MetricWidget, required: true, location_name: "MetricWidget"))
+    GetMetricWidgetImageInput.add_member(:output_format, Shapes::ShapeRef.new(shape: OutputFormat, location_name: "OutputFormat"))
+    GetMetricWidgetImageInput.struct_class = Types::GetMetricWidgetImageInput
+
+    GetMetricWidgetImageOutput.add_member(:metric_widget_image, Shapes::ShapeRef.new(shape: MetricWidgetImage, location_name: "MetricWidgetImage"))
+    GetMetricWidgetImageOutput.struct_class = Types::GetMetricWidgetImageOutput
+
     ListDashboardsInput.add_member(:dashboard_name_prefix, Shapes::ShapeRef.new(shape: DashboardNamePrefix, location_name: "DashboardNamePrefix"))
     ListDashboardsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     ListDashboardsInput.struct_class = Types::ListDashboardsInput
@@ -557,6 +569,14 @@ module Aws::CloudWatch
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceFault)
       end)
 
+      api.add_operation(:get_metric_widget_image, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetMetricWidgetImage"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetMetricWidgetImageInput)
+        o.output = Shapes::ShapeRef.new(shape: GetMetricWidgetImageOutput)
+      end)
+
       api.add_operation(:list_dashboards, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListDashboards"
         o.http_method = "POST"

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

@@ -788,6 +788,82 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetMetricWidgetImageInput
+    #   data as a hash:
+    #
+    #       {
+    #         metric_widget: "MetricWidget", # required
+    #         output_format: "OutputFormat",
+    #       }
+    #
+    # @!attribute [rw] metric_widget
+    #   A JSON string that defines the bitmap graph to be retrieved. The
+    #   string includes the metrics to include in the graph, statistics,
+    #   annotations, title, axis limits, and so on. You can include only one
+    #   `MetricWidget` parameter in each `GetMetricWidgetImage` call.
+    #
+    #   For more information about the syntax of `MetricWidget` see
+    #   CloudWatch-Metric-Widget-Structure.
+    #
+    #   If any metric on the graph could not load all the requested data
+    #   points, an orange triangle with an exclamation point appears next to
+    #   the graph legend.
+    #   @return [String]
+    #
+    # @!attribute [rw] output_format
+    #   The format of the resulting image. Only PNG images are supported.
+    #
+    #   The default is `png`. If you specify `png`, the API returns an HTTP
+    #   response with the content-type set to `text/xml`. The image data is
+    #   in a `MetricWidgetImage` field. For example:
+    #
+    #   ` <GetMetricWidgetImageResponse
+    #   xmlns="http://monitoring.amazonaws.com/doc/2010-08-01/">`
+    #
+    #   ` <GetMetricWidgetImageResult>`
+    #
+    #   ` <MetricWidgetImage>`
+    #
+    #   ` iVBORw0KGgoAAAANSUhEUgAAAlgAAAGQEAYAAAAip...`
+    #
+    #   ` </MetricWidgetImage>`
+    #
+    #   ` </GetMetricWidgetImageResult>`
+    #
+    #   ` <ResponseMetadata>`
+    #
+    #   ` <RequestId>6f0d4192-4d42-11e8-82c1-f539a07e0e3b</RequestId>`
+    #
+    #   ` </ResponseMetadata>`
+    #
+    #   `</GetMetricWidgetImageResponse>`
+    #
+    #   The `image/png` setting is intended only for custom HTTP requests.
+    #   For most use cases, and all actions using an AWS SDK, you should use
+    #   `png`. If you specify `image/png`, the HTTP response has a
+    #   content-type set to `image/png`, and the body of the response is a
+    #   PNG image.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricWidgetImageInput AWS API Documentation
+    #
+    class GetMetricWidgetImageInput < Struct.new(
+      :metric_widget,
+      :output_format)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] metric_widget_image
+    #   The image of the graph, in the output format specified.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricWidgetImageOutput AWS API Documentation
+    #
+    class GetMetricWidgetImageOutput < Struct.new(
+      :metric_widget_image)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListDashboardsInput
     #   data as a hash:
     #

metadata

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