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

# GetAccountInformation
<a name="API_GetAccountInformation"></a>

계정 이름, 계정 ID, 계정 생성 날짜 및 시간을 포함하여 지정된 계정에 대한 정보를 검색합니다. 이 API를 사용하려면 IAM 사용자 또는 역할에 `account:GetAccountInformation` IAM 권한이 있어야 합니다.

## Request Syntax
<a name="API_GetAccountInformation_RequestSyntax"></a>

```
POST /getAccountInformation HTTP/1.1
Content-type: application/json

{
   "AccountId": "string"
}
```

## URI 요청 파라미터
<a name="API_GetAccountInformation_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_GetAccountInformation_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [AccountId](#API_GetAccountInformation_RequestSyntax) **   <a name="accounts-GetAccountInformation-request-AccountId"></a>
이 작업을 사용하여 액세스하거나 수정할 계정의 12자리 AWS 계정 ID 번호를 지정합니다.  
이 파라미터를 지정하지 않으면 기본적으로 작업을 호출하는 데 사용되는 자격 증명의 AWS 계정으로 설정됩니다.  
이 파라미터를 사용하려면 호출자가 [조직의 관리 계정](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) 또는 위임된 관리자 계정의 자격 증명이어야 하며, 지정된 계정 ID는 동일한 조직의 멤버 계정이어야 합니다. 조직은 [모든 기능을 활성화](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)해야 하며, 계정 관리 서비스에 대해 [신뢰할 수 있는 액세스](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)가 활성화되어 있어야 하고, 선택 사항으로 [위임된 관리자](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) 계정이 할당되어 있어야 합니다.  
관리 계정은 자체 `AccountId`를 지정할 수 없습니다. `AccountId` 파라미터를 포함하지 않고 독립 실행형 컨텍스트에서 작업을 호출해야 합니다.
조직의 멤버가 아닌 계정에서 이 작업을 호출하려면 이 파라미터를 지정하지 말고, 검색하거나 수정하려는 연락처의 계정에 속한 자격 증명을 사용하여 작업을 호출합니다.  
유형: String  
패턴: `\d{12}`   
필수 여부: 아니요

## 응답 구문
<a name="API_GetAccountInformation_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountCreatedDate": "string",
   "AccountId": "string",
   "AccountName": "string"
}
```

## 응답 요소
<a name="API_GetAccountInformation_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AccountCreatedDate](#API_GetAccountInformation_ResponseSyntax) **   <a name="accounts-GetAccountInformation-response-AccountCreatedDate"></a>
계정이 생성된 날짜 및 시간입니다.  
유형: 타임스탬프

 ** [AccountId](#API_GetAccountInformation_ResponseSyntax) **   <a name="accounts-GetAccountInformation-response-AccountId"></a>
이 작업을 사용하여 AWS 계정 액세스하거나 수정할의 12자리 계정 ID 번호를 지정합니다. 이 파라미터를 사용하려면 호출자가 [조직의 관리 계정](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) 또는 위임된 관리자 계정의 자격 증명이어야 합니다. 지정된 계정 ID는 동일한 조직의 멤버 계정이어야 합니다. 조직은 [모든 기능을 활성화](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)해야 하며, 계정 관리 서비스에 대해 [신뢰할 수 있는 액세스](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)가 활성화되어 있어야 하고, 선택 사항으로 [위임된 관리자](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) 계정이 할당되어 있어야 합니다.  
이 작업은 멤버 계정을 대상으로, 관리 계정이나 조직의 위임된 관리자 계정에서만 호출할 수 있습니다.  
관리 계정은 자체 `AccountId`를 지정할 수 없습니다.
유형: String  
패턴: `\d{12}` 

 ** [AccountName](#API_GetAccountInformation_ResponseSyntax) **   <a name="accounts-GetAccountInformation-response-AccountName"></a>
계정의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
패턴: `[ -;=?-~]+` 

## 오류
<a name="API_GetAccountInformation_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
호출 자격 증명에 최소 필수 권한이 없어 작업이 실패했습니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 403

 ** InternalServerException **   
내부 오류로 인해 작업이 실패했습니다 AWS. 나중에 작업을 다시 시도하세요.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 500

 ** TooManyRequestsException **   
너무 잦은 호출 및 스로틀 제한 초과로 인해 작업이 실패했습니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력 파라미터 중 하나가 유효하지 않아 작업이 실패했습니다.    
 ** fieldList **   
잘못된 항목이 감지된 필드입니다.  
 ** message **   
요청에서 무엇이 유효하지 않았는지를 알려주는 메시지입니다.  
 ** reason **   
검증에 실패한 사유입니다.
HTTP 상태 코드: 400

## 예
<a name="API_GetAccountInformation_Examples"></a>

### 예제 1.
<a name="API_GetAccountInformation_Example_1"></a>

다음 예에서는 작업을 호출하는 데 자격 증명이 사용되는 계정의 계정 정보를 검색합니다.

#### 샘플 요청
<a name="API_GetAccountInformation_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
                    
{}
```

#### 샘플 응답
<a name="API_GetAccountInformation_Example_1_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyAccount",
   "AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```

### 예제 2.
<a name="API_GetAccountInformation_Example_2"></a>

다음 예에서는 조직의 지정된 멤버 계정에 대한 계정 정보를 검색합니다. 조직의 관리 계정 또는 계정 관리 서비스의 위임된 관리자 계정의 자격 증명을 사용해야 합니다.

#### 샘플 요청
<a name="API_GetAccountInformation_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
                    
{
   "AccountId": "123456789012" 
}
```

#### 샘플 응답
<a name="API_GetAccountInformation_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyMemberAccount",
   "AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```

## 참고
<a name="API_GetAccountInformation_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAccountInformation) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAccountInformation) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAccountInformation) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAccountInformation) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAccountInformation) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAccountInformation)