启用组织视图 - AWS Health

启用组织视图

您可以使用 AWS Health 控制台集中查看您 AWS 组织中的运行状况事件。

所有 AWS Support 计划的组织视图均可在 AWS Health 控制台中进行查看，无需支付额外费用。

注意

如果允许用户访问管理账户中的此功能，则他们必须拥有诸如 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 控制台。

  • 如果您拥有商业、Enterprise On-Ramp 或 Enterprise Support 计划，则可以调用 DescribeHealthServiceStatusForOrganization API 操作来检查流程的状态。

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

Enabling organizational view (CLI)

只能通过使用 EnableHealthServiceAccessForOrganization API 操作来启用组织视图。

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

注意

  • 您必须拥有商业、Enterprise On-Ramp 或 Enterprise Support 计划才能调用 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')

response = client.enable_health_service_access_for_organization()

print(response)

Java

您可以在以下示例中使用适用于 Java 2.0 版的 AWS 开发工具包。

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 开发工具包开发人员指南。

启用此功能时，AWSServiceRoleForHealth_Organizations 服务相关角色和 Health_OrganizationsServiceRolePolicy AWS 托管策略将应用于组织中的管理账户。

注意

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