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.

# CreateDataSet
<a name="API_CreateDataSet"></a>

Crea un conjunto de datos. Esta operación no admite conjuntos de datos que incluyan archivos cargados como fuente.

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

```
POST /accounts/AwsAccountId/data-sets HTTP/1.1
Content-type: application/json

{
   "ColumnGroups": [ 
      { 
         "GeoSpatialColumnGroup": { 
            "Columns": [ "string" ],
            "CountryCode": "string",
            "Name": "string"
         }
      }
   ],
   "ColumnLevelPermissionRules": [ 
      { 
         "ColumnNames": [ "string" ],
         "Principals": [ "string" ]
      }
   ],
   "DataSetId": "string",
   "DataSetUsageConfiguration": { 
      "DisableUseAsDirectQuerySource": boolean,
      "DisableUseAsImportedSource": boolean
   },
   "FieldFolders": { 
      "string" : { 
         "columns": [ "string" ],
         "description": "string"
      }
   },
   "ImportMode": "string",
   "LogicalTableMap": { 
      "string" : { 
         "Alias": "string",
         "DataTransforms": [ 
            { 
               "CastColumnTypeOperation": { 
                  "ColumnName": "string",
                  "Format": "string",
                  "NewColumnType": "string"
               },
               "CreateColumnsOperation": { 
                  "Columns": [ 
                     { 
                        "ColumnId": "string",
                        "ColumnName": "string",
                        "Expression": "string"
                     }
                  ]
               },
               "FilterOperation": { 
                  "ConditionExpression": "string"
               },
               "ProjectOperation": { 
                  "ProjectedColumns": [ "string" ]
               },
               "RenameColumnOperation": { 
                  "ColumnName": "string",
                  "NewColumnName": "string"
               },
               "TagColumnOperation": { 
                  "ColumnName": "string",
                  "Tags": [ 
                     { 
                        "ColumnDescription": { 
                           "Text": "string"
                        },
                        "ColumnGeographicRole": "string"
                     }
                  ]
               },
               "UntagColumnOperation": { 
                  "ColumnName": "string",
                  "TagNames": [ "string" ]
               }
            }
         ],
         "Source": { 
            "DataSetArn": "string",
            "JoinInstruction": { 
               "LeftJoinKeyProperties": { 
                  "UniqueKey": boolean
               },
               "LeftOperand": "string",
               "OnClause": "string",
               "RightJoinKeyProperties": { 
                  "UniqueKey": boolean
               },
               "RightOperand": "string",
               "Type": "string"
            },
            "PhysicalTableId": "string"
         }
      }
   },
   "Name": "string",
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "PhysicalTableMap": { 
      "string" : { 
         "CustomSql": { 
            "Columns": [ 
               { 
                  "Name": "string",
                  "Type": "string"
               }
            ],
            "DataSourceArn": "string",
            "Name": "string",
            "SqlQuery": "string"
         },
         "RelationalTable": { 
            "Catalog": "string",
            "DataSourceArn": "string",
            "InputColumns": [ 
               { 
                  "Name": "string",
                  "Type": "string"
               }
            ],
            "Name": "string",
            "Schema": "string"
         },
         "S3Source": { 
            "DataSourceArn": "string",
            "InputColumns": [ 
               { 
                  "Name": "string",
                  "Type": "string"
               }
            ],
            "UploadSettings": { 
               "ContainsHeader": boolean,
               "Delimiter": "string",
               "Format": "string",
               "StartFromRow": number,
               "TextQualifier": "string"
            }
         }
      }
   },
   "RowLevelPermissionDataSet": { 
      "Arn": "string",
      "FormatVersion": "string",
      "Namespace": "string",
      "PermissionPolicy": "string",
      "Status": "string"
   },
   "RowLevelPermissionTagConfiguration": { 
      "Status": "string",
      "TagRules": [ 
         { 
            "ColumnName": "string",
            "MatchAllValue": "string",
            "TagKey": "string",
            "TagMultiValueDelimiter": "string"
         }
      ]
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

La solicitud utiliza los siguientes parámetros URI.

 ** [AwsAccountId](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-AwsAccountId"></a>
El ID de la cuenta de AWS.  
Restricciones de longitud Longitud fija de 12.  
Patrón: `^[0-9]{12}$`   
Obligatorio: Sí

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

La solicitud acepta los siguientes datos en formato JSON.

 ** [DataSetId](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-DataSetId"></a>
ID del conjunto de datos que desea crear. Este ID es único porRegión de AWSpara cadaAWSaccount.  
Type: Cadena  
Obligatorio: Sí

 ** [ImportMode](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-ImportMode"></a>
Indica si desea importar los datos a SPICE.  
Type: Cadena  
Valores válidos:` SPICE | DIRECT_QUERY`   
Obligatorio: Sí

 ** [Name](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-Name"></a>
El nombre para mostrar en el conjunto de datos.  
Type: Cadena  
Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 128 caracteres.  
Obligatorio: Sí

 ** [PhysicalTableMap](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-PhysicalTableMap"></a>
Declara las tablas físicas que están disponibles en los orígenes de datos subyacentes.  
Type: Cadena para[PhysicalTable](API_PhysicalTable.md)mapa de objetos  
Entradas de mapa: El número mínimo es 0 elementos. Número máximo de 32 elementos.  
Restricciones de longitud de las Longitud mínima de 1. La longitud máxima es 64.  
Patrón de clave: `[0-9a-zA-Z-]*`   
Obligatorio: Sí

 ** [ColumnGroups](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-ColumnGroups"></a>
Agrupaciones de columnas que funcionan juntas en determinadas Amazon QuickSight Características. Actualmente, solo se admite la jerarquía geoespacial.  
Type: Matriz de[ColumnGroup](API_ColumnGroup.md)objects  
Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 8 elementos.  
Obligatorio: No

 ** [ColumnLevelPermissionRules](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-ColumnLevelPermissionRules"></a>
Un conjunto de una o más definiciones de una ` [ColumnLevelPermissionRule](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ColumnLevelPermissionRule.html) `.  
Type: Matriz de[ColumnLevelPermissionRule](API_ColumnLevelPermissionRule.md)objects  
Miembros de la matriz: Número mínimo de 1 elemento.  
Obligatorio: No

 ** [DataSetUsageConfiguration](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-DataSetUsageConfiguration"></a>
La configuración de uso que se aplicará a los conjuntos de datos secundarios que hacen referencia a este conjunto de datos como fuente.  
Tipo: objeto [DataSetUsageConfiguration](API_DataSetUsageConfiguration.md)  
Obligatorio: No

 ** [FieldFolders](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-FieldFolders"></a>
La carpeta que contiene campos y subcarpetas anidadas para el conjunto de datos.  
Type: Cadena para[FieldFolder](API_FieldFolder.md)mapa de objetos  
Restricciones de longitud de las Longitud mínima de 1. La longitud máxima es de 1000 caracteres.  
Obligatorio: No

 ** [LogicalTableMap](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-LogicalTableMap"></a>
Configura la combinación y transformación de los datos de las tablas físicas.  
Type: Cadena para[LogicalTable](API_LogicalTable.md)mapa de objetos  
Entradas de mapa: Número máximo de 64 elementos.  
Restricciones de longitud de las Longitud mínima de 1. La longitud máxima es 64.  
Patrón de clave: `[0-9a-zA-Z-]*`   
Obligatorio: No

 ** [Permissions](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-Permissions"></a>
Una lista de permisos de recursos en el conjunto de datos.  
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

 ** [RowLevelPermissionDataSet](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-RowLevelPermissionDataSet"></a>
La configuración de seguridad de nivel de fila para los datos que desea crear.  
Tipo: objeto [RowLevelPermissionDataSet](API_RowLevelPermissionDataSet.md)  
Obligatorio: No

 ** [RowLevelPermissionTagConfiguration](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-RowLevelPermissionTagConfiguration"></a>
La configuración de etiquetas en un conjunto de datos para establecer la seguridad a nivel de fila. Actualmente, las etiquetas de seguridad a nivel de fila solo se admiten para la incrustación anónima.  
Tipo: objeto [RowLevelPermissionTagConfiguration](API_RowLevelPermissionTagConfiguration.md)  
Obligatorio: No

 ** [Tags](#API_CreateDataSet_RequestSyntax) **   <a name="QS-CreateDataSet-request-Tags"></a>
Contiene un mapa de los pares clave-valor para la etiqueta o etiquetas de recursos asignadas al conjunto de datos.  
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

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

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

{
   "Arn": "string",
   "DataSetId": "string",
   "IngestionArn": "string",
   "IngestionId": "string",
   "RequestId": "string"
}
```

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

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Arn](#API_CreateDataSet_ResponseSyntax) **   <a name="QS-CreateDataSet-response-Arn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos.  
Type: Cadena

 ** [DataSetId](#API_CreateDataSet_ResponseSyntax) **   <a name="QS-CreateDataSet-response-DataSetId"></a>
ID del conjunto de datos que desea crear. Este ID es único porRegión de AWSpara cadaAWSaccount.  
Type: Cadena

 ** [IngestionArn](#API_CreateDataSet_ResponseSyntax) **   <a name="QS-CreateDataSet-response-IngestionArn"></a>
El ARN para la ingesta, que se activa como resultado de la creación del conjunto de datos si el modo de importación es SPICE.  
Type: Cadena

 ** [IngestionId](#API_CreateDataSet_ResponseSyntax) **   <a name="QS-CreateDataSet-response-IngestionId"></a>
El ID de la ingesta, que se activa como resultado de la creación del conjunto de datos si el modo de importación es SPICE.  
Type: Cadena

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

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

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

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

 ** LimitExceededException **   
Se superó un límite.  
Código de estado HTTP: 409

 ** 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 tiene actualmente Standard Edition y Enterprise Edition. No todas las operaciones y funciones están disponibles en todas las ediciones.  
Código de estado HTTP: 403

## Ejemplos
<a name="API_CreateDataSet_Examples"></a>

### Ejemplo
<a name="API_CreateDataSet_Example_1"></a>

Este ejemplo ilustra un uso de CreateDataSet.

#### Solicitud de muestra
<a name="API_CreateDataSet_Example_1_Request"></a>

```
POST /accounts/{AwsAccountId}/data-sets HTTP/1.1
Content-type: application/json
```

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