Para obtener capacidades similares a las de Amazon Timestream, considere Amazon Timestream LiveAnalytics para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información [aquí](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

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.

# Referencia de la API
<a name="API_Reference"></a>

Esta sección contiene la documentación de referencia de la API para Amazon Timestream. 

Timestream tiene dos APIs: Query y Write.
+ La **API Write** le permite realizar operaciones como la creación de tablas, el etiquetado de recursos y la escritura de registros en Timestream.
+ La **API Query** le permite realizar operaciones de consulta.

**nota**  
Ambos APIs incluyen la DescribeEndpoints acción. *Tanto para Query como para Write, la DescribeEndpoints acción es idéntica.*

Puede obtener más información sobre cada API a continuación, junto con los tipos de datos, los errores comunes y los parámetros.

**nota**  
Para ver los códigos de error comunes a todos los AWS servicios, consulte la [sección AWS Support](https://docs.aws.amazon.com/awssupport/latest/APIReference/CommonErrors.html). 

**Topics**
+ [

# Acciones
](API_Operations.md)
+ [

# Data Types
](API_Types.md)
+ [

# Errores comunes
](CommonErrors.md)
+ [

# Parámetros comunes
](CommonParameters.md)

# Acciones
<a name="API_Operations"></a>

La escritura de Amazon Timestream admite las siguientes acciones:
+  [CreateBatchLoadTask](API_CreateBatchLoadTask.md) 
+  [CreateDatabase](API_CreateDatabase.md) 
+  [CreateTable](API_CreateTable.md) 
+  [DeleteDatabase](API_DeleteDatabase.md) 
+  [DeleteTable](API_DeleteTable.md) 
+  [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) 
+  [DescribeDatabase](API_DescribeDatabase.md) 
+  [DescribeEndpoints](API_DescribeEndpoints.md) 
+  [DescribeTable](API_DescribeTable.md) 
+  [ListBatchLoadTasks](API_ListBatchLoadTasks.md) 
+  [ListDatabases](API_ListDatabases.md) 
+  [ListTables](API_ListTables.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateDatabase](API_UpdateDatabase.md) 
+  [UpdateTable](API_UpdateTable.md) 
+  [WriteRecords](API_WriteRecords.md) 

La consulta de Amazon Timestream admite las siguientes acciones:
+  [CancelQuery](API_query_CancelQuery.md) 
+  [CreateScheduledQuery](API_query_CreateScheduledQuery.md) 
+  [DeleteScheduledQuery](API_query_DeleteScheduledQuery.md) 
+  [DescribeAccountSettings](API_query_DescribeAccountSettings.md) 
+  [DescribeEndpoints](API_query_DescribeEndpoints.md) 
+  [DescribeScheduledQuery](API_query_DescribeScheduledQuery.md) 
+  [ExecuteScheduledQuery](API_query_ExecuteScheduledQuery.md) 
+  [ListScheduledQueries](API_query_ListScheduledQueries.md) 
+  [ListTagsForResource](API_query_ListTagsForResource.md) 
+  [PrepareQuery](API_query_PrepareQuery.md) 
+  [Query](API_query_Query.md) 
+  [TagResource](API_query_TagResource.md) 
+  [UntagResource](API_query_UntagResource.md) 
+  [UpdateAccountSettings](API_query_UpdateAccountSettings.md) 
+  [UpdateScheduledQuery](API_query_UpdateScheduledQuery.md) 

# Escritura de Amazon Timestream
<a name="API_Operations_Amazon_Timestream_Write"></a>

La escritura de Amazon Timestream admite las siguientes acciones:
+  [CreateBatchLoadTask](API_CreateBatchLoadTask.md) 
+  [CreateDatabase](API_CreateDatabase.md) 
+  [CreateTable](API_CreateTable.md) 
+  [DeleteDatabase](API_DeleteDatabase.md) 
+  [DeleteTable](API_DeleteTable.md) 
+  [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) 
+  [DescribeDatabase](API_DescribeDatabase.md) 
+  [DescribeEndpoints](API_DescribeEndpoints.md) 
+  [DescribeTable](API_DescribeTable.md) 
+  [ListBatchLoadTasks](API_ListBatchLoadTasks.md) 
+  [ListDatabases](API_ListDatabases.md) 
+  [ListTables](API_ListTables.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateDatabase](API_UpdateDatabase.md) 
+  [UpdateTable](API_UpdateTable.md) 
+  [WriteRecords](API_WriteRecords.md) 

# CreateBatchLoadTask
<a name="API_CreateBatchLoadTask"></a>

Crea una tarea nueva de carga por lotes de Timestream. Una tarea de carga por lotes procesa los datos de un origen CSV en una ubicación de S3 y los escribe en una tabla de Timestream. En una tarea de carga por lotes se define un mapeo del origen al destino. Los errores y los eventos se escriben en un informe en una ubicación de S3. En el caso del informe, si no se especifica la AWS KMS clave, el informe se cifrará con una clave gestionada por S3 cuando `SSE_S3` sea posible. De lo contrario, se genera un error. Para obtener más información, consulte [Claves administradas de AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk). [Se aplican cuotas de servicio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Para obtener más información, consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html).

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

```
{
   "ClientToken": "string",
   "DataModelConfiguration": { 
      "DataModel": { 
         "DimensionMappings": [ 
            { 
               "DestinationColumn": "string",
               "SourceColumn": "string"
            }
         ],
         "MeasureNameColumn": "string",
         "MixedMeasureMappings": [ 
            { 
               "MeasureName": "string",
               "MeasureValueType": "string",
               "MultiMeasureAttributeMappings": [ 
                  { 
                     "MeasureValueType": "string",
                     "SourceColumn": "string",
                     "TargetMultiMeasureAttributeName": "string"
                  }
               ],
               "SourceColumn": "string",
               "TargetMeasureName": "string"
            }
         ],
         "MultiMeasureMappings": { 
            "MultiMeasureAttributeMappings": [ 
               { 
                  "MeasureValueType": "string",
                  "SourceColumn": "string",
                  "TargetMultiMeasureAttributeName": "string"
               }
            ],
            "TargetMultiMeasureName": "string"
         },
         "TimeColumn": "string",
         "TimeUnit": "string"
      },
      "DataModelS3Configuration": { 
         "BucketName": "string",
         "ObjectKey": "string"
      }
   },
   "DataSourceConfiguration": { 
      "CsvConfiguration": { 
         "ColumnSeparator": "string",
         "EscapeChar": "string",
         "NullValue": "string",
         "QuoteChar": "string",
         "TrimWhiteSpace": boolean
      },
      "DataFormat": "string",
      "DataSourceS3Configuration": { 
         "BucketName": "string",
         "ObjectKeyPrefix": "string"
      }
   },
   "RecordVersion": number,
   "ReportConfiguration": { 
      "ReportS3Configuration": { 
         "BucketName": "string",
         "EncryptionOption": "string",
         "KmsKeyId": "string",
         "ObjectKeyPrefix": "string"
      }
   },
   "TargetDatabaseName": "string",
   "TargetTableName": "string"
}
```

## Parámetros de la solicitud
<a name="API_CreateBatchLoadTask_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-ClientToken"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Obligatorio: no

 ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-DataModelConfiguration"></a>
  
Tipo: objeto [DataModelConfiguration](API_DataModelConfiguration.md)  
Obligatorio: no

 ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-DataSourceConfiguration"></a>
Define la información de configuración del origen de datos de una tarea de carga por lotes.  
Tipo: objeto [DataSourceConfiguration](API_DataSourceConfiguration.md)  
Obligatorio: sí

 ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-RecordVersion"></a>
  
Tipo: largo  
Obligatorio: no

 ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-ReportConfiguration"></a>
Informe de la configuración de una tarea de carga por lotes. Contiene información sobre dónde se almacenan los informes de errores.  
Tipo: objeto [ReportConfiguration](API_ReportConfiguration.md)  
Obligatorio: sí

 ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-TargetDatabaseName"></a>
Base de datos de Timestream de destino para una tarea de carga por lotes.  
Tipo: cadena  
Patrón: `[a-zA-Z0-9_.-]+`   
Obligatorio: sí

 ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-TargetTableName"></a>
Tabla de Timestream de destino para una tarea de carga por lotes.  
Tipo: cadena  
Patrón: `[a-zA-Z0-9_.-]+`   
Obligatorio: sí

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

```
{
   "TaskId": "string"
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) **   <a name="timestream-CreateBatchLoadTask-response-TaskId"></a>
El ID de la tarea de carga por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 32 caracteres.  
Patrón: `[A-Z0-9]+` 

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** ConflictException **   
Timestream no pudo procesar esta solicitud porque contiene un recurso que ya existe.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ServiceQuotaExceededException **   
 Se superó la cuota de recursos de la instancia para esta cuenta.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateBatchLoadTask_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask) 

# CreateDatabase
<a name="API_CreateDatabase"></a>

Crea una nueva base de datos de Timestream. Si no se especifica la AWS KMS clave, la base de datos se cifrará con una AWS KMS clave gestionada por Timestream ubicada en su cuenta. Para obtener más información, consulte [Claves administradas de AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk). [Se aplican cuotas de servicio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Para obtener más información, consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html). 

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

```
{
   "DatabaseName": "string",
   "KmsKeyId": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateDatabase_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [DatabaseName](#API_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-request-DatabaseName"></a>
Nombre de la base de datos de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z0-9_.-]+`   
Obligatorio: sí

 ** [KmsKeyId](#API_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-request-KmsKeyId"></a>
La AWS KMS clave de la base de datos. Si no se especifica la AWS KMS clave, la base de datos se cifrará con una AWS KMS clave gestionada por Timestream ubicada en su cuenta. Para obtener más información, consulte [Claves administradas de AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** [Tags](#API_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-request-Tags"></a>
 Lista de pares clave-valor para etiquetar la tabla.   
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

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

```
{
   "Database": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "KmsKeyId": "string",
      "LastUpdatedTime": number,
      "TableCount": number
   }
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Database](#API_CreateDatabase_ResponseSyntax) **   <a name="timestream-CreateDatabase-response-Database"></a>
La base de datos nueva de Timestream.  
Tipo: objeto [Database](API_Database.md)

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** ConflictException **   
Timestream no pudo procesar esta solicitud porque contiene un recurso que ya existe.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ServiceQuotaExceededException **   
 Se superó la cuota de recursos de la instancia para esta cuenta.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateDatabase_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateDatabase) 

# CreateTable
<a name="API_CreateTable"></a>

Agrega una tabla nueva a una base de datos que ya existe en la cuenta. En un Cuenta de AWS, los nombres de las tablas deben ser al menos únicos en cada región si están en la misma base de datos. Podría haber nombres de tabla idénticos en la misma región si las tablas están en bases de datos distintas. Cuando cree la tabla, debe especificar su nombre, el nombre de la base de datos y las propiedades de retención. [Se aplican cuotas de servicio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html) para obtener más detalles. 

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

```
{
   "DatabaseName": "string",
   "MagneticStoreWriteProperties": { 
      "EnableMagneticStoreWrites": boolean,
      "MagneticStoreRejectedDataLocation": { 
         "S3Configuration": { 
            "BucketName": "string",
            "EncryptionOption": "string",
            "KmsKeyId": "string",
            "ObjectKeyPrefix": "string"
         }
      }
   },
   "RetentionProperties": { 
      "MagneticStoreRetentionPeriodInDays": number,
      "MemoryStoreRetentionPeriodInHours": number
   },
   "Schema": { 
      "CompositePartitionKey": [ 
         { 
            "EnforcementInRecord": "string",
            "Name": "string",
            "Type": "string"
         }
      ]
   },
   "TableName": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateTable_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [DatabaseName](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-DatabaseName"></a>
Nombre de la base de datos de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z0-9_.-]+`   
Obligatorio: sí

 ** [MagneticStoreWriteProperties](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-MagneticStoreWriteProperties"></a>
Contiene las propiedades que se tienen que establecer en la tabla cuando se habilitan las escrituras en el almacén magnético.  
Tipo: objeto [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)  
Obligatorio: no

 ** [RetentionProperties](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-RetentionProperties"></a>
La duración para la que los datos de serie temporal deben almacenarse en el almacén magnético y en el almacén de memoria.  
Tipo: objeto [RetentionProperties](API_RetentionProperties.md)  
Obligatorio: no

 ** [Schema](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-Schema"></a>
 El esquema de la tabla.   
Tipo: objeto [Schema](API_Schema.md)  
Obligatorio: no

 ** [TableName](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-TableName"></a>
Nombre de la tabla de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z0-9_.-]+`   
Obligatorio: sí

 ** [Tags](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-Tags"></a>
 Lista de pares clave-valor para etiquetar la tabla.   
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

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

```
{
   "Table": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "LastUpdatedTime": number,
      "MagneticStoreWriteProperties": { 
         "EnableMagneticStoreWrites": boolean,
         "MagneticStoreRejectedDataLocation": { 
            "S3Configuration": { 
               "BucketName": "string",
               "EncryptionOption": "string",
               "KmsKeyId": "string",
               "ObjectKeyPrefix": "string"
            }
         }
      },
      "RetentionProperties": { 
         "MagneticStoreRetentionPeriodInDays": number,
         "MemoryStoreRetentionPeriodInHours": number
      },
      "Schema": { 
         "CompositePartitionKey": [ 
            { 
               "EnforcementInRecord": "string",
               "Name": "string",
               "Type": "string"
            }
         ]
      },
      "TableName": "string",
      "TableStatus": "string"
   }
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Table](#API_CreateTable_ResponseSyntax) **   <a name="timestream-CreateTable-response-Table"></a>
La tabla nueva de Timestream.  
Tipo: objeto [Table](API_Table.md)

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** ConflictException **   
Timestream no pudo procesar esta solicitud porque contiene un recurso que ya existe.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ServiceQuotaExceededException **   
 Se superó la cuota de recursos de la instancia para esta cuenta.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateTable_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateTable) 

# DeleteDatabase
<a name="API_DeleteDatabase"></a>

Elimina una base de datos determinada de Timestream. *Se trata de una operación irreversible. Una vez que se elimina una base de datos, no pueden recuperarse los datos de serie temporal de las tablas.* 

**nota**  
Primero se deben eliminar todas las tablas de la base de datos o se producirá un ValidationException error.   
Debido a la naturaleza de los reintentos distribuidos, la operación puede arrojar un resultado exitoso o un ResourceNotFoundException. Los clientes deberían considerarlos equivalentes.

Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html) para obtener más detalles.

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

```
{
   "DatabaseName": "string"
}
```

## Parámetros de la solicitud
<a name="API_DeleteDatabase_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [DatabaseName](#API_DeleteDatabase_RequestSyntax) **   <a name="timestream-DeleteDatabase-request-DatabaseName"></a>
Nombre de la base de datos de Timestream que debe eliminarse.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteDatabase_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteDatabase) 

# DeleteTable
<a name="API_DeleteTable"></a>

Elimina una tabla determinada de Timestream. Se trata de una operación irreversible. Una vez que se elimina una base de datos de Timestream, no pueden recuperarse los datos de serie temporal almacenados de la tabla. 

**nota**  
Debido a la naturaleza de los reintentos distribuidos, la operación puede arrojar un resultado exitoso o un ResourceNotFoundException. Los clientes deberían considerarlos equivalentes.

Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html) para obtener más detalles.

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

```
{
   "DatabaseName": "string",
   "TableName": "string"
}
```

## Parámetros de la solicitud
<a name="API_DeleteTable_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [DatabaseName](#API_DeleteTable_RequestSyntax) **   <a name="timestream-DeleteTable-request-DatabaseName"></a>
El nombre de la base de datos en la que se va a eliminar la base de datos de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** [TableName](#API_DeleteTable_RequestSyntax) **   <a name="timestream-DeleteTable-request-TableName"></a>
Nombre de la tabla de Timestream que debe eliminarse.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteTable_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteTable) 

# DescribeBatchLoadTask
<a name="API_DescribeBatchLoadTask"></a>

Muestra información sobre la tarea de carga por lotes, incluidas las configuraciones, las asignaciones, el progreso y otros detalles. [Se aplican cuotas de servicio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-batch-load.html) para obtener más detalles.

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

```
{
   "TaskId": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeBatchLoadTask_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [TaskId](#API_DescribeBatchLoadTask_RequestSyntax) **   <a name="timestream-DescribeBatchLoadTask-request-TaskId"></a>
El ID de la tarea de carga por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 32 caracteres.  
Patrón: `[A-Z0-9]+`   
Obligatorio: sí

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

```
{
   "BatchLoadTaskDescription": { 
      "CreationTime": number,
      "DataModelConfiguration": { 
         "DataModel": { 
            "DimensionMappings": [ 
               { 
                  "DestinationColumn": "string",
                  "SourceColumn": "string"
               }
            ],
            "MeasureNameColumn": "string",
            "MixedMeasureMappings": [ 
               { 
                  "MeasureName": "string",
                  "MeasureValueType": "string",
                  "MultiMeasureAttributeMappings": [ 
                     { 
                        "MeasureValueType": "string",
                        "SourceColumn": "string",
                        "TargetMultiMeasureAttributeName": "string"
                     }
                  ],
                  "SourceColumn": "string",
                  "TargetMeasureName": "string"
               }
            ],
            "MultiMeasureMappings": { 
               "MultiMeasureAttributeMappings": [ 
                  { 
                     "MeasureValueType": "string",
                     "SourceColumn": "string",
                     "TargetMultiMeasureAttributeName": "string"
                  }
               ],
               "TargetMultiMeasureName": "string"
            },
            "TimeColumn": "string",
            "TimeUnit": "string"
         },
         "DataModelS3Configuration": { 
            "BucketName": "string",
            "ObjectKey": "string"
         }
      },
      "DataSourceConfiguration": { 
         "CsvConfiguration": { 
            "ColumnSeparator": "string",
            "EscapeChar": "string",
            "NullValue": "string",
            "QuoteChar": "string",
            "TrimWhiteSpace": boolean
         },
         "DataFormat": "string",
         "DataSourceS3Configuration": { 
            "BucketName": "string",
            "ObjectKeyPrefix": "string"
         }
      },
      "ErrorMessage": "string",
      "LastUpdatedTime": number,
      "ProgressReport": { 
         "BytesMetered": number,
         "FileFailures": number,
         "ParseFailures": number,
         "RecordIngestionFailures": number,
         "RecordsIngested": number,
         "RecordsProcessed": number
      },
      "RecordVersion": number,
      "ReportConfiguration": { 
         "ReportS3Configuration": { 
            "BucketName": "string",
            "EncryptionOption": "string",
            "KmsKeyId": "string",
            "ObjectKeyPrefix": "string"
         }
      },
      "ResumableUntil": number,
      "TargetDatabaseName": "string",
      "TargetTableName": "string",
      "TaskId": "string",
      "TaskStatus": "string"
   }
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BatchLoadTaskDescription](#API_DescribeBatchLoadTask_ResponseSyntax) **   <a name="timestream-DescribeBatchLoadTask-response-BatchLoadTaskDescription"></a>
Descripción de la tarea de carga por lotes.  
Tipo: objeto [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md)

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeBatchLoadTask_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeBatchLoadTask) 

# DescribeDatabase
<a name="API_DescribeDatabase"></a>

Muestra información sobre la base de datos, incluido el nombre de la base de datos, la hora en la que se creó y la cantidad total de tablas que se encuentran en la base de datos. [Se aplican cuotas de servicio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html) para obtener más detalles.

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

```
{
   "DatabaseName": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeDatabase_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [DatabaseName](#API_DescribeDatabase_RequestSyntax) **   <a name="timestream-DescribeDatabase-request-DatabaseName"></a>
Nombre de la base de datos de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

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

```
{
   "Database": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "KmsKeyId": "string",
      "LastUpdatedTime": number,
      "TableCount": number
   }
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Database](#API_DescribeDatabase_ResponseSyntax) **   <a name="timestream-DescribeDatabase-response-Database"></a>
Nombre de la tabla de Timestream.  
Tipo: objeto [Database](API_Database.md)

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeDatabase_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeDatabase) 

# DescribeEndpoints
<a name="API_DescribeEndpoints"></a>

Muestra una lista de puntos de conexión disponibles para realizar llamadas a la API de Timestream. Esta operación de API está disponible a través de Write y Query APIs.

Dado que los Timestream SDKs están diseñados para funcionar de forma transparente con la arquitectura del servicio, incluida la administración y el mapeo de los puntos finales del servicio, *no recomendamos utilizar esta operación de API a menos que*:
+ Utiliza [puntos de conexión de VPC (AWS PrivateLink) con Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints). 
+ Su aplicación utiliza un lenguaje de programación que aún no es compatible con SDK.
+ Necesita un mejor control sobre la implementación por parte del cliente.

Para obtener información detallada sobre cómo y cuándo usar e implementar DescribeEndpoints, consulte [The](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery) Endpoint Discovery Pattern.

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

```
{
   "Endpoints": [ 
      { 
         "Address": "string",
         "CachePeriodInMinutes": number
      }
   ]
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Endpoints](#API_DescribeEndpoints_ResponseSyntax) **   <a name="timestream-DescribeEndpoints-response-Endpoints"></a>
Se muestra un objeto de `Endpoints` cuando se realiza una solicitud de `DescribeEndpoints`.  
Tipo: matriz de objetos [Endpoint](API_Endpoint.md)

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

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

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeEndpoints_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeEndpoints) 

# DescribeTable
<a name="API_DescribeTable"></a>

Muestra información sobre la tabla, incluido su nombre, el nombre de la base de datos, el tiempo de retención del almacén de memoria y el almacenamiento magnético. [Se aplican cuotas de servicio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html) para obtener más detalles. 

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

```
{
   "DatabaseName": "string",
   "TableName": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeTable_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [DatabaseName](#API_DescribeTable_RequestSyntax) **   <a name="timestream-DescribeTable-request-DatabaseName"></a>
Nombre de la base de datos de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** [TableName](#API_DescribeTable_RequestSyntax) **   <a name="timestream-DescribeTable-request-TableName"></a>
Nombre de la tabla de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

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

```
{
   "Table": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "LastUpdatedTime": number,
      "MagneticStoreWriteProperties": { 
         "EnableMagneticStoreWrites": boolean,
         "MagneticStoreRejectedDataLocation": { 
            "S3Configuration": { 
               "BucketName": "string",
               "EncryptionOption": "string",
               "KmsKeyId": "string",
               "ObjectKeyPrefix": "string"
            }
         }
      },
      "RetentionProperties": { 
         "MagneticStoreRetentionPeriodInDays": number,
         "MemoryStoreRetentionPeriodInHours": number
      },
      "Schema": { 
         "CompositePartitionKey": [ 
            { 
               "EnforcementInRecord": "string",
               "Name": "string",
               "Type": "string"
            }
         ]
      },
      "TableName": "string",
      "TableStatus": "string"
   }
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Table](#API_DescribeTable_ResponseSyntax) **   <a name="timestream-DescribeTable-response-Table"></a>
La tabla de Timestream.  
Tipo: objeto [Table](API_Table.md)

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeTable_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeTable) 

# ListBatchLoadTasks
<a name="API_ListBatchLoadTasks"></a>

Ofrece una lista de las tareas de carga por lotes, junto con el nombre, el estado, hasta cuándo se puede reanudar la tarea y otra información. Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-batch-load-tasks.html) para obtener más detalles.

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

```
{
   "MaxResults": number,
   "NextToken": "string",
   "TaskStatus": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListBatchLoadTasks_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [MaxResults](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-MaxResults"></a>
El número total de elementos que se devuelven en la salida. Si el número total de artículos disponibles es superior al valor especificado, NextToken se proporciona a en la salida. Para reanudar la paginación, proporciona el NextToken valor como argumento de una invocación posterior a la API.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [NextToken](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-NextToken"></a>
Un token destinado a especificar dónde iniciar la paginación. Es el NextToken de una respuesta previamente truncada.  
Tipo: cadena  
Requerido: no

 ** [TaskStatus](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-TaskStatus"></a>
Estado de la tarea de carga por lotes.  
Tipo: cadena  
Valores válidos: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME`   
Obligatorio: no

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

```
{
   "BatchLoadTasks": [ 
      { 
         "CreationTime": number,
         "DatabaseName": "string",
         "LastUpdatedTime": number,
         "ResumableUntil": number,
         "TableName": "string",
         "TaskId": "string",
         "TaskStatus": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BatchLoadTasks](#API_ListBatchLoadTasks_ResponseSyntax) **   <a name="timestream-ListBatchLoadTasks-response-BatchLoadTasks"></a>
Una lista de detalles de la tarea de carga por lotes.  
Tipo: matriz de objetos [BatchLoadTask](API_BatchLoadTask.md)

 ** [NextToken](#API_ListBatchLoadTasks_ResponseSyntax) **   <a name="timestream-ListBatchLoadTasks-response-NextToken"></a>
Un token destinado a especificar dónde iniciar la paginación. Proporcione la siguiente. ListBatchLoadTasksRequest  
Tipo: cadena

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListBatchLoadTasks_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListBatchLoadTasks) 

# ListDatabases
<a name="API_ListDatabases"></a>

Muestra una lista de las bases de datos de Timestream. [Se aplican cuotas de servicio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html) para obtener más detalles. 

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

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListDatabases_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [MaxResults](#API_ListDatabases_RequestSyntax) **   <a name="timestream-ListDatabases-request-MaxResults"></a>
El número total de elementos que se devuelven en la salida. Si el número total de artículos disponibles es superior al valor especificado, NextToken se proporciona a en la salida. Para reanudar la paginación, proporciona el NextToken valor como argumento de una invocación posterior a la API.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 20.  
Obligatorio: no

 ** [NextToken](#API_ListDatabases_RequestSyntax) **   <a name="timestream-ListDatabases-request-NextToken"></a>
El token de paginación. Para reanudar la paginación, proporciona el NextToken valor como argumento de una invocación posterior a la API.  
Tipo: cadena  
Requerido: no

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

```
{
   "Databases": [ 
      { 
         "Arn": "string",
         "CreationTime": number,
         "DatabaseName": "string",
         "KmsKeyId": "string",
         "LastUpdatedTime": number,
         "TableCount": number
      }
   ],
   "NextToken": "string"
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Databases](#API_ListDatabases_ResponseSyntax) **   <a name="timestream-ListDatabases-response-Databases"></a>
Una lista de nombres de bases de datos.  
Tipo: matriz de objetos [Database](API_Database.md)

 ** [NextToken](#API_ListDatabases_ResponseSyntax) **   <a name="timestream-ListDatabases-response-NextToken"></a>
El token de paginación. Este parámetro se muestra cuando la respuesta está truncada.  
Tipo: cadena

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListDatabases_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListDatabases) 

# ListTables
<a name="API_ListTables"></a>

Ofrece una lista de tablas, junto con el nombre, el estado y las propiedades de retención de cada tabla. Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html) para obtener más detalles. 

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

```
{
   "DatabaseName": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListTables_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [DatabaseName](#API_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-DatabaseName"></a>
Nombre de la base de datos de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** [MaxResults](#API_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-MaxResults"></a>
El número total de elementos que se devuelven en la salida. Si el número total de artículos disponibles es superior al valor especificado, NextToken se proporciona a en la salida. Para reanudar la paginación, proporciona el NextToken valor como argumento de una invocación posterior a la API.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 20.  
Obligatorio: no

 ** [NextToken](#API_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-NextToken"></a>
El token de paginación. Para reanudar la paginación, proporciona el NextToken valor como argumento de una invocación posterior a la API.  
Tipo: cadena  
Requerido: no

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

```
{
   "NextToken": "string",
   "Tables": [ 
      { 
         "Arn": "string",
         "CreationTime": number,
         "DatabaseName": "string",
         "LastUpdatedTime": number,
         "MagneticStoreWriteProperties": { 
            "EnableMagneticStoreWrites": boolean,
            "MagneticStoreRejectedDataLocation": { 
               "S3Configuration": { 
                  "BucketName": "string",
                  "EncryptionOption": "string",
                  "KmsKeyId": "string",
                  "ObjectKeyPrefix": "string"
               }
            }
         },
         "RetentionProperties": { 
            "MagneticStoreRetentionPeriodInDays": number,
            "MemoryStoreRetentionPeriodInHours": number
         },
         "Schema": { 
            "CompositePartitionKey": [ 
               { 
                  "EnforcementInRecord": "string",
                  "Name": "string",
                  "Type": "string"
               }
            ]
         },
         "TableName": "string",
         "TableStatus": "string"
      }
   ]
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListTables_ResponseSyntax) **   <a name="timestream-ListTables-response-NextToken"></a>
Un token destinado a especificar dónde iniciar la paginación. Es el NextToken de una respuesta previamente truncada.  
Tipo: cadena

 ** [Tables](#API_ListTables_ResponseSyntax) **   <a name="timestream-ListTables-response-Tables"></a>
Una lista de tablas.  
Tipo: matriz de objetos [Table](API_Table.md)

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListTables_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTables) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

 Enumera todas las etiquetas de un recurso de Timestream. 

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

```
{
   "ResourceARN": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListTagsForResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) **   <a name="timestream-ListTagsForResource-request-ResourceARN"></a>
 El recurso de Timestream con las etiquetas que se van a incluir en la lista. Este valor es un Nombre de recurso de Amazon (ARN).   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 1011.  
Obligatorio: sí

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

```
{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="timestream-ListTagsForResource-response-Tags"></a>
 Las etiquetas asociadas actualmente al recurso de Timestream.   
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

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

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

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListTagsForResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTagsForResource) 

# ResumeBatchLoadTask
<a name="API_ResumeBatchLoadTask"></a>

 

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

```
{
   "TaskId": "string"
}
```

## Parámetros de la solicitud
<a name="API_ResumeBatchLoadTask_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [TaskId](#API_ResumeBatchLoadTask_RequestSyntax) **   <a name="timestream-ResumeBatchLoadTask-request-TaskId"></a>
El ID de la tarea de carga por lotes a reanudar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 32 caracteres.  
Patrón: `[A-Z0-9]+`   
Obligatorio: sí

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_ResumeBatchLoadTask_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ResumeBatchLoadTask) 

# TagResource
<a name="API_TagResource"></a>

 Asocia un conjunto de etiquetas con un recurso de Timestream. Puede habilitar estas etiquetas definidas por el usuario de modo que aparezcan en la consola de facturación y administración de costos y así poder usarlas para el seguimiento de asignación de costos. 

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

```
{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_TagResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ResourceARN](#API_TagResource_RequestSyntax) **   <a name="timestream-TagResource-request-ResourceARN"></a>
 Identifica el recurso de Timestream al que se deben agregar las etiquetas. Este valor es un Nombre de recurso de Amazon (ARN).   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 1011.  
Obligatorio: sí

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="timestream-TagResource-request-Tags"></a>
 Las etiquetas que se van a asignar al recurso de Timestream .   
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: sí

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

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

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ServiceQuotaExceededException **   
 Se superó la cuota de recursos de la instancia para esta cuenta.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_TagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

 Elimina la asociación de etiquetas de un recurso de Timestream. 

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

```
{
   "ResourceARN": "string",
   "TagKeys": [ "string" ]
}
```

## Parámetros de la solicitud
<a name="API_UntagResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ResourceARN](#API_UntagResource_RequestSyntax) **   <a name="timestream-UntagResource-request-ResourceARN"></a>
 El recurso de Timestream del que se eliminarán las etiquetas. Este valor es un Nombre de recurso de Amazon (ARN).   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 1011.  
Obligatorio: sí

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="timestream-UntagResource-request-TagKeys"></a>
 Una lista de claves de etiquetas. Las etiquetas existentes del recurso con claves que son miembros de esta lista se eliminarán del recurso de Timestream.   
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128 caracteres.  
Obligatorio: sí

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

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

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ServiceQuotaExceededException **   
 Se superó la cuota de recursos de la instancia para esta cuenta.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UntagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UntagResource) 

# UpdateDatabase
<a name="API_UpdateDatabase"></a>

 Modifica la AWS KMS clave de una base de datos existente. Al actualizar la base de datos, debe especificar el nombre de la base de datos y el identificador de la nueva AWS KMS clave que se va a utilizar (`KmsKeyId`). Si hay solicitudes `UpdateDatabase` simultáneas, gana el primer escritor. 

Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html) para obtener más detalles.

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

```
{
   "DatabaseName": "string",
   "KmsKeyId": "string"
}
```

## Parámetros de la solicitud
<a name="API_UpdateDatabase_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [DatabaseName](#API_UpdateDatabase_RequestSyntax) **   <a name="timestream-UpdateDatabase-request-DatabaseName"></a>
 El nombre de la base de datos.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) **   <a name="timestream-UpdateDatabase-request-KmsKeyId"></a>
 El identificador de la nueva AWS KMS clave (`KmsKeyId`) que se utilizará para cifrar los datos almacenados en la base de datos. Si el registro `KmsKeyId` actual en la base de datos es el mismo que el `KmsKeyId` de la solicitud, no habrá ninguna actualización.   
Puede especificar la `KmsKeyId` mediante alguno de los métodos siguientes:  
+ ID de clave: `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ ARN de clave: `arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Nombre de alias: `alias/ExampleAlias` 
+ ARN de alias: `arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias` 
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

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

```
{
   "Database": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "KmsKeyId": "string",
      "LastUpdatedTime": number,
      "TableCount": number
   }
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Database](#API_UpdateDatabase_ResponseSyntax) **   <a name="timestream-UpdateDatabase-response-Database"></a>
Un contenedor de nivel superior para una tabla. Las bases de datos y las tablas son los conceptos de administración fundamentales de Amazon Timestream. Todas las tablas de una base de datos se cifran con la misma AWS KMS clave.  
Tipo: objeto [Database](API_Database.md)

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ServiceQuotaExceededException **   
 Se superó la cuota de recursos de la instancia para esta cuenta.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateDatabase_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateDatabase) 

# UpdateTable
<a name="API_UpdateTable"></a>

Modifica la duración de la retención del almacén de memoria y el almacén magnético para la tabla de Timestream. Tenga en cuenta que el cambio en la duración de la retención entra en vigor de inmediato. Por ejemplo, si el periodo de retención del almacén de memoria se estableció inicialmente en 2 horas y, luego, se cambió a 24 horas, el almacén de memoria podrá almacenar 24 horas de datos, pero se completará con 24 horas de datos, 22 horas después de realizar este cambio. Timestream no recupera datos del almacén magnético para completarlos en el almacén de memoria. 

Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html) para obtener más detalles.

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

```
{
   "DatabaseName": "string",
   "MagneticStoreWriteProperties": { 
      "EnableMagneticStoreWrites": boolean,
      "MagneticStoreRejectedDataLocation": { 
         "S3Configuration": { 
            "BucketName": "string",
            "EncryptionOption": "string",
            "KmsKeyId": "string",
            "ObjectKeyPrefix": "string"
         }
      }
   },
   "RetentionProperties": { 
      "MagneticStoreRetentionPeriodInDays": number,
      "MemoryStoreRetentionPeriodInHours": number
   },
   "Schema": { 
      "CompositePartitionKey": [ 
         { 
            "EnforcementInRecord": "string",
            "Name": "string",
            "Type": "string"
         }
      ]
   },
   "TableName": "string"
}
```

## Parámetros de la solicitud
<a name="API_UpdateTable_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [DatabaseName](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-DatabaseName"></a>
Nombre de la base de datos de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** [MagneticStoreWriteProperties](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-MagneticStoreWriteProperties"></a>
Contiene las propiedades que se tienen que establecer en la tabla cuando se habilitan las escrituras en el almacén magnético.  
Tipo: objeto [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)  
Obligatorio: no

 ** [RetentionProperties](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-RetentionProperties"></a>
La duración de la retención del almacén de memoria y el almacén magnético.  
Tipo: objeto [RetentionProperties](API_RetentionProperties.md)  
Obligatorio: no

 ** [Schema](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-Schema"></a>
 El esquema de la tabla.   
Tipo: objeto [Schema](API_Schema.md)  
Obligatorio: no

 ** [TableName](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-TableName"></a>
Nombre de la tabla de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

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

```
{
   "Table": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "LastUpdatedTime": number,
      "MagneticStoreWriteProperties": { 
         "EnableMagneticStoreWrites": boolean,
         "MagneticStoreRejectedDataLocation": { 
            "S3Configuration": { 
               "BucketName": "string",
               "EncryptionOption": "string",
               "KmsKeyId": "string",
               "ObjectKeyPrefix": "string"
            }
         }
      },
      "RetentionProperties": { 
         "MagneticStoreRetentionPeriodInDays": number,
         "MemoryStoreRetentionPeriodInHours": number
      },
      "Schema": { 
         "CompositePartitionKey": [ 
            { 
               "EnforcementInRecord": "string",
               "Name": "string",
               "Type": "string"
            }
         ]
      },
      "TableName": "string",
      "TableStatus": "string"
   }
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Table](#API_UpdateTable_ResponseSyntax) **   <a name="timestream-UpdateTable-response-Table"></a>
La tabla actualizada de Timestream.  
Tipo: objeto [Table](API_Table.md)

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateTable_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateTable) 

# WriteRecords
<a name="API_WriteRecords"></a>

Le permite escribir datos de serie temporal en Timestream. Puede especificar un solo punto de datos o un lote de puntos de datos para insertarlos en el sistema. Timestream le ofrece un esquema flexible que detecta de manera automática los nombres de las columnas y los tipos de datos de las tablas de Timestream según los nombres de las dimensiones y los tipos de datos de los puntos de datos que especifique al invocar las escrituras en la base de datos. 

Timestream admite una semántica de lectura coherente posterior. Esto significa que, al consultar datos inmediatamente después de escribir un lote de datos en Timestream, es posible que los resultados de la consulta no reflejen los resultados de una operación de escritura que se haya completado recientemente. Además, los resultados pueden incluir algunos datos obsoletos. Si repite la solicitud de consulta después de un breve intervalo, la respuesta debería mostrar los datos más recientes. [Se aplican cuotas de servicio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). 

Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html) para obtener más detalles.

 **Upserts** 

Puede usar el parámetro `Version` en una solicitud de `WriteRecords` para actualizar los puntos de datos. Timestream rastrea un número de versión con cada registro. `Version` toma el valor predeterminado `1` cuando no se especifica para el registro en la solicitud. Timestream actualiza el valor de medida de un registro existente junto con la `Version` cuando recibe una solicitud de escritura con un número de `Version` superior para ese registro. Cuando recibe una solicitud de actualización en la que el valor de medida es el mismo que el del registro existente, Timestream sigue actualizando la `Version` si es mayor que el valor existente de `Version`. Puede actualizar un punto de datos tantas veces como desee, siempre que el valor de `Version` aumente continuamente. 

 Por ejemplo, supongamos que escribe un registro nuevo sin indicar la `Version` en la solicitud. Timestream almacena este registro y establece la `Version` en `1`. Supongamos que intenta actualizar este registro con una solicitud de `WriteRecords` del mismo registro con un valor de medida diferente, pero, como antes, no lo proporciona la `Version`. En este caso, Timestream rechazará esta actualización con una `RejectedRecordsException`, ya que la versión del registro actualizado no es superior al valor actual de la versión. 

Sin embargo, si volviera a enviar la solicitud de actualización con la `Version` en `2`, Timestream lograría actualizar el valor del registro y `Version` se establecería en `2`. A continuación, supongamos que envió una solicitud de `WriteRecords` con el mismo registro y un valor de medida idéntico, pero con `Version` en `3`. En este caso, Timestream solo actualizará `Version` a `3`. Cualquier otra actualización tendría que enviar un número de versión superior a `3`, o las solicitudes de actualización recibirían un `RejectedRecordsException`. 

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

```
{
   "CommonAttributes": { 
      "Dimensions": [ 
         { 
            "DimensionValueType": "string",
            "Name": "string",
            "Value": "string"
         }
      ],
      "MeasureName": "string",
      "MeasureValue": "string",
      "MeasureValues": [ 
         { 
            "Name": "string",
            "Type": "string",
            "Value": "string"
         }
      ],
      "MeasureValueType": "string",
      "Time": "string",
      "TimeUnit": "string",
      "Version": number
   },
   "DatabaseName": "string",
   "Records": [ 
      { 
         "Dimensions": [ 
            { 
               "DimensionValueType": "string",
               "Name": "string",
               "Value": "string"
            }
         ],
         "MeasureName": "string",
         "MeasureValue": "string",
         "MeasureValues": [ 
            { 
               "Name": "string",
               "Type": "string",
               "Value": "string"
            }
         ],
         "MeasureValueType": "string",
         "Time": "string",
         "TimeUnit": "string",
         "Version": number
      }
   ],
   "TableName": "string"
}
```

## Parámetros de la solicitud
<a name="API_WriteRecords_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [CommonAttributes](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-CommonAttributes"></a>
Un registro que contiene los atributos comunes de medida, dimensión, tiempo y versión compartidos en todos los registros de la solicitud. Los atributos de medida y dimensión especificados se combinarán con los atributos de medida y dimensión del objeto de registro cuando los datos se escriban en Timestream. Es posible que las dimensiones no se superpongan o aparecerá una `ValidationException`. Es decir, un registro debe contener dimensiones con nombres únicos.   
Tipo: objeto [Record](API_Record.md)  
Obligatorio: no

 ** [DatabaseName](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-DatabaseName"></a>
Nombre de la base de datos de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** [Records](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-Records"></a>
Una matriz de registros que contiene los atributos únicos de medida, dimensión, tiempo y versión de cada punto de datos de serie temporal.  
Tipo: Matriz de [Record](API_Record.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 100 artículos.  
Obligatorio: sí

 ** [TableName](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-TableName"></a>
Nombre de la tabla de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

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

```
{
   "RecordsIngested": { 
      "MagneticStore": number,
      "MemoryStore": number,
      "Total": number
   }
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [RecordsIngested](#API_WriteRecords_ResponseSyntax) **   <a name="timestream-WriteRecords-response-RecordsIngested"></a>
Información sobre los registros ingeridos por esta solicitud.  
Tipo: objeto [RecordsIngested](API_RecordsIngested.md)

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

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

 ** AccessDeniedException **   
No tiene autorización para realizar esta acción.  
Código de estado HTTP: 400

 ** InternalServerException **   
 Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.  
Código de estado HTTP: 500

 ** InvalidEndpointException **   
El punto de conexión solicitado no era válido.  
Código de estado HTTP: 400

 ** RejectedRecordsException **   
 WriteRecords generaría esta excepción en los siguientes casos:   
+ Los registros con datos duplicados en los que existen varios registros con las mismas dimensiones, marcas de tiempo y nombres de medidas, pero: 
  + Los valores de las medidas son diferentes.
  + La versión no está presente en la solicitud *o* el valor de la versión en el registro nuevo es igual o inferior al valor existente.

   En este caso, si Timestream rechaza los datos, el campo `ExistingVersion` de la respuesta `RejectedRecords` indicará la versión actual del registro. Para forzar una actualización, puede volver a enviar la solicitud con una versión del registro establecida en un valor superior a la `ExistingVersion`.
+  Los registros con marcas de tiempo que se encuentran fuera del periodo de retención del almacén de memoria. 
+  Los registros con dimensiones o medidas que superan los límites definidos por Timestream. 
 Para obtener más información, consulte [Cuotas](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) en la Guía para desarrolladores de Amazon Timestream.     
 ** RejectedRecords **   
 
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.  
Código de estado HTTP: 400

 ** ThrottlingException **   
 Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_WriteRecords_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/WriteRecords) 

# Consulta de Amazon Timestream
<a name="API_Operations_Amazon_Timestream_Query"></a>

La consulta de Amazon Timestream admite las siguientes acciones:
+  [CancelQuery](API_query_CancelQuery.md) 
+  [CreateScheduledQuery](API_query_CreateScheduledQuery.md) 
+  [DeleteScheduledQuery](API_query_DeleteScheduledQuery.md) 
+  [DescribeAccountSettings](API_query_DescribeAccountSettings.md) 
+  [DescribeEndpoints](API_query_DescribeEndpoints.md) 
+  [DescribeScheduledQuery](API_query_DescribeScheduledQuery.md) 
+  [ExecuteScheduledQuery](API_query_ExecuteScheduledQuery.md) 
+  [ListScheduledQueries](API_query_ListScheduledQueries.md) 
+  [ListTagsForResource](API_query_ListTagsForResource.md) 
+  [PrepareQuery](API_query_PrepareQuery.md) 
+  [Query](API_query_Query.md) 
+  [TagResource](API_query_TagResource.md) 
+  [UntagResource](API_query_UntagResource.md) 
+  [UpdateAccountSettings](API_query_UpdateAccountSettings.md) 
+  [UpdateScheduledQuery](API_query_UpdateScheduledQuery.md) 

# CancelQuery
<a name="API_query_CancelQuery"></a>

 Cancela una consulta que se emitió. La cancelación solo se ofrece si la consulta no se completó antes de que se emitiera la solicitud de cancelación. Como la cancelación es una operación idempotente, las solicitudes de cancelación posteriores mostrarán un `CancellationMessage`, lo que indica que la consulta ya se canceló. Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.cancel-query.html) para obtener más detalles. 

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

```
{
   "QueryId": "string"
}
```

## Parámetros de la solicitud
<a name="API_query_CancelQuery_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [QueryId](#API_query_CancelQuery_RequestSyntax) **   <a name="timestream-query_CancelQuery-request-QueryId"></a>
 El identificador de la consulta que debe cancelarse. Se muestra `QueryID` como parte del resultado de la consulta.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[a-zA-Z0-9]+`   
Obligatorio: sí

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

```
{
   "CancellationMessage": "string"
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CancellationMessage](#API_query_CancelQuery_ResponseSyntax) **   <a name="timestream-query_CancelQuery-response-CancellationMessage"></a>
 Se muestra un `CancellationMessage` cuando ya se emitió una solicitud `CancelQuery` para la consulta especificada por `QueryId`.   
Tipo: cadena

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

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

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_CancelQuery_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CancelQuery) 

# CreateScheduledQuery
<a name="API_query_CreateScheduledQuery"></a>

 Crear una consulta programada que se ejecutará en su nombre según la programación configurada. Timestream asume la función de ejecución proporcionada como parte del parámetro `ScheduledQueryExecutionRoleArn` para ejecutar la consulta. Puede usar el parámetro `NotificationConfiguration` para configurar la notificación de las operaciones de consulta programadas.

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

```
{
   "ClientToken": "string",
   "ErrorReportConfiguration": { 
      "S3Configuration": { 
         "BucketName": "string",
         "EncryptionOption": "string",
         "ObjectKeyPrefix": "string"
      }
   },
   "KmsKeyId": "string",
   "Name": "string",
   "NotificationConfiguration": { 
      "SnsConfiguration": { 
         "TopicArn": "string"
      }
   },
   "QueryString": "string",
   "ScheduleConfiguration": { 
      "ScheduleExpression": "string"
   },
   "ScheduledQueryExecutionRoleArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TargetConfiguration": { 
      "TimestreamConfiguration": { 
         "DatabaseName": "string",
         "DimensionMappings": [ 
            { 
               "DimensionValueType": "string",
               "Name": "string"
            }
         ],
         "MeasureNameColumn": "string",
         "MixedMeasureMappings": [ 
            { 
               "MeasureName": "string",
               "MeasureValueType": "string",
               "MultiMeasureAttributeMappings": [ 
                  { 
                     "MeasureValueType": "string",
                     "SourceColumn": "string",
                     "TargetMultiMeasureAttributeName": "string"
                  }
               ],
               "SourceColumn": "string",
               "TargetMeasureName": "string"
            }
         ],
         "MultiMeasureMappings": { 
            "MultiMeasureAttributeMappings": [ 
               { 
                  "MeasureValueType": "string",
                  "SourceColumn": "string",
                  "TargetMultiMeasureAttributeName": "string"
               }
            ],
            "TargetMultiMeasureName": "string"
         },
         "TableName": "string",
         "TimeColumn": "string"
      }
   }
}
```

## Parámetros de la solicitud
<a name="API_query_CreateScheduledQuery_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ClientToken"></a>
El uso de a ClientToken hace que la llamada sea CreateScheduledQuery idempotente, en otras palabras, hacer la misma solicitud repetidamente producirá el mismo resultado. Hacer varias CreateScheduledQuery solicitudes idénticas tiene el mismo efecto que hacer una sola solicitud.   
+  Si CreateScheduledQuery se llama sin una`ClientToken`, el SDK de consultas genera una `ClientToken` en tu nombre.
+  Después de 8 horas, cualquier solicitud con el mismo `ClientToken` es tratada como una nueva solicitud. 
Tipo: cadena  
Restricciones de longitud: longitud mínima de 32. Longitud máxima de 128.  
Obligatorio: no

 ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ErrorReportConfiguration"></a>
Configuración para el informe de errores. Se generarán informes de errores cuando se encuentre un problema al escribir los resultados de la consulta.   
Tipo: objeto [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Obligatorio: sí

 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-KmsKeyId"></a>
La clave de Amazon KMS usada para cifrar el recurso de consulta programada, en reposo. Si no se especifica la clave de Amazon KMS, el recurso de consulta programada se cifrará con una clave de Amazon KMS propiedad de Timestream. Para especificar una clave KMS, utilice el ID de la clave, ARN de la clave, el nombre de alias o el ARN del alias. Cuando utilice un nombre del alias, anteponga el nombre con *alias/*   
Si `SSE_KMS` se ErrorReportConfiguration utiliza como tipo de cifrado, KmsKeyId se utiliza lo mismo para cifrar el informe de errores en reposo.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Name"></a>
Nombre de la consulta programada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obligatorio: sí

 ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-NotificationConfiguration"></a>
Configuración de notificaciones para la consulta programada. Timestream envía una notificación cuando finaliza la ejecución de una consulta, cuando se actualiza el estado o cuando se elimina.   
Tipo: objeto [NotificationConfiguration](API_query_NotificationConfiguration.md)  
Obligatorio: sí

 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-QueryString"></a>
La cadena de consulta que se ejecutará. Los nombres de los parámetros se pueden especificar en la cadena de consulta `@` seguida de un identificador. El parámetro denominado `@scheduled_runtime` está reservado y se puede usar en la consulta para obtener la hora a la que está programada la ejecución de la consulta.  
La marca de tiempo calculada en función del ScheduleConfiguration parámetro será el valor del `@scheduled_runtime` parámetro para cada consulta que se ejecute. Por ejemplo, considere una instancia de una consulta programada que se ejecuta el 01-12-2021 00:00:00. Para esta instancia, el parámetro `@scheduled_runtime` se inicializa en la marca de tiempo 01-12-2021 00:00:00 al invocar la consulta.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 262144 caracteres.  
Obligatorio: sí

 ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduleConfiguration"></a>
La configuración programada para la consulta.  
Tipo: objeto [ScheduleConfiguration](API_query_ScheduleConfiguration.md)  
Obligatorio: sí

 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduledQueryExecutionRoleArn"></a>
El ARN para el rol de IAM que Timestream asumirá al ejecutar la consulta programada.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

 ** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Tags"></a>
Lista de pares clave-valor para etiquetar la consulta programada.  
Tipo: matriz de objetos [Tag](API_query_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-TargetConfiguration"></a>
Configuración que se utiliza para escribir el resultado de una consulta.  
Tipo: objeto [TargetConfiguration](API_query_TargetConfiguration.md)  
Obligatorio: no

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

```
{
   "Arn": "string"
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) **   <a name="timestream-query_CreateScheduledQuery-response-Arn"></a>
ARN para la consulta programada que se creó.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.

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

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

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** ConflictException **   
 No se pudo sondear los resultados de una consulta cancelada.   
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ServiceQuotaExceededException **   
Superó la cuota de servicio.  
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_CreateScheduledQuery_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery) 

# DeleteScheduledQuery
<a name="API_query_DeleteScheduledQuery"></a>

Elimina una consulta programada determinada. Se trata de una operación irreversible. 

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

```
{
   "ScheduledQueryArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_query_DeleteScheduledQuery_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) **   <a name="timestream-query_DeleteScheduledQuery-request-ScheduledQueryArn"></a>
El ARN de la consulta programada.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

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

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso solicitado.    
 ** ScheduledQueryArn **   
El ARN de la consulta programada.
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_DeleteScheduledQuery_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DeleteScheduledQuery) 

# DescribeAccountSettings
<a name="API_query_DescribeAccountSettings"></a>

Describe la configuración de su cuenta, que incluye el modelo de precios de las consultas y el máximo configurado que TCUs el servicio puede utilizar para la carga de trabajo de las consultas.

Solo se le cobrará por la duración de las unidades de cómputo que se utilizan para las cargas de trabajo.

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

```
{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "ActiveQueryTCU": number,
         "LastUpdate": { 
            "Status": "string",
            "StatusMessage": "string",
            "TargetQueryTCU": number
         },
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         }
      }
   },
   "QueryPricingModel": "string"
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [MaxQueryTCU](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-MaxQueryTCU"></a>
El número máximo de [unidades de cálculo de Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/tcu.html) (TCUs) que el servicio utilizará en cualquier momento para atender sus consultas. Para ejecutar consultas, debe establecer una capacidad mínima de 4 TCU. Puede establecer la cantidad máxima de TCU en múltiplos de 4, como 4, 8, 16, 32, etc. Esta configuración solo se aplica al uso bajo demanda de ()TCUs.   
Tipo: entero

 ** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryCompute"></a>
Un objeto que contiene la configuración de uso de las unidades de cómputo de flujo temporal (TCUs) en su cuenta para la carga de trabajo de consulta. QueryCompute solo está disponible en la región de Asia Pacífico (Bombay).  
Tipo: objeto [QueryComputeResponse](API_query_QueryComputeResponse.md)

 ** [QueryPricingModel](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryPricingModel"></a>
El modelo de precios para las consultas de la cuenta.  
Varias operaciones de Timestream utilizan el parámetro `QueryPricingModel`; sin embargo, la operación de la API `UpdateAccountSettings` no reconoce ningún otro valor que no sea `COMPUTE_UNITS`.
Tipo: cadena  
Valores válidos: `BYTES_SCANNED | COMPUTE_UNITS` 

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

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

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

## Véase también
<a name="API_query_DescribeAccountSettings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeAccountSettings) 

# DescribeEndpoints
<a name="API_query_DescribeEndpoints"></a>

DescribeEndpoints devuelve una lista de puntos finales disponibles para realizar llamadas a la API de Timestream. Esta API está disponible a través de la escritura y la consulta.

Dado que los Timestream SDKs están diseñados para funcionar de forma transparente con la arquitectura del servicio, incluida la administración y el mapeo de los puntos finales del servicio, *no se recomienda* utilizar esta API a menos que:
+ Utiliza [puntos de conexión de VPC (AWS PrivateLink) con Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints). 
+ Su aplicación utiliza un lenguaje de programación que aún no es compatible con SDK.
+ Necesita un mejor control sobre la implementación por parte del cliente.

Para obtener información detallada sobre cómo y cuándo usar e implementar DescribeEndpoints, consulte [The](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery) Endpoint Discovery Pattern.

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

```
{
   "Endpoints": [ 
      { 
         "Address": "string",
         "CachePeriodInMinutes": number
      }
   ]
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Endpoints](#API_query_DescribeEndpoints_ResponseSyntax) **   <a name="timestream-query_DescribeEndpoints-response-Endpoints"></a>
Se muestra un objeto de `Endpoints` cuando se realiza una solicitud de `DescribeEndpoints`.  
Tipo: matriz de objetos [Endpoint](API_query_Endpoint.md)

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

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

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_DescribeEndpoints_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeEndpoints) 

# DescribeScheduledQuery
<a name="API_query_DescribeScheduledQuery"></a>

Ofrece información detallada sobre una consulta programada.

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

```
{
   "ScheduledQueryArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_query_DescribeScheduledQuery_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) **   <a name="timestream-query_DescribeScheduledQuery-request-ScheduledQueryArn"></a>
El ARN de la consulta programada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

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

```
{
   "ScheduledQuery": { 
      "Arn": "string",
      "CreationTime": number,
      "ErrorReportConfiguration": { 
         "S3Configuration": { 
            "BucketName": "string",
            "EncryptionOption": "string",
            "ObjectKeyPrefix": "string"
         }
      },
      "KmsKeyId": "string",
      "LastRunSummary": { 
         "ErrorReportLocation": { 
            "S3ReportLocation": { 
               "BucketName": "string",
               "ObjectKey": "string"
            }
         },
         "ExecutionStats": { 
            "BytesMetered": number,
            "CumulativeBytesScanned": number,
            "DataWrites": number,
            "ExecutionTimeInMillis": number,
            "QueryResultRows": number,
            "RecordsIngested": number
         },
         "FailureReason": "string",
         "InvocationTime": number,
         "QueryInsightsResponse": { 
            "OutputBytes": number,
            "OutputRows": number,
            "QuerySpatialCoverage": { 
               "Max": { 
                  "PartitionKey": [ "string" ],
                  "TableArn": "string",
                  "Value": number
               }
            },
            "QueryTableCount": number,
            "QueryTemporalRange": { 
               "Max": { 
                  "TableArn": "string",
                  "Value": number
               }
            }
         },
         "RunStatus": "string",
         "TriggerTime": number
      },
      "Name": "string",
      "NextInvocationTime": number,
      "NotificationConfiguration": { 
         "SnsConfiguration": { 
            "TopicArn": "string"
         }
      },
      "PreviousInvocationTime": number,
      "QueryString": "string",
      "RecentlyFailedRuns": [ 
         { 
            "ErrorReportLocation": { 
               "S3ReportLocation": { 
                  "BucketName": "string",
                  "ObjectKey": "string"
               }
            },
            "ExecutionStats": { 
               "BytesMetered": number,
               "CumulativeBytesScanned": number,
               "DataWrites": number,
               "ExecutionTimeInMillis": number,
               "QueryResultRows": number,
               "RecordsIngested": number
            },
            "FailureReason": "string",
            "InvocationTime": number,
            "QueryInsightsResponse": { 
               "OutputBytes": number,
               "OutputRows": number,
               "QuerySpatialCoverage": { 
                  "Max": { 
                     "PartitionKey": [ "string" ],
                     "TableArn": "string",
                     "Value": number
                  }
               },
               "QueryTableCount": number,
               "QueryTemporalRange": { 
                  "Max": { 
                     "TableArn": "string",
                     "Value": number
                  }
               }
            },
            "RunStatus": "string",
            "TriggerTime": number
         }
      ],
      "ScheduleConfiguration": { 
         "ScheduleExpression": "string"
      },
      "ScheduledQueryExecutionRoleArn": "string",
      "State": "string",
      "TargetConfiguration": { 
         "TimestreamConfiguration": { 
            "DatabaseName": "string",
            "DimensionMappings": [ 
               { 
                  "DimensionValueType": "string",
                  "Name": "string"
               }
            ],
            "MeasureNameColumn": "string",
            "MixedMeasureMappings": [ 
               { 
                  "MeasureName": "string",
                  "MeasureValueType": "string",
                  "MultiMeasureAttributeMappings": [ 
                     { 
                        "MeasureValueType": "string",
                        "SourceColumn": "string",
                        "TargetMultiMeasureAttributeName": "string"
                     }
                  ],
                  "SourceColumn": "string",
                  "TargetMeasureName": "string"
               }
            ],
            "MultiMeasureMappings": { 
               "MultiMeasureAttributeMappings": [ 
                  { 
                     "MeasureValueType": "string",
                     "SourceColumn": "string",
                     "TargetMultiMeasureAttributeName": "string"
                  }
               ],
               "TargetMultiMeasureName": "string"
            },
            "TableName": "string",
            "TimeColumn": "string"
         }
      }
   }
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ScheduledQuery](#API_query_DescribeScheduledQuery_ResponseSyntax) **   <a name="timestream-query_DescribeScheduledQuery-response-ScheduledQuery"></a>
La consulta programada.  
Tipo: objeto [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md)

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

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

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso solicitado.    
 ** ScheduledQueryArn **   
El ARN de la consulta programada.
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_DescribeScheduledQuery_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeScheduledQuery) 

# ExecuteScheduledQuery
<a name="API_query_ExecuteScheduledQuery"></a>

 Puede utilizar esta API para ejecutar una consulta programada de manera manual. 

Si la habilitó `QueryInsights`, esta API también muestra información y métricas relacionadas con la consulta que ejecutó como parte de una notificación de Amazon SNS. `QueryInsights` ayuda a ajustar el rendimiento de la consulta. Para obtener más información sobre `QueryInsights`, consulte [Uso de la información sobre las consultas para su optimización en Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).

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

```
{
   "ClientToken": "string",
   "InvocationTime": number,
   "QueryInsights": { 
      "Mode": "string"
   },
   "ScheduledQueryArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_query_ExecuteScheduledQuery_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ClientToken"></a>
No se utiliza.   
Tipo: cadena  
Restricciones de longitud: longitud mínima de 32. Longitud máxima de 128.  
Obligatorio: no

 ** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-InvocationTime"></a>
La marca de tiempo en UTC. La consulta se ejecutará como si se hubiera invocado en esta marca de tiempo.   
Tipo: marca temporal  
Obligatorio: sí

 ** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-QueryInsights"></a>
Encapsula la configuración para habilitar una `QueryInsights`.  
La habilitación de la `QueryInsights` muestra la información y métricas como parte de la notificación de Amazon SNS para la consulta que ejecutó. Puede utilizar las `QueryInsights` para ajustar el rendimiento y el costo de sus consultas.  
Tipo: objeto [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md)  
Obligatorio: no

 ** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ScheduledQueryArn"></a>
ARN de la consulta programada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

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

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso solicitado.    
 ** ScheduledQueryArn **   
El ARN de la consulta programada.
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

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

### Mensaje de notificación de consulta programada para el modo ENABLED\$1WITH\$1RATE\$1CONTROL
<a name="API_query_ExecuteScheduledQuery_Example_1"></a>

En el siguiente ejemplo, se muestra un mensaje de notificación de consulta programada de manera correcta para el modo `ENABLED_WITH_RATE_CONTROL` del parámetro `QueryInsights`.

```
"SuccessNotificationMessage": {
    "type": "MANUAL_TRIGGER_SUCCESS",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-49c6ed55-c2e7-4cc2-9956-4a0ecea13420-80e05b035236a4c3",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1723710546,
        "triggerTimeMillis": 1723710547490,
        "runStatus": "MANUAL_TRIGGER_SUCCESS",
        "executionStats": {
            "executionTimeInMillis": 17343,
            "dataWrites": 1024,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 600,
            "recordsIngested": 1,
            "queryResultRows": 1
        },
        "queryInsightsResponse": {
            "querySpatialCoverage": {
                "max": {
                    "value": 1.0,
                    "tableArn": "arn:aws:timestream:<Region>:<Account>:database/BaseDb/table/BaseTable",
                    "partitionKey": [
                        "measure_name"
                    ]
                }
            },
            "queryTemporalRange": {
                "max": {
                    "value": 2399999999999,
                    "tableArn": "arn:aws:timestream:<Region>:<Account>:database/BaseDb/table/BaseTable"
                }
            },
            "queryTableCount": 1,
            "outputRows": 1,
            "outputBytes": 59
        }
    }
}
```

### Mensaje de notificación de consulta programada para el modo DISABLED
<a name="API_query_ExecuteScheduledQuery_Example_2"></a>

En el siguiente ejemplo, se muestra un mensaje de notificación de consulta programada de manera correcta para el modo `DISABLED` del parámetro `QueryInsights`.

```
"SuccessNotificationMessage": {
    "type": "MANUAL_TRIGGER_SUCCESS",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-fa109d9e-6528-4a0d-ac40-482fa05e657f-140faaeecdc5b2a7",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1723711401,
        "triggerTimeMillis": 1723711402144,
        "runStatus": "MANUAL_TRIGGER_SUCCESS",
        "executionStats": {
            "executionTimeInMillis": 17992,
            "dataWrites": 1024,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 600,
            "recordsIngested": 1,
            "queryResultRows": 1
        }
    }
}
```

### Mensaje de notificación de falla para el modo ENABLED\$1WITH\$1RATE\$1CONTROL
<a name="API_query_ExecuteScheduledQuery_Example_3"></a>

En el siguiente ejemplo, se muestra un mensaje de notificación de consulta programada fallido para el modo `ENABLED_WITH_RATE_CONTROL` del parámetro `QueryInsights`.

```
"FailureNotificationMessage": {
    "type": "MANUAL_TRIGGER_FAILURE",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1727915513,
        "triggerTimeMillis": 1727915513894,
        "runStatus": "MANUAL_TRIGGER_FAILURE",
        "executionStats": {
            "executionTimeInMillis": 10777,
            "dataWrites": 0,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 0,
            "recordsIngested": 0,
            "queryResultRows": 4
        },
        "errorReportLocation": {
            "s3ReportLocation": {
                "bucketName": "amzn-s3-demo-bucket",
                "objectKey": "4my-organization-f7a3c5d065a1a95e/1727915513/MANUAL/1727915513894/5e14b3df-b147-49f4-9331-784f749b68ae"
            }
        },
        "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details"
    }
}
```

### Mensaje de notificación de falla para el modo DISABLED
<a name="API_query_ExecuteScheduledQuery_Example_4"></a>

En el siguiente ejemplo, se muestra un mensaje de notificación de consulta programada fallido para el modo `DISABLED` del parámetro `QueryInsights`.

```
"FailureNotificationMessage": {
    "type": "MANUAL_TRIGGER_FAILURE",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1727915194,
        "triggerTimeMillis": 1727915195119,
        "runStatus": "MANUAL_TRIGGER_FAILURE",
        "executionStats": {
            "executionTimeInMillis": 10777,
            "dataWrites": 0,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 0,
            "recordsIngested": 0,
            "queryResultRows": 4
        },
        "errorReportLocation": {
            "s3ReportLocation": {
                "bucketName": "amzn-s3-demo-bucket",
                "objectKey": "4my-organization-b7e27a1d79be226d/1727915194/MANUAL/1727915195119/08dea9f5-9a0a-4e63-a5f7-ded23247bb98"
            }
        },
        "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details"
    }
}
```

## Véase también
<a name="API_query_ExecuteScheduledQuery_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecuteScheduledQuery) 

# ListScheduledQueries
<a name="API_query_ListScheduledQueries"></a>

Obtiene una lista de todas las consultas programadas en la cuenta Amazon y región de la persona que llama. `ListScheduledQueries` acaba siendo coherente. 

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

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_query_ListScheduledQueries_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-MaxResults"></a>
La cantidad máxima de elementos que se devuelven en el resultado. Si la cantidad total de elementos disponibles es mayor que el valor especificado, se ofrece un `NextToken` en el resultado. Para reanudar la paginación, brinde el valor de `NextToken` como el argumento de la llamada posterior a `ListScheduledQueriesRequest`.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 1000.  
Obligatorio: no

 ** [NextToken](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-NextToken"></a>
 Un token de paginación para reanudar la paginación.  
Tipo: cadena  
Requerido: no

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

```
{
   "NextToken": "string",
   "ScheduledQueries": [ 
      { 
         "Arn": "string",
         "CreationTime": number,
         "ErrorReportConfiguration": { 
            "S3Configuration": { 
               "BucketName": "string",
               "EncryptionOption": "string",
               "ObjectKeyPrefix": "string"
            }
         },
         "LastRunStatus": "string",
         "Name": "string",
         "NextInvocationTime": number,
         "PreviousInvocationTime": number,
         "State": "string",
         "TargetDestination": { 
            "TimestreamDestination": { 
               "DatabaseName": "string",
               "TableName": "string"
            }
         }
      }
   ]
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_query_ListScheduledQueries_ResponseSyntax) **   <a name="timestream-query_ListScheduledQueries-response-NextToken"></a>
Un token destinado a especificar dónde iniciar la paginación. Esto NextToken proviene de una respuesta previamente truncada.  
Tipo: cadena

 ** [ScheduledQueries](#API_query_ListScheduledQueries_ResponseSyntax) **   <a name="timestream-query_ListScheduledQueries-response-ScheduledQueries"></a>
Una lista de consultas programadas.  
Tipo: matriz de objetos [ScheduledQuery](API_query_ScheduledQuery.md)

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

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

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_ListScheduledQueries_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListScheduledQueries) 

# ListTagsForResource
<a name="API_query_ListTagsForResource"></a>

Enumera todas las etiquetas de una consulta de recurso de Timestream.

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

```
{
   "MaxResults": number,
   "NextToken": "string",
   "ResourceARN": "string"
}
```

## Parámetros de la solicitud
<a name="API_query_ListTagsForResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-MaxResults"></a>
Cantidad máxima de etiquetas que se mostrarán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 200.  
Obligatorio: no

 ** [NextToken](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-NextToken"></a>
Un token de paginación para reanudar la paginación.  
Tipo: cadena  
Requerido: no

 ** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-ResourceARN"></a>
El recurso de Timestream con las etiquetas que se van a incluir en la lista. Este valor es un Nombre de recurso de Amazon (ARN).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

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

```
{
   "NextToken": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-NextToken"></a>
Un token de paginación para reanudar la paginación con una llamada posterior a `ListTagsForResourceResponse`.  
Tipo: cadena

 ** [Tags](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-Tags"></a>
Las etiquetas asociadas actualmente al recurso de Timestream.   
Tipo: matriz de objetos [Tag](API_query_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

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

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

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso solicitado.    
 ** ScheduledQueryArn **   
El ARN de la consulta programada.
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_ListTagsForResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListTagsForResource) 

# PrepareQuery
<a name="API_query_PrepareQuery"></a>

Operación sincrónica que permite enviar una consulta con parámetros para que Timestream los almacene para su ejecución posterior. Timestream solo admite el uso de esta operación con `ValidateOnly` se establece en `true`. 

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

```
{
   "QueryString": "string",
   "ValidateOnly": boolean
}
```

## Parámetros de la solicitud
<a name="API_query_PrepareQuery_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [QueryString](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-QueryString"></a>
La cadena de consulta de Timestream que quiere utilizar como sentencia preparada. Los nombres de los parámetros se pueden especificar en la cadena de consulta `@` seguida de un identificador.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 262144 caracteres.  
Obligatorio: sí

 ** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-ValidateOnly"></a>
Al establecer este valor en `true`, Timestream solo validará que la cadena de consulta sea una consulta válida de Timestream y no almacenará la consulta preparada para su uso posterior.  
Tipo: Booleano  
Obligatorio: no

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

```
{
   "Columns": [ 
      { 
         "Aliased": boolean,
         "DatabaseName": "string",
         "Name": "string",
         "TableName": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "Parameters": [ 
      { 
         "Name": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "QueryString": "string"
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Columns](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Columns"></a>
Una lista de las columnas de la cláusula SELECT de la cadena de consulta que se envió.   
Tipo: matriz de objetos [SelectColumn](API_query_SelectColumn.md)

 ** [Parameters](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Parameters"></a>
Una lista de los parámetros utilizados en la cadena de consulta que se envió.   
Tipo: matriz de objetos [ParameterMapping](API_query_ParameterMapping.md)

 ** [QueryString](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-QueryString"></a>
La cadena de consulta que quiere preparar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 262144 caracteres.

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

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

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_PrepareQuery_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/PrepareQuery) 

# Query
<a name="API_query_Query"></a>

 `Query` es una operación sincrónica que le permite ejecutar una consulta sobre sus datos de Amazon Timestream.

Si la habilitó `QueryInsights`, esta API también muestra información y métricas relacionadas con la consulta que ejecutó. `QueryInsights` ayuda a ajustar el rendimiento de la consulta. Para obtener más información sobre `QueryInsights`, consulte [Uso de la información sobre las consultas para su optimización en Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).

**nota**  
La cantidad máxima de solicitudes a la API de `Query` que puede realizar con la opción `QueryInsights` habilitada es de 1 consulta por segundo (QPS). Si supera esta tasa de consultas, es posible que se produzca una limitación.

 `Query` se desconectará después de 60 segundos. Debe actualizar el tiempo de espera predeterminado en el SDK para que admita un tiempo de espera de 60 segundos. Consulte el [Ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html) para obtener más detalles. 

La solicitud de consulta fallará en los casos que se encuentra a continuación:
+  Si envía una solicitud de `Query` con el mismo token de cliente fuera del periodo de idempotencia de 5 minutos. 
+  Si envía una solicitud de `Query` con el mismo token de cliente, pero cambia otros parámetros, dentro del periodo de idempotencia de 5 minutos. 
+  Si el tamaño de la fila (incluidos los metadatos de la consulta) supera 1 MB, la consulta fallará y mostrará el siguiente mensaje de error: 

   `Query aborted as max page response size has been exceeded by the output result row` 
+  Si el principal de IAM del iniciador de consultas y el lector de resultados no son iguales and/or , el iniciador de consultas y el lector de resultados no tienen la misma cadena de consulta en las solicitudes de consulta, la consulta fallará y se producirá un error. `Invalid pagination token` 

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

```
{
   "ClientToken": "string",
   "MaxRows": number,
   "NextToken": "string",
   "QueryInsights": { 
      "Mode": "string"
   },
   "QueryString": "string"
}
```

## Parámetros de la solicitud
<a name="API_query_Query_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ClientToken](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-ClientToken"></a>
 Cadena única que distingue entre mayúsculas y minúsculas de hasta 64 caracteres ASCII que se especifica cuando se realiza una solicitud de `Query`. Si se brinda una `ClientToken`, la llamada a `Query` se vuelve *idempotente*. Esto significa que ejecutar la misma consulta de manera repetida producirá el mismo resultado. Es decir, hacer varias solicitudes de `Query` idénticas tiene el mismo efecto que realizar una sola solicitud. Cuando lo utilice `ClientToken` en una consulta, tenga en cuenta lo siguiente:   
+  Si la API de consulta se crea sin un `ClientToken`, el SDK de consulta genera un `ClientToken` en su nombre.
+ Si la invocación de `Query` solo contiene el `ClientToken`, pero no incluye un `NextToken`, se supone que la invocación de la `Query` se trata de una nueva ejecución de consulta.
+ Si la invocación contiene `NextToken`, se supone que esa invocación específica es una invocación posterior de una llamada anterior a la API de consulta y se muestra un conjunto de resultados.
+  Transcurridas 4 horas, cualquier solicitud con la misma información `ClientToken` se considerará una solicitud nueva. 
Tipo: cadena  
Restricciones de longitud: longitud mínima de 32. Longitud máxima de 128.  
Obligatorio: no

 ** [MaxRows](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-MaxRows"></a>
 La cantidad total de filas que se mostrarán en el resultado de `Query`. La ejecución inicial de `Query` con un valor `MaxRows` especificado mostrará el conjunto de resultados de la consulta en dos casos:   
+ El tamaño del resultado es inferior a `1MB`.
+ La cantidad de filas del conjunto de resultados es inferior al valor de `maxRows`.
De lo contrario, la invocación inicial de `Query` solo muestra un `NextToken`, que luego se puede utilizar en llamadas posteriores para obtener el conjunto de resultados. Para reanudar la paginación, proporcione el valor de `NextToken` en el comando posterior.  
Si el tamaño de la fila es grande (por ejemplo, una fila tiene muchas columnas), Timestream puede mostrar menos filas para evitar que el tamaño de la respuesta supere el límite de 1 MB. Si no se brinda `MaxRows`, Timestream enviará la cantidad de filas necesaria para cumplir con el límite de 1 MB.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 1000.  
Obligatorio: no

 ** [NextToken](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-NextToken"></a>
 Un token de paginación que se utiliza para mostrar un conjunto de resultados. Cuando se invoca la API de `Query` mediante `NextToken`, se supone que esa invocación específica es una invocación posterior de una llamada anterior a la `Query` y se muestra un conjunto de resultados. Sin embargo, si la invocación de `Query` solo contiene el `ClientToken`, se supone que la invocación de la `Query` se trata de una nueva ejecución de consulta.   
Tenga en cuenta lo siguiente cuando lo utilice NextToken en una consulta:  
+ Un token de paginación puede utilizarse para un máximo de cinco invocaciones de `Query` O durante un máximo de 1 hora, lo que ocurra primero.
+ Si se usa el mismo `NextToken`, se obtendrá el mismo conjunto de registros. Para seguir paginando el conjunto de resultados, debe utilizar el `nextToken` más reciente.
+ Supongamos que una invocación de `Query` muestra dos valores de `NextToken`, `TokenA` y `TokenB`. Si se utiliza `TokenB` en una invocación de `Query` posterior, se invalida `TokenA` y no se puede reutilizar.
+ Para solicitar un conjunto de resultados anterior de una consulta después de que se inicie la paginación, debe volver a invocar la API de consultas.
+ El último `NextToken` debe usarse para paginar hasta que se muestre `null`, momento en el que se debe utilizar un `NextToken` nuevo.
+  Si el principal de IAM del iniciador de la consulta y el lector de resultados no son iguales, el iniciador de and/or la consulta y el lector de resultados no tienen la misma cadena de consulta en las solicitudes de consulta, la consulta fallará y se generará un error. `Invalid pagination token` 
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** [QueryInsights](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryInsights"></a>
Encapsula la configuración para habilitar una `QueryInsights`.  
La habilitación de `QueryInsights` muestra información y métricas además de los resultados de la consulta que ejecutó. Puede utilizar las `QueryInsights` para ajustar el rendimiento de sus consultas.  
Tipo: objeto [QueryInsights](API_query_QueryInsights.md)  
Obligatorio: no

 ** [QueryString](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryString"></a>
 La consulta que ejecutará Timestream.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 262144 caracteres.  
Obligatorio: sí

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

```
{
   "ColumnInfo": [ 
      { 
         "Name": "string",
         "Type": { 
            "ArrayColumnInfo": "ColumnInfo",
            "RowColumnInfo": [ 
               "ColumnInfo"
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": "ColumnInfo"
         }
      }
   ],
   "NextToken": "string",
   "QueryId": "string",
   "QueryInsightsResponse": { 
      "OutputBytes": number,
      "OutputRows": number,
      "QuerySpatialCoverage": { 
         "Max": { 
            "PartitionKey": [ "string" ],
            "TableArn": "string",
            "Value": number
         }
      },
      "QueryTableCount": number,
      "QueryTemporalRange": { 
         "Max": { 
            "TableArn": "string",
            "Value": number
         }
      },
      "UnloadPartitionCount": number,
      "UnloadWrittenBytes": number,
      "UnloadWrittenRows": number
   },
   "QueryStatus": { 
      "CumulativeBytesMetered": number,
      "CumulativeBytesScanned": number,
      "ProgressPercentage": number
   },
   "Rows": [ 
      { 
         "Data": [ 
            { 
               "ArrayValue": [ 
                  "Datum"
               ],
               "NullValue": boolean,
               "RowValue": "Row",
               "ScalarValue": "string",
               "TimeSeriesValue": [ 
                  { 
                     "Time": "string",
                     "Value": "Datum"
                  }
               ]
            }
         ]
      }
   ]
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ColumnInfo](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-ColumnInfo"></a>
 Los tipos de datos de la columna del conjunto de datos que se muestra.   
Tipo: matriz de objetos [ColumnInfo](API_query_ColumnInfo.md)

 ** [NextToken](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-NextToken"></a>
 Un token de paginación que se puede volver a utilizar en una llamada de `Query` para obtener el siguiente conjunto de resultados.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.

 ** [QueryId](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryId"></a>
 Un identificador único para la consulta determinada.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[a-zA-Z0-9]+` 

 ** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryInsightsResponse"></a>
Encapsula `QueryInsights` que contiene información y métricas relacionadas con la consulta que ejecutó.  
Tipo: objeto [QueryInsightsResponse](API_query_QueryInsightsResponse.md)

 ** [QueryStatus](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryStatus"></a>
Información sobre el estado de la consulta, incluidos el progreso y los bytes que se escanearon.  
Tipo: objeto [QueryStatus](API_query_QueryStatus.md)

 ** [Rows](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-Rows"></a>
 Las filas del conjunto de resultados que muestra la consulta.   
Tipo: matriz de objetos [Row](API_query_Row.md)

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

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

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** ConflictException **   
 No se pudo sondear los resultados de una consulta cancelada.   
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** QueryExecutionException **   
 Timestream no pudo ejecutar la consulta de manera correcta.   
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_Query_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/Query) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/Query) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Query) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/Query) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Query) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/Query) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/Query) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/Query) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/Query) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Query) 

# TagResource
<a name="API_query_TagResource"></a>

Asocia un conjunto de etiquetas con un recurso de Timestream. Puede habilitar estas etiquetas definidas por el usuario de modo que aparezcan en la consola de facturación y administración de costos y así poder usarlas para el seguimiento de asignación de costos. 

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

```
{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_query_TagResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ResourceARN](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-ResourceARN"></a>
Identifica el recurso de Timestream al que se deben agregar las etiquetas. Este valor es un Nombre de recurso de Amazon (ARN).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

 ** [Tags](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-Tags"></a>
Las etiquetas que se van a asignar al recurso de Timestream .  
Tipo: matriz de objetos [Tag](API_query_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: sí

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

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

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso solicitado.    
 ** ScheduledQueryArn **   
El ARN de la consulta programada.
Código de estado HTTP: 400

 ** ServiceQuotaExceededException **   
Superó la cuota de servicio.  
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_TagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TagResource) 

# UntagResource
<a name="API_query_UntagResource"></a>

Elimina la asociación de etiquetas de un recurso de consulta de Timestream.

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

```
{
   "ResourceARN": "string",
   "TagKeys": [ "string" ]
}
```

## Parámetros de la solicitud
<a name="API_query_UntagResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ResourceARN](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-ResourceARN"></a>
El recurso de Timestream del que se eliminarán las etiquetas. Este valor es un Nombre de recurso de Amazon (ARN).   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

 ** [TagKeys](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-TagKeys"></a>
Una lista de claves de etiquetas. Las etiquetas existentes del recurso con claves que son miembros de esta lista se eliminarán del recurso de Timestream.   
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128 caracteres.  
Obligatorio: sí

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

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

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso solicitado.    
 ** ScheduledQueryArn **   
El ARN de la consulta programada.
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_UntagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UntagResource) 

# UpdateAccountSettings
<a name="API_query_UpdateAccountSettings"></a>

Hace la transición de su cuenta TCUs para utilizarla en los precios de las consultas y modifica el número máximo de unidades de cálculo de consultas que ha configurado. Si reduce el valor de `MaxQueryTCU` a la configuración deseada, el nuevo valor puede tardar hasta 24 horas en hacerse efectivo.

**nota**  
Una vez que haya hecho la transición de su cuenta TCUs para utilizarla en los precios de consulta, no podrá pasar a utilizar los bytes escaneados para utilizar los precios de consulta.

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

```
{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         },
         "TargetQueryTCU": number
      }
   },
   "QueryPricingModel": "string"
}
```

## Parámetros de la solicitud
<a name="API_query_UpdateAccountSettings_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-MaxQueryTCU"></a>
La cantidad máxima de unidades de cómputo de Timestream que el servicio utilizará en cualquier momento para atender las consultas. Para ejecutar consultas, debe establecer una capacidad mínima de 4 TCU. Puede establecer la cantidad máxima de TCU en múltiplos de 4, como 4, 8, 16, 32, etc. El valor máximo admitido de `MaxQueryTCU` es 1000. Para solicitar un aumento de este límite flexible, ponte en contacto con AWS Support. Para obtener más información acerca de la cuota predeterminada de maxQueryTCU, consulte Cuotas predeterminadas. Esta configuración solo se aplica al uso bajo demanda de las unidades de cómputo Timestream ()TCUs.  
El valor máximo admitido de `MaxQueryTCU` es 1000. Para solicitar un aumento de este límite flexible, ponte en contacto con AWS Support. Para obtener más información acerca de la cuota predeterminada de `maxQueryTCU`, consulte [Cuotas predeterminadas](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.default).  
Tipo: entero  
Obligatorio: no

 ** [QueryCompute](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryCompute"></a>
Modifica los ajustes de procesamiento de consultas configurados en su cuenta, incluidos el modelo de precios de las consultas y las unidades de cálculo de flujo temporal (TCUs) aprovisionadas en su cuenta. QueryCompute está disponible solo en la región de Asia Pacífico (Bombay).  
Esta API es idempotente, lo que significa que realizar la misma solicitud muchas veces tendrá el mismo efecto que hacer la solicitud una vez.
Tipo: objeto [QueryComputeRequest](API_query_QueryComputeRequest.md)  
Obligatorio: no

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryPricingModel"></a>
El modelo de precios para las consultas de la cuenta.  
Varias operaciones de Timestream utilizan el parámetro `QueryPricingModel`; sin embargo, la operación de la API `UpdateAccountSettings` no reconoce ningún otro valor que no sea `COMPUTE_UNITS`.
Tipo: cadena  
Valores válidos: `BYTES_SCANNED | COMPUTE_UNITS`   
Obligatorio: no

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

```
{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "ActiveQueryTCU": number,
         "LastUpdate": { 
            "Status": "string",
            "StatusMessage": "string",
            "TargetQueryTCU": number
         },
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         }
      }
   },
   "QueryPricingModel": "string"
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-MaxQueryTCU"></a>
La cantidad máxima configurada de unidades de cómputo de Timestream que el servicio utilizará en cualquier momento para atender las consultas.  
Tipo: entero

 ** [QueryCompute](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryCompute"></a>
Confirma la configuración actualizada de la cuenta para consultar los datos de su cuenta. QueryCompute está disponible solo en la región de Asia Pacífico (Bombay).  
Tipo: objeto [QueryComputeResponse](API_query_QueryComputeResponse.md)

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryPricingModel"></a>
El modelo de precios para una cuenta.  
Tipo: cadena  
Valores válidos: `BYTES_SCANNED | COMPUTE_UNITS` 

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

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

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_UpdateAccountSettings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateAccountSettings) 

# UpdateScheduledQuery
<a name="API_query_UpdateScheduledQuery"></a>

Actualizar la consulta programada.

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

```
{
   "ScheduledQueryArn": "string",
   "State": "string"
}
```

## Parámetros de la solicitud
<a name="API_query_UpdateScheduledQuery_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-ScheduledQueryArn"></a>
ARN de la consulta programada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

 ** [State](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-State"></a>
Estado de la consulta programada.   
Tipo: cadena  
Valores válidos: `ENABLED | DISABLED`   
Obligatorio: sí

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

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

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso solicitado.    
 ** ScheduledQueryArn **   
El ARN de la consulta programada.
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_UpdateScheduledQuery_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateScheduledQuery) 

# Data Types
<a name="API_Types"></a>

La escritura de Amazon Timestream admite los siguientes tipos de datos:
+  [BatchLoadProgressReport](API_BatchLoadProgressReport.md) 
+  [BatchLoadTask](API_BatchLoadTask.md) 
+  [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) 
+  [CsvConfiguration](API_CsvConfiguration.md) 
+  [Database](API_Database.md) 
+  [DataModel](API_DataModel.md) 
+  [DataModelConfiguration](API_DataModelConfiguration.md) 
+  [DataModelS3Configuration](API_DataModelS3Configuration.md) 
+  [DataSourceConfiguration](API_DataSourceConfiguration.md) 
+  [DataSourceS3Configuration](API_DataSourceS3Configuration.md) 
+  [Dimension](API_Dimension.md) 
+  [DimensionMapping](API_DimensionMapping.md) 
+  [Endpoint](API_Endpoint.md) 
+  [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) 
+  [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) 
+  [MeasureValue](API_MeasureValue.md) 
+  [MixedMeasureMapping](API_MixedMeasureMapping.md) 
+  [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) 
+  [MultiMeasureMappings](API_MultiMeasureMappings.md) 
+  [PartitionKey](API_PartitionKey.md) 
+  [Record](API_Record.md) 
+  [RecordsIngested](API_RecordsIngested.md) 
+  [RejectedRecord](API_RejectedRecord.md) 
+  [ReportConfiguration](API_ReportConfiguration.md) 
+  [ReportS3Configuration](API_ReportS3Configuration.md) 
+  [RetentionProperties](API_RetentionProperties.md) 
+  [S3Configuration](API_S3Configuration.md) 
+  [Schema](API_Schema.md) 
+  [Table](API_Table.md) 
+  [Tag](API_Tag.md) 

La consulta de Amazon Timestream admite los siguientes tipos de datos:
+  [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) 
+  [ColumnInfo](API_query_ColumnInfo.md) 
+  [Datum](API_query_Datum.md) 
+  [DimensionMapping](API_query_DimensionMapping.md) 
+  [Endpoint](API_query_Endpoint.md) 
+  [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) 
+  [ErrorReportLocation](API_query_ErrorReportLocation.md) 
+  [ExecutionStats](API_query_ExecutionStats.md) 
+  [LastUpdate](API_query_LastUpdate.md) 
+  [MixedMeasureMapping](API_query_MixedMeasureMapping.md) 
+  [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) 
+  [MultiMeasureMappings](API_query_MultiMeasureMappings.md) 
+  [NotificationConfiguration](API_query_NotificationConfiguration.md) 
+  [ParameterMapping](API_query_ParameterMapping.md) 
+  [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) 
+  [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) 
+  [QueryComputeRequest](API_query_QueryComputeRequest.md) 
+  [QueryComputeResponse](API_query_QueryComputeResponse.md) 
+  [QueryInsights](API_query_QueryInsights.md) 
+  [QueryInsightsResponse](API_query_QueryInsightsResponse.md) 
+  [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) 
+  [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) 
+  [QueryStatus](API_query_QueryStatus.md) 
+  [QueryTemporalRange](API_query_QueryTemporalRange.md) 
+  [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) 
+  [Row](API_query_Row.md) 
+  [S3Configuration](API_query_S3Configuration.md) 
+  [S3ReportLocation](API_query_S3ReportLocation.md) 
+  [ScheduleConfiguration](API_query_ScheduleConfiguration.md) 
+  [ScheduledQuery](API_query_ScheduledQuery.md) 
+  [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) 
+  [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) 
+  [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) 
+  [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) 
+  [SelectColumn](API_query_SelectColumn.md) 
+  [SnsConfiguration](API_query_SnsConfiguration.md) 
+  [Tag](API_query_Tag.md) 
+  [TargetConfiguration](API_query_TargetConfiguration.md) 
+  [TargetDestination](API_query_TargetDestination.md) 
+  [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) 
+  [TimestreamConfiguration](API_query_TimestreamConfiguration.md) 
+  [TimestreamDestination](API_query_TimestreamDestination.md) 
+  [Type](API_query_Type.md) 

# Escritura de Amazon Timestream
<a name="API_Types_Amazon_Timestream_Write"></a>

La escritura de Amazon Timestream admite los siguientes tipos de datos:
+  [BatchLoadProgressReport](API_BatchLoadProgressReport.md) 
+  [BatchLoadTask](API_BatchLoadTask.md) 
+  [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) 
+  [CsvConfiguration](API_CsvConfiguration.md) 
+  [Database](API_Database.md) 
+  [DataModel](API_DataModel.md) 
+  [DataModelConfiguration](API_DataModelConfiguration.md) 
+  [DataModelS3Configuration](API_DataModelS3Configuration.md) 
+  [DataSourceConfiguration](API_DataSourceConfiguration.md) 
+  [DataSourceS3Configuration](API_DataSourceS3Configuration.md) 
+  [Dimension](API_Dimension.md) 
+  [DimensionMapping](API_DimensionMapping.md) 
+  [Endpoint](API_Endpoint.md) 
+  [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) 
+  [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) 
+  [MeasureValue](API_MeasureValue.md) 
+  [MixedMeasureMapping](API_MixedMeasureMapping.md) 
+  [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) 
+  [MultiMeasureMappings](API_MultiMeasureMappings.md) 
+  [PartitionKey](API_PartitionKey.md) 
+  [Record](API_Record.md) 
+  [RecordsIngested](API_RecordsIngested.md) 
+  [RejectedRecord](API_RejectedRecord.md) 
+  [ReportConfiguration](API_ReportConfiguration.md) 
+  [ReportS3Configuration](API_ReportS3Configuration.md) 
+  [RetentionProperties](API_RetentionProperties.md) 
+  [S3Configuration](API_S3Configuration.md) 
+  [Schema](API_Schema.md) 
+  [Table](API_Table.md) 
+  [Tag](API_Tag.md) 

# BatchLoadProgressReport
<a name="API_BatchLoadProgressReport"></a>

Información sobre el progreso de una tarea de carga por lotes.

## Contenido
<a name="API_BatchLoadProgressReport_Contents"></a>

 ** BytesMetered **   <a name="timestream-Type-BatchLoadProgressReport-BytesMetered"></a>
  
Tipo: Long  
Obligatorio: no

 ** FileFailures **   <a name="timestream-Type-BatchLoadProgressReport-FileFailures"></a>
  
Tipo: Long  
Obligatorio: no

 ** ParseFailures **   <a name="timestream-Type-BatchLoadProgressReport-ParseFailures"></a>
  
Tipo: Long  
Obligatorio: no

 ** RecordIngestionFailures **   <a name="timestream-Type-BatchLoadProgressReport-RecordIngestionFailures"></a>
  
Tipo: Long  
Obligatorio: no

 ** RecordsIngested **   <a name="timestream-Type-BatchLoadProgressReport-RecordsIngested"></a>
  
Tipo: Long  
Obligatorio: no

 ** RecordsProcessed **   <a name="timestream-Type-BatchLoadProgressReport-RecordsProcessed"></a>
  
Tipo: Long  
Obligatorio: no

## Véase también
<a name="API_BatchLoadProgressReport_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadProgressReport) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadProgressReport) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadProgressReport) 

# BatchLoadTask
<a name="API_BatchLoadTask"></a>

Información sobre una tarea de carga por lotes.

## Contenido
<a name="API_BatchLoadTask_Contents"></a>

 ** CreationTime **   <a name="timestream-Type-BatchLoadTask-CreationTime"></a>
La hora en la que se creó la tarea de carga por lotes de Timestream.  
Tipo: marca temporal  
Obligatorio: no

 ** DatabaseName **   <a name="timestream-Type-BatchLoadTask-DatabaseName"></a>
Nombre de la base de datos para la base de datos en la que se cargan los datos una tarea de carga por lotes.  
Tipo: cadena  
Requerido: no

 ** LastUpdatedTime **   <a name="timestream-Type-BatchLoadTask-LastUpdatedTime"></a>
La hora en la que se actualizó por última vez la tarea de carga por lotes de Timestream.  
Tipo: marca temporal  
Obligatorio: no

 ** ResumableUntil **   <a name="timestream-Type-BatchLoadTask-ResumableUntil"></a>
   
Tipo: marca temporal  
Obligatorio: no

 ** TableName **   <a name="timestream-Type-BatchLoadTask-TableName"></a>
Nombre de la tabla para la tabla en la que se cargan los datos una tarea de carga por lotes.  
Tipo: cadena  
Requerido: no

 ** TaskId **   <a name="timestream-Type-BatchLoadTask-TaskId"></a>
El ID de la tarea de carga por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 32 caracteres.  
Patrón: `[A-Z0-9]+`   
Obligatorio: no

 ** TaskStatus **   <a name="timestream-Type-BatchLoadTask-TaskStatus"></a>
Estado de la tarea de carga por lotes.  
Tipo: cadena  
Valores válidos: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME`   
Obligatorio: no

## Véase también
<a name="API_BatchLoadTask_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTask) 

# BatchLoadTaskDescription
<a name="API_BatchLoadTaskDescription"></a>

Información sobre una tarea de carga por lotes.

## Contenido
<a name="API_BatchLoadTaskDescription_Contents"></a>

 ** CreationTime **   <a name="timestream-Type-BatchLoadTaskDescription-CreationTime"></a>
La hora en la que se creó la tarea de carga por lotes de Timestream.  
Tipo: marca temporal  
Obligatorio: no

 ** DataModelConfiguration **   <a name="timestream-Type-BatchLoadTaskDescription-DataModelConfiguration"></a>
Configuración del modelo de datos para una tarea de carga por lotes. Contiene información sobre dónde se almacena un modelo de datos para una tarea de carga por lotes.  
Tipo: objeto [DataModelConfiguration](API_DataModelConfiguration.md)  
Obligatorio: no

 ** DataSourceConfiguration **   <a name="timestream-Type-BatchLoadTaskDescription-DataSourceConfiguration"></a>
Información de configuración del origen de datos de una tarea de carga por lotes.  
Tipo: objeto [DataSourceConfiguration](API_DataSourceConfiguration.md)  
Obligatorio: no

 ** ErrorMessage **   <a name="timestream-Type-BatchLoadTaskDescription-ErrorMessage"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** LastUpdatedTime **   <a name="timestream-Type-BatchLoadTaskDescription-LastUpdatedTime"></a>
La hora en la que se actualizó por última vez la tarea de carga por lotes de Timestream.  
Tipo: marca temporal  
Obligatorio: no

 ** ProgressReport **   <a name="timestream-Type-BatchLoadTaskDescription-ProgressReport"></a>
  
Tipo: objeto [BatchLoadProgressReport](API_BatchLoadProgressReport.md)  
Obligatorio: no

 ** RecordVersion **   <a name="timestream-Type-BatchLoadTaskDescription-RecordVersion"></a>
  
Tipo: Long  
Obligatorio: no

 ** ReportConfiguration **   <a name="timestream-Type-BatchLoadTaskDescription-ReportConfiguration"></a>
Informe de la configuración de una tarea de carga por lotes. Contiene información sobre dónde se almacenan los informes de errores.  
Tipo: objeto [ReportConfiguration](API_ReportConfiguration.md)  
Obligatorio: no

 ** ResumableUntil **   <a name="timestream-Type-BatchLoadTaskDescription-ResumableUntil"></a>
   
Tipo: marca temporal  
Obligatorio: no

 ** TargetDatabaseName **   <a name="timestream-Type-BatchLoadTaskDescription-TargetDatabaseName"></a>
  
Tipo: cadena  
Requerido: no

 ** TargetTableName **   <a name="timestream-Type-BatchLoadTaskDescription-TargetTableName"></a>
  
Tipo: cadena  
Requerido: no

 ** TaskId **   <a name="timestream-Type-BatchLoadTaskDescription-TaskId"></a>
El ID de la tarea de carga por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 32 caracteres.  
Patrón: `[A-Z0-9]+`   
Obligatorio: no

 ** TaskStatus **   <a name="timestream-Type-BatchLoadTaskDescription-TaskStatus"></a>
Estado de la tarea de carga por lotes.  
Tipo: cadena  
Valores válidos: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME`   
Obligatorio: no

## Véase también
<a name="API_BatchLoadTaskDescription_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTaskDescription) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTaskDescription) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTaskDescription) 

# CsvConfiguration
<a name="API_CsvConfiguration"></a>

Un formato de datos delimitado donde el separador de columnas puede ser una coma y el separador de informes es un carácter de nueva línea.

## Contenido
<a name="API_CsvConfiguration_Contents"></a>

 ** ColumnSeparator **   <a name="timestream-Type-CsvConfiguration-ColumnSeparator"></a>
El separador de columnas puede ser una coma («,»), una barra vertical («\$1»), un punto y coma («;»), una tabulación («/t») o un espacio en blanco (« »).   
Tipo: cadena  
Limitaciones de longitud: longitud fija de 1 caracteres.  
Obligatorio: no

 ** EscapeChar **   <a name="timestream-Type-CsvConfiguration-EscapeChar"></a>
El carácter de escape puede ser uno de   
Tipo: cadena  
Limitaciones de longitud: longitud fija de 1 caracteres.  
Obligatorio: no

 ** NullValue **   <a name="timestream-Type-CsvConfiguration-NullValue"></a>
Puede ser un espacio en blanco (« »).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** QuoteChar **   <a name="timestream-Type-CsvConfiguration-QuoteChar"></a>
Puede ser una comilla simple (') o una comilla doble (").  
Tipo: cadena  
Limitaciones de longitud: longitud fija de 1 caracteres.  
Obligatorio: no

 ** TrimWhiteSpace **   <a name="timestream-Type-CsvConfiguration-TrimWhiteSpace"></a>
Especifica que se recorten los espacios en blanco iniciales y finales.  
Tipo: Booleano  
Obligatorio: no

## Véase también
<a name="API_CsvConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CsvConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CsvConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CsvConfiguration) 

# Database
<a name="API_Database"></a>

Un contenedor de nivel superior para una tabla. Las bases de datos y las tablas son los conceptos de administración fundamentales de Amazon Timestream. Todas las tablas de una base de datos se cifran con la misma clave de AWS KMS.

## Contenido
<a name="API_Database_Contents"></a>

 ** Arn **   <a name="timestream-Type-Database-Arn"></a>
El nombre del recurso de Amazon que identifica de manera exclusiva a esta base de datos.  
Tipo: cadena  
Requerido: no

 ** CreationTime **   <a name="timestream-Type-Database-CreationTime"></a>
La hora en que se creó la base de datos, que se calcula a partir de la época de Unix.  
Tipo: marca temporal  
Obligatorio: no

 ** DatabaseName **   <a name="timestream-Type-Database-DatabaseName"></a>
Nombre de la base de datos de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** KmsKeyId **   <a name="timestream-Type-Database-KmsKeyId"></a>
Identificador de la clave de AWS KMS que se ha utilizado para cifrar los datos almacenados en la base de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** LastUpdatedTime **   <a name="timestream-Type-Database-LastUpdatedTime"></a>
 La última vez que se actualizó esta base de datos.   
Tipo: marca temporal  
Obligatorio: no

 ** TableCount **   <a name="timestream-Type-Database-TableCount"></a>
La cantidad total de tablas que se encuentran en una base de datos de Timestream.   
Tipo: Long  
Obligatorio: no

## Véase también
<a name="API_Database_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Database) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Database) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Database) 

# DataModel
<a name="API_DataModel"></a>

Modelo de datos para una tarea de carga por lotes.

## Contenido
<a name="API_DataModel_Contents"></a>

 ** DimensionMappings **   <a name="timestream-Type-DataModel-DimensionMappings"></a>
Mapeos de las dimensiones de origen a destino.  
Tipo: Matriz de [DimensionMapping](API_DimensionMapping.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo.  
Obligatorio: sí

 ** MeasureNameColumn **   <a name="timestream-Type-DataModel-MeasureNameColumn"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** MixedMeasureMappings **   <a name="timestream-Type-DataModel-MixedMeasureMappings"></a>
Mapeos de origen a destino para las medidas.  
Tipo: Matriz de [MixedMeasureMapping](API_MixedMeasureMapping.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo.  
Obligatorio: no

 ** MultiMeasureMappings **   <a name="timestream-Type-DataModel-MultiMeasureMappings"></a>
Mapeos de origen a destino para los registros de varias medidas.  
Tipo: objeto [MultiMeasureMappings](API_MultiMeasureMappings.md)  
Obligatorio: no

 ** TimeColumn **   <a name="timestream-Type-DataModel-TimeColumn"></a>
Columna de origen que se asignará al tiempo.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** TimeUnit **   <a name="timestream-Type-DataModel-TimeUnit"></a>
 La granularidad de la unidad de marca de tiempo. Indica si el valor de tiempo está en segundos, milisegundos, nanosegundos u otros valores admitidos. El valor predeterminado es `MILLISECONDS`.   
Tipo: cadena  
Valores válidos: `MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS`   
Obligatorio: no

## Véase también
<a name="API_DataModel_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModel) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModel) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModel) 

# DataModelConfiguration
<a name="API_DataModelConfiguration"></a>



## Contenido
<a name="API_DataModelConfiguration_Contents"></a>

 ** DataModel **   <a name="timestream-Type-DataModelConfiguration-DataModel"></a>
  
Tipo: objeto [DataModel](API_DataModel.md)  
Obligatorio: no

 ** DataModelS3Configuration **   <a name="timestream-Type-DataModelConfiguration-DataModelS3Configuration"></a>
  
Tipo: objeto [DataModelS3Configuration](API_DataModelS3Configuration.md)  
Obligatorio: no

## Véase también
<a name="API_DataModelConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelConfiguration) 

# DataModelS3Configuration
<a name="API_DataModelS3Configuration"></a>



## Contenido
<a name="API_DataModelS3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-DataModelS3Configuration-BucketName"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 63 caracteres.  
Patrón: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Obligatorio: no

 ** ObjectKey **   <a name="timestream-Type-DataModelS3Configuration-ObjectKey"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.  
Patrón: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obligatorio: no

## Véase también
<a name="API_DataModelS3Configuration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelS3Configuration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelS3Configuration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelS3Configuration) 

# DataSourceConfiguration
<a name="API_DataSourceConfiguration"></a>

Define la información de configuración del origen de datos.

## Contenido
<a name="API_DataSourceConfiguration_Contents"></a>

 ** DataFormat **   <a name="timestream-Type-DataSourceConfiguration-DataFormat"></a>
Actualmente es CSV.  
Tipo: cadena  
Valores válidos: `CSV`   
Obligatorio: sí

 ** DataSourceS3Configuration **   <a name="timestream-Type-DataSourceConfiguration-DataSourceS3Configuration"></a>
Configuración de una ubicación de S3 para un archivo que contiene los datos que se van a cargar.  
Tipo: objeto [DataSourceS3Configuration](API_DataSourceS3Configuration.md)  
Obligatorio: sí

 ** CsvConfiguration **   <a name="timestream-Type-DataSourceConfiguration-CsvConfiguration"></a>
Un formato de datos delimitado donde el separador de columnas puede ser una coma y el separador de informes es un carácter de nueva línea.  
Tipo: objeto [CsvConfiguration](API_CsvConfiguration.md)  
Obligatorio: no

## Véase también
<a name="API_DataSourceConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceConfiguration) 

# DataSourceS3Configuration
<a name="API_DataSourceS3Configuration"></a>

 

## Contenido
<a name="API_DataSourceS3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-DataSourceS3Configuration-BucketName"></a>
El nombre del bucket de S3 del cliente.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 63 caracteres.  
Patrón: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Obligatorio: sí

 ** ObjectKeyPrefix **   <a name="timestream-Type-DataSourceS3Configuration-ObjectKeyPrefix"></a>
   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.  
Patrón: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obligatorio: no

## Véase también
<a name="API_DataSourceS3Configuration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceS3Configuration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceS3Configuration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceS3Configuration) 

# Dimension
<a name="API_Dimension"></a>

Representa los atributos de los metadatos de la serie temporal. Por ejemplo, el nombre y la zona de disponibilidad de una instancia EC2 o el nombre del fabricante de un aerogenerador son dimensiones. 

## Contenido
<a name="API_Dimension_Contents"></a>

 ** Name **   <a name="timestream-Type-Dimension-Name"></a>
 La dimensión representa los atributos de los metadatos de la serie temporal. Por ejemplo, el nombre y la zona de disponibilidad de una instancia EC2 o el nombre del fabricante de un aerogenerador son dimensiones.   
Para conocer las restricciones en los nombres de las dimensiones, consulte [Restricciones de nombres](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 60 caracteres.  
Obligatorio: sí

 ** Value **   <a name="timestream-Type-Dimension-Value"></a>
El valor de la dimensión.  
Tipo: cadena  
Obligatorio: sí

 ** DimensionValueType **   <a name="timestream-Type-Dimension-DimensionValueType"></a>
El tipo de datos de la dimensión para el punto de datos de serie temporal.  
Tipo: cadena  
Valores válidos: `VARCHAR`   
Obligatorio: no

## Véase también
<a name="API_Dimension_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Dimension) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Dimension) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Dimension) 

# DimensionMapping
<a name="API_DimensionMapping"></a>



## Contenido
<a name="API_DimensionMapping_Contents"></a>

 ** DestinationColumn **   <a name="timestream-Type-DimensionMapping-DestinationColumn"></a>
   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1.  
Obligatorio: no

 ** SourceColumn **   <a name="timestream-Type-DimensionMapping-SourceColumn"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1.  
Obligatorio: no

## Véase también
<a name="API_DimensionMapping_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DimensionMapping) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DimensionMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DimensionMapping) 

# Endpoint
<a name="API_Endpoint"></a>

Representa un punto de conexión disponible contra el que realizar llamadas a la API, así como el TTL de ese punto de conexión.

## Contenido
<a name="API_Endpoint_Contents"></a>

 ** Address **   <a name="timestream-Type-Endpoint-Address"></a>
Una dirección del punto de conexión.  
Tipo: cadena  
Obligatorio: sí

 ** CachePeriodInMinutes **   <a name="timestream-Type-Endpoint-CachePeriodInMinutes"></a>
El TTL del punto de conexión, en minutos.  
Tipo: Long  
Obligatorio: sí

## Véase también
<a name="API_Endpoint_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Endpoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Endpoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Endpoint) 

# MagneticStoreRejectedDataLocation
<a name="API_MagneticStoreRejectedDataLocation"></a>

La ubicación en donde se tienen que escribir los informes de errores para los registros rechazados de forma asíncrona durante las escrituras en el almacén magnético.

## Contenido
<a name="API_MagneticStoreRejectedDataLocation_Contents"></a>

 ** S3Configuration **   <a name="timestream-Type-MagneticStoreRejectedDataLocation-S3Configuration"></a>
La configuración de una ubicación de S3 en donde se tienen que escribir los informes de errores para los registros rechazados de forma asíncrona durante las escrituras en el almacén magnético.  
Tipo: objeto [S3Configuration](API_S3Configuration.md)  
Obligatorio: no

## Véase también
<a name="API_MagneticStoreRejectedDataLocation_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) 

# MagneticStoreWriteProperties
<a name="API_MagneticStoreWriteProperties"></a>

El conjunto de propiedades de una tabla para configurar las escrituras en el almacén magnético.

## Contenido
<a name="API_MagneticStoreWriteProperties_Contents"></a>

 ** EnableMagneticStoreWrites **   <a name="timestream-Type-MagneticStoreWriteProperties-EnableMagneticStoreWrites"></a>
Un indicador para habilitar las escrituras en el almacén magnético.  
Tipo: booleano  
Obligatorio: sí

 ** MagneticStoreRejectedDataLocation **   <a name="timestream-Type-MagneticStoreWriteProperties-MagneticStoreRejectedDataLocation"></a>
La ubicación en donde se tienen que escribir los informes de errores para los registros rechazados de forma asíncrona durante las escrituras en el almacén magnético.  
Tipo: objeto [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md)  
Obligatorio: no

## Véase también
<a name="API_MagneticStoreWriteProperties_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreWriteProperties) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreWriteProperties) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreWriteProperties) 

# MeasureValue
<a name="API_MeasureValue"></a>

 Representa el atributo de los datos de la serie temporal. Por ejemplo, se mide el uso de la CPU de una instancia de EC2 o el RPM de una turbina eólica. MeasureValue tiene tanto el nombre como el valor. 

 MeasureValue solo está permitido para el tipo `MULTI`. Con el tipo `MULTI`, puede pasar varios atributos de datos asociados a la misma serie temporal en un solo registro. 

## Contenido
<a name="API_MeasureValue_Contents"></a>

 ** Name **   <a name="timestream-Type-MeasureValue-Name"></a>
 El nombre de MeasureValue.   
 Para conocer las restricciones en los nombres de MeasureValue, consulte las [Restricciones de nombre](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming) en la Guía para desarrolladores de Amazon Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1.  
Obligatorio: sí

 ** Type **   <a name="timestream-Type-MeasureValue-Type"></a>
Contiene el tipo de datos de MeasureValue del punto de datos de serie temporal.  
Tipo: cadena  
Valores válidos: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI`   
Obligatorio: sí

 ** Value **   <a name="timestream-Type-MeasureValue-Value"></a>
 El valor de MeasureValue. Para obtener más información, consulte [Tipos de datos](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

## Véase también
<a name="API_MeasureValue_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MeasureValue) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MeasureValue) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MeasureValue) 

# MixedMeasureMapping
<a name="API_MixedMeasureMapping"></a>



## Contenido
<a name="API_MixedMeasureMapping_Contents"></a>

 ** MeasureValueType **   <a name="timestream-Type-MixedMeasureMapping-MeasureValueType"></a>
  
Tipo: cadena  
Valores válidos: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI`   
Obligatorio: sí

 ** MeasureName **   <a name="timestream-Type-MixedMeasureMapping-MeasureName"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1.  
Obligatorio: no

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-MixedMeasureMapping-MultiMeasureAttributeMappings"></a>
  
Tipo: Matriz de [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo.  
Obligatorio: no

 ** SourceColumn **   <a name="timestream-Type-MixedMeasureMapping-SourceColumn"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1.  
Obligatorio: no

 ** TargetMeasureName **   <a name="timestream-Type-MixedMeasureMapping-TargetMeasureName"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1.  
Obligatorio: no

## Véase también
<a name="API_MixedMeasureMapping_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MixedMeasureMapping) 

# MultiMeasureAttributeMapping
<a name="API_MultiMeasureAttributeMapping"></a>



## Contenido
<a name="API_MultiMeasureAttributeMapping_Contents"></a>

 ** SourceColumn **   <a name="timestream-Type-MultiMeasureAttributeMapping-SourceColumn"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1.  
Obligatorio: sí

 ** MeasureValueType **   <a name="timestream-Type-MultiMeasureAttributeMapping-MeasureValueType"></a>
  
Tipo: cadena  
Valores válidos: `DOUBLE | BIGINT | BOOLEAN | VARCHAR | TIMESTAMP`   
Obligatorio: no

 ** TargetMultiMeasureAttributeName **   <a name="timestream-Type-MultiMeasureAttributeMapping-TargetMultiMeasureAttributeName"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1.  
Obligatorio: no

## Véase también
<a name="API_MultiMeasureAttributeMapping_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureAttributeMapping) 

# MultiMeasureMappings
<a name="API_MultiMeasureMappings"></a>



## Contenido
<a name="API_MultiMeasureMappings_Contents"></a>

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-MultiMeasureMappings-MultiMeasureAttributeMappings"></a>
  
Tipo: Matriz de [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo.  
Obligatorio: sí

 ** TargetMultiMeasureName **   <a name="timestream-Type-MultiMeasureMappings-TargetMultiMeasureName"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1.  
Obligatorio: no

## Véase también
<a name="API_MultiMeasureMappings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureMappings) 

# PartitionKey
<a name="API_PartitionKey"></a>

 Un atributo que se utiliza para particionar los datos de una tabla. Una clave de dimensión divide los datos mediante el uso de los valores de la dimensión especificados en el nombre de la dimensión como clave de partición, mientras que una clave de medida divide los datos a través del uso de los nombres de medidas (valores de la columna «measure\$1name»). 

## Contenido
<a name="API_PartitionKey_Contents"></a>

 ** Type **   <a name="timestream-Type-PartitionKey-Type"></a>
 El tipo de la clave de particiones. Las opciones son DIMENSION (clave de dimensión) y MEASURE (clave de medida).   
Tipo: cadena  
Valores válidos: `DIMENSION | MEASURE`   
Obligatorio: sí

 ** EnforcementInRecord **   <a name="timestream-Type-PartitionKey-EnforcementInRecord"></a>
 El nivel de cumplimiento de la especificación de una clave de dimensión en los registros ingeridos. Las opciones son REQUIRED (debe especificarse la clave de dimensión) y OPTIONAL (no es necesario especificar la clave de dimensión).   
Tipo: cadena  
Valores válidos: `REQUIRED | OPTIONAL`   
Obligatorio: no

 ** Name **   <a name="timestream-Type-PartitionKey-Name"></a>
 El nombre del atributo que se utiliza para una clave de dimensión.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1.  
Obligatorio: no

## Véase también
<a name="API_PartitionKey_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/PartitionKey) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/PartitionKey) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/PartitionKey) 

# Record
<a name="API_Record"></a>

Representa un punto de datos de serie temporal que se escribe en Timestream. Cada registro contiene una matriz de dimensiones. Las dimensiones representan los atributos de los metadatos de un punto de datos de serie temporal, como el nombre de la instancia o la zona de disponibilidad de una instancia de EC2. Un registro también contiene el nombre de la medida, que es el nombre de la medida que se recopila (por ejemplo, el uso de la CPU de una instancia de EC2). Además, un registro contiene el valor de medida y el tipo de valor, que es el tipo de datos del valor de medida. También el registro contiene la marca de tiempo del momento en que se recopiló la medida y la unidad de la marca de tiempo, que representa la granularidad de la marca de tiempo. 

 Los registros tienen un campo `Version`, que es de 64 bits `long`, que puede utilizarse para actualizar los puntos de datos. La escritura de un registro duplicado con la misma dimensión, marca de tiempo y nombre de medida, pero con un valor de medida diferente, solo se realizará de manera correcta si el atributo `Version` del registro de la solicitud de escritura es superior al del registro existente. Timestream establece el valor predeterminado `Version` a `1` para los registros sin el campo `Version`. 

## Contenido
<a name="API_Record_Contents"></a>

 ** Dimensions **   <a name="timestream-Type-Record-Dimensions"></a>
Contiene la lista de dimensiones de los puntos de datos de serie temporal.  
Tipo: matriz de objetos [Dimension](API_Dimension.md)  
Miembros de la matriz: número máximo de 128 elementos.  
Obligatorio: no

 ** MeasureName **   <a name="timestream-Type-Record-MeasureName"></a>
La medida representa el atributo de los datos de la serie temporal. Por ejemplo, se mide el uso de la CPU de una instancia de EC2 o el RPM de una turbina eólica.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** MeasureValue **   <a name="timestream-Type-Record-MeasureValue"></a>
 Contiene el valor de medida del punto de datos de serie temporal.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** MeasureValues **   <a name="timestream-Type-Record-MeasureValues"></a>
 Contiene la lista de MeasureValue del punto de datos de serie temporal.   
 Esto solo está permitido para el tipo `MULTI`. Para valores escalares, utilice directamente el atributo `MeasureValue` del registro.   
Tipo: matriz de objetos [MeasureValue](API_MeasureValue.md)  
Obligatorio: no

 ** MeasureValueType **   <a name="timestream-Type-Record-MeasureValueType"></a>
 Contiene el tipo de datos del valor de medida del punto de datos de serie temporal. El tipo predeterminado es `DOUBLE`. Para obtener más información, consulte [Tipos de datos](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types).  
Tipo: cadena  
Valores válidos: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI`   
Obligatorio: no

 ** Time **   <a name="timestream-Type-Record-Time"></a>
 Contiene la hora en la que se recopiló el valor de medida del punto de datos. El valor de tiempo más la unidad brinda el tiempo transcurrido desde la época. Por ejemplo, si el valor del tiempo es `12345` y la unidad es `ms`, entonces transcurrieron `12345 ms` desde la época.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** TimeUnit **   <a name="timestream-Type-Record-TimeUnit"></a>
 La granularidad de la unidad de marca de tiempo. Indica si el valor de tiempo está en segundos, milisegundos, nanosegundos u otros valores admitidos. El valor predeterminado es `MILLISECONDS`.   
Tipo: cadena  
Valores válidos: `MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS`   
Obligatorio: no

 ** Version **   <a name="timestream-Type-Record-Version"></a>
Atributo de 64 bits utilizado para las actualizaciones de los registros. Las solicitudes de escritura de datos duplicados con un número de versión superior actualizarán el valor de medida y la versión existentes. En los casos en que el valor de la medida sea el mismo, `Version` se seguirá actualizando. El valor predeterminado es `1`.  
 `Version` debe ser `1` o superior o recibirá un error de `ValidationException`.
Tipo: Long  
Obligatorio: no

## Véase también
<a name="API_Record_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Record) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Record) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Record) 

# RecordsIngested
<a name="API_RecordsIngested"></a>

Información sobre los registros ingeridos por esta solicitud.

## Contenido
<a name="API_RecordsIngested_Contents"></a>

 ** MagneticStore **   <a name="timestream-Type-RecordsIngested-MagneticStore"></a>
Recuento de registros ingeridos en el almacén magnético.  
Tipo: entero  
Obligatorio: no

 ** MemoryStore **   <a name="timestream-Type-RecordsIngested-MemoryStore"></a>
Recuento de registros ingeridos en el almacén de memoria.  
Tipo: entero  
Obligatorio: no

 ** Total **   <a name="timestream-Type-RecordsIngested-Total"></a>
Recuento total de registros ingeridos de manera correcta.  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_RecordsIngested_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RecordsIngested) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RecordsIngested) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RecordsIngested) 

# RejectedRecord
<a name="API_RejectedRecord"></a>

 Representa los registros que no se insertaron de manera correcta en Timestream debido a problemas de validación de datos que deben resolverse antes de volver a insertar los datos de serie temporal en el sistema. 

## Contenido
<a name="API_RejectedRecord_Contents"></a>

 ** ExistingVersion **   <a name="timestream-Type-RejectedRecord-ExistingVersion"></a>
La versión existente del registro. Este valor se completa en situaciones en las que existe un registro idéntico con una versión superior a la versión de la solicitud de escritura.  
Tipo: Long  
Obligatorio: no

 ** Reason **   <a name="timestream-Type-RejectedRecord-Reason"></a>
 El motivo por el que un registro no se insertó de manera correcta en Timestream. Entre las posibles causas del error se incluyen las siguientes:   
+ Los registros con datos duplicados en los que existen varios registros con las mismas dimensiones, marcas de tiempo y nombres de medidas, pero: 
  + Los valores de las medidas son diferentes.
  + La versión no está presente en la solicitud *o* el valor de la versión en el registro nuevo es igual o inferior al valor existente.

  Si Timestream rechaza los datos en este caso, el campo `ExistingVersion` de la respuesta `RejectedRecords` indicará la versión actual del registro. Para forzar una actualización, puede volver a enviar la solicitud con una versión del registro establecida en un valor superior a la `ExistingVersion`.
+  Los registros con marcas de tiempo que se encuentran fuera del periodo de retención del almacén de memoria. 
**nota**  
Cuando se actualice la ventana de retención, recibirá una excepción `RejectedRecords` si intenta ingerir datos de inmediato dentro de la nueva ventana. Para evitar una excepción `RejectedRecords`, espere hasta que finalice la nueva ventana para ingerir datos nuevos. Para obtener más información, consulte [Prácticas recomendadas para configurar Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/best-practices.html#configuration) y [la explicación sobre cómo funciona el almacenamiento en Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/storage.html).
+  Los registros con dimensiones o medidas que superan los límites definidos por Timestream. 
 Para obtener más información, consulte [Access Management](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) en la Guía del desarrollador de Timestream.   
Tipo: cadena  
Requerido: no

 ** RecordIndex **   <a name="timestream-Type-RejectedRecord-RecordIndex"></a>
 El índice del registro en la solicitud de entrada de WriteRecords. Los índices comienzan con 0.   
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_RejectedRecord_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RejectedRecord) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RejectedRecord) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RejectedRecord) 

# ReportConfiguration
<a name="API_ReportConfiguration"></a>

Informe de la configuración de una tarea de carga por lotes. Contiene información sobre dónde se almacenan los informes de errores.

## Contenido
<a name="API_ReportConfiguration_Contents"></a>

 ** ReportS3Configuration **   <a name="timestream-Type-ReportConfiguration-ReportS3Configuration"></a>
La configuración de una ubicación de S3 en la que se escriben los informes y los eventos de errores para una carga por lotes.  
Tipo: objeto [ReportS3Configuration](API_ReportS3Configuration.md)  
Obligatorio: no

## Véase también
<a name="API_ReportConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportConfiguration) 

# ReportS3Configuration
<a name="API_ReportS3Configuration"></a>



## Contenido
<a name="API_ReportS3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-ReportS3Configuration-BucketName"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 63 caracteres.  
Patrón: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Obligatorio: sí

 ** EncryptionOption **   <a name="timestream-Type-ReportS3Configuration-EncryptionOption"></a>
  
Tipo: cadena  
Valores válidos: `SSE_S3 | SSE_KMS`   
Obligatorio: no

 ** KmsKeyId **   <a name="timestream-Type-ReportS3Configuration-KmsKeyId"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** ObjectKeyPrefix **   <a name="timestream-Type-ReportS3Configuration-ObjectKeyPrefix"></a>
  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 928 caracteres.  
Patrón: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obligatorio: no

## Véase también
<a name="API_ReportS3Configuration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportS3Configuration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportS3Configuration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportS3Configuration) 

# RetentionProperties
<a name="API_RetentionProperties"></a>

Las propiedades de retención contienen el tiempo durante el cual los datos de serie temporal deben almacenarse en el almacén magnético y en el almacén de memoria. 

## Contenido
<a name="API_RetentionProperties_Contents"></a>

 ** MagneticStoreRetentionPeriodInDays **   <a name="timestream-Type-RetentionProperties-MagneticStoreRetentionPeriodInDays"></a>
El tiempo durante el que deben almacenarse los datos en el almacén magnético.   
Tipo: Long  
Rango válido: valor mínimo de 1. Valor máximo de 73000.  
Obligatorio: sí

 ** MemoryStoreRetentionPeriodInHours **   <a name="timestream-Type-RetentionProperties-MemoryStoreRetentionPeriodInHours"></a>
El tiempo durante el que deben almacenarse los datos en el almacén de memoria.   
Tipo: Long  
Rango válido: valor mínimo de 1. Valor máximo de 8766.  
Obligatorio: sí

## Véase también
<a name="API_RetentionProperties_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RetentionProperties) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RetentionProperties) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RetentionProperties) 

# S3Configuration
<a name="API_S3Configuration"></a>

La configuración que especifica una ubicación de S3.

## Contenido
<a name="API_S3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-S3Configuration-BucketName"></a>
El nombre del bucket de S3 del cliente.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 63 caracteres.  
Patrón: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Obligatorio: no

 ** EncryptionOption **   <a name="timestream-Type-S3Configuration-EncryptionOption"></a>
La opción de cifrado de la ubicación de S3 del cliente. Las opciones son el cifrado del lado del servidor de S3 con una clave administrada S3 o una clave administrada por AWS.  
Tipo: cadena  
Valores válidos: `SSE_S3 | SSE_KMS`   
Obligatorio: no

 ** KmsKeyId **   <a name="timestream-Type-S3Configuration-KmsKeyId"></a>
El ID de clave de AWS KMS de la ubicación S3 del cliente cuando se cifra con una clave administrada por AWS.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** ObjectKeyPrefix **   <a name="timestream-Type-S3Configuration-ObjectKeyPrefix"></a>
La vista previa de la clave de objeto para la ubicación de S3 del cliente.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 928 caracteres.  
Patrón: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obligatorio: no

## Véase también
<a name="API_S3Configuration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/S3Configuration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/S3Configuration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/S3Configuration) 

# Schema
<a name="API_Schema"></a>

 Un esquema especifico el modelo de datos esperado de la tabla. 

## Contenido
<a name="API_Schema_Contents"></a>

 ** CompositePartitionKey **   <a name="timestream-Type-Schema-CompositePartitionKey"></a>
Una lista no vacía de claves de partición que definen los atributos que se utilizan para particionar los datos de la tabla. El orden de la lista determina la jerarquía de las particiones. El nombre y el tipo de cada clave de partición, así como el orden de las claves de partición, no pueden cambiarse una vez que se creó la tabla. Sin embargo, puede cambiarse el nivel de cumplimiento de cada clave de partición.   
Tipo: Matriz de [PartitionKey](API_PartitionKey.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo.  
Obligatorio: no

## Véase también
<a name="API_Schema_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Schema) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Schema) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Schema) 

# Table
<a name="API_Table"></a>

Representa una tabla de base de datos en Timestream. Las tablas contienen una o más series temporales relacionadas. Puede modificar la duración de la retención del almacén de memoria y el almacén magnético para una tabla. 

## Contenido
<a name="API_Table_Contents"></a>

 ** Arn **   <a name="timestream-Type-Table-Arn"></a>
El nombre del recurso de Amazon que identifica de manera exclusiva a esta tabla.  
Tipo: cadena  
Requerido: no

 ** CreationTime **   <a name="timestream-Type-Table-CreationTime"></a>
La hora en la que se creó la tabla de Timestream.   
Tipo: marca temporal  
Obligatorio: no

 ** DatabaseName **   <a name="timestream-Type-Table-DatabaseName"></a>
Nombre de la base de datos de Timestream que contiene esta tabla.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** LastUpdatedTime **   <a name="timestream-Type-Table-LastUpdatedTime"></a>
La hora en la que se actualizó por última vez la tabla de Timestream.  
Tipo: marca temporal  
Obligatorio: no

 ** MagneticStoreWriteProperties **   <a name="timestream-Type-Table-MagneticStoreWriteProperties"></a>
Contiene las propiedades que se tienen que establecer en la tabla cuando se habilitan las escrituras en el almacén magnético.  
Tipo: objeto [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)  
Obligatorio: no

 ** RetentionProperties **   <a name="timestream-Type-Table-RetentionProperties"></a>
Duración de la retención del almacén de memoria y el almacén magnético.  
Tipo: objeto [RetentionProperties](API_RetentionProperties.md)  
Obligatorio: no

 ** Schema **   <a name="timestream-Type-Table-Schema"></a>
 El esquema de la tabla.   
Tipo: objeto [Schema](API_Schema.md)  
Obligatorio: no

 ** TableName **   <a name="timestream-Type-Table-TableName"></a>
Nombre de la tabla de Timestream.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** TableStatus **   <a name="timestream-Type-Table-TableStatus"></a>
El estado actual de la tabla:  
+  `DELETING`: se está eliminando la tabla.
+  `ACTIVE`: ya se puede utilizar la tabla.
Tipo: cadena  
Valores válidos: `ACTIVE | DELETING | RESTORING`   
Obligatorio: no

## Véase también
<a name="API_Table_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Table) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Table) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Table) 

# Tag
<a name="API_Tag"></a>

 Una etiqueta es una marca que se asigna a una base de datos o tabla de Timestream. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario. Con las etiquetas, puede clasificar las bases de datos o las tablas según, por ejemplo, su finalidad, propietario o entorno. 

## Contenido
<a name="API_Tag_Contents"></a>

 ** Key **   <a name="timestream-Type-Tag-Key"></a>
 La clave de la etiqueta. Las claves de etiqueta distinguen entre mayúsculas y minúsculas.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128 caracteres.  
Obligatorio: sí

 ** Value **   <a name="timestream-Type-Tag-Value"></a>
 El valor de la etiqueta. Los valores de etiquetas distinguen entre mayúsculas y minúsculas y pueden ser nulos.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

## Véase también
<a name="API_Tag_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Tag) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Tag) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Tag) 

# Consulta de Amazon Timestream
<a name="API_Types_Amazon_Timestream_Query"></a>

La consulta de Amazon Timestream admite los siguientes tipos de datos:
+  [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) 
+  [ColumnInfo](API_query_ColumnInfo.md) 
+  [Datum](API_query_Datum.md) 
+  [DimensionMapping](API_query_DimensionMapping.md) 
+  [Endpoint](API_query_Endpoint.md) 
+  [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) 
+  [ErrorReportLocation](API_query_ErrorReportLocation.md) 
+  [ExecutionStats](API_query_ExecutionStats.md) 
+  [LastUpdate](API_query_LastUpdate.md) 
+  [MixedMeasureMapping](API_query_MixedMeasureMapping.md) 
+  [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) 
+  [MultiMeasureMappings](API_query_MultiMeasureMappings.md) 
+  [NotificationConfiguration](API_query_NotificationConfiguration.md) 
+  [ParameterMapping](API_query_ParameterMapping.md) 
+  [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) 
+  [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) 
+  [QueryComputeRequest](API_query_QueryComputeRequest.md) 
+  [QueryComputeResponse](API_query_QueryComputeResponse.md) 
+  [QueryInsights](API_query_QueryInsights.md) 
+  [QueryInsightsResponse](API_query_QueryInsightsResponse.md) 
+  [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) 
+  [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) 
+  [QueryStatus](API_query_QueryStatus.md) 
+  [QueryTemporalRange](API_query_QueryTemporalRange.md) 
+  [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) 
+  [Row](API_query_Row.md) 
+  [S3Configuration](API_query_S3Configuration.md) 
+  [S3ReportLocation](API_query_S3ReportLocation.md) 
+  [ScheduleConfiguration](API_query_ScheduleConfiguration.md) 
+  [ScheduledQuery](API_query_ScheduledQuery.md) 
+  [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) 
+  [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) 
+  [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) 
+  [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) 
+  [SelectColumn](API_query_SelectColumn.md) 
+  [SnsConfiguration](API_query_SnsConfiguration.md) 
+  [Tag](API_query_Tag.md) 
+  [TargetConfiguration](API_query_TargetConfiguration.md) 
+  [TargetDestination](API_query_TargetDestination.md) 
+  [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) 
+  [TimestreamConfiguration](API_query_TimestreamConfiguration.md) 
+  [TimestreamDestination](API_query_TimestreamDestination.md) 
+  [Type](API_query_Type.md) 

# AccountSettingsNotificationConfiguration
<a name="API_query_AccountSettingsNotificationConfiguration"></a>

Ajustes de configuración para las notificaciones relacionadas con la configuración de la cuenta.

## Contenido
<a name="API_query_AccountSettingsNotificationConfiguration_Contents"></a>

 ** RoleArn **   <a name="timestream-Type-query_AccountSettingsNotificationConfiguration-RoleArn"></a>
Un nombre de recurso de Amazon (ARN) que concede permiso a Timestream para publicar las notificaciones. Este campo solo es visible si se brinda el tema del SNS al actualizar la configuración de la cuenta.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

 ** SnsConfiguration **   <a name="timestream-Type-query_AccountSettingsNotificationConfiguration-SnsConfiguration"></a>
Detalles sobre SNS que se requieren para enviar la notificación.  
Tipo: objeto [SnsConfiguration](API_query_SnsConfiguration.md)  
Obligatorio: no

## Véase también
<a name="API_query_AccountSettingsNotificationConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) 

# ColumnInfo
<a name="API_query_ColumnInfo"></a>

 Contiene los metadatos de los resultados de las consultas, como los nombres de las columnas, los tipos de datos y otros atributos. 

## Contenido
<a name="API_query_ColumnInfo_Contents"></a>

 ** Type **   <a name="timestream-Type-query_ColumnInfo-Type"></a>
El tipo de datos de la columna del conjunto de datos. El tipo de datos puede ser escalar o complejo. Los tipos de datos escalares son enteros, cadenas, dobles, booleanos y otros. Los tipos de datos complejos son tipos como matrices, filas y otros.   
Tipo: objeto [Type](API_query_Type.md)  
Obligatorio: sí

 ** Name **   <a name="timestream-Type-query_ColumnInfo-Name"></a>
 El nombre de la columna del conjunto de resultados. El nombre del conjunto de resultados está disponible para las columnas de todos los tipos de datos, salvo para las matrices.   
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_query_ColumnInfo_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ColumnInfo) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ColumnInfo) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ColumnInfo) 

# Datum
<a name="API_query_Datum"></a>

 El Datum representa un único punto de datos en el resultado de una consulta. 

## Contenido
<a name="API_query_Datum_Contents"></a>

 ** ArrayValue **   <a name="timestream-Type-query_Datum-ArrayValue"></a>
 Indica si el punto de los datos es una matriz.   
Tipo: matriz de objetos [Datum](#API_query_Datum)  
Obligatorio: no

 ** NullValue **   <a name="timestream-Type-query_Datum-NullValue"></a>
 Indica si el punto de los datos es nulo.   
Tipo: Booleano  
Obligatorio: no

 ** RowValue **   <a name="timestream-Type-query_Datum-RowValue"></a>
 Indica si el punto de los datos es una fila.   
Tipo: objeto [Row](API_query_Row.md)  
Obligatorio: no

 ** ScalarValue **   <a name="timestream-Type-query_Datum-ScalarValue"></a>
 Indica si el punto de datos es un valor escalar, como entero, cadena, doble o booleano.   
Tipo: cadena  
Requerido: no

 ** TimeSeriesValue **   <a name="timestream-Type-query_Datum-TimeSeriesValue"></a>
 Indica si el punto de datos es un tipo de datos de serie temporal.   
Tipo: matriz de objetos [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md)  
Obligatorio: no

## Véase también
<a name="API_query_Datum_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Datum) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Datum) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Datum) 

# DimensionMapping
<a name="API_query_DimensionMapping"></a>

Este tipo se utiliza para asignar columnas del resultado de la consulta a una dimensión de la tabla de destino.

## Contenido
<a name="API_query_DimensionMapping_Contents"></a>

 ** DimensionValueType **   <a name="timestream-Type-query_DimensionMapping-DimensionValueType"></a>
Tipo para la dimensión.   
Tipo: cadena  
Valores válidos: `VARCHAR`   
Obligatorio: sí

 ** Name **   <a name="timestream-Type-query_DimensionMapping-Name"></a>
Nombre de la columna del resultado de la consulta.  
Tipo: cadena  
Obligatorio: sí

## Véase también
<a name="API_query_DimensionMapping_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DimensionMapping) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DimensionMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DimensionMapping) 

# Endpoint
<a name="API_query_Endpoint"></a>

Representa un punto de conexión disponible contra el que realizar llamadas a la API, así como el TTL de ese punto de conexión.

## Contenido
<a name="API_query_Endpoint_Contents"></a>

 ** Address **   <a name="timestream-Type-query_Endpoint-Address"></a>
Una dirección del punto de conexión.  
Tipo: cadena  
Obligatorio: sí

 ** CachePeriodInMinutes **   <a name="timestream-Type-query_Endpoint-CachePeriodInMinutes"></a>
El TTL del punto de conexión, en minutos.  
Tipo: Long  
Obligatorio: sí

## Véase también
<a name="API_query_Endpoint_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Endpoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Endpoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Endpoint) 

# ErrorReportConfiguration
<a name="API_query_ErrorReportConfiguration"></a>

Se requiere configuración para los informes de error.

## Contenido
<a name="API_query_ErrorReportConfiguration_Contents"></a>

 ** S3Configuration **   <a name="timestream-Type-query_ErrorReportConfiguration-S3Configuration"></a>
La configuración del S3 para los informes de error.  
Tipo: objeto [S3Configuration](API_query_S3Configuration.md)  
Obligatorio: sí

## Véase también
<a name="API_query_ErrorReportConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportConfiguration) 

# ErrorReportLocation
<a name="API_query_ErrorReportLocation"></a>

Contiene la ubicación del informe de errores de una única llamada de consulta programada. 

## Contenido
<a name="API_query_ErrorReportLocation_Contents"></a>

 ** S3ReportLocation **   <a name="timestream-Type-query_ErrorReportLocation-S3ReportLocation"></a>
La ubicación de S3 donde se escriben los informes de errores.  
Tipo: objeto [S3ReportLocation](API_query_S3ReportLocation.md)  
Obligatorio: no

## Véase también
<a name="API_query_ErrorReportLocation_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportLocation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportLocation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportLocation) 

# ExecutionStats
<a name="API_query_ExecutionStats"></a>

Estadísticas de una sola ejecución de la consulta programada.

## Contenido
<a name="API_query_ExecutionStats_Contents"></a>

 ** BytesMetered **   <a name="timestream-Type-query_ExecutionStats-BytesMetered"></a>
Bytes que se midieron para una sola ejecución de consulta programada.  
Tipo: Long  
Obligatorio: no

 ** CumulativeBytesScanned **   <a name="timestream-Type-query_ExecutionStats-CumulativeBytesScanned"></a>
Bytes que se escanearon para una sola ejecución de consulta programada.  
Tipo: Long  
Obligatorio: no

 ** DataWrites **   <a name="timestream-Type-query_ExecutionStats-DataWrites"></a>
Las escrituras de datos se miden para los registros ingeridos en una sola ejecución de consulta programada.  
Tipo: Long  
Obligatorio: no

 ** ExecutionTimeInMillis **   <a name="timestream-Type-query_ExecutionStats-ExecutionTimeInMillis"></a>
Tiempo total, medido en milisegundos, que se necesitó para completar la ejecución de la consulta programada.  
Tipo: Long  
Obligatorio: no

 ** QueryResultRows **   <a name="timestream-Type-query_ExecutionStats-QueryResultRows"></a>
Cantidad de filas presentes en el resultado de ejecutar una consulta antes de transferirla al origen de datos de destino.  
Tipo: Long  
Obligatorio: no

 ** RecordsIngested **   <a name="timestream-Type-query_ExecutionStats-RecordsIngested"></a>
La cantidad de registros ingeridos para una sola ejecución de consulta programada.   
Tipo: Long  
Obligatorio: no

## Véase también
<a name="API_query_ExecutionStats_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecutionStats) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecutionStats) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecutionStats) 

# LastUpdate
<a name="API_query_LastUpdate"></a>

Objeto de configuración que contiene la actualización más reciente de la configuración de la cuenta, visible solo si la configuración se actualizó previamente.

## Contenido
<a name="API_query_LastUpdate_Contents"></a>

 ** Status **   <a name="timestream-Type-query_LastUpdate-Status"></a>
El estado de la última actualización. Puede ser `PENDING`, `FAILED` o `SUCCEEDED`.  
Tipo: cadena  
Valores válidos: `PENDING | FAILED | SUCCEEDED`   
Obligatorio: no

 ** StatusMessage **   <a name="timestream-Type-query_LastUpdate-StatusMessage"></a>
Mensaje de error que describe el estado de la última actualización de la configuración de la cuenta, visible solo si se produjo un error.  
Tipo: cadena  
Requerido: no

 ** TargetQueryTCU **   <a name="timestream-Type-query_LastUpdate-TargetQueryTCU"></a>
La cantidad de TimeStream Compute Units (TCU, unidades de cómputo de Timestream) solicitadas en la última actualización de la configuración de la cuenta.  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_query_LastUpdate_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/LastUpdate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/LastUpdate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/LastUpdate) 

# MixedMeasureMapping
<a name="API_query_MixedMeasureMapping"></a>

Los MixedMeasureMappings son asignaciones que se pueden utilizar para ingerir datos en una mezcla de medidas estrechas y múltiples en la tabla derivada.

## Contenido
<a name="API_query_MixedMeasureMapping_Contents"></a>

 ** MeasureValueType **   <a name="timestream-Type-query_MixedMeasureMapping-MeasureValueType"></a>
Tipo del valor que se va a leer de sourceColumn. Si la asignación es para MULTI, utilice MeasureValueType.MULTI.  
Tipo: cadena  
Valores válidos: `BIGINT | BOOLEAN | DOUBLE | VARCHAR | MULTI`   
Obligatorio: sí

 ** MeasureName **   <a name="timestream-Type-query_MixedMeasureMapping-MeasureName"></a>
Se refiere al valor de measure\$1name en una fila de resultados. Este campo es obligatorio si se proporciona MeasureNameColumn.  
Tipo: cadena  
Requerido: no

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-query_MixedMeasureMapping-MultiMeasureAttributeMappings"></a>
Obligatorio cuando measureValueType es MULTI. Asignaciones de atributos para medidas de valor MULTI.  
Tipo: Matriz de [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo.  
Obligatorio: no

 ** SourceColumn **   <a name="timestream-Type-query_MixedMeasureMapping-SourceColumn"></a>
Este campo se refiere a la columna de origen de la que debe leerse el valor de la medida para la materialización del resultado.  
Tipo: cadena  
Requerido: no

 ** TargetMeasureName **   <a name="timestream-Type-query_MixedMeasureMapping-TargetMeasureName"></a>
Nombre de la medida objetivo que se va a utilizar. Si no se proporciona, el nombre de la medida objetivo de forma predeterminada sería measure-name si se proporciona, o SourceColumn en caso contrario.   
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_query_MixedMeasureMapping_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MixedMeasureMapping) 

# MultiMeasureAttributeMapping
<a name="API_query_MultiMeasureAttributeMapping"></a>

Asignación de atributos para medidas de valores MULTI.

## Contenido
<a name="API_query_MultiMeasureAttributeMapping_Contents"></a>

 ** MeasureValueType **   <a name="timestream-Type-query_MultiMeasureAttributeMapping-MeasureValueType"></a>
Tipo de atributo que se va a leer de la columna de origen.  
Tipo: cadena  
Valores válidos: `BIGINT | BOOLEAN | DOUBLE | VARCHAR | TIMESTAMP`   
Obligatorio: sí

 ** SourceColumn **   <a name="timestream-Type-query_MultiMeasureAttributeMapping-SourceColumn"></a>
Columna de origen de la que se va a leer el valor del atributo.  
Tipo: cadena  
Obligatorio: sí

 ** TargetMultiMeasureAttributeName **   <a name="timestream-Type-query_MultiMeasureAttributeMapping-TargetMultiMeasureAttributeName"></a>
Nombre personalizado que se utilizará para el nombre del atributo en la tabla derivada. Si no se proporciona, se utilizará el nombre de la columna de origen.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_query_MultiMeasureAttributeMapping_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureAttributeMapping) 

# MultiMeasureMappings
<a name="API_query_MultiMeasureMappings"></a>

Solo se debe proporcionar uno de los MixedMeasureMappings o MultiMeasureMappings. Los MultiMeasureMappings se pueden utilizar para ingerir los datos como medidas múltiples en la tabla derivada.

## Contenido
<a name="API_query_MultiMeasureMappings_Contents"></a>

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-query_MultiMeasureMappings-MultiMeasureAttributeMappings"></a>
Obligatorio. Mapeos de atributos que se utilizarán para asignar los resultados de la consulta a los datos de ingesta para los atributos multimedida.  
Tipo: Matriz de [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo.  
Obligatorio: sí

 ** TargetMultiMeasureName **   <a name="timestream-Type-query_MultiMeasureMappings-TargetMultiMeasureName"></a>
El nombre de la medida múltiple objetivo en la tabla derivada. Esta entrada es necesaria cuando no se proporciona measureNameColumn. Si se proporciona MeasureNameColumn, se utilizará el valor de esa columna como nombre de la multimedida.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_query_MultiMeasureMappings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureMappings) 

# NotificationConfiguration
<a name="API_query_NotificationConfiguration"></a>

Configuración de notificaciones para una consulta programada. Timestream envía una notificación cuando se crea una consulta programada, se actualiza su estado o se elimina. 

## Contenido
<a name="API_query_NotificationConfiguration_Contents"></a>

 ** SnsConfiguration **   <a name="timestream-Type-query_NotificationConfiguration-SnsConfiguration"></a>
Información sobre la configuración de Amazon Simple Notification Service (SNS). Este campo solo es visible cuando se brinda el tema del SNS al actualizar la configuración de la cuenta.   
Tipo: objeto [SnsConfiguration](API_query_SnsConfiguration.md)  
Obligatorio: sí

## Véase también
<a name="API_query_NotificationConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/NotificationConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/NotificationConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/NotificationConfiguration) 

# ParameterMapping
<a name="API_query_ParameterMapping"></a>

Mapeo de los parámetros con nombre.

## Contenido
<a name="API_query_ParameterMapping_Contents"></a>

 ** Name **   <a name="timestream-Type-query_ParameterMapping-Name"></a>
Nombre del parámetro.  
Tipo: cadena  
Obligatorio: sí

 ** Type **   <a name="timestream-Type-query_ParameterMapping-Type"></a>
Contiene el tipo de datos de una columna de un conjunto de resultados de la consulta. El tipo de datos puede ser escalar o complejo. Los tipos de datos escalares admitidos son enteros, booleanos, cadena, dobles, marca de tiempo, fecha, hora e intervalos. Los tipos de datos complejos admitidos son matrices, filas y series temporales.  
Tipo: objeto [Type](API_query_Type.md)  
Obligatorio: sí

## Véase también
<a name="API_query_ParameterMapping_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ParameterMapping) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ParameterMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ParameterMapping) 

# ProvisionedCapacityRequest
<a name="API_query_ProvisionedCapacityRequest"></a>

Una solicitud para actualizar la configuración de la capacidad aprovisionada para consultar los datos.

## Contenido
<a name="API_query_ProvisionedCapacityRequest_Contents"></a>

 ** TargetQueryTCU **   <a name="timestream-Type-query_ProvisionedCapacityRequest-TargetQueryTCU"></a>
La capacidad de cómputo objetivo para consultar datos, especificada en Timestream Compute Units (TCU, unidades de cómputo de Timestream).  
Tipo: número entero  
Obligatorio: sí

 ** NotificationConfiguration **   <a name="timestream-Type-query_ProvisionedCapacityRequest-NotificationConfiguration"></a>
Parámetros de configuración para las notificaciones relacionadas con la actualización de la capacidad aprovisionada.  
Tipo: objeto [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md)  
Obligatorio: no

## Véase también
<a name="API_query_ProvisionedCapacityRequest_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityRequest) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityRequest) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityRequest) 

# ProvisionedCapacityResponse
<a name="API_query_ProvisionedCapacityResponse"></a>

La respuesta a una solicitud para actualizar la configuración de la capacidad aprovisionada para consultar los datos.

## Contenido
<a name="API_query_ProvisionedCapacityResponse_Contents"></a>

 ** ActiveQueryTCU **   <a name="timestream-Type-query_ProvisionedCapacityResponse-ActiveQueryTCU"></a>
La cantidad de Timestream Compute Units (TCU, unidades de cómputo de Timestream) aprovisionadas en la cuenta. Este campo solo está visible cuando el modo de cómputo es `PROVISIONED`.  
Tipo: entero  
Obligatorio: no

 ** LastUpdate **   <a name="timestream-Type-query_ProvisionedCapacityResponse-LastUpdate"></a>
Información sobre la última actualización de la configuración de capacidad aprovisionada.  
Tipo: objeto [LastUpdate](API_query_LastUpdate.md)  
Obligatorio: no

 ** NotificationConfiguration **   <a name="timestream-Type-query_ProvisionedCapacityResponse-NotificationConfiguration"></a>
Un objeto que contiene la configuración de las notificaciones que se envían cada vez que se modifica la configuración de la capacidad aprovisionada. Este campo solo está visible cuando el modo de cómputo es `PROVISIONED`.  
Tipo: objeto [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md)  
Obligatorio: no

## Véase también
<a name="API_query_ProvisionedCapacityResponse_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityResponse) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityResponse) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityResponse) 

# QueryComputeRequest
<a name="API_query_QueryComputeRequest"></a>

Una solicitud para recuperar o actualizar la configuración de la capacidad de cómputo para consultar los datos. QueryCompute está disponible solo en la región Asia Pacífico (Mumbai).

## Contenido
<a name="API_query_QueryComputeRequest_Contents"></a>

 ** ComputeMode **   <a name="timestream-Type-query_QueryComputeRequest-ComputeMode"></a>
El modo en el que las Timestream Compute Units (TCU, unidades de cómputo de Timestream) se asignan y utilizan en una cuenta. Tenga en cuenta que en la región Asia-Pacífico (Mumbai), la operación de la API solo reconoce el valor `PROVISIONED`. QueryCompute está disponible solo en la región Asia Pacífico (Mumbai).  
Tipo: cadena  
Valores válidos: `ON_DEMAND | PROVISIONED`   
Obligatorio: no

 ** ProvisionedCapacity **   <a name="timestream-Type-query_QueryComputeRequest-ProvisionedCapacity"></a>
Objeto de configuración que contiene los ajustes de las Timestream Compute Units (TCU) aprovisionadas en la cuenta. QueryCompute está disponible solo en la región Asia Pacífico (Mumbai).  
Tipo: objeto [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md)  
Obligatorio: no

## Véase también
<a name="API_query_QueryComputeRequest_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeRequest) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeRequest) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeRequest) 

# QueryComputeResponse
<a name="API_query_QueryComputeResponse"></a>

La respuesta a una solicitud para recuperar o actualizar la configuración de la capacidad de cómputo para consultar los datos. QueryCompute está disponible solo en la región Asia Pacífico (Mumbai).

## Contenido
<a name="API_query_QueryComputeResponse_Contents"></a>

 ** ComputeMode **   <a name="timestream-Type-query_QueryComputeResponse-ComputeMode"></a>
El modo en el que las Timestream Compute Units (TCU, unidades de cómputo de Timestream) se asignan y utilizan en una cuenta. Tenga en cuenta que en la región Asia-Pacífico (Mumbai), la operación de la API solo reconoce el valor `PROVISIONED`. QueryCompute está disponible solo en la región Asia Pacífico (Mumbai).  
Tipo: cadena  
Valores válidos: `ON_DEMAND | PROVISIONED`   
Obligatorio: no

 ** ProvisionedCapacity **   <a name="timestream-Type-query_QueryComputeResponse-ProvisionedCapacity"></a>
Objeto de configuración que contiene los ajustes de las Timestream Compute Units (TCU) aprovisionadas en la cuenta. QueryCompute está disponible solo en la región Asia Pacífico (Mumbai).  
Tipo: objeto [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md)  
Obligatorio: no

## Véase también
<a name="API_query_QueryComputeResponse_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeResponse) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeResponse) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeResponse) 

# QueryInsights
<a name="API_query_QueryInsights"></a>

 `QueryInsights` es una característica de ajuste del rendimiento que le ayuda a optimizar las consultas, reducir los costos y mejorar el rendimiento. Con `QueryInsights`, puede evaluar la eficiencia de reducción de las consultas e identificar las áreas de mejora para mejorar el rendimiento de las consultas. Además, con `QueryInsights` puede analizar la eficacia de las consultas en términos de reducción basada en tiempo y en atributos, e identificar oportunidades para mejorar el rendimiento. En concreto, puede evaluar en qué medida en las consultas se utilizan las estrategias de indexación basadas en el tiempo y en las claves de partición para optimizar la recuperación de datos. A fin de optimizar el rendimiento de las consultas, es esencial refinar los parámetros temporales y espaciales que rigen la ejecución de las consultas.

Las métricas clave que ofrece `QueryInsights` son `QuerySpatialCoverage` y `QueryTemporalRange`. `QuerySpatialCoverage` indica qué parte del eje espacial explora la consulta; los valores más bajos son más eficientes. `QueryTemporalRange` muestra el intervalo de tiempo escaneado, en el que los intervalos más estrechos ofrecen un mejor rendimiento.

 **Ventajas de QueryInsights** 

A continuación, se describen los beneficios de la clave de usar `QueryInsights`:
+  **Identificación de consultas ineficientes**: `QueryInsights` ofrece información sobre la reducción basada en tiempo y en atributos de las tablas a las que accede la consulta. Esta información le permitirá identificar las tablas a las que se accede de manera subóptima.
+  **Optimización del modelo de datos y el particionamiento**: puede usar la información de `QueryInsights` para acceder al modelo de datos y la estrategia de particionamiento y refinarlos.
+  **Ajuste de las consultas**: la `QueryInsights` destaca las oportunidades para usar los índices de forma más eficaz.

**nota**  
La cantidad máxima de solicitudes a la API de `Query` que puede realizar con la opción `QueryInsights` habilitada es de 1 consulta por segundo (QPS). Si supera esta tasa de consultas, es posible que se produzcan limitaciones.

## Contenido
<a name="API_query_QueryInsights_Contents"></a>

 ** Mode **   <a name="timestream-Type-query_QueryInsights-Mode"></a>
Ofrece los siguientes modos para habilitar `QueryInsights`:  
+  `ENABLED_WITH_RATE_CONTROL`: habilita `QueryInsights` para el procesamiento de las consultas. Este modo también incluye un mecanismo de control de tasas, que limita la característica `QueryInsights` a 1 consulta por segundo (QPS).
+  `DISABLED`: deshabilita `QueryInsights`.
Tipo: cadena  
Valores válidos: `ENABLED_WITH_RATE_CONTROL | DISABLED`   
Obligatorio: sí

## Véase también
<a name="API_query_QueryInsights_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsights) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsights) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsights) 

# QueryInsightsResponse
<a name="API_query_QueryInsightsResponse"></a>

Ofrece distinta información y métricas relacionadas con la consulta que ejecutó.

## Contenido
<a name="API_query_QueryInsightsResponse_Contents"></a>

 ** OutputBytes **   <a name="timestream-Type-query_QueryInsightsResponse-OutputBytes"></a>
Indica el tamaño del conjunto de resultados de la consulta en bytes. Puede utilizar estos datos para validar si el conjunto de resultados cambió como parte del ejercicio de ajuste de la consulta.  
Tipo: Long  
Obligatorio: no

 ** OutputRows **   <a name="timestream-Type-query_QueryInsightsResponse-OutputRows"></a>
Indica la cantidad total de filas que se muestran como parte del conjunto de resultados de la consulta. Puede utilizar estos datos para validar si la cantidad de filas en el conjunto de resultados cambió como parte del ejercicio de ajuste de la consulta.  
Tipo: Long  
Obligatorio: no

 ** QuerySpatialCoverage **   <a name="timestream-Type-query_QueryInsightsResponse-QuerySpatialCoverage"></a>
Ofrece información sobre la cobertura espacial de la consulta, incluida la tabla con una reducción espacial subóptima (máxima). Esta información puede ayudarlo a identificar las áreas que deben mejorarse en su estrategia de partición para mejorar la reducción espacial.   
Tipo: objeto [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md)  
Obligatorio: no

 ** QueryTableCount **   <a name="timestream-Type-query_QueryInsightsResponse-QueryTableCount"></a>
Indica la cantidad de tablas de la consulta.  
Tipo: Long  
Obligatorio: no

 ** QueryTemporalRange **   <a name="timestream-Type-query_QueryInsightsResponse-QueryTemporalRange"></a>
Ofrece información sobre el rango temporal de la consulta, incluida la tabla con el rango de tiempo más grande (máximo). A continuación, encontrará algunas de las posibles opciones para optimizar la reducción en función del tiempo:  
+ Agregue los predicados temporales que faltan.
+ Elimine las funciones en torno a los predicados de tiempo.
+ Agregue los predicados de tiempo a todas las subconsultas.
Tipo: objeto [QueryTemporalRange](API_query_QueryTemporalRange.md)  
Obligatorio: no

 ** UnloadPartitionCount **   <a name="timestream-Type-query_QueryInsightsResponse-UnloadPartitionCount"></a>
Indica las particiones que creó la operación `Unload`.  
Tipo: Long  
Obligatorio: no

 ** UnloadWrittenBytes **   <a name="timestream-Type-query_QueryInsightsResponse-UnloadWrittenBytes"></a>
Indica el tamaño, en bytes, escrito por la operación `Unload`.  
Tipo: Long  
Obligatorio: no

 ** UnloadWrittenRows **   <a name="timestream-Type-query_QueryInsightsResponse-UnloadWrittenRows"></a>
Indica las filas escritas por la consulta `Unload`.  
Tipo: Long  
Obligatorio: no

## Véase también
<a name="API_query_QueryInsightsResponse_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsightsResponse) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsightsResponse) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsightsResponse) 

# QuerySpatialCoverage
<a name="API_query_QuerySpatialCoverage"></a>

Ofrece información sobre la cobertura espacial de la consulta, incluida la tabla con una reducción espacial subóptima (máxima). Esta información puede ayudarlo a identificar las áreas que deben mejorarse en su estrategia de partición para mejorar la reducción espacial.

Por ejemplo, puede hacer lo siguiente con la información de `QuerySpatialCoverage`:
+ Agregue measure\$1name o utilice predicados de [clave de partición definida por el cliente](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html) (CDPK).
+ Si ya realizó la acción anterior, elimine las funciones que las rodeen o las cláusulas, como `LIKE`.

## Contenido
<a name="API_query_QuerySpatialCoverage_Contents"></a>

 ** Max **   <a name="timestream-Type-query_QuerySpatialCoverage-Max"></a>
Ofrece información sobre la cobertura espacial de la consulta ejecutada y de la tabla con la reducción espacial más ineficiente.  
+  `Value`: la relación máxima de cobertura espacial.
+  `TableArn`: el nombre de recurso de Amazon (ARN) de la tabla con una reducción de espacio subóptima.
+  `PartitionKey`: la clave de partición utilizada para la partición, que puede ser una `measure_name` predeterminada o una CDPK.
Tipo: objeto [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md)  
Obligatorio: no

## Véase también
<a name="API_query_QuerySpatialCoverage_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverage) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverage) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverage) 

# QuerySpatialCoverageMax
<a name="API_query_QuerySpatialCoverageMax"></a>

Ofrece información sobre la tabla con el rango espacial menos óptimo analizado por la consulta.

## Contenido
<a name="API_query_QuerySpatialCoverageMax_Contents"></a>

 ** PartitionKey **   <a name="timestream-Type-query_QuerySpatialCoverageMax-PartitionKey"></a>
La clave de partición utilizada para la partición, que puede ser una `measure_name` predeterminada o una [clave de partición definida por el cliente](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html).  
Tipo: matriz de cadenas  
Obligatorio: no

 ** TableArn **   <a name="timestream-Type-query_QuerySpatialCoverageMax-TableArn"></a>
El nombre de recurso de Amazon (ARN) de la tabla con la reducción de espacio más subóptima.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** Value **   <a name="timestream-Type-query_QuerySpatialCoverageMax-Value"></a>
La relación máxima de cobertura espacial.  
Tipo: Doble  
Obligatorio: no

## Véase también
<a name="API_query_QuerySpatialCoverageMax_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverageMax) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverageMax) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverageMax) 

# QueryStatus
<a name="API_query_QueryStatus"></a>

Información sobre el estado de la consulta, incluidos el progreso y los bytes que se escanearon.

## Contenido
<a name="API_query_QueryStatus_Contents"></a>

 ** CumulativeBytesMetered **   <a name="timestream-Type-query_QueryStatus-CumulativeBytesMetered"></a>
La cantidad de datos escaneados por la consulta en bytes que se le cobrará. Se trata de una suma acumulada y representa la cantidad total de datos que se le cobrará desde que se inició la consulta. El cargo se aplica una sola vez y se aplica cuando la consulta termina de ejecutarse o cuando se cancela.   
Tipo: Long  
Obligatorio: no

 ** CumulativeBytesScanned **   <a name="timestream-Type-query_QueryStatus-CumulativeBytesScanned"></a>
La cantidad de datos escaneados por la consulta en bytes. Se trata de una suma acumulada y representa la cantidad total de bytes escaneados desde que se inició la consulta.   
Tipo: Long  
Obligatorio: no

 ** ProgressPercentage **   <a name="timestream-Type-query_QueryStatus-ProgressPercentage"></a>
El porcentaje del progreso de la consulta.  
Tipo: Doble  
Obligatorio: no

## Véase también
<a name="API_query_QueryStatus_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryStatus) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryStatus) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryStatus) 

# QueryTemporalRange
<a name="API_query_QueryTemporalRange"></a>

Ofrece información sobre el rango temporal de la consulta, incluida la tabla con el rango de tiempo más grande (máximo).

## Contenido
<a name="API_query_QueryTemporalRange_Contents"></a>

 ** Max **   <a name="timestream-Type-query_QueryTemporalRange-Max"></a>
Encapsula las siguientes propiedades que ofrecen información sobre la tabla de rendimiento menos óptima del eje temporal:  
+  `Value`: la duración máxima en nanosegundos entre el inicio y el final de la consulta.
+  `TableArn`: el nombre de recurso de Amazon (ARN) de la tabla que se consulta con el intervalo de tiempo más amplio.
Tipo: objeto [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md)  
Obligatorio: no

## Véase también
<a name="API_query_QueryTemporalRange_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRange) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRange) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRange) 

# QueryTemporalRangeMax
<a name="API_query_QueryTemporalRangeMax"></a>

Ofrece información sobre la tabla con la reducción de tiempo menos óptima analizada por la consulta.

## Contenido
<a name="API_query_QueryTemporalRangeMax_Contents"></a>

 ** TableArn **   <a name="timestream-Type-query_QueryTemporalRangeMax-TableArn"></a>
El nombre de recurso de Amazon (ARN) de la tabla que se consulta con el intervalo de tiempo más amplio.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** Value **   <a name="timestream-Type-query_QueryTemporalRangeMax-Value"></a>
La duración máxima en nanosegundos entre el inicio y el final de la consulta.  
Tipo: Long  
Obligatorio: no

## Véase también
<a name="API_query_QueryTemporalRangeMax_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRangeMax) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRangeMax) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRangeMax) 

# Row
<a name="API_query_Row"></a>

Representa una sola fila en los resultados de la consulta.

## Contenido
<a name="API_query_Row_Contents"></a>

 ** Data **   <a name="timestream-Type-query_Row-Data"></a>
Lista de puntos de los datos en una sola fila del conjunto de resultados.  
Tipo: matriz de objetos [Datum](API_query_Datum.md)  
Obligatorio: sí

## Véase también
<a name="API_query_Row_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Row) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Row) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Row) 

# S3Configuration
<a name="API_query_S3Configuration"></a>

Detalles sobre la ubicación de S3 para los informes de error que resultan de la puesta en marcha de una consulta. 

## Contenido
<a name="API_query_S3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-query_S3Configuration-BucketName"></a>
 Nombre del bucket de S3 en el que se crearán los informes de error.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 63 caracteres.  
Patrón: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Obligatorio: sí

 ** EncryptionOption **   <a name="timestream-Type-query_S3Configuration-EncryptionOption"></a>
 Opciones de cifrado en reposo para los informes de error. Si no se especifica ninguna opción de cifrado, Timestream elegirá SSE\$1S3 de forma predeterminada.   
Tipo: cadena  
Valores válidos: `SSE_S3 | SSE_KMS`   
Obligatorio: no

 ** ObjectKeyPrefix **   <a name="timestream-Type-query_S3Configuration-ObjectKeyPrefix"></a>
 Prefijo de la clave del informe de error. Timestream añade de forma predeterminada el siguiente prefijo a la ruta del informe de errores.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 896 caracteres.  
Patrón: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obligatorio: no

## Véase también
<a name="API_query_S3Configuration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3Configuration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3Configuration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3Configuration) 

# S3ReportLocation
<a name="API_query_S3ReportLocation"></a>

 Ubicación del informe de S3 para la ejecución de la consulta programada.

## Contenido
<a name="API_query_S3ReportLocation_Contents"></a>

 ** BucketName **   <a name="timestream-Type-query_S3ReportLocation-BucketName"></a>
 Nombre del bucket de S3.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 63 caracteres.  
Patrón: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Obligatorio: no

 ** ObjectKey **   <a name="timestream-Type-query_S3ReportLocation-ObjectKey"></a>
Clave de S3.   
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_query_S3ReportLocation_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3ReportLocation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3ReportLocation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3ReportLocation) 

# ScheduleConfiguration
<a name="API_query_ScheduleConfiguration"></a>

Configuración de la programación de la consulta.

## Contenido
<a name="API_query_ScheduleConfiguration_Contents"></a>

 ** ScheduleExpression **   <a name="timestream-Type-query_ScheduleConfiguration-ScheduleExpression"></a>
Una expresión que denota cuándo activar la puesta en marcha de la consulta programada. Puede ser una expresión de cron o una expresión rate.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

## Véase también
<a name="API_query_ScheduleConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduleConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduleConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduleConfiguration) 

# ScheduledQuery
<a name="API_query_ScheduledQuery"></a>

Consulta programada

## Contenido
<a name="API_query_ScheduledQuery_Contents"></a>

 ** Arn **   <a name="timestream-Type-query_ScheduledQuery-Arn"></a>
El nombre de recurso de Amazon.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

 ** Name **   <a name="timestream-Type-query_ScheduledQuery-Name"></a>
El nombre de la consulta programada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obligatorio: sí

 ** State **   <a name="timestream-Type-query_ScheduledQuery-State"></a>
Estado de la consulta programada.   
Tipo: cadena  
Valores válidos: `ENABLED | DISABLED`   
Obligatorio: sí

 ** CreationTime **   <a name="timestream-Type-query_ScheduledQuery-CreationTime"></a>
La hora de creación de la consulta programada.  
Tipo: marca temporal  
Obligatorio: no

 ** ErrorReportConfiguration **   <a name="timestream-Type-query_ScheduledQuery-ErrorReportConfiguration"></a>
Configuración para los informes de errores de las consultas programadas.  
Tipo: objeto [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Obligatorio: no

 ** LastRunStatus **   <a name="timestream-Type-query_ScheduledQuery-LastRunStatus"></a>
Estado de la última ejecución de la consulta programada.  
Tipo: cadena  
Valores válidos: `AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE`   
Obligatorio: no

 ** NextInvocationTime **   <a name="timestream-Type-query_ScheduledQuery-NextInvocationTime"></a>
La próxima ejecución de la consulta programada.  
Tipo: marca temporal  
Obligatorio: no

 ** PreviousInvocationTime **   <a name="timestream-Type-query_ScheduledQuery-PreviousInvocationTime"></a>
La última ejecución de la consulta programada.  
Tipo: marca temporal  
Obligatorio: no

 ** TargetDestination **   <a name="timestream-Type-query_ScheduledQuery-TargetDestination"></a>
Origen de datos de destino en la que se escribirá el resultado final de la consulta programada.  
Tipo: objeto [TargetDestination](API_query_TargetDestination.md)  
Obligatorio: no

## Véase también
<a name="API_query_ScheduledQuery_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQuery) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQuery) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQuery) 

# ScheduledQueryDescription
<a name="API_query_ScheduledQueryDescription"></a>

Estructura que describe la consulta programada.

## Contenido
<a name="API_query_ScheduledQueryDescription_Contents"></a>

 ** Arn **   <a name="timestream-Type-query_ScheduledQueryDescription-Arn"></a>
ARN de la consulta programada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

 ** Name **   <a name="timestream-Type-query_ScheduledQueryDescription-Name"></a>
Nombre de la consulta programada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obligatorio: sí

 ** NotificationConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-NotificationConfiguration"></a>
Configuración de notificaciones.  
Tipo: objeto [NotificationConfiguration](API_query_NotificationConfiguration.md)  
Obligatorio: sí

 ** QueryString **   <a name="timestream-Type-query_ScheduledQueryDescription-QueryString"></a>
La consulta que se ejecutará.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 262144 caracteres.  
Obligatorio: sí

 ** ScheduleConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-ScheduleConfiguration"></a>
Programar la configuración.  
Tipo: objeto [ScheduleConfiguration](API_query_ScheduleConfiguration.md)  
Obligatorio: sí

 ** State **   <a name="timestream-Type-query_ScheduledQueryDescription-State"></a>
Estado de la consulta programada.   
Tipo: cadena  
Valores válidos: `ENABLED | DISABLED`   
Obligatorio: sí

 ** CreationTime **   <a name="timestream-Type-query_ScheduledQueryDescription-CreationTime"></a>
Hora de creación de la consulta programada.  
Tipo: marca temporal  
Obligatorio: no

 ** ErrorReportConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-ErrorReportConfiguration"></a>
Configuración de informes de errores para las consultas programadas.  
Tipo: objeto [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Obligatorio: no

 ** KmsKeyId **   <a name="timestream-Type-query_ScheduledQueryDescription-KmsKeyId"></a>
Un cliente brindó la clave de KMS que se utilizó para cifrar el recurso de consulta programada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** LastRunSummary **   <a name="timestream-Type-query_ScheduledQueryDescription-LastRunSummary"></a>
Resumen del tiempo de ejecución de la última consulta programada.   
Tipo: objeto [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md)  
Obligatorio: no

 ** NextInvocationTime **   <a name="timestream-Type-query_ScheduledQueryDescription-NextInvocationTime"></a>
La próxima programación para ejecutar la consulta programada.  
Tipo: marca temporal  
Obligatorio: no

 ** PreviousInvocationTime **   <a name="timestream-Type-query_ScheduledQueryDescription-PreviousInvocationTime"></a>
La última vez que se ejecutó la consulta.  
Tipo: marca temporal  
Obligatorio: no

 ** RecentlyFailedRuns **   <a name="timestream-Type-query_ScheduledQueryDescription-RecentlyFailedRuns"></a>
Resumen del tiempo de ejecución de las últimas cinco ejecuciones fallidas de las consultas programadas.  
Tipo: matriz de objetos [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md)  
Obligatorio: no

 ** ScheduledQueryExecutionRoleArn **   <a name="timestream-Type-query_ScheduledQueryDescription-ScheduledQueryExecutionRoleArn"></a>
Rol de IAM que Timestream utiliza para ejecutar la consulta programada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** TargetConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-TargetConfiguration"></a>
Configuración del almacén de destino de la consulta programada.  
Tipo: objeto [TargetConfiguration](API_query_TargetConfiguration.md)  
Obligatorio: no

## Véase también
<a name="API_query_ScheduledQueryDescription_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryDescription) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryDescription) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryDescription) 

# ScheduledQueryInsights
<a name="API_query_ScheduledQueryInsights"></a>

Encapsula la configuración para habilitar `QueryInsights` en una `ExecuteScheduledQueryRequest`.

## Contenido
<a name="API_query_ScheduledQueryInsights_Contents"></a>

 ** Mode **   <a name="timestream-Type-query_ScheduledQueryInsights-Mode"></a>
Ofrece los siguientes modos para habilitar `ScheduledQueryInsights`:  
+  `ENABLED_WITH_RATE_CONTROL`: habilita `ScheduledQueryInsights` para el procesamiento de las consultas. Este modo también incluye un mecanismo de control de tasas, que limita la característica `QueryInsights` a 1 consulta por segundo (QPS).
+  `DISABLED`: deshabilita `ScheduledQueryInsights`.
Tipo: cadena  
Valores válidos: `ENABLED_WITH_RATE_CONTROL | DISABLED`   
Obligatorio: sí

## Véase también
<a name="API_query_ScheduledQueryInsights_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsights) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsights) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsights) 

# ScheduledQueryInsightsResponse
<a name="API_query_ScheduledQueryInsightsResponse"></a>

Ofrece distinta información y métricas relacionadas con la `ExecuteScheduledQueryRequest` que se ejecutó.

## Contenido
<a name="API_query_ScheduledQueryInsightsResponse_Contents"></a>

 ** OutputBytes **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-OutputBytes"></a>
Indica el tamaño del conjunto de resultados de la consulta en bytes. Puede utilizar estos datos para validar si el conjunto de resultados cambió como parte del ejercicio de ajuste de la consulta.  
Tipo: Long  
Obligatorio: no

 ** OutputRows **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-OutputRows"></a>
Indica la cantidad total de filas que se muestran como parte del conjunto de resultados de la consulta. Puede utilizar estos datos para validar si la cantidad de filas en el conjunto de resultados cambió como parte del ejercicio de ajuste de la consulta.  
Tipo: Long  
Obligatorio: no

 ** QuerySpatialCoverage **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-QuerySpatialCoverage"></a>
Ofrece información sobre la cobertura espacial de la consulta, incluida la tabla con una reducción espacial subóptima (máxima). Esta información puede ayudarlo a identificar las áreas que deben mejorarse en su estrategia de partición para mejorar la reducción espacial.  
Tipo: objeto [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md)  
Obligatorio: no

 ** QueryTableCount **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-QueryTableCount"></a>
Indica la cantidad de tablas de la consulta.  
Tipo: Long  
Obligatorio: no

 ** QueryTemporalRange **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-QueryTemporalRange"></a>
Ofrece información sobre el rango temporal de la consulta, incluida la tabla con el rango de tiempo más grande (máximo). A continuación, encontrará algunas de las posibles opciones para optimizar la reducción en función del tiempo:  
+ Agregue los predicados temporales que faltan.
+ Elimine las funciones en torno a los predicados de tiempo.
+ Agregue los predicados de tiempo a todas las subconsultas.
Tipo: objeto [QueryTemporalRange](API_query_QueryTemporalRange.md)  
Obligatorio: no

## Véase también
<a name="API_query_ScheduledQueryInsightsResponse_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) 

# ScheduledQueryRunSummary
<a name="API_query_ScheduledQueryRunSummary"></a>

Ejecutar el resumen de la consulta programada.

## Contenido
<a name="API_query_ScheduledQueryRunSummary_Contents"></a>

 ** ErrorReportLocation **   <a name="timestream-Type-query_ScheduledQueryRunSummary-ErrorReportLocation"></a>
Ubicación de S3 para el informe de errores.  
Tipo: objeto [ErrorReportLocation](API_query_ErrorReportLocation.md)  
Obligatorio: no

 ** ExecutionStats **   <a name="timestream-Type-query_ScheduledQueryRunSummary-ExecutionStats"></a>
Estadísticas de tiempo de ejecución de una ejecución programada.  
Tipo: objeto [ExecutionStats](API_query_ExecutionStats.md)  
Obligatorio: no

 ** FailureReason **   <a name="timestream-Type-query_ScheduledQueryRunSummary-FailureReason"></a>
Mensaje de error para la consulta programada en caso de error. Es posible que tenga que consultar el informe de errores para obtener información más detallada sobre los motivos del error.   
Tipo: cadena  
Requerido: no

 ** InvocationTime **   <a name="timestream-Type-query_ScheduledQueryRunSummary-InvocationTime"></a>
InvocationTime para esta ejecución. Esta es la hora a la que está programada la ejecución de la consulta. El parámetro `@scheduled_runtime` puede utilizarse en la consulta para obtener el valor.   
Tipo: marca temporal  
Obligatorio: no

 ** QueryInsightsResponse **   <a name="timestream-Type-query_ScheduledQueryRunSummary-QueryInsightsResponse"></a>
Ofrece distinta información y métricas relacionadas con el resumen de ejecución de la consulta programada.  
Tipo: objeto [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md)  
Obligatorio: no

 ** RunStatus **   <a name="timestream-Type-query_ScheduledQueryRunSummary-RunStatus"></a>
El estado de la ejecución de la consulta programada.  
Tipo: cadena  
Valores válidos: `AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE`   
Obligatorio: no

 ** TriggerTime **   <a name="timestream-Type-query_ScheduledQueryRunSummary-TriggerTime"></a>
La hora real en la que se ejecutó la consulta.  
Tipo: marca temporal  
Obligatorio: no

## Véase también
<a name="API_query_ScheduledQueryRunSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryRunSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryRunSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryRunSummary) 

# SelectColumn
<a name="API_query_SelectColumn"></a>

Información de la columna que se muestra en la consulta. 

## Contenido
<a name="API_query_SelectColumn_Contents"></a>

 ** Aliased **   <a name="timestream-Type-query_SelectColumn-Aliased"></a>
Verdadero, si la consulta puso un alias al nombre de la columna. De lo contrario, es falso.  
Tipo: Booleano  
Obligatorio: no

 ** DatabaseName **   <a name="timestream-Type-query_SelectColumn-DatabaseName"></a>
 Base de datos que contiene esta columna.  
Tipo: cadena  
Requerido: no

 ** Name **   <a name="timestream-Type-query_SelectColumn-Name"></a>
El nombre de la columna.  
Tipo: cadena  
Requerido: no

 ** TableName **   <a name="timestream-Type-query_SelectColumn-TableName"></a>
Tabla de la base de datos que tiene esta columna.   
Tipo: cadena  
Requerido: no

 ** Type **   <a name="timestream-Type-query_SelectColumn-Type"></a>
Contiene el tipo de datos de una columna de un conjunto de resultados de la consulta. El tipo de datos puede ser escalar o complejo. Los tipos de datos escalares admitidos son enteros, booleanos, cadena, dobles, marca de tiempo, fecha, hora e intervalos. Los tipos de datos complejos admitidos son matrices, filas y series temporales.  
Tipo: objeto [Type](API_query_Type.md)  
Obligatorio: no

## Véase también
<a name="API_query_SelectColumn_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SelectColumn) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SelectColumn) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SelectColumn) 

# SnsConfiguration
<a name="API_query_SnsConfiguration"></a>

Detalles sobre SNS que se requieren para enviar la notificación.

## Contenido
<a name="API_query_SnsConfiguration_Contents"></a>

 ** TopicArn **   <a name="timestream-Type-query_SnsConfiguration-TopicArn"></a>
ARN del tema SNS al que se enviarán las notificaciones del estado de la consulta programada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

## Véase también
<a name="API_query_SnsConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SnsConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SnsConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SnsConfiguration) 

# Tag
<a name="API_query_Tag"></a>

Una etiqueta es una marca que se asigna a una base de datos o tabla de Timestream. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario. Las etiquetas le permiten clasificar las bases de datos o las tablas según, por ejemplo, su finalidad, propietario o entorno. 

## Contenido
<a name="API_query_Tag_Contents"></a>

 ** Key **   <a name="timestream-Type-query_Tag-Key"></a>
La clave de la etiqueta. Las claves de etiqueta distinguen entre mayúsculas y minúsculas.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128 caracteres.  
Obligatorio: sí

 ** Value **   <a name="timestream-Type-query_Tag-Value"></a>
El valor de la etiqueta. Los valores de etiquetas distinguen entre mayúsculas y minúsculas y pueden ser nulos.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

## Véase también
<a name="API_query_Tag_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Tag) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Tag) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Tag) 

# TargetConfiguration
<a name="API_query_TargetConfiguration"></a>

Configuración que se utiliza para escribir el resultado de una consulta.

## Contenido
<a name="API_query_TargetConfiguration_Contents"></a>

 ** TimestreamConfiguration **   <a name="timestream-Type-query_TargetConfiguration-TimestreamConfiguration"></a>
Configuración necesaria para escribir datos en la base de datos y la tabla de Timestream.  
Tipo: objeto [TimestreamConfiguration](API_query_TimestreamConfiguration.md)  
Obligatorio: sí

## Véase también
<a name="API_query_TargetConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetConfiguration) 

# TargetDestination
<a name="API_query_TargetDestination"></a>

Información del destino para escribir datos para un origen de datos de destino. El origen de datos compatible actual es Timestream.

## Contenido
<a name="API_query_TargetDestination_Contents"></a>

 ** TimestreamDestination **   <a name="timestream-Type-query_TargetDestination-TimestreamDestination"></a>
Consulte la información del destino de los resultados para el origen de datos de Timestream.  
Tipo: objeto [TimestreamDestination](API_query_TimestreamDestination.md)  
Obligatorio: no

## Véase también
<a name="API_query_TargetDestination_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetDestination) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetDestination) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetDestination) 

# TimeSeriesDataPoint
<a name="API_query_TimeSeriesDataPoint"></a>

El tipo de datos de la serie temporal representa los valores de una medida a lo largo del tiempo. Una serie temporal es una matriz de filas de marcas de tiempo y valores de medidas, con las filas ordenadas en orden de tiempo ascendente. Un TimeSeriesDataPoint es un punto de datos único de la serie temporal. Representa una tupla de (tiempo, valor de medida) en una serie temporal. 

## Contenido
<a name="API_query_TimeSeriesDataPoint_Contents"></a>

 ** Time **   <a name="timestream-Type-query_TimeSeriesDataPoint-Time"></a>
La marca de tiempo en la que se recopiló el valor de la medida.  
Tipo: cadena  
Obligatorio: sí

 ** Value **   <a name="timestream-Type-query_TimeSeriesDataPoint-Value"></a>
El valor de la medida del punto de datos.  
Tipo: objeto [Datum](API_query_Datum.md)  
Obligatorio: sí

## Véase también
<a name="API_query_TimeSeriesDataPoint_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimeSeriesDataPoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimeSeriesDataPoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimeSeriesDataPoint) 

# TimestreamConfiguration
<a name="API_query_TimestreamConfiguration"></a>

 Configuración para escribir datos en la base de datos y la tabla de Timestream. Esta configuración permite al usuario asignar las columnas de selección del resultado de la consulta a las columnas de la tabla de destino. 

## Contenido
<a name="API_query_TimestreamConfiguration_Contents"></a>

 ** DatabaseName **   <a name="timestream-Type-query_TimestreamConfiguration-DatabaseName"></a>
Nombre de la base de datos Timestream en la que se escribirá el resultado de la consulta.  
Tipo: cadena  
Obligatorio: sí

 ** DimensionMappings **   <a name="timestream-Type-query_TimestreamConfiguration-DimensionMappings"></a>
 Esto permite asignar columnas del resultado de la consulta a la dimensión en la tabla de destino.   
Tipo: matriz de objetos [DimensionMapping](API_query_DimensionMapping.md)  
Obligatorio: sí

 ** TableName **   <a name="timestream-Type-query_TimestreamConfiguration-TableName"></a>
Nombre de la tabla Timestream en la que se escribirá el resultado de la consulta. La tabla debe estar dentro de la misma base de datos que se proporciona en la configuración de Timestream.  
Tipo: cadena  
Obligatorio: sí

 ** TimeColumn **   <a name="timestream-Type-query_TimestreamConfiguration-TimeColumn"></a>
Columna del resultado de la consulta que debe utilizarse como columna de tiempo en la tabla de destino. El tipo de columna para esto debe ser TIMESTAMP.  
Tipo: cadena  
Obligatorio: sí

 ** MeasureNameColumn **   <a name="timestream-Type-query_TimestreamConfiguration-MeasureNameColumn"></a>
Nombre de la columna de medidas.  
Tipo: cadena  
Requerido: no

 ** MixedMeasureMappings **   <a name="timestream-Type-query_TimestreamConfiguration-MixedMeasureMappings"></a>
Especifica cómo asignar medidas a registros de múltiples medidas.  
Tipo: Matriz de [MixedMeasureMapping](API_query_MixedMeasureMapping.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo.  
Obligatorio: no

 ** MultiMeasureMappings **   <a name="timestream-Type-query_TimestreamConfiguration-MultiMeasureMappings"></a>
Asignaciones de varias medidas.  
Tipo: objeto [MultiMeasureMappings](API_query_MultiMeasureMappings.md)  
Obligatorio: no

## Véase también
<a name="API_query_TimestreamConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamConfiguration) 

# TimestreamDestination
<a name="API_query_TimestreamDestination"></a>

Destino de la consulta programada.

## Contenido
<a name="API_query_TimestreamDestination_Contents"></a>

 ** DatabaseName **   <a name="timestream-Type-query_TimestreamDestination-DatabaseName"></a>
Nombre de la base de datos de Timestream.   
Tipo: cadena  
Requerido: no

 ** TableName **   <a name="timestream-Type-query_TimestreamDestination-TableName"></a>
Nombre de la tabla de Timestream.   
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_query_TimestreamDestination_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamDestination) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamDestination) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamDestination) 

# Type
<a name="API_query_Type"></a>

Contiene el tipo de datos de una columna de un conjunto de resultados de la consulta. El tipo de datos puede ser escalar o complejo. Los tipos de datos escalares admitidos son enteros, booleanos, cadena, dobles, marca de tiempo, fecha, hora e intervalos. Los tipos de datos complejos admitidos son matrices, filas y series temporales.

## Contenido
<a name="API_query_Type_Contents"></a>

 ** ArrayColumnInfo **   <a name="timestream-Type-query_Type-ArrayColumnInfo"></a>
Indica si la columna es una matriz.  
Tipo: objeto [ColumnInfo](API_query_ColumnInfo.md)  
Obligatorio: no

 ** RowColumnInfo **   <a name="timestream-Type-query_Type-RowColumnInfo"></a>
Indica si la columna es una fila.  
Tipo: matriz de objetos [ColumnInfo](API_query_ColumnInfo.md)  
Obligatorio: no

 ** ScalarType **   <a name="timestream-Type-query_Type-ScalarType"></a>
Indica si la columna es de tipo en cadena, entero, booleano, doble, marca de tiempo, fecha, hora. Para obtener más información, consulte [Tipos de datos admitidos](https://docs.aws.amazon.com/timestream/latest/developerguide/supported-data-types.html).  
Tipo: cadena  
Valores válidos: `VARCHAR | BOOLEAN | BIGINT | DOUBLE | TIMESTAMP | DATE | TIME | INTERVAL_DAY_TO_SECOND | INTERVAL_YEAR_TO_MONTH | UNKNOWN | INTEGER`   
Obligatorio: no

 ** TimeSeriesMeasureValueColumnInfo **   <a name="timestream-Type-query_Type-TimeSeriesMeasureValueColumnInfo"></a>
Indica si la columna es un tipo de datos de serie temporal.  
Tipo: objeto [ColumnInfo](API_query_ColumnInfo.md)  
Obligatorio: no

## Véase también
<a name="API_query_Type_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Type) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Type) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Type) 

# Errores comunes
<a name="CommonErrors"></a>

En esta sección, se enumeran los errores comunes a las acciones de la API de todos los servicios de AWS. En el caso de los errores específicos de una acción de la API de este servicio, consulte el tema de dicha acción de la API.

 **AccessDeniedException**   
No tiene acceso suficiente para realizar esta acción.  
Código de estado HTTP: 400

 **IncompleteSignature**   
La firma de solicitud no se ajusta a los estándares de AWS.  
Código de estado HTTP: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
El procesamiento de la solicitud ha devuelto un error debido a un error o una excepción desconocidos.  
Código de estado HTTP: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
La acción u operación solicitada no es válida. Compruebe que la acción se ha escrito correctamente.  
Código de estado HTTP: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
El certificado X.509 o el ID de clave de acceso de AWS proporcionado no existen en nuestros registros.  
Código de estado HTTP: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
No tiene permiso para realizar esta acción.  
Código de estado HTTP: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
El ID de clave de acceso de AWS necesita una suscripción al servicio.  
Código de estado HTTP: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
La solicitud llegó al servicio más de 15 minutos después de la marca de fecha en la solicitud o más de 15 minutos después de la fecha de vencimiento de la solicitud (por ejemplo, para las URL prefirmadas) o la marca de fecha de la solicitud corresponde a una hora futura en más de 15 minutos.  
Código de estado HTTP: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.  
Código de estado HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
La solicitud fue denegada debido a una limitación de la solicitud.  
Código de estado HTTP: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
La entrada no satisface las limitaciones que especifica un servicio de AWS.  
Código de estado HTTP: 400

# Parámetros comunes
<a name="CommonParameters"></a>

La siguiente lista contiene los parámetros que utilizan todas las acciones para firmar solicitudes de Signature Version 4 con una cadena de consulta. Los parámetros específicos de acción se enumeran en el tema correspondiente a la acción. Para obtener más información sobre Signature Version 4, consulte [Firma de solicitudes API de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) en la *Guía del usuario de IAM*.

 **Action**   <a name="CommonParameters-Action"></a>
Las acciones que se van a realizar.  
Tipo: cadena  
Obligatorio: sí

 **Version**   <a name="CommonParameters-Version"></a>
La versión de la API para la que está escrita la solicitud, expresada en el formato AAAA-MM-DD.  
Tipo: cadena  
Obligatorio: sí

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
El algoritmo de hash que utilizó para crear la solicitud de firma.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Valores válidos: `AWS4-HMAC-SHA256`   
Obligatorio: condicional

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
El valor del ámbito de la credencial, que es una cadena que incluye la clave de acceso, la fecha, la región a la que se dirige, el servicio que solicita y una cadena de terminación (“aws4\$1request”). El valor se expresa en el siguiente formato: *access\$1key*/*AAAAMMDD*/*region*/*service*/aws4\$1request.  
Para obtener más información, consulte [Crear una solicitud API de AWS firmada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) en la *Guía del usuario de IAM*.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
La fecha utilizada para crear la firma. El formato debe ser ISO 8601 formato básico (AAAAMMDD‘T’HHMMSS‘Z’). Por ejemplo, la siguiente fecha y hora es un valor válido de X-Amz-Date para `20120325T120000Z`.  
Condición: X-Amz-Date es opcional en todas las solicitudes; se puede utilizar para anular la fecha empleada a fin de firmar las solicitudes. Si el encabezado Date se especifica en el formato básico ISO 8601, no se requiere X-Amz-Date. Cuando se usa X-Amz-Date, siempre anula el valor del encabezado Date. Para obtener más información, consulte [Elementos de una firma de solicitud API de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) en la *Guía del usuario de IAM*.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
El token de seguridad temporal que se obtuvo mediante una llamada a AWS Security Token Service (AWS STS). Para obtener una lista de servicios compatibles con las credenciales de seguridad temporales de AWS STS, consulte [Servicios de AWS que funcionan con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) en la *Guía del usuario de IAM*.  
Condición: si utiliza credenciales de seguridad temporales de AWS STS, debe incluir el token de seguridad.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Especifica la firma codificada hexadecimal que se calculó a partir de la cadena que se va a firmar y la clave de firma derivada.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Especifica todos los encabezados HTTP que se incluyeron como parte de la solicitud canónica. Para obtener más información acerca de especificar encabezados firmados, consulte [Crear una solicitud API de AWS firmada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) en la *Guía del usuario de IAM*.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional