aws-sdk-health 1.32.0 → 1.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 936fba80fb92d8ef022b98ba518e1bd2ac2f1bb8c7a4f22924c99b85e1e26295
-  data.tar.gz: 87ae5ca5568f90565a2a8d4bf7b54a38795710c4dee5d5ed47e6dbdf92fbbddd
+  metadata.gz: d800aac727d82c251d437f2372c09031fff98e7340a9e4b0cf5beff169a0ce19
+  data.tar.gz: c7cc332f1be7aa0e333e02f12a1dcf2b34670a4fe13140820e5e42708abf89e1
 SHA512:
-  metadata.gz: 82a36b2d0b876aaeb7771ff2542d8169ed76602ba32b03c832829123f4227bf74073bfaa27ba6f6b33374d1ac933b64f0f79781bc754ae0fe94b6c765da22a2d
-  data.tar.gz: c7b312a8a835db6ac2c9089ce55be9a7b7f8bf31ab6377014348c2003cd09f562de6a603cfe9dd660ae9fcee7c36162593433bf5c19bdf46a42bc782ce0b2dd5
+  metadata.gz: e35ed16d14b06ced5d4268b545ff4379bc5c15e1ce24a0de6eaed28ce940de492f04f765f451dc26f86c235faa589324266894c26c5690fdcfb3f93c3fea8bba
+  data.tar.gz: e131e988f3f6c28df37b95c2d97e1f177749066310a8fb751a9e22045a2349532a8f6f38b83160e9ecd7ea7c4a79546bd273877cdad27e546016099cae98db17

data/lib/aws-sdk-health.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-health/customizations'
 # @!group service
 module Aws::Health
 
-  GEM_VERSION = '1.32.0'
+  GEM_VERSION = '1.33.0'
 
 end

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

@@ -344,7 +344,7 @@ module Aws::Health
     # Before you can call this operation, you must first enable AWS Health
     # to work with AWS Organizations. To do this, call the
     # [EnableHealthServiceAccessForOrganization][2] operation from your
-    # organization's master account.
+    # organization's management account.
     #
     # <note markdown="1"> This API operation uses pagination. Specify the `nextToken` parameter
     # in the next request to return more results.
@@ -415,11 +415,20 @@ 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 markdown="1"> * This API operation uses pagination. Specify the `nextToken`
+    #   parameter in the next request to return more results.
+    #
+    # * This operation supports resource-level permissions. You can use this
+    #   operation to allow or deny access to specific AWS Health events. For
+    #   more information, see [Resource- and action-based conditions][1] in
+    #   the *AWS Health User Guide*.
     #
     #  </note>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/ug/security_iam_id-based-policy-examples.html#resource-action-based-conditions
+    #
     # @option params [required, Types::EntityFilter] :filter
     #   Values to narrow the results returned. At least one event ARN is
     #   required.
@@ -507,16 +516,22 @@ module Aws::Health
     # Before you can call this operation, you must first enable AWS Health
     # to work with AWS Organizations. To do this, call the
     # [EnableHealthServiceAccessForOrganization][1] operation from your
-    # organization's master account.
+    # organization's management account.
     #
-    # <note markdown="1"> This API operation uses pagination. Specify the `nextToken` parameter
-    # in the next request to return more results.
+    # <note markdown="1"> * This API operation uses pagination. Specify the `nextToken`
+    #   parameter in the next request to return more results.
+    #
+    # * This operation doesn't support resource-level permissions. You
+    #   can't use this operation to allow or deny access to specific AWS
+    #   Health events. For more information, see [Resource- and action-based
+    #   conditions][2] in the *AWS Health User Guide*.
     #
     #  </note>
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_EnableHealthServiceAccessForOrganization.html
+    # [2]: https://docs.aws.amazon.com/health/latest/ug/security_iam_id-based-policy-examples.html#resource-action-based-conditions
     #
     # @option params [required, Array<Types::EventAccountFilter>] :organization_entity_filters
     #   A JSON set of elements including the `awsAccountId` and the
@@ -713,19 +728,27 @@ 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][1]), a detailed event description, and
-    # possible additional metadata that depends upon the nature of the
+    # Information includes standard event data (AWS 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][2] operation.
     #
     # If a specified event cannot be retrieved, an error message is returned
     # for that event.
     #
+    # <note markdown="1"> This operation supports resource-level permissions. You can use this
+    # operation to allow or deny access to specific AWS Health events. For
+    # more information, see [Resource- and action-based conditions][3] in
+    # the *AWS Health User Guide*.
+    #
+    #  </note>
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEvents.html
     # [2]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeAffectedEntities.html
+    # [3]: https://docs.aws.amazon.com/health/latest/ug/security_iam_id-based-policy-examples.html#resource-action-based-conditions
     #
     # @option params [required, Array<String>] :event_arns
     #   A list of event ARNs (unique identifiers). For example:
@@ -781,7 +804,7 @@ 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
+    # standard event data (AWS Region, service, and so on, as returned by
     # [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
@@ -790,7 +813,7 @@ module Aws::Health
     # Before you can call this operation, you must first enable AWS Health
     # to work with AWS Organizations. To do this, call the
     # [EnableHealthServiceAccessForOrganization][3] operation from your
-    # organization's master account.
+    # organization's management account.
     #
     # When you call the `DescribeEventDetailsForOrganization` operation, you
     # specify the `organizationEventDetailFilters` object in the request.
@@ -809,12 +832,20 @@ module Aws::Health
     #
     # For more information, see [Event][4].
     #
+    # <note markdown="1"> This operation doesn't support resource-level permissions. You can't
+    # use this operation to allow or deny access to specific AWS Health
+    # events. For more information, see [Resource- and action-based
+    # conditions][5] in the *AWS Health User Guide*.
+    #
+    #  </note>
+    #
     #
     #
     # [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
+    # [5]: https://docs.aws.amazon.com/health/latest/ug/security_iam_id-based-policy-examples.html#resource-action-based-conditions
     #
     # @option params [required, Array<Types::EventAccountFilter>] :organization_event_detail_filters
     #   A set of JSON elements that includes the `awsAccountId` and the
@@ -874,15 +905,23 @@ module Aws::Health
       req.send_request(options)
     end
 
-    # Returns the event types that meet the specified filter criteria. If no
-    # filter criteria are specified, all event types are returned, in no
-    # particular order.
+    # Returns the event types that meet the specified filter criteria. You
+    # can use this API operation to find information about the AWS Health
+    # event, such as the category, AWS service, and event code. The metadata
+    # for each event appears in the [EventType][1] object.
+    #
+    # If you don't specify a filter criteria, the API operation returns all
+    # event types, 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>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_EventType.html
+    #
     # @option params [Types::EventTypeFilter] :filter
     #   Values to narrow the results returned.
     #
@@ -1083,7 +1122,7 @@ module Aws::Health
     # 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.
+    # organization's management account.
     #
     # <note markdown="1"> This API operation uses pagination. Specify the `nextToken` parameter
     # in the next request to return more results.
@@ -1180,7 +1219,7 @@ module Aws::Health
     # This operation provides status information on enabling or disabling
     # AWS Health to work with your 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.
+    # root user (not recommended) in the organization's management account.
     #
     # @return [Types::DescribeHealthServiceStatusForOrganizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1202,15 +1241,15 @@ module Aws::Health
     # 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
+    # recommended) in the organization's management 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*.
+    # This operation doesn't remove the service-linked role from the
+    # management account in your organization. You must use the IAM console,
+    # API, or AWS Command Line Interface (AWS CLI) to remove the
+    # service-linked role. 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
@@ -1238,18 +1277,36 @@ module Aws::Health
       req.send_request(options)
     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 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.
+    # Enables AWS Health to work with AWS Organizations. You can use the
+    # organizational view feature to aggregate events from all AWS accounts
+    # in your organization in a centralized location.
     #
-    # For more information, see [Aggregating AWS Health events][1] in the
-    # *AWS Health User Guide*.
+    # This operation also creates a service-linked role for the management
+    # account in the organization.
     #
+    # <note markdown="1"> To call this operation, you must meet the following requirements:
     #
+    #  * You must have a Business or Enterprise support plan from [AWS
+    #   Support][1] to use the AWS Health API. If you call the AWS Health
+    #   API from an AWS account that doesn't have a Business or Enterprise
+    #   support plan, you receive a `SubscriptionRequiredException` error.
     #
-    # [1]: https://docs.aws.amazon.com/health/latest/ug/aggregate-events.html
+    # * You must have permission to call this operation from the
+    #   organization's management account. For example IAM policies, see
+    #   [AWS Health identity-based policy examples][2].
+    #
+    #  </note>
+    #
+    # If you don't have the required support plan, you can instead use the
+    # AWS Health console to enable the organizational view feature. For more
+    # information, see [Aggregating AWS Health events][3] in the *AWS Health
+    # User Guide*.
+    #
+    #
+    #
+    # [1]: http://aws.amazon.com/premiumsupport/
+    # [2]: https://docs.aws.amazon.com/health/latest/ug/security_iam_id-based-policy-examples.html
+    # [3]: https://docs.aws.amazon.com/health/latest/ug/aggregate-events.html
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1275,7 +1332,7 @@ module Aws::Health
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-health'
-      context[:gem_version] = '1.32.0'
+      context[:gem_version] = '1.33.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1341,10 +1341,25 @@ module Aws::Health
       include Aws::Structure
     end
 
-    # Metadata about a type of event that is reported by AWS Health. Data
-    # consists of the category (for example, `issue`), the service (for
-    # example, `EC2`), and the event type code (for example,
-    # `AWS_EC2_SYSTEM_MAINTENANCE_EVENT`).
+    # Contains the metadata about a type of event that is reported by AWS
+    # Health. The `EventType` shows the category, service, and the event
+    # type code of the event. For example, an `issue` might be the category,
+    # `EC2` the service, and `AWS_EC2_SYSTEM_MAINTENANCE_EVENT` the event
+    # type code.
+    #
+    # You can use the [DescribeEventTypes][1] API operation to return this
+    # information about an event.
+    #
+    # You can also use the Amazon CloudWatch Events console to create a rule
+    # so that you can get notified or take action when AWS Health delivers a
+    # specific event to your AWS account. For more information, see [Monitor
+    # for AWS Health events with Amazon CloudWatch Events][2] in the *AWS
+    # Health User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeEventTypes.html
+    # [2]: https://docs.aws.amazon.com/health/latest/ug/cloudwatch-events-health.html
     #
     # @!attribute [rw] service
     #   The AWS service that is affected by the event. For example, `EC2`,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-health
 version: !ruby/object:Gem::Version
-  version: 1.32.0
+  version: 1.33.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-02-02 00:00:00.000000000 Z
+date: 2021-02-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core