기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 조직 보기 활성화
<a name="enable-organizational-view"></a>

 AWS Health 콘솔을 사용하여 AWS 조직의 상태 이벤트에 대한 중앙 집중식 보기를 가져올 수 있습니다.

콘솔에서 모든 AWS Support 플랜에 AWS Health 대한 조직 보기를 추가 비용 없이 사용할 수 있습니다.

**참고**  
관리 계정에서 사용자가 이 기능에 액세스할 수 있도록 허용하려면 해당 사용자에게 [https://console.aws.amazon.com//iam/home?#/policies/arn:aws:iam::aws:policy/AWSHealthFullAccess](https://console.aws.amazon.com//iam/home?#/policies/arn:aws:iam::aws:policy/AWSHealthFullAccess) 정책과 같은 권한이 있어야 합니다. 자세한 내용은 [AWS Health 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md) 단원을 참조하십시오.

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

 AWS Health 콘솔에서 조직 보기를 활성화할 수 있습니다. AWS 조직의 관리 계정에 로그인해야 합니다.

**조직의 AWS Health 대시보드를 보려면**

1. [https://health.aws.amazon.com/health/home](https://health.aws.amazon.com/health/) AWS Health 대시보드를 엽니다.

1. 탐색 창의 **조직 상태**에서 **구성**을 선택합니다.

1. **조직 보기 사용** 페이지에서 **조직 보기 사용**을 선택합니다.

1. (선택 사항) AWS 조직 단위(OUs) 생성과 같이 조직을 변경하려면 **관리를 AWS Organizations**선택합니다.

   자세한 내용은 *AWS Organizations 사용 설명서*의 [AWS Organizations시작하기](https://docs.aws.amazon.com//organizations/latest/userguide/orgs_tutorials_basic.html)를 참조하십시오.

**참고**  
 AWS Health 조직 보기를 활성화하면 초기 계정 로드 프로세스가 백그라운드에서 실행되며 완료하는 데 몇 분 정도 걸릴 수 있습니다. 프로세스가 완료될 때까지 기다릴 필요가 없으므로 AWS Health 콘솔을 닫고 나중에 돌아올 수 있습니다. 과거 상태 이벤트( 기능을 활성화하기 전에 생성된 이벤트)가 조직 보기에 표시되는 데 최대 24시간이 걸릴 수 있습니다.
 AWS Business Support\$1, AWS Enterprise Support 또는 AWS 통합 운영 플랜이 있는 경우 [DescribeHealthServiceStatusForOrganization](https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeHealthServiceStatusForOrganization.html) API 작업을 호출하여 프로세스 상태를 확인할 수 있습니다.
이 기능을 활성화하면 `Health_OrganizationsServiceRolePolicy` AWS 관리형 정책이 있는 `AWSServiceRoleForHealth_Organizations` 서비스 연결 역할이 조직의 관리 계정에 적용됩니다. 자세한 내용은 [에 대한 서비스 연결 역할 사용 AWS Health](using-service-linked-roles.md) 단원을 참조하십시오.

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

조직 보기를 사용 설정하려면 [EnableHealthServiceAccessForOrganization](https://docs.aws.amazon.com/health/latest/APIReference/API_EnableHealthServiceAccessForOrganization.html) API 작업을 사용하면 됩니다.

 AWS Command Line Interface (AWS CLI) 또는 자체 코드를 사용하여이 작업을 호출할 수 있습니다.

**참고**  
 AWS Health API를 호출하려면 [Business](https://aws.amazon.com/premiumsupport/plans/business/), [Enterprise On-Ramp](https://aws.amazon.com/premiumsupport/plans/enterprise-onramp) 또는 [Enterprise](https://aws.amazon.com/premiumsupport/plans/enterprise) Support 플랜이 있어야 합니다.
미국 동부(버지니아 북부) 리전 엔드포인트를 사용해야 합니다.

**Example**  
다음 AWS CLI 명령은 AWS 계정에서이 기능을 활성화합니다. 이 명령은 관리 계정 또는 필요한 권한이 있는 역할을 맡을 수 있는 계정에서 사용할 수 있습니다.  

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

다음 코드 예제에서는 [EnableHealthServiceAccessForOrganization](https://docs.aws.amazon.com/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용 AWS SDK를 사용할 수 있습니다.

```
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 SDK 개발자 안내서](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/)를 참조하십시오.

이 기능을 활성화하면 `Health_OrganizationsServiceRolePolicy` AWS 관리형 정책이 있는 `AWSServiceRoleForHealth_Organizations` [서비스 연결 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html)이 조직의 관리 계정에 적용됩니다.

**참고**  
이 기능을 활성화하는 작업은 비동기 프로세스이며 완료하는 데 시간이 걸립니다. [DescribeHealthServiceStatusForOrganization](https://docs.aws.amazon.com/health/latest/APIReference/API_DescribeHealthServiceStatusForOrganization.html) 작업을 호출하여 프로세스의 상태를 확인할 수 있습니다.

------