View a markdown version of this page

启用组织视图 - Amazon Health
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

启用组织视图

您可以使用 Amazon Health 控制台获取 Amazon 组织中运行状况事件的集中视图。

Amazon Health 控制台中提供所有 Amazon Web Services 支持 计划的组织视图，无需额外付费。

注意

如果允许用户访问管理账户中的此功能，则他们必须拥有诸如 AWSHealthFullAccess 策略之类的权限。有关更多信息，请参阅 Amazon Health 基于身份的策略示例。

Enabling organizational view (Console)

您可以从 Amazon Health 控制台启用组织视图。你必须登录你的 Amazon 组织的管理账户。

要查看 Amazon Health 贵组织的控制面板

  1. 在以下位置打开您的 Amazon Health 控制面板https://health.aws.amazon.com/health/home。

  2. 在导航窗格的您的组织运行状况下，选择配置。

  3. 在启用组织视图页面上，选择启用组织视图。

  4. （可选）如果要对 Amazon 组织进行更改，例如创建组织单位 (OU)，请选择管理 Amazon Organizations。

    有关更多信息，请参阅《Amazon Organizations 用户指南》中的开始使用 Amazon Organizations。

注意

  • 启用 Amazon Health 组织视图后，初始账户加载过程在后台运行，可能需要几分钟才能完成。您可以关闭主 Amazon Health 机，稍后再返回，因为您无需等待该过程完成。历史运行状况事件（在启用该功能之前创建的历史事件）最多可能需要 24 小时才能显示在组织视图中。

  • 如果您有 Amazon 业务支持+、 Amazon 企业支持或 Amazon 统一运营计划，则可以调用 DescribeHealthServiceStatusForOrganization API 操作来检查流程的状态。

  • 启用此功能后，具有Health_OrganizationsServiceRolePolicy Amazon 托管策略的AWSServiceRoleForHealth_Organizations服务相关角色将应用于组织中的管理账户。有关更多信息，请参阅 将服务相关角色用于 Amazon Health。

Enabling organizational view (CLI)

您可以使用 EnableHealthServiceAccessForOrganization API 操作启用组织视图。

你可以使用 Amazon Command Line Interface (Amazon CLI) 或你自己的代码来调用这个操作。

注意

  • 您必须拥有商业 On-Ramp、企业或企业支持计划才能调用 Amazon Health API。

  • 您必须使用美国东部（弗吉尼亚州北部）区域端点。

例

以下 Amazon CLI 命令从您的 Amazon 账户启用此功能。您可以从管理账户或从可担任具有所需权限的角色的账户使用此命令。

aws health enable-health-service-access-for-organization --region us-east-1

以下代码示例调用 EnableHealthServiceAccessForOrganization API 操作。

Python

import boto3

client = boto3.client('health', region_name='us-east-1')

response = client.enable_health_service_access_for_organization()

print(response)

Java

对于以下示例，您可以使用 Amazon 适用于 Java 2.0 版本的软件开发工具包。

import software.amazon.awssdk.services.health.HealthClient;
import software.amazon.awssdk.services.health.HealthClientBuilder;
 
import software.amazon.awssdk.services.health.model.ConcurrentModificationException;
import software.amazon.awssdk.services.health.model.EnableHealthServiceAccessForOrganizationRequest;
import software.amazon.awssdk.services.health.model.EnableHealthServiceAccessForOrganizationResponse;
import software.amazon.awssdk.services.health.model.DescribeHealthServiceStatusForOrganizationRequest;
import software.amazon.awssdk.services.health.model.DescribeHealthServiceStatusForOrganizationResponse;
 
import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider;
 
import software.amazon.awssdk.regions.Region;
 
public class EnableHealthServiceAccessDemo {
    public static void main(String[] args) {
        HealthClient client = HealthClient.builder()
            .region(Region.US_EAST_1)
            .credentialsProvider(
                DefaultCredentialsProvider.builder().build()
            )
            .build();
 
        try {
            DescribeHealthServiceStatusForOrganizationResponse statusResponse = client.describeHealthServiceStatusForOrganization(
                DescribeHealthServiceStatusForOrganizationRequest.builder().build()
            );
 
            String status = statusResponse.healthServiceAccessStatusForOrganization();
            if ("ENABLED".equals(status)) {
                System.out.println("EnableHealthServiceAccessForOrganization already enabled!");
                return;
            }
 
            client.enableHealthServiceAccessForOrganization(
                EnableHealthServiceAccessForOrganizationRequest.builder().build()
            );
 
            System.out.println("EnableHealthServiceAccessForOrganization is in progress");
        } catch (ConcurrentModificationException cme) {
            System.out.println("EnableHealthServiceAccessForOrganization is already in progress. Wait for the action to complete before trying again.");
        } catch (Exception e) {
            System.out.println("EnableHealthServiceAccessForOrganization FAILED: " + e);
        }
    }
}

有关更多信息，请参阅适用于 Java 2.0 的Amazon 开发工具包开发人员指南。

启用此功能后，具有Health_OrganizationsServiceRolePolicyAmazon 托管策略的AWSServiceRoleForHealth_Organizations服务相关角色将应用于组织中的管理账户。

注意

启用此功能是一个异步过程，需要花点时间才能完成。您可以调用该DescribeHealthServiceStatusForOrganization操作来检查进程的状态。