CreateAnalysis - Amazon QuickSight
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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

Crea un análisis en Amazon QuickSight.

Sintaxis de la solicitud

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

La solicitud utiliza los siguientes parámetros URI.

AnalysisId

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

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

La solicitud acepta los siguientes datos en formato JSON.

Name

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

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

Obligatorio: Sí

Parameters

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

Obligatorio: No

Permissions

Estructura que describe los principales y los permisos de nivel de recursos en un análisis. Puede utilizar elPermissionsestructura 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, omitaPermissions.

Type: Matriz deResourcePermissionobjects

Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 64 elementos.

Obligatorio: No

Tags

Contiene un mapa de los pares clave-valor para la etiqueta o etiquetas de recursos asignadas al análisis.

Type: Matriz deTagobjects

Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 200 elementos.

Obligatorio: No

ThemeArn

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

HTTP/1.1 Status
Content-type: application/json

{
   "AnalysisId": "string",
   "Arn": "string",
   "CreationStatus": "string",
   "RequestId": "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.

AnalysisId

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

El ARN para el análisis.

Type: Cadena

CreationStatus

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

LaAWSID de solicitud de esta operación.

Type: Cadena

Errores

Para obtener información sobre los errores que son comunes a todas las acciones, consulteErrores comunes.

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

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: