View a markdown version of this page

启用组织视图 - AWS Health

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

启用组织视图

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

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

注意

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

Enabling organizational view (Console)

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

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

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

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

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

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

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

注意

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

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

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

Enabling organizational view (CLI)

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

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

注意

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

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

例

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

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

对于以下示例，您可以使用 AWS 适用于 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 的AWS 开发工具包开发人员指南。

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

注意

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