CreateAccountSubscription

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

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

이 작업을 사용하기 전에 기존 작업에 연결할 수 있는지 확인하십시오.AWS 계정. 계정이 없는 경우AWS 계정, 참조에 가입AWS의아마존 QuickSight 사용 설명서. 아마존에 가입한 사람 QuickSight 올바른 정보가 필요합니다.AWS Identity and Access Management(IAM) 권한입니다. 자세한 내용은 단원을 참조하십시오.Amazon IAM 정책 예제 QuickSight의아마존 QuickSight 사용 설명서.

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

기존 IAM 역할을 전달하여 다른 IAM 역할에 액세스할 수 없습니다.AWSAPI 작업을 사용하는 서비스. 기존 IAM 역할을 아마존에 전달하려면 QuickSight, 참조아마존에 IAM 역할 전달 QuickSight의아마존 QuickSight 사용 설명서.

Amazon에서 새 계정에 대한 기본 리소스 액세스를 설정할 수 없습니다. QuickSightAPI. 대신 Amazon에서 기본 리소스 액세스를 추가합니다. QuickSight 콘솔. 기본 리소스 액세스 설정에 대한 자세한 내용은AWS서비스, 참조기본 리소스 액세스 설정AWS서비스의아마존 QuickSight사용 설명서.

요청 구문

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 요청 파라미터

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

AwsAccountId

이AWS 계정Amazon을 만들기 위해 사용하는 계정 ID QuickSight 계정.

길이 제약 조건: 고정 길이는 12자입니다.

패턴: ^[0-9]{12}$

필수 사항: 예

요청 본문

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

AccountName

Amazon 이름 QuickSight 계정. 이 이름은 모두 고유합니다.AWS로 표시되며 사용자가 로그인할 때만 표시됩니다. 변경할 수 없습니다.AccountName아마존 이후의 가치 QuickSight 계정이 생성되었습니다.

Type: 문자열

필수 사항: 예

AuthenticationMethod

Amazon을 인증하기 위해 사용하려는 방법 QuickSight 계정. 현재 이 파라미터에 유효한 값은 입니다.IAM_AND_QUICKSIGHT,IAM_ONLY, 그리고ACTIVE_DIRECTORY.

선택 항목:ACTIVE_DIRECTORY, 다음을 제공합니다.ActiveDirectoryName그리고AdminGroupActive Directory 와 연결되어 있습니다.

Type: 문자열

유효한 값: IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY

필수 사항: 예

Edition

아마존 에디션 QuickSight 귀하의 계정에 갖고 싶은 것을 말이죠. 현재 선택 항목:ENTERPRISE또는ENTERPRISE_AND_Q.

선택 항목:ENTERPRISE_AND_Q를 사용하려면 다음 파라미터가 필요합니다.

• FirstName

• LastName

• EmailAddress

• ContactNumber

Type: 문자열

유효한 값: STANDARD | ENTERPRISE | ENTERPRISE_AND_Q

필수 사항: 예

NotificationEmail

아마존에서 원하는 이메일 주소 QuickSight 를 사용하여 Amazon에 대한 알림을 보냅니다. QuickSight 계정 또는 아마존 QuickSight 구독.

Type: 문자열

필수 사항: 예

ActiveDirectoryName

액티브 디렉터리 이름입니다. 의 경우 이 필드는 필수입니다.ACTIVE_DIRECTORY새 Amazon에서 선택한 인증 방법입니다. QuickSight 계정.

Type: 문자열

필수 사항: 아니요

AdminGroup

액티브 디렉터리에 연결된 관리자 그룹입니다. 의 경우 이 필드는 필수입니다.ACTIVE_DIRECTORY새 Amazon에서 선택한 인증 방법입니다. QuickSight 계정. 아마존에서 Active Directory 사용에 대한 자세한 내용은 QuickSight, 참조Active Directory 사용 QuickSight Enterprise Edition에서 Amazon QuickSight사용 설명서.

Type: 문자열 배열

필수 사항: 아니요

AuthorGroup

Active Directory와 연결된 저자 그룹입니다. 아마존에서 Active Directory 사용에 대한 자세한 내용은 QuickSight, 참조Active Directory 사용 QuickSight Enterprise Edition에서 Amazon QuickSight사용 설명서.

Type: 문자열 배열

필수 사항: 아니요

ContactNumber

아마존 작성자의 10자리 전화 번호 QuickSight future 커뮤니케이션에 사용할 계정. 의 경우 이 필드는 필수입니다.ENTERPPRISE_AND_Q새 아마존에서 선택한 에디션입니다. QuickSight 계정.

Type: 문자열

필수 사항: 아니요

DirectoryId

아마존에 연결된 Active Directory의 ID QuickSight 계정.

Type: 문자열

필수 사항: 아니요

EmailAddress

아마존 작성자의 이메일 주소 QuickSight future 커뮤니케이션에 사용할 계정. 의 경우 이 필드는 필수입니다.ENTERPPRISE_AND_Q새 아마존에서 선택한 에디션입니다. QuickSight 계정.

Type: 문자열

필수 사항: 아니요

FirstName

아마존 작성자의 이름입니다. QuickSight future 커뮤니케이션에 사용할 계정. 의 경우 이 필드는 필수입니다.ENTERPPRISE_AND_Q새 아마존에서 선택한 에디션입니다. QuickSight 계정.

Type: 문자열

필수 사항: 아니요

LastName

아마존 작성자의 성입니다. QuickSight future 커뮤니케이션에 사용할 계정. 의 경우 이 필드는 필수입니다.ENTERPPRISE_AND_Q새 아마존에서 선택한 에디션입니다. QuickSight 계정.

Type: 문자열

필수 사항: 아니요

ReaderGroup

액티브 디렉터리에 연결된 리더 그룹입니다. 아마존에서 Active Directory 사용에 대한 자세한 내용은 QuickSight, 참조Active Directory 사용 QuickSight Enterprise Edition의아마존 QuickSight사용 설명서.

Type: 문자열 배열

필수 사항: 아니요

Realm

아마존과 연결된 액티브 디렉토리의 영역입니다. QuickSight 계정. 의 경우 이 필드는 필수입니다.ACTIVE_DIRECTORY새 Amazon에서 선택한 인증 방법입니다. QuickSight 계정.

Type: 문자열

필수 사항: 아니요

응답 구문

HTTP/1.1 Status
Content-type: application/json

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

응답 요소

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

Status

요청의 HTTP 상태입니다.

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

RequestId

이AWS작업에 대한 요청 ID입니다.

Type: 문자열

SignupResponse

ASignupResponse새로 생성된 Amazon에 대한 정보를 반환하는 객체 QuickSight 계정.

유형: SignupResponse 객체

오류

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

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

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go

• AWS SDK for Java V2

• AWS를 위한 SDK JavaScript

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3