

Per funzionalità simili a Amazon Timestream for, prendi in considerazione Amazon Timestream LiveAnalytics per InfluxDB. Offre un'acquisizione semplificata dei dati e tempi di risposta alle query di una sola cifra di millisecondi per analisi in tempo reale. [Scopri](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html) di più qui.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Aggiunge una nuova tabella a un database esistente nel tuo account. In un Account AWS, i nomi delle tabelle devono essere almeno univoci all'interno di ogni regione se si trovano nello stesso database. Potresti avere nomi di tabella identici nella stessa regione se le tabelle si trovano in database separati. Durante la creazione della tabella, è necessario specificare il nome della tabella, il nome del database e le proprietà di conservazione. [Si applicano le quote di servizio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulta l'[esempio di codice](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html) per i dettagli. 

## Sintassi della richiesta
<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"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateTable_RequestParameters"></a>

Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

La richiesta accetta i seguenti dati in formato JSON.

 ** [DatabaseName](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-DatabaseName"></a>
Nome del database Timestream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Modello: `[a-zA-Z0-9_.-]+`   
Obbligatorio: sì

 ** [MagneticStoreWriteProperties](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-MagneticStoreWriteProperties"></a>
Contiene le proprietà da impostare nella tabella quando si abilitano le scritture dello store magnetico.  
Tipo: oggetto [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)  
Obbligatorio: no

 ** [RetentionProperties](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-RetentionProperties"></a>
La durata per la quale i dati delle serie temporali devono essere archiviati nell'archivio di memoria e nell'archivio magnetico.  
Tipo: oggetto [RetentionProperties](API_RetentionProperties.md)  
Obbligatorio: no

 ** [Schema](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-Schema"></a>
 Lo schema della tabella.   
Tipo: oggetto [Schema](API_Schema.md)  
Obbligatorio: no

 ** [TableName](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-TableName"></a>
Nome della tabella Timestream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Modello: `[a-zA-Z0-9_.-]+`   
Obbligatorio: sì

 ** [Tags](#API_CreateTable_RequestSyntax) **   <a name="timestream-CreateTable-request-Tags"></a>
 Un elenco di coppie chiave-valore per etichettare la tabella.   
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: no

## Sintassi della risposta
<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"
   }
}
```

## Elementi di risposta
<a name="API_CreateTable_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Table](#API_CreateTable_ResponseSyntax) **   <a name="timestream-CreateTable-response-Table"></a>
La tabella Timestream appena creata.  
Tipo: oggetto [Table](API_Table.md)

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

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
Codice di stato HTTP: 400

 ** ConflictException **   
Timestream non è stato in grado di elaborare questa richiesta perché contiene risorse già esistenti.  
Codice di stato HTTP: 400

 ** InternalServerException **   
 Timestream non è stato in grado di elaborare completamente questa richiesta a causa di un errore interno del server.  
Codice di stato HTTP: 500

 ** InvalidEndpointException **   
L'endpoint richiesto non era valido.  
Codice di stato HTTP: 400

 ** InvalidEndpointException **   
L'endpoint richiesto non era valido.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
L'operazione ha tentato di accedere a una risorsa inesistente. La risorsa potrebbe non essere specificata correttamente o il suo stato potrebbe non essere ATTIVO.  
Codice di stato HTTP: 400

 ** ServiceQuotaExceededException **   
 La quota di risorse dell'istanza è stata superata per questo account.  
Codice di stato HTTP: 400

 ** ThrottlingException **   
 Troppe richieste sono state fatte da un utente e hanno superato le quote di servizio. La richiesta è stata sottoposta a throttling.  
Codice di stato HTTP: 400

 ** ValidationException **   
 Richiesta non valida o non valida.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_CreateTable_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateTable) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateTable) 