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

# 启用组织视图
<a name="enable-organizational-view"></a>

您可以使用 Amazon Health 控制台集中查看 Amazon 组织中的健康事件。

所有 Amazon Web Services 支持 套餐均可在 Amazon Health 控制台中查看组织视图，无需支付额外费用。

**注意**  
如果允许用户访问管理账户中的此功能，则他们必须拥有诸如 [https://console.amazonaws.cn//iam/home?#/policies/arn:aws:iam::aws:policy/AWSHealthFullAccess](https://console.amazonaws.cn//iam/home?#/policies/arn:aws:iam::aws:policy/AWSHealthFullAccess) 策略之类的权限。有关更多信息，请参阅 [Amazon Health 基于身份的策略示例](security_iam_id-based-policy-examples.md)。

------
#### [ Enabling organizational view (Console) ]

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

**查看您组织的 Amazon Health 控制面板**

1. 在[https://health.aws.amazon.com/health/家](https://health.aws.amazon.com/health/)中打开 Amazon Health 控制面板。

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

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

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

   有关更多信息，请参阅《Amazon Organizations 用户指南》**中的[开始使用 Amazon Organizations](https://docs.amazonaws.cn//organizations/latest/userguide/orgs_tutorials_basic.html)。

**注意**  
启用 Amazon Health 组织视图后，初始账户加载过程将在后台运行，可能需要几分钟才能完成。您可以关闭 Amazon Health 控制台，稍后再返回，因为您无需等待该过程完成。历史运行状况事件（在启用该功能之前创建的健康事件）最长可能需要 24 小时才能显示在您的组织视图中。
 如果您有 B Amazon usiness Support\$1、En Amazon terprise Support 或 Amazon Unified Operations 计划，则可以调用 [DescribeHealthServiceStatusForOrganization](https://docs.amazonaws.cn/health/latest/APIReference/API_DescribeHealthServiceStatusForOrganization.html)API 操作来检查流程的状态。
启用此功能后，具有`Health_OrganizationsServiceRolePolicy` Amazon 托管策略的`AWSServiceRoleForHealth_Organizations`服务相关角色将应用于组织中的管理账户。有关更多信息，请参阅 [将服务相关角色用于 Amazon Health](using-service-linked-roles.md)。

------
#### [ Enabling organizational view (CLI) ]

您可以使用 [EnableHealthServiceAccessForOrganization](https://docs.amazonaws.cn/health/latest/APIReference/API_EnableHealthServiceAccessForOrganization.html)API 操作启用组织视图。

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

**注意**  
您必须有[商业](https://www.amazonaws.cn/premiumsupport/plans/business/)、[企业入口](https://www.amazonaws.cn/premiumsupport/plans/enterprise-onramp)或[企业](https://www.amazonaws.cn/premiumsupport/plans/enterprise)支持计划才能调用 Amazon Health API。
您必须使用美国东部（弗吉尼亚州北部）区域端点。

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

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

以下代码示例调用 [EnableHealthServiceAccessForOrganization](https://docs.amazonaws.cn/health/latest/APIReference/API_EnableHealthServiceAccessForOrganization.html)API 操作。

**Python**

```
import boto3

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

response = client.enable_health_service_access_for_organization()

print(response)
```

**Java**

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

```
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 开发工具包开发人员指南](https://docs.amazonaws.cn/sdk-for-java/latest/developer-guide/)。

启用此功能后，具有`Health_OrganizationsServiceRolePolicy` Amazon 托管策略的`AWSServiceRoleForHealth_Organizations`[服务相关角色](https://docs.amazonaws.cn/IAM/latest/UserGuide/using-service-linked-roles.html)将应用于组织中的管理账户。

**注意**  
启用此功能是一个异步过程，需要花点时间才能完成。您可以调用该[DescribeHealthServiceStatusForOrganization](https://docs.amazonaws.cn/health/latest/APIReference/API_DescribeHealthServiceStatusForOrganization.html)操作来检查进程的状态。

------