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

# CreateAccountSubscription
<a name="API_CreateAccountSubscription"></a>

Amazon 생성 QuickSight 계정 또는 아마존 구독 QuickSight Q.

이AWS 리전에 구성된 항목에서 계정이 파생됩니다.AWS CLI또는 SDK. 이 작업은 미국 동부 (오하이오) 리전, 남아메리카 (상파울루) 리전 또는 아시아 태평양 (싱가포르) 리전에서 지원되지 않습니다.

이 작업을 사용하기 전에 기존 작업에 연결할 수 있는지 확인하십시오.AWS 계정. 계정이 없는 경우AWS 계정, 참조[에 가입AWS](https://docs.aws.amazon.com/quicksight/latest/user/setting-up-aws-sign-up.html)의*아마존 QuickSight 사용 설명서*. 아마존에 가입한 사람 QuickSight 올바른 정보가 필요합니다.AWS Identity and Access Management(IAM) 권한입니다. 자세한 내용은 단원을 참조하십시오.[Amazon IAM 정책 예제 QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/iam-policy-examples.html)의*아마존 QuickSight 사용 설명서*.

IAM 정책에 다음 항목이 모두 포함되어 있는 경우`Subscribe`과`CreateAccountSubscription`작업, 두 동작이 모두 로 설정되어 있는지 확인`Allow`. 작업 중 하나가 로 설정된 경우`Deny`, 그`Deny`작업이 우선하며 API 호출이 실패합니다.

기존 IAM 역할을 전달하여 다른 IAM 역할에 액세스할 수 없습니다.AWSAPI 작업을 사용하는 서비스. 기존 IAM 역할을 아마존에 전달하려면 QuickSight, 참조[아마존에 IAM 역할 전달 QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/security_iam_service-with-iam.html#security-create-iam-role)의*아마존 QuickSight 사용 설명서*.

Amazon에서 새 계정에 대한 기본 리소스 액세스를 설정할 수 없습니다. QuickSightAPI. 대신 Amazon에서 기본 리소스 액세스를 추가합니다. QuickSight 콘솔. 기본 리소스 액세스 설정에 대한 자세한 내용은AWS서비스, 참조[기본 리소스 액세스 설정AWS서비스](https://docs.aws.amazon.com/quicksight/latest/user/scoping-policies-defaults.html)의*아마존 QuickSight사용 설명서*.

## 요청 구문
<a name="API_CreateAccountSubscription_RequestSyntax"></a>

```
POST /account/AwsAccountId HTTP/1.1
Content-type: application/json

{
   "AccountName": "string",
   "ActiveDirectoryName": "string",
   "AdminGroup": [ "string" ],
   "AuthenticationMethod": "string",
   "AuthorGroup": [ "string" ],
   "ContactNumber": "string",
   "DirectoryId": "string",
   "Edition": "string",
   "EmailAddress": "string",
   "FirstName": "string",
   "LastName": "string",
   "NotificationEmail": "string",
   "ReaderGroup": [ "string" ],
   "Realm": "string"
}
```

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

요청은 다음의 URI 파라미터를 사용합니다.

 ** [AwsAccountId](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AwsAccountId"></a>
이AWS 계정Amazon을 만들기 위해 사용하는 계정 ID QuickSight 계정.  
길이 제약 조건: 고정 길이는 12자입니다.  
패턴: `^[0-9]{12}$`   
필수 사항: 예

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

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

 ** [AccountName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AccountName"></a>
Amazon 이름 QuickSight 계정. 이 이름은 모두 고유합니다.AWS로 표시되며 사용자가 로그인할 때만 표시됩니다. 변경할 수 없습니다.`AccountName`아마존 이후의 가치 QuickSight 계정이 생성되었습니다.  
Type: 문자열  
필수 사항: 예

 ** [AuthenticationMethod](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AuthenticationMethod"></a>
Amazon을 인증하기 위해 사용하려는 방법 QuickSight 계정. 현재 이 파라미터에 유효한 값은 입니다.`IAM_AND_QUICKSIGHT`,`IAM_ONLY`, 그리고`ACTIVE_DIRECTORY`.  
선택 항목:`ACTIVE_DIRECTORY`, 다음을 제공합니다.`ActiveDirectoryName`그리고`AdminGroup`Active Directory 와 연결되어 있습니다.  
Type: 문자열  
유효한 값:` IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY`   
필수 사항: 예

 ** [Edition](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-Edition"></a>
아마존 에디션 QuickSight 귀하의 계정에 갖고 싶은 것을 말이죠. 현재 선택 항목:`ENTERPRISE`또는`ENTERPRISE_AND_Q`.  
선택 항목:`ENTERPRISE_AND_Q`를 사용하려면 다음 파라미터가 필요합니다.  
+  `FirstName` 
+  `LastName` 
+  `EmailAddress` 
+  `ContactNumber` 
Type: 문자열  
유효한 값:` STANDARD | ENTERPRISE | ENTERPRISE_AND_Q`   
필수 사항: 예

 ** [NotificationEmail](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-NotificationEmail"></a>
아마존에서 원하는 이메일 주소 QuickSight 를 사용하여 Amazon에 대한 알림을 보냅니다. QuickSight 계정 또는 아마존 QuickSight 구독.  
Type: 문자열  
필수 사항: 예

 ** [ActiveDirectoryName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ActiveDirectoryName"></a>
액티브 디렉터리 이름입니다. 의 경우 이 필드는 필수입니다.`ACTIVE_DIRECTORY`새 Amazon에서 선택한 인증 방법입니다. QuickSight 계정.  
Type: 문자열  
필수 사항: 아니요

 ** [AdminGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AdminGroup"></a>
액티브 디렉터리에 연결된 관리자 그룹입니다. 의 경우 이 필드는 필수입니다.`ACTIVE_DIRECTORY`새 Amazon에서 선택한 인증 방법입니다. QuickSight 계정. 아마존에서 Active Directory 사용에 대한 자세한 내용은 QuickSight, 참조[Active Directory 사용 QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)에서 Amazon QuickSight사용 설명서.  
Type: 문자열 배열  
필수 사항: 아니요

 ** [AuthorGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AuthorGroup"></a>
Active Directory와 연결된 저자 그룹입니다. 아마존에서 Active Directory 사용에 대한 자세한 내용은 QuickSight, 참조[Active Directory 사용 QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)에서 Amazon QuickSight사용 설명서.  
Type: 문자열 배열  
필수 사항: 아니요

 ** [ContactNumber](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ContactNumber"></a>
아마존 작성자의 10자리 전화 번호 QuickSight future 커뮤니케이션에 사용할 계정. 의 경우 이 필드는 필수입니다.`ENTERPPRISE_AND_Q`새 아마존에서 선택한 에디션입니다. QuickSight 계정.  
Type: 문자열  
필수 사항: 아니요

 ** [DirectoryId](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-DirectoryId"></a>
아마존에 연결된 Active Directory의 ID QuickSight 계정.  
Type: 문자열  
필수 사항: 아니요

 ** [EmailAddress](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-EmailAddress"></a>
아마존 작성자의 이메일 주소 QuickSight future 커뮤니케이션에 사용할 계정. 의 경우 이 필드는 필수입니다.`ENTERPPRISE_AND_Q`새 아마존에서 선택한 에디션입니다. QuickSight 계정.  
Type: 문자열  
필수 사항: 아니요

 ** [FirstName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-FirstName"></a>
아마존 작성자의 이름입니다. QuickSight future 커뮤니케이션에 사용할 계정. 의 경우 이 필드는 필수입니다.`ENTERPPRISE_AND_Q`새 아마존에서 선택한 에디션입니다. QuickSight 계정.  
Type: 문자열  
필수 사항: 아니요

 ** [LastName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-LastName"></a>
아마존 작성자의 성입니다. QuickSight future 커뮤니케이션에 사용할 계정. 의 경우 이 필드는 필수입니다.`ENTERPPRISE_AND_Q`새 아마존에서 선택한 에디션입니다. QuickSight 계정.  
Type: 문자열  
필수 사항: 아니요

 ** [ReaderGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ReaderGroup"></a>
액티브 디렉터리에 연결된 리더 그룹입니다. 아마존에서 Active Directory 사용에 대한 자세한 내용은 QuickSight, 참조[Active Directory 사용 QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)의*아마존 QuickSight사용 설명서*.  
Type: 문자열 배열  
필수 사항: 아니요

 ** [Realm](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-Realm"></a>
아마존과 연결된 액티브 디렉토리의 영역입니다. QuickSight 계정. 의 경우 이 필드는 필수입니다.`ACTIVE_DIRECTORY`새 Amazon에서 선택한 인증 방법입니다. QuickSight 계정.  
Type: 문자열  
필수 사항: 아니요

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

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

{
   "RequestId": "string",
   "SignupResponse": { 
      "accountName": "string",
      "directoryType": "string",
      "IAMUser": boolean,
      "userLoginName": "string"
   }
}
```

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

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

 ** [Status](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-Status"></a>
요청의 HTTP 상태입니다.

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

 ** [RequestId](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-RequestId"></a>
이AWS작업에 대한 요청 ID입니다.  
Type: 문자열

 ** [SignupResponse](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-SignupResponse"></a>
A`SignupResponse`새로 생성된 Amazon에 대한 정보를 반환하는 객체 QuickSight 계정.  
유형: [SignupResponse](API_SignupResponse.md) 객체

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

모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.[일반적인 오류](CommonErrors.md).

 ** AccessDeniedException **   
이 항목에 액세스할 수 없습니다. 제공된 자격 증명을 검증할 수 없습니다. 요청을 수행할 권한이 없을 수도 있습니다. 계정이 Amazon을 사용할 수 있도록 승인되었는지 확인합니다. QuickSight 정책에 올바른 권한이 있고 올바른 액세스 키를 사용하고 있는지 확인합니다.  
HTTP 상태 코드: 401

 ** ConflictException **   
리소스를 업데이트하거나 삭제하면 일관성 없는 상태가 발생할 수 있습니다.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 실패가 발생했습니다.  
HTTP 상태 코드: 500

 ** InvalidParameterValueException **   
하나 이상의 매개변수에 유효하지 않은 값이 있습니다.  
HTTP 상태 코드: 400

 ** PreconditionNotMetException **   
하나 이상의 사전 조건이 충족되지 않았습니다.  
HTTP 상태 코드: 400

 ** ResourceExistsException **   
지정한 리소스가 이미 존재합니다.  
HTTP 상태 코드: 409

 ** ResourceNotFoundException **   
리소스를 하나 이상 찾을 수 없습니다.  
HTTP 상태 코드: 404

 ** ResourceUnavailableException **   
이 리소스를 현재 사용할 수 없습니다.  
HTTP 상태 코드: 503

 ** ThrottlingException **   
액세스가 제한되었습니다.  
HTTP 상태 코드: 429

## 참고 항목
<a name="API_CreateAccountSubscription_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS를 위한 SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateAccountSubscription)