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

# 지원 센터 콘솔 API 정보


지원 센터 콘솔 API는 지원 센터 콘솔 경험을 개선합니다. 지원 센터 콘솔 API가 제공하는 기능의 예는 다음과 같습니다.
+ 지원 사례 초안을 생성하고 업데이트할 수 있는 기능
+ 지원 센터 콘솔에 계정의 현재 상태를 표시하는 기능
+ 지원 센터 콘솔에 선택한 서비스 및 범주에 대한 동적 도움말을 표시하는 기능

지원 센터 콘솔 API가 제공하는 작업의 전체 목록은 [지원 센터 콘솔 API 작업을 위한 IAM 정책 추가](support-console-access-control.md)의 표를 참조하세요.

**중요**  
지원 센터 콘솔 API에 포함된 함수를 계속 사용하려면 2026년 6월 1일 이전에 지원 센터 콘솔 작업을 AWS Identity and Access Management 정책에 추가해야 합니다. IAM 정책을 생성한 후 `support-console:*` 작업을 포함하도록 AWS Support 관리형 정책을 업데이트합니다. 자세한 내용은 [지원 센터 콘솔 API 작업을 위한 IAM 정책 추가](support-console-access-control.md) 단원을 참조하십시오.

**Topics**
+ [

# 지원 센터 콘솔 API 작업을 위한 IAM 정책 추가
](support-console-access-control.md)
+ [

# 지원 센터 콘솔 API 직접 호출 테스트
](support-console-access-control-test.md)

# 지원 센터 콘솔 API 작업을 위한 IAM 정책 추가


2026년 6월 1일 이전에는 지원 센터 콘솔 API 작업에 대한 AWS Identity and Access Management 정책을 생성해야 합니다. 2026년 6월 1일까지 이러한 정책을 생성하지 않으면 `AccessDenied` 오류가 발생합니다.

IAM 정책에 이러한 작업을 추가하려면 *AWS Identity and Access Management 사용 설명서*의 [IAM 정책 생성(콘솔)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html)을 참조하세요.

다음 표에는 콘솔 작업이 요약되어 있습니다.

**참고**  
이러한 작업은 콘솔에서만 사용할 수 있습니다. AWS SDK 또는 에서는 사용할 수 없습니다 AWS CLI.


| 연산 | 액세스 레벨 | 설명 | 
| --- | --- | --- | 
|  GetAccountState  |  READ  |  현재 계정 상태를 콘솔이 표시할 수 있는 권한을 부여합니다.  | 
|  GetAccountGovCloudEnabled  |  READ  |  계정에 GovCloud가 활성화되어 있는지 확인할 수 있는 권한을 부여합니다.  | 
|  GetCaseDraft  |  READ  |  이전에 생성한 사례 초안을 콘솔이 표시할 수 있는 권한을 부여합니다.  | 
|  CreateCaseDraft  |  WRITE  |  지정된 사례 유형의 사례 초안을 생성하거나 업데이트할 수 있는 권한을 부여합니다.  | 
|  DeleteCaseDraft  |  WRITE  |  지정된 사례 유형의 사례 초안을 삭제할 수 있는 권한을 부여합니다.  | 
|  GetBanner  |  READ  |  고객에게 영향을 미치는 이벤트 중에 표시되는 지원 배너를 콘솔에 표시할 수 있는 권한을 부여합니다.  | 
|  DescribeDynamicHelp  |  READ  |  선택한 서비스 및 범주의 동적 도움말 리소스를 콘솔이 표시할 수 있는 권한을 부여합니다.  | 
|  CreateContact  |  WRITE  |  선택한 연락처 유형의 인증된 연락처를 콘솔이 생성할 수 있는 권한을 부여합니다.  | 
|  CheckSubscription  |  READ  |  계정에 선택한 제품에 대한 액세스 권한이 있는지 콘솔이 확인할 수 있는 권한을 부여합니다.  | 
|  GetQuestionnaire  |  READ  |  고객 피드백 설문지를 콘솔이 표시할 수 있는 권한을 부여합니다.  | 
|  SaveFeedback  |  WRITE  |  설문지 피드백을 저장할 수 있는 권한을 부여합니다.  | 

**참고**  
 사용자 지정 VPN 구성이 있는 경우 클라이언트 IP 주소를 지원 센터 콘솔 API 엔드포인트로 올바르게 전달하도록 VPN을 구성해야 합니다. [aws:SourceIp](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_examples_aws_deny-ip.html) 조건이 포함된 AWS Identity and Access Management 정책과 함께 VPN을 사용하는 경우 IAM 정책에 지정된 클라이언트 IP 주소를 VPN의 IP 주소가 아닌 API 엔드포인트로 전달해야 합니다. VPN이 클라이언트 IP 주소 대신 자체 IP 주소를 전달하는 경우 IP 주소가 IAM 정책의 `aws:SourceIp` 조건과 일치하지 않기 때문에 권한 부여가 실패할 수 있습니다. 다음 표에는 지원 센터 콘솔 API 엔드포인트가 나와 있습니다 AWS 리전.  


| AWS 리전 | 지원 센터 콘솔 API 엔드포인트 | 
| --- | --- | 
|  `https://api.us-east-1.prod.support-console.support.aws.dev`  |  미국 동부(버지니아 북부)  | 
|  `https://api.us-west-2.prod.support-console.support.aws.dev`  |  US West (Oregon)  | 
|  `https://api.eu-west-1.prod.support-console.support.aws.dev`  |  유럽(아일랜드)  | 

# 지원 센터 콘솔 API 직접 호출 테스트


콘솔에 대한 API 직접 호출이 작동하는지 확인하려면 [AWS Support Center Console](https://console.aws.amazon.com/support)을 엽니다. 직접 호출이 실패하면 오류를 요약한 배너가 표시됩니다.

 AWS CloudTrail 를 사용하여 지원 센터 콘솔에 대한 API 호출을 디버깅할 수 있습니다. IAM 정책이 누락된 경우 API 직접 호출에 대한 CloudTrail 이벤트가 표시됩니다. 브라우저의 IP 주소를 CloudTrail 이벤트의 클라이언트 IP 주소와 비교하여 IP 주소 전달 문제를 조사할 수도 있습니다.

지원 센터 콘솔 직접 호출에 대한 CloudTrail 이벤트를 보려면 다음 단계를 완료하세요.

1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cloudtrail/](https://console.aws.amazon.com/cloudtrail/) CloudTrail 콘솔을 엽니다.

1. 탐색 창에서 **Event history(이벤트 기록)**를 선택합니다. 가장 최근 이벤트가 먼저 표시되는 필터링된 이벤트 목록이 보입니다. 이벤트의 기본 필터는 **읽기 전용**이며, **false**로 설정됩니다. 필터를 지우려면 필터 오른쪽에 있는 **X**를 선택합니다.

1. 이벤트 소스 **support-console.amazonaws.com**을 선택합니다. 이벤트 세부 정보 페이지에서 이벤트에 대한 세부 정보, 참조된 리소스, 이벤트 기록을 확인할 수 있습니다.