本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
组织视图 (CLI)
您也可以通过 Amazon Command Line Interface (Amazon CLI) 而不是 Amazon Health 控制台启用组织视图功能。要使用控制台,请参阅 启用组织视图(控制台)。
注意
如果允许用户访问管理账户以使用组织视图功能,则他们必须拥有诸如 AWSHealthFullAccess
启用组织视图 (CLI)
只能通过使用 EnableHealthServiceAccessForOrganization API 操作来启用组织视图。
您可以使用 Amazon Command Line Interface (Amazon CLI) 或自己的代码来调用此操作。
注意
-
您必须拥有商业
、Enterprise On-Ramp 或企业 Support 计划才能调用 Amazon Health API。 -
您必须使用美国东部(弗吉尼亚州北部)区域端点。
以下 Amazon CLI 命令从 Amazon 账户启用此功能。您可以从管理账户或从可担任具有所需权限的角色的账户使用此命令。
aws health enable-health-service-access-for-organization --region us-east-1
以下代码示例调用 EnableHealthServiceAccessForOrganization API 操作。
启用此功能时,AWSServiceRoleForHealth_Organizations
服务相关角色和 Health_OrganizationsServiceRolePolicy
Amazon 托管式策略将应用于组织中的管理账户。
注意
启用此功能是一个异步过程,需要花点时间才能完成。您可以调用 DescribeHealthServiceStatusForOrganization 操作以检查该过程的状态。
查看组织视图事件 (CLI)
启用此功能后,Amazon Health 会开始记录影响组织中账户的事件。当某个账户加入您的组织时,Amazon Health 会自动将该账户添加到组织视图中。
注意
Amazon Health 不会记录您启用组织视图之前组织中发生的事件。
当某个账户离开您的组织时,该账户中的新事件将不再记录到组织视图中。但是,现有事件将保留,您仍可以查询它们,直到达到 90 天限制。
您可以使用 Amazon Health API 操作从组织视图返回事件。
例 :描述组织视图事件
以下 Amazon CLI 命令返回组织中 Amazon 账户的运行状况事件。
aws health describe-events-for-organization --region us-east-1
有关其他 Amazon Health API 操作,请参阅以下部分。
禁用组织视图 (CLI)
您可以通过使用 DisableHealthServiceAccessForOrganization API 操作来禁用组织视图。
以下 Amazon CLI 命令从您的账户禁用此功能。
aws health disable-health-service-access-for-organization --region us-east-1
注意
您也可以通过使用 Organizations DisableAWSServiceAccess API 操作来禁用组织功能。调用此操作后,Amazon Health 会停止聚合组织中所有其他账户的事件。如果您为组织视图调用 Amazon Health API 操作,则 Amazon Health 会返回错误。Amazon Health 会继续为 Amazon 账户聚合运行状况事件。
禁用此功能后,Amazon Health 不再聚合来自组织的事件。但是,服务相关角色保留在管理账户中,直到您通过 Amazon Identity and Access Management (IAM) 控制台、IAM API 或 Amazon CLI 将其删除为止。有关更多信息,请参阅 IAM 用户指南中的删除服务相关角色。
Amazon Health 组织视图 API 操作
您可以将以下 Amazon Health API 操作用于组织视图:
-
DescribeEventsForOrganization – 返回有关组织中事件的摘要信息。
-
DescribeAffectedAccountsForOrganization – 返回组织中受指定事件影响的 Amazon 账户的列表。
-
DescribeEventDetailsForOrganization – 返回有关组织中一个或多个账户的指定事件的详细信息。
-
DescribeAffectedEntitiesForOrganization – 返回组织中一个或多个账户受到一个或多个事件影响的实体列表。
可使用以下操作来允许或禁止 Amazon Health 与组织结合使用:
-
EnableHealthServiceAccessForOrganization – 授予 Amazon Health 与组织互动的权限,并将 SLR 应用于组织中的管理账户。
-
DisableHealthServiceAccessForOrganization – 撤消 Amazon Health 与组织互动的权限。
-
DescribeHealthServiceStatusForOrganization – 返回有关是否为组织启用 Amazon Health 的状态信息。
您必须拥有商业、Enterprise On-Ramp 或企业 Support 计划才能调用这些 API 操作。如果您从至少具有商业支持计划的账户调用 DescribeEventForOrganization
和 DescribeAffectedAccountsForOrganization
操作,则可以返回有关组织中任何账户的信息,而不必考虑各个账户的支持级别。请见以下示例。
例 示例:组织包含具有商业和开发人员支持计划的账户
-
您的组织中有三个账户。管理账户具有商业支持计划,而另两个账户具有开发人员支持计划。
-
您可以从管理账户或从可使用所需权限担任角色的账户调用
DescribeEventForOrganization
API 操作。 -
Amazon Health 返回所有三个账户的信息。
如果您从至少具有商业支持计划的账户调用 DescribeEventDetailsForOrganization
和 DescribeAffectedEntitiesForOrganization
API 操作,则只能返回有关组织中具有商业、Enterprise On-Ramp 或企业 Support 计划的账户的信息。
例 示例:组织具有包含企业、商业和开发人员支持计划的账户
-
您的组织中有五个账户。管理账户具有企业支持计划,两个账户具有商业支持计划,而另两个账户具有开发人员支持计划。
-
您可以从管理账户调用
DescribeEventDetailsForOrganization
API 操作。 -
Amazon Health 仅返回具有企业或商业支持计划的账户的信息。具有开发人员支持计划的账户将显示在响应的
failedSet
中。