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

# 작업
<a name="API_Operations"></a>

다음 작업이 지원됩니다.
+  [AcceptPrimaryEmailUpdate](API_AcceptPrimaryEmailUpdate.md) 
+  [DeleteAlternateContact](API_DeleteAlternateContact.md) 
+  [DisableRegion](API_DisableRegion.md) 
+  [EnableRegion](API_EnableRegion.md) 
+  [GetAccountInformation](API_GetAccountInformation.md) 
+  [GetAlternateContact](API_GetAlternateContact.md) 
+  [GetContactInformation](API_GetContactInformation.md) 
+  [GetGovCloudAccountInformation](API_GetGovCloudAccountInformation.md) 
+  [GetPrimaryEmail](API_GetPrimaryEmail.md) 
+  [GetRegionOptStatus](API_GetRegionOptStatus.md) 
+  [ListRegions](API_ListRegions.md) 
+  [PutAccountName](API_PutAccountName.md) 
+  [PutAlternateContact](API_PutAlternateContact.md) 
+  [PutContactInformation](API_PutContactInformation.md) 
+  [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) 

# AcceptPrimaryEmailUpdate
<a name="API_AcceptPrimaryEmailUpdate"></a>

[StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md)에서 시작된 요청을 수락하여 지정된 계정에 기본 이메일 주소(루트 사용자 이메일 주소라고도 함)를 업데이트합니다.

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

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

{
   "AccountId": "string",
   "Otp": "string",
   "PrimaryEmail": "string"
}
```

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

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

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

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

 ** [AccountId](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-request-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}`   
