aws-sdk-lightsail 1.27.0 → 1.32.0

data/lib/aws-sdk-lightsail/errors.rb

@@ -6,6 +6,35 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::Lightsail
+
+  # When Lightsail returns an error response, the Ruby SDK constructs and raises an error.
+  # These errors all extend Aws::Lightsail::Errors::ServiceError < {Aws::Errors::ServiceError}
+  #
+  # You can rescue all Lightsail errors using ServiceError:
+  #
+  #     begin
+  #       # do stuff
+  #     rescue Aws::Lightsail::Errors::ServiceError
+  #       # rescues all Lightsail API errors
+  #     end
+  #
+  #
+  # ## Request Context
+  # ServiceError objects have a {Aws::Errors::ServiceError#context #context} method that returns
+  # information about the request that generated the error.
+  # See {Seahorse::Client::RequestContext} for more information.
+  #
+  # ## Error Classes
+  # * {AccessDeniedException}
+  # * {AccountSetupInProgressException}
+  # * {InvalidInputException}
+  # * {NotFoundException}
+  # * {OperationFailureException}
+  # * {ServiceException}
+  # * {UnauthenticatedException}
+  #
+  # Additionally, error classes are dynamically generated for service errors based on the error code
+  # if they are not defined above.
   module Errors
 
     extend Aws::Errors::DynamicErrors
@@ -38,7 +67,6 @@ module Aws::Lightsail
       def tip
         @data[:tip]
       end
-
     end
 
     class AccountSetupInProgressException < ServiceError
@@ -69,7 +97,6 @@ module Aws::Lightsail
       def tip
         @data[:tip]
       end
-
     end
 
     class InvalidInputException < ServiceError
@@ -100,7 +127,6 @@ module Aws::Lightsail
       def tip
         @data[:tip]
       end
-
     end
 
     class NotFoundException < ServiceError
@@ -131,7 +157,6 @@ module Aws::Lightsail
       def tip
         @data[:tip]
       end
-
     end
 
     class OperationFailureException < ServiceError
@@ -162,7 +187,6 @@ module Aws::Lightsail
       def tip
         @data[:tip]
       end
-
     end
 
     class ServiceException < ServiceError
@@ -193,7 +217,6 @@ module Aws::Lightsail
       def tip
         @data[:tip]
       end
-
     end
 
     class UnauthenticatedException < ServiceError
@@ -224,7 +247,6 @@ module Aws::Lightsail
       def tip
         @data[:tip]
       end
-
     end
 
   end

data/lib/aws-sdk-lightsail/resource.rb

@@ -6,6 +6,7 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::Lightsail
+
   class Resource
 
     # @param options ({})

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

@@ -137,6 +137,177 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
+    # Describes an alarm.
+    #
+    # An alarm is a way to monitor your Amazon Lightsail resource metrics.
+    # For more information, see [Alarms in Amazon Lightsail][1].
+    #
+    #
+    #
+    # [1]: https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-alarms
+    #
+    # @!attribute [rw] name
+    #   The name of the alarm.
+    #   @return [String]
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) of the alarm.
+    #   @return [String]
+    #
+    # @!attribute [rw] created_at
+    #   The timestamp when the alarm was created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] location
+    #   An object that lists information about the location of the alarm.
+    #   @return [Types::ResourceLocation]
+    #
+    # @!attribute [rw] resource_type
+    #   The Lightsail resource type (e.g., `Alarm`).
+    #   @return [String]
+    #
+    # @!attribute [rw] support_code
+    #   The support code. Include this code in your email to support when
+    #   you have questions about your Lightsail alarm. This code enables our
+    #   support team to look up your Lightsail information more easily.
+    #   @return [String]
+    #
+    # @!attribute [rw] monitored_resource_info
+    #   An object that lists information about the resource monitored by the
+    #   alarm.
+    #   @return [Types::MonitoredResourceInfo]
+    #
+    # @!attribute [rw] comparison_operator
+    #   The arithmetic operation used when comparing the specified statistic
+    #   and threshold.
+    #   @return [String]
+    #
+    # @!attribute [rw] evaluation_periods
+    #   The number of periods over which data is compared to the specified
+    #   threshold.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] period
+    #   The period, in seconds, over which the statistic is applied.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] threshold
+    #   The value against which the specified statistic is compared.
+    #   @return [Float]
+    #
+    # @!attribute [rw] datapoints_to_alarm
+    #   The number of data points that must not within the specified
+    #   threshold to trigger the alarm.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] treat_missing_data
+    #   Specifies how the alarm handles missing data points.
+    #
+    #   An alarm can treat missing data in the following ways:
+    #
+    #   * `breaching` - Assume the missing data is not within the threshold.
+    #     Missing data counts towards the number of times the metric is not
+    #     within the threshold.
+    #
+    #   * `notBreaching` - Assume the missing data is within the threshold.
+    #     Missing data does not count towards the number of times the metric
+    #     is not within the threshold.
+    #
+    #   * `ignore` - Ignore the missing data. Maintains the current alarm
+    #     state.
+    #
+    #   * `missing` - Missing data is treated as missing.
+    #   @return [String]
+    #
+    # @!attribute [rw] statistic
+    #   The statistic for the metric associated with the alarm.
+    #
+    #   The following statistics are available:
+    #
+    #   * `Minimum` - The lowest value observed during the specified period.
+    #     Use this value to determine low volumes of activity for your
+    #     application.
+    #
+    #   * `Maximum` - The highest value observed during the specified
+    #     period. Use this value to determine high volumes of activity for
+    #     your application.
+    #
+    #   * `Sum` - All values submitted for the matching metric added
+    #     together. You can use this statistic to determine the total volume
+    #     of a metric.
+    #
+    #   * `Average` - The value of Sum / SampleCount during the specified
+    #     period. By comparing this statistic with the Minimum and Maximum
+    #     values, you can determine the full scope of a metric and how close
+    #     the average use is to the Minimum and Maximum values. This
+    #     comparison helps you to know when to increase or decrease your
+    #     resources.
+    #
+    #   * `SampleCount` - The count, or number, of data points used for the
+    #     statistical calculation.
+    #   @return [String]
+    #
+    # @!attribute [rw] metric_name
+    #   The name of the metric associated with the alarm.
+    #   @return [String]
+    #
+    # @!attribute [rw] state
+    #   The current state of the alarm.
+    #
+    #   An alarm has the following possible states:
+    #
+    #   * `ALARM` - The metric is outside of the defined threshold.
+    #
+    #   * `INSUFFICIENT_DATA` - The alarm has just started, the metric is
+    #     not available, or not enough data is available for the metric to
+    #     determine the alarm state.
+    #
+    #   * `OK` - The metric is within the defined threshold.
+    #   @return [String]
+    #
+    # @!attribute [rw] unit
+    #   The unit of the metric associated with the alarm.
+    #   @return [String]
+    #
+    # @!attribute [rw] contact_protocols
+    #   The contact protocols for the alarm, such as `Email`, `SMS` (text
+    #   messaging), or both.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] notification_triggers
+    #   The alarm states that trigger a notification.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] notification_enabled
+    #   Indicates whether the alarm is enabled.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/Alarm AWS API Documentation
+    #
+    class Alarm < Struct.new(
+      :name,
+      :arn,
+      :created_at,
+      :location,
+      :resource_type,
+      :support_code,
+      :monitored_resource_info,
+      :comparison_operator,
+      :evaluation_periods,
+      :period,
+      :threshold,
+      :datapoints_to_alarm,
+      :treat_missing_data,
+      :statistic,
+      :metric_name,
+      :state,
+      :unit,
+      :contact_protocols,
+      :notification_triggers,
+      :notification_enabled)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass AllocateStaticIpRequest
     #   data as a hash:
     #
@@ -156,8 +327,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the static
-    #   IP address you allocated.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/AllocateStaticIpResult AWS API Documentation
@@ -199,7 +371,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/AttachDiskResult AWS API Documentation
@@ -242,7 +416,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object representing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/AttachInstancesToLoadBalancerResult AWS API Documentation
@@ -278,7 +454,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object representing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #
     #   These SSL/TLS certificates are only usable by Lightsail load
     #   balancers. You can't get the certificate and use it for another
@@ -317,8 +495,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about your API
-    #   operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/AttachStaticIpResult AWS API Documentation
@@ -539,7 +718,7 @@ module Aws::Lightsail
     # private server (or *instance*).
     #
     # @!attribute [rw] price
-    #   The price in US dollars (e.g., `5.0`).
+    #   The price in US dollars (e.g., `5.0`) of the bundle.
     #   @return [Float]
     #
     # @!attribute [rw] cpu_count
@@ -614,18 +793,19 @@ module Aws::Lightsail
     #         port_info: { # required
     #           from_port: 1,
     #           to_port: 1,
-    #           protocol: "tcp", # accepts tcp, all, udp
+    #           protocol: "tcp", # accepts tcp, all, udp, icmp
+    #           cidrs: ["string"],
+    #           cidr_list_aliases: ["string"],
     #         },
     #         instance_name: "ResourceName", # required
     #       }
     #
     # @!attribute [rw] port_info
-    #   Information about the public port you are trying to close.
+    #   An object to describe the ports to close for the specified instance.
     #   @return [Types::PortInfo]
     #
     # @!attribute [rw] instance_name
-    #   The name of the instance on which you're attempting to close the
-    #   public ports.
+    #   The name of the instance for which to close ports.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CloseInstancePublicPortsRequest AWS API Documentation
@@ -637,8 +817,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operation
-    #   An array of key-value pairs that contains information about the
-    #   operation.
+    #   An object that describes the result of the action, such as the
+    #   status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CloseInstancePublicPortsResult AWS API Documentation
@@ -730,6 +911,81 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
+    # Describes a contact method.
+    #
+    # A contact method is a way to send you notifications. For more
+    # information, see [Notifications in Amazon Lightsail][1].
+    #
+    #
+    #
+    # [1]: https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-notifications
+    #
+    # @!attribute [rw] contact_endpoint
+    #   The destination of the contact method, such as an email address or a
+    #   mobile phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The current status of the contact method.
+    #
+    #   A contact method has the following possible status:
+    #
+    #   * `PendingVerification` - The contact method has not yet been
+    #     verified, and the verification has not yet expired.
+    #
+    #   * `Valid` - The contact method has been verified.
+    #
+    #   * `InValid` - An attempt was made to verify the contact method, but
+    #     the verification has expired.
+    #   @return [String]
+    #
+    # @!attribute [rw] protocol
+    #   The protocol of the contact method, such as email or SMS (text
+    #   messaging).
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the contact method.
+    #   @return [String]
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) of the contact method.
+    #   @return [String]
+    #
+    # @!attribute [rw] created_at
+    #   The timestamp when the contact method was created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] location
+    #   Describes the resource location.
+    #   @return [Types::ResourceLocation]
+    #
+    # @!attribute [rw] resource_type
+    #   The Lightsail resource type (e.g., `ContactMethod`).
+    #   @return [String]
+    #
+    # @!attribute [rw] support_code
+    #   The support code. Include this code in your email to support when
+    #   you have questions about your Lightsail contact method. This code
+    #   enables our support team to look up your Lightsail information more
+    #   easily.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/ContactMethod AWS API Documentation
+    #
+    class ContactMethod < Struct.new(
+      :contact_endpoint,
+      :status,
+      :protocol,
+      :name,
+      :arn,
+      :created_at,
+      :location,
+      :resource_type,
+      :support_code)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass CopySnapshotRequest
     #   data as a hash:
     #
@@ -834,7 +1090,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   A list of objects describing the API operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CopySnapshotResult AWS API Documentation
@@ -874,7 +1132,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   A list of objects describing the API operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateCloudFormationStackResult AWS API Documentation
@@ -884,6 +1144,84 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass CreateContactMethodRequest
+    #   data as a hash:
+    #
+    #       {
+    #         protocol: "Email", # required, accepts Email, SMS
+    #         contact_endpoint: "StringMax256", # required
+    #       }
+    #
+    # @!attribute [rw] protocol
+    #   The protocol of the contact method, such as `Email` or `SMS` (text
+    #   messaging).
+    #
+    #   The `SMS` protocol is supported only in the following AWS Regions.
+    #
+    #   * US East (N. Virginia) (`us-east-1`)
+    #
+    #   * US West (Oregon) (`us-west-2`)
+    #
+    #   * Europe (Ireland) (`eu-west-1`)
+    #
+    #   * Asia Pacific (Tokyo) (`ap-northeast-1`)
+    #
+    #   * Asia Pacific (Singapore) (`ap-southeast-1`)
+    #
+    #   * Asia Pacific (Sydney) (`ap-southeast-2`)
+    #
+    #   For a list of countries/regions where SMS text messages can be sent,
+    #   and the latest AWS Regions where SMS text messaging is supported,
+    #   see [Supported Regions and Countries][1] in the *Amazon SNS
+    #   Developer Guide*.
+    #
+    #   For more information about notifications in Amazon Lightsail, see
+    #   [Notifications in Amazon Lightsail][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-supported-regions-countries.html
+    #   [2]: https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-notifications
+    #   @return [String]
+    #
+    # @!attribute [rw] contact_endpoint
+    #   The destination of the contact method, such as an email address or a
+    #   mobile phone number.
+    #
+    #   Use the E.164 format when specifying a mobile phone number. E.164 is
+    #   a standard for the phone number structure used for international
+    #   telecommunication. Phone numbers that follow this format can have a
+    #   maximum of 15 digits, and they are prefixed with the plus character
+    #   (+) and the country code. For example, a U.S. phone number in E.164
+    #   format would be specified as +1XXX5550100. For more information, see
+    #   [E.164][1] on *Wikipedia*.
+    #
+    #
+    #
+    #   [1]: https://en.wikipedia.org/wiki/E.164
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateContactMethodRequest AWS API Documentation
+    #
+    class CreateContactMethodRequest < Struct.new(
+      :protocol,
+      :contact_endpoint)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] operations
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
+    #   @return [Array<Types::Operation>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateContactMethodResult AWS API Documentation
+    #
+    class CreateContactMethodResult < Struct.new(
+      :operations)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass CreateDiskFromSnapshotRequest
     #   data as a hash:
     #
@@ -1031,7 +1369,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateDiskFromSnapshotResult AWS API Documentation
@@ -1106,7 +1446,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateDiskResult AWS API Documentation
@@ -1177,7 +1519,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateDiskSnapshotResult AWS API Documentation
@@ -1223,8 +1567,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operation
-    #   An array of key-value pairs containing information about the
-    #   operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateDomainEntryResult AWS API Documentation
@@ -1276,8 +1621,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operation
-    #   An array of key-value pairs containing information about the domain
-    #   resource you created.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateDomainResult AWS API Documentation
@@ -1327,8 +1673,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the results
-    #   of your create instances snapshot request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateInstanceSnapshotResult AWS API Documentation
@@ -1528,8 +1875,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the results
-    #   of your create instances from snapshot request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateInstancesFromSnapshotResult AWS API Documentation
@@ -1663,8 +2011,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the results
-    #   of your create instances request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateInstancesResult AWS API Documentation
@@ -1721,8 +2070,9 @@ module Aws::Lightsail
     #   @return [String]
     #
     # @!attribute [rw] operation
-    #   An array of key-value pairs containing information about the results
-    #   of your create key pair request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateKeyPairResult AWS API Documentation
@@ -1814,7 +2164,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object containing information about the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateLoadBalancerResult AWS API Documentation
@@ -1891,7 +2243,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object containing information about the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateLoadBalancerTlsCertificateResult AWS API Documentation
@@ -2020,8 +2374,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the result of your create relational database
-    #   from snapshot request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateRelationalDatabaseFromSnapshotResult AWS API Documentation
@@ -2212,8 +2567,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the result of your create relational database
-    #   request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateRelationalDatabaseResult AWS API Documentation
@@ -2269,8 +2625,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the result of your create relational database
-    #   snapshot request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateRelationalDatabaseSnapshotResult AWS API Documentation
@@ -2280,6 +2637,37 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DeleteAlarmRequest
+    #   data as a hash:
+    #
+    #       {
+    #         alarm_name: "ResourceName", # required
+    #       }
+    #
+    # @!attribute [rw] alarm_name
+    #   The name of the alarm to delete.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteAlarmRequest AWS API Documentation
+    #
+    class DeleteAlarmRequest < Struct.new(
+      :alarm_name)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] operations
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
+    #   @return [Array<Types::Operation>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteAlarmResult AWS API Documentation
+    #
+    class DeleteAlarmResult < Struct.new(
+      :operations)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DeleteAutoSnapshotRequest
     #   data as a hash:
     #
@@ -2308,7 +2696,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of objects that describe the result of your request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteAutoSnapshotResult AWS API Documentation
@@ -2318,6 +2708,44 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DeleteContactMethodRequest
+    #   data as a hash:
+    #
+    #       {
+    #         protocol: "Email", # required, accepts Email, SMS
+    #       }
+    #
+    # @!attribute [rw] protocol
+    #   The protocol that will be deleted, such as `Email` or `SMS` (text
+    #   messaging).
+    #
+    #   <note markdown="1"> To delete an `Email` and an `SMS` contact method if you added both,
+    #   you must run separate `DeleteContactMethod` actions to delete each
+    #   protocol.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteContactMethodRequest AWS API Documentation
+    #
+    class DeleteContactMethodRequest < Struct.new(
+      :protocol)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] operations
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
+    #   @return [Array<Types::Operation>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteContactMethodResult AWS API Documentation
+    #
+    class DeleteContactMethodResult < Struct.new(
+      :operations)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DeleteDiskRequest
     #   data as a hash:
     #
@@ -2344,7 +2772,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of objects that describe the result of your request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteDiskResult AWS API Documentation
@@ -2374,7 +2804,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteDiskSnapshotResult AWS API Documentation
@@ -2419,8 +2851,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operation
-    #   An array of key-value pairs containing information about the results
-    #   of your delete domain entry request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteDomainEntryResult AWS API Documentation
@@ -2449,8 +2882,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operation
-    #   An array of key-value pairs containing information about the results
-    #   of your delete domain request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteDomainResult AWS API Documentation
@@ -2486,8 +2920,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the results
-    #   of your delete instance request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteInstanceResult AWS API Documentation
@@ -2516,8 +2951,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the results
-    #   of your delete instance snapshot request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteInstanceSnapshotResult AWS API Documentation
@@ -2546,8 +2982,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operation
-    #   An array of key-value pairs containing information about the results
-    #   of your delete key pair request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteKeyPairResult AWS API Documentation
@@ -2577,7 +3014,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   A list of objects describing the API operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteKnownHostKeysResult AWS API Documentation
@@ -2606,7 +3045,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteLoadBalancerResult AWS API Documentation
@@ -2652,7 +3093,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteLoadBalancerTlsCertificateResult AWS API Documentation
@@ -2713,8 +3156,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the result of your delete relational database
-    #   request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteRelationalDatabaseResult AWS API Documentation
@@ -2743,8 +3187,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the result of your delete relational database
-    #   snapshot request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DeleteRelationalDatabaseSnapshotResult AWS API Documentation
@@ -2792,7 +3237,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DetachDiskResult AWS API Documentation
@@ -2828,7 +3275,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DetachInstancesFromLoadBalancerResult AWS API Documentation
@@ -2857,8 +3306,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the results
-    #   of your detach static IP request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DetachStaticIpResult AWS API Documentation
@@ -2893,7 +3343,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of objects that describe the result of your request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/DisableAddOnResult AWS API Documentation
@@ -3381,7 +3833,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of objects that describe the result of your request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/EnableAddOnResult AWS API Documentation
@@ -3513,7 +3967,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   A list of objects describing the API operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/ExportSnapshotResult AWS API Documentation
@@ -3531,7 +3987,11 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for paginating results from your get active names
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetActiveNames` request. If
+    #   your results are paginated, the response will return a next page
+    #   token that you can specify as the page token in a subsequent
     #   request.
     #   @return [String]
     #
@@ -3547,8 +4007,14 @@ module Aws::Lightsail
     #   @return [Array<String>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   active names request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetActiveNames`
+    #   request and specify the next page token using the `pageToken`
+    #   parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetActiveNamesResult AWS API Documentation
@@ -3559,31 +4025,92 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetAutoSnapshotsRequest
+    # @note When making an API call, you may pass GetAlarmsRequest
     #   data as a hash:
     #
     #       {
-    #         resource_name: "ResourceName", # required
+    #         alarm_name: "ResourceName",
+    #         page_token: "string",
+    #         monitored_resource_name: "ResourceName",
     #       }
     #
-    # @!attribute [rw] resource_name
-    #   The name of the source instance or disk from which to get automatic
-    #   snapshot information.
+    # @!attribute [rw] alarm_name
+    #   The name of the alarm.
+    #
+    #   Specify an alarm name to return information about a specific alarm.
     #   @return [String]
     #
-    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetAutoSnapshotsRequest AWS API Documentation
+    # @!attribute [rw] page_token
+    #   The token to advance to the next page of results from your request.
     #
-    class GetAutoSnapshotsRequest < Struct.new(
-      :resource_name)
-      include Aws::Structure
-    end
-
-    # @!attribute [rw] resource_name
-    #   The name of the source instance or disk for the automatic snapshots.
+    #   To get a page token, perform an initial `GetAlarms` request. If your
+    #   results are paginated, the response will return a next page token
+    #   that you can specify as the page token in a subsequent request.
     #   @return [String]
     #
-    # @!attribute [rw] resource_type
-    #   The resource type (e.g., `Instance` or `Disk`).
+    # @!attribute [rw] monitored_resource_name
+    #   The name of the Lightsail resource being monitored by the alarm.
+    #
+    #   Specify a monitored resource name to return information about all
+    #   alarms for a specific resource.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetAlarmsRequest AWS API Documentation
+    #
+    class GetAlarmsRequest < Struct.new(
+      :alarm_name,
+      :page_token,
+      :monitored_resource_name)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] alarms
+    #   An array of objects that describe the alarms.
+    #   @return [Array<Types::Alarm>]
+    #
+    # @!attribute [rw] next_page_token
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetAlarms` request
+    #   and specify the next page token using the `pageToken` parameter.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetAlarmsResult AWS API Documentation
+    #
+    class GetAlarmsResult < Struct.new(
+      :alarms,
+      :next_page_token)
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass GetAutoSnapshotsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         resource_name: "ResourceName", # required
+    #       }
+    #
+    # @!attribute [rw] resource_name
+    #   The name of the source instance or disk from which to get automatic
+    #   snapshot information.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetAutoSnapshotsRequest AWS API Documentation
+    #
+    class GetAutoSnapshotsRequest < Struct.new(
+      :resource_name)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] resource_name
+    #   The name of the source instance or disk for the automatic snapshots.
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_type
+    #   The resource type (e.g., `Instance` or `Disk`).
     #   @return [String]
     #
     # @!attribute [rw] auto_snapshots
@@ -3614,8 +4141,12 @@ module Aws::Lightsail
     #   @return [Boolean]
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to the next page of results from your get
-    #   blueprints request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetBlueprints` request. If
+    #   your results are paginated, the response will return a next page
+    #   token that you can specify as the page token in a subsequent
+    #   request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetBlueprintsRequest AWS API Documentation
@@ -3632,8 +4163,14 @@ module Aws::Lightsail
     #   @return [Array<Types::Blueprint>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   blueprints request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetBlueprints`
+    #   request and specify the next page token using the `pageToken`
+    #   parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetBlueprintsResult AWS API Documentation
@@ -3658,8 +4195,12 @@ module Aws::Lightsail
     #   @return [Boolean]
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to the next page of results from your get
-    #   bundles request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetBundles` request. If
+    #   your results are paginated, the response will return a next page
+    #   token that you can specify as the page token in a subsequent
+    #   request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetBundlesRequest AWS API Documentation
@@ -3676,8 +4217,14 @@ module Aws::Lightsail
     #   @return [Array<Types::Bundle>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   active names request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetBundles`
+    #   request and specify the next page token using the `pageToken`
+    #   parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetBundlesResult AWS API Documentation
@@ -3696,8 +4243,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to a specific page of results for your
-    #   `get cloud formation stack records` request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial
+    #   `GetClouFormationStackRecords` request. If your results are
+    #   paginated, the response will return a next page token that you can
+    #   specify as the page token in a subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetCloudFormationStackRecordsRequest AWS API Documentation
@@ -3712,8 +4263,14 @@ module Aws::Lightsail
     #   @return [Array<Types::CloudFormationStackRecord>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results of your get
-    #   relational database bundles request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another
+    #   `GetCloudFormationStackRecords` request and specify the next page
+    #   token using the `pageToken` parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetCloudFormationStackRecordsResult AWS API Documentation
@@ -3724,6 +4281,39 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetContactMethodsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         protocols: ["Email"], # accepts Email, SMS
+    #       }
+    #
+    # @!attribute [rw] protocols
+    #   The protocols used to send notifications, such as `Email`, or `SMS`
+    #   (text messaging).
+    #
+    #   Specify a protocol in your request to return information about a
+    #   specific contact method protocol.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetContactMethodsRequest AWS API Documentation
+    #
+    class GetContactMethodsRequest < Struct.new(
+      :protocols)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] contact_methods
+    #   An array of objects that describe the contact methods.
+    #   @return [Array<Types::ContactMethod>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetContactMethodsResult AWS API Documentation
+    #
+    class GetContactMethodsResult < Struct.new(
+      :contact_methods)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetDiskRequest
     #   data as a hash:
     #
@@ -3790,8 +4380,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to the next page of results from your
-    #   GetDiskSnapshots request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetDiskSnapshots` request.
+    #   If your results are paginated, the response will return a next page
+    #   token that you can specify as the page token in a subsequent
+    #   request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetDiskSnapshotsRequest AWS API Documentation
@@ -3807,8 +4401,14 @@ module Aws::Lightsail
     #   @return [Array<Types::DiskSnapshot>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your
-    #   GetDiskSnapshots request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetDiskSnapshots`
+    #   request and specify the next page token using the `pageToken`
+    #   parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetDiskSnapshotsResult AWS API Documentation
@@ -3827,8 +4427,11 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to the next page of results from your
-    #   GetDisks request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetDisks` request. If your
+    #   results are paginated, the response will return a next page token
+    #   that you can specify as the page token in a subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetDisksRequest AWS API Documentation
@@ -3844,8 +4447,13 @@ module Aws::Lightsail
     #   @return [Array<Types::Disk>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your
-    #   GetDisks request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetDisks` request
+    #   and specify the next page token using the `pageToken` parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetDisksResult AWS API Documentation
@@ -3894,8 +4502,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to the next page of results from your get
-    #   domains request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetDomains` request. If
+    #   your results are paginated, the response will return a next page
+    #   token that you can specify as the page token in a subsequent
+    #   request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetDomainsRequest AWS API Documentation
@@ -3911,8 +4523,14 @@ module Aws::Lightsail
     #   @return [Array<Types::Domain>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   active names request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetDomains`
+    #   request and specify the next page token using the `pageToken`
+    #   parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetDomainsResult AWS API Documentation
@@ -3931,8 +4549,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to a specific page of results for your
-    #   `get export snapshot records` request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetExportSnapshotRecords`
+    #   request. If your results are paginated, the response will return a
+    #   next page token that you can specify as the page token in a
+    #   subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetExportSnapshotRecordsRequest AWS API Documentation
@@ -3947,8 +4569,14 @@ module Aws::Lightsail
     #   @return [Array<Types::ExportSnapshotRecord>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results of your get
-    #   relational database bundles request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another
+    #   `GetExportSnapshotRecords` request and specify the next page token
+    #   using the `pageToken` parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetExportSnapshotRecordsResult AWS API Documentation
@@ -4000,7 +4628,7 @@ module Aws::Lightsail
     #
     #       {
     #         instance_name: "ResourceName", # required
-    #         metric_name: "CPUUtilization", # required, accepts CPUUtilization, NetworkIn, NetworkOut, StatusCheckFailed, StatusCheckFailed_Instance, StatusCheckFailed_System
+    #         metric_name: "CPUUtilization", # required, accepts CPUUtilization, NetworkIn, NetworkOut, StatusCheckFailed, StatusCheckFailed_Instance, StatusCheckFailed_System, BurstCapacityTime, BurstCapacityPercentage
     #         period: 1, # required
     #         start_time: Time.now, # required
     #         end_time: Time.now, # required
@@ -4013,11 +4641,118 @@ module Aws::Lightsail
     #   @return [String]
     #
     # @!attribute [rw] metric_name
-    #   The metric name to get data about.
+    #   The metric for which you want to return information.
+    #
+    #   Valid instance metric names are listed below, along with the most
+    #   useful `statistics` to include in your request, and the published
+    #   `unit` value.
+    #
+    #   * <b> <code>BurstCapacityPercentage</code> </b> - The percentage of
+    #     CPU performance available for your instance to burst above its
+    #     baseline. Your instance continously accrues and consumes burst
+    #     capacity. Burst capacity stops accruing when your instance's
+    #     `BurstCapacityPercentage` reaches 100%. For more information, see
+    #     [Viewing instance burst capacity in Amazon Lightsail][1].
+    #
+    #     `Statistics`\: The most useful statistics are `Maximum` and
+    #     `Average`.
+    #
+    #     `Unit`\: The published unit is `Percent`.
+    #
+    #   * <b> <code>BurstCapacityTime</code> </b> - The available amount of
+    #     time for your instance to burst at 100% CPU utilization. Your
+    #     instance continously accrues and consumes burst capacity. Burst
+    #     capacity time stops accruing when your instance's
+    #     `BurstCapacityPercentage` metric reaches 100%.
+    #
+    #     Burst capacity time is consumed at the full rate only when your
+    #     instance operates at 100% CPU utilization. For example, if your
+    #     instance operates at 50% CPU utilization in the burstable zone for
+    #     a 5-minute period, then it consumes CPU burst capacity minutes at
+    #     a 50% rate in that period. Your instance consumed 2 minutes and 30
+    #     seconds of CPU burst capacity minutes in the 5-minute period. For
+    #     more information, see [Viewing instance burst capacity in Amazon
+    #     Lightsail][1].
+    #
+    #     `Statistics`\: The most useful statistics are `Maximum` and
+    #     `Average`.
+    #
+    #     `Unit`\: The published unit is `Seconds`.
+    #
+    #   * <b> <code>CPUUtilization</code> </b> - The percentage of allocated
+    #     compute units that are currently in use on the instance. This
+    #     metric identifies the processing power to run the applications on
+    #     the instance. Tools in your operating system can show a lower
+    #     percentage than Lightsail when the instance is not allocated a
+    #     full processor core.
+    #
+    #     `Statistics`\: The most useful statistics are `Maximum` and
+    #     `Average`.
+    #
+    #     `Unit`\: The published unit is `Percent`.
+    #
+    #   * <b> <code>NetworkIn</code> </b> - The number of bytes received on
+    #     all network interfaces by the instance. This metric identifies the
+    #     volume of incoming network traffic to the instance. The number
+    #     reported is the number of bytes received during the period.
+    #     Because this metric is reported in 5-minute intervals, divide the
+    #     reported number by 300 to find Bytes/second.
+    #
+    #     `Statistics`\: The most useful statistic is `Sum`.
+    #
+    #     `Unit`\: The published unit is `Bytes`.
+    #
+    #   * <b> <code>NetworkOut</code> </b> - The number of bytes sent out on
+    #     all network interfaces by the instance. This metric identifies the
+    #     volume of outgoing network traffic from the instance. The number
+    #     reported is the number of bytes sent during the period. Because
+    #     this metric is reported in 5-minute intervals, divide the reported
+    #     number by 300 to find Bytes/second.
+    #
+    #     `Statistics`\: The most useful statistic is `Sum`.
+    #
+    #     `Unit`\: The published unit is `Bytes`.
+    #
+    #   * <b> <code>StatusCheckFailed</code> </b> - Reports whether the
+    #     instance passed or failed both the instance status check and the
+    #     system status check. This metric can be either 0 (passed) or 1
+    #     (failed). This metric data is available in 1-minute (60 seconds)
+    #     granularity.
+    #
+    #     `Statistics`\: The most useful statistic is `Sum`.
+    #
+    #     `Unit`\: The published unit is `Count`.
+    #
+    #   * <b> <code>StatusCheckFailed_Instance</code> </b> - Reports whether
+    #     the instance passed or failed the instance status check. This
+    #     metric can be either 0 (passed) or 1 (failed). This metric data is
+    #     available in 1-minute (60 seconds) granularity.
+    #
+    #     `Statistics`\: The most useful statistic is `Sum`.
+    #
+    #     `Unit`\: The published unit is `Count`.
+    #
+    #   * <b> <code>StatusCheckFailed_System</code> </b> - Reports whether
+    #     the instance passed or failed the system status check. This metric
+    #     can be either 0 (passed) or 1 (failed). This metric data is
+    #     available in 1-minute (60 seconds) granularity.
+    #
+    #     `Statistics`\: The most useful statistic is `Sum`.
+    #
+    #     `Unit`\: The published unit is `Count`.
+    #
+    #
+    #
+    #   [1]: https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-viewing-instance-burst-capacity
     #   @return [String]
     #
     # @!attribute [rw] period
     #   The granularity, in seconds, of the returned data points.
+    #
+    #   The `StatusCheckFailed`, `StatusCheckFailed_Instance`, and
+    #   `StatusCheckFailed_System` instance metric data is available in
+    #   1-minute (60 seconds) granularity. All other instance metric data is
+    #   available in 5-minute (300 seconds) granularity.
     #   @return [Integer]
     #
     # @!attribute [rw] start_time
@@ -4029,11 +4764,37 @@ module Aws::Lightsail
     #   @return [Time]
     #
     # @!attribute [rw] unit
-    #   The unit. The list of valid values is below.
+    #   The unit for the metric data request. Valid units depend on the
+    #   metric data being requested. For the valid units to specify with
+    #   each available metric, see the `metricName` parameter.
     #   @return [String]
     #
     # @!attribute [rw] statistics
-    #   The instance statistics.
+    #   The statistic for the metric.
+    #
+    #   The following statistics are available:
+    #
+    #   * `Minimum` - The lowest value observed during the specified period.
+    #     Use this value to determine low volumes of activity for your
+    #     application.
+    #
+    #   * `Maximum` - The highest value observed during the specified
+    #     period. Use this value to determine high volumes of activity for
+    #     your application.
+    #
+    #   * `Sum` - All values submitted for the matching metric added
+    #     together. You can use this statistic to determine the total volume
+    #     of a metric.
+    #
+    #   * `Average` - The value of Sum / SampleCount during the specified
+    #     period. By comparing this statistic with the Minimum and Maximum
+    #     values, you can determine the full scope of a metric and how close
+    #     the average use is to the Minimum and Maximum values. This
+    #     comparison helps you to know when to increase or decrease your
+    #     resources.
+    #
+    #   * `SampleCount` - The count, or number, of data points used for the
+    #     statistical calculation.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetInstanceMetricDataRequest AWS API Documentation
@@ -4050,12 +4811,11 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] metric_name
-    #   The metric name to return data for.
+    #   The name of the metric returned.
     #   @return [String]
     #
     # @!attribute [rw] metric_data
-    #   An array of key-value pairs containing information about the results
-    #   of your get instance metric data request.
+    #   An array of objects that describe the metric data returned.
     #   @return [Array<Types::MetricDatapoint>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetInstanceMetricDataResult AWS API Documentation
@@ -4074,7 +4834,7 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] instance_name
-    #   The name of the instance.
+    #   The name of the instance for which to return firewall port states.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetInstancePortStatesRequest AWS API Documentation
@@ -4085,7 +4845,8 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] port_states
-    #   Information about the port states resulting from your request.
+    #   An array of objects that describe the firewall port states for the
+    #   specified instance.
     #   @return [Array<Types::InstancePortState>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetInstancePortStatesResult AWS API Documentation
@@ -4163,8 +4924,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to the next page of results from your get
-    #   instance snapshots request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetInstanceSnapshots`
+    #   request. If your results are paginated, the response will return a
+    #   next page token that you can specify as the page token in a
+    #   subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetInstanceSnapshotsRequest AWS API Documentation
@@ -4180,8 +4945,14 @@ module Aws::Lightsail
     #   @return [Array<Types::InstanceSnapshot>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   instance snapshots request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another
+    #   `GetInstanceSnapshots` request and specify the next page token using
+    #   the `pageToken` parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetInstanceSnapshotsResult AWS API Documentation
@@ -4229,8 +5000,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to the next page of results from your get
-    #   instances request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetInstances` request. If
+    #   your results are paginated, the response will return a next page
+    #   token that you can specify as the page token in a subsequent
+    #   request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetInstancesRequest AWS API Documentation
@@ -4246,8 +5021,14 @@ module Aws::Lightsail
     #   @return [Array<Types::Instance>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   instances request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetInstances`
+    #   request and specify the next page token using the `pageToken`
+    #   parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetInstancesResult AWS API Documentation
@@ -4296,8 +5077,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to the next page of results from your get
-    #   key pairs request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetKeyPairs` request. If
+    #   your results are paginated, the response will return a next page
+    #   token that you can specify as the page token in a subsequent
+    #   request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetKeyPairsRequest AWS API Documentation
@@ -4313,8 +5098,14 @@ module Aws::Lightsail
     #   @return [Array<Types::KeyPair>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   key pairs request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetKeyPairs`
+    #   request and specify the next page token using the `pageToken`
+    #   parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetKeyPairsResult AWS API Documentation
@@ -4343,94 +5134,127 @@ module Aws::Lightsail
     #   @return [String]
     #
     # @!attribute [rw] metric_name
-    #   The metric about which you want to return information. Valid values
-    #   are listed below, along with the most useful `statistics` to include
-    #   in your request.
+    #   The metric for which you want to return information.
+    #
+    #   Valid load balancer metric names are listed below, along with the
+    #   most useful `statistics` to include in your request, and the
+    #   published `unit` value.
     #
     #   * <b> <code>ClientTLSNegotiationErrorCount</code> </b> - The number
     #     of TLS connections initiated by the client that did not establish
-    #     a session with the load balancer. Possible causes include a
-    #     mismatch of ciphers or protocols.
+    #     a session with the load balancer due to a TLS error generated by
+    #     the load balancer. Possible causes include a mismatch of ciphers
+    #     or protocols.
     #
     #     `Statistics`\: The most useful statistic is `Sum`.
     #
+    #     `Unit`\: The published unit is `Count`.
+    #
     #   * <b> <code>HealthyHostCount</code> </b> - The number of target
     #     instances that are considered healthy.
     #
     #     `Statistics`\: The most useful statistic are `Average`, `Minimum`,
     #     and `Maximum`.
     #
-    #   * <b> <code>UnhealthyHostCount</code> </b> - The number of target
-    #     instances that are considered unhealthy.
+    #     `Unit`\: The published unit is `Count`.
     #
-    #     `Statistics`\: The most useful statistic are `Average`, `Minimum`,
-    #     and `Maximum`.
-    #
-    #   * <b> <code>HTTPCode_LB_4XX_Count</code> </b> - The number of HTTP
-    #     4XX client error codes that originate from the load balancer.
-    #     Client errors are generated when requests are malformed or
-    #     incomplete. These requests have not been received by the target
-    #     instance. This count does not include any response codes generated
-    #     by the target instances.
+    #   * <b> <code>HTTPCode_Instance_2XX_Count</code> </b> - The number of
+    #     HTTP 2XX response codes generated by the target instances. This
+    #     does not include any response codes generated by the load
+    #     balancer.
     #
     #     `Statistics`\: The most useful statistic is `Sum`. Note that
     #     `Minimum`, `Maximum`, and `Average` all return `1`.
     #
-    #   * <b> <code>HTTPCode_LB_5XX_Count</code> </b> - The number of HTTP
-    #     5XX server error codes that originate from the load balancer. This
-    #     count does not include any response codes generated by the target
-    #     instances.
+    #     `Unit`\: The published unit is `Count`.
+    #
+    #   * <b> <code>HTTPCode_Instance_3XX_Count</code> </b> - The number of
+    #     HTTP 3XX response codes generated by the target instances. This
+    #     does not include any response codes generated by the load
+    #     balancer.
     #
     #     `Statistics`\: The most useful statistic is `Sum`. Note that
-    #     `Minimum`, `Maximum`, and `Average` all return `1`. Note that
     #     `Minimum`, `Maximum`, and `Average` all return `1`.
     #
-    #   * <b> <code>HTTPCode_Instance_2XX_Count</code> </b> - The number of
-    #     HTTP response codes generated by the target instances. This does
-    #     not include any response codes generated by the load balancer.
+    #     `Unit`\: The published unit is `Count`.
+    #
+    #   * <b> <code>HTTPCode_Instance_4XX_Count</code> </b> - The number of
+    #     HTTP 4XX response codes generated by the target instances. This
+    #     does not include any response codes generated by the load
+    #     balancer.
     #
     #     `Statistics`\: The most useful statistic is `Sum`. Note that
     #     `Minimum`, `Maximum`, and `Average` all return `1`.
     #
-    #   * <b> <code>HTTPCode_Instance_3XX_Count</code> </b> - The number of
-    #     HTTP response codes generated by the target instances. This does
-    #     not include any response codes generated by the load balancer.
+    #     `Unit`\: The published unit is `Count`.
+    #
+    #   * <b> <code>HTTPCode_Instance_5XX_Count</code> </b> - The number of
+    #     HTTP 5XX response codes generated by the target instances. This
+    #     does not include any response codes generated by the load
+    #     balancer.
     #
     #     `Statistics`\: The most useful statistic is `Sum`. Note that
     #     `Minimum`, `Maximum`, and `Average` all return `1`.
     #
-    #   * <b> <code>HTTPCode_Instance_4XX_Count</code> </b> - The number of
-    #     HTTP response codes generated by the target instances. This does
-    #     not include any response codes generated by the load balancer.
+    #     `Unit`\: The published unit is `Count`.
+    #
+    #   * <b> <code>HTTPCode_LB_4XX_Count</code> </b> - The number of HTTP
+    #     4XX client error codes that originated from the load balancer.
+    #     Client errors are generated when requests are malformed or
+    #     incomplete. These requests were not received by the target
+    #     instance. This count does not include response codes generated by
+    #     the target instances.
     #
     #     `Statistics`\: The most useful statistic is `Sum`. Note that
     #     `Minimum`, `Maximum`, and `Average` all return `1`.
     #
-    #   * <b> <code>HTTPCode_Instance_5XX_Count</code> </b> - The number of
-    #     HTTP response codes generated by the target instances. This does
-    #     not include any response codes generated by the load balancer.
+    #     `Unit`\: The published unit is `Count`.
+    #
+    #   * <b> <code>HTTPCode_LB_5XX_Count</code> </b> - The number of HTTP
+    #     5XX server error codes that originated from the load balancer.
+    #     This does not include any response codes generated by the target
+    #     instance. This metric is reported if there are no healthy
+    #     instances attached to the load balancer, or if the request rate
+    #     exceeds the capacity of the instances (spillover) or the load
+    #     balancer.
     #
     #     `Statistics`\: The most useful statistic is `Sum`. Note that
     #     `Minimum`, `Maximum`, and `Average` all return `1`.
     #
+    #     `Unit`\: The published unit is `Count`.
+    #
     #   * <b> <code>InstanceResponseTime</code> </b> - The time elapsed, in
     #     seconds, after the request leaves the load balancer until a
     #     response from the target instance is received.
     #
     #     `Statistics`\: The most useful statistic is `Average`.
     #
+    #     `Unit`\: The published unit is `Seconds`.
+    #
     #   * <b> <code>RejectedConnectionCount</code> </b> - The number of
     #     connections that were rejected because the load balancer had
     #     reached its maximum number of connections.
     #
     #     `Statistics`\: The most useful statistic is `Sum`.
     #
+    #     `Unit`\: The published unit is `Count`.
+    #
     #   * <b> <code>RequestCount</code> </b> - The number of requests
     #     processed over IPv4. This count includes only the requests with a
     #     response generated by a target instance of the load balancer.
     #
     #     `Statistics`\: The most useful statistic is `Sum`. Note that
     #     `Minimum`, `Maximum`, and `Average` all return `1`.
+    #
+    #     `Unit`\: The published unit is `Count`.
+    #
+    #   * <b> <code>UnhealthyHostCount</code> </b> - The number of target
+    #     instances that are considered unhealthy.
+    #
+    #     `Statistics`\: The most useful statistic are `Average`, `Minimum`,
+    #     and `Maximum`.
+    #
+    #     `Unit`\: The published unit is `Count`.
     #   @return [String]
     #
     # @!attribute [rw] period
@@ -4446,34 +5270,37 @@ module Aws::Lightsail
     #   @return [Time]
     #
     # @!attribute [rw] unit
-    #   The unit for the time period request. Valid values are listed below.
+    #   The unit for the metric data request. Valid units depend on the
+    #   metric data being requested. For the valid units with each available
+    #   metric, see the `metricName` parameter.
     #   @return [String]
     #
     # @!attribute [rw] statistics
-    #   An array of statistics that you want to request metrics for. Valid
-    #   values are listed below.
+    #   The statistic for the metric.
     #
-    #   * <b> <code>SampleCount</code> </b> - The count (number) of data
-    #     points used for the statistical calculation.
+    #   The following statistics are available:
     #
-    #   * <b> <code>Average</code> </b> - The value of Sum / SampleCount
-    #     during the specified period. By comparing this statistic with the
-    #     Minimum and Maximum, you can determine the full scope of a metric
-    #     and how close the average use is to the Minimum and Maximum. This
-    #     comparison helps you to know when to increase or decrease your
-    #     resources as needed.
+    #   * `Minimum` - The lowest value observed during the specified period.
+    #     Use this value to determine low volumes of activity for your
+    #     application.
     #
-    #   * <b> <code>Sum</code> </b> - All values submitted for the matching
-    #     metric added together. This statistic can be useful for
-    #     determining the total volume of a metric.
+    #   * `Maximum` - The highest value observed during the specified
+    #     period. Use this value to determine high volumes of activity for
+    #     your application.
     #
-    #   * <b> <code>Minimum</code> </b> - The lowest value observed during
-    #     the specified period. You can use this value to determine low
-    #     volumes of activity for your application.
+    #   * `Sum` - All values submitted for the matching metric added
+    #     together. You can use this statistic to determine the total volume
+    #     of a metric.
     #
-    #   * <b> <code>Maximum</code> </b> - The highest value observed during
-    #     the specified period. You can use this value to determine high
-    #     volumes of activity for your application.
+    #   * `Average` - The value of Sum / SampleCount during the specified
+    #     period. By comparing this statistic with the Minimum and Maximum
+    #     values, you can determine the full scope of a metric and how close
+    #     the average use is to the Minimum and Maximum values. This
+    #     comparison helps you to know when to increase or decrease your
+    #     resources.
+    #
+    #   * `SampleCount` - The count, or number, of data points used for the
+    #     statistical calculation.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetLoadBalancerMetricDataRequest AWS API Documentation
@@ -4490,98 +5317,11 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] metric_name
-    #   The metric about which you are receiving information. Valid values
-    #   are listed below, along with the most useful `statistics` to include
-    #   in your request.
-    #
-    #   * <b> <code>ClientTLSNegotiationErrorCount</code> </b> - The number
-    #     of TLS connections initiated by the client that did not establish
-    #     a session with the load balancer. Possible causes include a
-    #     mismatch of ciphers or protocols.
-    #
-    #     `Statistics`\: The most useful statistic is `Sum`.
-    #
-    #   * <b> <code>HealthyHostCount</code> </b> - The number of target
-    #     instances that are considered healthy.
-    #
-    #     `Statistics`\: The most useful statistic are `Average`, `Minimum`,
-    #     and `Maximum`.
-    #
-    #   * <b> <code>UnhealthyHostCount</code> </b> - The number of target
-    #     instances that are considered unhealthy.
-    #
-    #     `Statistics`\: The most useful statistic are `Average`, `Minimum`,
-    #     and `Maximum`.
-    #
-    #   * <b> <code>HTTPCode_LB_4XX_Count</code> </b> - The number of HTTP
-    #     4XX client error codes that originate from the load balancer.
-    #     Client errors are generated when requests are malformed or
-    #     incomplete. These requests have not been received by the target
-    #     instance. This count does not include any response codes generated
-    #     by the target instances.
-    #
-    #     `Statistics`\: The most useful statistic is `Sum`. Note that
-    #     `Minimum`, `Maximum`, and `Average` all return `1`.
-    #
-    #   * <b> <code>HTTPCode_LB_5XX_Count</code> </b> - The number of HTTP
-    #     5XX server error codes that originate from the load balancer. This
-    #     count does not include any response codes generated by the target
-    #     instances.
-    #
-    #     `Statistics`\: The most useful statistic is `Sum`. Note that
-    #     `Minimum`, `Maximum`, and `Average` all return `1`. Note that
-    #     `Minimum`, `Maximum`, and `Average` all return `1`.
-    #
-    #   * <b> <code>HTTPCode_Instance_2XX_Count</code> </b> - The number of
-    #     HTTP response codes generated by the target instances. This does
-    #     not include any response codes generated by the load balancer.
-    #
-    #     `Statistics`\: The most useful statistic is `Sum`. Note that
-    #     `Minimum`, `Maximum`, and `Average` all return `1`.
-    #
-    #   * <b> <code>HTTPCode_Instance_3XX_Count</code> </b> - The number of
-    #     HTTP response codes generated by the target instances. This does
-    #     not include any response codes generated by the load balancer.
-    #
-    #     `Statistics`\: The most useful statistic is `Sum`. Note that
-    #     `Minimum`, `Maximum`, and `Average` all return `1`.
-    #
-    #   * <b> <code>HTTPCode_Instance_4XX_Count</code> </b> - The number of
-    #     HTTP response codes generated by the target instances. This does
-    #     not include any response codes generated by the load balancer.
-    #
-    #     `Statistics`\: The most useful statistic is `Sum`. Note that
-    #     `Minimum`, `Maximum`, and `Average` all return `1`.
-    #
-    #   * <b> <code>HTTPCode_Instance_5XX_Count</code> </b> - The number of
-    #     HTTP response codes generated by the target instances. This does
-    #     not include any response codes generated by the load balancer.
-    #
-    #     `Statistics`\: The most useful statistic is `Sum`. Note that
-    #     `Minimum`, `Maximum`, and `Average` all return `1`.
-    #
-    #   * <b> <code>InstanceResponseTime</code> </b> - The time elapsed, in
-    #     seconds, after the request leaves the load balancer until a
-    #     response from the target instance is received.
-    #
-    #     `Statistics`\: The most useful statistic is `Average`.
-    #
-    #   * <b> <code>RejectedConnectionCount</code> </b> - The number of
-    #     connections that were rejected because the load balancer had
-    #     reached its maximum number of connections.
-    #
-    #     `Statistics`\: The most useful statistic is `Sum`.
-    #
-    #   * <b> <code>RequestCount</code> </b> - The number of requests
-    #     processed over IPv4. This count includes only the requests with a
-    #     response generated by a target instance of the load balancer.
-    #
-    #     `Statistics`\: The most useful statistic is `Sum`. Note that
-    #     `Minimum`, `Maximum`, and `Average` all return `1`.
+    #   The name of the metric returned.
     #   @return [String]
     #
     # @!attribute [rw] metric_data
-    #   An array of metric datapoint objects.
+    #   An array of objects that describe the metric data returned.
     #   @return [Array<Types::MetricDatapoint>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetLoadBalancerMetricDataResult AWS API Documentation
@@ -4660,7 +5400,11 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for paginating the results from your GetLoadBalancers
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetLoadBalancers` request.
+    #   If your results are paginated, the response will return a next page
+    #   token that you can specify as the page token in a subsequent
     #   request.
     #   @return [String]
     #
@@ -4676,8 +5420,14 @@ module Aws::Lightsail
     #   @return [Array<Types::LoadBalancer>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your
-    #   GetLoadBalancers request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetLoadBalancers`
+    #   request and specify the next page token using the `pageToken`
+    #   parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetLoadBalancersResult AWS API Documentation
@@ -4707,8 +5457,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operation
-    #   An array of key-value pairs containing information about the results
-    #   of your get operation request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetOperationResult AWS API Documentation
@@ -4731,8 +5482,12 @@ module Aws::Lightsail
     #   @return [String]
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to the next page of results from your get
-    #   operations for resource request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetOperationsForResource`
+    #   request. If your results are paginated, the response will return a
+    #   next page token that you can specify as the page token in a
+    #   subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetOperationsForResourceRequest AWS API Documentation
@@ -4744,8 +5499,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the results
-    #   of your get operations for resource request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @!attribute [rw] next_page_count
@@ -4759,9 +5515,14 @@ module Aws::Lightsail
     #   @return [String]
     #
     # @!attribute [rw] next_page_token
-    #   An identifier that was returned from the previous call to this
-    #   operation, which can be used to return the next set of items in the
-    #   list.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another
+    #   `GetOperationsForResource` request and specify the next page token
+    #   using the `pageToken` parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetOperationsForResourceResult AWS API Documentation
@@ -4781,8 +5542,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to the next page of results from your get
-    #   operations request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetOperations` request. If
+    #   your results are paginated, the response will return a next page
+    #   token that you can specify as the page token in a subsequent
+    #   request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetOperationsRequest AWS API Documentation
@@ -4793,13 +5558,20 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the results
-    #   of your get operations request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   operations request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetOperations`
+    #   request and specify the next page token using the `pageToken`
+    #   parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetOperationsResult AWS API Documentation
@@ -4858,8 +5630,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to a specific page of results for your
-    #   `get relational database blueprints` request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial
+    #   `GetRelationalDatabaseBlueprints` request. If your results are
+    #   paginated, the response will return a next page token that you can
+    #   specify as the page token in a subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseBlueprintsRequest AWS API Documentation
@@ -4875,8 +5651,14 @@ module Aws::Lightsail
     #   @return [Array<Types::RelationalDatabaseBlueprint>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results of your get
-    #   relational database blueprints request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another
+    #   `GetRelationalDatabaseBlueprints` request and specify the next page
+    #   token using the `pageToken` parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseBlueprintsResult AWS API Documentation
@@ -4895,8 +5677,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to a specific page of results for your
-    #   `get relational database bundles` request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial
+    #   `GetRelationalDatabaseBundles` request. If your results are
+    #   paginated, the response will return a next page token that you can
+    #   specify as the page token in a subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseBundlesRequest AWS API Documentation
@@ -4912,8 +5698,14 @@ module Aws::Lightsail
     #   @return [Array<Types::RelationalDatabaseBundle>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results of your get
-    #   relational database bundles request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another
+    #   `GetRelationalDatabaseBundles` request and specify the next page
+    #   token using the `pageToken` parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseBundlesResult AWS API Documentation
@@ -4947,8 +5739,12 @@ module Aws::Lightsail
     #   @return [Integer]
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to a specific page of results from for
-    #   get relational database events request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial
+    #   `GetRelationalDatabaseEvents` request. If your results are
+    #   paginated, the response will return a next page token that you can
+    #   specify as the page token in a subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseEventsRequest AWS API Documentation
@@ -4966,8 +5762,14 @@ module Aws::Lightsail
     #   @return [Array<Types::RelationalDatabaseEvent>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   relational database events request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another
+    #   `GetRelationalDatabaseEvents` request and specify the next page
+    #   token using the `pageToken` parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseEventsResult AWS API Documentation
@@ -5040,8 +5842,14 @@ module Aws::Lightsail
     #   @return [Boolean]
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to a specific page of results for your
-    #   `get relational database log events` request.
+    #   The token to advance to the next or previous page of results from
+    #   your request.
+    #
+    #   To get a page token, perform an initial
+    #   `GetRelationalDatabaseLogEvents` request. If your results are
+    #   paginated, the response will return a next forward token and/or next
+    #   backward token that you can specify as the page token in a
+    #   subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseLogEventsRequest AWS API Documentation
@@ -5177,11 +5985,66 @@ module Aws::Lightsail
     #   @return [String]
     #
     # @!attribute [rw] metric_name
-    #   The name of the metric data to return.
+    #   The metric for which you want to return information.
+    #
+    #   Valid relational database metric names are listed below, along with
+    #   the most useful `statistics` to include in your request, and the
+    #   published `unit` value. All relational database metric data is
+    #   available in 1-minute (60 seconds) granularity.
+    #
+    #   * <b> <code>CPUUtilization</code> </b> - The percentage of CPU
+    #     utilization currently in use on the database.
+    #
+    #     `Statistics`\: The most useful statistics are `Maximum` and
+    #     `Average`.
+    #
+    #     `Unit`\: The published unit is `Percent`.
+    #
+    #   * <b> <code>DatabaseConnections</code> </b> - The number of database
+    #     connections in use.
+    #
+    #     `Statistics`\: The most useful statistics are `Maximum` and `Sum`.
+    #
+    #     `Unit`\: The published unit is `Count`.
+    #
+    #   * <b> <code>DiskQueueDepth</code> </b> - The number of outstanding
+    #     IOs (read/write requests) that are waiting to access the disk.
+    #
+    #     `Statistics`\: The most useful statistic is `Sum`.
+    #
+    #     `Unit`\: The published unit is `Count`.
+    #
+    #   * <b> <code>FreeStorageSpace</code> </b> - The amount of available
+    #     storage space.
+    #
+    #     `Statistics`\: The most useful statistic is `Sum`.
+    #
+    #     `Unit`\: The published unit is `Bytes`.
+    #
+    #   * <b> <code>NetworkReceiveThroughput</code> </b> - The incoming
+    #     (Receive) network traffic on the database, including both customer
+    #     database traffic and AWS traffic used for monitoring and
+    #     replication.
+    #
+    #     `Statistics`\: The most useful statistic is `Average`.
+    #
+    #     `Unit`\: The published unit is `Bytes/Second`.
+    #
+    #   * <b> <code>NetworkTransmitThroughput</code> </b> - The outgoing
+    #     (Transmit) network traffic on the database, including both
+    #     customer database traffic and AWS traffic used for monitoring and
+    #     replication.
+    #
+    #     `Statistics`\: The most useful statistic is `Average`.
+    #
+    #     `Unit`\: The published unit is `Bytes/Second`.
     #   @return [String]
     #
     # @!attribute [rw] period
     #   The granularity, in seconds, of the returned data points.
+    #
+    #   All relational database metric data is available in 1-minute (60
+    #   seconds) granularity.
     #   @return [Integer]
     #
     # @!attribute [rw] start_time
@@ -5211,11 +6074,37 @@ module Aws::Lightsail
     #   @return [Time]
     #
     # @!attribute [rw] unit
-    #   The unit for the metric data request.
+    #   The unit for the metric data request. Valid units depend on the
+    #   metric data being requested. For the valid units with each available
+    #   metric, see the `metricName` parameter.
     #   @return [String]
     #
     # @!attribute [rw] statistics
-    #   The array of statistics for your metric data request.
+    #   The statistic for the metric.
+    #
+    #   The following statistics are available:
+    #
+    #   * `Minimum` - The lowest value observed during the specified period.
+    #     Use this value to determine low volumes of activity for your
+    #     application.
+    #
+    #   * `Maximum` - The highest value observed during the specified
+    #     period. Use this value to determine high volumes of activity for
+    #     your application.
+    #
+    #   * `Sum` - All values submitted for the matching metric added
+    #     together. You can use this statistic to determine the total volume
+    #     of a metric.
+    #
+    #   * `Average` - The value of Sum / SampleCount during the specified
+    #     period. By comparing this statistic with the Minimum and Maximum
+    #     values, you can determine the full scope of a metric and how close
+    #     the average use is to the Minimum and Maximum values. This
+    #     comparison helps you to know when to increase or decrease your
+    #     resources.
+    #
+    #   * `SampleCount` - The count, or number, of data points used for the
+    #     statistical calculation.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseMetricDataRequest AWS API Documentation
@@ -5232,12 +6121,11 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] metric_name
-    #   The name of the metric.
+    #   The name of the metric returned.
     #   @return [String]
     #
     # @!attribute [rw] metric_data
-    #   An object describing the result of your get relational database
-    #   metric data request.
+    #   An array of objects that describe the metric data returned.
     #   @return [Array<Types::MetricDatapoint>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseMetricDataResult AWS API Documentation
@@ -5261,8 +6149,12 @@ module Aws::Lightsail
     #   @return [String]
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to a specific page of results for your
-    #   `get relational database parameters` request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial
+    #   `GetRelationalDatabaseParameters` request. If your results are
+    #   paginated, the response will return a next page token that you can
+    #   specify as the page token in a subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseParametersRequest AWS API Documentation
@@ -5279,8 +6171,14 @@ module Aws::Lightsail
     #   @return [Array<Types::RelationalDatabaseParameter>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   static IPs request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another
+    #   `GetRelationalDatabaseParameters` request and specify the next page
+    #   token using the `pageToken` parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseParametersResult AWS API Documentation
@@ -5357,8 +6255,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to a specific page of results for your
-    #   `get relational database snapshots` request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial
+    #   `GetRelationalDatabaseSnapshots` request. If your results are
+    #   paginated, the response will return a next page token that you can
+    #   specify as the page token in a subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseSnapshotsRequest AWS API Documentation
@@ -5374,8 +6276,14 @@ module Aws::Lightsail
     #   @return [Array<Types::RelationalDatabaseSnapshot>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   relational database snapshots request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another
+    #   `GetRelationalDatabaseSnapshots` request and specify the next page
+    #   token using the `pageToken` parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabaseSnapshotsResult AWS API Documentation
@@ -5394,8 +6302,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to a specific page of results for your
-    #   `get relational database` request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetRelationalDatabases`
+    #   request. If your results are paginated, the response will return a
+    #   next page token that you can specify as the page token in a
+    #   subsequent request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabasesRequest AWS API Documentation
@@ -5411,8 +6323,14 @@ module Aws::Lightsail
     #   @return [Array<Types::RelationalDatabase>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   relational databases request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another
+    #   `GetRelationalDatabases` request and specify the next page token
+    #   using the `pageToken` parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetRelationalDatabasesResult AWS API Documentation
@@ -5461,8 +6379,12 @@ module Aws::Lightsail
     #       }
     #
     # @!attribute [rw] page_token
-    #   A token used for advancing to the next page of results from your get
-    #   static IPs request.
+    #   The token to advance to the next page of results from your request.
+    #
+    #   To get a page token, perform an initial `GetStaticIps` request. If
+    #   your results are paginated, the response will return a next page
+    #   token that you can specify as the page token in a subsequent
+    #   request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetStaticIpsRequest AWS API Documentation
@@ -5478,8 +6400,14 @@ module Aws::Lightsail
     #   @return [Array<Types::StaticIp>]
     #
     # @!attribute [rw] next_page_token
-    #   A token used for advancing to the next page of results from your get
-    #   static IPs request.
+    #   The token to advance to the next page of resutls from your request.
+    #
+    #   A next page token is not returned if there are no more results to
+    #   display.
+    #
+    #   To get the next page of results, perform another `GetStaticIps`
+    #   request and specify the next page token using the `pageToken`
+    #   parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/GetStaticIpsResult AWS API Documentation
@@ -5586,8 +6514,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operation
-    #   An array of key-value pairs containing information about the request
-    #   operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/ImportKeyPairResult AWS API Documentation
@@ -5836,14 +6765,22 @@ module Aws::Lightsail
     #
     #   The following configuration options are available:
     #
-    #   * DEFAULT — Use the default firewall settings from the image.
+    #   * `DEFAULT` - Use the default firewall settings from the Lightsail
+    #     instance blueprint.
+    #
+    #   * `INSTANCE` - Use the configured firewall settings from the source
+    #     Lightsail instance.
+    #
+    #   * `NONE` - Use the default Amazon EC2 security group.
     #
-    #   * INSTANCE — Use the firewall settings from the source Lightsail
-    #     instance.
+    #   * `CLOSED` - All ports closed.
     #
-    #   * NONE — Default to Amazon EC2.
+    #   <note markdown="1"> If you configured `lightsail-connect` as a `cidrListAliases` on your
+    #   instance, or if you chose to allow the Lightsail browser-based SSH
+    #   or RDP clients to connect to your instance, that configuration is
+    #   not carried over to your new Amazon EC2 instance.
     #
-    #   * CLOSED — All ports closed.
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] user_data
@@ -5998,18 +6935,44 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
-    # Describes information about the instance ports.
+    # Describes information about ports for an Amazon Lightsail instance.
+    #
+    # @!attribute [rw] from_port
+    #   The first port in a range of open ports on an instance.
+    #
+    #   Allowed ports:
+    #
+    #   * TCP and UDP - `0` to `65535`
     #
-    # @!attribute [rw] from_port
-    #   The first port in the range.
+    #   * ICMP - `8` (to configure Ping)
+    #
+    #     <note markdown="1"> Ping is the only communication supported through the ICMP protocol
+    #     in Lightsail. To configure ping, specify the `fromPort` parameter
+    #     as `8`, and the `toPort` parameter as `-1`.
+    #
+    #      </note>
     #   @return [Integer]
     #
     # @!attribute [rw] to_port
-    #   The last port in the range.
+    #   The last port in a range of open ports on an instance.
+    #
+    #   Allowed ports:
+    #
+    #   * TCP and UDP - `0` to `65535`
+    #
+    #   * ICMP - `-1` (to configure Ping)
+    #
+    #     <note markdown="1"> Ping is the only communication supported through the ICMP protocol
+    #     in Lightsail. To configure ping, specify the `fromPort` parameter
+    #     as `8`, and the `toPort` parameter as `-1`.
+    #
+    #      </note>
     #   @return [Integer]
     #
     # @!attribute [rw] protocol
-    #   The protocol being used. Can be one of the following.
+    #   The IP protocol name.
+    #
+    #   The name can be one of the following:
     #
     #   * `tcp` - Transmission Control Protocol (TCP) provides reliable,
     #     ordered, and error-checked delivery of streamed data between
@@ -6018,7 +6981,7 @@ module Aws::Lightsail
     #     service, use UDP instead.
     #
     #   * `all` - All transport layer protocol types. For more general
-    #     information, see [Transport layer][1] on Wikipedia.
+    #     information, see [Transport layer][1] on *Wikipedia*.
     #
     #   * `udp` - With User Datagram Protocol (UDP), computer applications
     #     can send messages (or datagrams) to other hosts on an Internet
@@ -6029,14 +6992,26 @@ module Aws::Lightsail
     #     latency over reliability. If you do require reliable data stream
     #     service, use TCP instead.
     #
+    #   * `icmp` - Internet Control Message Protocol (ICMP) is used to send
+    #     error messages and operational information indicating success or
+    #     failure when communicating with an instance. For example, an error
+    #     is indicated when an instance could not be reached.
+    #
+    #     <note markdown="1"> Ping is the only communication supported through the ICMP protocol
+    #     in Lightsail. To configure ping, specify the `fromPort` parameter
+    #     as `8`, and the `toPort` parameter as `-1`.
+    #
+    #      </note>
+    #
     #
     #
     #   [1]: https://en.wikipedia.org/wiki/Transport_layer
     #   @return [String]
     #
     # @!attribute [rw] access_from
-    #   The location from which access is allowed (e.g., `Anywhere
-    #   (0.0.0.0/0)`).
+    #   The location from which access is allowed. For example, `Anywhere
+    #   (0.0.0.0/0)`, or `Custom` if a specific IP address or range of IP
+    #   addresses is allowed.
     #   @return [String]
     #
     # @!attribute [rw] access_type
@@ -6044,13 +7019,39 @@ module Aws::Lightsail
     #   @return [String]
     #
     # @!attribute [rw] common_name
-    #   The common name.
+    #   The common name of the port information.
     #   @return [String]
     #
     # @!attribute [rw] access_direction
     #   The access direction (`inbound` or `outbound`).
+    #
+    #   <note markdown="1"> Lightsail currently supports only `inbound` access direction.
+    #
+    #    </note>
     #   @return [String]
     #
+    # @!attribute [rw] cidrs
+    #   The IP address, or range of IP addresses in CIDR notation, that are
+    #   allowed to connect to an instance through the ports, and the
+    #   protocol. Lightsail supports IPv4 addresses.
+    #
+    #   For more information about CIDR block notation, see [Classless
+    #   Inter-Domain Routing][1] on *Wikipedia*.
+    #
+    #
+    #
+    #   [1]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#CIDR_notation
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] cidr_list_aliases
+    #   An alias that defines access for a preconfigured range of IP
+    #   addresses.
+    #
+    #   The only alias currently supported is `lightsail-connect`, which
+    #   allows IP addresses of the browser-based RDP/SSH client in the
+    #   Lightsail console to connect to your instance.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/InstancePortInfo AWS API Documentation
     #
     class InstancePortInfo < Struct.new(
@@ -6060,22 +7061,51 @@ module Aws::Lightsail
       :access_from,
       :access_type,
       :common_name,
-      :access_direction)
+      :access_direction,
+      :cidrs,
+      :cidr_list_aliases)
       include Aws::Structure
     end
 
-    # Describes the port state.
+    # Describes open ports on an instance, the IP addresses allowed to
+    # connect to the instance through the ports, and the protocol.
     #
     # @!attribute [rw] from_port
-    #   The first port in the range.
+    #   The first port in a range of open ports on an instance.
+    #
+    #   Allowed ports:
+    #
+    #   * TCP and UDP - `0` to `65535`
+    #
+    #   * ICMP - `8` (to configure Ping)
+    #
+    #     <note markdown="1"> Ping is the only communication supported through the ICMP protocol
+    #     in Lightsail. To configure ping, specify the `fromPort` parameter
+    #     as `8`, and the `toPort` parameter as `-1`.
+    #
+    #      </note>
     #   @return [Integer]
     #
     # @!attribute [rw] to_port
-    #   The last port in the range.
+    #   The last port in a range of open ports on an instance.
+    #
+    #   Allowed ports:
+    #
+    #   * TCP and UDP - `0` to `65535`
+    #
+    #   * ICMP - `-1` (to configure Ping)
+    #
+    #     <note markdown="1"> Ping is the only communication supported through the ICMP protocol
+    #     in Lightsail. To configure ping, specify the `fromPort` parameter
+    #     as `8`, and the `toPort` parameter as `-1`.
+    #
+    #      </note>
     #   @return [Integer]
     #
     # @!attribute [rw] protocol
-    #   The protocol being used. Can be one of the following.
+    #   The IP protocol name.
+    #
+    #   The name can be one of the following:
     #
     #   * `tcp` - Transmission Control Protocol (TCP) provides reliable,
     #     ordered, and error-checked delivery of streamed data between
@@ -6084,7 +7114,7 @@ module Aws::Lightsail
     #     service, use UDP instead.
     #
     #   * `all` - All transport layer protocol types. For more general
-    #     information, see [Transport layer][1] on Wikipedia.
+    #     information, see [Transport layer][1] on *Wikipedia*.
     #
     #   * `udp` - With User Datagram Protocol (UDP), computer applications
     #     can send messages (or datagrams) to other hosts on an Internet
@@ -6095,6 +7125,17 @@ module Aws::Lightsail
     #     latency over reliability. If you do require reliable data stream
     #     service, use TCP instead.
     #
+    #   * `icmp` - Internet Control Message Protocol (ICMP) is used to send
+    #     error messages and operational information indicating success or
+    #     failure when communicating with an instance. For example, an error
+    #     is indicated when an instance could not be reached.
+    #
+    #     <note markdown="1"> Ping is the only communication supported through the ICMP protocol
+    #     in Lightsail. To configure ping, specify the `fromPort` parameter
+    #     as `8`, and the `toPort` parameter as `-1`.
+    #
+    #      </note>
+    #
     #
     #
     #   [1]: https://en.wikipedia.org/wiki/Transport_layer
@@ -6102,15 +7143,43 @@ module Aws::Lightsail
     #
     # @!attribute [rw] state
     #   Specifies whether the instance port is `open` or `closed`.
+    #
+    #   <note markdown="1"> The port state for Lightsail instances is always `open`.
+    #
+    #    </note>
     #   @return [String]
     #
+    # @!attribute [rw] cidrs
+    #   The IP address, or range of IP addresses in CIDR notation, that are
+    #   allowed to connect to an instance through the ports, and the
+    #   protocol. Lightsail supports IPv4 addresses.
+    #
+    #   For more information about CIDR block notation, see [Classless
+    #   Inter-Domain Routing][1] on *Wikipedia*.
+    #
+    #
+    #
+    #   [1]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#CIDR_notation
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] cidr_list_aliases
+    #   An alias that defines access for a preconfigured range of IP
+    #   addresses.
+    #
+    #   The only alias currently supported is `lightsail-connect`, which
+    #   allows IP addresses of the browser-based RDP/SSH client in the
+    #   Lightsail console to connect to your instance.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/InstancePortState AWS API Documentation
     #
     class InstancePortState < Struct.new(
       :from_port,
       :to_port,
       :protocol,
-      :state)
+      :state,
+      :cidrs,
+      :cidr_list_aliases)
       include Aws::Structure
     end
 
@@ -6561,7 +7630,8 @@ module Aws::Lightsail
     #   @return [Boolean]
     #
     # @!attribute [rw] status
-    #   The status of the SSL/TLS certificate. Valid values are below.
+    #   The validation status of the SSL/TLS certificate. Valid values are
+    #   below.
     #   @return [String]
     #
     # @!attribute [rw] domain_name
@@ -6823,6 +7893,39 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
+    # Describes resource being monitored by an alarm.
+    #
+    # An alarm is a way to monitor your Amazon Lightsail resource metrics.
+    # For more information, see [Alarms in Amazon Lightsail][1].
+    #
+    #
+    #
+    # [1]: https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-alarms
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) of the resource being monitored.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the Lightsail resource being monitored.
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_type
+    #   The Lightsail resource type of the resource being monitored.
+    #
+    #   Instances, load balancers, and relational databases are the only
+    #   Lightsail resources that can currently be monitored by alarms.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/MonitoredResourceInfo AWS API Documentation
+    #
+    class MonitoredResourceInfo < Struct.new(
+      :arn,
+      :name,
+      :resource_type)
+      include Aws::Structure
+    end
+
     # Describes the monthly data transfer in and out of your virtual private
     # server (or *instance*).
     #
@@ -6868,19 +7971,19 @@ module Aws::Lightsail
     #         port_info: { # required
     #           from_port: 1,
     #           to_port: 1,
-    #           protocol: "tcp", # accepts tcp, all, udp
+    #           protocol: "tcp", # accepts tcp, all, udp, icmp
+    #           cidrs: ["string"],
+    #           cidr_list_aliases: ["string"],
     #         },
     #         instance_name: "ResourceName", # required
     #       }
     #
     # @!attribute [rw] port_info
-    #   An array of key-value pairs containing information about the port
-    #   mappings.
+    #   An object to describe the ports to open for the specified instance.
     #   @return [Types::PortInfo]
     #
     # @!attribute [rw] instance_name
-    #   The name of the instance for which you want to open the public
-    #   ports.
+    #   The name of the instance for which to open ports.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/OpenInstancePublicPortsRequest AWS API Documentation
@@ -6892,8 +7995,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operation
-    #   An array of key-value pairs containing information about the request
-    #   operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/OpenInstancePublicPortsResult AWS API Documentation
@@ -7044,8 +8148,9 @@ module Aws::Lightsail
     class PeerVpcRequest < Aws::EmptyStructure; end
 
     # @!attribute [rw] operation
-    #   An array of key-value pairs containing information about the request
-    #   operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PeerVpcResult AWS API Documentation
@@ -7102,8 +8207,8 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
-    # Describes information about the ports on your virtual private server
-    # (or *instance*).
+    # Describes ports to open on an instance, the IP addresses allowed to
+    # connect to the instance through the ports, and the protocol.
     #
     # @note When making an API call, you may pass PortInfo
     #   data as a hash:
@@ -7111,27 +8216,319 @@ module Aws::Lightsail
     #       {
     #         from_port: 1,
     #         to_port: 1,
-    #         protocol: "tcp", # accepts tcp, all, udp
+    #         protocol: "tcp", # accepts tcp, all, udp, icmp
+    #         cidrs: ["string"],
+    #         cidr_list_aliases: ["string"],
     #       }
     #
     # @!attribute [rw] from_port
-    #   The first port in the range.
+    #   The first port in a range of open ports on an instance.
+    #
+    #   Allowed ports:
+    #
+    #   * TCP and UDP - `0` to `65535`
+    #
+    #   * ICMP - `8` (to configure Ping)
+    #
+    #     <note markdown="1"> Ping is the only communication supported through the ICMP protocol
+    #     in Lightsail. To configure ping, specify the `fromPort` parameter
+    #     as `8`, and the `toPort` parameter as `-1`.
+    #
+    #      </note>
     #   @return [Integer]
     #
     # @!attribute [rw] to_port
-    #   The last port in the range.
+    #   The last port in a range of open ports on an instance.
+    #
+    #   Allowed ports:
+    #
+    #   * TCP and UDP - `0` to `65535`
+    #
+    #   * ICMP - `-1` (to configure Ping)
+    #
+    #     <note markdown="1"> Ping is the only communication supported through the ICMP protocol
+    #     in Lightsail. To configure ping, specify the `fromPort` parameter
+    #     as `8`, and the `toPort` parameter as `-1`.
+    #
+    #      </note>
     #   @return [Integer]
     #
     # @!attribute [rw] protocol
-    #   The protocol.
+    #   The IP protocol name.
+    #
+    #   The name can be one of the following:
+    #
+    #   * `tcp` - Transmission Control Protocol (TCP) provides reliable,
+    #     ordered, and error-checked delivery of streamed data between
+    #     applications running on hosts communicating by an IP network. If
+    #     you have an application that doesn't require reliable data stream
+    #     service, use UDP instead.
+    #
+    #   * `all` - All transport layer protocol types. For more general
+    #     information, see [Transport layer][1] on *Wikipedia*.
+    #
+    #   * `udp` - With User Datagram Protocol (UDP), computer applications
+    #     can send messages (or datagrams) to other hosts on an Internet
+    #     Protocol (IP) network. Prior communications are not required to
+    #     set up transmission channels or data paths. Applications that
+    #     don't require reliable data stream service can use UDP, which
+    #     provides a connectionless datagram service that emphasizes reduced
+    #     latency over reliability. If you do require reliable data stream
+    #     service, use TCP instead.
+    #
+    #   * `icmp` - Internet Control Message Protocol (ICMP) is used to send
+    #     error messages and operational information indicating success or
+    #     failure when communicating with an instance. For example, an error
+    #     is indicated when an instance could not be reached.
+    #
+    #     <note markdown="1"> Ping is the only communication supported through the ICMP protocol
+    #     in Lightsail. To configure ping, specify the `fromPort` parameter
+    #     as `8`, and the `toPort` parameter as `-1`.
+    #
+    #      </note>
+    #
+    #
+    #
+    #   [1]: https://en.wikipedia.org/wiki/Transport_layer
     #   @return [String]
     #
