aws-sdk-health 1.27.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3bc8ae00dea99726d0d4eb8ddabdc9f76ddd8dab1dc8d84e618de5a10465b455
-  data.tar.gz: f41bdd80e970f08668bcb3f7138997e6c3b6f05a191e98681ff39eb521406c5c
+  metadata.gz: 1d471d435fbec6b47f325f65c663d948c34ce267b6a002245f4d4e68af2a7e9f
+  data.tar.gz: 4a9fc5891f2c3bcbb9461a3c8e1f973972daa06e94e3e24b3a9fb0886d4be111
 SHA512:
-  metadata.gz: 598c5d90ef9fb86c907d64e08d99a8cbdbc2749d6f66a5f05c032f12efc6c68739e57ac8744995bedf59916062d05e6b81d3939302f1bd4f9af3482b750fba6f
-  data.tar.gz: b49cb72b5b8a3af3cfaef4ba2a87e46b0db6eb7272238912e2daabf5923040c9c9f40c98a8b3835ab47b5d60da033af2979aa41a0869093b0f109bdd3cb7bf41
+  metadata.gz: cd1fafd95f921c88370f8b3d1613f088b6d8152cc757ed2f2213a55adffc0464b63afc9f4acb64c72393b78d2484c14ee591c79a6df4dd4d45c40a05d80e1c8f
+  data.tar.gz: 7f8fc7b1e4aa458244aed80e5e25db1b79724da712fc4d59cf5093e68df5eb46698c104f36dff441b0232e3ff9ca04cf74f30f92daecc163897992baffac0776

data/lib/aws-sdk-health.rb

@@ -47,6 +47,6 @@ require_relative 'aws-sdk-health/customizations'
 # @service
 module Aws::Health
 
-  GEM_VERSION = '1.27.0'
+  GEM_VERSION = '1.28.0'
 
 end

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

@@ -323,13 +323,24 @@ module Aws::Health
     # @!group API Operations
 
     # Returns a list of accounts in the organization from AWS Organizations
-    # that are affected by the provided event.
+    # that are affected by the provided event. For more information about
+    # the different types of AWS Health events, see [Event][1].
     #
     # Before you can call this operation, you must first enable AWS Health
     # to work with AWS Organizations. To do this, call the
-    # EnableHealthServiceAccessForOrganization operation from your
+    # [EnableHealthServiceAccessForOrganization][2] operation from your
     # organization's master account.
     #
+    # <note markdown="1"> This API operation uses pagination. Specify the `nextToken` parameter
+    # in the next request to return more results.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_Event.html
+    # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_EnableHealthServiceAccessForOrganization.html
+    #
     # @option params [required, String] :event_arn
     #   The unique identifier for the event. Format:
     #   `arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID
@@ -389,6 +400,11 @@ module Aws::Health
     # At least one event ARN is required. Results are sorted by the
     # `lastUpdatedTime` of the entity, starting with the most recent.
     #
+    # <note markdown="1"> This API operation uses pagination. Specify the `nextToken` parameter
+    # in the next request to return more results.
+    #
+    #  </note>
+    #
     # @option params [required, Types::EntityFilter] :filter
     #   Values to narrow the results returned. At least one event ARN is
     #   required.
@@ -469,14 +485,24 @@ module Aws::Health
     # individual customer resources, groups of customer resources, or any
     # other construct, depending on the AWS service.
     #
-    # At least one event ARN and account ID are required. Results are sorted
-    # by the `lastUpdatedTime` of the entity, starting with the most recent.
+    # At least one event Amazon Resource Name (ARN) and account ID are
+    # required. Results are sorted by the `lastUpdatedTime` of the entity,
+    # starting with the most recent.
     #
     # Before you can call this operation, you must first enable AWS Health
     # to work with AWS Organizations. To do this, call the
-    # EnableHealthServiceAccessForOrganization operation from your
+    # [EnableHealthServiceAccessForOrganization][1] operation from your
     # organization's master account.
     #
+    # <note markdown="1"> This API operation uses pagination. Specify the `nextToken` parameter
+    # in the next request to return more results.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_EnableHealthServiceAccessForOrganization.html
+    #
     # @option params [required, Array<Types::EventAccountFilter>] :organization_entity_filters
     #   A JSON set of elements including the `awsAccountId` and the
     #   `eventArn`.
@@ -584,6 +610,11 @@ module Aws::Health
     # change, and account notification). If no filter is specified, the
     # counts of all events in each category are returned.
     #
+    # <note markdown="1"> This API operation uses pagination. Specify the `nextToken` parameter
+    # in the next request to return more results.
+    #
+    #  </note>
+    #
     # @option params [Types::EventFilter] :filter
     #   Values to narrow the results returned.
     #
@@ -667,15 +698,20 @@ module Aws::Health
     end
 
     # Returns detailed information about one or more specified events.
-    # Information includes standard event data (region, service, and so on,
-    # as returned by DescribeEvents), a detailed event description, and
+    # Information includes standard event data (Region, service, and so on,
+    # as returned by [DescribeEvents][1]), a detailed event description, and
     # possible additional metadata that depends upon the nature of the
-    # event. Affected entities are not included; to retrieve those, use the
-    # DescribeAffectedEntities operation.
+    # event. Affected entities are not included. To retrieve those, use the
+    # [DescribeAffectedEntities][2] operation.
     #
     # If a specified event cannot be retrieved, an error message is returned
     # for that event.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEvents.html
+    # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeAffectedEntities.html
+    #
     # @option params [required, Array<String>] :event_arns
     #   A list of event ARNs (unique identifiers). For example:
     #   `"arn:aws:health:us-east-1::event/EC2/EC2_INSTANCE_RETIREMENT_SCHEDULED/EC2_INSTANCE_RETIREMENT_SCHEDULED_ABC123-CDE456",
@@ -731,16 +767,40 @@ module Aws::Health
     # Returns detailed information about one or more specified events for
     # one or more accounts in your organization. Information includes
     # standard event data (Region, service, and so on, as returned by
-    # DescribeEventsForOrganization, a detailed event description, and
+    # [DescribeEventsForOrganization][1]), a detailed event description, and
     # possible additional metadata that depends upon the nature of the
     # event. Affected entities are not included; to retrieve those, use the
-    # DescribeAffectedEntitiesForOrganization operation.
+    # [DescribeAffectedEntitiesForOrganization][2] operation.
     #
     # Before you can call this operation, you must first enable AWS Health
     # to work with AWS Organizations. To do this, call the
-    # EnableHealthServiceAccessForOrganization operation from your
+    # [EnableHealthServiceAccessForOrganization][3] operation from your
     # organization's master account.
     #
+    # When you call the `DescribeEventDetailsForOrganization` operation, you
+    # specify the `organizationEventDetailFilters` object in the request.
+    # Depending on the AWS Health event type, note the following
+    # differences:
+    #
+    # * If the event is public, the `awsAccountId` parameter must be empty.
+    #   If you specify an account ID for a public event, then an error
+    #   message is returned. That's because the event might apply to all
+    #   AWS accounts and isn't specific to an account in your organization.
+    #
+    # * If the event is specific to an account, then you must specify the
+    #   `awsAccountId` parameter in the request. If you don't specify an
+    #   account ID, an error message returns because the event is specific
+    #   to an AWS account in your organization.
+    #
+    # For more information, see [Event][4].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventsForOrganization.html
+    # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeAffectedEntitiesForOrganization.html
+    # [3]: https://docs.aws.amazon.com/health/latest/APIReference/API_EnableHealthServiceAccessForOrganization.html
+    # [4]: https://docs.aws.amazon.com/health/latest/APIReference/API_Event.html
+    #
     # @option params [required, Array<Types::EventAccountFilter>] :organization_event_detail_filters
     #   A set of JSON elements that includes the `awsAccountId` and the
     #   `eventArn`.
@@ -803,6 +863,11 @@ module Aws::Health
     # filter criteria are specified, all event types are returned, in no
     # particular order.
     #
+    # <note markdown="1"> This API operation uses pagination. Specify the `nextToken` parameter
+    # in the next request to return more results.
+    #
+    #  </note>
+    #
     # @option params [Types::EventTypeFilter] :filter
     #   Values to narrow the results returned.
     #
@@ -862,10 +927,31 @@ module Aws::Health
     # criteria. Events are returned in a summary form and do not include the
     # detailed description, any additional metadata that depends on the
     # event type, or any affected resources. To retrieve that information,
-    # use the DescribeEventDetails and DescribeAffectedEntities operations.
+    # use the [DescribeEventDetails][1] and [DescribeAffectedEntities][2]
+    # operations.
     #
     # If no filter criteria are specified, all events are returned. Results
-    # are sorted by `lastModifiedTime`, starting with the most recent.
+    # are sorted by `lastModifiedTime`, starting with the most recent event.
+    #
+    # <note markdown="1"> * When you call the `DescribeEvents` operation and specify an entity
+    #   for the `entityValues` parameter, AWS Health might return public
+    #   events that aren't specific to that resource. For example, if you
+    #   call `DescribeEvents` and specify an ID for an Amazon Elastic
+    #   Compute Cloud (Amazon EC2) instance, AWS Health might return events
+    #   that aren't specific to that resource or service. To get events
+    #   that are specific to a service, use the `services` parameter in the
+    #   `filter` object. For more information, see [Event][3].
+    #
+    # * This API operation uses pagination. Specify the `nextToken`
+    #   parameter in the next request to return more results.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventDetails.html
+    # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeAffectedEntities.html
+    # [3]: https://docs.aws.amazon.com/health/latest/APIReference/API_Event.html
     #
     # @option params [Types::EventFilter] :filter
     #   Values to narrow the results returned.
@@ -960,22 +1046,42 @@ module Aws::Health
     end
 
     # Returns information about events across your organization in AWS
-    # Organizations, meeting the specified filter criteria. Events are
-    # returned in a summary form and do not include the accounts impacted,
-    # detailed description, any additional metadata that depends on the
-    # event type, or any affected resources. To retrieve that information,
-    # use the DescribeAffectedAccountsForOrganization,
-    # DescribeEventDetailsForOrganization, and
-    # DescribeAffectedEntitiesForOrganization operations.
+    # Organizations. You can use the`filters` parameter to specify the
+    # events that you want to return. Events are returned in a summary form
+    # and don't include the affected accounts, detailed description, any
+    # additional metadata that depends on the event type, or any affected
+    # resources. To retrieve that information, use the following operations:
     #
-    # If no filter criteria are specified, all events across your
-    # organization are returned. Results are sorted by `lastModifiedTime`,
-    # starting with the most recent.
+    # * [DescribeAffectedAccountsForOrganization][1]
     #
-    # Before you can call this operation, you must first enable Health to
-    # work with AWS Organizations. To do this, call the
-    # EnableHealthServiceAccessForOrganization operation from your
-    # organization's master account.
+    # * [DescribeEventDetailsForOrganization][2]
+    #
+    # * [DescribeAffectedEntitiesForOrganization][3]
+    #
+    # If you don't specify a `filter`, the `DescribeEventsForOrganizations`
+    # returns all events across your organization. Results are sorted by
+    # `lastModifiedTime`, starting with the most recent event.
+    #
+    # For more information about the different types of AWS Health events,
+    # see [Event][4].
+    #
+    # Before you can call this operation, you must first enable AWS Health
+    # to work with AWS Organizations. To do this, call the
+    # [EnableHealthServiceAccessForOrganization][5] operation from your
+    # organization's master AWS account.
+    #
+    # <note markdown="1"> This API operation uses pagination. Specify the `nextToken` parameter
+    # in the next request to return more results.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeAffectedAccountsForOrganization.html
+    # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventDetailsForOrganization.html
+    # [3]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeAffectedEntitiesForOrganization.html
+    # [4]: https://docs.aws.amazon.com/health/latest/APIReference/API_Event.html
+    # [5]: https://docs.aws.amazon.com/health/latest/APIReference/API_EnableHealthServiceAccessForOrganization.html
     #
     # @option params [Types::OrganizationEventFilter] :filter
     #   Values to narrow the results returned.
@@ -1078,12 +1184,33 @@ module Aws::Health
       req.send_request(options)
     end
 
