

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

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