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.
# Uso de Amazon QuickSight API
A continuación, puede averiguar cómo comenzar a utilizar Amazon QuickSight API.
**Topics**
+ [Realizar solicitudes a la API](qs-api-making-api-requests.md)
+ [Nombres de recursos de Amazon (ARN) en Amazon QuickSight](qs-arns.md)
+ [Permisos para Amazon QuickSight Recursos](qs-api-permissions.md)
+ [Amazon QuickSight Errores de API](qs-api-errors.md)
# Realizar solicitudes a la API
Proporcionamos una API para Amazon QuickSighty también los SDK de Amazon que le permiten tener acceso a Amazon QuickSight de su lenguaje de programación preferido. Uso de Amazon QuickSight, puede administrar algunos aspectos de la implementación a través de los SDK de Amazon.
Para monitorizar las llamadas efectuadas a Amazon QuickSight API para tu cuenta, puedes usarAWS CloudTrail. CloudTrail puede supervisar las llamadas realizadas por elConsola de administración de AWS, herramientas de línea de comandos y otros servicios. Para obtener más información, consulte la [Guía del usuario de AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
**Topics**
+ [Conocimientos previos](#qs-api-required-knowledge)
+ [Operaciones de API disponibles para Amazon QuickSight](#qs-api-using-libraries)
## Conocimientos previos
Si piensas acceder a Amazon QuickSight a través de una API, debe estar familiarizado con:
+ JSON
+ Servicios web
+ Solicitudes HTTP
+ Uno o varios lenguajes de programación, como JavaScript, Python, Python o C\$1.
Recomendamos visitar elAWS [Centro de recursos introductorios](https://aws.amazon.com//getting-started/tools-sdks/)para ver lo que ofrecen los SDK y los kits de herramientas de Amazon.
Aunque puedes usar un terminal y tu editor de texto favorito, es posible que te beneficies de la experiencia de interfaz de usuario más visual que obtienes en un entorno de desarrollo integrado (IDE). Proporcionamos una lista de IDEs en la*AWSCentro de recursos introductorios*en la[Kits de herramientas IDE e IDE](https://aws.amazon.com//getting-started/tools-sdks/#IDE_and_IDE_Toolkits)sección. Este sitioAWSkits de herramientas que puede descargar para su IDE preferido. Algunos IDE también ofrecen tutoriales para ayudarle a obtener más información sobre los lenguajes de programación.
## Operaciones de API disponibles para Amazon QuickSight
Amazon QuickSight Las operaciones de la API
+ Administración de usuarios y grupos
+ Administración de datos (fuentes de datos, conjuntos de datos, plantillas e ingesta de SPICE)
+ Gestión de panel y análisis
+ Administración de plantillas
+ Permissions management
+ Administración de la personalización
AWSproporciona bibliotecas, ejemplos de código, tutoriales y otros recursos para los desarrolladores de software que prefieren crear aplicaciones con operaciones de API específicas del lenguaje, en lugar de enviar solicitudes por HTTPS. Estas bibliotecas proporcionan funciones básicas que automatizan tareas como la firma criptográfica de las solicitudes, el reintento de las solicitudes o el tratamiento de las respuestas de error. Estas bibliotecas le ayudan a empezar a empezar a.
Para obtener más información acerca de cómo descargar los SDK de Amazon, consulte[SDK y herramientas de Amazon](https://aws.amazon.com/tools/). Los siguientes enlaces son una muestra de la documentación de API específica del idioma disponible.
**AWS Command Line Interface**
+ [AWS CLI QuickSight Referencia de los comandos](https://docs.aws.amazon.com//cli/latest/reference/quicksight/index.html)
+ [Guía del usuario de AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/)
+ [Referencia de los comandos de la AWS CLI](https://docs.aws.amazon.com//cli/latest/reference/)
**AWS SDK para .NET**
+ [Amazon. Vista rápida](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSight.html)
+ [Amazon.Quicksight.Modelo](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSightModel.html)
**AWS SDK para C\$1\$1**
+ [Cejas::QuickSight::QuickSightClient Referencia de la clase](https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_quick_sight_1_1_quick_sight_client.html)
**AWS SDK para Go**
+ [quicksight](https://docs.aws.amazon.com/sdk-for-go/api/service/quicksight/)
**AWS SDK para Java**
+ [QuickSightClient](https://docs.aws.amazon.com/sdk-for-java/latest/reference//software/amazon/awssdk/services/quicksight/package-frame.html)
+ [QuickSightModel](https://docs.aws.amazon.com/sdk-for-java/latest/reference//software/amazon/awssdk/services/quicksight/model/package-frame.html)
**AWS SDK para JavaScript**
+ [QuickSight](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/QuickSight.html)
**AWS SDK para PHP**
+ [QuickSightClient](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.QuickSight.QuickSightClient.html)
**AWS SDK para Python (Boto3)**
+ [QuickSight](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/quicksight.html)
**AWS SDK para Ruby**
+ [Cejas::QuickSight](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/QuickSight.html)
# Nombres de recursos de Amazon (ARN) en Amazon QuickSight
Los nombres de recursos de Amazon (ARN) identifican de forma exclusiva los recursos de AWS. Un ARN identifica un recurso de forma inequívoca en todos losAWS, por ejemplo, en IAMPolicies, etiquetas de Amazon Relational Database Service (Amazon RDS) y llamadas a la API. Para obtener el ARN de un Amazon QuickSight, puede utilizar`Describe`operación en el recurso correspondiente.
Puedes usar esta sección para aprender cómo funcionan los ARN. El material aquí proporciona ejemplos que están diseñados específicamente para Amazon QuickSight.
**Topics**
+ [Formatos de ARN](qs-arn-format.md)
+ [Amazon QuickSight ARN de recursos de](qs-resource-arns.md)
# Formatos de ARN
Los ARN están delimitados por dos puntos y están compuestos por*Segmentos de*, que son las partes deben estar separadas por comas (`:`). Los componentes y valores específicos utilizados en los segmentos de un ARN dependen de quéAWSservicio para el que es el ARN. El siguiente ejemplo muestra cómo se construyen los ARN.
```
arn:partition:service:region:account-id:resource-id
arn:partition:service:region:account-id:resource-type/resource-id
arn:partition:service:region:account-id:resource-type:resource-id
```
Estos ARN contienen los siguientes segmentos:
***`partition`***: la partición en la que se encuentra el recurso. ParaRegiones de AWS, la partición es*aws*. Si tiene recursos en otras particiones, la partición es*aws-partitionname*. Por ejemplo, la partición de los recursos de la región China (Pekín) es `aws-cn`.
***`service`***: el espacio de nombres del servicio que identifica elAWSProduct. Por ejemplo,`quicksight`identifica a Amazon QuickSight,`s3`identifica Amazon S3,`iam`identifica la IAM, y así sucesivamente.
***`region`***— ElRegión de AWSen el que reside el recurso. Tenga en cuenta que los ARN de algunos recursos no requieren unaRegión de AWS, por lo que este componente podría omitirse en algunos casos, como en el caso de S3. Amazon QuickSight Los ARN requieren unRegión de AWS.
***`account-id`***: el ID deCuenta de AWSque posee el recurso. Cuando se usa el número de cuenta en una operación de ARN o API, se omiten los guiones (por ejemplo, 123456789012). Tenga en cuenta que los ARN de algunos recursos no requieren un número de cuenta, por lo que este componente podría omitirse. Amazon QuickSight Los ARN requieren unCuenta de AWSnúmero. Sin embargo, el número de cuenta y elRegión de AWSse omiten de los ARN del depósito de S3, como se muestra a continuación.
```
arn:aws:s3:::bucket_name
arn:aws:s3:::bucket_name/key_name
```
***`resource`*o*`resource-type`***: el contenido de esta parte del ARN varía en función del servicio. Un identificador de recurso puede ser el nombre o ID del recurso (por ejemplo,`user/Bob`o`instance/i-1234567890abcdef0`) o una ruta de recurso. Por ejemplo, algunos identificadores de recursos incluyen un recurso principal (`sub-resource-type/parent-resource/sub-resource`) o un calificador como una versión (*resource-*:*nombre-recurso*:*Calificador*).
Algunos ARN de recursos pueden incluir una ruta, una variable o una ruta.
Puede utilizar los caracteres comodín (`*`y`?`) dentro de cualquier segmento de ARN. Un asterisco (`*`) representa cualquier combinación de cero o más caracteres y un signo de interrogación (`?`) representa un único carácter. Puede utilizar varios caracteres \$1 o ? o en cada segmento, pero un carácter comodín no puede abarcar varios segmentos. Si usa el ARN para los permisos, evite usar`*`caracteres comodín si es posible, para limitar el acceso solo a los elementos necesarios. A continuación, se muestran algunos ejemplos de uso de rutas, caracteres comodín y variables.
Para el siguiente ejemplo, utilizamos un ARN de S3. Puede usar esto cuando conceda permisos a S3 en una IAMPolicy. Este ARN de S3 muestra que se especifican una ruta y un archivo.
**nota**
El*Nombre de la clave*se usa para describir lo que parece una ruta y un archivo después`bucketname/`. Se denominan nombres de clave porque un depósito en realidad no contiene estructuras de carpetas como las que se usan en el sistema de archivos de su computadora. En cambio, la barra (`/`) es un delimitador que ayuda a que la organización del depósito sea más intuitiva. En este caso, el nombre del depósito es`examplebucket`y el nombre de la clave es`developers/design_info.doc`.
```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q4.json
```
Si desea identificar todos los objetos del depósito, puede usar un comodín para indicar que todos los nombres de clave (o rutas y archivos) están incluidos en el ARN, de la siguiente manera.
```
arn:aws:s3:::examplebucket/*
```
Puede usar parte de un nombre de clave más el comodín para identificar todos los objetos que comiencen con un patrón específico. En este caso, se parece a un nombre de carpeta más un comodín, como se muestra a continuación. Sin embargo, este ARN también incluye cualquier «subcarpeta» dentro de`my-data`.
```
arn:aws:s3:::examplebucket/my-data/*
```
Puede especificar un nombre parcial agregando un comodín. Este identifica todos los objetos que comiencen con`my-data/sales-export*`.
```
arn:aws:s3:::examplebucket/my-data/sales-export*
```
En este caso, al especificar el uso de este comodín, se incluyen los objetos con nombres como los siguientes:
+ `my-data/sales-export-1.xlsx`
+ `my-data/sales-export-new.txt`
+ `my-data/sales-export-2019/file1.txt`
Puede usar comodines de ambos tipos (asteriscos y signos de interrogación) en combinación o por separado, como se muestra a continuación.
```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q?.*
arn:aws:s3:::examplebucket/my-data/sales-export-20??-q?.*
```
O bien, si desea preparar el ARN para el futuro, puede reemplazar todo el año con un comodín, en lugar de usar simplemente comodines para los dos últimos dígitos.
```
arn:aws:s3:::examplebucket/my-data/sales-export-????-q?.*
arn:aws:s3:::examplebucket/my-data/sales-export-*-q?.*
```
Para obtener más información sobre los ARN de S3, consulte[Especificación de recursos en una política](https://docs.aws.amazon.com//AmazonS3/latest/dev/s3-arn-format.html)y[Clave y metadatos de objetos](https://docs.aws.amazon.com//AmazonS3/latest/dev/UsingMetadata.html)en la*Amazon Simple Storage Service Resource Guide.*
# Amazon QuickSight ARN de recursos de
Amazon define los siguientes tipos de recursos QuickSight: usuario, grupo y panel. Se utilizan en Amazon QuickSight Llamadas a la API y como elementos de las declaraciones de IAMPermission. Paraup-to-date información para Amazon QuickSight (prefijo de servicio: vista rápida) claves de contexto de condición, acciones y recursos para su uso en las políticas de IAMPermission, consulte[Claves de condición, recursos y acciones de Amazon QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)en la*Guía del usuario de*
| Tipo de recurso | Formato de ARN | Claves de condición |
| --- | --- | --- |
| user | arn: \$1 \$1Account\$1 :user/\$1 Account\$1 :user/\$1 Account\$1 :user/\$1 Account\$1 :user/\$1 Account\$1ResourceId\$1 | N/A |
| grupo | arn: \$1 \$1Account\$1 :Resource: \$1 \$1Account\$1 :Resource\$1 :guarder/\$1 Resource\$1 :detector/\$1ResourceId\$1 | N/A |
| panel | arn: \$1 \$1Account\$1 :guarder/\$1 Account\$1 :detectaber/\$1 Account\$1 :dasher/\$1 Account\$1 :detector/\$1 Account\$1ResourceId\$1 | N/A |
Los ARN de recursos se crean a partir de los segmentos que describen el recurso. Por ejemplo, un ARN de recursos para un análisis consta de los siguientes segmentos.
```
arn::quicksight:::/
```
Los segmentos se definen de la siguiente manera:
+ *`partition`*— Por ejemplo:`aws`o`aws-cn`.
+ *`aws-region`*— ElRegión de AWSque contiene el recurso.
+ *`aws-account-id`*— ElCuenta de AWSque contiene el recurso. Esto excluye los guiones.
+ *`resource-type`*: el tipo de recurso de. Para este ejemplo, este`analyses`. Para un tablero, es`dashboard`.
+ *`resource-id`*: el identificador único para un recurso específico.
LaRegión de AWS, el tipo de recurso y el identificador del recurso se identifican en la URL del recurso cuando utiliza Amazon QuickSight consola de . Por ejemplo, imaginemos que esta es la URL del análisis para el que desea un ARN.
```
https://us-east-2.quicksight.aws.amazon.com/sn/analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```
El valor de Región de AWS es `us-east-2`. El tipo de recurso es`analysis`. El ID de recurso de esta URL es`4036e682-7de6-4c05-8a76-be51b9ec9b29`. Si el número de su cuenta de`111122223333`, el ARN para este análisis es el siguiente.
```
arn:aws:quicksight:us-east-2:111122223333:analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```
Para obtenerCuenta de AWSnúmero, póngase en contacto con el administrador del sistema.
# Permisos para Amazon QuickSight Recursos
Si tiene dudas sobre el permiso necesario, puede intentar realizar una llamada. A continuación, el cliente le dice cuál es el permiso que falta. Puedes usar asterisco (`*`) en el campo Recurso de la política de permisos en lugar de especificar recursos explícitos. Sin embargo, es absolutamente recomendable que restrinja cada permiso en la medida de lo posible. Para restringir el acceso de los usuarios, especifique los recursos o exyalos de la política mediante su Amazon QuickSight ARN. Para obtener el ARN de un Amazon QuickSight , utilice el`Describe`operación en el recurso correspondiente.
Antes de que pueda llamar a Amazon QuickSight Operaciones de la API, necesita`quicksight:operation-name`permiso en una política adjunta a tu IAMIdentity. Por ejemplo, para llamar a `list-users`, necesita el permiso `quicksight:ListUsers`. Lo mismo es aplicable a todas las operaciones. Si intenta realizar la llamada para la que no tiene permisos para llamar, el permiso que falta se indicará en el error resultante se indicará en el error resultante. Recomendamos encarecidamente que restrinja cada permiso tanto como sea posible.
En algunos casos, puede añadir condiciones en IAM para restringir aún más el acceso a una API. Por ejemplo, cuando añade `User1` a `Group1`, el recurso principal es `Group1`. Puede permitir o denegar el acceso a determinados grupos. O también puede editar la QuickSight Soy clave`quicksight:UserName`para añadir una condición que permita o impida añadir determinados usuarios a ese grupo.
Para obtener más información, consulte los siguientes enlaces:
+ [Acciones, recursos y claves de condiciones](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_amazonquicksight.html)
+ [Elementos de las políticas de](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_elements.html)
Para ver más up-to-date lista de Amazon QuickSight acciones, consulte[Acciones definidas QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html#amazonquicksight-actions-as-permissions)en la*IAM User Guide*.
## Prácticas recomendadas de
Amazon QuickSight le permite compartir análisis, paneles, plantillas y temas con hasta 100 principales. UNA*principal*puede ser uno de los siguientes:
+ El nombre de recurso de Amazon (ARN) de un Amazon QuickSight usuario o grupo asociado a una fuente de datos o conjunto de datos. (Este es el caso frecuente).
+ El ARN de una Amazon QuickSight usuario, grupo o espacio de nombres asociado a un análisis, panel, plantilla o tema. (Este es el caso frecuente).
+ El ARN deAWSraíz de la cuenta: Se trata de un ARN de IAM en lugar de un QuickSight ARN. Utilice esta opción solo para compartir recursos (plantillas) entreAWScuentas. (Este es el caso menos frecuente).
Si desea compartir estos recursos con más entidades principales, considere la posibilidad de asignar permisos de recursos a nivel de grupo o espacio de nombres. Por ejemplo, si agrega usuarios a un grupo y comparte un recurso con el grupo, el grupo cuenta como un principal, aunque se comparte con todos los miembros del grupo.
# Amazon QuickSight Errores de API
Amazon QuickSight incluye dos tipos de códigos de error:
+ **Errores del cliente**: estos errores suelen ser causados por algo que el cliente hizo. Un ejemplo es especificar un parámetro incorrecto o no válido en la solicitud o usar una acción o recurso para un usuario que no tiene permisos para utilizar la acción o el recurso. Estos errores vienen acompañados de un código de respuesta HTTP 400.
+ **Errores del servidor**: estos errores suelen ser causados por unaAWSproblema del lado del servidor de. Estos errores vienen acompañados de un código de respuesta HTTP 500.
**Topics**
+ [Errores del cliente comunes](#qs-api-errors-client)
+ [Errores de cliente](#qs-api-errors-table-client)
+ [Errores de servidor](#qs-api-errors-table-server)
## Errores del cliente comunes
A continuación, encontrará una lista de los errores del cliente comunes que todas las acciones pueden devolver.
| Código de error | Descripción |
| --- | --- |
| AuthFailure | La credenciales proporcionadas no se pudieron validar. Es posible que no tenga autorización para realizar la solicitud. Asegúrese de que su cuenta esté autorizada para usar Amazon QuickSight , que los datos de la tarjeta de crédito son correctos y que está utilizando las claves de acceso correctas. |
| Blocked | Su cuenta está bloqueada actualmente. Póngase en contacto con aws-verification@amazon.com si tiene alguna pregunta. |
| DryRunOperation | El usuario tiene los permisos necesarios, por lo que la solicitud se realizaría correctamente, pero se usó el parámetro DryRun. |
| IdempotentParameterMismatch | La solicitud utiliza el mismo token de cliente que uno anterior, pero no la misma solicitud. No reutilice un token de cliente con diferentes solicitudes, a menos que las solicitudes sean idénticas. |
| IncompleteSignature | The request signature does not conform toAWSestándares de. |
| InvalidAction | La acción u operación solicitada no es válida. Compruebe que la acción se ha escrito correctamente. |
| InvalidCharacter | Un carácter especificado no es válido. |
| InvalidClientTokenId | El certificado X.509 o el ID de clave de acceso de AWS proporcionado no existen en nuestros registros. |
| InvalidPaginationToken | El token de paginación especificado no es válido o ha caducado. |
| InvalidParameter | Un parámetro especificado en una solicitud no es válido, no se admite o no se puede utilizar. El mensaje devuelto proporciona una explicación del valor del error. |
| InvalidParameterCombination | Indica una combinación incorrecta de parámetros o un parámetro que falta. |
| InvalidParameterValue | Un valor especificado en un parámetro no es válido, no se admite o no se puede utilizar. Asegúrese de especificar un recurso utilizando su ID completo. El mensaje devuelto proporciona una explicación del valor del error. |
| InvalidQueryParameter | LaAWSla cadena de consulta de está mal formada o no cumpleAWSestándares de. |
| MalformedQueryString | La cadena de consulta contiene un error de sintaxis. |
| MissingAction | Falta un parámetro obligatorio o una acción en la solicitud. |
| MissingAuthenticationToken | La solicitud debe contener un certificado X.509 o bien un ID de clave de acceso de AWS válido (registrado). |
| MissingParameter | Falta un parámetro obligatorio en la solicitud. Asegúrese de que ha proporcionado todos los parámetros necesarios de la solicitud, como el ID del recurso. |
| OptInRequired | No está autorizado a usar el servicio solicitado. Asegúrese de que se ha suscrito al servicio que intenta utilizar. Si eres nuevo enAWS, su cuenta podría tardar un tiempo en activarse mientras se verifican los datos de la tarjeta de crédito. |
| PendingVerification | Su cuenta está pendiente de verificación. Hasta que el proceso de verificación se complete, es posible que no pueda realizar solicitudes con esta cuenta. Si tiene alguna pregunta, póngase en contacto con [AWS Support](https://console.aws.amazon.com/support/home#/). |
| RequestExpired | La solicitud llegó al servicio más de 15 minutos después de la fecha de vencimiento de la solicitud (por ejemplo, para las URL prefirmadas). O el sello de fecha en la solicitud es de más de 15 minutos en el future. Si está utilizando credenciales de seguridad temporales, este error también puede producirse si las credenciales han caducado. Para obtener más información, consulte [Credenciales de seguridad temporales](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) en la guía del usuario de IAM. |
| UnauthorizedOperation | No está autorizado para realizar esta operación. Compruebe sus políticas de IAM y asegúrese de que está utilizando las claves de acceso correctas. |
| UnknownParameter | Se proporcionó un parámetro desconocido o no reconocido. Este error se puede producir si en la solicitud se especifica un parámetro incorrecto o un parámetro que no se admite para la versión de la API especificada. |
| UnsupportedInstanceAttribute | El atributo especificado no se puede modificar. |
| UnsupportedOperation | La solicitud especificada incluye una operación no admitida. El mensaje devuelto proporciona detalles de la operación no admitida. |
| UnsupportedProtocol | El protocolo que utilizó no se admite. |
| ValidationError | La entrada no satisface las limitaciones que especifica elAWSservicio. |
## Errores de cliente
A continuación, puede encontrar una lista de los errores del cliente que son específicos de Amazon QuickSight Operaciones de la API.
| Código de error | Descripción |
| --- | --- |
| AccessDeniedException | No tiene permiso de acceso. La credenciales proporcionadas no se pudieron validar. Es posible que no tenga autorización para realizar la solicitud. Asegúrese de que su cuenta esté autorizada para usar Amazon QuickSight , que sus políticas tienen los permisos correctos y que está utilizando las claves de acceso correctas. |
| DomainNotWhiteListedException | El dominio especificado no está en la lista de dominios permitidos. Amazon debe añadir todos los dominios de los paneles integrados a la lista de dominios aprobados por una empresa de Amazon QuickSight admin. |
| IdentityTypeNotSupportedException | No se admite el tipo de identidad especificado. Los tipos de identidades admitidos son: Soy y QUICKSIGHT. |
| InvalidNextTokenException | El valor de NextToken no es válido. |
| InvalidParameterValueException | Uno o varios parámetros no tienen un valor válido. |
| PreconditionNotMetException | No se cumplen una o varias condiciones previas. |
| QuickSightUserNotFoundException | No se encuentra al usuario. Esto puede ocurrir en cualquier operación que requiera la búsqueda de un usuario en función del nombre de usuario proporcionado, como DeleteUser,DescribeUser, y así sucesivamente. |
| ResourceExistsException | El recurso especificado no existe. |
| ResourceNotFoundException | No se encontraron uno o varios recursos. |
| SessionLifetimeInMinutesInvalidException | El número de minutos especificado para la vida útil de una sesión no es válido. La vida útil de la sesión debe ser un valor comprendido entre 15 y 600 minutos. |
| ThrottlingException | El acceso está limitado. |
| UnsupportedUserEditionException | Indica que está llamando a una operación en Amazon QuickSightuna suscripción en la que la edición no admite esa operación. Amazon QuickSight actualmente tiene Standard Edition y Enterprise Edition. No todas las operaciones y funciones están disponibles en todas las ediciones. |
### Causas comunes de errores del cliente
Existen varias razones por las que puede producirse un error mientras realiza una solicitud. Algunos errores se pueden prevenir y resolver fácilmente siguiendo estas directrices:
+ **Especifique elCuenta de AWSID y espacio de nombres**— Lo relevanteCuenta de AWSSe debe proporcionar una identificación con cada solicitud. El espacio de nombres debe establecerse en `default`.
+ **Permiten la consistencia final**: algunos errores se producen porque una solicitud anterior aún no se ha propagado al sistema.
+ **Usar un intervalo de suspensión entre las tasas de solicitudes**— Amazon QuickSight Las solicitudes de la API de se limitan para ayudar a mantener el rendimiento del servicio. Si sus solicitudes están limitadas, se producirá un error.
+ **Usar el ID completo del recurso**: cuando especifique un recurso, asegúrese de utilizar su ID completo y no el nombre o la descripción proporcionados por el usuario.
+ **Compruebe sus servicios**: asegúrese de que se ha inscrito en todos los servicios que intenta utilizar. Puede comprobar los servicios en los que está inscrito yendo a la**Mi Cuenta**Sección sobre de la[AWSPágina de inicio de](https://aws.amazon.com/).
+ **Compruebe sus permisos**: asegúrese de que tiene los permisos necesarios para realizar la solicitud.
+ **Compruebe su VPC**: algunos recursos no se pueden compartir entre nubes privadas virtuales (VPC), por ejemplo, los grupos de seguridad.
+ **Compruebe sus credenciales**— Asegúrese de que proporciona sus claves de acceso cuando realiza solicitudes y de que ha introducido las credenciales correctamente. Además, si tiene más de una cuenta, asegúrese de que está utilizando las credenciales correctas para una cuenta en concreto. Si las credenciales proporcionadas son incorrectas, es posible que se produzca el siguiente error:`Client.AuthFailure`.
## Errores de servidor
A continuación, puede encontrar una lista de errores que puede devolver el servidor.
| Código de error | Descripción |
| --- | --- |
| BatchClientRequestTokensNotDistinctException – | Los tokens de una solicitud de cliente por lotes no son únicos. |
| EmptyBatchRequestException | La solicitud por lotes estaba vacía. |
| InternalFailureException | Se produjo un error interno. |
| InternalServiceError | Se produjo un error interno del servicio. |
| InvalidBatchClientRequestTokenException | LaAWSEl token de solicitud de esta solicitud por lotes del cliente no es válido. |
| InvalidParameterException | Uno o varios parámetros tienen un valor no válido. |
| LimitExceededException | Se superó un límite. |
| ResourceUnavailableException | Este recurso no está disponible en este momento. |
| TooManyEntriesInBatchRequestException | Hay demasiadas entradas en esta solicitud por lotes. |