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.

# UpdateDataSet
<a name="API_UpdateDataSet"></a>

Actualiza 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_UpdateDataSet_RequestSyntax"></a>

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

{
   "ColumnGroups": [ 
      { 
         "GeoSpatialColumnGroup": { 
            "Columns": [ "string" ],
            "CountryCode": "string",
            "Name": "string"
         }
      }
   ],
   "ColumnLevelPermissionRules": [ 
      { 
         "ColumnNames": [ "string" ],
         "Principals": [ "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",
   "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"
         }
      ]
   }
}
```

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

La solicitud utiliza los siguientes parámetros URI.

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

 ** [DataSetId](#API_UpdateDataSet_RequestSyntax) **   <a name="QS-UpdateDataSet-request-DataSetId"></a>
ID del conjunto de datos que desea actualizar. Este ID es único porRegión de AWSpara cada)AWSaccount.  
Required: Sí

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

La solicitud acepta los siguientes datos en formato JSON.

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

 ** [Name](#API_UpdateDataSet_RequestSyntax) **   <a name="QS-UpdateDataSet-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.  
Required: Sí

 ** [PhysicalTableMap](#API_UpdateDataSet_RequestSyntax) **   <a name="QS-UpdateDataSet-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: Longitud mínima de 1. La longitud máxima es 64.  
Patrón de clave: `[0-9a-zA-Z-]*`   
Required: Sí

 ** [ColumnGroups](#API_UpdateDataSet_RequestSyntax) **   <a name="QS-UpdateDataSet-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 de 1 elemento. Número máximo de 8 elementos.  
Required: No

 ** [ColumnLevelPermissionRules](#API_UpdateDataSet_RequestSyntax) **   <a name="QS-UpdateDataSet-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 de 1 elemento.  
Required: No

 ** [DataSetUsageConfiguration](#API_UpdateDataSet_RequestSyntax) **   <a name="QS-UpdateDataSet-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)  
Required: No

 ** [FieldFolders](#API_UpdateDataSet_RequestSyntax) **   <a name="QS-UpdateDataSet-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: Longitud mínima de 1. La longitud máxima es de 1000 caracteres.  
Required: No

 ** [LogicalTableMap](#API_UpdateDataSet_RequestSyntax) **   <a name="QS-UpdateDataSet-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: Longitud mínima de 1. La longitud máxima es 64.  
Patrón de clave: `[0-9a-zA-Z-]*`   
Required: No

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

 ** [RowLevelPermissionTagConfiguration](#API_UpdateDataSet_RequestSyntax) **   <a name="QS-UpdateDataSet-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)  
Required: No

## Sintaxis de la respuesta
<a name="API_UpdateDataSet_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_UpdateDataSet_ResponseElements"></a>

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

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

El servicio devuelve los datos siguientes en formato JSON.

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

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

 ** [IngestionArn](#API_UpdateDataSet_ResponseSyntax) **   <a name="QS-UpdateDataSet-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_UpdateDataSet_ResponseSyntax) **   <a name="QS-UpdateDataSet-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_UpdateDataSet_ResponseSyntax) **   <a name="QS-UpdateDataSet-response-RequestId"></a>
LaAWSID de esta operación.  
Type: Cadena

## Errores
<a name="API_UpdateDataSet_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 a este elemento. 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 las políticas tienen los permisos de 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

 ** 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 una operación en una operación en una operación QuickSighten la que la edición no incluye soporte para esa operación. Amazon QuickSight 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

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

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

Este ejemplo ilustra un uso de UpdateDataSet.

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

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

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