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

# API 참조
<a name="api-reference"></a>

계정 관리(`account`) 네임스페이스의 API 작업을 통해를 수정할 수 있습니다 AWS 계정.

모든는 계정과 연결된 최대 3개의 대체 연락처에 대한 정보를 포함하여 계정에 대한 정보가 포함된 메타데이터를 AWS 계정 지원합니다. 이는 계정의 [루트 사용자](root-user.md)와 연결된 이메일 주소에 추가됩니다. 계정과 연결된 다음 각 연락 유형 중 하나만 지정할 수 있습니다.
+ 결제 연락처
+ 운영 연락처
+ 보안 연락처

기본적으로 이 가이드에서 설명하는 API 작업은 작업을 호출하는 계정에 직접 적용됩니다. 작업을 호출하는 계정의 [자격 증명](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)은 일반적으로 IAM 역할 또는 IAM 사용자이며 API 작업을 호출하려면 IAM 정책에서 적용하는 권한이 있어야 합니다. 또는 관리 계정의 자격 증명 AWS Organizations 에서 이러한 API 작업을 호출하고 조직의 멤버 AWS 계정 인의 계정 ID 번호를 지정할 수 있습니다.

 **API 버전** 

이 버전의 계정 API 참조는 계정 관리 API 버전 2021-02-01을 문서화합니다.

**참고**  
API를 직접 사용하는 대신 다양한 프로그래밍 언어 및 플랫폼(Java, Ruby, .NET, iOS, Android 등)에 대한 라이브러리 및 샘플 코드로 구성된 AWS SDKs 중 하나를 사용할 수 있습니다. SDKs는 AWS Organizations에 프로그래밍 방식으로 액세스할 수 있는 편리한 방법을 제공합니다. 예를 들어 SDK는 요청에 암호화 방식으로 서명, 오류 관리 및 자동으로 요청 재시도와 같은 작업을 처리합니다. 다운로드 및 설치 방법을 포함하여 AWS SDKs에 대한 자세한 내용은 [Amazon Web Services용 도구를](https://console.aws.amazon.com/) 참조하세요.

 AWS SDKs를 사용하여 계정 관리 서비스에 프로그래밍 방식 API 호출을 수행하는 것이 좋습니다. 그러나 계정 관리 Query API를 사용하여 계정 관리 웹 서비스에 직접 호출할 수도 있습니다. 계정 관리 Query API에 대한 자세한 내용은 계정 관리 사용 설명서의 [HTTP 쿼리 요청을 통한 API 호출](query-requests.md) 섹션을 참조하세요. 조직은 모든 작업에 대해 GET 및 POST 요청을 지원합니다. 즉, API 사용 시 어떤 작업에는 GET을 사용하고 또 어떤 작업에는 POST를 사용할 필요가 없습니다. 하지만 GET 요청에는 URL 크기 제한이 적용됩니다. 따라서 크기가 더 큰 작업이 필요한 경우 POST 요청을 사용합니다.

**요청에 서명하기**

HTTP 요청을 보낼 때가 요청을 보낸 사람을 식별할 AWS 수 있도록 요청에 서명해야 AWS합니다. AWS 액세스 키 ID와 보안 액세스 키로 구성된 액세스 키를 사용하여 요청에 서명합니다. 루트 계정에 대한 액세스 키 페어는 생성하지 않는 것이 좋습니다. 루트 계정에 대한 액세스 키를 보유한 사람은 누구든지 계정의 모든 리소스에 무제한으로 액세스할 수 있습니다. 대신 관리 권한이 있는 IAM 사용자의 액세스 키를 생성합니다. 또 다른 옵션으로 AWS Security Token Service를 사용하여 임시 보안 자격 증명을 생성하고 해당 자격 증명을 사용하여 요청에 서명합니다.

요청에 서명하려면 Signature Version 4를 사용하는 것이 좋습니다. Signature Version 2를 사용하는 기존 애플리케이션이 있는 경우 Signature Version 4를 사용하도록 업데이트할 필요가 없습니다. 그러나 이제 일부 작업에는 Signature Version 4가 필요합니다. Signature Version 4가 필요한 작업에 대한 설명서는 이 요구 사항이 필요합니다. 자세한 내용은 *IAM 사용 설명서*의 [AWS API 요청 서명을](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) 참조하세요.

 AWS 명령줄 인터페이스(AWS CLI) 또는 AWS SDKs 중 하나를 사용하여 요청을 할 때 AWS이러한 도구는 도구를 구성할 때 지정한 액세스 키로 요청에 자동으로 서명합니다.

**계정 관리에 대한 지원 및 피드백**

우리는 여러분의 의견을 환영합니다. [feedback-awsaccounts@amazon.com](mailto://feedback-awsaccounts@amazon.com)으로 의견을 보내거나 [계정 관리 지원 포럼](https://forums.aws.amazon.com/forum.jspa?forumID=219)에 피드백과 질문을 게시합니다. AWS 지원 포럼에 대한 자세한 내용은 [포럼 도움말을 참조하세요](https://forums.aws.amazon.com/help.jspa).

**예 제시 방법**

요청에 대한 응답으로 계정 관리에서 반환하는 JSON은 줄 바꿈 또는 서식 공백 없이 긴 단일 문자열로 반환됩니다. 가독성을 높이기 위해 이 가이드의 예제에는 줄 바꿈과 공백이 모두 표시됩니다. 예제 입력 파라미터로 인해 긴 문자열이 화면 밖으로 확장되는 경우 줄 바꿈을 삽입하여 가독성을 높입니다. 항상 입력을 단일 JSON 텍스트 문자열로 제출해야 합니다.

**API 요청 기록**

계정 관리는에 대한 AWS API 호출을 기록하고 Amazon S3 버킷에 로그 파일을 AWS 계정 전송하는 서비스인 CloudTrail을 지원합니다. CloudTrail에서 수집된 정보를 사용하여 계정 관리에 대한 성공적인 요청, 요청자, 요청 시기 등을 결정할 수 있습니다. 계정 관리 및 CloudTrail에 대한 계정 관리의 지원에 대한 자세한 내용은 [를 사용하여 AWS 계정 관리 API 호출 로깅 AWS CloudTrail](monitoring-cloudtrail.md) 섹션을 참조하세요. 설정 방법 및 로그 파일을 찾는 방법을 비롯한 CloudTrail에 대한 자세한 내용은 [AWS CloudTrail 사용 설명서](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)를 참조하세요.

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

# 다른 AWS 서비스의 관련 작업
<a name="API_Related_Operations"></a>

다음 작업은와 관련이 AWS Account Management 있지만 네임스페이스의 AWS Organizations 일부입니다.
+ [CreateAccount](API_CreateAccount.md)
+ [CreateGovCloudAccount](API_CreateGovCloudAccount.md)
+ [DescribeAccount](API_DescribeAccount.md)

# CreateAccount
<a name="API_CreateAccount"></a>

`CreateAccount` API 작업은 AWS Organizations 서비스에서 관리하는 조직의 컨텍스트에서만 사용할 수 있습니다. API 작업은 해당 서비스의 네임스페이스에 정의됩니다.

자세한 내용은 *AWS Organizations API 참조*의 [CreateAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateAccount.html)를 참조하세요.

# CreateGovCloudAccount
<a name="API_CreateGovCloudAccount"></a>

`CreateGovCloudAccount` API 작업은 AWS Organizations 서비스에서 관리하는 조직의 컨텍스트에서만 사용할 수 있습니다. API 작업은 해당 서비스의 네임스페이스에 정의됩니다.

자세한 내용은 *AWS Organizations API 참조*의 [CreateGovCloudAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateGovCloudAccount.html)를 참조하세요.

# DescribeAccount
<a name="API_DescribeAccount"></a>

`DescribeAccount` API 작업은 AWS Organizations 서비스에서 관리하는 조직의 컨텍스트에서만 사용할 수 있습니다. API 작업은 해당 서비스의 네임스페이스에 정의됩니다.

자세한 내용은 *AWS Organizations API 참조*의 [DescribeAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_DescribeAccount.html)를 참조하세요.

# 데이터 타입
<a name="API_Types"></a>

다음 데이터 타입이 지원됩니다.
+  [AlternateContact](API_AlternateContact.md) 
+  [ContactInformation](API_ContactInformation.md) 
+  [Region](API_Region.md) 
+  [ValidationExceptionField](API_ValidationExceptionField.md) 

# AlternateContact
<a name="API_AlternateContact"></a>

 AWS 계정과 연결된 대체 연락처의 세부 정보가 포함된 구조

## 내용
<a name="API_AlternateContact_Contents"></a>

 ** AlternateContactType **   <a name="accounts-Type-AlternateContact-AlternateContactType"></a>
대체 연락처의 유형입니다.  
타입: 문자열  
유효 값: `BILLING | OPERATIONS | SECURITY`   
필수 여부: 아니요

 ** EmailAddress **   <a name="accounts-Type-AlternateContact-EmailAddress"></a>
이 대체 연락처와 연결된 이메일 주소입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 254입니다.  
패턴: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`   
필수 여부: 아니요

 ** Name **   <a name="accounts-Type-AlternateContact-Name"></a>
이 대체 연락처와 연결된 이름입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
필수 여부: 아니요

 ** PhoneNumber **   <a name="accounts-Type-AlternateContact-PhoneNumber"></a>
이 대체 연락처와 연결된 전화번호입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 25입니다.  
패턴: `[\s0-9()+-]+`   
필수 여부: 아니요

 ** Title **   <a name="accounts-Type-AlternateContact-Title"></a>
이 대체 연락처와 연결된 제목입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50입니다.  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AlternateContact) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AlternateContact) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AlternateContact) 

# ContactInformation
<a name="API_ContactInformation"></a>

 AWS 계정과 연결된 기본 연락처 정보의 세부 정보를 포함합니다.

## 내용
<a name="API_ContactInformation_Contents"></a>

 ** AddressLine1 **   <a name="accounts-Type-ContactInformation-AddressLine1"></a>
기본 연락처 주소의 첫 번째 줄입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 60입니다.  
필수 항목 여부: 예

 ** City **   <a name="accounts-Type-ContactInformation-City"></a>
기본 연락처 주소의 도시입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
필수 항목 여부: 예

 ** CountryCode **   <a name="accounts-Type-ContactInformation-CountryCode"></a>
기본 연락처 주소의 ISO-3166 국가 코드 2자입니다.  
유형: 문자열  
길이 제약 조건: 고정 길이는 2입니다.  
필수 항목 여부: 예

 ** FullName **   <a name="accounts-Type-ContactInformation-FullName"></a>
기본 연락처 주소의 전체 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
필수 항목 여부: 예

 ** PhoneNumber **   <a name="accounts-Type-ContactInformation-PhoneNumber"></a>
기본 연락처 정보의 전화번호입니다. 숫자는 검증되며, 일부 국가에서는 활성화 여부를 확인합니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 20입니다.  
패턴: `[+][\s0-9()-]+`   
필수 여부: 예

 ** PostalCode **   <a name="accounts-Type-ContactInformation-PostalCode"></a>
기본 연락처 주소의 우편 번호입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 20입니다.  
필수 항목 여부: 예

 ** AddressLine2 **   <a name="accounts-Type-ContactInformation-AddressLine2"></a>
기본 연락처 주소의 두 번째 줄입니다(있는 경우).  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 60입니다.  
필수 여부: 아니요

 ** AddressLine3 **   <a name="accounts-Type-ContactInformation-AddressLine3"></a>
기본 연락처 주소의 세 번째 줄입니다(있는 경우).  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 60입니다.  
필수 여부: 아니요

 ** CompanyName **   <a name="accounts-Type-ContactInformation-CompanyName"></a>
기본 연락처 정보와 연결된 회사의 이름입니다(있는 경우).  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50입니다.  
필수 여부: 아니요

 ** DistrictOrCounty **   <a name="accounts-Type-ContactInformation-DistrictOrCounty"></a>
기본 연락처 주소의 시/군/구 또는 카운티입니다(있는 경우).  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50입니다.  
필수 여부: 아니요

 ** StateOrRegion **   <a name="accounts-Type-ContactInformation-StateOrRegion"></a>
기본 연락처 주소의 상태 또는 리전입니다. 우편 주소가 미국(US) 내에 있는 경우 이 필드의 값은 주 코드 2자(예: `NJ`) 또는 전체 주 이름(예: `New Jersey`)일 수 있습니다. 이 필드는 `US`, `CA`, `GB`, `DE`, `JP`, `IN`, `BR`의 국가에서 필수입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50입니다.  
필수 여부: 아니요

 ** WebsiteUrl **   <a name="accounts-Type-ContactInformation-WebsiteUrl"></a>
기본 연락처 정보와 연결된 웹 사이트의 URL입니다(있는 경우).  
유형: 문자열  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256.  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ContactInformation) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ContactInformation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ContactInformation) 

# Region
<a name="API_Region"></a>

이는 지정된 계정의 리전을 표현하는 구조로, 이름과 옵트인 상태로 구성됩니다.

## 내용
<a name="API_Region_Contents"></a>

 ** RegionName **   <a name="accounts-Type-Region-RegionName"></a>
지정된 리전의 리전 코드(예: `us-east-1`)입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50입니다.  
필수 여부: 아니요

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

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/Region) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/Region) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/Region) 

# ValidationExceptionField
<a name="API_ValidationExceptionField"></a>

입력이 지정된 필드의 AWS 서비스에서 지정한 제약 조건을 충족하지 못했습니다.

## 내용
<a name="API_ValidationExceptionField_Contents"></a>

 ** message **   <a name="accounts-Type-ValidationExceptionField-message"></a>
검증 예외에 대한 메시지입니다.  
유형: 문자열  
필수 항목 여부: 예

 ** name **   <a name="accounts-Type-ValidationExceptionField-name"></a>
잘못된 항목이 감지된 필드 이름입니다.  
유형: 문자열  
필수 항목 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ValidationExceptionField) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ValidationExceptionField) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ValidationExceptionField) 

# 공통 파라미터
<a name="CommonParameters"></a>

다음 목록에는 모든 작업이 쿼리 문자열을 사용하여 Signature Version 4 요청에 서명하는 데 사용하는 파라미터가 포함되어 있습니다. 작업별 파라미터는 그 작업에 대한 항목에 나열되어 있습니다. 서명 버전 4에 대한 자세한 내용은 *IAM 사용 설명서*의 [AWS API 요청 서명을](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) 참조하세요.

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
요청 서명을 생성하는 데 사용된 해시 알고리즘입니다.  
조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다.  
타입: 문자열  
유효 값: `AWS4-HMAC-SHA256`   
필수 항목 여부: 조건부

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
자격 증명 범위 값이며 액세스 키, 날짜, 대상으로 하는 리전, 요청하는 서비스 및 종료 문자열("aws4\$1request")이 포함된 문자열입니다. 값은 다음 형식으로 표시됩니다. *access\$1key*/*YYYYMMDD*/*region*/*service*/aws4\$1request.  
자세한 내용은 *IAM 사용 설명서*의 [서명된 AWS API 요청 생성을](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) 참조하세요.  
조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다.  
타입: 문자열  
필수 항목 여부: 조건부

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
서명을 만드는 데 사용되는 날짜입니다. 형식은 ISO 8601 기본 형식(YYYYMMDD'T'HHMMSS'Z')이어야 합니다. 예를 들어 다음 날짜 시간은 유효한 X-Amz-Date 값: `20120325T120000Z`.  
조건: X-Amz-Date는 모든 요청에서 옵션이지만 서명 요청에 사용되는 날짜보다 우선할 때 사용됩니다. 날짜 헤더가 ISO 8601 기본 형식으로 지정된 경우 X-Amz-Date가 필요하지 않습니다. X-Amz-Date를 사용하는 경우 항상 Date 헤더의 값을 재정의합니다. 자세한 내용은 *IAM 사용 설명서*[의 AWS API 요청 서명 요소를](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) 참조하세요.  
타입: 문자열  
필수 항목 여부: 조건부

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
 AWS Security Token Service ()에 대한 호출을 통해 얻은 임시 보안 토큰입니다AWS STS. AWS STS의 임시 보안 인증 정보를 지원하는 서비스 목록은 **IAM 사용 설명서의 [IAM으로 작업하는AWS 서비스](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)를 참조하세요.  
조건:에서 임시 보안 자격 증명을 사용하는 경우 보안 토큰을 포함해야 AWS STS합니다.  
타입: 문자열  
필수 항목 여부: 조건부

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
서명할 문자열과 파생된 서명 키에서 계산된 16진수로 인코딩된 서명을 지정합니다.  
조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다.  
타입: 문자열  
필수 항목 여부: 조건부

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
표준 요청의 일부로 포함된 모든 HTTP 헤더를 지정합니다. 서명된 헤더 지정에 대한 자세한 내용은 *IAM 사용 설명서*의 [서명된 AWS API 요청 생성을](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) 참조하세요.  
조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다.  
타입: 문자열  
필수 항목 여부: 조건부

# 일반적인 오류 유형
<a name="CommonErrors"></a>

이 섹션에는이 AWS 서비스가 반환할 수 있는 일반적인 오류 유형이 나열되어 있습니다. 모든 서비스가 여기에 나열된 모든 오류 유형을 반환하는 것은 아닙니다. 이 서비스의 API 작업에 대한 오류는 해당 API 작업에 대한 주제를 참조하세요.

 **AccessDeniedException**   <a name="CommonErrors-AccessDeniedException"></a>
이 작업을 수행하려면 권한이 있어야 합니다. IAM 정책에 필요한 권한이 포함되어 있는지 확인합니다.  
HTTP 상태 코드: 403

 **ExpiredTokenException**   <a name="CommonErrors-ExpiredTokenException"></a>
요청에 포함된 보안 토큰이 만료되었습니다. 새 보안 토큰을 요청하고 다시 시도하세요.  
HTTP 상태 코드: 403

 **IncompleteSignature**   <a name="CommonErrors-IncompleteSignature"></a>
요청 서명이 AWS 표준을 준수하지 않습니다. 유효한 AWS 자격 증명을 사용하고 있고 요청의 형식이 올바른지 확인합니다. SDK를 사용하는 경우 최신 상태인지 확인합니다.  
HTTP 상태 코드: 403

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
내부 서버 문제로 인해 현재 요청을 처리할 수 없습니다. 나중에 다시 시도해 주세요. 문제가 지속되면 AWS Support에 문의하세요.  
HTTP 상태 코드: 500

 **MalformedHttpRequestException**   <a name="CommonErrors-MalformedHttpRequestException"></a>
요청 본문을 처리할 수 없습니다. 이는 일반적으로 지정된 콘텐츠 인코딩 알고리즘을 사용하여 요청 본문의 압축을 풀 수 없는 경우에 발생합니다. 콘텐츠 인코딩 헤더가 사용된 압축 형식과 일치하는지 확인합니다.  
HTTP 상태 코드: 400

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
이 작업을 수행할 권한이 없습니다. IAM 정책에 필요한 권한이 포함되어 있는지 확인합니다.  
HTTP 상태 코드: 401

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
 AWS 계정에이 서비스에 대한 구독이 필요합니다. 계정에서 서비스를 활성화했는지 확인합니다.  
HTTP 상태 코드: 403

 **RequestAbortedException**   <a name="CommonErrors-RequestAbortedException"></a>
응답이 반환되기 전에 요청이 중단되었습니다. 이는 일반적으로 클라이언트가 연결을 닫을 때 발생합니다.  
HTTP 상태 코드: 400

 **RequestEntityTooLargeException**   <a name="CommonErrors-RequestEntityTooLargeException"></a>
요청 엔티티가 너무 큽니다. 요청 본문의 크기를 줄이고 다시 시도하세요.  
HTTP 상태 코드: 413

 **RequestTimeoutException**   <a name="CommonErrors-RequestTimeoutException"></a>
요청 시간이 초과되었습니다. 서버가 예상 기간 내에 전체 요청을 받지 못했습니다. 다시 시도하세요.  
HTTP 상태 코드: 408

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도해 주세요.  
HTTP 상태 코드: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
요청 속도가 너무 높습니다. AWS SDKs 자동으로 재시도합니다. 요청 횟수를 줄입니다.  
HTTP 상태 코드: 400

 **UnknownOperationException**   <a name="CommonErrors-UnknownOperationException"></a>
작업 또는 작업이 인식되지 않습니다. 작업 이름의 철자가 올바르고 사용 중인 API 버전에서 지원되는지 확인합니다.  
HTTP 상태 코드: 404

 **UnrecognizedClientException**   <a name="CommonErrors-UnrecognizedClientException"></a>
제공한 X.509 인증서 또는 AWS 액세스 키 ID가 레코드에 없습니다. 유효한 자격 증명을 사용하고 있고 만료되지 않았는지 확인합니다.  
HTTP 상태 코드: 403

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
입력이 필수 형식 또는 제약 조건을 충족하지 않습니다. 모든 필수 파라미터가 포함되어 있고 값이 유효한지 확인합니다.  
HTTP 상태 코드: 400

# HTTP 쿼리 요청을 통한 API 호출
<a name="query-requests"></a>

이 섹션에는 AWS 계정 관리를 위한 쿼리 API 사용에 대한 일반적인 정보가 포함되어 있습니다. API 작업 및 오류에 대한 자세한 정보는 [API 참조](api-reference.md)를 참조하십시오.

**참고**  
 AWS 계정 관리 쿼리 API를 직접 호출하는 대신 AWS SDKs. AWS SDKs는 다양한 프로그래밍 언어 및 플랫폼(Java, Ruby, .NET, iOS, Android 등)을 위한 라이브러리와 샘플 코드로 구성됩니다. SDKs는 AWS 계정 관리 및에 프로그래밍 방식으로 액세스할 수 있는 편리한 방법을 제공합니다 AWS. 예를 들어 SDK는 요청에 암호화 방식으로 서명, 오류 관리 및 자동으로 요청 재시도와 같은 작업을 처리합니다. 다운로드 및 설치 방법을 포함하여 AWS SDKs에 대한 자세한 내용은 [Amazon Web Services용 도구를](https://aws.amazon.com/tools) 참조하세요.

 AWS 계정 관리용 쿼리 API를 사용하면 서비스 작업을 호출할 수 있습니다. 쿼리 API 요청은 수행할 작업을 나타내는 `Action` 파라미터를 포함해야 하는 HTTPS 요청입니다. AWS 계정 관리는 모든 작업에 대해 `GET` 및 `POST` 요청을 지원합니다. 즉, API 사용 시 어떤 작업에는 `GET`을 사용하고 또 어떤 작업에는 `POST`를 사용할 필요가 없습니다. 하지만 `GET` 요청에는 URL 크기 제한이 적용됩니다. 제한은 브라우저에 따라 다르지만, 일반적으로 2,048바이트입니다. 따라서 더 큰 크기가 필요한 쿼리 API 요청의 경우 `POST` 요청을 사용해야 합니다.

응답은 XML 문서입니다. 응답에 대한 자세한 내용은 [API 참조](api-reference.md)의 개별 작업 페이지를 참조하십시오.

**Topics**
+ [엔드포인트](#endpoints)
+ [HTTPS 필요](#IAMHTTPSRequired)
+ [AWS Account Management API 요청 서명](#SigVersion)

## 엔드포인트
<a name="endpoints"></a>

AWS 계정 관리에는 미국 동부(버지니아 북부)에서 호스팅되는 단일 글로벌 API 엔드포인트가 있습니다 AWS 리전.

모든 서비스의 AWS 엔드포인트 및 리전에 대한 자세한 내용은의 [리전 및 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/rande.html)를 참조하세요*AWS 일반 참조*.

## HTTPS 필요
<a name="IAMHTTPSRequired"></a>

쿼리 API는 보안 자격 증명과 같이 민감한 정보를 반환할 수 있으므로 HTTPS를 이용해 모든 API 요청을 암호화해야 합니다.

## AWS Account Management API 요청 서명
<a name="SigVersion"></a>

액세스 키 ID와 보안 액세스 키를 사용하여 요청에 서명해야 합니다. AWS 계정 관리의 일상적인 작업에 AWS 루트 계정 자격 증명을 사용하지 않는 것이 좋습니다. AWS Identity and Access Management (IAM) 사용자에 대한 자격 증명 또는 IAM 역할과 함께를 사용하는 등의 임시 자격 증명을 사용할 수 있습니다.

API 요청에 서명하려면 AWS 서명 버전 4를 사용해야 합니다. 서명 버전 4 사용에 대한 자세한 내용은 *IAM 사용 설명서*의 [AWS API 요청 서명을](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) 참조하세요.

자세한 내용은 다음을 참조하세요.
+ [AWS 보안 자격 증명](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) – AWS액세스를 위해 사용 가능한 자격 증명 유형에 대한 일반 정보를 제공합니다.
+ [IAM의 보안 모범 사례](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) - IAM 서비스를 사용하여 AWS 계정 관리의 리소스를 포함한 AWS 리소스를 보호하는 데 도움이 되는 제안을 제공합니다.
+ [IAM의 임시 자격 증명](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) – 임시 보안 자격 증명을 생성하고 사용하는 방법에 대해 설명합니다.