필수 여부: 예

 ** [Otp](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-request-Otp"></a>
`StartPrimaryEmailUpdate` API 호출에 지정된 `PrimaryEmail`로 전송된 OTP 코드입니다.  
유형: String  
패턴: `[a-zA-Z0-9]{6}`   
필수 여부: 예

 ** [PrimaryEmail](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-request-PrimaryEmail"></a>
지정된 계정과 함께 사용할 새 기본 이메일 주소입니다. `StartPrimaryEmailUpdate` API 호출의 `PrimaryEmail`와 일치해야 합니다.  
유형: 문자열  
길이 제약: 최소 길이는 5입니다. 최대 길이는 64.  
필수 항목 여부: 예

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

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

{
   "Status": "string"
}
```

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

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

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

 ** [Status](#API_AcceptPrimaryEmailUpdate_ResponseSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-response-Status"></a>
수락된 기본 이메일 업데이트 요청의 상태를 검색합니다.  
타입: 문자열  
유효 값: `PENDING | ACCEPTED` 

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

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

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

 ** ConflictException **   
리소스의 현재 상태에 충돌이 발생하여 요청을 처리할 수 없습니다. 예를 들어, 현재 비활성화된 리전(비활성화 상태)을 활성화하려고 하거나 계정의 루트 사용자 이메일을 이미 사용 중인 이메일 주소로 변경하려고 하면 이 문제가 발생합니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 409

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

 ** ResourceNotFoundException **   
찾을 수 없는 리소스 지정으로 인해 작업이 실패했습니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 404

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

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

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

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

# DeleteAlternateContact
<a name="API_DeleteAlternateContact"></a>

에서 지정된 대체 연락처를 삭제합니다 AWS 계정.

대체 연락처 작업을 사용하는 방법에 대한 자세한 내용은 [AWS 계정의 대체 연락처 업데이트](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)를 참조하세요.

**참고**  
에서 AWS 계정 관리하는에 대한 대체 연락처 정보를 업데이트하려면 먼저 AWS 계정 관리와 조직 간의 통합을 활성화 AWS Organizations해야 합니다. 자세한 내용은 [AWS 계정 관리에 대한 신뢰할 수 있는 액세스 활성화](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)를 참조하세요.

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

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

{
   "AccountId": "string",
   "AlternateContactType": "string"
}
```

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

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

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

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

 ** [AccountId](#API_DeleteAlternateContact_RequestSyntax) **   <a name="accounts-DeleteAlternateContact-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}`   
필수 여부: 아니요

 ** [AlternateContactType](#API_DeleteAlternateContact_RequestSyntax) **   <a name="accounts-DeleteAlternateContact-request-AlternateContactType"></a>
삭제할 대체 연락처를 지정합니다.  
타입: 문자열  
유효 값: `BILLING | OPERATIONS | SECURITY`   
필수 여부: 예

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteAlternateContact_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

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

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

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

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

 ** ResourceNotFoundException **   
찾을 수 없는 리소스 지정으로 인해 작업이 실패했습니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 404

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

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

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

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

다음 예에서는 작업을 호출하는 데 자격 증명이 사용되는 계정의 보안 대체 연락처를 삭제합니다.

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact

{
   "AccountName":"MyAccount"
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
```

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

다음 예에서는 조직의 지정된 멤버 계정에 대한 대체 결제 연락처를 삭제합니다. 조직의 관리 계정 또는 계정 관리 서비스의 위임된 관리자 계정의 자격 증명을 사용해야 합니다.

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact

{
   "AccountId":"123456789012",
   "AlternateContactType":"BILLING"
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
```

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

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

# DisableRegion
<a name="API_DisableRegion"></a>

계정의 특정 리전을 비활성화(옵트아웃)합니다.

**참고**  
리전을 비활성화하면 해당 리전에 있는 모든 리소스에 대한 모든 IAM 액세스가 제거됩니다.

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

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

{
   "AccountId": "string",
   "RegionName": "string"
}
```

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

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

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

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

 ** [AccountId](#API_DisableRegion_RequestSyntax) **   <a name="accounts-DisableRegion-request-AccountId"></a>
이 작업을 사용하여 AWS 계정 액세스하거나 수정할의 12자리 계정 ID 번호를 지정합니다. 이 파라미터를 지정하지 않으면 기본적으로 작업을 호출하는 데 사용되는 자격 증명의 Amazon Web Services 계정으로 설정됩니다. 이 파라미터를 사용하려면 호출자가 [조직의 관리 계정](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`를 지정할 수 없습니다. `AccountId` 파라미터를 포함하지 않고 독립 실행형 컨텍스트에서 작업을 호출해야 합니다.
조직의 멤버가 아닌 계정에서 이 작업을 호출하려면 이 파라미터를 지정하지 마세요. 대신 연락처가 검색하거나 수정하려는 계정에 속한 자격 증명을 사용하여 작업을 호출합니다.  
유형: String  
패턴: `\d{12}`   
필수 여부: 아니요

 ** [RegionName](#API_DisableRegion_RequestSyntax) **   <a name="accounts-DisableRegion-request-RegionName"></a>
지정된 리전 이름에 리전 코드를 지정합니다(예: `af-south-1`). 리전을 비활성화하면는 해당 리전의 IAM 리소스를 삭제하는 등 계정에서 해당 리전을 비활성화하는 작업을 AWS 수행합니다. 이 프로세스는 대부분의 계정에서 몇 분이 걸리지만 몇 시간이 걸릴 수도 있습니다. 비활성화 프로세스가 완전히 완료될 때까지 리전을 활성화할 수 없습니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
필수 항목 여부: 예

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DisableRegion_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

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

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

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

 ** ConflictException **   
리소스의 현재 상태에 충돌이 발생하여 요청을 처리할 수 없습니다. 예를 들어, 현재 비활성화된 리전(비활성화 상태)을 활성화하려고 하거나 계정의 루트 사용자 이메일을 이미 사용 중인 이메일 주소로 변경하려고 하면 이 문제가 발생합니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 409

 ** 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_DisableRegion_SeeAlso"></a>

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

# EnableRegion
<a name="API_EnableRegion"></a>

계정의 특정 리전을 활성화(옵트인)합니다.

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

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

{
   "AccountId": "string",
   "RegionName": "string"
}
```

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

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

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

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

 ** [AccountId](#API_EnableRegion_RequestSyntax) **   <a name="accounts-EnableRegion-request-AccountId"></a>
이 작업을 사용하여 AWS 계정 액세스하거나 수정할의 12자리 계정 ID 번호를 지정합니다. 이 파라미터를 지정하지 않으면 기본적으로 작업을 호출하는 데 사용되는 자격 증명의 Amazon Web Services 계정으로 설정됩니다. 이 파라미터를 사용하려면 호출자가 [조직의 관리 계정](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`를 지정할 수 없습니다. `AccountId` 파라미터를 포함하지 않고 독립 실행형 컨텍스트에서 작업을 호출해야 합니다.
조직의 멤버가 아닌 계정에서 이 작업을 호출하려면 이 파라미터를 지정하지 마세요. 대신 연락처가 검색하거나 수정하려는 계정에 속한 자격 증명을 사용하여 작업을 호출합니다.  
유형: String  
패턴: `\d{12}`   
필수 여부: 아니요

 ** [RegionName](#API_EnableRegion_RequestSyntax) **   <a name="accounts-EnableRegion-request-RegionName"></a>
지정된 리전 이름에 리전 코드를 지정합니다(예: `af-south-1`). 리전을 활성화하면 AWS 에서 해당 리전의 계정을 준비하는 작업(예: IAM 리소스를 해당 리전으로 배포)을 수행합니다. 이 프로세스는 대부분의 계정에서 몇 분이 걸리지만 몇 시간이 걸릴 수도 있습니다. 이 프로세스가 완료될 때까지는 해당 리전을 사용할 수 없습니다. 또한 활성화 프로세스가 완전히 완료될 때까지 리전을 비활성화할 수 없습니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
필수 항목 여부: 예

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_EnableRegion_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

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

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

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

 ** ConflictException **   
리소스의 현재 상태에 충돌이 발생하여 요청을 처리할 수 없습니다. 예를 들어, 현재 비활성화된 리전(비활성화 상태)을 활성화하려고 하거나 계정의 루트 사용자 이메일을 이미 사용 중인 이메일 주소로 변경하려고 하면 이 문제가 발생합니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 409

 ** 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_EnableRegion_SeeAlso"></a>

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

# 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) 

# GetAlternateContact
<a name="API_GetAlternateContact"></a>

에 연결된 지정된 대체 연락처를 검색합니다 AWS 계정.

대체 연락처 작업을 사용하는 방법에 대한 자세한 내용은 [AWS 계정의 대체 연락처 업데이트](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)를 참조하세요.

**참고**  
에서 AWS 계정 관리하는에 대한 대체 연락처 정보를 업데이트하려면 먼저 AWS 계정 관리와 조직 간의 통합을 활성화 AWS Organizations해야 합니다. 자세한 내용은 [AWS 계정 관리에 대한 신뢰할 수 있는 액세스 활성화](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)를 참조하세요.

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

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

{
   "AccountId": "string",
   "AlternateContactType": "string"
}
```

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

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

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

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

 ** [AccountId](#API_GetAlternateContact_RequestSyntax) **   <a name="accounts-GetAlternateContact-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}`   
필수 여부: 아니요

 ** [AlternateContactType](#API_GetAlternateContact_RequestSyntax) **   <a name="accounts-GetAlternateContact-request-AlternateContactType"></a>
검색할 대체 연락처를 지정합니다.  
타입: 문자열  
유효 값: `BILLING | OPERATIONS | SECURITY`   
필수 여부: 예

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

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

{
   "AlternateContact": { 
      "AlternateContactType": "string",
      "EmailAddress": "string",
      "Name": "string",
      "PhoneNumber": "string",
      "Title": "string"
   }
}
```

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

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

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

 ** [AlternateContact](#API_GetAlternateContact_ResponseSyntax) **   <a name="accounts-GetAlternateContact-response-AlternateContact"></a>
지정된 대체 연락처의 세부 정보가 포함된 구조입니다.  
타입: [AlternateContact](API_AlternateContact.md) 객체

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

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

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

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

 ** ResourceNotFoundException **   
찾을 수 없는 리소스 지정으로 인해 작업이 실패했습니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 404

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

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

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

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

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

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact

{
   "AlternateContactType":"SECURITY"
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json

{
   "AlternateContact":{
      "Name":"Anika",
      "Title":"COO",
      "EmailAddress":"anika@example.com",
      "PhoneNumber":"206-555-0198",
      "AlternateContactType":"Security"
   }
}
```

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

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

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact

{
   "AccountId":"123456789012",
   "AlternateContactType":"Operations"
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json

{
   "AlternateContact":{
      "Name":"Anika",
      "Title":"COO",
      "EmailAddress":"anika@example.com",
      "PhoneNumber":"206-555-0198",
      "AlternateContactType":"Operations"
   }
}
```

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

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

# GetContactInformation
<a name="API_GetContactInformation"></a>

 AWS 계정의 기본 연락처 정보를 검색합니다.

기본 연락처 작업을 사용하는 방법에 대한 자세한 내용은 [AWS 계정의 기본 연락처 업데이트](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html)를 참조하세요.

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

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

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

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

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

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

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

 ** [AccountId](#API_GetContactInformation_RequestSyntax) **   <a name="accounts-GetContactInformation-request-AccountId"></a>
이 작업을 사용하여 AWS 계정 액세스하거나 수정할의 12자리 계정 ID 번호를 지정합니다. 이 파라미터를 지정하지 않으면 기본적으로 작업을 호출하는 데 사용되는 자격 증명의 Amazon Web Services 계정으로 설정됩니다. 이 파라미터를 사용하려면 호출자가 [조직의 관리 계정](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`를 지정할 수 없습니다. `AccountId` 파라미터를 포함하지 않고 독립 실행형 컨텍스트에서 작업을 호출해야 합니다.
조직의 멤버가 아닌 계정에서 이 작업을 호출하려면 이 파라미터를 지정하지 마세요. 대신 연락처가 검색하거나 수정하려는 계정에 속한 자격 증명을 사용하여 작업을 호출합니다.  
유형: String  
패턴: `\d{12}`   
필수 여부: 아니요

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

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

{
   "ContactInformation": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "AddressLine3": "string",
      "City": "string",
      "CompanyName": "string",
      "CountryCode": "string",
      "DistrictOrCounty": "string",
      "FullName": "string",
      "PhoneNumber": "string",
      "PostalCode": "string",
      "StateOrRegion": "string",
      "WebsiteUrl": "string"
   }
}
```

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

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

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

 ** [ContactInformation](#API_GetContactInformation_ResponseSyntax) **   <a name="accounts-GetContactInformation-response-ContactInformation"></a>
 AWS 계정과 연결된 기본 연락처 정보의 세부 정보를 포함합니다.  
타입: [ContactInformation](API_ContactInformation.md) 객체

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

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

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

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

 ** ResourceNotFoundException **   
찾을 수 없는 리소스 지정으로 인해 작업이 실패했습니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 404

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

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

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

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

# GetGovCloudAccountInformation
<a name="API_GetGovCloudAccountInformation"></a>

GovCloud 계정 ID 및 상태를 포함하여 지정된 표준 계정(있는 경우)에 연결된 GovCloud 계정에 대한 정보를 검색합니다. 이 API를 사용하려면 IAM 사용자 또는 역할에 `account:GetGovCloudAccountInformation` IAM 권한이 있어야 합니다.

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

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

{
   "StandardAccountId": "string"
}
```

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

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

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

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

 ** [StandardAccountId](#API_GetGovCloudAccountInformation_RequestSyntax) **   <a name="accounts-GetGovCloudAccountInformation-request-StandardAccountId"></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_GetGovCloudAccountInformation_ResponseSyntax"></a>

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

{
   "AccountState": "string",
   "GovCloudAccountId": "string"
}
```

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

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

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

 ** [AccountState](#API_GetGovCloudAccountInformation_ResponseSyntax) **   <a name="accounts-GetGovCloudAccountInformation-response-AccountState"></a>
연결된 GovCloud 계정의 계정 상태입니다.  
타입: 문자열  
유효 값: `PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED` 

 ** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) **   <a name="accounts-GetGovCloudAccountInformation-response-GovCloudAccountId"></a>
연결된 GovCloud 계정의 12자리 계정 ID 번호입니다.  
유형: String  
패턴: `\d{12}` 

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

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

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

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

 ** ResourceNotFoundException **   
찾을 수 없는 리소스 지정으로 인해 작업이 실패했습니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 404

 ** ResourceUnavailableException **   
현재 사용할 수 없는 리소스를 지정했기 때문에 작업이 실패했습니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 424

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

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

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

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

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

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

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

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

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "GovCloudAccountId": "123456789012",
   "AccountState": "ACTIVE"
}
```

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

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

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
                    
{
   "StandardAccountId": "111111111111" 
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "GovCloudAccountId": "123456789012",
   "AccountState": "ACTIVE"
}
```

### 예제 3
<a name="API_GetGovCloudAccountInformation_Example_3"></a>

다음 예시에서는 GovCloud 계정에 연결되지 않은 표준 계정에 대해 연결된 GovCloud 계정 정보를 검색하려고 시도합니다.

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
                    
{
   "StandardAccountId": "222222222222" 
}
```

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

```
HTTP/1.1 404
Content-Type: application/json
                    
{
   "message":"GovCloud Account ID not found for Standard Account - 222222222222."
}
```

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

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

# GetPrimaryEmail
<a name="API_GetPrimaryEmail"></a>

지정된 계정의 기본 이메일 주소를 검색합니다.

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

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

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

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

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

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

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

 ** [AccountId](#API_GetPrimaryEmail_RequestSyntax) **   <a name="accounts-GetPrimaryEmail-request-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}`   
필수 여부: 예

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

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

{
   "PrimaryEmail": "string"
}
```

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

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

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

 ** [PrimaryEmail](#API_GetPrimaryEmail_ResponseSyntax) **   <a name="accounts-GetPrimaryEmail-response-PrimaryEmail"></a>
지정된 계정과 연결된 기본 이메일 주소를 검색합니다.  
유형: 문자열  
길이 제약: 최소 길이는 5입니다. 최대 길이는 64.

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

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

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

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

 ** ResourceNotFoundException **   
찾을 수 없는 리소스 지정으로 인해 작업이 실패했습니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 404

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

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

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

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

# GetRegionOptStatus
<a name="API_GetRegionOptStatus"></a>

특정 리전의 옵트인 상태를 검색합니다.

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

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

{
   "AccountId": "string",
   "RegionName": "string"
}
```

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

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

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

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

 ** [AccountId](#API_GetRegionOptStatus_RequestSyntax) **   <a name="accounts-GetRegionOptStatus-request-AccountId"></a>
이 작업을 사용하여 AWS 계정 액세스하거나 수정할의 12자리 계정 ID 번호를 지정합니다. 이 파라미터를 지정하지 않으면 기본적으로 작업을 호출하는 데 사용되는 자격 증명의 Amazon Web Services 계정으로 설정됩니다. 이 파라미터를 사용하려면 호출자가 [조직의 관리 계정](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`를 지정할 수 없습니다. `AccountId` 파라미터를 포함하지 않고 독립 실행형 컨텍스트에서 작업을 호출해야 합니다.
조직의 멤버가 아닌 계정에서 이 작업을 호출하려면 이 파라미터를 지정하지 마세요. 대신 연락처가 검색하거나 수정하려는 계정에 속한 자격 증명을 사용하여 작업을 호출합니다.  
유형: String  
패턴: `\d{12}`   
필수 여부: 아니요

 ** [RegionName](#API_GetRegionOptStatus_RequestSyntax) **   <a name="accounts-GetRegionOptStatus-request-RegionName"></a>
지정된 리전 이름에 리전 코드를 지정합니다(예: `af-south-1`). 이 함수는 이 파라미터에 전달하는 리전의 상태를 반환합니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
필수 항목 여부: 예

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

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

{
   "RegionName": "string",
   "RegionOptStatus": "string"
}
```

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

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

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

 ** [RegionName](#API_GetRegionOptStatus_ResponseSyntax) **   <a name="accounts-GetRegionOptStatus-response-RegionName"></a>
전달된 리전 코드입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.

 ** [RegionOptStatus](#API_GetRegionOptStatus_ResponseSyntax) **   <a name="accounts-GetRegionOptStatus-response-RegionOptStatus"></a>
리전이 거칠 수 있는 잠재적 상태 중 하나(활성화됨, 활성화 중, 비활성화됨, 비활성화 중, 기본값으로 활성화됨)입니다.  
타입: 문자열  
유효 값: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` 

## 오류
<a name="API_GetRegionOptStatus_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_GetRegionOptStatus_SeeAlso"></a>

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

# ListRegions
<a name="API_ListRegions"></a>

지정된 계정의 모든 리전과 해당 옵트인 상태를 나열합니다. 선택적으로 이 목록은 `region-opt-status-contains` 파라미터로 필터링할 수 있습니다.

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

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

{
   "AccountId": "string",
   "MaxResults": number,
   "NextToken": "string",
   "RegionOptStatusContains": [ "string" ]
}
```

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

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

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

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

 ** [AccountId](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-AccountId"></a>
이 작업을 사용하여 AWS 계정 액세스하거나 수정할의 12자리 계정 ID 번호를 지정합니다. 이 파라미터를 지정하지 않으면 기본적으로 작업을 호출하는 데 사용되는 자격 증명의 Amazon Web Services 계정으로 설정됩니다. 이 파라미터를 사용하려면 호출자가 [조직의 관리 계정](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`를 지정할 수 없습니다. `AccountId` 파라미터를 포함하지 않고 독립 실행형 컨텍스트에서 작업을 호출해야 합니다.
조직의 멤버가 아닌 계정에서 이 작업을 호출하려면 이 파라미터를 지정하지 마세요. 대신 연락처가 검색하거나 수정하려는 계정에 속한 자격 증명을 사용하여 작업을 호출합니다.  
유형: String  
패턴: `\d{12}`   
필수 여부: 아니요

 ** [MaxResults](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-MaxResults"></a>
명령의 출력에서 반환되는 항목의 총 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 명령의 출력에 `NextToken`이 제공됩니다. 페이지 매김을 재개하려면 후속 명령의 `starting-token` 인수에 `NextToken` 값을 제공합니다. AWS CLI 외부에서 직접 `NextToken` 응답 요소를 사용하지 마십시오. 사용 예제는 * AWS 명령줄 인터페이스 사용 설명서*의 [페이지 매김](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)을 참조하세요.  
타입: 정수  
유효 범위: 최소값 1. 최대값 50.  
필수 여부: 아니요

 ** [NextToken](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-NextToken"></a>
페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이는 이전에 잘린 응답에서 도출된 `NextToken`입니다. 사용 예제는 * AWS 명령줄 인터페이스 사용 설명서*의 [페이지 매김](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)을 참조하세요.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 1,000.  
필수 여부: 아니요

 ** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-RegionOptStatusContains"></a>
지정된 계정의 리전 목록을 필터링하는 데 사용할 리전 상태 목록(활성화 중, 활성화됨, 비활성화 중, 비활성화됨, 기본값으로 활성화됨)입니다. 예를 들어 ENABLING 값을 전달하면 리전 상태가 ENABLING인 리전 목록만 반환됩니다.  
유형: 문자열 배열  
유효 값: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`   
필수 항목 여부: 아니요

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

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

{
   "NextToken": "string",
   "Regions": [ 
      { 
         "RegionName": "string",
         "RegionOptStatus": "string"
      }
   ]
}
```

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

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

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

 ** [NextToken](#API_ListRegions_ResponseSyntax) **   <a name="accounts-ListRegions-response-NextToken"></a>
반환해야 할 데이터가 더 있는 경우 이 데이터가 채워집니다. `list-regions`의 `next-token` 요청 파라미터로 전달해야 합니다.  
유형: 문자열

 ** [Regions](#API_ListRegions_ResponseSyntax) **   <a name="accounts-ListRegions-response-Regions"></a>
지정된 계정의 리전 목록이거나 필터링된 파라미터가 사용된 경우 `filter` 파라미터에 설정된 필터 기준과 일치하는 리전 목록입니다.  
타입: [Region](API_Region.md) 객체 배열

## 오류
<a name="API_ListRegions_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_ListRegions_SeeAlso"></a>

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

# PutAccountName
<a name="API_PutAccountName"></a>

지정된 계정의 계정 이름을 업데이트합니다. 이 API를 사용하려면 IAM 위탁자에 `account:PutAccountName` IAM 권한이 있어야 합니다.

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

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

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

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

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

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

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

 ** [AccountId](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-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}`   
필수 여부: 아니요

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

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutAccountName_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_PutAccountName_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_PutAccountName_Examples"></a>

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

다음 예에서는 작업을 호출하는 데 사용되는 자격 증명을 가진 계정의 이름을 업데이트합니다.

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountName":"MyAccount"
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
```

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

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

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyMemberAccount"
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
```

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

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

# PutAlternateContact
<a name="API_PutAlternateContact"></a>

에 연결된 지정된 대체 연락처를 수정합니다 AWS 계정.

대체 연락처 작업을 사용하는 방법에 대한 자세한 내용은 [AWS 계정의 대체 연락처 업데이트](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)를 참조하세요.

**참고**  
에서 AWS 계정 관리하는에 대한 대체 연락처 정보를 업데이트하려면 먼저 AWS 계정 관리와 조직 간의 통합을 활성화 AWS Organizations해야 합니다. 자세한 내용은 [AWS 계정 관리에 대한 신뢰할 수 있는 액세스 활성화](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)를 참조하세요.

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

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

{
   "AccountId": "string",
   "AlternateContactType": "string",
   "EmailAddress": "string",
   "Name": "string",
   "PhoneNumber": "string",
   "Title": "string"
}
```

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

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

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

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

 ** [AccountId](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-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}`   
필수 여부: 아니요

 ** [AlternateContactType](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-AlternateContactType"></a>
생성 또는 업데이트하려는 대체 연락처를 지정합니다.  
타입: 문자열  
유효 값: `BILLING | OPERATIONS | SECURITY`   
필수 사항 여부: 예

 ** [EmailAddress](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-EmailAddress"></a>
대체 연락처의 이메일 주소를 지정합니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 254입니다.  
패턴: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`   
필수 여부: 예

 ** [Name](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-Name"></a>
대체 연락처의 이름을 지정합니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
필수 항목 여부: 예

 ** [PhoneNumber](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-PhoneNumber"></a>
대체 연락처의 전화번호를 지정합니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 25입니다.  
패턴: `[\s0-9()+-]+`   
필수 여부: 예

 ** [Title](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-Title"></a>
대체 연락처의 제목을 지정합니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
필수 항목 여부: 예

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutAlternateContact_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_PutAlternateContact_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_PutAlternateContact_Examples"></a>

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

다음 예에서는 작업을 호출하는 데 자격 증명이 사용되는 계정의 결제 대체 연락처를 설정합니다.

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact

{
    "AlternateContactType": "Billing",
    "Name": "Carlos Salazar",
    "Title": "CFO",
    "EmailAddress": "carlos@example.com",
    "PhoneNumber": "206-555-0199"
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
```

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

다음 예제에서는 조직의 지정된 멤버 계정의 결제 대체 연락처를 설정하거나 덮어씁니다. 조직의 관리 계정 또는 계정 관리 서비스의 위임된 관리자 계정의 자격 증명을 사용해야 합니다.

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact

{
    "AccountId": "123456789012",
    "AlternateContactType": "Billing",
    "Name": "Carlos Salazar",
    "Title": "CFO",
    "EmailAddress": "carlos@example.com",
    "PhoneNumber": "206-555-0199"
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
```

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

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

# PutContactInformation
<a name="API_PutContactInformation"></a>

 AWS 계정의 기본 연락처 정보를 업데이트합니다.

기본 연락처 작업을 사용하는 방법에 대한 자세한 내용은 [AWS 계정의 기본 연락처 업데이트](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html)를 참조하세요.

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

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

{
   "AccountId": "string",
   "ContactInformation": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "AddressLine3": "string",
      "City": "string",
      "CompanyName": "string",
      "CountryCode": "string",
      "DistrictOrCounty": "string",
      "FullName": "string",
      "PhoneNumber": "string",
      "PostalCode": "string",
      "StateOrRegion": "string",
      "WebsiteUrl": "string"
   }
}
```

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

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

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

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

 ** [AccountId](#API_PutContactInformation_RequestSyntax) **   <a name="accounts-PutContactInformation-request-AccountId"></a>
이 작업을 사용하여 AWS 계정 액세스하거나 수정할의 12자리 계정 ID 번호를 지정합니다. 이 파라미터를 지정하지 않으면 기본적으로 작업을 호출하는 데 사용되는 자격 증명의 Amazon Web Services 계정으로 설정됩니다. 이 파라미터를 사용하려면 호출자가 [조직의 관리 계정](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}`   
필수 여부: 아니요

 ** [ContactInformation](#API_PutContactInformation_RequestSyntax) **   <a name="accounts-PutContactInformation-request-ContactInformation"></a>
 AWS 계정과 연결된 기본 연락처 정보의 세부 정보를 포함합니다.  
타입: [ContactInformation](API_ContactInformation.md)객체  
필수 여부: 예

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutContactInformation_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_PutContactInformation_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_PutContactInformation_SeeAlso"></a>

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

# StartPrimaryEmailUpdate
<a name="API_StartPrimaryEmailUpdate"></a>

지정된 계정의 기본 이메일 주소를 업데이트하는 프로세스를 시작합니다.

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

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

{
   "AccountId": "string",
   "PrimaryEmail": "string"
}
```

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

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

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

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

 ** [AccountId](#API_StartPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-request-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}`   
필수 여부: 예

 ** [PrimaryEmail](#API_StartPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-request-PrimaryEmail"></a>
지정된 계정에서 사용할 새 기본 이메일 주소(루트 사용자 이메일 주소라고도 함)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 5입니다. 최대 길이는 64.  
필수 항목 여부: 예

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

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

{
   "Status": "string"
}
```

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

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

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

 ** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-response-Status"></a>
기본 이메일 업데이트 요청의 상태입니다.  
타입: 문자열  
유효 값: `PENDING | ACCEPTED` 

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

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

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

 ** ConflictException **   
리소스의 현재 상태에 충돌이 발생하여 요청을 처리할 수 없습니다. 예를 들어, 현재 비활성화된 리전(비활성화 상태)을 활성화하려고 하거나 계정의 루트 사용자 이메일을 이미 사용 중인 이메일 주소로 변경하려고 하면 이 문제가 발생합니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 409

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

 ** ResourceNotFoundException **   
찾을 수 없는 리소스 지정으로 인해 작업이 실패했습니다.    
 ** errorType **   
API Gateway에 의해 `x-amzn-ErrorType` 응답 헤더에 채워지는 값입니다.
HTTP 상태 코드: 404

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

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

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

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