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.

# CreateAnalysis
<a name="API_CreateAnalysis"></a>

Crea un análisis en Amazon QuickSight.

## Sintaxis de la solicitud
<a name="API_CreateAnalysis_RequestSyntax"></a>

```
POST /accounts/AwsAccountId/analyses/AnalysisId HTTP/1.1
Content-type: application/json

{
   "Name": "string",
   "Parameters": { 
      "DateTimeParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "DecimalParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "IntegerParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "StringParameters": [ 
         { 
            "Name": "string",
            "Values": [ "string" ]
         }
      ]
   },
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "SourceEntity": { 
      "SourceTemplate": { 
         "Arn": "string",
         "DataSetReferences": [ 
            { 
               "DataSetArn": "string",
               "DataSetPlaceholder": "string"
            }
         ]
      }
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThemeArn": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_CreateAnalysis_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [AnalysisId](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-AnalysisId"></a>
El ID del análisis que está creando. Este identificador se muestra en la URL del análisis.  
Limitaciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Patrón: `[\w\-]+`   
Obligatorio: Sí

 ** [AwsAccountId](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-AwsAccountId"></a>
El ID de laAWScuenta en la que está creando un análisis.  
Limitaciones de longitud Longitud fija de 12 caracteres.  
Patrón: `^[0-9]{12}$`   
Obligatorio: Sí

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

La solicitud acepta los siguientes datos en formato JSON.

 ** [Name](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Name"></a>
Un nombre descriptivo para el análisis que va a crear. Este nombre se muestra para el análisis en Amazon QuickSight consola de .   
Type: Cadena  
Limitaciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: Sí

 ** [SourceEntity](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-SourceEntity"></a>
Una entidad de origen que se utilizará para el análisis que está creando. Esta estructura de metadatos contiene detalles que describen una plantilla de origen y uno o más conjuntos de datos.  
Tipo: objeto [AnalysisSourceEntity](API_AnalysisSourceEntity.md)  
Obligatorio: Sí

 ** [Parameters](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Parameters"></a>
Los nombres de los parámetros y los valores de anulación que desea usar. Un análisis puede tener cualquier tipo de parámetro y algunos parámetros pueden aceptar varios valores.   
Tipo: objeto [Parameters](API_Parameters.md)  
Obligatorio: No

 ** [Permissions](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Permissions"></a>
Estructura que describe los principales y los permisos de nivel de recursos en un análisis. Puede utilizar el`Permissions`estructura para conceder permisos proporcionando una lista deAWS Identity and Access Management(IAM) para cada principal que aparece por nombre de recurso de Amazon (ARN).   
Para no especificar ningún permiso, omita`Permissions`.  
Type: Matriz de[ResourcePermission](API_ResourcePermission.md)objects  
Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 64 elementos.  
Obligatorio: No

 ** [Tags](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Tags"></a>
Contiene un mapa de los pares clave-valor para la etiqueta o etiquetas de recursos asignadas al análisis.  
Type: Matriz de[Tag](API_Tag.md)objects  
Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 200 elementos.  
Obligatorio: No

 ** [ThemeArn](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-ThemeArn"></a>
El ARN del tema que se va a aplicar al análisis que está creando. Para ver el tema en Amazon QuickSight , asegúrese de tener acceso a ella.  
Type: Cadena  
Obligatorio: No

## Sintaxis de la respuesta
<a name="API_CreateAnalysis_ResponseSyntax"></a>

```
HTTP/1.1 Status
Content-type: application/json

{
   "AnalysisId": "string",
   "Arn": "string",
   "CreationStatus": "string",
   "RequestId": "string"
}
```

## Elementos de respuesta
<a name="API_CreateAnalysis_ResponseElements"></a>

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [AnalysisId](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-AnalysisId"></a>
El ID del análisis.  
Type: Cadena  
Limitaciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Patrón: `[\w\-]+` 

 ** [Arn](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-Arn"></a>
El ARN para el análisis.  
Type: Cadena

 ** [CreationStatus](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-CreationStatus"></a>
El estado de la creación del análisis.   
Type: Cadena  
Valores válidos:` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` 

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

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

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

 ** 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

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

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

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

 ** UnsupportedUserEditionException **   
Este error indica que está llamando a una operación en Amazon QuickSighten la que la edición no incluye soporte para esa operación. Amazon Amazon Amazon QuickSight actualmente tiene Standard Edition y Enterprise Edition. No todas las operaciones y funciones están disponibles en todas las ediciones.  
Código de estado HTTP: 403

## Véase también
<a name="API_CreateAnalysis_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/CreateAnalysis) 
+  [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateAnalysis) 
+  [SDK para Java V2 de AWS](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateAnalysis) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateAnalysis) 
+  [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateAnalysis) 
+  [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateAnalysis) 
+  [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateAnalysis)