

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

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