Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Crea un Amazon QuickSight cuenta o se suscribe a Amazon QuickSight Q.

LaRegión de AWSde la cuenta se deriva de lo que está configurado en laAWS CLIo SDK. Esta operación no se admite en la región EE.UU. Este (Ohio), Sudamérica (Sao Paulo) ni en la región Asia-Pacífico (Singapur). 

Antes de usar esta operación, asegúrese de que puede conectarse a unCuenta de AWS. Si no tiene unCuenta de AWSconsulte[Registrarse enAWS](https://docs.aws.amazon.com/quicksight/latest/user/setting-up-aws-sign-up.html)en la*Amazon QuickSight Guía del usuario de*. La persona que se suscribe a Amazon QuickSight necesita tener la correctaAWS Identity and Access Managementpermisos (IAM). Para obtener más información, consulte[Ejemplos de política de IAM para Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/iam-policy-examples.html)en la*Amazon QuickSight Guía del usuario de*.

Si su política de IAM incluye tanto el`Subscribe`y`CreateAccountSubscription`acciones, asegúrese de que ambas acciones estén configuradas en`Allow`. Si alguna de las acciones se establece en`Deny`, el`Deny`prevalece y la llamada al API genera un error.

No puede pasar una función de IAM existente para acceder a otrasAWSservicios que utilizan esta operación de la API. Para pasar su función de IAM actual a Amazon QuickSightconsulte[Transferencia de funciones de IAM a Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/security_iam_service-with-iam.html#security-create-iam-role)en la*Amazon QuickSight Guía del usuario de*.

No puedes establecer el acceso predeterminado a los recursos en la nueva cuenta de Amazon QuickSightAPI. En su lugar, añada el acceso predeterminado a los recursos desde Amazon QuickSight consola de . Para obtener más información sobre cómo configurar el acceso de recursos predeterminado a.AWSservicios, consulte[Establecer el acceso predeterminado a los recursos enAWSServicios de](https://docs.aws.amazon.com/quicksight/latest/user/scoping-policies-defaults.html)en la*Amazon QuickSightGuía del usuario de*.

## Sintaxis de la solicitud
<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 de solicitud del URI
<a name="API_CreateAccountSubscription_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [AwsAccountId](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AwsAccountId"></a>
LaCuenta de AWSID de la cuenta que utiliza para crear su cuenta de Amazon QuickSight account.  
Restricciones de longitud Limitado de 12.  
Patrón: `^[0-9]{12}$`   
Obligatorio: Sí

## Cuerpo de la solicitud
<a name="API_CreateAccountSubscription_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [AccountName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AccountName"></a>
El nombre de su Amazon QuickSight account. Este nombre es único en todosAWSy solo aparece cuando los usuarios inician sesión. No puede cambiar`AccountName`valor después del Amazonas QuickSight se ha creado la cuenta.  
Type: Cadena  
Obligatorio: Sí

 ** [AuthenticationMethod](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AuthenticationMethod"></a>
El método que desea utilizar para autenticar su Amazon QuickSight account. Actualmente, los valores válidos para este parámetro son:`IAM_AND_QUICKSIGHT`,`IAM_ONLY`, y`ACTIVE_DIRECTORY`.  
Si elige`ACTIVE_DIRECTORY`, proporcione un`ActiveDirectoryName`y un`AdminGroup`asociado con Active Directory.  
Type: Cadena  
Valores válidos:` IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY`   
Obligatorio: Sí

 ** [Edition](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-Edition"></a>
La edición de Amazon QuickSight que quieres que tenga tu cuenta. Actualmente puede elegir entre`ENTERPRISE`o`ENTERPRISE_AND_Q`.  
Si elige`ENTERPRISE_AND_Q`, se requieren los siguientes parámetros:  
+  `FirstName` 
+  `LastName` 
+  `EmailAddress` 
+  `ContactNumber` 
Type: Cadena  
Valores válidos:` STANDARD | ENTERPRISE | ENTERPRISE_AND_Q`   
Obligatorio: Sí

 ** [NotificationEmail](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-NotificationEmail"></a>
La dirección de correo electrónico que quieres Amazon QuickSight para enviar notificaciones sobre tu Amazon QuickSight cuenta o Amazon QuickSight suscripción.  
Type: Cadena  
Obligatorio: Sí

 ** [ActiveDirectoryName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ActiveDirectoryName"></a>
El nombre de Active Directory. Este campo es obligatorio si`ACTIVE_DIRECTORY`es el método de autenticación seleccionado para el nuevo Amazon QuickSight account.  
Type: Cadena  
Obligatorio: No

 ** [AdminGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AdminGroup"></a>
El grupo de administradores asociado a su Active Directory. Este campo es obligatorio si`ACTIVE_DIRECTORY`es el método de autenticación seleccionado para el nuevo Amazon QuickSight account. Para obtener más información sobre cómo usar Active Directory en Amazon QuickSightconsulte[Uso de Active Directory con Amazon QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)en Amazon QuickSightGuía del usuario de .  
Type: Matriz de cadenas  
Obligatorio: No

 ** [AuthorGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AuthorGroup"></a>
El grupo de autores asociado a su Active Directory. Para obtener más información sobre cómo usar Active Directory en Amazon QuickSightconsulte[Uso de Active Directory con Amazon QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)en Amazon QuickSightGuía del usuario de .  
Type: Matriz de cadenas  
Obligatorio: No

 ** [ContactNumber](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ContactNumber"></a>
Un número de teléfono de 10 dígitos del autor de Amazon QuickSight cuenta para utilizarla en future comunicaciones. Este campo es obligatorio si`ENTERPPRISE_AND_Q`es la edición seleccionada del nuevo Amazon QuickSight account.  
Type: Cadena  
Obligatorio: No

 ** [DirectoryId](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-DirectoryId"></a>
El ID del Active Directory de que está asociado a su Amazon QuickSight account.  
Type: Cadena  
Obligatorio: No

 ** [EmailAddress](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-EmailAddress"></a>
La dirección de correo electrónico del autor de Amazon QuickSight cuenta para utilizarla en future comunicaciones. Este campo es obligatorio si`ENTERPPRISE_AND_Q`es la edición seleccionada del nuevo Amazon QuickSight account.  
Type: Cadena  
Obligatorio: No

 ** [FirstName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-FirstName"></a>
El nombre del autor del Amazonas QuickSight cuenta para utilizarla en future comunicaciones. Este campo es obligatorio si`ENTERPPRISE_AND_Q`es la edición seleccionada del nuevo Amazon QuickSight account.  
Type: Cadena  
Obligatorio: No

 ** [LastName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-LastName"></a>
El apellido del autor del Amazonas QuickSight cuenta para utilizarla en future comunicaciones. Este campo es obligatorio si`ENTERPPRISE_AND_Q`es la edición seleccionada del nuevo Amazon QuickSight account.  
Type: Cadena  
Obligatorio: No

 ** [ReaderGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ReaderGroup"></a>
El grupo de lectores asociado a su Active Directory. Para obtener más información sobre cómo usar Active Directory en Amazon QuickSightconsulte[Uso de Active Directory con Amazon QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)en la*Amazon QuickSightGuía del usuario de*.  
Type: Matriz de cadenas  
Obligatorio: No

 ** [Realm](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-Realm"></a>
El ámbito de Active Directory que está asociado a tu Amazon QuickSight account. Este campo es obligatorio si`ACTIVE_DIRECTORY`es el método de autenticación seleccionado para el nuevo Amazon QuickSight account.  
Type: Cadena  
Obligatorio: No

## Sintaxis de la respuesta
<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 respuesta
<a name="API_CreateAccountSubscription_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve la siguiente respuesta HTTP.

 ** [Status](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-Status"></a>
El estado HTTP de la solicitud.

El servicio devuelve los datos siguientes en formato JSON.

 ** [RequestId](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-RequestId"></a>
LaAWSID de solicitud de esta operación.  
Type: Cadena

 ** [SignupResponse](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-SignupResponse"></a>
UNA`SignupResponse`objeto que devuelve información sobre un Amazon recién creado QuickSight account.  
Tipo: objeto [SignupResponse](API_SignupResponse.md)

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

Para obtener información sobre los errores que son comunes a todas las acciones, consulte.[Errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene permiso de acceso. La credenciales proporcionadas no se pudieron validar. Es posible que no tenga permiso para realizar la solicitud. Asegúrese de que su cuenta esté autorizada para usar Amazon QuickSight , que las políticas tienen los permisos correctos y que está utilizando las claves de acceso correctas.  
Código de estado HTTP: 401

 ** ConflictException **   
La actualización o eliminación de un recurso puede provocar un estado incoherente.  
Código de estado HTTP: 409

 ** InternalFailureException **   
Se produjo un error interno.  
Código de estado HTTP: 500

 ** InvalidParameterValueException **   
Uno o más parámetros tienen un valor que no es válido.  
Código de estado HTTP: 400

 ** PreconditionNotMetException **   
No se cumplen una o varias condiciones previas.  
Código de estado HTTP: 400

 ** ResourceExistsException **   
El recurso especificado ya existe.   
Código de estado HTTP: 409

 ** ResourceNotFoundException **   
No se encontraron uno o varios recursos.  
Código de estado HTTP: 404

 ** ResourceUnavailableException **   
Este recurso no está disponible en este momento.  
Código de estado HTTP: 503

 ** ThrottlingException **   
El acceso está limitado.  
Código de estado HTTP: 429

## Véase también
<a name="API_CreateAccountSubscription_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateAccountSubscription) 
+  [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateAccountSubscription) 
+  [SDK para Java V2 de AWS](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) 
+  [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateAccountSubscription)