Actions, resources, and condition keys for Amazon Health APIs and Notifications
Amazon Health APIs and Notifications (service prefix: health) provides the following
service-specific operations, resources, actions, and condition keys for use in IAM permission
policies.
References:
-
Learn how to configure this service.
-
View a list of the API operations available for this service.
-
Learn how to secure this service and its resources by using IAM permission policies.
-
View the programmatic service authorization reference
for this service.
Topics
API operations defined by Amazon Health APIs and Notifications
The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.
| Operation | IAM action | Condition key | Possible value(s) | Access level |
|---|---|---|---|---|
|
DescribeAffectedAccountsForOrganization |
Read |
|||
List |
||||
|
DescribeAffectedEntities |
Read |
|||
|
DescribeAffectedEntitiesForOrganization |
Read |
|||
List |
||||
|
DescribeEntityAggregates |
Read |
|||
|
DescribeEntityAggregatesForOrganization |
Read |
|||
List |
||||
|
DescribeEventAggregates |
Read |
|||
|
DescribeEventDetails |
Read |
|||
|
DescribeEventDetailsForOrganization |
Read |
|||
List |
||||
|
DescribeEventTypes |
Read |
|||
|
DescribeEvents |
Read |
|||
|
DescribeEventsForOrganization |
Read |
|||
List |
||||
|
DescribeHealthServiceStatusForOrganization |
Read |
|||
List |
||||
|
DisableHealthServiceAccessForOrganization |
Permissions management, Write |
|||
Write |
||||
List |
||||
|
EnableHealthServiceAccessForOrganization |
Permissions management, Write |
|||
Write |
||||
Write |
||||
List |
Actions defined by Amazon Health APIs and Notifications
You can specify the following actions in the Action element of an IAM
policy statement. Use policies to grant permissions to perform an operation in Amazon. When
you use an action in a policy, you usually allow or deny access to the API operation or CLI
command with the same name. However, in some cases, a single action controls access to more
than one operation. Alternatively, some operations require several different actions.
| Actions | Description | Resource types (*required) | Condition keys | Access level |
|---|---|---|---|---|
Grants permission to retrieve a list of accounts that have been affected by the specified events in organization |
Read |
|||
Grants permission to retrieve a list of entities that have been affected by the specified events |
Read |
|||
Grants permission to retrieve a list of entities that have been affected by the specified events and accounts in organization |
Read |
|||
Grants permission to retrieve the number of entities that are affected by each of the specified events |
Read |
|||
Grants permission to retrieve the number of entities that are affected by each of the specified events in an organization |
Read |
|||
Grants permission to retrieve the number of events of each event type (issue, scheduled change, and account notification) |
Read |
|||
Grants permission to retrieve detailed information about one or more specified events |
Read |
|||
Grants permission to retrieve detailed information about one or more specified events for provided accounts in organization |
Read |
|||
Grants permission to retrieve the event types that meet the specified filter criteria |
Read |
|||
Grants permission to retrieve information about events that meet the specified filter criteria |
Read |
|||
Grants permission to retrieve information about events that meet the specified filter criteria in organization |
Read |
|||
Grants permission to retrieve the status of enabling or disabling the Organizational View feature |
Read |
|||
Grants permission to disable the Organizational View feature |
Permissions management, Write |
|||
Grants permission to enable the Organizational View feature |
Permissions management, Write |
Resource types defined by Amazon Health APIs and Notifications
The following resource types are defined by this service and can be used in the
Resource element of IAM permission policy statements.
| Resource types | ARN | Condition keys |
|---|---|---|
arn:${Partition}:health:*::event/${Service}/${EventTypeCode}/* |
Condition keys for Amazon Health APIs and Notifications
Amazon Health APIs and Notifications defines the following condition keys that can be used in the
Condition element of an IAM policy.
| Condition keys | Description | Type |
|---|---|---|
Filters access by event type |
String |
|
Filters access by impacted service |
String |