-    # Calling this operation disables Health from working with AWS
-    # Organizations. This does not remove the Service Linked Role (SLR) from
-    # the the master account in your organization. Use the IAM console, API,
-    # or AWS CLI to remove the SLR if desired. To call this operation, you
-    # must sign in as an IAM user, assume an IAM role, or sign in as the
-    # root user (not recommended) in the organization's master account.
+    # Disables AWS Health from working with AWS Organizations. To call this
+    # operation, you must sign in as an AWS Identity and Access Management
+    # (IAM) user, assume an IAM role, or sign in as the root user (not
+    # recommended) in the organization's master AWS account. For more
+    # information, see [Aggregating AWS Health events][1] in the *AWS Health
+    # User Guide*.
+    #
+    # This operation doesn't remove the service-linked role (SLR) from the
+    # AWS master account in your organization. You must use the IAM console,
+    # API, or AWS Command Line Interface (AWS CLI) to remove the SLR. For
+    # more information, see [Deleting a Service-Linked Role][2] in the *IAM
+    # User Guide*.
+    #
+    # <note markdown="1"> You can also disable the organizational feature by using the
+    # Organizations [DisableAWSServiceAccess][3] API operation. After you
+    # call this operation, AWS Health stops aggregating events for all other
+    # AWS accounts in your organization. If you call the AWS Health API
+    # operations for organizational view, AWS Health returns an error. AWS
+    # Health continues to aggregate health events for your AWS account.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/ug/aggregate-events.html
+    # [2]: https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role
+    # [3]: https://docs.aws.amazon.com/organizations/latest/APIReference/API_DisableAWSServiceAccess.html
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1097,13 +1224,18 @@ module Aws::Health
     end
 
     # Calling this operation enables AWS Health to work with AWS
-    # Organizations. This applies a Service Linked Role (SLR) to the master
-    # account in the organization. To learn more about the steps in this
-    # process, visit enabling service access for AWS Health in AWS
-    # Organizations. To call this operation, you must sign in as an IAM
-    # user, assume an IAM role, or sign in as the root user (not
+    # Organizations. This applies a service-linked role (SLR) to the master
+    # account in the organization. To call this operation, you must sign in
+    # as an IAM user, assume an IAM role, or sign in as the root user (not
     # recommended) in the organization's master account.
     #
+    # For more information, see [Aggregating AWS Health events][1] in the
+    # *AWS Health User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/ug/aggregate-events.html
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/health-2016-08-04/EnableHealthServiceAccessForOrganization AWS API Documentation
@@ -1128,7 +1260,7 @@ module Aws::Health
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-health'
-      context[:gem_version] = '1.27.0'
+      context[:gem_version] = '1.28.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -49,6 +49,10 @@ module Aws::Health
     #
     # @!attribute [rw] tags
     #   A map of entity tags attached to the affected entity.
+    #
+    #   <note markdown="1"> Currently, the `tags` property isn't supported.
+    #
+    #    </note>
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/health-2016-08-04/AffectedEntity AWS API Documentation
@@ -66,9 +70,15 @@ module Aws::Health
       include Aws::Structure
     end
 
-    # EnableHealthServiceAccessForOrganization is already in progress. Wait
-    # for the action to complete before trying again. To get the current
-    # status, use the DescribeHealthServiceStatusForOrganization operation.
+    # [EnableHealthServiceAccessForOrganization][1] is already in progress.
+    # Wait for the action to complete before trying again. To get the
+    # current status, use the
+    # [DescribeHealthServiceStatusForOrganization][2] operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_EnableHealthServiceAccessForOrganization.html
+    # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeHealthServiceStatusForOrganization.html
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -81,13 +91,18 @@ module Aws::Health
       include Aws::Structure
     end
 
-    # A range of dates and times that is used by the EventFilter and
-    # EntityFilter objects. If `from` is set and `to` is set: match items
-    # where the timestamp (`startTime`, `endTime`, or `lastUpdatedTime`) is
-    # between `from` and `to` inclusive. If `from` is set and `to` is not
-    # set: match items where the timestamp value is equal to or after
-    # `from`. If `from` is not set and `to` is set: match items where the
-    # timestamp value is equal to or before `to`.
+    # A range of dates and times that is used by the [EventFilter][1] and
+    # [EntityFilter][2] objects. If `from` is set and `to` is set: match
+    # items where the timestamp (`startTime`, `endTime`, or
+    # `lastUpdatedTime`) is between `from` and `to` inclusive. If `from` is
+    # set and `to` is not set: match items where the timestamp value is
+    # equal to or after `from`. If `from` is not set and `to` is set: match
+    # items where the timestamp value is equal to or before `to`.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_EventFilter.html
+    # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_EntityFilter.html
     #
     # @note When making an API call, you may pass DateTimeRange
     #   data as a hash:
@@ -158,6 +173,20 @@ module Aws::Health
     #   @return [Array<String>]
     #
     # @!attribute [rw] event_scope_code
+    #   This parameter specifies if the AWS Health event is a public AWS
+    #   service event or an account-specific event.
+    #
+    #   * If the `eventScopeCode` value is `PUBLIC`, then the
+    #     `affectedAccounts` value is always empty.
+    #
+    #   * If the `eventScopeCode` value is `ACCOUNT_SPECIFIC`, then the
+    #     `affectedAccounts` value lists the affected AWS accounts in your
+    #     organization. For example, if an event affects a service such as
+    #     Amazon Elastic Compute Cloud and you have AWS accounts that use
+    #     that service, those account IDs appear in the response.
+    #
+    #   * If the `eventScopeCode` value is `NONE`, then the `eventArn` that
+    #     you specified in the request is invalid or doesn't exist.
     #   @return [String]
     #
     # @!attribute [rw] next_token
@@ -230,7 +259,7 @@ module Aws::Health
     # @!attribute [rw] entities
     #   A JSON set of elements including the `awsAccountId` and its
     #   `entityArn`, `entityValue` and its `entityArn`, `lastUpdatedTime`,
-    #   `statusCode`, and `tags`.
+    #   and `statusCode`.
     #   @return [Array<Types::AffectedEntity>]
     #
     # @!attribute [rw] failed_set
@@ -833,7 +862,11 @@ module Aws::Health
     end
 
     # The number of entities that are affected by one or more events.
-    # Returned by the DescribeEntityAggregates operation.
+    # Returned by the [DescribeEntityAggregates][1] operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEntityAggregates.html
     #
     # @!attribute [rw] event_arn
     #   The unique identifier for the event. Format:
@@ -843,7 +876,7 @@ module Aws::Health
     #   @return [String]
     #
     # @!attribute [rw] count
-    #   The number entities that match the criteria for the specified
+    #   The number of entities that match the criteria for the specified
     #   events.
     #   @return [Integer]
     #
@@ -856,9 +889,13 @@ module Aws::Health
       include Aws::Structure
     end
 
-    # The values to use to filter results from the DescribeAffectedEntities
+    # The values to use to filter results from the [EntityFilter][1]
     # operation.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_EntityFilter.html
+    #
     # @note When making an API call, you may pass EntityFilter
     #   data as a hash:
     #
@@ -901,6 +938,10 @@ module Aws::Health
     #
     # @!attribute [rw] tags
     #   A map of entity tags attached to the affected entity.
+    #
+    #   <note markdown="1"> Currently, the `tags` property isn't supported.
+    #
+    #    </note>
     #   @return [Array<Hash<String,String>>]
     #
     # @!attribute [rw] status_codes
@@ -923,6 +964,27 @@ module Aws::Health
 
     # Summary information about an AWS Health event.
     #
+    # AWS Health events can be public or account-specific:
+    #
+    # * *Public events* might be service events that are not specific to an
+    #   AWS account. For example, if there is an issue with an AWS Region,
+    #   AWS Health provides information about the event, even if you don't
+    #   use services or resources in that Region.
+    #
+    # * *Account-specific* events are specific to either your AWS account or
+    #   an account in your organization. For example, if there's an issue
+    #   with Amazon Elastic Compute Cloud in a Region that you use, AWS
+    #   Health provides information about the event and the affected
+    #   resources in the account.
+    #
+    # You can determine if an event is public or account-specific by using
+    # the `eventScopeCode` parameter. For more information, see
+    # [eventScopeCode][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_Event.html#AWSHealth-Type-Event-eventScopeCode
+    #
     # @!attribute [rw] arn
     #   The unique identifier for the event. Format:
     #   `arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID
@@ -972,6 +1034,20 @@ module Aws::Health
     #   @return [String]
     #
     # @!attribute [rw] event_scope_code
+    #   This parameter specifies if the AWS Health event is a public AWS
+    #   service event or an account-specific event.
+    #
+    #   * If the `eventScopeCode` value is `PUBLIC`, then the
+    #     `affectedAccounts` value is always empty.
+    #
+    #   * If the `eventScopeCode` value is `ACCOUNT_SPECIFIC`, then the
+    #     `affectedAccounts` value lists the affected AWS accounts in your
+    #     organization. For example, if an event affects a service such as
+    #     Amazon Elastic Compute Cloud and you have AWS accounts that use
+    #     that service, those account IDs appear in the response.
+    #
+    #   * If the `eventScopeCode` value is `NONE`, then the `eventArn` that
+    #     you specified in the request is invalid or doesn't exist.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/health-2016-08-04/Event AWS API Documentation
@@ -993,8 +1069,13 @@ module Aws::Health
     end
 
     # The values used to filter results from the
-    # DescribeEventDetailsForOrganization and
-    # DescribeAffectedEntitiesForOrganization operations.
+    # [DescribeEventDetailsForOrganization][1] and
+    # [DescribeAffectedEntitiesForOrganization][2] operations.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventDetailsForOrganization.html
+    # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeAffectedEntitiesForOrganization.html
     #
     # @note When making an API call, you may pass EventAccountFilter
     #   data as a hash:
@@ -1026,7 +1107,11 @@ module Aws::Health
     end
 
     # The number of events of each issue type. Returned by the
-    # DescribeEventAggregates operation.
+    # [DescribeEventAggregates][1] operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventAggregates.html
     #
     # @!attribute [rw] aggregate_value
     #   The issue type for the associated count.
@@ -1046,7 +1131,11 @@ module Aws::Health
     end
 
     # The detailed description of the event. Included in the information
-    # returned by the DescribeEventDetails operation.
+    # returned by the [DescribeEventDetails][1] operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventDetails.html
     #
     # @!attribute [rw] latest_description
     #   The most recent description of the event.
@@ -1060,9 +1149,15 @@ module Aws::Health
       include Aws::Structure
     end
 
-    # Detailed information about an event. A combination of an Event object,
-    # an EventDescription object, and additional metadata about the event.
-    # Returned by the DescribeEventDetails operation.
+    # Detailed information about an event. A combination of an [Event][1]
+    # object, an [EventDescription][2] object, and additional metadata about
+    # the event. Returned by the [DescribeEventDetails][3] operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_Event.html
+    # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_EventDescription.html
+    # [3]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventDetails.html
     #
     # @!attribute [rw] event
     #   Summary information about the event.
@@ -1086,9 +1181,13 @@ module Aws::Health
       include Aws::Structure
     end
 
-    # Error information returned when a DescribeEventDetails operation
+    # Error information returned when a [DescribeEventDetails][1] operation
     # cannot find a specified event.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventDetails.html
+    #
     # @!attribute [rw] event_arn
     #   The unique identifier for the event. Format:
     #   `arn:aws:health:event-region::event/SERVICE/EVENT_TYPE_CODE/EVENT_TYPE_PLUS_ID
@@ -1114,8 +1213,13 @@ module Aws::Health
       include Aws::Structure
     end
 
-    # The values to use to filter results from the DescribeEvents and
-    # DescribeEventAggregates operations.
+    # The values to use to filter results from the [DescribeEvents][1] and
+    # [DescribeEventAggregates][2] operations.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEvents.html
+    # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventAggregates.html
     #
     # @note When making an API call, you may pass EventFilter
     #   data as a hash:
@@ -1207,6 +1311,10 @@ module Aws::Health
     #
     # @!attribute [rw] tags
     #   A map of entity tags attached to the affected entity.
+    #
+    #   <note markdown="1"> Currently, the `tags` property isn't supported.
+    #
+    #    </note>
     #   @return [Array<Hash<String,String>>]
     #
     # @!attribute [rw] event_status_codes
@@ -1264,9 +1372,13 @@ module Aws::Health
       include Aws::Structure
     end
 
-    # The values to use to filter results from the DescribeEventTypes
+    # The values to use to filter results from the [DescribeEventTypes][1]
     # operation.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventTypes.html
+    #
     # @note When making an API call, you may pass EventTypeFilter
     #   data as a hash:
     #
@@ -1314,9 +1426,13 @@ module Aws::Health
     end
 
     # Error information returned when a
-    # DescribeAffectedEntitiesForOrganization operation cannot find or
+    # [DescribeAffectedEntitiesForOrganization][1] operation cannot find or
     # process a specific entity.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeAffectedEntitiesForOrganization.html
+    #
     # @!attribute [rw] aws_account_id
     #   The 12-digit AWS account numbers that contains the affected
     #   entities.
