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.

# CreateDashboard
<a name="API_CreateDashboard"></a>

Crea un panel a partir de una plantilla Para crear primero una plantilla, consulte la operación API ` [CreateTemplate](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateTemplate.html) `.

Un panel es una entidad de Amazon QuickSight que identifica a Amazon QuickSight informes, creados a partir de análisis. Puedes compartir Amazon QuickSight paneles. Con los permisos adecuados, puede crear informes de correo electrónico programados a partir de ellos. Si tiene los permisos correctos, puede crear un panel a partir de una plantilla que exista en unAWSaccount.

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

```
POST /accounts/AwsAccountId/dashboards/DashboardId HTTP/1.1
Content-type: application/json

{
   "DashboardPublishOptions": { 
      "AdHocFilteringOption": { 
         "AvailabilityStatus": "string"
      },
      "ExportToCSVOption": { 
         "AvailabilityStatus": "string"
      },
      "SheetControlsOption": { 
         "VisibilityState": "string"
      }
   },
   "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",
   "VersionDescription": "string"
}
```

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

La solicitud utiliza los siguientes parámetros URI.

 ** [AwsAccountId](#API_CreateDashboard_RequestSyntax) **   <a name="QS-CreateDashboard-request-AwsAccountId"></a>
El ID de laAWSen la que desea crear el panel.  
Restricciones de longitud Longitud fija de 12.  
Patrón: `^[0-9]{12}$`   
Obligatorio: Sí

 ** [DashboardId](#API_CreateDashboard_RequestSyntax) **   <a name="QS-CreateDashboard-request-DashboardId"></a>
El identificador del panel, que también se ha añadido a la política de IAM.  
Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Patrón: `[\w\-]+`   
Obligatorio: Sí

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

La solicitud acepta los siguientes datos en formato JSON.

 ** [Name](#API_CreateDashboard_RequestSyntax) **   <a name="QS-CreateDashboard-request-Name"></a>
El nombre para mostrar del panel.  
Type: Cadena  
Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: Sí

 ** [SourceEntity](#API_CreateDashboard_RequestSyntax) **   <a name="QS-CreateDashboard-request-SourceEntity"></a>
La entidad que utiliza como fuente cuando crea el panel. En`SourceEntity`, especifica el tipo de objeto que va a utilizar como fuente. Solo puede crear un panel a partir de una plantilla, de modo que se utiliza un`SourceTemplate`Entidad. Si necesita crear un panel de control a partir de un análisis, primero convierta el análisis en una plantilla mediante la` [CreateTemplate](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateTemplate.html) `Operación de la API. Para`SourceTemplate`, especifique el nombre de recurso de Amazon (ARN) de la plantilla de origen. La`SourceTemplate`El ARN puede contener cualquierAWScuenta y cualquier Amazon QuickSight-admitidoRegión de AWS.   
Usar`DataSetReferences`entidad dentro`SourceTemplate`para enumerar los conjuntos de datos de reemplazo para los marcadores de posición que aparecen en el original. El esquema de cada conjunto de datos debe coincidir con su marcador de posición.   
Tipo: objeto [DashboardSourceEntity](API_DashboardSourceEntity.md)  
Obligatorio: Sí

 ** [DashboardPublishOptions](#API_CreateDashboard_RequestSyntax) **   <a name="QS-CreateDashboard-request-DashboardPublishOptions"></a>
Opciones para publicar el panel al crearlo:  
+  `AvailabilityStatus`para`AdHocFilteringOption`- Este estado puede ser:`ENABLED`o`DISABLED`. Cuando se ha establecido en`DISABLED`, Amazon QuickSight deshabilita el panel de filtro izquierdo en el panel publicado, que se puede usar para el filtrado ad hoc (una sola vez). Esta opción es`ENABLED`de forma predeterminada. 
+  `AvailabilityStatus`para`ExportToCSVOption`- Este estado puede ser:`ENABLED`o`DISABLED`. La opción visual para exportar datos a formato.CSV no está habilitada cuando se establece en`DISABLED`. Esta opción es`ENABLED`de forma predeterminada. 
+  `VisibilityState`para`SheetControlsOption`- Este estado de visibilidad puede ser`COLLAPSED`o`EXPANDED`. Esta opción es`COLLAPSED`de forma predeterminada. 
Tipo: objeto [DashboardPublishOptions](API_DashboardPublishOptions.md)  
Obligatorio: No

 ** [Parameters](#API_CreateDashboard_RequestSyntax) **   <a name="QS-CreateDashboard-request-Parameters"></a>
Los parámetros para la creación del panel, que desea usar para anular la configuración predeterminada. Un panel puede tener cualquier tipo de parámetros y algunos parámetros pueden aceptar varios valores.   
Tipo: objeto [Parameters](API_Parameters.md)  
Obligatorio: No

 ** [Permissions](#API_CreateDashboard_RequestSyntax) **   <a name="QS-CreateDashboard-request-Permissions"></a>
: una estructura que contiene los permisos del panel. Puede usar esta estructura para conceder permisos si proporciona una lista de información de acción de IAM para cada ARN principal.   
Para no especificar ningún permiso, omita la lista de permisos.  
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_CreateDashboard_RequestSyntax) **   <a name="QS-CreateDashboard-request-Tags"></a>
Contiene un mapa de los pares clave-valor para la etiqueta o etiquetas de recursos asignadas al panel.  
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_CreateDashboard_RequestSyntax) **   <a name="QS-CreateDashboard-request-ThemeArn"></a>
El nombre de recurso de Amazon (ARN) del tema que se está utilizando para este panel. Si agrega un valor para este campo, anula el valor que se utiliza en la entidad de origen. El ARN del tema debe existir en el mismoAWScuenta en la que se crea el panel de control.  
Type: Cadena  
Obligatorio: No

 ** [VersionDescription](#API_CreateDashboard_RequestSyntax) **   <a name="QS-CreateDashboard-request-VersionDescription"></a>
: descripción de la primera versión del panel que se está creando.  
Type: Cadena  
Restricciones de longitud Longitud mínima de 1. La longitud máxima es 512.  
Obligatorio: No

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

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

{
   "Arn": "string",
   "CreationStatus": "string",
   "DashboardId": "string",
   "RequestId": "string",
   "VersionArn": "string"
}
```

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

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Arn](#API_CreateDashboard_ResponseSyntax) **   <a name="QS-CreateDashboard-response-Arn"></a>
El ARN del panel.  
Type: Cadena

 ** [CreationStatus](#API_CreateDashboard_ResponseSyntax) **   <a name="QS-CreateDashboard-response-CreationStatus"></a>
Estado de la solicitud de creación de paneles.  
Type: Cadena  
Valores válidos:` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` 

 ** [DashboardId](#API_CreateDashboard_ResponseSyntax) **   <a name="QS-CreateDashboard-response-DashboardId"></a>
El identificador del panel.  
Type: Cadena  
Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Patrón: `[\w\-]+` 

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

 ** [VersionArn](#API_CreateDashboard_ResponseSyntax) **   <a name="QS-CreateDashboard-response-VersionArn"></a>
El ARN del panel, incluido el número de versión de la primera versión que se crea.  
Type: Cadena

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