Para recursos semelhantes aos do Amazon Timestream para, considere o Amazon Timestream LiveAnalytics para InfluxDB. Ele oferece ingestão de dados simplificada e tempos de resposta de consulta de um dígito em milissegundos para análises em tempo real. Saiba mais [aqui](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Referência de API
<a name="API_Reference"></a>

Esta seção contém a documentação de referência da API para o Amazon Timestream. 

O Timestream tem dois APIs: Query e Write.
+ A **API Gravação** permite que você execute operações como criação de tabelas, marcação de recursos e gravação de registros no Timestream.
+ A **API Consulta** permite que você execute operações de consulta.

**nota**  
Ambos APIs incluem a DescribeEndpoints ação. *Tanto para Consulta quanto para DescribeEndpoints Gravação, as ações são idênticas.*

Você pode ler mais sobre cada API abaixo, além de tipos de dados, erros comuns e parâmetros.

**nota**  
Para códigos de erro comuns a todos os AWS serviços, consulte a [seção AWS Support](https://docs.aws.amazon.com/awssupport/latest/APIReference/CommonErrors.html). 

**Topics**
+ [

# Ações
](API_Operations.md)
+ [

# Tipos de dados
](API_Types.md)
+ [

# Erros comuns
](CommonErrors.md)
+ [

# Parâmetros gerais
](CommonParameters.md)

# Ações
<a name="API_Operations"></a>

As seguintes ações são compatíveis com a gravação do Amazon Timestream:
+  [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) 

As seguintes ações são compatíveis com a consulta do Amazon Timestream:
+  [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) 

# Gravação do Amazon Timestream
<a name="API_Operations_Amazon_Timestream_Write"></a>

As seguintes ações são compatíveis com a gravação do Amazon Timestream:
+  [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>

Cria uma tarefa de carregamento em lote do Timestream. Uma tarefa de carregamento em lote processa dados de uma fonte CSV em um local do S3 e grava em uma tabela do Timestream. Um mapeamento da origem para o destino é definido em uma tarefa de carregamento em lote. Erros e eventos são gravados em um relatório em um local do S3. Para o relatório, se a AWS KMS chave não for especificada, o relatório será criptografado com uma chave gerenciada do S3 quando `SSE_S3` for a opção. Caso contrário, um erro será gerado. Para obter mais informações, consulte [Chaves gerenciadas pela AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk). [Cotas de serviço se aplicam](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html) para obter detalhes.

## Sintaxe da solicitação
<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 da solicitação
<a name="API_CreateBatchLoadTask_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-ClientToken"></a>
  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Obrigatório: não

 ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-DataModelConfiguration"></a>
  
Tipo: objeto [DataModelConfiguration](API_DataModelConfiguration.md)  
Obrigatório: não

 ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-DataSourceConfiguration"></a>
Define detalhes de configuração sobre a fonte de dados para uma tarefa de carregamento em lote.  
Tipo: objeto [DataSourceConfiguration](API_DataSourceConfiguration.md)  
Obrigatório: sim

 ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-RecordVersion"></a>
  
Tipo: longo  
Obrigatório: não

 ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-ReportConfiguration"></a>
Configuração do relatório para uma tarefa de carregamento em lote. Contém detalhes sobre onde os relatórios de erros são armazenados.  
Tipo: objeto [ReportConfiguration](API_ReportConfiguration.md)  
Obrigatório: sim

 ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-TargetDatabaseName"></a>
Banco de dados Timestream de destino para uma tarefa de carregamento em lote.  
Tipo: string  
Padrão: `[a-zA-Z0-9_.-]+`   
Obrigatório: sim

 ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-TargetTableName"></a>
Tabela de Timestream de destino para uma tarefa de carregamento em lote.  
Tipo: string  
Padrão: `[a-zA-Z0-9_.-]+`   
Obrigatório: sim

## Sintaxe da resposta
<a name="API_CreateBatchLoadTask_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) **   <a name="timestream-CreateBatchLoadTask-response-TaskId"></a>
ID da tarefa de carregamento em lote.  
Tipo: string  
Restrições de tamanho: comprimento mínimo de 3. O comprimento máximo é 32.  
Padrão: `[A-Z0-9]+` 

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** ConflictException **   
O Timestream não conseguiu processar essa solicitação porque ela contém um recurso que já existe.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ServiceQuotaExceededException **   
 A cota de instância do recurso foi excedida para essa conta.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_CreateBatchLoadTask_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Cria um banco de dados do Timestream. Se a AWS KMS chave não for especificada, o banco de dados será criptografado com uma AWS KMS chave gerenciada do Timestream localizada em sua conta. Para obter mais informações, consulte [Chaves gerenciadas pela AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk). [Cotas de serviço se aplicam](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html) para obter detalhes. 

## Sintaxe da solicitação
<a name="API_CreateDatabase_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_CreateDatabase_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [DatabaseName](#API_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-request-DatabaseName"></a>
O nome do banco de dados do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. Tamanho máximo de 256.  
Padrão: `[a-zA-Z0-9_.-]+`   
Obrigatório: Sim

 ** [KmsKeyId](#API_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-request-KmsKeyId"></a>
A AWS KMS chave para o banco de dados. Se a AWS KMS chave não for especificada, o banco de dados será criptografado com uma AWS KMS chave gerenciada do Timestream localizada em sua conta. Para obter mais informações, consulte [Chaves gerenciadas pela AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk).  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2.048.  
Obrigatório: não

 ** [Tags](#API_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-request-Tags"></a>
 Uma lista de pares de chave-valor para rotular a tabela.   
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: não

## Sintaxe da resposta
<a name="API_CreateDatabase_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Database](#API_CreateDatabase_ResponseSyntax) **   <a name="timestream-CreateDatabase-response-Database"></a>
O banco de dados do Timestream criado recentemente.  
Tipo: objeto [Database](API_Database.md)

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** ConflictException **   
O Timestream não conseguiu processar essa solicitação porque ela contém um recurso que já existe.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ServiceQuotaExceededException **   
 A cota de instância do recurso foi excedida para essa conta.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_CreateDatabase_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Adiciona uma nova tabela a um banco de dados existente em sua conta. Em um Conta da AWS, os nomes das tabelas devem ser pelo menos exclusivos em cada região se estiverem no mesmo banco de dados. Será possível ter nomes de tabela idênticos na mesma região se as tabelas estiverem em bancos de dados separados. Ao criar a tabela, especifique o nome da tabela, o nome do banco de dados e as propriedades de retenção. [Cotas de serviço se aplicam](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html) para obter detalhes. 

## Sintaxe da solicitação
<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 da solicitação
<a name="API_CreateTable_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [DatabaseName](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-DatabaseName"></a>
O nome do banco de dados do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. Tamanho máximo de 256.  
Padrão: `[a-zA-Z0-9_.-]+`   
Obrigatório: sim

 ** [MagneticStoreWriteProperties](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-MagneticStoreWriteProperties"></a>
Contém propriedades a serem definidas na tabela ao habilitar gravações de armazenamento magnético.  
Tipo: objeto [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)  
Obrigatório: não

 ** [RetentionProperties](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-RetentionProperties"></a>
O período durante o qual seus dados de séries temporais devem ser armazenados na memória e no armazenamento magnético.  
Tipo: objeto [RetentionProperties](API_RetentionProperties.md)  
Obrigatório: não

 ** [Schema](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-Schema"></a>
 O esquema da tabela.   
Tipo: objeto [Schema](API_Schema.md)  
Obrigatório: não

 ** [TableName](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-TableName"></a>
O nome da tabela do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. Tamanho máximo de 256.  
Padrão: `[a-zA-Z0-9_.-]+`   
Obrigatório: sim

 ** [Tags](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-Tags"></a>
 Uma lista de pares de chave-valor para rotular a tabela.   
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: não

## Sintaxe da resposta
<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 resposta
<a name="API_CreateTable_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Table](#API_CreateTable_ResponseSyntax) **   <a name="timestream-CreateTable-response-Table"></a>
A tabela Timestream recém-criada.  
Tipo: objeto [Table](API_Table.md)

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** ConflictException **   
O Timestream não conseguiu processar essa solicitação porque ela contém um recurso que já existe.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ServiceQuotaExceededException **   
 A cota de instância do recurso foi excedida para essa conta.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_CreateTable_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma linguagem específica AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Exclui um determinado banco de dados do Timestream. *Essa operação é irreversível. Depois que um banco de dados é excluído, os dados de séries temporais de suas tabelas não podem ser recuperados.* 

**nota**  
Todas as tabelas no banco de dados devem ser excluídas primeiro, ou um ValidationException erro será gerado.   
Devido à natureza das novas tentativas distribuídas, a operação pode retornar um sucesso ou um ResourceNotFoundException. Os clientes devem considerá-los equivalentes.

Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html) para obter detalhes.

## Sintaxe da solicitação
<a name="API_DeleteDatabase_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_DeleteDatabase_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [DatabaseName](#API_DeleteDatabase_RequestSyntax) **   <a name="timestream-DeleteDatabase-request-DatabaseName"></a>
O nome do banco de dados do Timestream a ser excluído.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: sim

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

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_DeleteDatabase_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Exclui uma determinada tabela de Timestream. Essa operação é irreversível. Depois que uma tabela do banco de dados Timestream é excluída, os dados de série temporais armazenados na tabela não podem ser recuperados. 

**nota**  
Devido à natureza das novas tentativas distribuídas, a operação pode retornar um sucesso ou um ResourceNotFoundException. Os clientes devem considerá-los equivalentes.

Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html) para obter detalhes.

## Sintaxe da solicitação
<a name="API_DeleteTable_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_DeleteTable_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [DatabaseName](#API_DeleteTable_RequestSyntax) **   <a name="timestream-DeleteTable-request-DatabaseName"></a>
O nome do banco de dados no qual o banco de dados do Timestream deve ser excluído.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: sim

 ** [TableName](#API_DeleteTable_RequestSyntax) **   <a name="timestream-DeleteTable-request-TableName"></a>
Nome da tabela do Timestream a ser excluída.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: sim

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

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_DeleteTable_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Retorna informações sobre a tarefa de carregamento em lote, incluindo configurações, mapeamentos, progresso e outros detalhes. [Cotas de serviço se aplicam](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-batch-load.html) para obter detalhes.

## Sintaxe da solicitação
<a name="API_DescribeBatchLoadTask_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_DescribeBatchLoadTask_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [TaskId](#API_DescribeBatchLoadTask_RequestSyntax) **   <a name="timestream-DescribeBatchLoadTask-request-TaskId"></a>
ID da tarefa de carregamento em lote.  
Tipo: string  
Restrições de tamanho: comprimento mínimo de 3. O comprimento máximo é 32.  
Padrão: `[A-Z0-9]+`   
Obrigatório: sim

## Sintaxe da resposta
<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 resposta
<a name="API_DescribeBatchLoadTask_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [BatchLoadTaskDescription](#API_DescribeBatchLoadTask_ResponseSyntax) **   <a name="timestream-DescribeBatchLoadTask-response-BatchLoadTaskDescription"></a>
Descrição da tarefa de carregamento em lote.  
Tipo: objeto [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md)

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

## Consulte também
<a name="API_DescribeBatchLoadTask_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Retorna informações sobre o banco de dados, incluindo o nome do banco de dados, a hora em que o banco de dados foi criado e o número total de tabelas encontradas no banco de dados. [Cotas de serviço se aplicam](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html) para obter detalhes.

## Sintaxe da solicitação
<a name="API_DescribeDatabase_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_DescribeDatabase_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [DatabaseName](#API_DescribeDatabase_RequestSyntax) **   <a name="timestream-DescribeDatabase-request-DatabaseName"></a>
O nome do banco de dados do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: sim

## Sintaxe da resposta
<a name="API_DescribeDatabase_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Database](#API_DescribeDatabase_ResponseSyntax) **   <a name="timestream-DescribeDatabase-response-Database"></a>
O nome da tabela do Timestream.  
Tipo: objeto [Database](API_Database.md)

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_DescribeDatabase_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Retorna uma lista de endpoints disponíveis para fazer chamadas de API Timestream. Essa operação de API está disponível por meio da Gravação e da Consulta APIs.

Como o SDKs Timestream foi projetado para trabalhar de forma transparente com a arquitetura do serviço, incluindo o gerenciamento e o mapeamento dos endpoints do serviço, *não recomendamos que você use essa operação de API, a menos que*:
+ Você está usando [endpoints da VPC (AWS PrivateLink) com Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) 
+ Seu aplicativo usa uma linguagem de programação que ainda não tem suporte para SDK
+ Você precisa de um melhor controle sobre a implantação do lado do cliente

Para obter informações detalhadas sobre como e quando usar e implementar DescribeEndpoints, consulte [The Endpoint Discovery Pattern](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery).

## Sintaxe da resposta
<a name="API_DescribeEndpoints_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Endpoints](#API_DescribeEndpoints_ResponseSyntax) **   <a name="timestream-DescribeEndpoints-response-Endpoints"></a>
Um objeto `Endpoints` é retornado quando uma solicitação `DescribeEndpoints` é feita.  
Tipo: matriz de objetos [Endpoint](API_Endpoint.md)

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_DescribeEndpoints_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Retorna informações sobre a tabela, incluindo seu nome, o nome do banco de dados, a duração de retenção do armazenamento de memória e o armazenamento magnético. [Cotas de serviço se aplicam](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html) para obter detalhes. 

## Sintaxe da solicitação
<a name="API_DescribeTable_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_DescribeTable_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [DatabaseName](#API_DescribeTable_RequestSyntax) **   <a name="timestream-DescribeTable-request-DatabaseName"></a>
O nome do banco de dados do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: sim

 ** [TableName](#API_DescribeTable_RequestSyntax) **   <a name="timestream-DescribeTable-request-TableName"></a>
O nome da tabela do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: sim

## Sintaxe da resposta
<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 resposta
<a name="API_DescribeTable_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

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

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_DescribeTable_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Fornece uma lista de tarefas de carregamento em lote, junto com o nome, status, até quando a tarefa pode ser retomada e outros detalhes. Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-batch-load-tasks.html) para obter detalhes.

## Sintaxe da solicitação
<a name="API_ListBatchLoadTasks_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_ListBatchLoadTasks_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [MaxResults](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-MaxResults"></a>
O número total de itens para retornar na saída. Se o número total de itens disponíveis for maior que o valor especificado, um NextToken será fornecido na saída. Para retomar a paginação, forneça o NextToken valor como argumento de uma invocação de API subsequente.  
Tipo: inteiro  
Faixa válida: valor mínimo de 1. Valor máximo de 100.  
Obrigatório: não

 ** [NextToken](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-NextToken"></a>
Um token para especificar onde iniciar a paginação. Isso é NextToken de uma resposta previamente truncada.  
Tipo: string  
Obrigatório: não

 ** [TaskStatus](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-TaskStatus"></a>
Status da tarefa de carregamento em lote.  
Tipo: string  
Valores válidos: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME`   
Obrigatório: não

## Sintaxe da resposta
<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 resposta
<a name="API_ListBatchLoadTasks_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [BatchLoadTasks](#API_ListBatchLoadTasks_ResponseSyntax) **   <a name="timestream-ListBatchLoadTasks-response-BatchLoadTasks"></a>
Uma lista de detalhes da tarefa de carregamento em lote.  
Tipo: matriz de objetos [BatchLoadTask](API_BatchLoadTask.md)

 ** [NextToken](#API_ListBatchLoadTasks_ResponseSyntax) **   <a name="timestream-ListBatchLoadTasks-response-NextToken"></a>
Um token para especificar onde iniciar a paginação. Forneça o próximo ListBatchLoadTasksRequest.  
Tipo: string

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_ListBatchLoadTasks_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Retorna uma lista de seus bancos de dados Timestream. [Cotas de serviço se aplicam](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html) para obter detalhes. 

## Sintaxe da solicitação
<a name="API_ListDatabases_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_ListDatabases_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [MaxResults](#API_ListDatabases_RequestSyntax) **   <a name="timestream-ListDatabases-request-MaxResults"></a>
O número total de itens para retornar na saída. Se o número total de itens disponíveis for maior que o valor especificado, um NextToken será fornecido na saída. Para retomar a paginação, forneça o NextToken valor como argumento de uma invocação de API subsequente.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 1. Valor máximo de 20.  
Obrigatório: não

 ** [NextToken](#API_ListDatabases_RequestSyntax) **   <a name="timestream-ListDatabases-request-NextToken"></a>
Token de paginação. Para retomar a paginação, forneça o NextToken valor como argumento de uma invocação de API subsequente.  
Tipo: string  
Obrigatório: não

## Sintaxe da resposta
<a name="API_ListDatabases_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Databases](#API_ListDatabases_ResponseSyntax) **   <a name="timestream-ListDatabases-response-Databases"></a>
Uma lista de nomes de bancos de dados.  
Tipo: matriz de objetos [Database](API_Database.md)

 ** [NextToken](#API_ListDatabases_ResponseSyntax) **   <a name="timestream-ListDatabases-response-NextToken"></a>
Token de paginação. Esse parâmetro é retornado quando a resposta está truncada.  
Tipo: string

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_ListDatabases_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Fornece uma lista de tabelas, junto com o nome, o status e as propriedades de retenção de cada tabela. Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html) para obter detalhes. 

## Sintaxe da solicitação
<a name="API_ListTables_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_ListTables_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [DatabaseName](#API_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-DatabaseName"></a>
O nome do banco de dados do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: não

 ** [MaxResults](#API_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-MaxResults"></a>
O número total de itens para retornar na saída. Se o número total de itens disponíveis for maior que o valor especificado, um NextToken será fornecido na saída. Para retomar a paginação, forneça o NextToken valor como argumento de uma invocação de API subsequente.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 1. Valor máximo de 20.  
Obrigatório: não

 ** [NextToken](#API_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-NextToken"></a>
Token de paginação. Para retomar a paginação, forneça o NextToken valor como argumento de uma invocação de API subsequente.  
Tipo: string  
Obrigatório: não

## Sintaxe da resposta
<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 resposta
<a name="API_ListTables_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [NextToken](#API_ListTables_ResponseSyntax) **   <a name="timestream-ListTables-response-NextToken"></a>
Um token para especificar onde iniciar a paginação. Isso é NextToken de uma resposta previamente truncada.  
Tipo: string

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

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_ListTables_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

 Lista todas as tags em um recurso do Timestream. 

## Sintaxe da solicitação
<a name="API_ListTagsForResource_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_ListTagsForResource_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) **   <a name="timestream-ListTagsForResource-request-ResourceARN"></a>
 O recurso do Timestream com as tags a serem listadas. Esse valor é um nome do recurso da Amazon (ARN).   
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 1011.  
Obrigatório: sim

## Sintaxe da resposta
<a name="API_ListTagsForResource_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="timestream-ListTagsForResource-response-Tags"></a>
 As tags atualmente associadas ao recurso Timestream.   
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_ListTagsForResource_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

 

## Sintaxe da solicitação
<a name="API_ResumeBatchLoadTask_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_ResumeBatchLoadTask_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [TaskId](#API_ResumeBatchLoadTask_RequestSyntax) **   <a name="timestream-ResumeBatchLoadTask-request-TaskId"></a>
O ID da tarefa de carregamento em lote a ser retomada.  
Tipo: string  
Restrições de tamanho: comprimento mínimo de 3. O comprimento máximo é 32.  
Padrão: `[A-Z0-9]+`   
Obrigatório: sim

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

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_ResumeBatchLoadTask_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

 Associa um conjunto de tags a um recurso Timestream. Em seguida, você pode ativar essas tags definidas pelo usuário para que elas apareçam no console de Faturamento e Gerenciamento de custos para o controle da alocação de custos. 

## Sintaxe da solicitação
<a name="API_TagResource_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_TagResource_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ResourceARN](#API_TagResource_RequestSyntax) **   <a name="timestream-TagResource-request-ResourceARN"></a>
 Identifica o recurso Timestream ao qual as tags devem ser adicionadas. Esse valor é um nome do recurso da Amazon (ARN).   
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 1011.  
Obrigatório: sim

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="timestream-TagResource-request-Tags"></a>
 As tags a serem atribuídas ao recurso do Amazon Neptune.   
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: sim

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

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ServiceQuotaExceededException **   
 A cota de instância do recurso foi excedida para essa conta.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_TagResource_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

 Remove a associação de tags de um recurso Timestream. 

## Sintaxe da solicitação
<a name="API_UntagResource_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_UntagResource_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ResourceARN](#API_UntagResource_RequestSyntax) **   <a name="timestream-UntagResource-request-ResourceARN"></a>
 O recurso do Timestream do qual as tags serão removidas. Esse valor é um nome do recurso da Amazon (ARN).   
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 1011.  
Obrigatório: sim

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="timestream-UntagResource-request-TagKeys"></a>
 Uma lista de chaves de tags. As tags existentes do recurso cujas chaves são membros dessa lista serão removidas do recurso Timestream.   
Tipo: matriz de strings  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 128.  
Obrigatório: sim

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

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ServiceQuotaExceededException **   
 A cota de instância do recurso foi excedida para essa conta.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_UntagResource_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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 a AWS KMS chave de um banco de dados existente. Ao atualizar o banco de dados, você deve especificar o nome do banco de dados e o identificador da nova AWS KMS chave a ser usada (`KmsKeyId`). Se houver alguma solicitação simultânea `UpdateDatabase`, o primeiro escritor vence. 

Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html) para obter detalhes.

## Sintaxe da solicitação
<a name="API_UpdateDatabase_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_UpdateDatabase_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [DatabaseName](#API_UpdateDatabase_RequestSyntax) **   <a name="timestream-UpdateDatabase-request-DatabaseName"></a>
 O nome do banco de dados.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: sim

 ** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) **   <a name="timestream-UpdateDatabase-request-KmsKeyId"></a>
 O identificador da nova AWS KMS chave (`KmsKeyId`) a ser usada para criptografar os dados armazenados no banco de dados. Se o `KmsKeyId` atualmente registrado no banco de dados for o mesmo que o `KmsKeyId` na solicitação, nenhuma atualização será feita.   
Você pode especificar a `KmsKeyId` usando qualquer um dos seguintes itens:  
+ ID da chave: `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ ARN da chave: `arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Nome do alias: `alias/ExampleAlias` 
+ ARN do alias: `arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias` 
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2048.  
Obrigatório: sim

## Sintaxe da resposta
<a name="API_UpdateDatabase_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Database](#API_UpdateDatabase_ResponseSyntax) **   <a name="timestream-UpdateDatabase-response-Database"></a>
Um contêiner de nível superior para uma mesa. Bancos de dados e tabelas são os conceitos fundamentais de gerenciamento no Amazon Timestream. Todas as tabelas em um banco de dados são criptografadas com a mesma AWS KMS chave.  
Tipo: objeto [Database](API_Database.md)

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ServiceQuotaExceededException **   
 A cota de instância do recurso foi excedida para essa conta.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_UpdateDatabase_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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 a duração de retenção do armazenamento em memória e do armazenamento magnético para sua tabela Timestream. Observe que a alteração na duração da retenção entra em vigor imediatamente. Por exemplo, se o período de retenção do armazenamento de memória foi inicialmente definido para 2 horas e depois alterado para 24 horas, o armazenamento de memória será capaz de armazenar 24 horas de dados, mas será preenchido com 24 horas de dados 22 horas após a alteração ter sido feita. O Timestream não recupera dados do armazenamento magnético para preencher o armazenamento de memória. 

Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html) para obter detalhes.

## Sintaxe da solicitação
<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 da solicitação
<a name="API_UpdateTable_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [DatabaseName](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-DatabaseName"></a>
O nome do banco de dados do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: sim

 ** [MagneticStoreWriteProperties](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-MagneticStoreWriteProperties"></a>
Contém propriedades a serem definidas na tabela ao habilitar gravações de armazenamento magnético.  
Tipo: objeto [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)  
Obrigatório: não

 ** [RetentionProperties](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-RetentionProperties"></a>
A duração da retenção da memória e do armazenamento magnético.  
Tipo: objeto [RetentionProperties](API_RetentionProperties.md)  
Obrigatório: não

 ** [Schema](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-Schema"></a>
 O esquema da tabela.   
Tipo: objeto [Schema](API_Schema.md)  
Obrigatório: não

 ** [TableName](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-TableName"></a>
O nome da tabela do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: sim

## Sintaxe da resposta
<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 resposta
<a name="API_UpdateTable_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Table](#API_UpdateTable_ResponseSyntax) **   <a name="timestream-UpdateTable-response-Table"></a>
A tabela Timestream atualizada.  
Tipo: objeto [Table](API_Table.md)

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_UpdateTable_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Permite que você grave seus dados de séries temporais no Timestream. É possível especificar um único ponto de dados ou um lote de pontos de dados a serem inseridos no sistema. O Timestream oferece um esquema flexível que detecta automaticamente os nomes das colunas e os tipos de dados das tabelas do Timestream com base nos nomes das dimensões e nos tipos de dados dos pontos de dados especificados ao invocar gravações no banco de dados. 

O Timestream é compatível com uma eventual semântica de leitura final consistente. Isso significa que quando você consulta dados imediatamente após gravar um lote de dados no Timestream, os resultados da consulta podem não refletir os resultados de uma operação de gravação recém-concluída. Os resultados também podem incluir alguns dados obsoletos. Se você repetir a solicitação da consulta após um curto período de tempo, os resultados devem retornar os dados mais recentes. [Cotas de serviço se aplicam](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). 

Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html) para obter detalhes.

 **Upserts** 

Você pode usar o parâmetro `Version` em uma solicitação `WriteRecords` para atualizar pontos de dados. O Timestream rastreia um número de versão com cada registro. A `Version` padrão é `1` quando não é especificado para o registro na solicitação. O Timestream atualiza o valor de medida de um registro existente junto com o valor da `Version` quando recebe uma solicitação de gravação com um número de `Version` maior para esse registro. Quando recebe uma solicitação de atualização em que o valor da medida é o mesmo do registro existente, o Timestream ainda atualiza a `Version`, se for maior que o valor existente de `Version`. É possível atualizar um ponto de dados quantas vezes quiser, desde que o valor da `Version` aumente continuamente. 

 Por exemplo, suponha que você grave um novo registro sem indicar `Version` na solicitação. O Timestream armazena esse registro e o define a `Version` como `1`. Agora, suponha que você tente atualizar esse registro com uma solicitação `WriteRecords` do mesmo registro com um valor de medida diferente, mas, como antes, não forneça a `Version`. Nesse caso, o Timestream rejeitará essa atualização com um `RejectedRecordsException`, já que a versão do registro atualizado não é maior que o valor existente de Versão. 

No entanto, se você reenviasse a solicitação de atualização com `Version` definido como `2`, o Timestream conseguiria atualizar o valor do registro e a `Version` seria definida como `2`. Em seguida, suponha que você tenha enviado uma solicitação `WriteRecords` com esse mesmo registro e um valor de medida idêntico, mas com `Version` definida como `3`. Nesse caso, o Timestream apenas atualizaria a `Version` para `3`. Quaisquer atualizações adicionais precisariam enviar um número de versão maior que `3`, ou as solicitações de atualização receberiam um `RejectedRecordsException`. 

## Sintaxe da solicitação
<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 da solicitação
<a name="API_WriteRecords_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [CommonAttributes](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-CommonAttributes"></a>
Um registro que contém os atributos comuns de medida, dimensão, tempo e versão compartilhados entre todos os registros na solicitação. Os atributos de medida e dimensão especificados serão mesclados com os atributos de medida e dimensão no objeto de registros quando os dados forem gravados no Timestream. As dimensões não podem se sobrepor, ou um `ValidationException` será lançado. Em outras palavras, um registro deve conter dimensões com nomes exclusivos.   
Tipo: objeto [Record](API_Record.md)  
Obrigatório: não

 ** [DatabaseName](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-DatabaseName"></a>
O nome do banco de dados do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: sim

 ** [Records](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-Records"></a>
Uma matriz de registros que contém os atributos exclusivos de medida, dimensão, tempo e versão para cada ponto de dados de série temporal.  
Tipo: matriz de objetos [Record](API_Record.md)  
Membros da matriz: número mínimo de 1 item. Número máximo de 100 itens.  
Obrigatório: sim

 ** [TableName](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-TableName"></a>
O nome da tabela do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.  
Obrigatório: sim

## Sintaxe da resposta
<a name="API_WriteRecords_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [RecordsIngested](#API_WriteRecords_ResponseSyntax) **   <a name="timestream-WriteRecords-response-RecordsIngested"></a>
Informações sobre os registros ingeridos por essa solicitação.  
Tipo: objeto [RecordsIngested](API_RecordsIngested.md)

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem autorização para executar esta ação.  
Código de status HTTP: 400

 ** InternalServerException **   
 O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.  
Código de status HTTP: 500

 ** InvalidEndpointException **   
O endpoint solicitado não era válido.  
Código de status HTTP: 400

 ** RejectedRecordsException **   
 WriteRecords lançaria essa exceção nos seguintes casos:   
+ Registros com dados duplicados nos quais há vários registros com as mesmas dimensões, registros de data/hora e nomes de medidas, mas: 
  + Os valores das medidas são diferentes
  + A versão não está presente na solicitação *ou* o valor da versão no novo registro é igual ou inferior ao valor existente

   Nesse caso, se o Timestream rejeitar dados, o campo `ExistingVersion` na resposta `RejectedRecords` indicará a versão atual do registro. Para forçar uma atualização, você pode reenviar a solicitação com uma versão do conjunto de registros com um valor maior que a `ExistingVersion`.
+  Registros com registros de data/hora que estão fora da duração de retenção do armazenamento na memória. 
+  Registros com dimensões ou medidas que excedem os limites definidos pelo Timestream. 
 Para obter mais informações, consulte [Cotas](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) no Guia do desenvolvedor do Amazon Timestream.     
 ** RejectedRecords **   
 
Código de status HTTP: 400

 ** ResourceNotFoundException **   
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.  
Código de status HTTP: 400

 ** ThrottlingException **   
 Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.  
Código de status HTTP: 400

 ** ValidationException **   
 Uma solicitação inválida ou malformada.  
Código de status HTTP: 400

## Consulte também
<a name="API_WriteRecords_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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 do Amazon Timestream
<a name="API_Operations_Amazon_Timestream_Query"></a>

As seguintes ações são compatíveis com a consulta do Amazon Timestream:
+  [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 uma consulta que foi emitida. O cancelamento é fornecido somente se a consulta não tiver sido concluída antes da emissão da solicitação de cancelamento. Como o cancelamento é uma operação idempotente, as solicitações de cancelamento subsequentes retornarão a `CancellationMessage`, indicando que a consulta já foi cancelada. Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.cancel-query.html) para obter detalhes. 

## Sintaxe da solicitação
<a name="API_query_CancelQuery_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_query_CancelQuery_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [QueryId](#API_query_CancelQuery_RequestSyntax) **   <a name="timestream-query_CancelQuery-request-QueryId"></a>
 O ID da consulta que precisa ser cancelada. `QueryID` é retornado como parte do resultado da consulta.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `[a-zA-Z0-9]+`   
Obrigatório: sim

## Sintaxe da resposta
<a name="API_query_CancelQuery_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [CancellationMessage](#API_query_CancelQuery_ResponseSyntax) **   <a name="timestream-query_CancelQuery-response-CancellationMessage"></a>
 A `CancellationMessage` é retornada quando uma solicitação `CancelQuery` para a consulta especificada por `QueryId` já foi emitida.   
Tipo: string

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem as permissões necessárias para acessar as configurações da conta.  
Código de status HTTP: 400

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_CancelQuery_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

 Crie uma consulta agendada que será executada em seu nome na programação configurada. O Timestream assume a função de execução fornecida como parte do parâmetro `ScheduledQueryExecutionRoleArn` para executar a consulta. É possível utilizar o parâmetro `NotificationConfiguration` para configurar a notificação das suas operações de consulta agendada.

## Sintaxe da solicitação
<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 da solicitação
<a name="API_query_CreateScheduledQuery_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ClientToken"></a>
Usar a ClientToken torna a chamada para CreateScheduledQuery idempotente, em outras palavras, fazer a mesma solicitação repetidamente produzirá o mesmo resultado. Fazer várias CreateScheduledQuery solicitações idênticas tem o mesmo efeito que fazer uma única solicitação.   
+  Se CreateScheduledQuery for chamado sem um`ClientToken`, o Query SDK gerará um `ClientToken` em seu nome.
+  Após oito horas, qualquer solicitação com o mesmo `ClientToken` será tratada como uma nova solicitação. 
Tipo: string  
Restrições de comprimento: comprimento mínimo de 32. O comprimento máximo é 128.  
Obrigatório: não

 ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ErrorReportConfiguration"></a>
Configuração para relatórios de erros. Relatórios de erros serão gerados quando um problema for encontrado ao gravar resultados de consultas.   
Tipo: objeto [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Obrigatório: sim

 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-KmsKeyId"></a>
A chave do Amazon KMS utilizada para criptografar o recurso de consulta agendada em repouso. Se a chave do Amazon KMS não for especificada, o recurso de consulta agendada será criptografado com uma chave do Amazon KMS de propriedade do Timestream. Para especificar uma chave do KMS, use o ID de chave, o ARN de chave, o nome de alias ou o ARN de alias. Ao usar um nome de alias, use *alias/* como prefixo.   
Se for ErrorReportConfiguration usado `SSE_KMS` como tipo de criptografia, o mesmo KmsKeyId será usado para criptografar o relatório de erros em repouso.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2.048.  
Obrigatório: não

 ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Name"></a>
Nome da consulta agendada.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obrigatório: sim

 ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-NotificationConfiguration"></a>
Configuração de notificação para a consulta agendada. Uma notificação é enviada pelo Timestream quando uma execução de consulta é finalizada, quando seu estado é atualizado ou quando ela é excluída.   
Tipo: objeto [NotificationConfiguration](API_query_NotificationConfiguration.md)  
Obrigatório: sim

 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-QueryString"></a>
String de consulta a ser executada. Nomes de parâmetros podem ser especificados no caractere `@` da string de consulta, seguido por um identificador. O parâmetro nomeado `@scheduled_runtime` é reservado e pode ser utilizado na consulta para obter o horário em que ela está programada para ser executada.  
O timestamp, calculado de acordo com o ScheduleConfiguration parâmetro, será o valor do `@scheduled_runtime` parâmetro para cada execução de consulta. Por exemplo, considere uma instância de uma consulta agendada em execução em 2021-12-01 00:00:00. Para esse caso, o parâmetro `@scheduled_runtime` é inicializado no registro de data/hora 2021-12-01 00:00:00 ao chamar a consulta.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 262144.  
Obrigatório: sim

 ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduleConfiguration"></a>
Configuração da programação da consulta.  
Tipo: objeto [ScheduleConfiguration](API_query_ScheduleConfiguration.md)  
Obrigatório: sim

 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduledQueryExecutionRoleArn"></a>
O ARN do perfil do IAM que o Timestream assumirá ao executar a consulta agendada.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2048.  
Obrigatório: sim

 ** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Tags"></a>
Uma lista de pares chave/valor para rotular a consulta agendada.  
Tipo: matriz de objetos [Tag](API_query_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: não

 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-TargetConfiguration"></a>
Configuração utilizada para gravar o resultado de uma consulta.  
Tipo: objeto [TargetConfiguration](API_query_TargetConfiguration.md)  
Obrigatório: não

## Sintaxe da resposta
<a name="API_query_CreateScheduledQuery_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) **   <a name="timestream-query_CreateScheduledQuery-response-Arn"></a>
ARN referente à consulta agendada criada.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2.048.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem as permissões necessárias para acessar as configurações da conta.  
Código de status HTTP: 400

 ** ConflictException **   
 Não é possível obter resultados de uma consulta cancelada.   
Código de status HTTP: 400

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ServiceQuotaExceededException **   
Service quota excedida.  
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_CreateScheduledQuery_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Exclui uma determinada consulta agendada. Essa operação é irreversível. 

## Sintaxe da solicitação
<a name="API_query_DeleteScheduledQuery_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_query_DeleteScheduledQuery_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) **   <a name="timestream-query_DeleteScheduledQuery-request-ScheduledQueryArn"></a>
ARN da consulta agendada.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2048.  
Obrigatório: sim

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

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem as permissões necessárias para acessar as configurações da conta.  
Código de status HTTP: 400

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
Não foi possível encontrar o recurso solicitado.    
 ** ScheduledQueryArn **   
ARN da consulta agendada.
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_DeleteScheduledQuery_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Descreve as configurações da sua conta que incluem o modelo de preços de consulta e o máximo configurado que TCUs o serviço pode usar para sua carga de trabalho de consulta.

Você será cobrado apenas pela duração das unidades de computação usadas para suas workloads.

## Sintaxe da resposta
<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 resposta
<a name="API_query_DescribeAccountSettings_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [MaxQueryTCU](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-MaxQueryTCU"></a>
O número máximo de [unidades computacionais do Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/tcu.html) (TCUs) que o serviço usará a qualquer momento para atender às suas consultas. Para realizar consultas, é necessário estabelecer uma capacidade mínima de 4 TCU. É possível estabelecer o número máximo de TCU em múltiplos de 4, como 4, 8, 16, 32 e assim por diante. Essa configuração é aplicável somente para o uso sob demanda de (TCUs).   
Tipo: inteiro

 ** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryCompute"></a>
Um objeto que contém as configurações de uso de Timestream Compute Units (TCUs) em sua conta para a carga de trabalho de consulta. QueryCompute está disponível somente na região Ásia-Pacífico (Mumbai).  
Tipo: objeto [QueryComputeResponse](API_query_QueryComputeResponse.md)

 ** [QueryPricingModel](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryPricingModel"></a>
Modelo de preços para consultas em sua conta.  
O parâmetro `QueryPricingModel` é usado por várias operações do Timestream, no entanto, a operação da API `UpdateAccountSettings` não reconhece nenhum valor além de `COMPUTE_UNITS`.
Tipo: string  
Valores válidos: `BYTES_SCANNED | COMPUTE_UNITS` 

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem as permissões necessárias para acessar as configurações da conta.  
Código de status HTTP: 400

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

## Consulte também
<a name="API_query_DescribeAccountSettings_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma linguagem específica AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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 retorna uma lista de endpoints disponíveis para fazer chamadas à API Timestream. Essa API está disponível por meio de gravação e consulta.

Como o SDKs Timestream foi projetado para trabalhar de forma transparente com a arquitetura do serviço, incluindo o gerenciamento e o mapeamento dos endpoints do serviço, *não é recomendável usar essa API, a menos que*:
+ Você está usando [endpoints da VPC (AWS PrivateLink) com Timestream ](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) 
+ Seu aplicativo usa uma linguagem de programação que ainda não tem suporte para SDK
+ Você precisa de um melhor controle sobre a implantação do lado do cliente

Para obter informações detalhadas sobre como e quando usar e implementar DescribeEndpoints, consulte [The Endpoint Discovery Pattern](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery).

## Sintaxe da resposta
<a name="API_query_DescribeEndpoints_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Endpoints](#API_query_DescribeEndpoints_ResponseSyntax) **   <a name="timestream-query_DescribeEndpoints-response-Endpoints"></a>
Um objeto `Endpoints` é retornado quando uma solicitação `DescribeEndpoints` é feita.  
Tipo: matriz de objetos [Endpoint](API_query_Endpoint.md)

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_DescribeEndpoints_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Fornece informações detalhadas a respeito de uma consulta agendada.

## Sintaxe da solicitação
<a name="API_query_DescribeScheduledQuery_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_query_DescribeScheduledQuery_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) **   <a name="timestream-query_DescribeScheduledQuery-request-ScheduledQueryArn"></a>
ARN da consulta agendada.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2048.  
Obrigatório: sim

## Sintaxe da resposta
<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 resposta
<a name="API_query_DescribeScheduledQuery_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

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

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem as permissões necessárias para acessar as configurações da conta.  
Código de status HTTP: 400

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
Não foi possível encontrar o recurso solicitado.    
 ** ScheduledQueryArn **   
ARN da consulta agendada.
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_DescribeScheduledQuery_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

 Você pode usar essa API para executar uma consulta agendada manualmente. 

Se você ativou `QueryInsights`, essa API também retornará insights e métricas relacionadas à consulta que você executou como parte de uma notificação do Amazon SNS. `QueryInsights` ajuda no ajuste do desempenho de sua consulta. Para mais informações sobre `QueryInsights`, consulte [Uso de insights de consulta para otimizar consultas no Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).

## Sintaxe da solicitação
<a name="API_query_ExecuteScheduledQuery_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_query_ExecuteScheduledQuery_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ClientToken"></a>
Não usado.   
Tipo: string  
Restrições de comprimento: comprimento mínimo de 32. O comprimento máximo é 128.  
Obrigatório: não

 ** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-InvocationTime"></a>
Registro de data/hora em UTC. A consulta será executada como se tivesse sido invocada nesse registro de data/hora.   
Tipo: Timestamp  
Obrigatório: sim

 ** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-QueryInsights"></a>
Encapsula as configurações para ativar o `QueryInsights`.  
A ativação do `QueryInsights` retorna insights e métricas como parte da notificação do Amazon SNS para a consulta executada. Você pode usar o `QueryInsights` para ajustar o desempenho e o custo de sua consulta.  
Tipo: objeto [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md)  
Obrigatório: não

 ** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ScheduledQueryArn"></a>
ARN da consulta agendada.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2048.  
Obrigatório: sim

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

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem as permissões necessárias para acessar as configurações da conta.  
Código de status HTTP: 400

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
Não foi possível encontrar o recurso solicitado.    
 ** ScheduledQueryArn **   
ARN da consulta agendada.
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

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

### Mensagem de notificação de consulta agendada para o modo ENABLED\$1WITH\$1RATE\$1CONTROL
<a name="API_query_ExecuteScheduledQuery_Example_1"></a>

O exemplo a seguir mostra uma mensagem de notificação de consulta agendada bem-sucedida para o modo `ENABLED_WITH_RATE_CONTROL` do 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
        }
    }
}
```

### Mensagem de notificação de consulta agendada para o modo DISABLED
<a name="API_query_ExecuteScheduledQuery_Example_2"></a>

O exemplo a seguir mostra uma mensagem de notificação de consulta agendada bem-sucedida para o modo `DISABLED` do 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
        }
    }
}
```

### Mensagem de notificação de falha para o modo ENABLED\$1WITH\$1RATE\$1CONTROL
<a name="API_query_ExecuteScheduledQuery_Example_3"></a>

O exemplo a seguir mostra uma mensagem de notificação de consulta agendada com falha para o modo `ENABLED_WITH_RATE_CONTROL` do 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"
    }
}
```

### Mensagem de notificação de falha para o modo DISABLED
<a name="API_query_ExecuteScheduledQuery_Example_4"></a>

O exemplo a seguir mostra uma mensagem de notificação de consulta agendada com falha para o modo `DISABLED` do 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"
    }
}
```

## Consulte também
<a name="API_query_ExecuteScheduledQuery_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Obtém uma lista de todas as consultas agendadas na conta e na região da Amazon do chamador. `ListScheduledQueries`eventualmente é consistente. 

## Sintaxe da solicitação
<a name="API_query_ListScheduledQueries_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_query_ListScheduledQueries_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-MaxResults"></a>
O número máximo de itens a retornar na saída. Se o número total de itens disponíveis for maior que o valor especificado, um `NextToken` será fornecido na saída. Para retomar a paginação, forneça o valor `NextToken` no argumento de um comando subsequente `ListScheduledQueriesRequest`.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 1. Valor máximo de 1.000.  
Obrigatório: não

 ** [NextToken](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-NextToken"></a>
 Um token de paginação para retomar a paginação.  
Tipo: string  
Obrigatório: não

## Sintaxe da resposta
<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 resposta
<a name="API_query_ListScheduledQueries_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [NextToken](#API_query_ListScheduledQueries_ResponseSyntax) **   <a name="timestream-query_ListScheduledQueries-response-NextToken"></a>
Um token para especificar onde iniciar a paginação. Isso é NextToken de uma resposta previamente truncada.  
Tipo: string

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

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem as permissões necessárias para acessar as configurações da conta.  
Código de status HTTP: 400

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_ListScheduledQueries_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Lista todas as tags em um recurso de consulta do Timestream.

## Sintaxe da solicitação
<a name="API_query_ListTagsForResource_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_query_ListTagsForResource_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-MaxResults"></a>
O número máximo de tarefas a serem retornadas.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 1. Valor máximo de 200.  
Obrigatório: não

 ** [NextToken](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-NextToken"></a>
Um token de paginação para retomar a paginação.  
Tipo: string  
Obrigatório: não

 ** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-ResourceARN"></a>
O recurso do Timestream com as tags a serem listadas. Esse valor é um nome do recurso da Amazon (ARN).  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2048.  
Obrigatório: sim

## Sintaxe da resposta
<a name="API_query_ListTagsForResource_ResponseSyntax"></a>

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

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [NextToken](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-NextToken"></a>
Um token de paginação para retomar a paginação com uma chamada subsequente para `ListTagsForResourceResponse`.  
Tipo: string

 ** [Tags](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-Tags"></a>
As tags atualmente associadas ao recurso Timestream.   
Tipo: matriz de objetos [Tag](API_query_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
Não foi possível encontrar o recurso solicitado.    
 ** ScheduledQueryArn **   
ARN da consulta agendada.
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_ListTagsForResource_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Uma operação síncrona que permite enviar uma consulta com parâmetros a serem armazenados pelo Timestream para execução posterior. O Timestream só suporta o uso desta operação com `ValidateOnly` definido como. `true` 

## Sintaxe da solicitação
<a name="API_query_PrepareQuery_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_query_PrepareQuery_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [QueryString](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-QueryString"></a>
A string de consulta Timestream que você deseja usar como uma instrução preparada. Nomes de parâmetros podem ser especificados no caractere `@` da string de consulta, seguido por um identificador.   
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 262144.  
Obrigatório: sim

 ** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-ValidateOnly"></a>
Ao definir esse valor como `true`, o Timestream só validará se a string de consulta é uma consulta Timestream válida e não armazenará a consulta preparada para uso posterior.  
Tipo: booliano  
Obrigatório: não

## Sintaxe da resposta
<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 resposta
<a name="API_query_PrepareQuery_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Columns](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Columns"></a>
Uma lista das colunas da cláusula SELECT da string de consulta enviada.   
Tipo: matriz de objetos [SelectColumn](API_query_SelectColumn.md)

 ** [Parameters](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Parameters"></a>
Uma lista de parâmetros usados na sequência de caracteres de consulta enviada.   
Tipo: matriz de objetos [ParameterMapping](API_query_ParameterMapping.md)

 ** [QueryString](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-QueryString"></a>
A sequência de caracteres de consulta que você deseja preparar.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 262144.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem as permissões necessárias para acessar as configurações da conta.  
Código de status HTTP: 400

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_PrepareQuery_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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` é uma operação síncrona que permite que você execute uma consulta em seus dados do Amazon Timestream.

Se você ativou `QueryInsights`, essa API também retornará informações e métricas relacionadas à consulta que você executou. `QueryInsights` ajuda no ajuste do desempenho de sua consulta. Para mais informações sobre `QueryInsights`, consulte [Uso de insights de consulta para otimizar consultas no Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).

**nota**  
O número máximo de solicitações de API `Query` que você pode fazer com o `QueryInsights` ativado é de 1 consulta por segundo (QPS). Se você exceder essa taxa de consulta, isso poderá resultar em um controle de utilização.

 `Query` atingirá o tempo limite após 60 segundos. Você deve atualizar o tempo limite padrão no SDK para suportar um tempo limite de 60 segundos. Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html) para obter detalhes. 

Sua solicitação de consulta falhará nos seguintes casos:
+  Se você enviar uma `Query` solicitação com o mesmo token de cliente fora da janela de idempotência de 5 minutos. 
+  Se você enviar uma `Query` solicitação com o mesmo token de cliente, mas alterar outros parâmetros, dentro da janela de idempotência de 5 minutos. 
+  Se o tamanho da linha (incluindo os metadados da consulta) exceder 1 MB, a consulta falhará com a seguinte mensagem de erro: 

   `Query aborted as max page response size has been exceeded by the output result row` 
+  Se o principal do IAM do iniciador da consulta e do leitor de resultados não forem os mesmos, and/or o iniciador da consulta e o leitor de resultados não tiverem a mesma string de consulta nas solicitações de consulta, a consulta falhará com um `Invalid pagination token` erro. 

## Sintaxe da solicitação
<a name="API_query_Query_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_query_Query_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ClientToken](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-ClientToken"></a>
 Sequência exclusiva, com distinção entre maiúsculas e minúsculas, de até 64 caracteres ASCII, especificada quando uma `Query` solicitação é feita. Fornecer um `ClientToken` torna a chamada `Query` *idempotente*. Isso significa que executar a mesma consulta repetidamente produzirá o mesmo resultado. Em outras palavras, fazer várias solicitações `Query` idênticas tem o mesmo efeito de se fazer uma única solicitação. Após o uso `ClientToken` em uma consulta, observe o seguinte:   
+  Se a API de consulta for instanciada sem um `ClientToken`, o SDK de consulta gerará um `ClientToken` em seu nome.
+ Se a `Query` invocação contiver apenas o, `ClientToken` mas não incluir um`NextToken`, essa invocação de será `Query` considerada uma nova execução de consulta.
+ Se a invocação contiver `NextToken`, essa invocação específica será considerada uma invocação subsequente de uma chamada anterior para a API de consulta e um conjunto de resultados será retornado.
+  Após 4 horas, qualquer solicitação com a mesma `ClientToken` é tratada como uma nova solicitação. 
Tipo: string  
Restrições de comprimento: comprimento mínimo de 32. O comprimento máximo é 128.  
Obrigatório: não

 ** [MaxRows](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-MaxRows"></a>
 O número total de itens para retornar na saída `Query`. A execução inicial de `Query` com um `MaxRows` valor especificado retornará o conjunto de resultados da consulta em dois casos:   
+ O tamanho do resultado é menor que `1MB`.
+ O número de linhas no conjunto de resultados é menor que o valor de `maxRows`.
Caso contrário, a invocação inicial de retorna `Query` apenas a `NextToken`, que pode ser usada em chamadas subsequentes para buscar o conjunto de resultados. Para retomar a paginação, forneça o valor `NextToken` no argumento de um comando subsequente.  
Se o tamanho da linha for grande (por exemplo, uma linha tem muitas colunas), o Timestream pode retornar menos linhas para evitar que o tamanho da resposta exceda o limite de 1 MB. Se não `MaxRows` for fornecido, o Timestream enviará o número necessário de linhas para atingir o limite de 1 MB.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 1. Valor máximo de 1.000.  
Obrigatório: não

 ** [NextToken](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-NextToken"></a>
 Um token de paginação usado para retornar um conjunto de resultados. Quando a API `Query` é invocada usando `NextToken`, essa invocação específica é considerada uma invocação subsequente de uma chamada anterior para `Query`, e um conjunto de resultados é retornado. No entanto, se a `Query` invocação contiver apenas o `ClientToken`, essa invocação de será `Query` considerada uma nova consulta executada.   
Observe o seguinte ao usar NextToken em uma consulta:  
+ Um token de paginação pode ser usado para até cinco `Query` invocações OU por uma duração de até 1 hora, o que ocorrer primeiro.
+ Usar o mesmo `NextToken` retornará o mesmo conjunto de registros. Para continuar paginando o conjunto de resultados, você deve usar o mais recente `nextToken`.
+ Suponha que uma `Query` invocação retorne dois `NextToken` valores, `TokenA` e `TokenB`. Se `TokenB` for usado em uma `Query` invocação subsequente, será invalidado e `TokenA` não poderá ser reutilizado.
+ Para solicitar um conjunto de resultados anterior de uma consulta após o início da paginação, você deve invocar novamente a API de consulta.
+ O último `NextToken` deve ser usado para paginar até `null` ser retornado, momento em que um novo `NextToken` deve ser usado.
+  Se o principal do IAM do iniciador da consulta e do leitor de resultados não forem os mesmos, and/or o iniciador da consulta e o leitor de resultados não tiverem a mesma string de consulta nas solicitações de consulta, a consulta falhará com um `Invalid pagination token` erro. 
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2.048.  
Obrigatório: não

 ** [QueryInsights](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryInsights"></a>
Encapsula as configurações para ativar o `QueryInsights`.  
A ativação `QueryInsights` retorna insights e métricas, além dos resultados da consulta que você executou. Você pode usar `QueryInsights` para ajustar o desempenho da consulta.  
Tipo: objeto [QueryInsights](API_query_QueryInsights.md)  
Obrigatório: não

 ** [QueryString](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryString"></a>
 A consulta a ser executada pelo Timestream.   
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 262144.  
Obrigatório: sim

## Sintaxe da resposta
<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 resposta
<a name="API_query_Query_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [ColumnInfo](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-ColumnInfo"></a>
 Os tipos de dados da coluna do conjunto de resultados retornado.   
Tipo: matriz de objetos [ColumnInfo](API_query_ColumnInfo.md)

 ** [NextToken](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-NextToken"></a>
 Um token de paginação que pode ser usado novamente em uma `Query` chamada para obter o próximo conjunto de resultados.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2.048.

 ** [QueryId](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryId"></a>
 Um ID exclusivo para a consulta em questão.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `[a-zA-Z0-9]+` 

 ** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryInsightsResponse"></a>
Encapsulamentos `QueryInsights` contendo insights e métricas relacionadas à consulta que você executou.  
Tipo: objeto [QueryInsightsResponse](API_query_QueryInsightsResponse.md)

 ** [QueryStatus](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryStatus"></a>
Informações sobre o status da consulta, incluindo progresso e bytes examinados.  
Tipo: objeto [QueryStatus](API_query_QueryStatus.md)

 ** [Rows](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-Rows"></a>
 As linhas do conjunto de resultados retornado pela consulta.   
Tipo: matriz de objetos [Row](API_query_Row.md)

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem as permissões necessárias para acessar as configurações da conta.  
Código de status HTTP: 400

 ** ConflictException **   
 Não é possível obter resultados de uma consulta cancelada.   
Código de status HTTP: 400

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** QueryExecutionException **   
 O Timestream não conseguiu executar a consulta com êxito.   
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_Query_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Associa um conjunto de etiquetas a um recurso do Timestream. Em seguida, você pode ativar essas tags definidas pelo usuário para que elas apareçam no console de Faturamento e Gerenciamento de custos para o controle da alocação de custos. 

## Sintaxe da solicitação
<a name="API_query_TagResource_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_query_TagResource_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ResourceARN](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-ResourceARN"></a>
Identifica o recurso Timestream ao qual as tags devem ser adicionadas. Esse valor é um nome do recurso da Amazon (ARN).  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2048.  
Obrigatório: sim

 ** [Tags](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-Tags"></a>
As tags a serem atribuídas ao recurso do Amazon Neptune.  
Tipo: matriz de objetos [Tag](API_query_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: sim

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

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
Não foi possível encontrar o recurso solicitado.    
 ** ScheduledQueryArn **   
ARN da consulta agendada.
Código de status HTTP: 400

 ** ServiceQuotaExceededException **   
Service quota excedida.  
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_TagResource_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Remove a associação de tags de um recurso de consulta do Timestream.

## Sintaxe da solicitação
<a name="API_query_UntagResource_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_query_UntagResource_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ResourceARN](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-ResourceARN"></a>
O recurso do Timestream do qual as tags serão removidas. Esse valor é um nome do recurso da Amazon (ARN).   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2048.  
Obrigatório: sim

 ** [TagKeys](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-TagKeys"></a>
Uma lista de chaves de tags. As tags existentes do recurso cujas chaves são membros dessa lista serão removidas do recurso Timestream.   
Tipo: matriz de strings  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 128.  
Obrigatório: sim

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

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
Não foi possível encontrar o recurso solicitado.    
 ** ScheduledQueryArn **   
ARN da consulta agendada.
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_UntagResource_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Faz a transição da sua conta TCUs para uso nos preços de consulta e modifica o máximo de unidades computacionais de consulta que você configurou. Se você reduzir o valor de `MaxQueryTCU` para a configuração desejada, o novo valor poderá levar até 24 horas para entrar em vigor.

**nota**  
Depois de fazer a transição de sua conta TCUs para uso nos preços de consulta, você não pode fazer a transição para o uso de bytes escaneados para preços de consulta.

## Sintaxe da solicitação
<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 da solicitação
<a name="API_query_UpdateAccountSettings_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-MaxQueryTCU"></a>
O número máximo de unidades de computação que o serviço usará em qualquer momento para atender às suas consultas. Para realizar consultas, é necessário estabelecer uma capacidade mínima de 4 TCU. É possível estabelecer o número máximo de TCU em múltiplos de 4, como 4, 8, 16, 32 e assim por diante. O valor máximo compatível para `MaxQueryTCU` é de 1000. Para solicitar um aumento desse limite flexível, entre em contato com o AWS Support. Para obter mais informações sobre cotas padrão para maxQueryTCU, consulte Cotas padrão. Essa configuração é aplicável somente para o uso sob demanda de Timestream Compute Units (). TCUs  
O valor máximo compatível para `MaxQueryTCU` é de 1000. Para solicitar um aumento desse limite flexível, entre em contato com o AWS Support. Para obter mais informações sobre cotas padrão para`maxQueryTCU`, consulte [Cotas padrão](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.default).  
Tipo: inteiro  
Obrigatório: não

 ** [QueryCompute](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryCompute"></a>
Modifica as configurações de computação de consulta definidas em sua conta, incluindo o modelo de preços de consulta e as unidades de computação Timestream provisionadas () em sua conta. TCUs QueryCompute está disponível somente na região Ásia-Pacífico (Mumbai).  
Essa API é idempotente, o que significa que fazer a mesma solicitação várias vezes terá o mesmo efeito que fazer a solicitação uma vez.
Tipo: objeto [QueryComputeRequest](API_query_QueryComputeRequest.md)  
Obrigatório: não

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryPricingModel"></a>
O modelo de preços para consultas em uma conta.  
O parâmetro `QueryPricingModel` é usado por várias operações do Timestream, no entanto, a operação da API `UpdateAccountSettings` não reconhece nenhum valor além de `COMPUTE_UNITS`.
Tipo: string  
Valores válidos: `BYTES_SCANNED | COMPUTE_UNITS`   
Obrigatório: não

## Sintaxe da resposta
<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 resposta
<a name="API_query_UpdateAccountSettings_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-MaxQueryTCU"></a>
O número máximo configurado de unidades de computação que o serviço usará em qualquer momento para atender às suas consultas.  
Tipo: inteiro

 ** [QueryCompute](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryCompute"></a>
Confirma as configurações atualizadas da conta para consultar dados em sua conta. QueryCompute está disponível somente na região Ásia-Pacífico (Mumbai).  
Tipo: objeto [QueryComputeResponse](API_query_QueryComputeResponse.md)

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryPricingModel"></a>
O modelo de preços de uma conta.  
Tipo: string  
Valores válidos: `BYTES_SCANNED | COMPUTE_UNITS` 

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem as permissões necessárias para acessar as configurações da conta.  
Código de status HTTP: 400

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_UpdateAccountSettings_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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>

Atualizar uma consulta agendada.

## Sintaxe da solicitação
<a name="API_query_UpdateScheduledQuery_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_query_UpdateScheduledQuery_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-ScheduledQueryArn"></a>
ARN da consulta agendada.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2048.  
Obrigatório: sim

 ** [State](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-State"></a>
Estado da consulta agendada.   
Tipo: string  
Valores válidos: `ENABLED | DISABLED`   
Obrigatório: sim

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

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem as permissões necessárias para acessar as configurações da conta.  
Código de status HTTP: 400

 ** InternalServerException **   
Ocorreu um erro interno ao processar a solicitação.  
Código de status HTTP: 400

 ** InvalidEndpointException **   
O endpoint solicitado é inválido.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
Não foi possível encontrar o recurso solicitado.    
 ** ScheduledQueryArn **   
ARN da consulta agendada.
Código de status HTTP: 400

 ** ThrottlingException **   
A solicitação foi restringida devido ao excesso de solicitações.  
Código de status HTTP: 400

 ** ValidationException **   
 Solicitação inválida ou malformada.   
Código de status HTTP: 400

## Consulte também
<a name="API_query_UpdateScheduledQuery_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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) 

# Tipos de dados
<a name="API_Types"></a>

Os seguintes tipos de dados são compatíveis com a gravação do Amazon Timestream:
+  [BatchLoadProgressReport](API_BatchLoadProgressReport.md) 
+  [BatchLoadTask](API_BatchLoadTask.md) 
+  [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) 
+  [CsvConfiguration](API_CsvConfiguration.md) 
+  [Database](API_Database.md) 
+  [DataModel](API_DataModel.md) 
+  [DataModelConfiguration](API_DataModelConfiguration.md) 
+  [DataModelS3Configuration](API_DataModelS3Configuration.md) 
+  [DataSourceConfiguration](API_DataSourceConfiguration.md) 
+  [DataSourceS3Configuration](API_DataSourceS3Configuration.md) 
+  [Dimension](API_Dimension.md) 
+  [DimensionMapping](API_DimensionMapping.md) 
+  [Endpoint](API_Endpoint.md) 
+  [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) 
+  [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) 
+  [MeasureValue](API_MeasureValue.md) 
+  [MixedMeasureMapping](API_MixedMeasureMapping.md) 
+  [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) 
+  [MultiMeasureMappings](API_MultiMeasureMappings.md) 
+  [PartitionKey](API_PartitionKey.md) 
+  [Record](API_Record.md) 
+  [RecordsIngested](API_RecordsIngested.md) 
+  [RejectedRecord](API_RejectedRecord.md) 
+  [ReportConfiguration](API_ReportConfiguration.md) 
+  [ReportS3Configuration](API_ReportS3Configuration.md) 
+  [RetentionProperties](API_RetentionProperties.md) 
+  [S3Configuration](API_S3Configuration.md) 
+  [Schema](API_Schema.md) 
+  [Table](API_Table.md) 
+  [Tag](API_Tag.md) 

Os seguintes tipos de dados são compatíveis com a consulta do Amazon Timestream:
+  [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) 
+  [ColumnInfo](API_query_ColumnInfo.md) 
+  [Datum](API_query_Datum.md) 
+  [DimensionMapping](API_query_DimensionMapping.md) 
+  [Endpoint](API_query_Endpoint.md) 
+  [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) 
+  [ErrorReportLocation](API_query_ErrorReportLocation.md) 
+  [ExecutionStats](API_query_ExecutionStats.md) 
+  [LastUpdate](API_query_LastUpdate.md) 
+  [MixedMeasureMapping](API_query_MixedMeasureMapping.md) 
+  [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) 
+  [MultiMeasureMappings](API_query_MultiMeasureMappings.md) 
+  [NotificationConfiguration](API_query_NotificationConfiguration.md) 
+  [ParameterMapping](API_query_ParameterMapping.md) 
+  [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) 
+  [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) 
+  [QueryComputeRequest](API_query_QueryComputeRequest.md) 
+  [QueryComputeResponse](API_query_QueryComputeResponse.md) 
+  [QueryInsights](API_query_QueryInsights.md) 
+  [QueryInsightsResponse](API_query_QueryInsightsResponse.md) 
+  [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) 
+  [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) 
+  [QueryStatus](API_query_QueryStatus.md) 
+  [QueryTemporalRange](API_query_QueryTemporalRange.md) 
+  [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) 
+  [Row](API_query_Row.md) 
+  [S3Configuration](API_query_S3Configuration.md) 
+  [S3ReportLocation](API_query_S3ReportLocation.md) 
+  [ScheduleConfiguration](API_query_ScheduleConfiguration.md) 
+  [ScheduledQuery](API_query_ScheduledQuery.md) 
+  [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) 
+  [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) 
+  [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) 
+  [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) 
+  [SelectColumn](API_query_SelectColumn.md) 
+  [SnsConfiguration](API_query_SnsConfiguration.md) 
+  [Tag](API_query_Tag.md) 
+  [TargetConfiguration](API_query_TargetConfiguration.md) 
+  [TargetDestination](API_query_TargetDestination.md) 
+  [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) 
+  [TimestreamConfiguration](API_query_TimestreamConfiguration.md) 
+  [TimestreamDestination](API_query_TimestreamDestination.md) 
+  [Type](API_query_Type.md) 

# Gravação do Amazon Timestream
<a name="API_Types_Amazon_Timestream_Write"></a>

Os seguintes tipos de dados são compatíveis com a gravação do Amazon Timestream:
+  [BatchLoadProgressReport](API_BatchLoadProgressReport.md) 
+  [BatchLoadTask](API_BatchLoadTask.md) 
+  [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) 
+  [CsvConfiguration](API_CsvConfiguration.md) 
+  [Database](API_Database.md) 
+  [DataModel](API_DataModel.md) 
+  [DataModelConfiguration](API_DataModelConfiguration.md) 
+  [DataModelS3Configuration](API_DataModelS3Configuration.md) 
+  [DataSourceConfiguration](API_DataSourceConfiguration.md) 
+  [DataSourceS3Configuration](API_DataSourceS3Configuration.md) 
+  [Dimension](API_Dimension.md) 
+  [DimensionMapping](API_DimensionMapping.md) 
+  [Endpoint](API_Endpoint.md) 
+  [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) 
+  [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) 
+  [MeasureValue](API_MeasureValue.md) 
+  [MixedMeasureMapping](API_MixedMeasureMapping.md) 
+  [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) 
+  [MultiMeasureMappings](API_MultiMeasureMappings.md) 
+  [PartitionKey](API_PartitionKey.md) 
+  [Record](API_Record.md) 
+  [RecordsIngested](API_RecordsIngested.md) 
+  [RejectedRecord](API_RejectedRecord.md) 
+  [ReportConfiguration](API_ReportConfiguration.md) 
+  [ReportS3Configuration](API_ReportS3Configuration.md) 
+  [RetentionProperties](API_RetentionProperties.md) 
+  [S3Configuration](API_S3Configuration.md) 
+  [Schema](API_Schema.md) 
+  [Table](API_Table.md) 
+  [Tag](API_Tag.md) 

# BatchLoadProgressReport
<a name="API_BatchLoadProgressReport"></a>

Detalhes sobre o progresso de uma tarefa de carregamento em lote.

## Conteúdo
<a name="API_BatchLoadProgressReport_Contents"></a>

 ** BytesMetered **   <a name="timestream-Type-BatchLoadProgressReport-BytesMetered"></a>
  
Tipo: longo  
Obrigatório: não

 ** FileFailures **   <a name="timestream-Type-BatchLoadProgressReport-FileFailures"></a>
  
Tipo: longo  
Obrigatório: não

 ** ParseFailures **   <a name="timestream-Type-BatchLoadProgressReport-ParseFailures"></a>
  
Tipo: longo  
Obrigatório: não

 ** RecordIngestionFailures **   <a name="timestream-Type-BatchLoadProgressReport-RecordIngestionFailures"></a>
  
Tipo: longo  
Obrigatório: não

 ** RecordsIngested **   <a name="timestream-Type-BatchLoadProgressReport-RecordsIngested"></a>
  
Tipo: longo  
Obrigatório: não

 ** RecordsProcessed **   <a name="timestream-Type-BatchLoadProgressReport-RecordsProcessed"></a>
  
Tipo: longo  
Obrigatório: não

## Consulte também
<a name="API_BatchLoadProgressReport_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadProgressReport) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadProgressReport) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadProgressReport) 

# BatchLoadTask
<a name="API_BatchLoadTask"></a>

Detalhes sobre uma tarefa de carregamento em lote.

## Conteúdo
<a name="API_BatchLoadTask_Contents"></a>

 ** CreationTime **   <a name="timestream-Type-BatchLoadTask-CreationTime"></a>
A hora em que a tarefa de carregamento em lote do Timestream foi criada.  
Tipo: Timestamp  
Obrigatório: não

 ** DatabaseName **   <a name="timestream-Type-BatchLoadTask-DatabaseName"></a>
Nome do banco de dados para o banco de dados onde uma tarefa de carregamento em lote insere dados.  
Tipo: string  
Obrigatório: não

 ** LastUpdatedTime **   <a name="timestream-Type-BatchLoadTask-LastUpdatedTime"></a>
A hora em que a tarefa de carregamento em lote do Timestream foi atualizada pela última vez.  
Tipo: Timestamp  
Obrigatório: não

 ** ResumableUntil **   <a name="timestream-Type-BatchLoadTask-ResumableUntil"></a>
   
Tipo: Timestamp  
Obrigatório: não

 ** TableName **   <a name="timestream-Type-BatchLoadTask-TableName"></a>
Nome da tabela na qual uma tarefa de carregamento em lote carrega dados.  
Tipo: string  
Obrigatório: não

 ** TaskId **   <a name="timestream-Type-BatchLoadTask-TaskId"></a>
ID da tarefa de carregamento em lote.  
Tipo: string  
Restrições de tamanho: comprimento mínimo de 3. Comprimento máximo de 32.  
Padrão: `[A-Z0-9]+`   
Obrigatório: não

 ** TaskStatus **   <a name="timestream-Type-BatchLoadTask-TaskStatus"></a>
Status da tarefa de carregamento em lote.  
Tipo: string  
Valores válidos: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME`   
Obrigatório: não

## Consulte também
<a name="API_BatchLoadTask_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTask) 

# BatchLoadTaskDescription
<a name="API_BatchLoadTaskDescription"></a>

Detalhes sobre uma tarefa de carregamento em lote.

## Conteúdo
<a name="API_BatchLoadTaskDescription_Contents"></a>

 ** CreationTime **   <a name="timestream-Type-BatchLoadTaskDescription-CreationTime"></a>
A hora em que a tarefa de carregamento em lote do Timestream foi criada.  
Tipo: Timestamp  
Obrigatório: não

 ** DataModelConfiguration **   <a name="timestream-Type-BatchLoadTaskDescription-DataModelConfiguration"></a>
Configuração do modelo de dados para uma tarefa de carregamento em lote. Contém detalhes sobre onde um modelo de dados para uma tarefa de carregamento em lote é armazenado.  
Tipo: objeto [DataModelConfiguration](API_DataModelConfiguration.md)  
Obrigatório: não

 ** DataSourceConfiguration **   <a name="timestream-Type-BatchLoadTaskDescription-DataSourceConfiguration"></a>
Detalhes de configuração sobre a fonte de dados para uma tarefa de carregamento em lote.  
Tipo: objeto [DataSourceConfiguration](API_DataSourceConfiguration.md)  
Obrigatório: não

 ** ErrorMessage **   <a name="timestream-Type-BatchLoadTaskDescription-ErrorMessage"></a>
  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: não

 ** LastUpdatedTime **   <a name="timestream-Type-BatchLoadTaskDescription-LastUpdatedTime"></a>
A hora em que a tarefa de carregamento em lote do Timestream foi atualizada pela última vez.  
Tipo: Timestamp  
Obrigatório: não

 ** ProgressReport **   <a name="timestream-Type-BatchLoadTaskDescription-ProgressReport"></a>
  
Tipo: objeto [BatchLoadProgressReport](API_BatchLoadProgressReport.md)  
Obrigatório: não

 ** RecordVersion **   <a name="timestream-Type-BatchLoadTaskDescription-RecordVersion"></a>
  
Tipo: longo  
Obrigatório: não

 ** ReportConfiguration **   <a name="timestream-Type-BatchLoadTaskDescription-ReportConfiguration"></a>
Configuração do relatório para uma tarefa de carregamento em lote. Contém detalhes sobre onde os relatórios de erros são armazenados.  
Tipo: objeto [ReportConfiguration](API_ReportConfiguration.md)  
Obrigatório: não

 ** ResumableUntil **   <a name="timestream-Type-BatchLoadTaskDescription-ResumableUntil"></a>
   
Tipo: Timestamp  
Obrigatório: não

 ** TargetDatabaseName **   <a name="timestream-Type-BatchLoadTaskDescription-TargetDatabaseName"></a>
  
Tipo: string  
Obrigatório: não

 ** TargetTableName **   <a name="timestream-Type-BatchLoadTaskDescription-TargetTableName"></a>
  
Tipo: string  
Obrigatório: não

 ** TaskId **   <a name="timestream-Type-BatchLoadTaskDescription-TaskId"></a>
O ID da tarefa de carregamento em lote.  
Tipo: string  
Restrições de tamanho: comprimento mínimo de 3. Comprimento máximo de 32.  
Padrão: `[A-Z0-9]+`   
Obrigatório: não

 ** TaskStatus **   <a name="timestream-Type-BatchLoadTaskDescription-TaskStatus"></a>
Status da tarefa de carregamento em lote.  
Tipo: string  
Valores válidos: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME`   
Obrigatório: não

## Consulte também
<a name="API_BatchLoadTaskDescription_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTaskDescription) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTaskDescription) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTaskDescription) 

# CsvConfiguration
<a name="API_CsvConfiguration"></a>

Um formato de dados delimitado em que o separador de colunas pode ser uma vírgula e o separador de registros é um caractere de nova linha.

## Conteúdo
<a name="API_CsvConfiguration_Contents"></a>

 ** ColumnSeparator **   <a name="timestream-Type-CsvConfiguration-ColumnSeparator"></a>
O separador de colunas pode ser vírgula (','), barra vertical ('\$1), ponto e vírgula (';'), tabulação ('/t') ou espaço em branco ('').   
Tipo: string  
Restrições de comprimento: comprimento fixo de 1.  
Obrigatório: não

 ** EscapeChar **   <a name="timestream-Type-CsvConfiguration-EscapeChar"></a>
O caractere de escape pode ser um dos   
Tipo: string  
Restrições de comprimento: comprimento fixo de 1.  
Obrigatório: não

 ** NullValue **   <a name="timestream-Type-CsvConfiguration-NullValue"></a>
Pode ser um espaço em branco ('').  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.  
Obrigatório: não

 ** QuoteChar **   <a name="timestream-Type-CsvConfiguration-QuoteChar"></a>
Podem ser aspas simples (') ou aspas duplas (“).  
Tipo: string  
Restrições de comprimento: comprimento fixo de 1.  
Obrigatório: não

 ** TrimWhiteSpace **   <a name="timestream-Type-CsvConfiguration-TrimWhiteSpace"></a>
Especifica a redução dos espaços em branco à esquerda e à direita.  
Tipo: booliano  
Obrigatório: não

## Consulte também
<a name="API_CsvConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CsvConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CsvConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CsvConfiguration) 

# Database
<a name="API_Database"></a>

Um contêiner de nível superior para uma mesa. Bancos de dados e tabelas são os conceitos fundamentais de gerenciamento no Amazon Timestream. Todas as tabelas em um banco de dados são criptografadas com a mesma chave AWS KMS.

## Conteúdo
<a name="API_Database_Contents"></a>

 ** Arn **   <a name="timestream-Type-Database-Arn"></a>
O nome do recurso da Amazon que identifica exclusivamente esse banco de dados.  
Tipo: string  
Obrigatório: não

 ** CreationTime **   <a name="timestream-Type-Database-CreationTime"></a>
A hora em que o banco de dados foi criado, calculada a partir da época do Unix.  
Tipo: Timestamp  
Obrigatório: não

 ** DatabaseName **   <a name="timestream-Type-Database-DatabaseName"></a>
O nome do banco de dados do Timestream.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 3. Tamanho máximo de 256.  
Obrigatório: não

 ** KmsKeyId **   <a name="timestream-Type-Database-KmsKeyId"></a>
O identificador da chave do AWS KMS usada para criptografar os dados armazenados no banco de dados.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: não

 ** LastUpdatedTime **   <a name="timestream-Type-Database-LastUpdatedTime"></a>
 A hora em que essa fonte de dados foi atualizada pela última vez.   
Tipo: Timestamp  
Obrigatório: não

 ** TableCount **   <a name="timestream-Type-Database-TableCount"></a>
O número total de tabelas encontradas em um banco de dados Timestream.   
Tipo: longo  
Obrigatório: não

## Consulte também
<a name="API_Database_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Database) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Database) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Database) 

# DataModel
<a name="API_DataModel"></a>

Modelo de dados para uma tarefa de carregamento em lote.

## Conteúdo
<a name="API_DataModel_Contents"></a>

 ** DimensionMappings **   <a name="timestream-Type-DataModel-DimensionMappings"></a>
Mapeamentos de origem para destino para dimensões.  
Tipo: matriz de objetos [DimensionMapping](API_DimensionMapping.md)  
Membros da matriz: número mínimo de 1 item.  
Obrigatório: sim

 ** MeasureNameColumn **   <a name="timestream-Type-DataModel-MeasureNameColumn"></a>
  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.  
Obrigatório: não

 ** MixedMeasureMappings **   <a name="timestream-Type-DataModel-MixedMeasureMappings"></a>
Mapeamentos de origem para destino para medidas.  
Tipo: matriz de objetos [MixedMeasureMapping](API_MixedMeasureMapping.md)  
Membros da matriz: número mínimo de 1 item.  
Obrigatório: não

 ** MultiMeasureMappings **   <a name="timestream-Type-DataModel-MultiMeasureMappings"></a>
Mapeamentos de origem para destino para registros de várias medidas.  
Tipo: objeto [MultiMeasureMappings](API_MultiMeasureMappings.md)  
Obrigatório: não

 ** TimeColumn **   <a name="timestream-Type-DataModel-TimeColumn"></a>
Coluna de origem a ser mapeada para o tempo.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.  
Obrigatório: não

 ** TimeUnit **   <a name="timestream-Type-DataModel-TimeUnit"></a>
 A granularidade da unidade de registro de data e hora. Indica se o valor do tempo está em segundos, milissegundos, nanossegundos ou outros valores compatíveis. O padrão é `MILLISECONDS`.   
Tipo: string  
Valores válidos: `MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS`   
Obrigatório: não

## Consulte também
<a name="API_DataModel_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModel) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModel) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModel) 

# DataModelConfiguration
<a name="API_DataModelConfiguration"></a>



## Conteúdo
<a name="API_DataModelConfiguration_Contents"></a>

 ** DataModel **   <a name="timestream-Type-DataModelConfiguration-DataModel"></a>
  
Tipo: objeto [DataModel](API_DataModel.md)  
Obrigatório: não

 ** DataModelS3Configuration **   <a name="timestream-Type-DataModelConfiguration-DataModelS3Configuration"></a>
  
Tipo: objeto [DataModelS3Configuration](API_DataModelS3Configuration.md)  
Obrigatório: não

## Consulte também
<a name="API_DataModelConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelConfiguration) 

# DataModelS3Configuration
<a name="API_DataModelS3Configuration"></a>



## Conteúdo
<a name="API_DataModelS3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-DataModelS3Configuration-BucketName"></a>
  
Tipo: String  
Restrições de tamanho: comprimento mínimo de 3. Tamanho máximo de 63.  
Padrão: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Obrigatório: Não

 ** ObjectKey **   <a name="timestream-Type-DataModelS3Configuration-ObjectKey"></a>
  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.  
Padrão: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obrigatório: Não

## Consulte também
<a name="API_DataModelS3Configuration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelS3Configuration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelS3Configuration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelS3Configuration) 

# DataSourceConfiguration
<a name="API_DataSourceConfiguration"></a>

Define detalhes de configuração sobre a fonte de dados.

## Conteúdo
<a name="API_DataSourceConfiguration_Contents"></a>

 ** DataFormat **   <a name="timestream-Type-DataSourceConfiguration-DataFormat"></a>
Atualmente, é CSV.  
Tipo: string  
Valores válidos: `CSV`   
Obrigatório: sim

 ** DataSourceS3Configuration **   <a name="timestream-Type-DataSourceConfiguration-DataSourceS3Configuration"></a>
Configuração de um local do S3 para um arquivo que contém dados a serem carregados.  
Tipo: objeto [DataSourceS3Configuration](API_DataSourceS3Configuration.md)  
Obrigatório: sim

 ** CsvConfiguration **   <a name="timestream-Type-DataSourceConfiguration-CsvConfiguration"></a>
Um formato de dados delimitado em que o separador de colunas pode ser uma vírgula e o separador de registros é um caractere de nova linha.  
Tipo: objeto [CsvConfiguration](API_CsvConfiguration.md)  
Obrigatório: não

## Consulte também
<a name="API_DataSourceConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceConfiguration) 

# DataSourceS3Configuration
<a name="API_DataSourceS3Configuration"></a>

 

## Conteúdo
<a name="API_DataSourceS3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-DataSourceS3Configuration-BucketName"></a>
O nome de bucket do bucket do cliente do S3.  
Tipo: String  
Restrições de tamanho: comprimento mínimo de 3. Tamanho máximo de 63.  
Padrão: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Exigido: Sim

 ** ObjectKeyPrefix **   <a name="timestream-Type-DataSourceS3Configuration-ObjectKeyPrefix"></a>
   
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.  
Padrão: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obrigatório: Não

## Consulte também
<a name="API_DataSourceS3Configuration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceS3Configuration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceS3Configuration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceS3Configuration) 

# Dimension
<a name="API_Dimension"></a>

Representa os atributos de metadados da série temporal. Por exemplo, o nome e a zona de disponibilidade de uma instância do EC2 ou o nome do fabricante de uma turbina eólica são dimensões. 

## Conteúdo
<a name="API_Dimension_Contents"></a>

 ** Name **   <a name="timestream-Type-Dimension-Name"></a>
 A dimensão representa os atributos de metadados da série temporal. Por exemplo, o nome e a zona de disponibilidade de uma instância do EC2 ou o nome do fabricante de uma turbina eólica são dimensões.   
Para restrições sobre nomes de dimensões, consulte [Restrições de nomenclatura](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming).  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 60.  
Obrigatório: sim

 ** Value **   <a name="timestream-Type-Dimension-Value"></a>
O valor da dimensão.  
Tipo: string  
Obrigatório: sim

 ** DimensionValueType **   <a name="timestream-Type-Dimension-DimensionValueType"></a>
O tipo de dados da dimensão para o ponto de dados de séries temporais.  
Tipo: string  
Valores válidos: `VARCHAR`   
Obrigatório: não

## Consulte também
<a name="API_Dimension_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Dimension) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Dimension) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Dimension) 

# DimensionMapping
<a name="API_DimensionMapping"></a>



## Conteúdo
<a name="API_DimensionMapping_Contents"></a>

 ** DestinationColumn **   <a name="timestream-Type-DimensionMapping-DestinationColumn"></a>
   
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1.  
Obrigatório: Não

 ** SourceColumn **   <a name="timestream-Type-DimensionMapping-SourceColumn"></a>
  
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1.  
Obrigatório: Não

## Consulte também
<a name="API_DimensionMapping_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DimensionMapping) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DimensionMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DimensionMapping) 

# Endpoint
<a name="API_Endpoint"></a>

Representa um endpoint disponível para fazer chamadas de API, bem como o TTL desse endpoint.

## Conteúdo
<a name="API_Endpoint_Contents"></a>

 ** Address **   <a name="timestream-Type-Endpoint-Address"></a>
Um endereço de endpoint.  
Tipo: string  
Obrigatório: sim

 ** CachePeriodInMinutes **   <a name="timestream-Type-Endpoint-CachePeriodInMinutes"></a>
O TTL para o endpoint, em minutos.  
Tipo: longo  
Obrigatório: sim

## Consulte também
<a name="API_Endpoint_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Endpoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Endpoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Endpoint) 

# MagneticStoreRejectedDataLocation
<a name="API_MagneticStoreRejectedDataLocation"></a>

O local no qual gravar relatórios de erros para registros rejeitados, de forma assíncrona, durante gravações de armazenamento magnético.

## Conteúdo
<a name="API_MagneticStoreRejectedDataLocation_Contents"></a>

 ** S3Configuration **   <a name="timestream-Type-MagneticStoreRejectedDataLocation-S3Configuration"></a>
A configuração de um local do S3 no qual gravar relatórios de erros para registros rejeitados, de forma assíncrona, durante gravações de armazenamento magnético.  
Tipo: objeto [S3Configuration](API_S3Configuration.md)  
Obrigatório: Não

## Consulte também
<a name="API_MagneticStoreRejectedDataLocation_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) 

# MagneticStoreWriteProperties
<a name="API_MagneticStoreWriteProperties"></a>

O conjunto de propriedades em uma tabela para configurar gravações em armazenamento magnético.

## Conteúdo
<a name="API_MagneticStoreWriteProperties_Contents"></a>

 ** EnableMagneticStoreWrites **   <a name="timestream-Type-MagneticStoreWriteProperties-EnableMagneticStoreWrites"></a>
Um sinalizador para habilitar gravações em armazenamento magnético.  
Tipo: booliano  
Obrigatório: Sim

 ** MagneticStoreRejectedDataLocation **   <a name="timestream-Type-MagneticStoreWriteProperties-MagneticStoreRejectedDataLocation"></a>
O local no qual gravar relatórios de erros para registros rejeitados, de forma assíncrona, durante gravações em armazenamento magnético.  
Tipo: objeto [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md)  
Obrigatório: Não

## Consulte também
<a name="API_MagneticStoreWriteProperties_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreWriteProperties) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreWriteProperties) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreWriteProperties) 

# MeasureValue
<a name="API_MeasureValue"></a>

 Representa o atributo de dados da série temporal. Por exemplo, a utilização da CPU de uma instância do EC2 ou a RPM de uma turbina eólica são medidas. MeasureValue tem nome e valor. 

 MeasureValue só é permitido para tipo `MULTI`. Usando o tipo `MULTI`, você pode passar vários atributos de dados associados à mesma série temporal em um único registro 

## Conteúdo
<a name="API_MeasureValue_Contents"></a>

 ** Name **   <a name="timestream-Type-MeasureValue-Name"></a>
 Nome do MeasureValue.   
 Para restrições sobre nomes de MeasureValue, consulte [Restrições de nomenclatura no Guia do desenvolvedor](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming) do Amazon Timestream.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1.  
Obrigatório: sim

 ** Type **   <a name="timestream-Type-MeasureValue-Type"></a>
Contém o tipo de dados do MeasureValue para o ponto de dados de série temporal.  
Tipo: string  
Valores válidos: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI`   
Obrigatório: sim

 ** Value **   <a name="timestream-Type-MeasureValue-Value"></a>
 Valor do MeasureValue. Para mais informações, consulte [Tipos de dados](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types).  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: sim

## Consulte também
<a name="API_MeasureValue_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MeasureValue) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MeasureValue) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MeasureValue) 

# MixedMeasureMapping
<a name="API_MixedMeasureMapping"></a>



## Conteúdo
<a name="API_MixedMeasureMapping_Contents"></a>

 ** MeasureValueType **   <a name="timestream-Type-MixedMeasureMapping-MeasureValueType"></a>
  
Tipo: String  
Valores Válidos: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI`   
Obrigatório: sim

 ** MeasureName **   <a name="timestream-Type-MixedMeasureMapping-MeasureName"></a>
  
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1.  
Obrigatório: Não

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-MixedMeasureMapping-MultiMeasureAttributeMappings"></a>
  
Tipo: Matriz de objetos [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md)  
Membros da matriz: número mínimo de 1 item.  
Obrigatório: Não

 ** SourceColumn **   <a name="timestream-Type-MixedMeasureMapping-SourceColumn"></a>
  
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1.  
Obrigatório: Não

 ** TargetMeasureName **   <a name="timestream-Type-MixedMeasureMapping-TargetMeasureName"></a>
  
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1.  
Obrigatório: Não

## Consulte também
<a name="API_MixedMeasureMapping_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MixedMeasureMapping) 

# MultiMeasureAttributeMapping
<a name="API_MultiMeasureAttributeMapping"></a>



## Conteúdo
<a name="API_MultiMeasureAttributeMapping_Contents"></a>

 ** SourceColumn **   <a name="timestream-Type-MultiMeasureAttributeMapping-SourceColumn"></a>
  
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1.  
Obrigatório: sim

 ** MeasureValueType **   <a name="timestream-Type-MultiMeasureAttributeMapping-MeasureValueType"></a>
  
Tipo: String  
Valores Válidos: `DOUBLE | BIGINT | BOOLEAN | VARCHAR | TIMESTAMP`   
Obrigatório: Não

 ** TargetMultiMeasureAttributeName **   <a name="timestream-Type-MultiMeasureAttributeMapping-TargetMultiMeasureAttributeName"></a>
  
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1.  
Obrigatório: Não

## Consulte também
<a name="API_MultiMeasureAttributeMapping_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureAttributeMapping) 

# MultiMeasureMappings
<a name="API_MultiMeasureMappings"></a>



## Conteúdo
<a name="API_MultiMeasureMappings_Contents"></a>

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-MultiMeasureMappings-MultiMeasureAttributeMappings"></a>
  
Tipo: Matriz de objetos [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md)  
Membros da matriz: número mínimo de 1 item.  
Obrigatório: sim

 ** TargetMultiMeasureName **   <a name="timestream-Type-MultiMeasureMappings-TargetMultiMeasureName"></a>
  
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1.  
Obrigatório: Não

## Consulte também
<a name="API_MultiMeasureMappings_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureMappings) 

# PartitionKey
<a name="API_PartitionKey"></a>

 Atributo usado no particionamento de dados em uma tabela. Uma chave de dimensão particiona os dados usando os valores da dimensão especificada pelo nome da dimensão como chave de partição, enquanto uma chave de medida particiona os dados usando nomes de medida (valores da coluna “measure\$1name”). 

## Conteúdo
<a name="API_PartitionKey_Contents"></a>

 ** Type **   <a name="timestream-Type-PartitionKey-Type"></a>
 O nome da chave da partição. As opções são DIMENSION (chave de dimensão) e MEASURE (chave de medida).   
Tipo: string  
Valores válidos: `DIMENSION | MEASURE`   
Obrigatório: sim

 ** EnforcementInRecord **   <a name="timestream-Type-PartitionKey-EnforcementInRecord"></a>
 Nível de fiscalização da especificação de uma chave de dimensão nos registros ingeridos. As alternativas são OBRIGATÓRIAS (a especificação da chave de dimensão é necessária) e OPCIONAIS (a especificação da chave de dimensão não é imprescindível).   
Tipo: string  
Valores válidos: `REQUIRED | OPTIONAL`   
Obrigatório: não

 ** Name **   <a name="timestream-Type-PartitionKey-Name"></a>
 Nome do atributo usado para uma chave da dimensão.   
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1.  
Obrigatório: não

## Consulte também
<a name="API_PartitionKey_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/PartitionKey) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/PartitionKey) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/PartitionKey) 

# Record
<a name="API_Record"></a>

Representa um ponto de dados de séries temporais sendo gravado no Timestream. Cada registro contém uma matriz de dimensões. As dimensões representam os atributos de metadados de um ponto de dados de série temporal, como o nome da instância ou a zona de disponibilidade de uma instância do EC2. Um registro também contém o nome da medida, que é o nome da medida que está sendo coletada (por exemplo, a utilização da CPU de uma instância do EC2). Além disso, um registro contém o valor da medida e o tipo de valor, que é o tipo de dados do valor da medida. Além disso, o registro contém o registro de data e hora de quando a medida foi coletada e a unidade de registro de data e hora, que representa a granularidade do timestamp. 

 Os registros têm um campo `Version`, que é um `long` de 64 bits que você pode usar para atualizar pontos de dados. As gravações de um registro duplicado com a mesma dimensão, data e hora e nome de medida, mas com valores de medida diferentes, só serão bem-sucedidas se o atributo `Version` do registro na solicitação de gravação for maior que o do registro existente. O padrão do Timestream é `Version` de `1` para registros sem o campo `Version`. 

## Conteúdo
<a name="API_Record_Contents"></a>

 ** Dimensions **   <a name="timestream-Type-Record-Dimensions"></a>
Contém a lista de dimensões para pontos de dados de séries temporais.  
Tipo: matriz de objetos [Dimension](API_Dimension.md)  
Membros da matriz: número máximo de 128 itens.  
Obrigatório: Não

 ** MeasureName **   <a name="timestream-Type-Record-MeasureName"></a>
A medida representa o atributo de dados da série temporal. Por exemplo, a utilização da CPU de uma instância do EC2 ou a RPM de uma turbina eólica são medidas.   
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.  
Obrigatório: Não

 ** MeasureValue **   <a name="timestream-Type-Record-MeasureValue"></a>
 Contém o valor da medida para o ponto de dados de série temporal.   
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: Não

 ** MeasureValues **   <a name="timestream-Type-Record-MeasureValues"></a>
 Contém a lista de MeasureValue para dados de séries temporais.   
 Isso só é permitido para o tipo `MULTI`. Para valores escalares, use o atributo `MeasureValue` do registro diretamente.   
Tipo: matriz de objetos [MeasureValue](API_MeasureValue.md)  
Obrigatório: Não

 ** MeasureValueType **   <a name="timestream-Type-Record-MeasureValueType"></a>
 Contém o tipo de dados do valor da medida para o ponto de dados de série temporal. O tipo padrão é `DOUBLE`. Para obter mais informações, consulte [Tipos de dados](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types).  
Tipo: String  
Valores Válidos: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI`   
Obrigatório: Não

 ** Time **   <a name="timestream-Type-Record-Time"></a>
 Contém a hora em que o valor da medida para o ponto de dados foi coletado. O valor do tempo mais a unidade fornece o tempo decorrido desde a época. Por exemplo, se o valor do tempo for `12345` e a unidade for `ms`, então `12345 ms` já passaram desde a época.   
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.  
Obrigatório: Não

 ** TimeUnit **   <a name="timestream-Type-Record-TimeUnit"></a>
 A granularidade da unidade de registro de data e hora. Indica se o valor do tempo está em segundos, milissegundos, nanossegundos ou outros valores compatíveis. O padrão é `MILLISECONDS`.   
Tipo: String  
Valores Válidos: `MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS`   
Obrigatório: Não

 ** Version **   <a name="timestream-Type-Record-Version"></a>
Atributo de 64 bits usado para atualizações de registros. As solicitações de gravação de dados duplicados com um número de versão maior atualizarão o valor e a versão existentes da medida. Nos casos em que o valor da medida for o mesmo, `Version` ainda será atualizado. O valor padrão é . `1`.  
 `Version` deve ser `1` ou maior, ou você receberá um erro `ValidationException`.
Tipo: longo  
Obrigatório: Não

## Consulte também
<a name="API_Record_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Record) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Record) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Record) 

# RecordsIngested
<a name="API_RecordsIngested"></a>

Informações sobre os registros ingeridos por essa solicitação.

## Conteúdo
<a name="API_RecordsIngested_Contents"></a>

 ** MagneticStore **   <a name="timestream-Type-RecordsIngested-MagneticStore"></a>
Quantidade de registros ingeridos no armazenamento magnético.  
Tipo: inteiro  
Obrigatório: Não

 ** MemoryStore **   <a name="timestream-Type-RecordsIngested-MemoryStore"></a>
Quantidade de registros ingeridos no armazenamento em memória.  
Tipo: inteiro  
Obrigatório: Não

 ** Total **   <a name="timestream-Type-RecordsIngested-Total"></a>
Quantidade total de registros ingeridos com sucesso.  
Tipo: inteiro  
Obrigatório: Não

## Consulte também
<a name="API_RecordsIngested_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RecordsIngested) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RecordsIngested) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RecordsIngested) 

# RejectedRecord
<a name="API_RejectedRecord"></a>

 Representa registros que não foram inseridos com sucesso no Timestream devido a problemas de validação de dados que devem ser resolvidos antes da reinserção de dados de séries temporais no sistema. 

## Conteúdo
<a name="API_RejectedRecord_Contents"></a>

 ** ExistingVersion **   <a name="timestream-Type-RejectedRecord-ExistingVersion"></a>
A versão existente do registro. Esse valor é preenchido em cenários nos quais existe um registro idêntico com uma versão superior à versão na solicitação de gravação.  
Tipo: longo  
Obrigatório: Não

 ** Reason **   <a name="timestream-Type-RejectedRecord-Reason"></a>
 O motivo pelo qual um registro não foi inserido com sucesso no Timestream. As possíveis causas de falha incluem:   
+ Registros com dados duplicados nos quais há vários registros com as mesmas dimensões, carimbos de data/hora e nomes de medidas, mas: 
  + Os valores das medidas são diferentes
  + A versão não está presente na solicitação *ou* o valor da versão no novo registro é igual ou inferior ao valor existente

  Se o Timestream rejeitar os dados desse caso, o campo `ExistingVersion` na resposta `RejectedRecords` indicará a versão atual do registro. Para forçar uma atualização, você pode reenviar a solicitação com uma versão do conjunto de registros com um valor maior que `ExistingVersion`.
+  Registros com carimbos de data/hora que estão fora da duração de retenção do armazenamento na memória. 
**nota**  
Quando a janela de retenção for atualizada, você receberá uma exceção `RejectedRecords` se tentar imediatamente ingerir dados dentro da nova janela. Para evitar uma exceção `RejectedRecords`, espere até a duração da nova janela para ingerir novos dados. Para obter mais informações, consulte [Melhores práticas para configurar o Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/best-practices.html#configuration) e [a explicação de como o armazenamento funciona no Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/storage.html).
+  Registros com dimensões ou medidas que excedem os limites definidos pelo Timestream. 
 Para obter mais informações, consulte [Gerenciamento de acesso](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) no Guia do desenvolvedor do Timestream.   
Tipo: String  
Obrigatório: Não

 ** RecordIndex **   <a name="timestream-Type-RejectedRecord-RecordIndex"></a>
 O índice do registro na solicitação de entrada para WriteRecords. Os índices começam com 0.   
Tipo: inteiro  
Obrigatório: Não

## Consulte também
<a name="API_RejectedRecord_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RejectedRecord) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RejectedRecord) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RejectedRecord) 

# ReportConfiguration
<a name="API_ReportConfiguration"></a>

Configuração do relatório para uma tarefa de carregamento em lote. Contém detalhes sobre onde os relatórios de erros são armazenados.

## Conteúdo
<a name="API_ReportConfiguration_Contents"></a>

 ** ReportS3Configuration **   <a name="timestream-Type-ReportConfiguration-ReportS3Configuration"></a>
A configuração de um local do S3 para gravar relatórios de erros e eventos para um carregamento em lote.  
Tipo: objeto [ReportS3Configuration](API_ReportS3Configuration.md)  
Obrigatório: Não

## Consulte também
<a name="API_ReportConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem da AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportConfiguration) 

# ReportS3Configuration
<a name="API_ReportS3Configuration"></a>



## Conteúdo
<a name="API_ReportS3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-ReportS3Configuration-BucketName"></a>
  
Tipo: String  
Restrições de tamanho: comprimento mínimo de 3. Tamanho máximo de 63.  
Padrão: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Exigido: Sim

 ** EncryptionOption **   <a name="timestream-Type-ReportS3Configuration-EncryptionOption"></a>
  
Tipo: String  
Valores Válidos: `SSE_S3 | SSE_KMS`   
Obrigatório: Não

 ** KmsKeyId **   <a name="timestream-Type-ReportS3Configuration-KmsKeyId"></a>
  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: Não

 ** ObjectKeyPrefix **   <a name="timestream-Type-ReportS3Configuration-ObjectKeyPrefix"></a>
  
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 928.  
Padrão: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obrigatório: Não

## Consulte também
<a name="API_ReportS3Configuration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportS3Configuration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportS3Configuration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportS3Configuration) 

# RetentionProperties
<a name="API_RetentionProperties"></a>

As propriedades de retenção contêm o período de tempo durante o qual dados de série temporal devem ser armazenados no armazenamento magnético e no armazenamento de memória. 

## Conteúdo
<a name="API_RetentionProperties_Contents"></a>

 ** MagneticStoreRetentionPeriodInDays **   <a name="timestream-Type-RetentionProperties-MagneticStoreRetentionPeriodInDays"></a>
O período de tempo durante o qual os dados devem ser armazenados no armazenamento magnético.   
Tipo: longo  
Faixa válida: valor mínimo de 1. Valor máximo de 73000.  
Obrigatório: Sim

 ** MemoryStoreRetentionPeriodInHours **   <a name="timestream-Type-RetentionProperties-MemoryStoreRetentionPeriodInHours"></a>
o período de tempo durante o qual os dados devem ser armazenados de memória magnético.   
Tipo: longo  
Faixa válida: valor mínimo de 1. Valor máximo de 8766.  
Obrigatório: Sim

## Consulte também
<a name="API_RetentionProperties_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RetentionProperties) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RetentionProperties) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RetentionProperties) 

# S3Configuration
<a name="API_S3Configuration"></a>

A configuração que especifica um local do S3.

## Conteúdo
<a name="API_S3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-S3Configuration-BucketName"></a>
O nome de bucket do bucket do cliente do S3.  
Tipo: String  
Restrições de tamanho: comprimento mínimo de 3. Tamanho máximo de 63.  
Padrão: : `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Obrigatório: Não

 ** EncryptionOption **   <a name="timestream-Type-S3Configuration-EncryptionOption"></a>
A opção de criptografia para o local do cliente do S3. As opções são a criptografia no lado do servidor do S3 com uma chave gerenciada do S3 ou com uma chave gerenciada da AWS.  
Tipo: String  
Valores Válidos: `SSE_S3 | SSE_KMS`   
Obrigatório: Não

 ** KmsKeyId **   <a name="timestream-Type-S3Configuration-KmsKeyId"></a>
O ID da chave do AWS KMS para o local do cliente no S3 ao criptografar com uma chave gerenciada da AWS.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: Não

 ** ObjectKeyPrefix **   <a name="timestream-Type-S3Configuration-ObjectKeyPrefix"></a>
A pré-visualização da chave do objeto para um local do cliente do S3.  
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 928.  
Padrão: : `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obrigatório: Não

## Consulte também
<a name="API_S3Configuration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/S3Configuration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/S3Configuration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/S3Configuration) 

# Schema
<a name="API_Schema"></a>

 Um esquema especifica o modelo de dados esperado da tabela. 

## Conteúdo
<a name="API_Schema_Contents"></a>

 ** CompositePartitionKey **   <a name="timestream-Type-Schema-CompositePartitionKey"></a>
Uma lista não vazia de chaves de partição que define os atributos usados para particionar os dados da tabela. A ordem da lista determina a hierarquia de partições. O nome e o tipo de cada chave de partição, bem como a ordem da chave de partição, não podem ser alterados após a criação da tabela. No entanto, o nível de imposição de cada chave de partição pode ser alterado.   
Tipo: Matriz de objetos [PartitionKey](API_PartitionKey.md)  
Membros da matriz: número mínimo de 1 item.  
Obrigatório: Não

## Consulte também
<a name="API_Schema_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Schema) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Schema) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Schema) 

# Table
<a name="API_Table"></a>

Representa uma tabela de banco de dados no Timestream. As tabelas contêm uma ou mais séries temporais relacionadas. Você pode modificar a duração da retenção do armazenamento na memória e o armazenamento magnético para uma tabela. 

## Conteúdo
<a name="API_Table_Contents"></a>

 ** Arn **   <a name="timestream-Type-Table-Arn"></a>
O nome do recurso da Amazon que identifica essa tabela de forma exclusiva.  
Tipo: String  
Obrigatório: Não

 ** CreationTime **   <a name="timestream-Type-Table-CreationTime"></a>
A hora em que a tabela do Timestamp foi criada.   
Tipo: Timestamp  
Obrigatório: Não

 ** DatabaseName **   <a name="timestream-Type-Table-DatabaseName"></a>
O nome do banco de dados do Timestream que contém essa tabela.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 3. Tamanho máximo de 256.  
Obrigatório: Não

 ** LastUpdatedTime **   <a name="timestream-Type-Table-LastUpdatedTime"></a>
A hora em que a tabela do Timestamp foi atualizada pela última vez.  
Tipo: Timestamp  
Obrigatório: Não

 ** MagneticStoreWriteProperties **   <a name="timestream-Type-Table-MagneticStoreWriteProperties"></a>
Contém propriedades a serem definidas na tabela ao habilitar gravações de armazenamento magnético.  
Tipo: objeto [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)  
Obrigatório: Não

 ** RetentionProperties **   <a name="timestream-Type-Table-RetentionProperties"></a>
A duração da retenção para o armazenamento na memória e o armazenamento magnético.  
Tipo: objeto [RetentionProperties](API_RetentionProperties.md)  
Obrigatório: Não

 ** Schema **   <a name="timestream-Type-Table-Schema"></a>
 O esquema da tabela.   
Tipo: objeto [Schema](API_Schema.md)  
Obrigatório: Não

 ** TableName **   <a name="timestream-Type-Table-TableName"></a>
O nome da tabela do Timestream.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 3. Tamanho máximo de 256.  
Obrigatório: Não

 ** TableStatus **   <a name="timestream-Type-Table-TableStatus"></a>
O estado atual da tabela:  
+  `DELETING` - A tabela está sendo excluída.
+  `ACTIVE` - A tabela está pronta para uso.
Tipo: String  
Valores Válidos: `ACTIVE | DELETING | RESTORING`   
Obrigatório: Não

## Consulte também
<a name="API_Table_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Table) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Table) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Table) 

# Tag
<a name="API_Tag"></a>

 Tag é um rótulo que você atribui a um banco de dados e/ou uma tabela do Timestream. Cada tag consiste de uma chave e um valor opcional, que podem ser definidos. Com tags, é possível categorizar bancos de dados e/ou tabelas, por exemplo, por finalidade, proprietário ou ambiente. 

## Conteúdo
<a name="API_Tag_Contents"></a>

 ** Key **   <a name="timestream-Type-Tag-Key"></a>
 A chave da tag. Chaves de tag fazem distinção entre maiúsculas e minúsculas.   
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.  
Obrigatório: Sim

 ** Value **   <a name="timestream-Type-Tag-Value"></a>
 O valor da tag. Os valores de tag diferenciam maiúsculas de minúsculas e podem ser nulos.   
Tipo: String  
Restrições de tamanho: o tamanho mínimo é 0. O tamanho máximo é 256.  
Obrigatório: Sim

## Consulte também
<a name="API_Tag_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Tag) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Tag) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Tag) 

# Consulta do Amazon Timestream
<a name="API_Types_Amazon_Timestream_Query"></a>

Os seguintes tipos de dados são compatíveis com a consulta do Amazon Timestream:
+  [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) 
+  [ColumnInfo](API_query_ColumnInfo.md) 
+  [Datum](API_query_Datum.md) 
+  [DimensionMapping](API_query_DimensionMapping.md) 
+  [Endpoint](API_query_Endpoint.md) 
+  [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) 
+  [ErrorReportLocation](API_query_ErrorReportLocation.md) 
+  [ExecutionStats](API_query_ExecutionStats.md) 
+  [LastUpdate](API_query_LastUpdate.md) 
+  [MixedMeasureMapping](API_query_MixedMeasureMapping.md) 
+  [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) 
+  [MultiMeasureMappings](API_query_MultiMeasureMappings.md) 
+  [NotificationConfiguration](API_query_NotificationConfiguration.md) 
+  [ParameterMapping](API_query_ParameterMapping.md) 
+  [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) 
+  [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) 
+  [QueryComputeRequest](API_query_QueryComputeRequest.md) 
+  [QueryComputeResponse](API_query_QueryComputeResponse.md) 
+  [QueryInsights](API_query_QueryInsights.md) 
+  [QueryInsightsResponse](API_query_QueryInsightsResponse.md) 
+  [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) 
+  [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) 
+  [QueryStatus](API_query_QueryStatus.md) 
+  [QueryTemporalRange](API_query_QueryTemporalRange.md) 
+  [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) 
+  [Row](API_query_Row.md) 
+  [S3Configuration](API_query_S3Configuration.md) 
+  [S3ReportLocation](API_query_S3ReportLocation.md) 
+  [ScheduleConfiguration](API_query_ScheduleConfiguration.md) 
+  [ScheduledQuery](API_query_ScheduledQuery.md) 
+  [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) 
+  [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) 
+  [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) 
+  [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) 
+  [SelectColumn](API_query_SelectColumn.md) 
+  [SnsConfiguration](API_query_SnsConfiguration.md) 
+  [Tag](API_query_Tag.md) 
+  [TargetConfiguration](API_query_TargetConfiguration.md) 
+  [TargetDestination](API_query_TargetDestination.md) 
+  [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) 
+  [TimestreamConfiguration](API_query_TimestreamConfiguration.md) 
+  [TimestreamDestination](API_query_TimestreamDestination.md) 
+  [Type](API_query_Type.md) 

# AccountSettingsNotificationConfiguration
<a name="API_query_AccountSettingsNotificationConfiguration"></a>

Configurações para notificações relacionadas às configurações da conta.

## Conteúdo
<a name="API_query_AccountSettingsNotificationConfiguration_Contents"></a>

 ** RoleArn **   <a name="timestream-Type-query_AccountSettingsNotificationConfiguration-RoleArn"></a>
Nome do recurso da Amazon (ARN) que concede permissão ao Timestream para publicar notificações. Esse campo só será visível somente quando o tópico do SNS é fornecido ao atualizar as configurações da conta.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2048.  
Obrigatório: sim

 ** SnsConfiguration **   <a name="timestream-Type-query_AccountSettingsNotificationConfiguration-SnsConfiguration"></a>
Detalhes sobre o SNS que são necessários para enviar a notificação.  
Tipo: objeto [SnsConfiguration](API_query_SnsConfiguration.md)  
Obrigatório: não

## Consulte também
<a name="API_query_AccountSettingsNotificationConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) 

# ColumnInfo
<a name="API_query_ColumnInfo"></a>

 Contém os metadados dos resultados da consulta, como nomes de colunas, tipos de dados e outros atributos. 

## Conteúdo
<a name="API_query_ColumnInfo_Contents"></a>

 ** Type **   <a name="timestream-Type-query_ColumnInfo-Type"></a>
O tipo de dados da coluna do conjunto de resultados. Tipo de dados pode ser escalar ou complexo. Os tipos de dados escalares são números inteiros, cadeias de caracteres, doubles, booleanos e outros. Tipos de dados complexos são tipos como matrizes, linhas e outros.   
Tipo: objeto [Type](API_query_Type.md)  
Obrigatório: sim

 ** Name **   <a name="timestream-Type-query_ColumnInfo-Name"></a>
 Nome da coluna do conjunto de resultados. Nome do conjunto de resultados está disponível para colunas de todos os tipos de dados, exceto matrizes.   
Tipo: string  
Obrigatório: não

## Consulte também
<a name="API_query_ColumnInfo_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ColumnInfo) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ColumnInfo) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ColumnInfo) 

# Datum
<a name="API_query_Datum"></a>

 O dado representa um único ponto de dados em um resultado de consulta. 

## Conteúdo
<a name="API_query_Datum_Contents"></a>

 ** ArrayValue **   <a name="timestream-Type-query_Datum-ArrayValue"></a>
 Indica se o ponto de dados é uma matriz.   
Tipo: matriz de objetos [Datum](#API_query_Datum)  
Obrigatório: não

 ** NullValue **   <a name="timestream-Type-query_Datum-NullValue"></a>
 Indica se o ponto de dados é nulo.   
Tipo: booliano  
Obrigatório: não

 ** RowValue **   <a name="timestream-Type-query_Datum-RowValue"></a>
 Indica se o ponto de dados é uma linha.   
Tipo: objeto [Row](API_query_Row.md)  
Obrigatório: não

 ** ScalarValue **   <a name="timestream-Type-query_Datum-ScalarValue"></a>
 Indica se o ponto de dados é um valor escalar, como inteiro, string, double ou booleano.   
Tipo: string  
Obrigatório: não

 ** TimeSeriesValue **   <a name="timestream-Type-query_Datum-TimeSeriesValue"></a>
 Indica se o ponto de dados é um tipo de dados de série temporal.   
Tipo: matriz de objetos [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md)  
Obrigatório: não

## Consulte também
<a name="API_query_Datum_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Datum) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Datum) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Datum) 

# DimensionMapping
<a name="API_query_DimensionMapping"></a>

Esse tipo é utilizado para mapear coluna(s) do resultado da consulta para uma dimensão na tabela de destino.

## Conteúdo
<a name="API_query_DimensionMapping_Contents"></a>

 ** DimensionValueType **   <a name="timestream-Type-query_DimensionMapping-DimensionValueType"></a>
Tipo da dimensão.   
Tipo: String  
Valores Válidos: `VARCHAR`   
Obrigatório: Sim

 ** Name **   <a name="timestream-Type-query_DimensionMapping-Name"></a>
Nome da coluna do resultado da consulta.  
Tipo: string  
Obrigatório: Sim

## Consulte também
<a name="API_query_DimensionMapping_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DimensionMapping) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DimensionMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DimensionMapping) 

# Endpoint
<a name="API_query_Endpoint"></a>

Representa um endpoint disponível para fazer chamadas de API, bem como o TTL desse endpoint.

## Conteúdo
<a name="API_query_Endpoint_Contents"></a>

 ** Address **   <a name="timestream-Type-query_Endpoint-Address"></a>
Endereço de endpoint.  
Tipo: string  
Obrigatório: sim

 ** CachePeriodInMinutes **   <a name="timestream-Type-query_Endpoint-CachePeriodInMinutes"></a>
TTL para o endpoint, em minutos.  
Tipo: longo  
Obrigatório: sim

## Consulte também
<a name="API_query_Endpoint_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Endpoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Endpoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Endpoint) 

# ErrorReportConfiguration
<a name="API_query_ErrorReportConfiguration"></a>

Configuração necessária para relatórios de erros.

## Conteúdo
<a name="API_query_ErrorReportConfiguration_Contents"></a>

 ** S3Configuration **   <a name="timestream-Type-query_ErrorReportConfiguration-S3Configuration"></a>
A configuração do S3 para os relatórios de erros.  
Tipo: objeto [S3Configuration](API_query_S3Configuration.md)  
Obrigatório: Sim

## Consulte também
<a name="API_query_ErrorReportConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportConfiguration) 

# ErrorReportLocation
<a name="API_query_ErrorReportLocation"></a>

Contém a localização do relatório de erros para uma única chamada de consulta agendada. 

## Conteúdo
<a name="API_query_ErrorReportLocation_Contents"></a>

 ** S3ReportLocation **   <a name="timestream-Type-query_ErrorReportLocation-S3ReportLocation"></a>
Local no S3 onde os relatórios de erros são gravados.  
Tipo: objeto [S3ReportLocation](API_query_S3ReportLocation.md)  
Obrigatório: não

## Consulte também
<a name="API_query_ErrorReportLocation_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportLocation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportLocation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportLocation) 

# ExecutionStats
<a name="API_query_ExecutionStats"></a>

Estatísticas para uma única execução de consulta agendada.

## Conteúdo
<a name="API_query_ExecutionStats_Contents"></a>

 ** BytesMetered **   <a name="timestream-Type-query_ExecutionStats-BytesMetered"></a>
Bytes medidos para uma única execução de consulta agendada.  
Tipo: longo  
Obrigatório: não

 ** CumulativeBytesScanned **   <a name="timestream-Type-query_ExecutionStats-CumulativeBytesScanned"></a>
Bytes escaneados para uma única execução de consulta agendada.  
Tipo: longo  
Obrigatório: não

 ** DataWrites **   <a name="timestream-Type-query_ExecutionStats-DataWrites"></a>
As medições dos dados gravados foram realizadas para os registros processados em uma única execução de uma consulta programada.  
Tipo: longo  
Obrigatório: não

 ** ExecutionTimeInMillis **   <a name="timestream-Type-query_ExecutionStats-ExecutionTimeInMillis"></a>
Tempo total, medido em milissegundos, necessário para a conclusão da execução da consulta agendada.  
Tipo: longo  
Obrigatório: não

 ** QueryResultRows **   <a name="timestream-Type-query_ExecutionStats-QueryResultRows"></a>
Quantidade de linhas que se encontra na saída da execução de uma consulta, antes da incorporação na fonte de dados de destino.  
Tipo: longo  
Obrigatório: não

 ** RecordsIngested **   <a name="timestream-Type-query_ExecutionStats-RecordsIngested"></a>
Número de registros ingeridos para uma única execução de consulta agendada.   
Tipo: longo  
Obrigatório: não

## Consulte também
<a name="API_query_ExecutionStats_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecutionStats) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecutionStats) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecutionStats) 

# LastUpdate
<a name="API_query_LastUpdate"></a>

O item de configuração que abriga a versão mais atual das definições da conta, visível apenas caso as configurações tenham sido previamente modificadas.

## Conteúdo
<a name="API_query_LastUpdate_Contents"></a>

 ** Status **   <a name="timestream-Type-query_LastUpdate-Status"></a>
O status da última atualização. Pode ser `PENDING`, `FAILED` ou `SUCCEEDED`.  
Tipo: string  
Valores válidos: `PENDING | FAILED | SUCCEEDED`   
Obrigatório: não

 ** StatusMessage **   <a name="timestream-Type-query_LastUpdate-StatusMessage"></a>
Mensagem de erro que indica o estado da atualização mais recente das configurações da conta, exibida apenas em caso de falha.  
Tipo: string  
Obrigatório: não

 ** TargetQueryTCU **   <a name="timestream-Type-query_LastUpdate-TargetQueryTCU"></a>
Número de unidades de computação do TimeStream (TCUs) solicitadas na última atualização das configurações da conta.  
Tipo: inteiro  
Obrigatório: não

## Consulte também
<a name="API_query_LastUpdate_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/LastUpdate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/LastUpdate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/LastUpdate) 

# MixedMeasureMapping
<a name="API_query_MixedMeasureMapping"></a>

MixedMeasureMappings são mapeamentos que podem ser utilizados para ingerir dados em uma combinação de medidas estreitas e múltiplas na tabela derivada.

## Conteúdo
<a name="API_query_MixedMeasureMapping_Contents"></a>

 ** MeasureValueType **   <a name="timestream-Type-query_MixedMeasureMapping-MeasureValueType"></a>
Tipo do valor a ser lido de sourceColumn. Se o mapeamento for para MULTI, use MeasureValueType.MULTI.  
Tipo: String  
Valores Válidos: `BIGINT | BOOLEAN | DOUBLE | VARCHAR | MULTI`   
Obrigatório: Sim

 ** MeasureName **   <a name="timestream-Type-query_MixedMeasureMapping-MeasureName"></a>
Refere-se ao valor de measure\$1name em uma linha de resultado. Esse campo apenas será obrigatório se MeasureNameColumn for fornecido.  
Tipo: String  
Obrigatório: Não

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-query_MixedMeasureMapping-MultiMeasureAttributeMappings"></a>
Necessário quando measureValueType é MULTI. Mapeamentos de atributos para medidas de valores MULTI.  
Tipo: Matriz de objetos [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md)  
Membros da matriz: número mínimo de 1 item.  
Obrigatório: Não

 ** SourceColumn **   <a name="timestream-Type-query_MixedMeasureMapping-SourceColumn"></a>
Esse campo refere-se à coluna de origem da qual o valor de medida deve ser lido para a materialização do resultado.  
Tipo: String  
Obrigatório: Não

 ** TargetMeasureName **   <a name="timestream-Type-query_MixedMeasureMapping-TargetMeasureName"></a>
Nome da medida de destino a ser utilizada. Se não for fornecido, o nome da medida de destino, por padrão, seria nome da medida, se fornecido, ou sourceColumn de outra forma.   
Tipo: String  
Obrigatório: Não

## Consulte também
<a name="API_query_MixedMeasureMapping_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MixedMeasureMapping) 

# MultiMeasureAttributeMapping
<a name="API_query_MultiMeasureAttributeMapping"></a>

Mapeamento de atributos para medidas de valores MULTI.

## Conteúdo
<a name="API_query_MultiMeasureAttributeMapping_Contents"></a>

 ** MeasureValueType **   <a name="timestream-Type-query_MultiMeasureAttributeMapping-MeasureValueType"></a>
Tipo do atributo a ser lido na coluna de origem.  
Tipo: String  
Valores Válidos: `BIGINT | BOOLEAN | DOUBLE | VARCHAR | TIMESTAMP`   
Obrigatório: Sim

 ** SourceColumn **   <a name="timestream-Type-query_MultiMeasureAttributeMapping-SourceColumn"></a>
Coluna de origem de onde o valor do atributo deve ser lido.  
Tipo: string  
Obrigatório: Sim

 ** TargetMultiMeasureAttributeName **   <a name="timestream-Type-query_MultiMeasureAttributeMapping-TargetMultiMeasureAttributeName"></a>
Nome personalizado a ser utilizado para o nome do atributo na tabela derivada. Se não for fornecido, o nome da coluna de origem será usado.  
Tipo: String  
Obrigatório: Não

## Consulte também
<a name="API_query_MultiMeasureAttributeMapping_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureAttributeMapping) 

# MultiMeasureMappings
<a name="API_query_MultiMeasureMappings"></a>

Apenas uma opção de MixedMeasureMappings ou MultiMeasureMappings deve ser fornecida. MultiMeasureMappings pode ser utilizado para ingerir dados como medidas múltiplas na tabela derivada.

## Conteúdo
<a name="API_query_MultiMeasureMappings_Contents"></a>

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-query_MultiMeasureMappings-MultiMeasureAttributeMappings"></a>
Obrigatório. Mapeamentos de atributos a serem utilizados para mapear resultados de consulta para ingerir dados para atributos de várias medidas.  
Tipo: Matriz de objetos [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md)  
Membros da matriz: número mínimo de 1 item.  
Obrigatório: Sim

 ** TargetMultiMeasureName **   <a name="timestream-Type-query_MultiMeasureMappings-TargetMultiMeasureName"></a>
O nome do nome de várias medidas de destino na tabela derivada. Essa entrada é necessária quando measureNameColumn não é fornecido. Se MeasureNameColumn for fornecido, o valor dessa coluna será utilizado como nome de várias medidas.  
Tipo: String  
Obrigatório: Não

## Consulte também
<a name="API_query_MultiMeasureMappings_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureMappings) 

# NotificationConfiguration
<a name="API_query_NotificationConfiguration"></a>

Configuração de notificação para uma consulta programada. Uma notificação é enviada pelo Timestream quando uma consulta programada é criada, seu estado é atualizado ou quando é excluído. 

## Conteúdo
<a name="API_query_NotificationConfiguration_Contents"></a>

 ** SnsConfiguration **   <a name="timestream-Type-query_NotificationConfiguration-SnsConfiguration"></a>
Detalhes sobre a configuração do Amazon Simple Notification Service (SNS). Esse campo é visível somente quando o tópico do SNS é fornecido ao atualizar as configurações da conta.   
Tipo: objeto [SnsConfiguration](API_query_SnsConfiguration.md)  
Obrigatório: sim

## Consulte também
<a name="API_query_NotificationConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/NotificationConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/NotificationConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/NotificationConfiguration) 

# ParameterMapping
<a name="API_query_ParameterMapping"></a>

Mapeamento para parâmetros nomeados.

## Conteúdo
<a name="API_query_ParameterMapping_Contents"></a>

 ** Name **   <a name="timestream-Type-query_ParameterMapping-Name"></a>
Nome do parâmetro  
Tipo: string  
Obrigatório: sim

 ** Type **   <a name="timestream-Type-query_ParameterMapping-Type"></a>
Contém o tipo de dados de uma coluna em um conjunto de resultados de consulta. Tipo de dados pode ser escalar ou complexo. Tipos de dados escalares suportados são inteiros, boolean, string, double, timestamp, date, time e intervals. Tipos de dados complexos compatíveis são matrizes, linhas e séries temporais.  
Tipo: objeto [Type](API_query_Type.md)  
Obrigatório: sim

## Consulte também
<a name="API_query_ParameterMapping_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ParameterMapping) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ParameterMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ParameterMapping) 

# ProvisionedCapacityRequest
<a name="API_query_ProvisionedCapacityRequest"></a>

Solicitação para atualizar as configurações de capacidade provisionada para consultar dados.

## Conteúdo
<a name="API_query_ProvisionedCapacityRequest_Contents"></a>

 ** TargetQueryTCU **   <a name="timestream-Type-query_ProvisionedCapacityRequest-TargetQueryTCU"></a>
Capacidade computacional de destino para consultar dados, especificada em Timestream Compute Units (TCUs).  
Tipo: inteiro  
Obrigatório: sim

 ** NotificationConfiguration **   <a name="timestream-Type-query_ProvisionedCapacityRequest-NotificationConfiguration"></a>
Definições de configuração para notificações relacionadas à atualização da capacidade provisionada.  
Tipo: objeto [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md)  
Obrigatório: não

## Consulte também
<a name="API_query_ProvisionedCapacityRequest_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityRequest) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityRequest) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityRequest) 

# ProvisionedCapacityResponse
<a name="API_query_ProvisionedCapacityResponse"></a>

Resposta a uma solicitação para atualizar as configurações de capacidade provisionada para consultar dados.

## Conteúdo
<a name="API_query_ProvisionedCapacityResponse_Contents"></a>

 ** ActiveQueryTCU **   <a name="timestream-Type-query_ProvisionedCapacityResponse-ActiveQueryTCU"></a>
O número de unidades de computação das Timestream Compute Units (TCUs) provisionadas na conta. Esse campo só é visível quando o modo de computação está `PROVISIONED`.  
Tipo: inteiro  
Obrigatório: não

 ** LastUpdate **   <a name="timestream-Type-query_ProvisionedCapacityResponse-LastUpdate"></a>
Informações referentes à mais recente atualização das configurações de capacidade provisionada.  
Tipo: objeto [LastUpdate](API_query_LastUpdate.md)  
Obrigatório: não

 ** NotificationConfiguration **   <a name="timestream-Type-query_ProvisionedCapacityResponse-NotificationConfiguration"></a>
Objeto que contém as configurações para notificações enviadas sempre que as configurações de capacidade provisionada são alteradas. Esse campo só é visível quando o modo de computação está `PROVISIONED`.  
Tipo: objeto [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md)  
Obrigatório: não

## Consulte também
<a name="API_query_ProvisionedCapacityResponse_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityResponse) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityResponse) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityResponse) 

# QueryComputeRequest
<a name="API_query_QueryComputeRequest"></a>

Solicitação para recuperar ou atualizar as configurações de capacidade computacional para a consulta de dados. QueryCompute está disponível agora na região da Ásia-Pacífico (Mumbai).

## Conteúdo
<a name="API_query_QueryComputeRequest_Contents"></a>

 ** ComputeMode **   <a name="timestream-Type-query_QueryComputeRequest-ComputeMode"></a>
O modo no qual as unidades de computação das Timestream Compute Units (TCUs) são alocadas e utilizadas em uma conta. Observe que na região Ásia-Pacífico (Mumbai), a operação da API reconhece apenas o valor `PROVISIONED`. QueryCompute está disponível agora na região da Ásia-Pacífico (Mumbai).  
Tipo: string  
Valores válidos: `ON_DEMAND | PROVISIONED`   
Obrigatório: não

 ** ProvisionedCapacity **   <a name="timestream-Type-query_QueryComputeRequest-ProvisionedCapacity"></a>
Objeto de configuração que contém as definições para as Timestream Compute Units (TCUs) provisionadas na sua conta. QueryCompute está disponível agora na região da Ásia-Pacífico (Mumbai).  
Tipo: objeto [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md)  
Obrigatório: não

## Consulte também
<a name="API_query_QueryComputeRequest_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeRequest) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeRequest) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeRequest) 

# QueryComputeResponse
<a name="API_query_QueryComputeResponse"></a>

A resposta para recuperar ou atualizar as configurações de capacidade computacional para consultar dados. QueryCompute está disponível agora na região da Ásia-Pacífico (Mumbai).

## Conteúdo
<a name="API_query_QueryComputeResponse_Contents"></a>

 ** ComputeMode **   <a name="timestream-Type-query_QueryComputeResponse-ComputeMode"></a>
O modo no qual as unidades de computação das Timestream Compute Units (TCUs) são alocadas e utilizadas em uma conta. Observe que na região Ásia-Pacífico (Mumbai), a operação da API reconhece apenas o valor `PROVISIONED`. QueryCompute está disponível agora na região da Ásia-Pacífico (Mumbai).  
Tipo: string  
Valores válidos: `ON_DEMAND | PROVISIONED`   
Obrigatório: não

 ** ProvisionedCapacity **   <a name="timestream-Type-query_QueryComputeResponse-ProvisionedCapacity"></a>
Objeto de configuração que contém as definições para as Timestream Compute Units (TCUs) provisionadas na sua conta. QueryCompute está disponível agora na região da Ásia-Pacífico (Mumbai).  
Tipo: objeto [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md)  
Obrigatório: não

## Consulte também
<a name="API_query_QueryComputeResponse_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeResponse) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeResponse) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeResponse) 

# QueryInsights
<a name="API_query_QueryInsights"></a>

 `QueryInsights` é um atributo de ajuste de desempenho que ajuda você a otimizar suas consultas, reduzir custos e melhorar o desempenho. Com o `QueryInsights`, você pode avaliar a eficiência da redução de suas consultas e identificar áreas de melhoria para aprimorar o desempenho das consultas. Com o `QueryInsights`, você também pode analisar a eficácia de suas consultas em termos de redução temporal e espacial e identificar oportunidades para melhorar o desempenho. Especificamente, você pode avaliar o quão bem suas consultas usam estratégias de indexação baseadas em tempo e chave de partição para otimizar a recuperação de dados. Para otimizar o desempenho da consulta, é essencial que você faça o ajuste fino dos parâmetros temporais e espaciais que governam a execução da consulta.

As principais métricas fornecidas pelo `QueryInsights` são `QuerySpatialCoverage` e `QueryTemporalRange`. `QuerySpatialCoverage` indica quanto do eixo espacial a consulta digitaliza, com valores mais baixos sendo mais eficientes. `QueryTemporalRange` mostra o intervalo de tempo escaneado, com intervalos mais estreitos tendo melhor desempenho.

 **Benefícios do QueryInsights** 

Os benefícios principais de usar o `QueryInsights` são os seguintes:
+  **Identificação de consultas ineficientes** — `QueryInsights` fornece informações sobre a remoção baseada em tempo e em atributos das tabelas acessadas pela consulta. Essas informações ajudarão você a identificar as tabelas que não são acessadas de forma ideal.
+  **Otimizar seu modelo de dados e particionamento** — Você pode usar as informações do `QueryInsights` para acessar e ajustar seu modelo de dados e sua estratégia de particionamento.
+  **Ajuste de consultas** — `QueryInsights` destaca as oportunidades de usar índices com mais eficiência.

**nota**  
O número máximo de solicitações de API `Query` que você pode fazer com o `QueryInsights` ativado é de 1 consulta por segundo (QPS). Se você exceder essa taxa de consulta, isso poderá resultar em um controle de utilização.

## Conteúdo
<a name="API_query_QueryInsights_Contents"></a>

 ** Mode **   <a name="timestream-Type-query_QueryInsights-Mode"></a>
Fornece os seguintes modos para ativar o `QueryInsights`:  
+  `ENABLED_WITH_RATE_CONTROL` – Ativa `QueryInsights` para as consultas que estão sendo processadas. Esse modo também inclui um mecanismo de controle de taxa, que limita o atributo `QueryInsights` a 1 consulta por segundo (QPS).
+  `DISABLED` – Desativa `QueryInsights`.
Tipo: String  
Valores Válidos: `ENABLED_WITH_RATE_CONTROL | DISABLED`   
Exigido: Sim

## Consulte também
<a name="API_query_QueryInsights_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsights) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsights) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsights) 

# QueryInsightsResponse
<a name="API_query_QueryInsightsResponse"></a>

Fornece vários insights e métricas relacionados à consulta que você executou.

## Conteúdo
<a name="API_query_QueryInsightsResponse_Contents"></a>

 ** OutputBytes **   <a name="timestream-Type-query_QueryInsightsResponse-OutputBytes"></a>
Indica o tamanho do conjunto de resultados da consulta em bytes. Você pode usar esses dados para validar se o conjunto de resultados foi alterado como parte do exercício de ajuste da consulta.  
Tipo: longo  
Obrigatório: Não

 ** OutputRows **   <a name="timestream-Type-query_QueryInsightsResponse-OutputRows"></a>
Indica o número total de linhas retornadas como parte do conjunto de resultados da consulta. Você pode usar esses dados para validar se o número de linhas no conjunto de resultados foi alterado como parte do exercício de ajuste da consulta.  
Tipo: longo  
Obrigatório: Não

 ** QuerySpatialCoverage **   <a name="timestream-Type-query_QueryInsightsResponse-QuerySpatialCoverage"></a>
Fornece informações sobre a cobertura espacial da consulta, incluindo a tabela com redução espacial abaixo do ideal (máximo). Essas informações podem ajudar você a identificar áreas de melhoria em sua estratégia de particionamento para aprimorar a redução espacial.   
Tipo: objeto [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md)  
Obrigatório: Não

 ** QueryTableCount **   <a name="timestream-Type-query_QueryInsightsResponse-QueryTableCount"></a>
Indica o número de tabelas na consulta.  
Tipo: longo  
Obrigatório: Não

 ** QueryTemporalRange **   <a name="timestream-Type-query_QueryInsightsResponse-QueryTemporalRange"></a>
Fornece informações sobre o intervalo temporal da consulta, incluindo a tabela com o maior intervalo de tempo (máximo). A seguir estão algumas das opções possíveis para otimizar a redução com base no tempo:  
+ Adicione predicados de tempo ausentes.
+ Remova funções de acordo com os predicados de tempo.
+ Adicione predicados de tempo a todas as subconsultas.
Tipo: objeto [QueryTemporalRange](API_query_QueryTemporalRange.md)  
Obrigatório: Não

 ** UnloadPartitionCount **   <a name="timestream-Type-query_QueryInsightsResponse-UnloadPartitionCount"></a>
Indica as partições criadas pela operação `Unload`.  
Tipo: longo  
Obrigatório: Não

 ** UnloadWrittenBytes **   <a name="timestream-Type-query_QueryInsightsResponse-UnloadWrittenBytes"></a>
Indica o tamanho, em bytes, escrito pela operação `Unload`.  
Tipo: longo  
Obrigatório: Não

 ** UnloadWrittenRows **   <a name="timestream-Type-query_QueryInsightsResponse-UnloadWrittenRows"></a>
Indica as linhas gravadas pela consulta `Unload`.  
Tipo: longo  
Obrigatório: Não

## Consulte também
<a name="API_query_QueryInsightsResponse_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsightsResponse) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsightsResponse) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsightsResponse) 

# QuerySpatialCoverage
<a name="API_query_QuerySpatialCoverage"></a>

Fornece informações sobre a cobertura espacial da consulta, incluindo a tabela com redução espacial abaixo do ideal (máximo). Essas informações podem ajudar você a identificar áreas de melhoria em sua estratégia de particionamento para aprimorar a redução espacial

Por exemplo, você pode fazer o seguinte com as informações `QuerySpatialCoverage`:
+ Adicione measure\$1name ou use predicados de [chave de partição definida pelo cliente](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html) (CDPK).
+ Se você já executou a ação anterior, remova as funções em torno delas ou das cláusulas, como `LIKE`.

## Conteúdo
<a name="API_query_QuerySpatialCoverage_Contents"></a>

 ** Max **   <a name="timestream-Type-query_QuerySpatialCoverage-Max"></a>
Fornece informações sobre a cobertura espacial da consulta executada e da tabela com a redução espacial mais ineficiente.  
+  `Value` — A proporção máxima de cobertura espacial.
+  `TableArn` — O nome do recurso da Amazon (ARN) da tabela com redução espacial abaixo do ideal.
+  `PartitionKey` — A chave de partição usada para particionamento, que pode ser padrão `measure_name` ou CDPK.
Tipo: objeto [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md)  
Obrigatório: Não

## Consulte também
<a name="API_query_QuerySpatialCoverage_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverage) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverage) 

# QuerySpatialCoverageMax
<a name="API_query_QuerySpatialCoverageMax"></a>

Fornece informações sobre a tabela com a faixa espacial mais abaixo do ideal escaneada pela sua consulta.

## Conteúdo
<a name="API_query_QuerySpatialCoverageMax_Contents"></a>

 ** PartitionKey **   <a name="timestream-Type-query_QuerySpatialCoverageMax-PartitionKey"></a>
A chave de partição usada para particionamento, que pode ser uma chave de partição padrão `measure_name` ou [definida pelo cliente](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html).  
Tipo: matriz de strings  
Obrigatório: Não

 ** TableArn **   <a name="timestream-Type-query_QuerySpatialCoverageMax-TableArn"></a>
O nome do recurso da Amazon (ARN) da tabela com a redução espacial mais inadequada.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: Não

 ** Value **   <a name="timestream-Type-query_QuerySpatialCoverageMax-Value"></a>
A proporção máxima de cobertura espacial.  
Tipo: duplo  
Obrigatório: Não

## Consulte também
<a name="API_query_QuerySpatialCoverageMax_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverageMax) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverageMax) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverageMax) 

# QueryStatus
<a name="API_query_QueryStatus"></a>

Informações sobre o status da consulta, incluindo progresso e bytes examinados.

## Conteúdo
<a name="API_query_QueryStatus_Contents"></a>

 ** CumulativeBytesMetered **   <a name="timestream-Type-query_QueryStatus-CumulativeBytesMetered"></a>
A quantidade de dados digitalizados pela consulta em bytes pela qual você será cobrado. Essa é uma soma cumulativa e representa a quantidade total de dados pela qual você será cobrado desde o início da consulta. A cobrança é aplicada somente uma vez e é aplicada quando a consulta é concluída ou quando a consulta é cancelada.   
Tipo: longo  
Obrigatório: Não

 ** CumulativeBytesScanned **   <a name="timestream-Type-query_QueryStatus-CumulativeBytesScanned"></a>
A quantidade de dados digitalizados pela consulta em bytes. Essa é uma soma cumulativa e representa a quantidade total de bytes verificados desde que a consulta foi iniciada.   
Tipo: longo  
Obrigatório: Não

 ** ProgressPercentage **   <a name="timestream-Type-query_QueryStatus-ProgressPercentage"></a>
O progresso da consulta, expresso como uma porcentagem.  
Tipo: duplo  
Obrigatório: Não

## Consulte também
<a name="API_query_QueryStatus_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryStatus) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryStatus) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryStatus) 

# QueryTemporalRange
<a name="API_query_QueryTemporalRange"></a>

Fornece informações sobre o intervalo temporal da consulta, incluindo a tabela com o maior intervalo de tempo (máximo).

## Conteúdo
<a name="API_query_QueryTemporalRange_Contents"></a>

 ** Max **   <a name="timestream-Type-query_QueryTemporalRange-Max"></a>
Encapsula as seguintes propriedades que fornecem informações sobre a tabela de desempenho mais abaixo do ideal no eixo temporal:  
+  `Value` — A duração máxima em nanossegundos entre o início e o fim da consulta.
+  `TableArn` — O nome do recurso da Amazon (ARN) da tabela que é consultada com o maior intervalo de tempo.
Tipo: objeto [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md)  
Obrigatório: Não

## Consulte também
<a name="API_query_QueryTemporalRange_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRange) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRange) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRange) 

# QueryTemporalRangeMax
<a name="API_query_QueryTemporalRangeMax"></a>

Fornece informações sobre a tabela com a redução temporal mais abaixo do ideal verificada pela sua consulta.

## Conteúdo
<a name="API_query_QueryTemporalRangeMax_Contents"></a>

 ** TableArn **   <a name="timestream-Type-query_QueryTemporalRangeMax-TableArn"></a>
O nome do recurso da Amazon (ARN) da tabela que é consultada com o maior intervalo de tempo.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: Não

 ** Value **   <a name="timestream-Type-query_QueryTemporalRangeMax-Value"></a>
A duração máxima em nanossegundos entre o início e o fim da consulta.  
Tipo: longo  
Obrigatório: Não

## Consulte também
<a name="API_query_QueryTemporalRangeMax_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRangeMax) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRangeMax) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRangeMax) 

# Row
<a name="API_query_Row"></a>

Representa uma única linha nos resultados da consulta.

## Conteúdo
<a name="API_query_Row_Contents"></a>

 ** Data **   <a name="timestream-Type-query_Row-Data"></a>
Lista de pontos de dados em uma única linha do conjunto de resultados.  
Tipo: matriz de objetos [Datum](API_query_Datum.md)  
Obrigatório: Sim

## Consulte também
<a name="API_query_Row_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Row) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Row) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Row) 

# S3Configuration
<a name="API_query_S3Configuration"></a>

Detalhes sobre a localização do S3 para relatórios de erros resultantes da execução de uma consulta. 

## Conteúdo
<a name="API_query_S3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-query_S3Configuration-BucketName"></a>
 Nome do bucket do S3 sob o qual os relatórios de erros serão criados.  
Tipo: String  
Restrições de tamanho: comprimento mínimo de 3. Tamanho máximo de 63.  
Padrão: : `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Exigido: Sim

 ** EncryptionOption **   <a name="timestream-Type-query_S3Configuration-EncryptionOption"></a>
 Opções de criptografia em repouso para os relatórios de erros. Se nenhuma opção de criptografia for especificada, o Timestream escolherá SSE\$1S3 como padrão.   
Tipo: String  
Valores Válidos: `SSE_S3 | SSE_KMS`   
Obrigatório: Não

 ** ObjectKeyPrefix **   <a name="timestream-Type-query_S3Configuration-ObjectKeyPrefix"></a>
 Prefixo para a chave do relatório de erros. Por padrão, o fluxo de tempo adiciona o seguinte prefixo ao caminho do relatório de erros.   
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 896.  
Padrão: : `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obrigatório: Não

## Consulte também
<a name="API_query_S3Configuration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3Configuration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3Configuration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3Configuration) 

# S3ReportLocation
<a name="API_query_S3ReportLocation"></a>

 Local do relatório S3 para a execução da consulta agendada.

## Conteúdo
<a name="API_query_S3ReportLocation_Contents"></a>

 ** BucketName **   <a name="timestream-Type-query_S3ReportLocation-BucketName"></a>
 O nome do bucket do S3.   
Tipo: String  
Restrições de tamanho: comprimento mínimo de 3. Tamanho máximo de 63.  
Padrão: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Obrigatório: Não

 ** ObjectKey **   <a name="timestream-Type-query_S3ReportLocation-ObjectKey"></a>
Chave S3.   
Tipo: String  
Obrigatório: Não

## Consulte também
<a name="API_query_S3ReportLocation_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3ReportLocation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3ReportLocation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3ReportLocation) 

# ScheduleConfiguration
<a name="API_query_ScheduleConfiguration"></a>

Configuração da programação da consulta.

## Conteúdo
<a name="API_query_ScheduleConfiguration_Contents"></a>

 ** ScheduleExpression **   <a name="timestream-Type-query_ScheduleConfiguration-ScheduleExpression"></a>
Uma expressão que indica quando acionar a execução da consulta programada. Pode ser uma expressão cron ou uma expressão de taxa.   
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.  
Obrigatório: Sim

## Consulte também
<a name="API_query_ScheduleConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduleConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduleConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduleConfiguration) 

# ScheduledQuery
<a name="API_query_ScheduledQuery"></a>

Consulta programada

## Conteúdo
<a name="API_query_ScheduledQuery_Contents"></a>

 ** Arn **   <a name="timestream-Type-query_ScheduledQuery-Arn"></a>
O nome do recurso da Amazon (ARN)  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: Sim

 ** Name **   <a name="timestream-Type-query_ScheduledQuery-Name"></a>
O nome da consulta programada.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.  
Padrão: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Exigido: Sim

 ** State **   <a name="timestream-Type-query_ScheduledQuery-State"></a>
Estado da consulta programada.   
Tipo: String  
Valores Válidos: `ENABLED | DISABLED`   
Obrigatório: Sim

 ** CreationTime **   <a name="timestream-Type-query_ScheduledQuery-CreationTime"></a>
O horário de criação da consulta agendada.  
Tipo: Timestamp  
Obrigatório: Não

 ** ErrorReportConfiguration **   <a name="timestream-Type-query_ScheduledQuery-ErrorReportConfiguration"></a>
A configuração do relatório de erros da consulta programada.  
Tipo: objeto [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Obrigatório: Não

 ** LastRunStatus **   <a name="timestream-Type-query_ScheduledQuery-LastRunStatus"></a>
Status da última execução de consulta programada.  
Tipo: String  
Valores Válidos: `AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE`   
Obrigatório: Não

 ** NextInvocationTime **   <a name="timestream-Type-query_ScheduledQuery-NextInvocationTime"></a>
O horário quando a próxima consulta programada deve ser executada.  
Tipo: Timestamp  
Obrigatório: Não

 ** PreviousInvocationTime **   <a name="timestream-Type-query_ScheduledQuery-PreviousInvocationTime"></a>
A última vez em que a consulta programada foi executada.  
Tipo: Timestamp  
Obrigatório: Não

 ** TargetDestination **   <a name="timestream-Type-query_ScheduledQuery-TargetDestination"></a>
Fonte de dados de destino na qual o resultado final da consulta agendada será gravado.  
Tipo: objeto [TargetDestination](API_query_TargetDestination.md)  
Obrigatório: Não

## Consulte também
<a name="API_query_ScheduledQuery_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQuery) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQuery) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQuery) 

# ScheduledQueryDescription
<a name="API_query_ScheduledQueryDescription"></a>

Estrutura que descreve a consulta programada.

## Conteúdo
<a name="API_query_ScheduledQueryDescription_Contents"></a>

 ** Arn **   <a name="timestream-Type-query_ScheduledQueryDescription-Arn"></a>
ARN da consulta programada.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: Sim

 ** Name **   <a name="timestream-Type-query_ScheduledQueryDescription-Name"></a>
Nome da consulta programada.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.  
Padrão: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Exigido: Sim

 ** NotificationConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-NotificationConfiguration"></a>
Configuração de notificação.  
Tipo: objeto [NotificationConfiguration](API_query_NotificationConfiguration.md)  
Obrigatório: Sim

 ** QueryString **   <a name="timestream-Type-query_ScheduledQueryDescription-QueryString"></a>
A consulta a ser executada.  
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 262144.  
Obrigatório: Sim

 ** ScheduleConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-ScheduleConfiguration"></a>
Configuração de programação.  
Tipo: objeto [ScheduleConfiguration](API_query_ScheduleConfiguration.md)  
Obrigatório: Sim

 ** State **   <a name="timestream-Type-query_ScheduledQueryDescription-State"></a>
Estado da consulta programada.   
Tipo: String  
Valores Válidos: `ENABLED | DISABLED`   
Obrigatório: Sim

 ** CreationTime **   <a name="timestream-Type-query_ScheduledQueryDescription-CreationTime"></a>
O horário de criação da consulta programada.  
Tipo: Timestamp  
Obrigatório: Não

 ** ErrorReportConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-ErrorReportConfiguration"></a>
A configuração do relatório de erros da consulta programada.  
Tipo: objeto [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Obrigatório: Não

 ** KmsKeyId **   <a name="timestream-Type-query_ScheduledQueryDescription-KmsKeyId"></a>
Uma chave KMS fornecida pelo cliente utilizada para criptografar o atributo de consulta programada.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: Não

 ** LastRunSummary **   <a name="timestream-Type-query_ScheduledQueryDescription-LastRunSummary"></a>
Resumo do runtime da última execução da consulta programada.   
Tipo: objeto [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md)  
Obrigatório: Não

 ** NextInvocationTime **   <a name="timestream-Type-query_ScheduledQueryDescription-NextInvocationTime"></a>
O horário quando a próxima consulta programada está programada para ser executada.  
Tipo: Timestamp  
Obrigatório: Não

 ** PreviousInvocationTime **   <a name="timestream-Type-query_ScheduledQueryDescription-PreviousInvocationTime"></a>
Última vez que a consulta foi executada.  
Tipo: Timestamp  
Obrigatório: Não

 ** RecentlyFailedRuns **   <a name="timestream-Type-query_ScheduledQueryDescription-RecentlyFailedRuns"></a>
Resumo do runtime das últimas cinco execuções de consulta programadas com falha.  
Tipo: matriz de objetos [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md)  
Obrigatório: Não

 ** ScheduledQueryExecutionRoleArn **   <a name="timestream-Type-query_ScheduledQueryDescription-ScheduledQueryExecutionRoleArn"></a>
Perfil do IAM que o Timestream usa para executar a consulta programada.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: Não

 ** TargetConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-TargetConfiguration"></a>
Configuração programada do armazenamento de destinos da consulta.  
Tipo: objeto [TargetConfiguration](API_query_TargetConfiguration.md)  
Obrigatório: Não

## Consulte também
<a name="API_query_ScheduledQueryDescription_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryDescription) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryDescription) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryDescription) 

# ScheduledQueryInsights
<a name="API_query_ScheduledQueryInsights"></a>

Encapsula as configurações para ativação do `QueryInsights` em um `ExecuteScheduledQueryRequest`. 

## Conteúdo
<a name="API_query_ScheduledQueryInsights_Contents"></a>

 ** Mode **   <a name="timestream-Type-query_ScheduledQueryInsights-Mode"></a>
Fornece os seguintes modos para ativar o `ScheduledQueryInsights`:  
+  `ENABLED_WITH_RATE_CONTROL` – Ativa `ScheduledQueryInsights` para as consultas que estão sendo processadas. Esse modo também inclui um mecanismo de controle de taxa, que limita o atributo `QueryInsights` a 1 consulta por segundo (QPS).
+  `DISABLED` – Desativa `ScheduledQueryInsights`.
Tipo: String  
Valores Válidos: `ENABLED_WITH_RATE_CONTROL | DISABLED`   
Exigido: Sim

## Consulte também
<a name="API_query_ScheduledQueryInsights_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsights) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsights) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsights) 

# ScheduledQueryInsightsResponse
<a name="API_query_ScheduledQueryInsightsResponse"></a>

Fornece vários insights e métricas relacionados ao `ExecuteScheduledQueryRequest` que foi executado.

## Conteúdo
<a name="API_query_ScheduledQueryInsightsResponse_Contents"></a>

 ** OutputBytes **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-OutputBytes"></a>
Indica o tamanho do conjunto de resultados da consulta em bytes. Você pode usar esses dados para validar se o conjunto de resultados foi alterado como parte do exercício de ajuste da consulta.  
Tipo: longo  
Obrigatório: Não

 ** OutputRows **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-OutputRows"></a>
Indica o número total de linhas retornadas como parte do conjunto de resultados da consulta. Você pode usar esses dados para validar se o número de linhas no conjunto de resultados foi alterado como parte do exercício de ajuste da consulta.  
Tipo: longo  
Obrigatório: Não

 ** QuerySpatialCoverage **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-QuerySpatialCoverage"></a>
Fornece informações sobre a cobertura espacial da consulta, incluindo a tabela com redução espacial abaixo do ideal (máximo). Essas informações podem ajudar você a identificar áreas de melhoria em sua estratégia de particionamento para aprimorar a redução espacial.  
Tipo: objeto [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md)  
Obrigatório: Não

 ** QueryTableCount **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-QueryTableCount"></a>
Indica o número de tabelas na consulta.  
Tipo: longo  
Obrigatório: Não

 ** QueryTemporalRange **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-QueryTemporalRange"></a>
Fornece informações sobre o intervalo temporal da consulta, incluindo a tabela com o maior intervalo de tempo (máximo). A seguir estão algumas das opções possíveis para otimizar a redução com base no tempo:  
+ Adicione predicados de tempo ausentes.
+ Remova funções de acordo com os predicados de tempo.
+ Adicione predicados de tempo a todas as subconsultas.
Tipo: objeto [QueryTemporalRange](API_query_QueryTemporalRange.md)  
Obrigatório: Não

## Consulte também
<a name="API_query_ScheduledQueryInsightsResponse_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) 

# ScheduledQueryRunSummary
<a name="API_query_ScheduledQueryRunSummary"></a>

Resumo de execução da consulta programada

## Conteúdo
<a name="API_query_ScheduledQueryRunSummary_Contents"></a>

 ** ErrorReportLocation **   <a name="timestream-Type-query_ScheduledQueryRunSummary-ErrorReportLocation"></a>
Local S3 para relatório de erros.  
Tipo: objeto [ErrorReportLocation](API_query_ErrorReportLocation.md)  
Obrigatório: Não

 ** ExecutionStats **   <a name="timestream-Type-query_ScheduledQueryRunSummary-ExecutionStats"></a>
Estatísticas de runtime para uma execução programada.  
Tipo: objeto [ExecutionStats](API_query_ExecutionStats.md)  
Obrigatório: Não

 ** FailureReason **   <a name="timestream-Type-query_ScheduledQueryRunSummary-FailureReason"></a>
Mensagem de erro para a consulta programada em caso de falha. Talvez seja necessário consultar o relatório de erros para obter motivos de erro mais detalhados.   
Tipo: String  
Obrigatório: Não

 ** InvocationTime **   <a name="timestream-Type-query_ScheduledQueryRunSummary-InvocationTime"></a>
InvocationTime para esta execução. Esse é o horário em que a consulta está programada para ser executada. O parâmetro `@scheduled_runtime` pode ser usado na consulta para obter o valor.   
Tipo: Timestamp  
Obrigatório: Não

 ** QueryInsightsResponse **   <a name="timestream-Type-query_ScheduledQueryRunSummary-QueryInsightsResponse"></a>
Fornece vários insights e métricas relacionados ao resumo da execução da consulta programada.  
Tipo: objeto [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md)  
Obrigatório: Não

 ** RunStatus **   <a name="timestream-Type-query_ScheduledQueryRunSummary-RunStatus"></a>
O status de uma consulta agendada executada.  
Tipo: String  
Valores Válidos: `AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE`   
Obrigatório: Não

 ** TriggerTime **   <a name="timestream-Type-query_ScheduledQueryRunSummary-TriggerTime"></a>
O horário real em que a consulta foi executada.  
Tipo: Timestamp  
Obrigatório: Não

## Consulte também
<a name="API_query_ScheduledQueryRunSummary_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryRunSummary) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryRunSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryRunSummary) 

# SelectColumn
<a name="API_query_SelectColumn"></a>

Detalhes da coluna retornada pela consulta. 

## Conteúdo
<a name="API_query_SelectColumn_Contents"></a>

 ** Aliased **   <a name="timestream-Type-query_SelectColumn-Aliased"></a>
Verdadeiro, caso o nome da coluna tenha o alias da consulta. Caso contrário, falso.  
Tipo: booliano  
Obrigatório: não

 ** DatabaseName **   <a name="timestream-Type-query_SelectColumn-DatabaseName"></a>
 Banco de dados que tem essa coluna.  
Tipo: string  
Obrigatório: não

 ** Name **   <a name="timestream-Type-query_SelectColumn-Name"></a>
Nome da coluna.  
Tipo: string  
Obrigatório: não

 ** TableName **   <a name="timestream-Type-query_SelectColumn-TableName"></a>
Tabela dentro do banco de dados que tem essa coluna.   
Tipo: string  
Obrigatório: não

 ** Type **   <a name="timestream-Type-query_SelectColumn-Type"></a>
Contém o tipo de dados de uma coluna em um conjunto de resultados de consulta. O tipo de dados pode ser escalar ou complexo. Os tipos de dados escalares suportados são inteiros, booleanos, string, double, registro de data e hora, data, hora e intervalos. Os tipos de dados complexos suportados são matrizes, linhas e séries temporais.  
Tipo: objeto [Type](API_query_Type.md)  
Obrigatório: não

## Consulte também
<a name="API_query_SelectColumn_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SelectColumn) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SelectColumn) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SelectColumn) 

# SnsConfiguration
<a name="API_query_SnsConfiguration"></a>

Detalhes sobre o SNS que são necessários para enviar a notificação.

## Conteúdo
<a name="API_query_SnsConfiguration_Contents"></a>

 ** TopicArn **   <a name="timestream-Type-query_SnsConfiguration-TopicArn"></a>
ARN do tópico do SNS para o qual as notificações de status da consulta programada serão enviadas.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: Sim

## Consulte também
<a name="API_query_SnsConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SnsConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SnsConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SnsConfiguration) 

# Tag
<a name="API_query_Tag"></a>

Tag é um rótulo que você atribui a um banco de dados e/ou uma tabela do Timestream. Cada tag consiste de uma chave e um valor opcional, que podem ser definidos. As tags permitem categorizar bancos de dados e/ou tabelas, por exemplo, por finalidade, proprietário ou ambiente. 

## Conteúdo
<a name="API_query_Tag_Contents"></a>

 ** Key **   <a name="timestream-Type-query_Tag-Key"></a>
Chave da tag. Chaves de tag fazem distinção entre maiúsculas e minúsculas.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.  
Obrigatório: sim

 ** Value **   <a name="timestream-Type-query_Tag-Value"></a>
Valor da tag. Os valores de tag diferenciam maiúsculas de minúsculas e podem ser nulos.   
Tipo: string  
Restrições de tamanho: o tamanho mínimo é 0. O tamanho máximo é 256.  
Obrigatório: sim

## Consulte também
<a name="API_query_Tag_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Tag) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Tag) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Tag) 

# TargetConfiguration
<a name="API_query_TargetConfiguration"></a>

Configuração utilizada para gravar a saída de uma consulta.

## Conteúdo
<a name="API_query_TargetConfiguration_Contents"></a>

 ** TimestreamConfiguration **   <a name="timestream-Type-query_TargetConfiguration-TimestreamConfiguration"></a>
Configuração necessária para gravar dados no banco de dados e na tabela Timestream.  
Tipo: objeto [TimestreamConfiguration](API_query_TimestreamConfiguration.md)  
Obrigatório: Sim

## Consulte também
<a name="API_query_TargetConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetConfiguration) 

# TargetDestination
<a name="API_query_TargetDestination"></a>

Detalhes do destino para gravar dados para uma fonte de dados de destino. A fonte de dados atualmente suportada é Timestream.

## Conteúdo
<a name="API_query_TargetDestination_Contents"></a>

 ** TimestreamDestination **   <a name="timestream-Type-query_TargetDestination-TimestreamDestination"></a>
Detalhes do destino do resultado da consulta para a fonte de dados Timestream.  
Tipo: objeto [TimestreamDestination](API_query_TimestreamDestination.md)  
Obrigatório: Não

## Consulte também
<a name="API_query_TargetDestination_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetDestination) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetDestination) 

# TimeSeriesDataPoint
<a name="API_query_TimeSeriesDataPoint"></a>

O tipo de dados timeseries representa os valores de uma medida ao longo do tempo. Uma série temporal é uma matriz composta por linhas de registros de data e hora, juntamente com valores de medida, organizadas em ordem crescente de tempo. Um TimeSeriesDataPoint é um ponto de dados único nas séries temporais. Indica uma tupla de (tempo, valor de medida) em uma série temporal. 

## Conteúdo
<a name="API_query_TimeSeriesDataPoint_Contents"></a>

 ** Time **   <a name="timestream-Type-query_TimeSeriesDataPoint-Time"></a>
Data e hora em que o valor da medida foi coletado.  
Tipo: string  
Obrigatório: sim

 ** Value **   <a name="timestream-Type-query_TimeSeriesDataPoint-Value"></a>
Valor da medida para o ponto de dados.  
Tipo: objeto [Datum](API_query_Datum.md)  
Obrigatório: sim

## Consulte também
<a name="API_query_TimeSeriesDataPoint_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimeSeriesDataPoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimeSeriesDataPoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimeSeriesDataPoint) 

# TimestreamConfiguration
<a name="API_query_TimestreamConfiguration"></a>

 Configuração para gravar dados no banco de dados e na tabela Timestream. Essa configuração permite que o usuário mapeie as colunas de seleção de resultados da consulta nas colunas da tabela de destino. 

## Conteúdo
<a name="API_query_TimestreamConfiguration_Contents"></a>

 ** DatabaseName **   <a name="timestream-Type-query_TimestreamConfiguration-DatabaseName"></a>
Nome do banco de dados do Timestream no qual o resultado da consulta será gravado.  
Tipo: string  
Obrigatório: Sim

 ** DimensionMappings **   <a name="timestream-Type-query_TimestreamConfiguration-DimensionMappings"></a>
 Isso permite o mapeamento de coluna(s) do resultado da consulta para uma dimensão na tabela de destino.   
Tipo: matriz de objetos [DimensionMapping](API_query_DimensionMapping.md)  
Obrigatório: Sim

 ** TableName **   <a name="timestream-Type-query_TimestreamConfiguration-TableName"></a>
Nome da tabela Timestream na qual o resultado da consulta será gravado. A tabela deve estar dentro do mesmo banco de dados fornecido na configuração de Timestream.  
Tipo: string  
Obrigatório: Sim

 ** TimeColumn **   <a name="timestream-Type-query_TimestreamConfiguration-TimeColumn"></a>
Coluna do resultado da consulta que deve ser utilizada como coluna de tempo na tabela de destino. Para isso, o tipo de coluna deve ser TIMESTAMP.  
Tipo: string  
Obrigatório: Sim

 ** MeasureNameColumn **   <a name="timestream-Type-query_TimestreamConfiguration-MeasureNameColumn"></a>
O nome da coluna de medida.  
Tipo: String  
Obrigatório: Não

 ** MixedMeasureMappings **   <a name="timestream-Type-query_TimestreamConfiguration-MixedMeasureMappings"></a>
Especifica como mapear medidas para registros de várias medidas.  
Tipo: Matriz de objetos [MixedMeasureMapping](API_query_MixedMeasureMapping.md)  
Membros da matriz: número mínimo de 1 item.  
Obrigatório: Não

 ** MultiMeasureMappings **   <a name="timestream-Type-query_TimestreamConfiguration-MultiMeasureMappings"></a>
Mapeamentos de várias medidas.  
Tipo: objeto [MultiMeasureMappings](API_query_MultiMeasureMappings.md)  
Obrigatório: Não

## Consulte também
<a name="API_query_TimestreamConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamConfiguration) 

# TimestreamDestination
<a name="API_query_TimestreamDestination"></a>

Destino para consulta programada.

## Conteúdo
<a name="API_query_TimestreamDestination_Contents"></a>

 ** DatabaseName **   <a name="timestream-Type-query_TimestreamDestination-DatabaseName"></a>
Nome do banco de dados do Timestream.   
Tipo: String  
Obrigatório: Não

 ** TableName **   <a name="timestream-Type-query_TimestreamDestination-TableName"></a>
Nome da tabela do Timestream.   
Tipo: String  
Obrigatório: Não

## Consulte também
<a name="API_query_TimestreamDestination_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamDestination) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamDestination) 

# Type
<a name="API_query_Type"></a>

Contém o tipo de dados de uma coluna em um conjunto de resultados de consulta. O tipo de dados pode ser escalar ou complexo. Os tipos de dados escalares suportados são inteiros, booleanos, string, duplo, registro de data e hora, data, hora e intervalos. Os tipos de dados complexos suportados são matrizes, linhas e séries temporais.

## Conteúdo
<a name="API_query_Type_Contents"></a>

 ** ArrayColumnInfo **   <a name="timestream-Type-query_Type-ArrayColumnInfo"></a>
Indica se a coluna é uma matriz.  
Tipo: objeto [ColumnInfo](API_query_ColumnInfo.md)  
Obrigatório: Não

 ** RowColumnInfo **   <a name="timestream-Type-query_Type-RowColumnInfo"></a>
Indica se a coluna é uma linha.  
Tipo: matriz de objetos [ColumnInfo](API_query_ColumnInfo.md)  
Obrigatório: Não

 ** ScalarType **   <a name="timestream-Type-query_Type-ScalarType"></a>
Indica se a coluna é do tipo string, inteiro, booleano, duplo, registro de data e hora, data, hora. Para obter mais informações, consulte [Tipos de dados com suporte](https://docs.aws.amazon.com/timestream/latest/developerguide/supported-data-types.html).  
Tipo: String  
Valores Válidos: `VARCHAR | BOOLEAN | BIGINT | DOUBLE | TIMESTAMP | DATE | TIME | INTERVAL_DAY_TO_SECOND | INTERVAL_YEAR_TO_MONTH | UNKNOWN | INTEGER`   
Obrigatório: Não

 ** TimeSeriesMeasureValueColumnInfo **   <a name="timestream-Type-query_Type-TimeSeriesMeasureValueColumnInfo"></a>
Indica se a coluna é do tipo de dados de série temporal.  
Tipo: objeto [ColumnInfo](API_query_ColumnInfo.md)  
Obrigatório: Não

## Consulte também
<a name="API_query_Type_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Type) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Type) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Type) 

# Erros comuns
<a name="CommonErrors"></a>

Esta seção lista os erros comuns às ações de API de todos os serviços da AWS. Para saber os erros específicos de uma ação de API para esse serviço, consulte o tópico sobre a ação de API em questão.

 **AccessDeniedException**   
Você não tem acesso suficiente para executar essa ação.  
Código de Status HTTP: 400

 **IncompleteSignature**   
A assinatura da solicitação não segue os padrões da AWS.  
Código de Status HTTP: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
O processamento da solicitação falhou por causa de um erro, uma exceção ou uma falha desconhecida.  
Código de Status HTTP: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
A ação ou operação solicitada é inválida. Verifique se a ação foi digitada corretamente.  
Código de Status HTTP: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
O certificado X.509 ou o ID de chave de acesso da AWS fornecido não existe em nossos registros.  
Código de status HTTP: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
Você não tem permissão para realizar esta ação.  
Código de Status HTTP: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
O ID da chave de acesso da AWS precisa de uma assinatura do serviço.  
Código de status HTTP: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
A solicitação atingiu o serviço mais de 15 minutos após a data na solicitação ou mais de 15 minutos após a data de expiração da solicitação (como para URLs predeterminados), ou a data na solicitação está a mais de 15 minutos no futuro.  
Código de Status HTTP: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
Falha na solicitação devido a um erro temporário do servidor.  
Código de status HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
A solicitação foi negada devido à limitação da solicitação.  
Código de Status HTTP: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
A entrada não atende às restrições especificadas por um serviço da AWS.  
Código de Status HTTP: 400

# Parâmetros gerais
<a name="CommonParameters"></a>

A lista a seguir contém os parâmetros que todas as ações usam para assinar solicitações do Signature versão 4 com uma string de consulta. Todos os parâmetros específicos de uma ação são listados no tópico para a ação. Para obter mais informações sobre o Signature versão 4, consulte [Assinatura de solicitações de API da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) no *Guia do usuário do IAM*.

 **Action**   <a name="CommonParameters-Action"></a>
A ação a ser executada.  
Tipo: string  
Obrigatório: Sim

 **Version**   <a name="CommonParameters-Version"></a>
A versão da API para a qual a solicitação foi escrita, expressa no formato AAAA-MM-DD.  
Tipo: string  
Obrigatório: Sim

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
O algoritmo de hash que foi usado para criar a assinatura da solicitação.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Valores Válidos: `AWS4-HMAC-SHA256`   
Obrigatório: condicional

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
O valor de escopo da credencial, uma string que inclui a sua chave de acesso, a data, a região visada, o serviço que está sendo solicitado e uma sequência de encerramento ("aws4\$1request"). O valor é expresso no seguinte formato: *chave\$1acesso*/*AAAAMMDD*/*região*/*serviço*/aws4\$1request.  
Para obter mais informações, consulte [Criação de uma solicitação de API da AWS assinada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) no *Guia do usuário do IAM*.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
A data usada para criar a assinatura. O formato deve ser o formato básico ISO 8601 (AAAAMMDD'T'HHMMSS'Z'). Por exemplo, a data/hora a seguir é um valor X-Amz-Date válido: `20120325T120000Z`.  
Condição: X-Amz-Date é opcional para todas as solicitações e pode ser usado para substituir a data usada para assinar solicitações. Se o cabeçalho Date (Data) for especificado no formato básico ISO 8601, o valor X-Amz-Date não será necessário. Quando X-Amz-Date é usado, sempre substitui o valor do cabeçalho Date (Data). Para obter mais informações, consulte [Elementos de uma assinatura de solicitação de API da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) no *Guia do usuário do IAM*.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
O token de segurança temporário que foi obtido por meio de uma chamada para o AWS Security Token Service (AWS STS). Para obter uma lista de serviços que oferecem suporte a credenciais de segurança temporárias do AWS STS, consulte [Serviços da AWS que funcionam com o IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) no *Guia do usuário do IAM*.  
Condição: se estiver usando credenciais de segurança temporárias do AWS STS, será necessário incluir o token de segurança.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Especifica a assinatura com codificação hexadecimal que foi calculada com base na string a ser assinada e na chave de assinatura derivada.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Especifica todos os cabeçalhos HTTP que foram incluídos como parte da solicitação canônica. Para obter mais informações sobre a especificação de cabeçalhos assinados, consulte [Criação de uma solicitação de API da AWS assinada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) no *Guia do usuário do IAM*.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Obrigatório: Condicional