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.

# 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)