+    # @!attribute [rw] cidrs
+    #   The IP address, or range of IP addresses in CIDR notation, that are
+    #   allowed to connect to an instance through the ports, and the
+    #   protocol. Lightsail supports IPv4 addresses.
+    #
+    #   Examples:
+    #
+    #   * To allow the IP address `192.0.2.44`, specify `192.0.2.44` or
+    #     `192.0.2.44/32`.
+    #
+    #   * To allow the IP addresses `192.0.2.0` to `192.0.2.255`, specify
+    #     `192.0.2.0/24`.
+    #
+    #   For more information about CIDR block notation, see [Classless
+    #   Inter-Domain Routing][1] on *Wikipedia*.
+    #
+    #
+    #
+    #   [1]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#CIDR_notation
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] cidr_list_aliases
+    #   An alias that defines access for a preconfigured range of IP
+    #   addresses.
+    #
+    #   The only alias currently supported is `lightsail-connect`, which
+    #   allows IP addresses of the browser-based RDP/SSH client in the
+    #   Lightsail console to connect to your instance.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PortInfo AWS API Documentation
     #
     class PortInfo < Struct.new(
       :from_port,
       :to_port,
-      :protocol)
+      :protocol,
+      :cidrs,
+      :cidr_list_aliases)
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass PutAlarmRequest
+    #   data as a hash:
+    #
+    #       {
+    #         alarm_name: "ResourceName", # required
+    #         metric_name: "CPUUtilization", # required, accepts CPUUtilization, NetworkIn, NetworkOut, StatusCheckFailed, StatusCheckFailed_Instance, StatusCheckFailed_System, ClientTLSNegotiationErrorCount, HealthyHostCount, UnhealthyHostCount, HTTPCode_LB_4XX_Count, HTTPCode_LB_5XX_Count, HTTPCode_Instance_2XX_Count, HTTPCode_Instance_3XX_Count, HTTPCode_Instance_4XX_Count, HTTPCode_Instance_5XX_Count, InstanceResponseTime, RejectedConnectionCount, RequestCount, DatabaseConnections, DiskQueueDepth, FreeStorageSpace, NetworkReceiveThroughput, NetworkTransmitThroughput, BurstCapacityTime, BurstCapacityPercentage
+    #         monitored_resource_name: "ResourceName", # required
+    #         comparison_operator: "GreaterThanOrEqualToThreshold", # required, accepts GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, LessThanOrEqualToThreshold
+    #         threshold: 1.0, # required
+    #         evaluation_periods: 1, # required
+    #         datapoints_to_alarm: 1,
+    #         treat_missing_data: "breaching", # accepts breaching, notBreaching, ignore, missing
+    #         contact_protocols: ["Email"], # accepts Email, SMS
+    #         notification_triggers: ["OK"], # accepts OK, ALARM, INSUFFICIENT_DATA
+    #         notification_enabled: false,
+    #       }
+    #
+    # @!attribute [rw] alarm_name
+    #   The name for the alarm. Specify the name of an existing alarm to
+    #   update, and overwrite the previous configuration of the alarm.
+    #   @return [String]
+    #
+    # @!attribute [rw] metric_name
+    #   The name of the metric to associate with the alarm.
+    #
+    #   You can configure up to two alarms per metric.
+    #
+    #   The following metrics are available for each resource type:
+    #
+    #   * **Instances**\: `BurstCapacityPercentage`, `BurstCapacityTime`,
+    #     `CPUUtilization`, `NetworkIn`, `NetworkOut`, `StatusCheckFailed`,
+    #     `StatusCheckFailed_Instance`, and `StatusCheckFailed_System`.
+    #
+    #   * **Load balancers**\: `ClientTLSNegotiationErrorCount`,
+    #     `HealthyHostCount`, `UnhealthyHostCount`, `HTTPCode_LB_4XX_Count`,
+    #     `HTTPCode_LB_5XX_Count`, `HTTPCode_Instance_2XX_Count`,
+    #     `HTTPCode_Instance_3XX_Count`, `HTTPCode_Instance_4XX_Count`,
+    #     `HTTPCode_Instance_5XX_Count`, `InstanceResponseTime`,
+    #     `RejectedConnectionCount`, and `RequestCount`.
+    #
+    #   * **Relational databases**\: `CPUUtilization`,
+    #     `DatabaseConnections`, `DiskQueueDepth`, `FreeStorageSpace`,
+    #     `NetworkReceiveThroughput`, and `NetworkTransmitThroughput`.
+    #
+    #   For more information about these metrics, see [Metrics available in
+    #   Lightsail][1].
+    #
+    #
+    #
+    #   [1]: https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-resource-health-metrics#available-metrics
+    #   @return [String]
+    #
+    # @!attribute [rw] monitored_resource_name
+    #   The name of the Lightsail resource that will be monitored.
+    #
+    #   Instances, load balancers, and relational databases are the only
+    #   Lightsail resources that can currently be monitored by alarms.
+    #   @return [String]
+    #
+    # @!attribute [rw] comparison_operator
+    #   The arithmetic operation to use when comparing the specified
+    #   statistic to the threshold. The specified statistic value is used as
+    #   the first operand.
+    #   @return [String]
+    #
+    # @!attribute [rw] threshold
+    #   The value against which the specified statistic is compared.
+    #   @return [Float]
+    #
+    # @!attribute [rw] evaluation_periods
+    #   The number of most recent periods over which data is compared to the
+    #   specified threshold. If you are setting an "M out of N" alarm,
+    #   this value (`evaluationPeriods`) is the N.
+    #
+    #   If you are setting an alarm that requires that a number of
+    #   consecutive data points be breaching to trigger the alarm, this
+    #   value specifies the rolling period of time in which data points are
+    #   evaluated.
+    #
+    #   Each evaluation period is five minutes long. For example, specify an
+    #   evaluation period of 24 to evaluate a metric over a rolling period
+    #   of two hours.
+    #
+    #   You can specify a minimum valuation period of 1 (5 minutes), and a
+    #   maximum evaluation period of 288 (24 hours).
+    #   @return [Integer]
+    #
+    # @!attribute [rw] datapoints_to_alarm
+    #   The number of data points that must be not within the specified
+    #   threshold to trigger the alarm. If you are setting an "M out of N"
+    #   alarm, this value (`datapointsToAlarm`) is the M.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] treat_missing_data
+    #   Sets how this alarm will handle missing data points.
+    #
+    #   An alarm can treat missing data in the following ways:
+    #
+    #   * `breaching` - Assume the missing data is not within the threshold.
+    #     Missing data counts towards the number of times the metric is not
+    #     within the threshold.
+    #
+    #   * `notBreaching` - Assume the missing data is within the threshold.
+    #     Missing data does not count towards the number of times the metric
+    #     is not within the threshold.
+    #
+    #   * `ignore` - Ignore the missing data. Maintains the current alarm
+    #     state.
+    #
+    #   * `missing` - Missing data is treated as missing.
+    #
+    #   If `treatMissingData` is not specified, the default behavior of
+    #   `missing` is used.
+    #   @return [String]
+    #
+    # @!attribute [rw] contact_protocols
+    #   The contact protocols to use for the alarm, such as `Email`, `SMS`
+    #   (text messaging), or both.
+    #
+    #   A notification is sent via the specified contact protocol if
+    #   notifications are enabled for the alarm, and when the alarm is
+    #   triggered.
+    #
+    #   A notification is not sent if a contact protocol is not specified,
+    #   if the specified contact protocol is not configured in the AWS
+    #   Region, or if notifications are not enabled for the alarm using the
+    #   `notificationEnabled` paramater.
+    #
+    #   Use the `CreateContactMethod` action to configure a contact protocol
+    #   in an AWS Region.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] notification_triggers
+    #   The alarm states that trigger a notification.
+    #
+    #   An alarm has the following possible states:
+    #
+    #   * `ALARM` - The metric is outside of the defined threshold.
+    #
+    #   * `INSUFFICIENT_DATA` - The alarm has just started, the metric is
+    #     not available, or not enough data is available for the metric to
+    #     determine the alarm state.
+    #
+    #   * `OK` - The metric is within the defined threshold.
+    #
+    #   When you specify a notification trigger, the `ALARM` state must be
+    #   specified. The `INSUFFICIENT_DATA` and `OK` states can be specified
+    #   in addition to the `ALARM` state.
+    #
+    #   * If you specify `OK` as an alarm trigger, a notification is sent
+    #     when the alarm switches from an `ALARM` or `INSUFFICIENT_DATA`
+    #     alarm state to an `OK` state. This can be thought of as an *all
+    #     clear* alarm notification.
+    #
+    #   * If you specify `INSUFFICIENT_DATA` as the alarm trigger, a
+    #     notification is sent when the alarm switches from an `OK` or
+    #     `ALARM` alarm state to an `INSUFFICIENT_DATA` state.
+    #
+    #   The notification trigger defaults to `ALARM` if you don't specify
+    #   this parameter.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] notification_enabled
+    #   Indicates whether the alarm is enabled.
+    #
+    #   Notifications are enabled by default if you don't specify this
+    #   parameter.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutAlarmRequest AWS API Documentation
+    #
+    class PutAlarmRequest < Struct.new(
+      :alarm_name,
+      :metric_name,
+      :monitored_resource_name,
+      :comparison_operator,
+      :threshold,
+      :evaluation_periods,
+      :datapoints_to_alarm,
+      :treat_missing_data,
+      :contact_protocols,
+      :notification_triggers,
+      :notification_enabled)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] operations
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
+    #   @return [Array<Types::Operation>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutAlarmResult AWS API Documentation
+    #
+    class PutAlarmResult < Struct.new(
+      :operations)
       include Aws::Structure
     end
 
@@ -7143,18 +8540,21 @@ module Aws::Lightsail
     #           {
     #             from_port: 1,
     #             to_port: 1,
-    #             protocol: "tcp", # accepts tcp, all, udp
+    #             protocol: "tcp", # accepts tcp, all, udp, icmp
+    #             cidrs: ["string"],
+    #             cidr_list_aliases: ["string"],
     #           },
     #         ],
     #         instance_name: "ResourceName", # required
     #       }
     #
     # @!attribute [rw] port_infos
-    #   Specifies information about the public port(s).
+    #   An array of objects to describe the ports to open for the specified
+    #   instance.
     #   @return [Array<Types::PortInfo>]
     #
     # @!attribute [rw] instance_name
-    #   The Lightsail instance name of the public port(s) you are setting.
+    #   The name of the instance for which to open ports.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutInstancePublicPortsRequest AWS API Documentation
@@ -7166,7 +8566,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operation
-    #   Describes metadata about the operation you just executed.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutInstancePublicPortsResult AWS API Documentation
@@ -7195,8 +8597,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the request
-    #   operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/RebootInstanceResult AWS API Documentation
@@ -7225,8 +8628,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the result of your reboot relational database
-    #   request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/RebootRelationalDatabaseResult AWS API Documentation
@@ -7790,8 +9194,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the request
-    #   operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/ReleaseStaticIpResult AWS API Documentation
@@ -7820,6 +9225,37 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass SendContactMethodVerificationRequest
+    #   data as a hash:
+    #
+    #       {
+    #         protocol: "Email", # required, accepts Email
+    #       }
+    #
+    # @!attribute [rw] protocol
+    #   The protocol to verify, such as `Email` or `SMS` (text messaging).
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/SendContactMethodVerificationRequest AWS API Documentation
+    #
+    class SendContactMethodVerificationRequest < Struct.new(
+      :protocol)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] operations
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
+    #   @return [Array<Types::Operation>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/SendContactMethodVerificationResult AWS API Documentation
+    #
+    class SendContactMethodVerificationResult < Struct.new(
+      :operations)
+      include Aws::Structure
+    end
+
     # A general service exception.
     #
     # @!attribute [rw] code
@@ -7863,8 +9299,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the request
-    #   operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/StartInstanceResult AWS API Documentation
@@ -7893,8 +9330,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the result of your start relational database
-    #   request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/StartRelationalDatabaseResult AWS API Documentation
@@ -7993,8 +9431,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the request
-    #   operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/StopInstanceResult AWS API Documentation
@@ -8030,8 +9469,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the result of your stop relational database
-    #   request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/StopRelationalDatabaseResult AWS API Documentation
@@ -8118,7 +9558,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   A list of objects describing the API operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/TagResourceResult AWS API Documentation
@@ -8128,6 +9570,53 @@ module Aws::Lightsail
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass TestAlarmRequest
+    #   data as a hash:
+    #
+    #       {
+    #         alarm_name: "ResourceName", # required
+    #         state: "OK", # required, accepts OK, ALARM, INSUFFICIENT_DATA
+    #       }
+    #
+    # @!attribute [rw] alarm_name
+    #   The name of the alarm to test.
+    #   @return [String]
+    #
+    # @!attribute [rw] state
+    #   The alarm state to test.
+    #
+    #   An alarm has the following possible states that can be tested:
+    #
+    #   * `ALARM` - The metric is outside of the defined threshold.
+    #
+    #   * `INSUFFICIENT_DATA` - The alarm has just started, the metric is
+    #     not available, or not enough data is available for the metric to
+    #     determine the alarm state.
+    #
+    #   * `OK` - The metric is within the defined threshold.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/TestAlarmRequest AWS API Documentation
+    #
+    class TestAlarmRequest < Struct.new(
+      :alarm_name,
+      :state)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] operations
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
+    #   @return [Array<Types::Operation>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/TestAlarmResult AWS API Documentation
+    #
+    class TestAlarmResult < Struct.new(
+      :operations)
+      include Aws::Structure
+    end
+
     # Lightsail throws this exception when the user has not been
     # authenticated.
     #
@@ -8160,8 +9649,9 @@ module Aws::Lightsail
     class UnpeerVpcRequest < Aws::EmptyStructure; end
 
     # @!attribute [rw] operation
-    #   An array of key-value pairs containing information about the request
-    #   operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Types::Operation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/UnpeerVpcResult AWS API Documentation
@@ -8203,7 +9693,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   A list of objects describing the API operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/UntagResourceResult AWS API Documentation
@@ -8248,8 +9740,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An array of key-value pairs containing information about the request
-    #   operation.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/UpdateDomainEntryResult AWS API Documentation
@@ -8292,7 +9785,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the API operations.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/UpdateLoadBalancerAttributeResult AWS API Documentation
@@ -8338,8 +9833,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the result of your update relational database
-    #   parameters request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/UpdateRelationalDatabaseParametersResult AWS API Documentation
@@ -8479,8 +9975,9 @@ module Aws::Lightsail
     end
 
     # @!attribute [rw] operations
-    #   An object describing the result of your update relational database
-    #   request.
+    #   An array of objects that describe the result of the action, such as
+    #   the status of the request, the timestamp of the request, and the
+    #   resources affected by the request.
     #   @return [Array<Types::Operation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/UpdateRelationalDatabaseResult AWS API Documentation