@@ -1351,7 +1467,11 @@ module Aws::Health
     end
 
     # Summary information about an event, returned by the
-    # DescribeEventsForOrganization operation.
+    # [DescribeEventsForOrganization][1] operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventsForOrganization.html
     #
     # @!attribute [rw] arn
     #   The unique identifier for the event. Format:
@@ -1376,6 +1496,20 @@ module Aws::Health
     #   @return [String]
     #
     # @!attribute [rw] event_scope_code
+    #   This parameter specifies if the AWS Health event is a public AWS
+    #   service event or an account-specific event.
+    #
+    #   * If the `eventScopeCode` value is `PUBLIC`, then the
+    #     `affectedAccounts` value is always empty.
+    #
+    #   * If the `eventScopeCode` value is `ACCOUNT_SPECIFIC`, then the
+    #     `affectedAccounts` value lists the affected AWS accounts in your
+    #     organization. For example, if an event affects a service such as
+    #     Amazon Elastic Compute Cloud and you have AWS accounts that use
+    #     that service, those account IDs appear in the response.
+    #
+    #   * If the `eventScopeCode` value is `NONE`, then the `eventArn` that
+    #     you specified in the request is invalid or doesn't exist.
     #   @return [String]
     #
     # @!attribute [rw] region
@@ -1416,9 +1550,16 @@ module Aws::Health
       include Aws::Structure
     end
 
-    # Detailed information about an event. A combination of an Event object,
-    # an EventDescription object, and additional metadata about the event.
-    # Returned by the DescribeEventDetailsForOrganization operation.
+    # Detailed information about an event. A combination of an [Event][1]
+    # object, an [EventDescription][2] object, and additional metadata about
+    # the event. Returned by the [DescribeEventDetailsForOrganization][3]
+    # operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_Event.html
+    # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_EventDescription.html
+    # [3]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventDetailsForOrganization.html
     #
     # @!attribute [rw] aws_account_id
     #   The 12-digit AWS account numbers that contains the affected
@@ -1427,11 +1568,36 @@ module Aws::Health
     #
     # @!attribute [rw] event
     #   Summary information about an AWS Health event.
+    #
+    #   AWS Health events can be public or account-specific:
+    #
+    #   * *Public events* might be service events that are not specific to
+    #     an AWS account. For example, if there is an issue with an AWS
+    #     Region, AWS Health provides information about the event, even if
+    #     you don't use services or resources in that Region.
+    #
+    #   * *Account-specific* events are specific to either your AWS account
+    #     or an account in your organization. For example, if there's an
+    #     issue with Amazon Elastic Compute Cloud in a Region that you use,
+    #     AWS Health provides information about the event and the affected
+    #     resources in the account.
+    #
+    #   You can determine if an event is public or account-specific by using
+    #   the `eventScopeCode` parameter. For more information, see
+    #   [eventScopeCode][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_Event.html#AWSHealth-Type-Event-eventScopeCode
     #   @return [Types::Event]
     #
     # @!attribute [rw] event_description
     #   The detailed description of the event. Included in the information
-    #   returned by the DescribeEventDetails operation.
+    #   returned by the [DescribeEventDetails][1] operation.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventDetails.html
     #   @return [Types::EventDescription]
     #
     # @!attribute [rw] event_metadata
@@ -1449,13 +1615,22 @@ module Aws::Health
       include Aws::Structure
     end
 
-    # Error information returned when a DescribeEventDetailsForOrganization
-    # operation cannot find a specified event.
+    # Error information returned when a
+    # [DescribeEventDetailsForOrganization][1] operation cannot find a
+    # specified event.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventDetailsForOrganization.html
     #
     # @!attribute [rw] aws_account_id
     #   Error information returned when a
-    #   DescribeEventDetailsForOrganization operation cannot find a
+    #   [DescribeEventDetailsForOrganization][1] operation cannot find a
     #   specified event.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventDetailsForOrganization.html
     #   @return [String]
     #
     # @!attribute [rw] event_arn
@@ -1484,8 +1659,12 @@ module Aws::Health
       include Aws::Structure
     end
 
-    # The values to filter results from the DescribeEventsForOrganization
-    # operation.
+    # The values to filter results from the
+    # [DescribeEventsForOrganization][1] operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventsForOrganization.html
     #
     # @note When making an API call, you may pass OrganizationEventFilter
     #   data as a hash:
@@ -1533,37 +1712,52 @@ module Aws::Health
     #   @return [Array<String>]
     #
     # @!attribute [rw] start_time
-    #   A range of dates and times that is used by the EventFilter and
-    #   EntityFilter objects. If `from` is set and `to` is set: match items
-    #   where the timestamp (`startTime`, `endTime`, or `lastUpdatedTime`)
-    #   is between `from` and `to` inclusive. If `from` is set and `to` is
-    #   not set: match items where the timestamp value is equal to or after
-    #   `from`. If `from` is not set and `to` is set: match items where the
-    #   timestamp value is equal to or before `to`.
+    #   A range of dates and times that is used by the [EventFilter][1] and
+    #   [EntityFilter][2] objects. If `from` is set and `to` is set: match
+    #   items where the timestamp (`startTime`, `endTime`, or
+    #   `lastUpdatedTime`) is between `from` and `to` inclusive. If `from`
+    #   is set and `to` is not set: match items where the timestamp value is
+    #   equal to or after `from`. If `from` is not set and `to` is set:
+    #   match items where the timestamp value is equal to or before `to`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_EventFilter.html
+    #   [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_EntityFilter.html
     #   @return [Types::DateTimeRange]
     #
     # @!attribute [rw] end_time
-    #   A range of dates and times that is used by the EventFilter and
-    #   EntityFilter objects. If `from` is set and `to` is set: match items
-    #   where the timestamp (`startTime`, `endTime`, or `lastUpdatedTime`)
-    #   is between `from` and `to` inclusive. If `from` is set and `to` is
-    #   not set: match items where the timestamp value is equal to or after
-    #   `from`. If `from` is not set and `to` is set: match items where the
-    #   timestamp value is equal to or before `to`.
+    #   A range of dates and times that is used by the [EventFilter][1] and
+    #   [EntityFilter][2] objects. If `from` is set and `to` is set: match
+    #   items where the timestamp (`startTime`, `endTime`, or
+    #   `lastUpdatedTime`) is between `from` and `to` inclusive. If `from`
+    #   is set and `to` is not set: match items where the timestamp value is
+    #   equal to or after `from`. If `from` is not set and `to` is set:
+    #   match items where the timestamp value is equal to or before `to`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_EventFilter.html
+    #   [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_EntityFilter.html
     #   @return [Types::DateTimeRange]
     #
     # @!attribute [rw] last_updated_time
-    #   A range of dates and times that is used by the EventFilter and
-    #   EntityFilter objects. If `from` is set and `to` is set: match items
-    #   where the timestamp (`startTime`, `endTime`, or `lastUpdatedTime`)
-    #   is between `from` and `to` inclusive. If `from` is set and `to` is
-    #   not set: match items where the timestamp value is equal to or after
-    #   `from`. If `from` is not set and `to` is set: match items where the
-    #   timestamp value is equal to or before `to`.
+    #   A range of dates and times that is used by the [EventFilter][1] and
+    #   [EntityFilter][2] objects. If `from` is set and `to` is set: match
+    #   items where the timestamp (`startTime`, `endTime`, or
+    #   `lastUpdatedTime`) is between `from` and `to` inclusive. If `from`
+    #   is set and `to` is not set: match items where the timestamp value is
+    #   equal to or after `from`. If `from` is not set and `to` is set:
+    #   match items where the timestamp value is equal to or before `to`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_EventFilter.html
+    #   [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_EntityFilter.html
     #   @return [Types::DateTimeRange]
     #
     # @!attribute [rw] entity_arns
-    #   REPLACEME
+    #   A list of entity ARNs (unique identifiers).
     #   @return [Array<String>]
     #
     # @!attribute [rw] entity_values
@@ -1572,7 +1766,8 @@ module Aws::Health
     #   @return [Array<String>]
     #
     # @!attribute [rw] event_type_categories
-    #   REPLACEME
+    #   A list of event type category codes (issue, scheduledChange, or
+    #   accountNotification).
     #   @return [Array<String>]
     #
     # @!attribute [rw] event_status_codes

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-health
 version: !ruby/object:Gem::Version
-  version: 1.27.0
+  version: 1.28.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-23 00:00:00.000000000 Z
+date: 2020-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core