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
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 AWSconsulteRegistrarse enAWSen laAmazon 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, consulteEjemplos de política de IAM para Amazon QuickSighten laAmazon QuickSight Guía del usuario de.
Si su política de IAM incluye tanto elSubscribeyCreateAccountSubscriptionacciones, asegúrese de que ambas acciones estén configuradas enAllow. Si alguna de las acciones se establece enDeny, elDenyprevalece 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 QuickSightconsulteTransferencia de funciones de IAM a Amazon QuickSighten laAmazon 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, consulteEstablecer el acceso predeterminado a los recursos enAWSServicios deen laAmazon QuickSightGuía del usuario de.
Sintaxis de la solicitud
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
La solicitud utiliza los siguientes parámetros URI.
- AwsAccountId
-
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
La solicitud acepta los siguientes datos en formato JSON.
- AccountName
-
El nombre de su Amazon QuickSight account. Este nombre es único en todosAWSy solo aparece cuando los usuarios inician sesión. No puede cambiar
AccountNamevalor después del Amazonas QuickSight se ha creado la cuenta.Type: Cadena
Obligatorio: Sí
- AuthenticationMethod
-
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, yACTIVE_DIRECTORY.Si elige
ACTIVE_DIRECTORY, proporcione unActiveDirectoryNamey unAdminGroupasociado con Active Directory.Type: Cadena
Valores válidos:
IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORYObligatorio: Sí
- Edition
-
La edición de Amazon QuickSight que quieres que tenga tu cuenta. Actualmente puede elegir entre
ENTERPRISEoENTERPRISE_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_QObligatorio: Sí
-
- NotificationEmail
-
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
-
El nombre de Active Directory. Este campo es obligatorio si
ACTIVE_DIRECTORYes el método de autenticación seleccionado para el nuevo Amazon QuickSight account.Type: Cadena
Obligatorio: No
- AdminGroup
-
El grupo de administradores asociado a su Active Directory. Este campo es obligatorio si
ACTIVE_DIRECTORYes 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 QuickSightconsulteUso de Active Directory con Amazon QuickSight Enterprise Editionen Amazon QuickSightGuía del usuario de .Type: Matriz de cadenas
Obligatorio: No
- AuthorGroup
-
El grupo de autores asociado a su Active Directory. Para obtener más información sobre cómo usar Active Directory en Amazon QuickSightconsulteUso de Active Directory con Amazon QuickSight Enterprise Editionen Amazon QuickSightGuía del usuario de .
Type: Matriz de cadenas
Obligatorio: No
- ContactNumber
-
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_Qes la edición seleccionada del nuevo Amazon QuickSight account.Type: Cadena
Obligatorio: No
- DirectoryId
-
El ID del Active Directory de que está asociado a su Amazon QuickSight account.
Type: Cadena
Obligatorio: No
- EmailAddress
-
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_Qes la edición seleccionada del nuevo Amazon QuickSight account.Type: Cadena
Obligatorio: No
- FirstName
-
El nombre del autor del Amazonas QuickSight cuenta para utilizarla en future comunicaciones. Este campo es obligatorio si
ENTERPPRISE_AND_Qes la edición seleccionada del nuevo Amazon QuickSight account.Type: Cadena
Obligatorio: No
- LastName
-
El apellido del autor del Amazonas QuickSight cuenta para utilizarla en future comunicaciones. Este campo es obligatorio si
ENTERPPRISE_AND_Qes la edición seleccionada del nuevo Amazon QuickSight account.Type: Cadena
Obligatorio: No
- ReaderGroup
-
El grupo de lectores asociado a su Active Directory. Para obtener más información sobre cómo usar Active Directory en Amazon QuickSightconsulteUso de Active Directory con Amazon QuickSight Enterprise Editionen laAmazon QuickSightGuía del usuario de.
Type: Matriz de cadenas
Obligatorio: No
- Realm
-
El ámbito de Active Directory que está asociado a tu Amazon QuickSight account. Este campo es obligatorio si
ACTIVE_DIRECTORYes el método de autenticación seleccionado para el nuevo Amazon QuickSight account.Type: Cadena
Obligatorio: No
Sintaxis de la respuesta
HTTP/1.1 Status
Content-type: application/json
{
"RequestId": "string",
"SignupResponse": {
"accountName": "string",
"directoryType": "string",
"IAMUser": boolean,
"userLoginName": "string"
}
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve la siguiente respuesta HTTP.
- Status
-
El estado HTTP de la solicitud.
El servicio devuelve los datos siguientes en formato JSON.
- RequestId
-
LaAWSID de solicitud de esta operación.
Type: Cadena
- SignupResponse
-
UNA
SignupResponseobjeto que devuelve información sobre un Amazon recién creado QuickSight account.Tipo: objeto SignupResponse
Errores
Para obtener información sobre los errores que son comunes a todas las acciones, consulte.Errores comunes.
- 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
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
