As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Cria uma Amazon QuickSight conta ou assina a Amazon QuickSight Q

ORegião da AWSpara a conta é derivada do que está configurado naAWS CLIou SDK. Esta operação não é suportada nas regiões Leste dos EUA (Ohio), América do Sul (São Paulo) ou Ásia-Pacífico (Cingapura). 

Antes de usar esta operação, certifique-se de que você pode se conectar a umConta da AWS. Se você não tiver umaConta da AWS, consulte[Cadastro naAWS](https://docs.aws.amazon.com/quicksight/latest/user/setting-up-aws-sign-up.html)no*Amazônia QuickSight Guia do usuário do*. A pessoa que se inscreve na Amazon QuickSight precisa ter o corretoAWS Identity and Access Management(IAM) permissões. Para obter mais informações, consulte[Exemplos de política do IAM para o Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/iam-policy-examples.html)no*Amazônia QuickSight Guia do usuário do*.

Se a sua política do IAM incluir os`Subscribe`e`CreateAccountSubscription`ações, certifique-se de que ambas as ações estejam definidas como`Allow`. Se uma das ações estiver definida como`Deny`, o`Deny`a ação prevalecerá e sua chamada de API falha.

Você não pode passar uma função existente do IAM para acessar outrasAWSserviços que usam essa operação de API. Para passar sua função existente do IAM para a Amazon QuickSight, consulte[Transferência de funções do IAM para a Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/security_iam_service-with-iam.html#security-create-iam-role)no*Amazônia QuickSight Guia do usuário do*.

Você não pode definir o acesso padrão ao recurso na nova conta da Amazon QuickSightAPI. Em vez disso, adicione acesso padrão a recursos da Amazon QuickSight console do . Para obter mais informações sobre como definir o acesso a recursos padrão paraAWSserviços, consulte[Definindo o acesso padrão ao recurso paraAWSserviços](https://docs.aws.amazon.com/quicksight/latest/user/scoping-policies-defaults.html)no*Amazônia QuickSightGuia do usuário do*.

## Sintaxe da solicitação
<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"
}
```

## Parâmetros da solicitação de URI
<a name="API_CreateAccountSubscription_RequestParameters"></a>

A solicitação usa os parâmetros de URI a seguir.

 ** [AwsAccountId](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AwsAccountId"></a>
OConta da AWSID da conta usada para criar sua Amazon QuickSight conta.  
Restrições de tamanho: Comprimento fixo de  
Padrão: `^[0-9]{12}$`   
Obrigatório: Sim

## Corpo da solicitação
<a name="API_CreateAccountSubscription_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [AccountName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AccountName"></a>
O nome da sua Amazon QuickSight conta. Este nome é único em todosAWSe ele aparece somente quando os usuários fazem login. Não é possível alterar`AccountName`valor depois da Amazônia QuickSight conta é criada.  
Type: String  
Obrigatório: Sim

 ** [AuthenticationMethod](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AuthenticationMethod"></a>
O método que você deseja que o utilize para autenticar a sua Amazon QuickSight conta. No momento, os valores válidos desse parâmetro são`IAM_AND_QUICKSIGHT`,`IAM_ONLY`, e`ACTIVE_DIRECTORY`.  
Se escolher`ACTIVE_DIRECTORY`, forneça um`ActiveDirectoryName`e um`AdminGroup`associado ao Active Directory.  
Type: String  
Valores válidos:` IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY`   
Obrigatório: Sim

 ** [Edition](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-Edition"></a>
A edição da Amazon QuickSight que você deseja que sua conta tenha. Atualmente, você pode escolher`ENTERPRISE`ou`ENTERPRISE_AND_Q`.  
Se escolher`ENTERPRISE_AND_Q`, os seguintes parâmetros são obrigatórios:  
+  `FirstName` 
+  `LastName` 
+  `EmailAddress` 
+  `ContactNumber` 
Type: String  
Valores válidos:` STANDARD | ENTERPRISE | ENTERPRISE_AND_Q`   
Obrigatório: Sim

 ** [NotificationEmail](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-NotificationEmail"></a>
O endereço de e-mail que você deseja Amazon QuickSight para enviar notificações sobre a Amazon QuickSight conta ou Amazon QuickSight assinatura.  
Type: String  
Obrigatório: Sim

 ** [ActiveDirectoryName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ActiveDirectoryName"></a>
O nome do Active Directory. Esse campo será obrigatório`ACTIVE_DIRECTORY`é o método de autenticação selecionado da nova Amazon QuickSight conta.  
Type: String  
Obrigatório: Não

 ** [AdminGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AdminGroup"></a>
O grupo de administradores associado ao seu Active Directory. Esse campo será obrigatório`ACTIVE_DIRECTORY`é o método de autenticação selecionado da nova Amazon QuickSight conta. Para obter mais informações sobre como usar o Active Directory na Amazon QuickSight, consulte[Uso do Active Directory com o Amazon QuickSight Edição Enterprise](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)na Amazon QuickSightGuia do usuário do .  
Type: Matriz de strings  
Obrigatório: Não

 ** [AuthorGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AuthorGroup"></a>
O grupo de autores associado ao seu Active Directory. Para obter mais informações sobre como usar o Active Directory na Amazon QuickSight, consulte[Uso do Active Directory com o Amazon QuickSight Edição Enterprise](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)na Amazon QuickSightGuia do usuário do .  
Type: Matriz de strings  
Obrigatório: Não

 ** [ContactNumber](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ContactNumber"></a>
Um número de telefone de 10 dígitos do autor da Amazon QuickSight conta a ser usada para comunicações future. Esse campo será obrigatório`ENTERPPRISE_AND_Q`é a edição selecionada da nova Amazon QuickSight conta.  
Type: String  
Obrigatório: Não

 ** [DirectoryId](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-DirectoryId"></a>
O ID do Active Directory que é associado ao seu Amazon QuickSight conta.  
Type: String  
Obrigatório: Não

 ** [EmailAddress](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-EmailAddress"></a>
O endereço de e-mail do autor da Amazon QuickSight conta a ser usada para comunicações future. Esse campo será obrigatório`ENTERPPRISE_AND_Q`é a edição selecionada da nova Amazon QuickSight conta.  
Type: String  
Obrigatório: Não

 ** [FirstName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-FirstName"></a>
O nome do autor da Amazônia QuickSight conta a ser usada para comunicações future. Esse campo será obrigatório`ENTERPPRISE_AND_Q`é a edição selecionada da nova Amazon QuickSight conta.  
Type: String  
Obrigatório: Não

 ** [LastName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-LastName"></a>
O sobrenome do autor da Amazônia QuickSight conta a ser usada para comunicações future. Esse campo será obrigatório`ENTERPPRISE_AND_Q`é a edição selecionada da nova Amazon QuickSight conta.  
Type: String  
Obrigatório: Não

 ** [ReaderGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ReaderGroup"></a>
O grupo de leitores associado ao seu Active Directory. Para obter mais informações sobre como usar o Active Directory na Amazon QuickSight, consulte[Uso do Active Directory com o Amazon QuickSight Edição Enterprise](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)no*Amazônia QuickSightGuia do usuário do*.  
Type: Matriz de strings  
Obrigatório: Não

 ** [Realm](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-Realm"></a>
O domínio do Active Directory associado à sua Amazon QuickSight conta. Esse campo será obrigatório`ACTIVE_DIRECTORY`é o método de autenticação selecionado da nova Amazon QuickSight conta.  
Type: String  
Obrigatório: Não

## Sintaxe da resposta
<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"
   }
}
```

## Elementos de resposta
<a name="API_CreateAccountSubscription_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.

 ** [Status](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-Status"></a>
O status HTTP da solicitação.

Os seguintes dados são retornados no formato JSON pelo serviço.

 ** [RequestId](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-RequestId"></a>
OAWSID de solicitação para essa operação.  
Type: String

 ** [SignupResponse](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-SignupResponse"></a>
UMA`SignupResponse`objeto que retorna informações sobre uma Amazon recém-criada QuickSight conta.  
Tipo: objeto [SignupResponse](API_SignupResponse.md)

## Erros
<a name="API_CreateAccountSubscription_Errors"></a>

Para obter informações sobre os erros que são comuns a todas as ações, consulte[Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem acesso a esse item. Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight , se as suas políticas têm as permissões corretas e se você está usando as chaves de acesso corretas.  
Código de status HTTP: 401

 ** ConflictException **   
Atualizar ou excluir um recurso pode causar um estado inconsistente.  
Código de status HTTP: 409

 ** InternalFailureException **   
Ocorreu um erro interno.  
Código de status HTTP: 500

 ** InvalidParameterValueException **   
Um ou mais parâmetros têm um valor que não é válido.  
Código de status HTTP: 400

 ** PreconditionNotMetException **   
Uma ou mais pré-condições não foram atendidas.  
Código de status HTTP: 400

 ** ResourceExistsException **   
O recurso especificado já existe.   
Código de status HTTP: 409

 ** ResourceNotFoundException **   
Não foi possível encontrar um ou mais recursos.  
Código de status HTTP: 404

 ** ResourceUnavailableException **   
Este recurso está indisponível no momento.  
Código de status HTTP: 503

 ** ThrottlingException **   
O acesso é limitado.  
Código de status HTTP: 429

## Consulte também
<a name="API_CreateAccountSubscription_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
+  [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 para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK para 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)