

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

# Guida di riferimento alle API
<a name="API_Reference"></a>

Questa sezione contiene la documentazione di riferimento delle API per Amazon Timestream. 

Timestream ne ha due APIs: Query e Write.
+ L'**API Write** consente di eseguire operazioni come la creazione di tabelle, l'etichettatura delle risorse e la scrittura di record su Timestream.
+ L'**API Query** consente di eseguire operazioni di interrogazione.

**Nota**  
Entrambi APIs includono l' DescribeEndpoints azione. *Sia per Query che per Write, l' DescribeEndpoints azione è identica.*

Di seguito puoi leggere ulteriori informazioni su ciascuna API, insieme ai tipi di dati, agli errori e ai parametri comuni.

**Nota**  
Per i codici di errore comuni a tutti i AWS servizi, consulta la [sezione AWS Support](https://docs.aws.amazon.com/awssupport/latest/APIReference/CommonErrors.html). 

**Topics**
+ [Operazioni](API_Operations.md)
+ [Tipi di dati](API_Types.md)
+ [Errori comuni](CommonErrors.md)
+ [Parametri comuni](CommonParameters.md)

# Operazioni
<a name="API_Operations"></a>

Le seguenti azioni sono supportate da Amazon Timestream Write:
+  [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) 

Le seguenti azioni sono supportate da Amazon Timestream Query:
+  [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) 

# Amazon Timestream Write
<a name="API_Operations_Amazon_Timestream_Write"></a>

Le seguenti azioni sono supportate da Amazon Timestream Write:
+  [CreateBatchLoadTask](API_CreateBatchLoadTask.md) 
+  [CreateDatabase](API_CreateDatabase.md) 
+  [CreateTable](API_CreateTable.md) 
+  [DeleteDatabase](API_DeleteDatabase.md) 
+  [DeleteTable](API_DeleteTable.md) 
+  [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) 
+  [DescribeDatabase](API_DescribeDatabase.md) 
+  [DescribeEndpoints](API_DescribeEndpoints.md) 
+  [DescribeTable](API_DescribeTable.md) 
+  [ListBatchLoadTasks](API_ListBatchLoadTasks.md) 
+  [ListDatabases](API_ListDatabases.md) 
+  [ListTables](API_ListTables.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateDatabase](API_UpdateDatabase.md) 
+  [UpdateTable](API_UpdateTable.md) 
+  [WriteRecords](API_WriteRecords.md) 

# CreateBatchLoadTask
<a name="API_CreateBatchLoadTask"></a>

Crea una nuova attività di caricamento batch Timestream. Un'attività di caricamento in batch elabora i dati da un'origine CSV in una posizione S3 e li scrive in una tabella Timestream. Una mappatura dall'origine alla destinazione è definita in un'attività di caricamento in batch. Gli errori e gli eventi vengono scritti in un report in una posizione S3. Per il report, se la AWS KMS chiave non è specificata, il report verrà crittografato con una chiave gestita S3, se `SSE_S3` possibile. Altrimenti viene generato un errore. Per ulteriori informazioni, consulta le [AWS chiavi gestite da](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) . [Si applicano le quote di servizio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Per i dettagli, vedi [esempio di codice](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html).

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

## Parametri della richiesta
<a name="API_CreateBatchLoadTask_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.

 ** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-ClientToken"></a>
  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Obbligatorio: no

 ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-DataModelConfiguration"></a>
  
Tipo: oggetto [DataModelConfiguration](API_DataModelConfiguration.md)  
Obbligatorio: no

 ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-DataSourceConfiguration"></a>
Definisce i dettagli di configurazione sull'origine dati per un'attività di caricamento in batch.  
Tipo: oggetto [DataSourceConfiguration](API_DataSourceConfiguration.md)  
Obbligatorio: sì

 ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-RecordVersion"></a>
  
Tipo: long  
Obbligatorio: no

 ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-ReportConfiguration"></a>
Configurazione del report per un'attività di caricamento in batch. Contiene dettagli sulla posizione in cui vengono archiviate le segnalazioni di errori.  
Tipo: oggetto [ReportConfiguration](API_ReportConfiguration.md)  
Obbligatorio: sì

 ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-TargetDatabaseName"></a>
Database Target Timestream per un'attività di caricamento in batch.  
Tipo: stringa  
Modello: `[a-zA-Z0-9_.-]+`   
Obbligatorio: sì

 ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-TargetTableName"></a>
Tabella Target Timestream per un'attività di caricamento in batch.  
Tipo: stringa  
Modello: `[a-zA-Z0-9_.-]+`   
Obbligatorio: sì

## Sintassi della risposta
<a name="API_CreateBatchLoadTask_ResponseSyntax"></a>

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

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

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

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

 ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) **   <a name="timestream-CreateBatchLoadTask-response-TaskId"></a>
L'ID dell'operazione di caricamento in batch.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 32 caratteri.  
Modello: `[A-Z0-9]+` 

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

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori 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

 ** 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_CreateBatchLoadTask_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/CreateBatchLoadTask) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask) 

# CreateDatabase
<a name="API_CreateDatabase"></a>

Crea un nuovo database Timestream. Se la AWS KMS chiave non è specificata, il database verrà crittografato con una AWS KMS chiave gestita Timestream situata nel tuo account. Per ulteriori informazioni, consulta le [AWS chiavi gestite da](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) . [Si applicano le quote di servizio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Per i dettagli, consulta l'esempio di [codice.](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html) 

## Sintassi della richiesta
<a name="API_CreateDatabase_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_CreateDatabase_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_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-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ì

 ** [KmsKeyId](#API_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-request-KmsKeyId"></a>
La AWS KMS chiave per il database. Se la AWS KMS chiave non è specificata, il database verrà crittografato con una AWS KMS chiave gestita da Timestream situata nel tuo account. Per ulteriori informazioni, consulta le [AWS chiavi gestite da](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) .  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: no

 ** [Tags](#API_CreateDatabase_RequestSyntax) **   <a name="timestream-CreateDatabase-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_CreateDatabase_ResponseSyntax"></a>

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

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

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

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

 ** [Database](#API_CreateDatabase_ResponseSyntax) **   <a name="timestream-CreateDatabase-response-Database"></a>
Il database Timestream appena creato.  
Tipo: oggetto [Database](API_Database.md)

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

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori 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

 ** 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_CreateDatabase_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/CreateDatabase) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateDatabase) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateDatabase) 

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

# DeleteDatabase
<a name="API_DeleteDatabase"></a>

Elimina un determinato database Timestream. *Si tratta di un'operazione irreversibile. Dopo l'eliminazione di un database, i dati delle serie temporali dalle relative tabelle non possono essere recuperati.* 

**Nota**  
Tutte le tabelle del database devono essere prima eliminate, altrimenti verrà ValidationException generato un errore.   
A causa della natura dei tentativi distribuiti, l'operazione può restituire un risultato positivo o un. ResourceNotFoundException I clienti dovrebbero considerarli equivalenti.

Consulta l'[esempio di codice](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html) per i dettagli.

## Sintassi della richiesta
<a name="API_DeleteDatabase_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_DeleteDatabase_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_DeleteDatabase_RequestSyntax) **   <a name="timestream-DeleteDatabase-request-DatabaseName"></a>
Il nome del database Timestream da eliminare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** 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

 ** 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_DeleteDatabase_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/DeleteDatabase) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteDatabase) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteDatabase) 

# DeleteTable
<a name="API_DeleteTable"></a>

Elimina una determinata tabella Timestream. Si tratta di un'operazione irreversibile. Dopo l'eliminazione di una tabella del database Timestream, i dati delle serie temporali memorizzati nella tabella non possono essere recuperati. 

**Nota**  
A causa della natura dei tentativi distribuiti, l'operazione può restituire un risultato positivo o un. ResourceNotFoundException I clienti dovrebbero considerarli equivalenti.

Consulta l'[esempio di codice](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html) per i dettagli.

## Sintassi della richiesta
<a name="API_DeleteTable_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_DeleteTable_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_DeleteTable_RequestSyntax) **   <a name="timestream-DeleteTable-request-DatabaseName"></a>
Il nome del database in cui deve essere eliminato il database Timestream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

 ** [TableName](#API_DeleteTable_RequestSyntax) **   <a name="timestream-DeleteTable-request-TableName"></a>
Il nome della tabella Timestream da eliminare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** 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

 ** 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_DeleteTable_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/DeleteTable) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteTable) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteTable) 

# DescribeBatchLoadTask
<a name="API_DescribeBatchLoadTask"></a>

Restituisce informazioni sull'attività di caricamento in batch, tra cui configurazioni, mappature, avanzamento e altri dettagli. [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.describe-batch-load.html) per i dettagli.

## Sintassi della richiesta
<a name="API_DescribeBatchLoadTask_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_DescribeBatchLoadTask_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.

 ** [TaskId](#API_DescribeBatchLoadTask_RequestSyntax) **   <a name="timestream-DescribeBatchLoadTask-request-TaskId"></a>
L'ID dell'operazione di caricamento in batch.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 32 caratteri.  
Modello: `[A-Z0-9]+`   
Obbligatorio: sì

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

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

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

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

 ** [BatchLoadTaskDescription](#API_DescribeBatchLoadTask_ResponseSyntax) **   <a name="timestream-DescribeBatchLoadTask-response-BatchLoadTaskDescription"></a>
Descrizione dell'operazione di caricamento in batch.  
Tipo: oggetto [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md)

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** 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

 ** 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

## Vedi anche
<a name="API_DescribeBatchLoadTask_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/DescribeBatchLoadTask) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeBatchLoadTask) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeBatchLoadTask) 

# DescribeDatabase
<a name="API_DescribeDatabase"></a>

Restituisce informazioni sul database, incluso il nome del database, l'ora di creazione del database e il numero totale di tabelle trovate all'interno del database. [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.describe-db.html) per i dettagli.

## Sintassi della richiesta
<a name="API_DescribeDatabase_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_DescribeDatabase_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_DescribeDatabase_RequestSyntax) **   <a name="timestream-DescribeDatabase-request-DatabaseName"></a>
Nome del database Timestream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_DescribeDatabase_ResponseSyntax"></a>

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

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

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

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

 ** [Database](#API_DescribeDatabase_ResponseSyntax) **   <a name="timestream-DescribeDatabase-response-Database"></a>
Nome della tabella Timestream.  
Tipo: oggetto [Database](API_Database.md)

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** 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

 ** 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_DescribeDatabase_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/DescribeDatabase) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeDatabase) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeDatabase) 

# DescribeEndpoints
<a name="API_DescribeEndpoints"></a>

Restituisce un elenco di endpoint disponibili su cui effettuare chiamate API Timestream. Questa operazione API è disponibile sia tramite Write che Query. APIs

Poiché i Timestream SDKs sono progettati per funzionare in modo trasparente con l'architettura del servizio, inclusa la gestione e la mappatura degli endpoint del servizio, *non è consigliabile utilizzare questa operazione API a meno che*:
+ Stai utilizzando [endpoint VPC ()AWS PrivateLink](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) con Timestream 
+ L'applicazione utilizza un linguaggio di programmazione che non supporta ancora l'SDK
+ È necessario un controllo migliore sull'implementazione lato client

Per informazioni dettagliate su come e quando utilizzare e implementare DescribeEndpoints, consulta [The Endpoint](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery) Discovery Pattern.

## Sintassi della risposta
<a name="API_DescribeEndpoints_ResponseSyntax"></a>

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

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

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

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

 ** [Endpoints](#API_DescribeEndpoints_ResponseSyntax) **   <a name="timestream-DescribeEndpoints-response-Endpoints"></a>
Un `Endpoints` oggetto viene restituito quando viene effettuata una `DescribeEndpoints` richiesta.  
Tipo: matrice di oggetti [Endpoint](API_Endpoint.md)

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

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

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

 ** 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_DescribeEndpoints_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/DescribeEndpoints) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeEndpoints) 

# DescribeTable
<a name="API_DescribeTable"></a>

Restituisce informazioni sulla tabella, inclusi il nome della tabella, il nome del database, la durata di conservazione dell'archivio di memoria e dell'archivio magnetico. [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.describe-table.html) per i dettagli. 

## Sintassi della richiesta
<a name="API_DescribeTable_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_DescribeTable_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_DescribeTable_RequestSyntax) **   <a name="timestream-DescribeTable-request-DatabaseName"></a>
Nome del database Timestream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

 ** [TableName](#API_DescribeTable_RequestSyntax) **   <a name="timestream-DescribeTable-request-TableName"></a>
Nome della tabella Timestream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

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

## Elementi di risposta
<a name="API_DescribeTable_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_DescribeTable_ResponseSyntax) **   <a name="timestream-DescribeTable-response-Table"></a>
La tabella Timestream.  
Tipo: oggetto [Table](API_Table.md)

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** 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

 ** 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_DescribeTable_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/DescribeTable) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeTable) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeTable) 

# ListBatchLoadTasks
<a name="API_ListBatchLoadTasks"></a>

Fornisce un elenco delle attività di caricamento in batch, insieme al nome, allo stato, alla data di ripresa dell'attività e ad altri dettagli. Consulta l'[esempio di codice](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-batch-load-tasks.html) per i dettagli.

## Sintassi della richiesta
<a name="API_ListBatchLoadTasks_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_ListBatchLoadTasks_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.

 ** [MaxResults](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-MaxResults"></a>
Il numero totale di elementi da restituire nell'output. Se il numero totale di elementi disponibili è superiore al valore specificato, nell'output NextToken viene fornito un. Per riprendere l'impaginazione, fornite il NextToken valore come argomento di una successiva chiamata all'API.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [NextToken](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-NextToken"></a>
Token per specificare dove iniziare l'impaginazione. Questo è il risultato di una risposta precedentemente NextToken troncata.  
▬Tipo: stringa  
Obbligatorio: no

 ** [TaskStatus](#API_ListBatchLoadTasks_RequestSyntax) **   <a name="timestream-ListBatchLoadTasks-request-TaskStatus"></a>
Stato dell'operazione di caricamento in batch.  
Tipo: String  
Valori validi: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME`   
Campo obbligatorio: no

## Sintassi della risposta
<a name="API_ListBatchLoadTasks_ResponseSyntax"></a>

```
{
   "BatchLoadTasks": [ 
      { 
         "CreationTime": number,
         "DatabaseName": "string",
         "LastUpdatedTime": number,
         "ResumableUntil": number,
         "TableName": "string",
         "TaskId": "string",
         "TaskStatus": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

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

 ** [BatchLoadTasks](#API_ListBatchLoadTasks_ResponseSyntax) **   <a name="timestream-ListBatchLoadTasks-response-BatchLoadTasks"></a>
Un elenco di dettagli dell'attività di caricamento in batch.  
Tipo: matrice di oggetti [BatchLoadTask](API_BatchLoadTask.md)

 ** [NextToken](#API_ListBatchLoadTasks_ResponseSyntax) **   <a name="timestream-ListBatchLoadTasks-response-NextToken"></a>
Token per specificare dove iniziare l'impaginazione. Fornisci il successivo ListBatchLoadTasksRequest.  
Tipo: String

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** 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_ListBatchLoadTasks_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/ListBatchLoadTasks) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListBatchLoadTasks) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListBatchLoadTasks) 

# ListDatabases
<a name="API_ListDatabases"></a>

Restituisce un elenco dei tuoi database Timestream. [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.list-db.html) per i dettagli. 

## Sintassi della richiesta
<a name="API_ListDatabases_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_ListDatabases_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.

 ** [MaxResults](#API_ListDatabases_RequestSyntax) **   <a name="timestream-ListDatabases-request-MaxResults"></a>
Il numero totale di elementi da restituire nell'output. Se il numero totale di articoli disponibili è superiore al valore specificato, nell'output NextToken viene fornito a. Per riprendere l'impaginazione, fornite il NextToken valore come argomento di una successiva chiamata all'API.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo di 20.  
Obbligatorio: no

 ** [NextToken](#API_ListDatabases_RequestSyntax) **   <a name="timestream-ListDatabases-request-NextToken"></a>
Il token di impaginazione. Per riprendere l'impaginazione, fornite il NextToken valore come argomento di una successiva chiamata all'API.  
▬Tipo: stringa  
Obbligatorio: no

## Sintassi della risposta
<a name="API_ListDatabases_ResponseSyntax"></a>

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

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

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

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

 ** [Databases](#API_ListDatabases_ResponseSyntax) **   <a name="timestream-ListDatabases-response-Databases"></a>
Un elenco di nomi di database.  
Tipo: matrice di oggetti [Database](API_Database.md)

 ** [NextToken](#API_ListDatabases_ResponseSyntax) **   <a name="timestream-ListDatabases-response-NextToken"></a>
Il token di impaginazione. Questo parametro viene restituito quando la risposta viene troncata.  
Tipo: String

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** 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_ListDatabases_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/ListDatabases) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListDatabases) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListDatabases) 

# ListTables
<a name="API_ListTables"></a>

Fornisce un elenco di tabelle, insieme al nome, allo stato e alle proprietà di conservazione di ciascuna tabella. Consulta l'[esempio di codice](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html) per i dettagli. 

## Sintassi della richiesta
<a name="API_ListTables_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_ListTables_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_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-DatabaseName"></a>
Nome del database Timestream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: no

 ** [MaxResults](#API_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-MaxResults"></a>
Il numero totale di elementi da restituire nell'output. Se il numero totale di elementi disponibili è superiore al valore specificato, nell'output NextToken viene fornito un. Per riprendere l'impaginazione, fornite il NextToken valore come argomento di una successiva chiamata all'API.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo di 20.  
Obbligatorio: no

 ** [NextToken](#API_ListTables_RequestSyntax) **   <a name="timestream-ListTables-request-NextToken"></a>
Il token di impaginazione. Per riprendere l'impaginazione, fornite il NextToken valore come argomento di una successiva chiamata all'API.  
▬Tipo: stringa  
Obbligatorio: no

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

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

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

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

 ** [NextToken](#API_ListTables_ResponseSyntax) **   <a name="timestream-ListTables-response-NextToken"></a>
Token per specificare dove iniziare l'impaginazione. Questo è il risultato di una risposta precedentemente NextToken troncata.  
Tipo: String

 ** [Tables](#API_ListTables_ResponseSyntax) **   <a name="timestream-ListTables-response-Tables"></a>
Un elenco di tabelle.  
Tipo: matrice di oggetti [Table](API_Table.md)

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** ResourceNotFoundException **   
L'operazione ha cercato 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

 ** 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_ListTables_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/ListTables) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTables) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTables) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

 Elenca tutti i tag su una risorsa Timestream. 

## Sintassi della richiesta
<a name="API_ListTagsForResource_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_ListTagsForResource_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.

 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) **   <a name="timestream-ListTagsForResource-request-ResourceARN"></a>
 La risorsa Timestream con i tag da elencare. Questo valore è un Amazon Resource Name (ARN).   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011.  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_ListTagsForResource_ResponseSyntax"></a>

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

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

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

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

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="timestream-ListTagsForResource-response-Tags"></a>
 I tag attualmente associati alla risorsa Timestream.   
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

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

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

 ** 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

 ** 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 con formato errato.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListTagsForResource_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/ListTagsForResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTagsForResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTagsForResource) 

# ResumeBatchLoadTask
<a name="API_ResumeBatchLoadTask"></a>

 

## Sintassi della richiesta
<a name="API_ResumeBatchLoadTask_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_ResumeBatchLoadTask_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.

 ** [TaskId](#API_ResumeBatchLoadTask_RequestSyntax) **   <a name="timestream-ResumeBatchLoadTask-request-TaskId"></a>
L'ID dell'operazione di caricamento batch da riprendere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 32 caratteri.  
Modello: `[A-Z0-9]+`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** 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

 ** 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_ResumeBatchLoadTask_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/ResumeBatchLoadTask) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ResumeBatchLoadTask) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ResumeBatchLoadTask) 

# TagResource
<a name="API_TagResource"></a>

 Associa un set di tag a una risorsa Timestream. È quindi possibile attivare questi tag definiti dall'utente in modo che vengano visualizzati nella console di Billing and Cost Management per il monitoraggio dell'allocazione dei costi. 

## Sintassi della richiesta
<a name="API_TagResource_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_TagResource_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.

 ** [ResourceARN](#API_TagResource_RequestSyntax) **   <a name="timestream-TagResource-request-ResourceARN"></a>
 Identifica la risorsa Timestream a cui aggiungere i tag. Questo valore è un Amazon Resource Name (ARN).   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011.  
Obbligatorio: sì

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="timestream-TagResource-request-Tags"></a>
 I tag da assegnare alla risorsa Timestream.   
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

 ** 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_TagResource_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/TagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/TagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

 Rimuove l'associazione di tag da una risorsa Timestream. 

## Sintassi della richiesta
<a name="API_UntagResource_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_UntagResource_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.

 ** [ResourceARN](#API_UntagResource_RequestSyntax) **   <a name="timestream-UntagResource-request-ResourceARN"></a>
 La risorsa Timestream da cui verranno rimossi i tag. Questo valore è un Amazon Resource Name (ARN).   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011.  
Obbligatorio: sì

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="timestream-UntagResource-request-TagKeys"></a>
 Un elenco di tag e chiavi. I tag esistenti della risorsa le cui chiavi sono membri di questo elenco verranno rimossi dalla risorsa Timestream.   
Tipo: array di stringhe  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

 ** 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_UntagResource_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/UntagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UntagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UntagResource) 

# UpdateDatabase
<a name="API_UpdateDatabase"></a>

 Modifica la AWS KMS chiave per un database esistente. Durante l'aggiornamento del database, è necessario specificare il nome del database e l'identificatore della nuova AWS KMS chiave da utilizzare ()`KmsKeyId`. Se ci sono `UpdateDatabase` richieste simultanee, vince il primo scrittore. 

Consulta l'[esempio di codice](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html) per i dettagli.

## Sintassi della richiesta
<a name="API_UpdateDatabase_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_UpdateDatabase_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_UpdateDatabase_RequestSyntax) **   <a name="timestream-UpdateDatabase-request-DatabaseName"></a>
 Nome del database.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

 ** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) **   <a name="timestream-UpdateDatabase-request-KmsKeyId"></a>
 L'identificatore della nuova AWS KMS chiave (`KmsKeyId`) da utilizzare per crittografare i dati memorizzati nel database. Se il `KmsKeyId` valore attualmente registrato nel database è lo stesso indicato `KmsKeyId` nella richiesta, non ci sarà alcun aggiornamento.   
È possibile specificare l'`KmsKeyId`utilizzo di uno dei seguenti:  
+ ID chiave: `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ ARN chiave: `arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Nome alias: `alias/ExampleAlias` 
+ ARN alias: `arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias` 
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_UpdateDatabase_ResponseSyntax"></a>

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

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

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

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

 ** [Database](#API_UpdateDatabase_ResponseSyntax) **   <a name="timestream-UpdateDatabase-response-Database"></a>
Un contenitore di primo livello per una tabella. I database e le tabelle sono i concetti di gestione fondamentali in Amazon Timestream. Tutte le tabelle di un database sono crittografate con la stessa AWS KMS chiave.  
Tipo: oggetto [Database](API_Database.md)

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** ResourceNotFoundException **   
L'operazione ha cercato 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_UpdateDatabase_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/UpdateDatabase) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateDatabase) 

# UpdateTable
<a name="API_UpdateTable"></a>

Modifica la durata di conservazione dell'archivio di memoria e dell'archivio magnetico per la tabella Timestream. Si noti che la modifica della durata di conservazione ha effetto immediato. Ad esempio, se il periodo di conservazione dell'archivio di memoria è stato inizialmente impostato su 2 ore e poi modificato su 24 ore, l'archivio di memoria sarà in grado di contenere 24 ore di dati, ma verrà popolato con 24 ore di dati 22 ore dopo la modifica. Timestream non recupera i dati dall'archivio magnetico per popolare l'archivio di memoria. 

Consulta l'[esempio di codice](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html) per i dettagli.

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

## Parametri della richiesta
<a name="API_UpdateTable_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_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-DatabaseName"></a>
Nome del database Timestream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

 ** [MagneticStoreWriteProperties](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-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_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-RetentionProperties"></a>
La durata di conservazione dell'archivio di memoria e dell'archivio magnetico.  
Tipo: oggetto [RetentionProperties](API_RetentionProperties.md)  
Obbligatorio: no

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

 ** [TableName](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-TableName"></a>
Nome della tabella Timestream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

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

## Elementi di risposta
<a name="API_UpdateTable_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_UpdateTable_ResponseSyntax) **   <a name="timestream-UpdateTable-response-Table"></a>
La tabella Timestream aggiornata.  
Tipo: oggetto [Table](API_Table.md)

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** ResourceNotFoundException **   
L'operazione ha cercato 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

 ** 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_UpdateTable_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/UpdateTable) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateTable) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateTable) 

# WriteRecords
<a name="API_WriteRecords"></a>

Consente di scrivere i dati delle serie temporali in Timestream. È possibile specificare un singolo punto dati o un batch di punti dati da inserire nel sistema. Timestream ti offre uno schema flessibile che rileva automaticamente i nomi delle colonne e i tipi di dati per le tue tabelle Timestream in base ai nomi delle dimensioni e ai tipi di dati dei punti dati specificati quando richiami le scritture nel database. 

Timestream supporta la semantica di lettura con eventuale coerenza. Ciò significa che quando si interrogano i dati immediatamente dopo aver scritto un batch di dati in Timestream, i risultati della query potrebbero non riflettere i risultati di un'operazione di scrittura completata di recente. I risultati possono includere anche alcuni dati obsoleti. Se si ripete la richiesta di interrogazione dopo un breve periodo, i risultati dovrebbero restituire i dati più recenti. [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.write.html) per i dettagli.

 **Sconvolge** 

È possibile utilizzare il `Version` parametro in una `WriteRecords` richiesta di aggiornamento dei punti dati. Timestream tiene traccia di un numero di versione per ogni record. `Version`il valore predefinito è `1` quando non è specificato per il record nella richiesta. Timestream aggiorna il valore di misura di un record esistente insieme al suo `Version` quando riceve una richiesta di scrittura con un `Version` numero più alto per quel record. Quando riceve una richiesta di aggiornamento in cui il valore di misura è uguale a quello del record esistente, Timestream si aggiorna comunque`Version`, se è maggiore del valore esistente di. `Version` È possibile aggiornare un punto dati tutte le volte che si desidera, purché il valore di aumenti `Version` continuamente. 

 Ad esempio, supponete di scrivere un nuovo record senza indicarlo `Version` nella richiesta. Timestream memorizza questo record e lo imposta su. `Version` `1` Supponiamo ora di provare ad aggiornare questo record con una `WriteRecords` richiesta dello stesso record con un valore di misura diverso ma, come in precedenza, di non fornire. `Version` In questo caso, Timestream rifiuterà questo aggiornamento con un `RejectedRecordsException` poiché la versione del record aggiornato non è maggiore del valore esistente di Version. 

Tuttavia, se dovessi inviare nuovamente la richiesta di aggiornamento con `Version` set to`2`, Timestream riuscirà ad aggiornare il valore del record e verrebbe impostato su. `Version` `2` Supponiamo quindi di aver inviato una `WriteRecords` richiesta con lo stesso record e un valore di misura identico, ma impostata su. `Version` `3` In questo caso, Timestream si aggiornerebbe solo a. `Version` `3` Eventuali ulteriori aggiornamenti dovrebbero inviare un numero di versione maggiore di`3`, oppure le richieste di aggiornamento riceverebbero un. `RejectedRecordsException` 

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

## Parametri della richiesta
<a name="API_WriteRecords_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.

 ** [CommonAttributes](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-CommonAttributes"></a>
Un record che contiene gli attributi comuni di misura, dimensione, ora e versione condivisi tra tutti i record della richiesta. Gli attributi di misura e dimensione specificati verranno uniti agli attributi di misura e dimensione nell'oggetto records quando i dati vengono scritti in Timestream. Le dimensioni non possono sovrapporsi o verrà generato un`ValidationException`. In altre parole, un record deve contenere dimensioni con nomi univoci.   
Tipo: oggetto [Record](API_Record.md)  
Obbligatorio: no

 ** [DatabaseName](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-DatabaseName"></a>
Nome del database Timestream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

 ** [Records](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-Records"></a>
Una matrice di record che contiene gli attributi univoci di misura, dimensione, ora e versione per ogni punto dati della serie temporale.  
Tipo: matrice di oggetti [Record](API_Record.md)  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 100 elementi.  
Obbligatorio: sì

 ** [TableName](#API_WriteRecords_RequestSyntax) **   <a name="timestream-WriteRecords-request-TableName"></a>
Nome della tabella Timestream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_WriteRecords_ResponseSyntax"></a>

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

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

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

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

 ** [RecordsIngested](#API_WriteRecords_ResponseSyntax) **   <a name="timestream-WriteRecords-response-RecordsIngested"></a>
Informazioni sui record acquisiti da questa richiesta.  
Tipo: oggetto [RecordsIngested](API_RecordsIngested.md)

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

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

 ** AccessDeniedException **   
Non sei autorizzato a eseguire questa azione.  
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

 ** RejectedRecordsException **   
 WriteRecords genererebbe questa eccezione nei seguenti casi:   
+ Record con dati duplicati in cui sono presenti più record con le stesse dimensioni, timestamp e nomi di misure ma: 
  + I valori di misura sono diversi
  + La versione non è presente nella richiesta *oppure* il valore della versione nel nuovo record è uguale o inferiore al valore esistente

   In questo caso, se Timestream rifiuta i dati, il `ExistingVersion` campo nella `RejectedRecords` risposta indicherà la versione del record corrente. Per forzare un aggiornamento, puoi inviare nuovamente la richiesta con una versione del record impostata su un valore maggiore di. `ExistingVersion`
+  Record con timestamp che non rientrano nella durata di conservazione dell'archivio di memoria. 
+  Record con dimensioni o misure che superano i limiti definiti dal Timestream. 
 Per ulteriori informazioni, consulta [Quotas](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) nella Amazon Timestream Developer Guide.     
 ** RejectedRecords **   
 
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
L'operazione ha cercato 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

 ** 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_WriteRecords_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/WriteRecords) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/WriteRecords) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/WriteRecords) 

# Interrogazione su Amazon Timestream
<a name="API_Operations_Amazon_Timestream_Query"></a>

Le seguenti azioni sono supportate da Amazon Timestream Query:
+  [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>

 Annulla una richiesta che è stata emessa. L'annullamento viene fornito solo se l'esecuzione della richiesta non è stata completata prima dell'emissione della richiesta di cancellazione. Poiché l'annullamento è un'operazione idempotente, le richieste di annullamento successive restituiranno a`CancellationMessage`, a indicare che la query è già stata annullata. Consulta l'[esempio di codice](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.cancel-query.html) per i dettagli. 

## Sintassi della richiesta
<a name="API_query_CancelQuery_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_query_CancelQuery_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.

 ** [QueryId](#API_query_CancelQuery_RequestSyntax) **   <a name="timestream-query_CancelQuery-request-QueryId"></a>
 L'ID della query che deve essere annullata. `QueryID`viene restituito come parte del risultato della query.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[a-zA-Z0-9]+`   
Obbligatorio: sì

## Sintassi della risposta
<a name="API_query_CancelQuery_ResponseSyntax"></a>

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

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

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

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

 ** [CancellationMessage](#API_query_CancelQuery_ResponseSyntax) **   <a name="timestream-query_CancelQuery-response-CancellationMessage"></a>
 A `CancellationMessage` viene restituito quando è già `QueryId` stata emessa una `CancelQuery` richiesta per la query specificata da.   
Tipo: String

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

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

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

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

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_CancelQuery_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-query-2018-11-01/CancelQuery) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CancelQuery) 

# CreateScheduledQuery
<a name="API_query_CreateScheduledQuery"></a>

 Creare una query pianificata che verrà eseguita per conto dell'utente in base alla pianificazione configurata. Per l'esecuzione della query, a Timestream viene assegnato il ruolo di esecutore nell'ambito del parametro `ScheduledQueryExecutionRoleArn`. È possibile utilizzare il parametro `NotificationConfiguration` per configurare l'invio di una notifica per le operazioni di query pianificate.

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

## Parametri della richiesta
<a name="API_query_CreateScheduledQuery_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.

 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ClientToken"></a>
L'uso di a ClientToken rende la chiamata CreateScheduledQuery idempotente, in altre parole, ripetere la stessa richiesta produrrà lo stesso risultato. Effettuare più CreateScheduledQuery richieste identiche ha lo stesso effetto di fare una singola richiesta.   
+  Se CreateScheduledQuery viene chiamato senza un`ClientToken`, Query SDK genera un `ClientToken` messaggio per conto dell'utente.
+  Dopo 8 ore, qualsiasi richiesta con lo stesso `ClientToken` viene considerata e gestita come una nuova richiesta. 
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 32. La lunghezza massima è 128 caratteri.  
Obbligatorio: no

 ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ErrorReportConfiguration"></a>
Configurazione della segnalazione di errori. I report di errore vengono generati quando si verifica un problema durante la scrittura dei risultati della query.   
Tipo: oggetto [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Obbligatorio: sì

 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-KmsKeyId"></a>
La chiave Amazon KMS utilizzata per crittografare la risorsa di query pianificata, quando i dati sono inattivi. Se la chiave Amazon KMS non viene specificata, la risorsa di query pianificata verrà crittografata con una chiave Amazon KMS di proprietà di Timestream. Per specificare una chiave KMS, utilizzare l'ID o l'ARN della chiave oppure il nome o l'ARN dell'alias. Quando si utilizza un nome alias, aggiungere al nome il prefisso *alias/*   
Se viene ErrorReportConfiguration utilizzato `SSE_KMS` come tipo di crittografia, lo stesso KmsKeyId viene utilizzato per crittografare la segnalazione degli errori a riposo.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: no

 ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Name"></a>
Nome della query pianificata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obbligatorio: sì

 ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-NotificationConfiguration"></a>
Configurazione della notifica per la query pianificata. Quando l'esecuzione di una query pianificata termina oppure lo stato della query viene aggiornato oppure la query viene eliminata, Timestream invia una notifica.   
Tipo: oggetto [NotificationConfiguration](API_query_NotificationConfiguration.md)  
Obbligatorio: sì

 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-QueryString"></a>
La stringa query da eseguire. I nomi dei parametri possono essere specificati nella stringa query dal carattere `@` seguito da un identificatore. Il parametro denominato `@scheduled_runtime` è riservato e può essere utilizzato nella query per ottenere l'ora in cui è pianificata l'esecuzione della query.  
Il timestamp calcolato in base al ScheduleConfiguration parametro sarà il valore del `@scheduled_runtime` parametro per ogni esecuzione di query. Ad esempio, si può considerare un'istanza di una query pianificata in esecuzione alla data/ora 2021-12-01 00:00:00. In questa istanza, il parametro `@scheduled_runtime` viene inizializzato in corrispondenza del timestamp 2021-12-01 00:00:00 quando si richiama la query.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 262144.  
Obbligatorio: sì

 ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduleConfiguration"></a>
La configurazione della pianificazione per la query.  
Tipo: oggetto [ScheduleConfiguration](API_query_ScheduleConfiguration.md)  
Obbligatorio: sì

 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduledQueryExecutionRoleArn"></a>
L'ARN del ruolo IAM che Timestream assumerà durante l'esecuzione della query pianificata.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: sì

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

 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-TargetConfiguration"></a>
Configurazione utilizzata per scrivere il risultato di una query.  
Tipo: oggetto [TargetConfiguration](API_query_TargetConfiguration.md)  
Obbligatorio: no

## Sintassi della risposta
<a name="API_query_CreateScheduledQuery_ResponseSyntax"></a>

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

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

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

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

 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) **   <a name="timestream-query_CreateScheduledQuery-response-Arn"></a>
ARN per la query pianificata creata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.

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

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

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Impossibile visualizzare i risultati di un sondaggio per una query annullata.   
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

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

 ** ServiceQuotaExceededException **   
Hai superato la quota di servizio.  
Codice di stato HTTP: 400

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_CreateScheduledQuery_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-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery) 

# DeleteScheduledQuery
<a name="API_query_DeleteScheduledQuery"></a>

Elimina una determinata query pianificata. Si tratta di un'operazione irreversibile. 

## Sintassi della richiesta
<a name="API_query_DeleteScheduledQuery_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_query_DeleteScheduledQuery_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.

 ** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) **   <a name="timestream-query_DeleteScheduledQuery-request-ScheduledQueryArn"></a>
L'ARN della query pianificata.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

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

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa richiesta.    
 ** ScheduledQueryArn **   
L'ARN della query pianificata.
Codice di stato HTTP: 400

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_DeleteScheduledQuery_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-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DeleteScheduledQuery) 

# DescribeAccountSettings
<a name="API_query_DescribeAccountSettings"></a>

Descrive le impostazioni dell'account che includono il modello di determinazione dei prezzi delle query e il numero massimo configurato che TCUs il servizio può utilizzare per il carico di lavoro delle query.

Ti viene addebitata solo la durata delle unità di calcolo utilizzate per i tuoi carichi di lavoro.

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

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

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

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

 ** [MaxQueryTCU](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-MaxQueryTCU"></a>
Il numero massimo di [unità di calcolo Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/tcu.html) (TCUs) che il servizio utilizzerà in qualsiasi momento per rispondere alle tue domande. Per eseguire le query, è necessario impostare una capacità minima di 4 TCU. È possibile impostare il numero massimo di TCU in multipli di 4, ad esempio 4, 8, 16, 32 e così via. Questa configurazione è applicabile solo per l'utilizzo su richiesta di (). TCUs   
Tipo: numero intero

 ** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryCompute"></a>
Un oggetto che contiene le impostazioni di utilizzo per Timestream Compute Units (TCUs) nel tuo account per il carico di lavoro delle query. QueryCompute è disponibile solo nella regione Asia Pacifico (Mumbai).  
Tipo: oggetto [QueryComputeResponse](API_query_QueryComputeResponse.md)

 ** [QueryPricingModel](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryPricingModel"></a>
Il modello di prezzo per le domande nel tuo account.  
Il `QueryPricingModel` parametro viene utilizzato da diverse operazioni Timestream; tuttavia, l'operazione `UpdateAccountSettings` API non riconosce alcun valore diverso da. `COMPUTE_UNITS`
Tipo: String  
Valori validi: `BYTES_SCANNED | COMPUTE_UNITS` 

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

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

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

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

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_query_DescribeAccountSettings_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-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeAccountSettings) 

# DescribeEndpoints
<a name="API_query_DescribeEndpoints"></a>

DescribeEndpoints restituisce un elenco di endpoint disponibili su cui effettuare chiamate API Timestream. Questa API è disponibile sia tramite Write che Query.

Poiché i Timestream SDKs sono progettati per funzionare in modo trasparente con l'architettura del servizio, inclusa la gestione e la mappatura degli endpoint del servizio, *non è consigliabile utilizzare questa API a meno che*:
+ Stai utilizzando [endpoint VPC ()AWS PrivateLink](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) con Timestream 
+ L'applicazione utilizza un linguaggio di programmazione che non supporta ancora l'SDK
+ È necessario un controllo migliore sull'implementazione lato client

Per informazioni dettagliate su come e quando utilizzare e implementare DescribeEndpoints, consulta [The Endpoint](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery) Discovery Pattern.

## Sintassi della risposta
<a name="API_query_DescribeEndpoints_ResponseSyntax"></a>

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

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

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

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

 ** [Endpoints](#API_query_DescribeEndpoints_ResponseSyntax) **   <a name="timestream-query_DescribeEndpoints-response-Endpoints"></a>
Un `Endpoints` oggetto viene restituito quando viene effettuata una `DescribeEndpoints` richiesta.  
Tipo: matrice di oggetti [Endpoint](API_query_Endpoint.md)

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

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

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_DescribeEndpoints_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-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeEndpoints) 

# DescribeScheduledQuery
<a name="API_query_DescribeScheduledQuery"></a>

Fornisce informazioni dettagliate su un'interrogazione pianificata.

## Sintassi della richiesta
<a name="API_query_DescribeScheduledQuery_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_query_DescribeScheduledQuery_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.

 ** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) **   <a name="timestream-query_DescribeScheduledQuery-request-ScheduledQueryArn"></a>
L'ARN della query pianificata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: sì

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

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

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

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

 ** [ScheduledQuery](#API_query_DescribeScheduledQuery_ResponseSyntax) **   <a name="timestream-query_DescribeScheduledQuery-response-ScheduledQuery"></a>
L'interrogazione pianificata.  
Tipo: oggetto [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md)

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

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

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

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

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa richiesta.    
 ** ScheduledQueryArn **   
L'ARN della query pianificata.
Codice di stato HTTP: 400

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_DescribeScheduledQuery_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-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeScheduledQuery) 

# ExecuteScheduledQuery
<a name="API_query_ExecuteScheduledQuery"></a>

 Puoi utilizzare questa API per eseguire manualmente una query pianificata. 

Se abilitata`QueryInsights`, questa API restituisce anche informazioni e metriche relative alla query che hai eseguito come parte di una notifica Amazon SNS. `QueryInsights`aiuta a ottimizzare le prestazioni della tua query. Per ulteriori informazioni su`QueryInsights`, consulta [Usare le informazioni sulle query per ottimizzare le query in Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).

## Sintassi della richiesta
<a name="API_query_ExecuteScheduledQuery_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_query_ExecuteScheduledQuery_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.

 ** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ClientToken"></a>
Non utilizzato.   
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 32. La lunghezza massima è 128 caratteri.  
Obbligatorio: no

 ** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-InvocationTime"></a>
Il timestamp in UTC. La query verrà eseguita come se fosse stata richiamata in questo timestamp.   
Tipo: Timestamp  
Obbligatorio: sì

 ** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-QueryInsights"></a>
Incapsula le impostazioni per l'attivazione. `QueryInsights`  
Attivazione di approfondimenti e metriche sui `QueryInsights` resi come parte della notifica Amazon SNS per la query che hai eseguito. Puoi utilizzarla `QueryInsights` per ottimizzare le prestazioni e i costi delle query.  
Tipo: oggetto [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md)  
Obbligatorio: no

 ** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ScheduledQueryArn"></a>
ARN della query pianificata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

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

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa richiesta.    
 ** ScheduledQueryArn **   
L'ARN della query pianificata.
Codice di stato HTTP: 400

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

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

### Messaggio di notifica di interrogazione pianificata per la modalità ENABLED\$1WITH\$1RATE\$1CONTROL
<a name="API_query_ExecuteScheduledQuery_Example_1"></a>

L'esempio seguente mostra un messaggio di notifica di interrogazione pianificata riuscita per la modalità del parametro. `ENABLED_WITH_RATE_CONTROL` `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
        }
    }
}
```

### Messaggio di notifica delle interrogazioni pianificate per la modalità DISABLED
<a name="API_query_ExecuteScheduledQuery_Example_2"></a>

L'esempio seguente mostra un messaggio di notifica di interrogazione pianificata riuscita per la `DISABLED` modalità del `QueryInsights` parametro.

```
"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
        }
    }
}
```

### Messaggio di notifica di errore per la modalità ENABLED\$1WITH\$1RATE\$1CONTROL
<a name="API_query_ExecuteScheduledQuery_Example_3"></a>

L'esempio seguente mostra un messaggio di notifica di interrogazione pianificata non riuscita per la modalità del parametro. `ENABLED_WITH_RATE_CONTROL` `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"
    }
}
```

### Messaggio di notifica di errore per la modalità DISABLED
<a name="API_query_ExecuteScheduledQuery_Example_4"></a>

L'esempio seguente mostra un messaggio di notifica di interrogazione pianificata non riuscita per la `DISABLED` modalità del `QueryInsights` parametro.

```
"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"
    }
}
```

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

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

# ListScheduledQueries
<a name="API_query_ListScheduledQueries"></a>

Ottiene un elenco di tutte le domande pianificate nell'account Amazon e nella regione del chiamante. `ListScheduledQueries`alla fine è coerente. 

## Sintassi della richiesta
<a name="API_query_ListScheduledQueries_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_query_ListScheduledQueries_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.

 ** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-MaxResults"></a>
Il numero massimo di elementi da restituire nell'output. Se il numero totale di articoli disponibili è superiore al valore specificato, nell'output `NextToken` viene fornito un. Per riprendere l'impaginazione, fornite il `NextToken` valore come argomento per la successiva chiamata a. `ListScheduledQueriesRequest`  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.  
Obbligatorio: no

 ** [NextToken](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-NextToken"></a>
 Un token di impaginazione per riprendere l'impaginazione.  
▬Tipo: stringa  
Obbligatorio: no

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

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

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

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

 ** [NextToken](#API_query_ListScheduledQueries_ResponseSyntax) **   <a name="timestream-query_ListScheduledQueries-response-NextToken"></a>
Token per specificare dove iniziare l'impaginazione. Questo è il risultato di una NextToken risposta precedentemente troncata.  
Tipo: String

 ** [ScheduledQueries](#API_query_ListScheduledQueries_ResponseSyntax) **   <a name="timestream-query_ListScheduledQueries-response-ScheduledQueries"></a>
Un elenco di interrogazioni pianificate.  
Tipo: matrice di oggetti [ScheduledQuery](API_query_ScheduledQuery.md)

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

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

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

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

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_ListScheduledQueries_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-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListScheduledQueries) 

# ListTagsForResource
<a name="API_query_ListTagsForResource"></a>

Elenca tutti i tag su una risorsa di query Timestream.

## Sintassi della richiesta
<a name="API_query_ListTagsForResource_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_query_ListTagsForResource_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.

 ** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-MaxResults"></a>
Il numero massimo di tag da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 200.  
Obbligatorio: no

 ** [NextToken](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-NextToken"></a>
Un token di impaginazione per riprendere l'impaginazione.  
▬Tipo: stringa  
Obbligatorio: no

 ** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-ResourceARN"></a>
La risorsa Timestream con i tag da elencare. Questo valore è un Amazon Resource Name (ARN).  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_query_ListTagsForResource_ResponseSyntax"></a>

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

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

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

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

 ** [NextToken](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-NextToken"></a>
Un token di impaginazione per riprendere l'impaginazione con una chiamata successiva a. `ListTagsForResourceResponse`  
Tipo: String

 ** [Tags](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-Tags"></a>
I tag attualmente associati alla risorsa Timestream.   
Tipo: matrice di oggetti [Tag](API_query_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

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

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

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

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa richiesta.    
 ** ScheduledQueryArn **   
L'ARN della query pianificata.
Codice di stato HTTP: 400

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_ListTagsForResource_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-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListTagsForResource) 

# PrepareQuery
<a name="API_query_PrepareQuery"></a>

Un'operazione sincrona che consente di inviare una query con parametri da archiviare da Timestream per un'esecuzione successiva. Timestream supporta l'utilizzo di questa operazione solo con set to. `ValidateOnly` `true` 

## Sintassi della richiesta
<a name="API_query_PrepareQuery_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_query_PrepareQuery_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.

 ** [QueryString](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-QueryString"></a>
La stringa di query Timestream che desideri utilizzare come istruzione preparata. I nomi dei parametri possono essere specificati nella stringa query dal carattere `@` seguito da un identificatore.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 262144.  
Obbligatorio: sì

 ** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-ValidateOnly"></a>
Impostando questo valore su`true`, Timestream convaliderà solo che la stringa di query sia una query Timestream valida e non memorizzerà la query preparata per un uso successivo.  
Tipo: Booleano  
Obbligatorio: no

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

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

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

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

 ** [Columns](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Columns"></a>
Un elenco di colonne della clausola SELECT della stringa di query inviata.   
Tipo: matrice di oggetti [SelectColumn](API_query_SelectColumn.md)

 ** [Parameters](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Parameters"></a>
Un elenco di parametri utilizzati nella stringa di query inviata.   
Tipo: matrice di oggetti [ParameterMapping](API_query_ParameterMapping.md)

 ** [QueryString](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-QueryString"></a>
La stringa di query che si desidera preparare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 262144.

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

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

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

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

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_PrepareQuery_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-query-2018-11-01/PrepareQuery) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/PrepareQuery) 

# Query
<a name="API_query_Query"></a>

 `Query`è un'operazione sincrona che consente di eseguire una query sui dati di Amazon Timestream.

Se abilitata`QueryInsights`, questa API restituisce anche informazioni e metriche relative alla query che hai eseguito. `QueryInsights`aiuta a ottimizzare le prestazioni della query. Per ulteriori informazioni su`QueryInsights`, consulta [Using query insights per ottimizzare le query in Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).

**Nota**  
Il numero massimo di richieste `Query` API che puoi effettuare con `QueryInsights` enabled è 1 query al secondo (QPS). Se superi questa frequenza di query, potrebbe verificarsi una limitazione.

 `Query`scadrà dopo 60 secondi. È necessario aggiornare il timeout predefinito nell'SDK per supportare un timeout di 60 secondi. Per i dettagli, consulta l'[esempio di codice](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html). 

La richiesta di interrogazione avrà esito negativo nei seguenti casi:
+  Se invii una `Query` richiesta con lo stesso token client al di fuori della finestra di idempotenza di 5 minuti. 
+  Se invii una `Query` richiesta con lo stesso token client, ma modifichi altri parametri, entro la finestra di idempotenza di 5 minuti. 
+  Se la dimensione della riga (inclusi i metadati della query) supera 1 MB, la query avrà esito negativo e verrà visualizzato il seguente messaggio di errore: 

   `Query aborted as max page response size has been exceeded by the output result row` 
+  Se il principale IAM dell'iniziatore della query e il lettore dei risultati non coincidono, l'iniziatore and/or della query e il lettore dei risultati non hanno la stessa stringa di query nelle richieste di query, la query avrà esito negativo e restituirà un errore. `Invalid pagination token` 

## Sintassi della richiesta
<a name="API_query_Query_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_query_Query_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.

 ** [ClientToken](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-ClientToken"></a>
 Stringa unica, con distinzione tra maiuscole e minuscole, contenente un massimo di 64 caratteri ASCII, specificata quando viene effettuata una richiesta. `Query` *Fornire un `ClientToken` rende la chiamata idempotente. `Query`* Ciò significa che l'esecuzione ripetuta della stessa query produrrà lo stesso risultato. In altre parole, fare più `Query` richieste identiche ha lo stesso effetto di fare una singola richiesta. Quando si utilizza `ClientToken` in una query, tenete presente quanto segue:   
+  Se l'API Query viene istanziata senza un`ClientToken`, Query SDK genera un file per `ClientToken` conto dell'utente.
+ Se la `Query` chiamata contiene solo `ClientToken` ma non include a`NextToken`, si presume che tale invocazione di `Query` sia l'esecuzione di una nuova query.
+ Se la chiamata contiene`NextToken`, si presume che quella particolare invocazione sia una chiamata successiva di una precedente chiamata all'API Query e viene restituito un set di risultati.
+  Dopo 4 ore, qualsiasi richiesta con lo stesso valore `ClientToken` viene trattata come una nuova richiesta. 
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 32. La lunghezza massima è 128 caratteri.  
Obbligatorio: no

 ** [MaxRows](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-MaxRows"></a>
 Il numero totale di righe da restituire nell'`Query`output. L'esecuzione iniziale di `Query` con un `MaxRows` valore specificato restituirà il set di risultati della query in due casi:   
+ La dimensione del risultato è inferiore a`1MB`.
+ Il numero di righe nel set di risultati è inferiore al valore di`maxRows`.
Altrimenti, l'invocazione iniziale di restituisce `Query` solo a`NextToken`, che può quindi essere utilizzato nelle chiamate successive per recuperare il set di risultati. Per riprendere l'impaginazione, fornite il `NextToken` valore nel comando successivo.  
Se la dimensione della riga è grande (ad esempio una riga ha molte colonne), Timestream può restituire un numero inferiore di righe per evitare che la dimensione della risposta superi il limite di 1 MB. Se non `MaxRows` viene fornito, Timestream invierà il numero di righe necessario per soddisfare il limite di 1 MB.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.  
Obbligatorio: no

 ** [NextToken](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-NextToken"></a>
 Un token di impaginazione utilizzato per restituire una serie di risultati. Quando l'`Query`API viene richiamata utilizzando`NextToken`, si presume che quella particolare invocazione sia una chiamata successiva di una chiamata precedente a e viene restituito un set di `Query` risultati. Tuttavia, se la `Query` chiamata contiene solo il, si presume che tale invocazione sia una nuova esecuzione di `Query` una query. `ClientToken`   
Quando si utilizza NextToken in una query, tenere presente quanto segue:  
+ Un token di impaginazione può essere utilizzato per un massimo di cinque `Query` chiamate, OPPURE per una durata massima di 1 ora, a seconda dell'evento che si verifica per primo.
+ L'utilizzo dello stesso `NextToken` restituirà lo stesso set di record. Per continuare a sfogliare il set di risultati, è necessario utilizzare i più recenti. `nextToken`
+ Supponiamo che una `Query` chiamata restituisca due valori e. `NextToken` `TokenA` `TokenB` Se `TokenB` viene utilizzato in una `Query` chiamata successiva, viene invalidato e non può essere `TokenA` riutilizzato.
+ Per richiedere un set di risultati precedente da una query dopo l'inizio dell'impaginazione, è necessario richiamare nuovamente l'API Query.
+ L'ultima `NextToken` deve essere utilizzata per impaginare fino a quando non `null` viene restituita, a quel punto deve essere usata una nuova`NextToken`.
+  Se il principale IAM dell'iniziatore di query e il lettore dei risultati non sono gli stessi and/or , l'iniziatore di query e il lettore di risultati non hanno la stessa stringa di query nelle richieste di query, la query avrà esito negativo e verrà generato un errore. `Invalid pagination token` 
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: no

 ** [QueryInsights](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryInsights"></a>
Incapsula le impostazioni per l'abilitazione. `QueryInsights`  
L'attivazione `QueryInsights` restituisce approfondimenti e metriche oltre ai risultati delle query per la query eseguita. È possibile utilizzarlo `QueryInsights` per ottimizzare le prestazioni delle query.  
Tipo: oggetto [QueryInsights](API_query_QueryInsights.md)  
Obbligatorio: no

 ** [QueryString](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryString"></a>
 La query che deve essere eseguita da Timestream.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 262144.  
Obbligatorio: sì

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

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

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

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

 ** [ColumnInfo](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-ColumnInfo"></a>
 I tipi di dati delle colonne del set di risultati restituito.   
Tipo: matrice di oggetti [ColumnInfo](API_query_ColumnInfo.md)

 ** [NextToken](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-NextToken"></a>
 Un token di impaginazione che può essere riutilizzato durante una `Query` chiamata per ottenere il successivo set di risultati.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.

 ** [QueryId](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryId"></a>
 Un ID univoco per la query specificata.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[a-zA-Z0-9]+` 

 ** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryInsightsResponse"></a>
Incapsula `QueryInsights` contenente informazioni e metriche relative alla query che hai eseguito.  
Tipo: oggetto [QueryInsightsResponse](API_query_QueryInsightsResponse.md)

 ** [QueryStatus](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryStatus"></a>
Informazioni sullo stato della query, inclusi lo stato di avanzamento e i byte scansionati.  
Tipo: oggetto [QueryStatus](API_query_QueryStatus.md)

 ** [Rows](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-Rows"></a>
 Le righe del set di risultati restituite dalla query.   
Tipo: matrice di oggetti [Row](API_query_Row.md)

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

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

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Impossibile visualizzare i risultati di un sondaggio per una query annullata.   
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

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

 ** QueryExecutionException **   
 Timestream non è riuscito a eseguire la query con successo.   
Codice di stato HTTP: 400

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_Query_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-query-2018-11-01/Query) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/Query) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Query) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/Query) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Query) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/Query) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/Query) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/Query) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/Query) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Query) 

# TagResource
<a name="API_query_TagResource"></a>

Associa un set di tag a una risorsa Timestream. È quindi possibile attivare questi tag definiti dall'utente in modo che vengano visualizzati nella console di Billing and Cost Management per il monitoraggio dell'allocazione dei costi. 

## Sintassi della richiesta
<a name="API_query_TagResource_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_query_TagResource_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.

 ** [ResourceARN](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-ResourceARN"></a>
Identifica la risorsa Timestream a cui aggiungere i tag. Questo valore è un Amazon Resource Name (ARN).  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: sì

 ** [Tags](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-Tags"></a>
I tag da assegnare alla risorsa Timestream.  
Tipo: matrice di oggetti [Tag](API_query_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

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

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa richiesta.    
 ** ScheduledQueryArn **   
L'ARN della query pianificata.
Codice di stato HTTP: 400

 ** ServiceQuotaExceededException **   
Hai superato la quota di servizio.  
Codice di stato HTTP: 400

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_TagResource_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-query-2018-11-01/TagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TagResource) 

# UntagResource
<a name="API_query_UntagResource"></a>

Rimuove l'associazione di tag da una risorsa di query Timestream.

## Sintassi della richiesta
<a name="API_query_UntagResource_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_query_UntagResource_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.

 ** [ResourceARN](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-ResourceARN"></a>
La risorsa Timestream da cui verranno rimossi i tag. Questo valore è un Amazon Resource Name (ARN).   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: sì

 ** [TagKeys](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-TagKeys"></a>
Un elenco di tag e chiavi. I tag esistenti della risorsa le cui chiavi sono membri di questo elenco verranno rimossi dalla risorsa Timestream.   
Tipo: array di stringhe  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

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

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa richiesta.    
 ** ScheduledQueryArn **   
L'ARN della query pianificata.
Codice di stato HTTP: 400

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_UntagResource_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-query-2018-11-01/UntagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UntagResource) 

# UpdateAccountSettings
<a name="API_query_UpdateAccountSettings"></a>

Trasforma il tuo account in modo da utilizzarlo TCUs per la determinazione dei prezzi delle query e modifica il numero massimo di unità di calcolo delle query che hai configurato. Se riduci il valore di `MaxQueryTCU` alla configurazione desiderata, il nuovo valore può richiedere fino a 24 ore per essere efficace.

**Nota**  
Dopo aver trasferito il tuo account all'utilizzo TCUs per la determinazione dei prezzi delle query, non puoi passare all'utilizzo dei byte scansionati per la determinazione dei prezzi delle query.

## Sintassi della richiesta
<a name="API_query_UpdateAccountSettings_RequestSyntax"></a>

```
{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         },
         "TargetQueryTCU": number
      }
   },
   "QueryPricingModel": "string"
}
```

## Parametri della richiesta
<a name="API_query_UpdateAccountSettings_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.

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-MaxQueryTCU"></a>
Il numero massimo di unità di elaborazione che il servizio utilizzerà in qualsiasi momento per rispondere alle tue richieste. Per eseguire le query, è necessario impostare una capacità minima di 4 TCU. È possibile impostare il numero massimo di TCU in multipli di 4, ad esempio 4, 8, 16, 32 e così via. Il valore massimo supportato per `MaxQueryTCU` è 1000. Per richiedere un aumento di questo limite flessibile, contatta l' AWS assistenza. Per informazioni sulla quota predefinita per MaxQueryTCU, vedi Quote predefinite. Questa configurazione è applicabile solo all'utilizzo su richiesta di Timestream Compute Units (). TCUs  
Il valore massimo supportato per è 1000. `MaxQueryTCU` Per richiedere un aumento di questo limite flessibile, contatta l' AWS assistenza. Per informazioni sulla quota predefinita per`maxQueryTCU`, consulta [Quote predefinite](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.default).  
Tipo: Integer  
Obbligatorio: no

 ** [QueryCompute](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryCompute"></a>
Modifica le impostazioni di calcolo delle query configurate nel tuo account, incluso il modello di determinazione dei prezzi delle query e le unità di calcolo Timestream () assegnate al tuo account. TCUs QueryCompute è disponibile solo nella regione Asia Pacifico (Mumbai).  
Questa API è idempotente, il che significa che effettuare la stessa richiesta più volte avrà lo stesso effetto della richiesta una sola volta.
Tipo: oggetto [QueryComputeRequest](API_query_QueryComputeRequest.md)  
Obbligatorio: no

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryPricingModel"></a>
Il modello di prezzo per le richieste in un account.  
Il `QueryPricingModel` parametro viene utilizzato da diverse operazioni di Timestream; tuttavia, l'operazione `UpdateAccountSettings` API non riconosce alcun valore diverso da. `COMPUTE_UNITS`
Tipo: String  
Valori validi: `BYTES_SCANNED | COMPUTE_UNITS`   
Campo obbligatorio: no

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

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

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

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

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-MaxQueryTCU"></a>
Il numero massimo configurato di unità di calcolo che il servizio utilizzerà in qualsiasi momento per rispondere alle tue domande.  
Tipo: numero intero

 ** [QueryCompute](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryCompute"></a>
Conferma le impostazioni aggiornate dell'account per l'interrogazione dei dati nel tuo account. QueryCompute è disponibile solo nella regione Asia Pacifico (Mumbai).  
Tipo: oggetto [QueryComputeResponse](API_query_QueryComputeResponse.md)

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryPricingModel"></a>
Il modello di prezzo per un account.  
Tipo: String  
Valori validi: `BYTES_SCANNED | COMPUTE_UNITS` 

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

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

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

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

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_UpdateAccountSettings_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-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateAccountSettings) 

# UpdateScheduledQuery
<a name="API_query_UpdateScheduledQuery"></a>

Aggiorna un'interrogazione pianificata.

## Sintassi della richiesta
<a name="API_query_UpdateScheduledQuery_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_query_UpdateScheduledQuery_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.

 ** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-ScheduledQueryArn"></a>
ARN della query pianificata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Obbligatorio: sì

 ** [State](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-State"></a>
Stato dell'interrogazione pianificata.   
Tipo: String  
Valori validi: `ENABLED | DISABLED`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per accedere alle impostazioni dell'account.  
Codice di stato HTTP: 400

 ** InternalServerException **   
Si è verificato un errore interno del server durante l'elaborazione della richiesta.  
Codice di stato HTTP: 400

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

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa richiesta.    
 ** ScheduledQueryArn **   
L'ARN della query pianificata.
Codice di stato HTTP: 400

 ** ThrottlingException **   
La richiesta è stata limitata a causa di un numero eccessivo di richieste.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_query_UpdateScheduledQuery_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-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateScheduledQuery) 

# Tipi di dati
<a name="API_Types"></a>

I seguenti tipi di dati sono supportati da Amazon Timestream Write:
+  [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) 

I seguenti tipi di dati sono supportati da Amazon Timestream Query:
+  [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) 

# Amazon Timestream Write
<a name="API_Types_Amazon_Timestream_Write"></a>

I seguenti tipi di dati sono supportati da Amazon Timestream Write:
+  [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>

Dettagli sullo stato di avanzamento di un'operazione di caricamento in batch.

## Indice
<a name="API_BatchLoadProgressReport_Contents"></a>

 ** BytesMetered **   <a name="timestream-Type-BatchLoadProgressReport-BytesMetered"></a>
  
Tipo: long  
Campo obbligatorio: no

 ** FileFailures **   <a name="timestream-Type-BatchLoadProgressReport-FileFailures"></a>
  
Tipo: long  
Campo obbligatorio: no

 ** ParseFailures **   <a name="timestream-Type-BatchLoadProgressReport-ParseFailures"></a>
  
Tipo: long  
Campo obbligatorio: no

 ** RecordIngestionFailures **   <a name="timestream-Type-BatchLoadProgressReport-RecordIngestionFailures"></a>
  
Tipo: long  
Campo obbligatorio: no

 ** RecordsIngested **   <a name="timestream-Type-BatchLoadProgressReport-RecordsIngested"></a>
  
Tipo: long  
Campo obbligatorio: no

 ** RecordsProcessed **   <a name="timestream-Type-BatchLoadProgressReport-RecordsProcessed"></a>
  
Tipo: long  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadProgressReport) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadProgressReport) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadProgressReport) 

# BatchLoadTask
<a name="API_BatchLoadTask"></a>

Dettagli su un'operazione di caricamento in batch.

## Indice
<a name="API_BatchLoadTask_Contents"></a>

 ** CreationTime **   <a name="timestream-Type-BatchLoadTask-CreationTime"></a>
L'ora in cui è stata creata l'attività di caricamento in batch di Timestream.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** DatabaseName **   <a name="timestream-Type-BatchLoadTask-DatabaseName"></a>
Nome del database in cui un'operazione di caricamento in batch carica i dati.  
Tipo: string  
Campo obbligatorio: no

 ** LastUpdatedTime **   <a name="timestream-Type-BatchLoadTask-LastUpdatedTime"></a>
L'ora dell'ultimo aggiornamento dell'attività di caricamento in batch di Timestream.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** ResumableUntil **   <a name="timestream-Type-BatchLoadTask-ResumableUntil"></a>
   
Tipo: Timestamp  
Campo obbligatorio: no

 ** TableName **   <a name="timestream-Type-BatchLoadTask-TableName"></a>
Nome della tabella in cui un'operazione di caricamento in batch carica i dati.  
Tipo: string  
Campo obbligatorio: no

 ** TaskId **   <a name="timestream-Type-BatchLoadTask-TaskId"></a>
L'ID dell'operazione di caricamento in batch.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 32 caratteri.  
Modello: `[A-Z0-9]+`   
Campo obbligatorio: no

 ** TaskStatus **   <a name="timestream-Type-BatchLoadTask-TaskStatus"></a>
Stato dell'operazione di caricamento in batch.  
Tipo: stringa  
Valori validi: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME`   
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTask) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTask) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTask) 

# BatchLoadTaskDescription
<a name="API_BatchLoadTaskDescription"></a>

Dettagli su un'operazione di caricamento in batch.

## Indice
<a name="API_BatchLoadTaskDescription_Contents"></a>

 ** CreationTime **   <a name="timestream-Type-BatchLoadTaskDescription-CreationTime"></a>
L'ora in cui è stata creata l'attività di caricamento in batch di Timestream.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** DataModelConfiguration **   <a name="timestream-Type-BatchLoadTaskDescription-DataModelConfiguration"></a>
Configurazione del modello di dati per un'operazione di caricamento in batch. Contiene dettagli sulla posizione in cui è archiviato un modello di dati per un'operazione di caricamento in batch.  
Tipo: oggetto [DataModelConfiguration](API_DataModelConfiguration.md)  
Campo obbligatorio: no

 ** DataSourceConfiguration **   <a name="timestream-Type-BatchLoadTaskDescription-DataSourceConfiguration"></a>
Dettagli di configurazione sull'origine dati per un'operazione di caricamento in batch.  
Tipo: oggetto [DataSourceConfiguration](API_DataSourceConfiguration.md)  
Required: No

 ** ErrorMessage **   <a name="timestream-Type-BatchLoadTaskDescription-ErrorMessage"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: no

 ** LastUpdatedTime **   <a name="timestream-Type-BatchLoadTaskDescription-LastUpdatedTime"></a>
L'ora dell'ultimo aggiornamento dell'attività di caricamento in batch di Timestream.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** ProgressReport **   <a name="timestream-Type-BatchLoadTaskDescription-ProgressReport"></a>
  
Tipo: oggetto [BatchLoadProgressReport](API_BatchLoadProgressReport.md)  
Campo obbligatorio: no

 ** RecordVersion **   <a name="timestream-Type-BatchLoadTaskDescription-RecordVersion"></a>
  
Tipo: long  
Campo obbligatorio: no

 ** ReportConfiguration **   <a name="timestream-Type-BatchLoadTaskDescription-ReportConfiguration"></a>
Configurazione del report per un'attività di caricamento in batch. Contiene dettagli sulla posizione in cui vengono archiviate le segnalazioni di errori.  
Tipo: oggetto [ReportConfiguration](API_ReportConfiguration.md)  
Campo obbligatorio: no

 ** ResumableUntil **   <a name="timestream-Type-BatchLoadTaskDescription-ResumableUntil"></a>
   
Tipo: Timestamp  
Required: No

 ** TargetDatabaseName **   <a name="timestream-Type-BatchLoadTaskDescription-TargetDatabaseName"></a>
  
Tipo: string  
Required: No

 ** TargetTableName **   <a name="timestream-Type-BatchLoadTaskDescription-TargetTableName"></a>
  
Tipo: string  
Campo obbligatorio: no

 ** TaskId **   <a name="timestream-Type-BatchLoadTaskDescription-TaskId"></a>
L'ID dell'operazione di caricamento in batch.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 32 caratteri.  
Modello: `[A-Z0-9]+`   
Campo obbligatorio: no

 ** TaskStatus **   <a name="timestream-Type-BatchLoadTaskDescription-TaskStatus"></a>
Stato dell'operazione di caricamento in batch.  
Tipo: stringa  
Valori validi: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME`   
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTaskDescription) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTaskDescription) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTaskDescription) 

# CsvConfiguration
<a name="API_CsvConfiguration"></a>

Un formato di dati delimitato in cui il separatore di colonna può essere una virgola e il separatore di record è un carattere di nuova riga.

## Indice
<a name="API_CsvConfiguration_Contents"></a>

 ** ColumnSeparator **   <a name="timestream-Type-CsvConfiguration-ColumnSeparator"></a>
Il separatore di colonna può essere composto da virgola (','), pipe ('\$1), punto e virgola (';'), tab ('/t') o spazio vuoto ('').   
Tipo: stringa  
Vincoli di lunghezza: lunghezza fissa pari a 1.  
Campo obbligatorio: no

 ** EscapeChar **   <a name="timestream-Type-CsvConfiguration-EscapeChar"></a>
Il personaggio di fuga può essere uno dei   
Tipo: stringa  
Vincoli di lunghezza: lunghezza fissa pari a 1.  
Campo obbligatorio: no

 ** NullValue **   <a name="timestream-Type-CsvConfiguration-NullValue"></a>
Può essere uno spazio vuoto ('').  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

 ** QuoteChar **   <a name="timestream-Type-CsvConfiguration-QuoteChar"></a>
Può essere tra virgolette singole (') o doppie («).  
Tipo: stringa  
Vincoli di lunghezza: lunghezza fissa pari a 1.  
Campo obbligatorio: no

 ** TrimWhiteSpace **   <a name="timestream-Type-CsvConfiguration-TrimWhiteSpace"></a>
Specifica di tagliare gli spazi bianchi iniziali e finali.  
Tipo: Booleano  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CsvConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CsvConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CsvConfiguration) 

# Database
<a name="API_Database"></a>

Un contenitore di primo livello per una tabella. I database e le tabelle sono i concetti di gestione fondamentali in Amazon Timestream. Tutte le tabelle di un database sono crittografate con la stessa AWS KMS chiave.

## Indice
<a name="API_Database_Contents"></a>

 ** Arn **   <a name="timestream-Type-Database-Arn"></a>
L'Amazon Resource Name che identifica in modo univoco questo database.  
Tipo: string  
Campo obbligatorio: no

 ** CreationTime **   <a name="timestream-Type-Database-CreationTime"></a>
L'ora in cui è stato creato il database, calcolata a partire dall'epoca Unix.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** DatabaseName **   <a name="timestream-Type-Database-DatabaseName"></a>
Nome del database Timestream.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

 ** KmsKeyId **   <a name="timestream-Type-Database-KmsKeyId"></a>
L'identificatore della AWS KMS chiave utilizzata per crittografare i dati memorizzati nel database.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: no

 ** LastUpdatedTime **   <a name="timestream-Type-Database-LastUpdatedTime"></a>
 L'ultima volta che questo database è stato aggiornato.   
Tipo: Timestamp  
Campo obbligatorio: no

 ** TableCount **   <a name="timestream-Type-Database-TableCount"></a>
Il numero totale di tabelle trovate all'interno di un database Timestream.   
Tipo: long  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Database) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Database) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Database) 

# DataModel
<a name="API_DataModel"></a>

Modello di dati per un'attività di caricamento in batch.

## Indice
<a name="API_DataModel_Contents"></a>

 ** DimensionMappings **   <a name="timestream-Type-DataModel-DimensionMappings"></a>
Mappature da origine a destinazione per le dimensioni.  
Tipo: matrice di oggetti [DimensionMapping](API_DimensionMapping.md)  
Membri dell’array: numero minimo di 1 elemento.  
Campo obbligatorio: sì

 ** MeasureNameColumn **   <a name="timestream-Type-DataModel-MeasureNameColumn"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

 ** MixedMeasureMappings **   <a name="timestream-Type-DataModel-MixedMeasureMappings"></a>
Mappature da origine a destinazione per le misure.  
Tipo: matrice di oggetti [MixedMeasureMapping](API_MixedMeasureMapping.md)  
Membri dell’array: numero minimo di 1 elemento.  
Campo obbligatorio: no

 ** MultiMeasureMappings **   <a name="timestream-Type-DataModel-MultiMeasureMappings"></a>
Mappature da origine a destinazione per record multimisura.  
Tipo: oggetto [MultiMeasureMappings](API_MultiMeasureMappings.md)  
Campo obbligatorio: no

 ** TimeColumn **   <a name="timestream-Type-DataModel-TimeColumn"></a>
Colonna di origine da mappare all'ora.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

 ** TimeUnit **   <a name="timestream-Type-DataModel-TimeUnit"></a>
 La granularità dell'unità timestamp. Indica se il valore temporale è in secondi, millisecondi, nanosecondi o altri valori supportati. Il valore predefinito è `MILLISECONDS`.   
Tipo: stringa  
Valori validi: `MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS`   
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModel) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModel) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModel) 

# DataModelConfiguration
<a name="API_DataModelConfiguration"></a>



## Indice
<a name="API_DataModelConfiguration_Contents"></a>

 ** DataModel **   <a name="timestream-Type-DataModelConfiguration-DataModel"></a>
  
Tipo: oggetto [DataModel](API_DataModel.md)  
Campo obbligatorio: no

 ** DataModelS3Configuration **   <a name="timestream-Type-DataModelConfiguration-DataModelS3Configuration"></a>
  
Tipo: oggetto [DataModelS3Configuration](API_DataModelS3Configuration.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelConfiguration) 

# DataModelS3Configuration
<a name="API_DataModelS3Configuration"></a>



## Indice
<a name="API_DataModelS3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-DataModelS3Configuration-BucketName"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 63 caratteri.  
Modello: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Required: No

 ** ObjectKey **   <a name="timestream-Type-DataModelS3Configuration-ObjectKey"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.  
Modello: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelS3Configuration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelS3Configuration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelS3Configuration) 

# DataSourceConfiguration
<a name="API_DataSourceConfiguration"></a>

Definisce i dettagli di configurazione sull'origine dati.

## Indice
<a name="API_DataSourceConfiguration_Contents"></a>

 ** DataFormat **   <a name="timestream-Type-DataSourceConfiguration-DataFormat"></a>
Attualmente è CSV.  
Tipo: stringa  
Valori validi: `CSV`   
Campo obbligatorio: sì

 ** DataSourceS3Configuration **   <a name="timestream-Type-DataSourceConfiguration-DataSourceS3Configuration"></a>
Configurazione di una posizione S3 per un file che contiene dati da caricare.  
Tipo: oggetto [DataSourceS3Configuration](API_DataSourceS3Configuration.md)  
Campo obbligatorio: sì

 ** CsvConfiguration **   <a name="timestream-Type-DataSourceConfiguration-CsvConfiguration"></a>
Un formato di dati delimitato in cui il separatore di colonna può essere una virgola e il separatore di record è un carattere di nuova riga.  
Tipo: oggetto [CsvConfiguration](API_CsvConfiguration.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceConfiguration) 

# DataSourceS3Configuration
<a name="API_DataSourceS3Configuration"></a>

 

## Indice
<a name="API_DataSourceS3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-DataSourceS3Configuration-BucketName"></a>
Il nome bucket del bucket S3 del cliente.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 63 caratteri.  
Modello: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Campo obbligatorio: sì

 ** ObjectKeyPrefix **   <a name="timestream-Type-DataSourceS3Configuration-ObjectKeyPrefix"></a>
   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.  
Modello: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceS3Configuration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceS3Configuration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceS3Configuration) 

# Dimension
<a name="API_Dimension"></a>

Rappresenta gli attributi dei metadati delle serie temporali. Ad esempio, il nome e la zona di disponibilità di un' EC2istanza o il nome del produttore di una turbina eolica sono dimensioni. 

## Indice
<a name="API_Dimension_Contents"></a>

 ** Name **   <a name="timestream-Type-Dimension-Name"></a>
 La dimensione rappresenta gli attributi dei metadati delle serie temporali. Ad esempio, il nome e la zona di disponibilità di un' EC2 istanza o il nome del produttore di una turbina eolica sono dimensioni.   
[Per i vincoli sui nomi delle dimensioni, vedere Vincoli di denominazione.](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming)  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 60.  
Campo obbligatorio: sì

 ** Value **   <a name="timestream-Type-Dimension-Value"></a>
Il valore della dimensione.  
Tipo: stringa  
Campo obbligatorio: sì

 ** DimensionValueType **   <a name="timestream-Type-Dimension-DimensionValueType"></a>
Il tipo di dati della dimensione per il punto dati della serie temporale.  
Tipo: stringa  
Valori validi: `VARCHAR`   
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Dimension) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Dimension) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Dimension) 

# DimensionMapping
<a name="API_DimensionMapping"></a>



## Indice
<a name="API_DimensionMapping_Contents"></a>

 ** DestinationColumn **   <a name="timestream-Type-DimensionMapping-DestinationColumn"></a>
   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1.  
Required: No

 ** SourceColumn **   <a name="timestream-Type-DimensionMapping-SourceColumn"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1.  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DimensionMapping) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DimensionMapping) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DimensionMapping) 

# Endpoint
<a name="API_Endpoint"></a>

Rappresenta un endpoint disponibile verso il quale effettuare chiamate API, nonché il TTL per quell'endpoint.

## Indice
<a name="API_Endpoint_Contents"></a>

 ** Address **   <a name="timestream-Type-Endpoint-Address"></a>
Un indirizzo endpoint.  
Tipo: stringa  
Campo obbligatorio: sì

 ** CachePeriodInMinutes **   <a name="timestream-Type-Endpoint-CachePeriodInMinutes"></a>
Il TTL per l'endpoint, in minuti.  
Tipo: long  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Endpoint) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Endpoint) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Endpoint) 

# MagneticStoreRejectedDataLocation
<a name="API_MagneticStoreRejectedDataLocation"></a>

La posizione in cui scrivere i report degli errori per i record rifiutati, in modo asincrono, durante le scritture dell’archivio magnetico.

## Indice
<a name="API_MagneticStoreRejectedDataLocation_Contents"></a>

 ** S3Configuration **   <a name="timestream-Type-MagneticStoreRejectedDataLocation-S3Configuration"></a>
Configurazione di una posizione S3 in cui scrivere i report degli errori per i record rifiutati, in modo asincrono, durante le scritture dell’archivio magnetico.  
Tipo: oggetto [S3Configuration](API_S3Configuration.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) 

# MagneticStoreWriteProperties
<a name="API_MagneticStoreWriteProperties"></a>

Il set di proprietà in una tabella per la configurazione di scritture dell’archivio magnetico.

## Indice
<a name="API_MagneticStoreWriteProperties_Contents"></a>

 ** EnableMagneticStoreWrites **   <a name="timestream-Type-MagneticStoreWriteProperties-EnableMagneticStoreWrites"></a>
Un contrassegno per abilitare scritture dell’archivio magnetico.  
Tipo: Booleano  
Campo obbligatorio: sì

 ** MagneticStoreRejectedDataLocation **   <a name="timestream-Type-MagneticStoreWriteProperties-MagneticStoreRejectedDataLocation"></a>
La posizione in cui scrivere i report degli errori per i record rifiutati, in modo asincrono, durante le scritture dell’archivio magnetico.  
Tipo: oggetto [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreWriteProperties) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreWriteProperties) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreWriteProperties) 

# MeasureValue
<a name="API_MeasureValue"></a>

 Rappresenta l'attributo di dati della serie temporale. Ad esempio, l'utilizzo della CPU di un' EC2 istanza o il numero di giri al minuto di una turbina eolica sono misure. MeasureValue ha sia nome che valore. 

 MeasureValue è consentito solo per tipo`MULTI`. Utilizzando `MULTI` type, è possibile passare più attributi di dati associati alla stessa serie temporale in un singolo record 

## Indice
<a name="API_MeasureValue_Contents"></a>

 ** Name **   <a name="timestream-Type-MeasureValue-Name"></a>
 Nome della MeasureValue.   
 Per i vincoli sui MeasureValue nomi, consulta [Naming Constraints nella](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming) Amazon Timestream Developer Guide.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1.  
Campo obbligatorio: sì

 ** Type **   <a name="timestream-Type-MeasureValue-Type"></a>
Contiene il tipo di dati del punto dati della serie temporale. MeasureValue   
Tipo: stringa  
Valori validi: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI`   
Campo obbligatorio: sì

 ** Value **   <a name="timestream-Type-MeasureValue-Value"></a>
 Il valore per. MeasureValue Per informazioni, consulta [Tipi di dati](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types).  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MeasureValue) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MeasureValue) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MeasureValue) 

# MixedMeasureMapping
<a name="API_MixedMeasureMapping"></a>



## Indice
<a name="API_MixedMeasureMapping_Contents"></a>

 ** MeasureValueType **   <a name="timestream-Type-MixedMeasureMapping-MeasureValueType"></a>
  
Tipo: stringa  
Valori validi: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI`   
Campo obbligatorio: sì

 ** MeasureName **   <a name="timestream-Type-MixedMeasureMapping-MeasureName"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1.  
Campo obbligatorio: no

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-MixedMeasureMapping-MultiMeasureAttributeMappings"></a>
  
Tipo: matrice di oggetti [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md)  
Membri dell’array: numero minimo di 1 elemento.  
Required: No

 ** SourceColumn **   <a name="timestream-Type-MixedMeasureMapping-SourceColumn"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1.  
Required: No

 ** TargetMeasureName **   <a name="timestream-Type-MixedMeasureMapping-TargetMeasureName"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1.  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MixedMeasureMapping) 

# MultiMeasureAttributeMapping
<a name="API_MultiMeasureAttributeMapping"></a>



## Indice
<a name="API_MultiMeasureAttributeMapping_Contents"></a>

 ** SourceColumn **   <a name="timestream-Type-MultiMeasureAttributeMapping-SourceColumn"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1.  
Campo obbligatorio: sì

 ** MeasureValueType **   <a name="timestream-Type-MultiMeasureAttributeMapping-MeasureValueType"></a>
  
Tipo: stringa  
Valori validi: `DOUBLE | BIGINT | BOOLEAN | VARCHAR | TIMESTAMP`   
Campo obbligatorio: no

 ** TargetMultiMeasureAttributeName **   <a name="timestream-Type-MultiMeasureAttributeMapping-TargetMultiMeasureAttributeName"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1.  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureAttributeMapping) 

# MultiMeasureMappings
<a name="API_MultiMeasureMappings"></a>



## Indice
<a name="API_MultiMeasureMappings_Contents"></a>

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-MultiMeasureMappings-MultiMeasureAttributeMappings"></a>
  
Tipo: matrice di oggetti [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md)  
Membri dell’array: numero minimo di 1 elemento.  
Campo obbligatorio: sì

 ** TargetMultiMeasureName **   <a name="timestream-Type-MultiMeasureMappings-TargetMultiMeasureName"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1.  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureMappings) 

# PartitionKey
<a name="API_PartitionKey"></a>

 Un attributo utilizzato per il partizionamento dei dati in una tabella. Una chiave di dimensione partiziona i dati utilizzando i valori della dimensione specificata dal nome della dimensione come chiave di partizione, mentre una chiave di misura partiziona i dati utilizzando i nomi delle misure (valori della colonna «measure\$1name»). 

## Indice
<a name="API_PartitionKey_Contents"></a>

 ** Type **   <a name="timestream-Type-PartitionKey-Type"></a>
 Il tipo di chiave di partizione. Le opzioni sono DIMENSION (chiave di dimensione) e MEASURE (chiave di misura).   
Tipo: stringa  
Valori validi: `DIMENSION | MEASURE`   
Campo obbligatorio: sì

 ** EnforcementInRecord **   <a name="timestream-Type-PartitionKey-EnforcementInRecord"></a>
 Il livello di applicazione per la specificazione di una chiave di dimensione nei record importati. Le opzioni sono OBBLIGATORIE (la chiave della dimensione deve essere specificata) e OPZIONALE (la chiave della dimensione non deve essere specificata).   
Tipo: stringa  
Valori validi: `REQUIRED | OPTIONAL`   
Campo obbligatorio: no

 ** Name **   <a name="timestream-Type-PartitionKey-Name"></a>
 Il nome dell'attributo utilizzato per una chiave di dimensione.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1.  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/PartitionKey) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/PartitionKey) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/PartitionKey) 

# Record
<a name="API_Record"></a>

Rappresenta un punto dati di serie temporali che viene scritto in Timestream. Ogni record contiene una matrice di dimensioni. Le dimensioni rappresentano gli attributi dei metadati di un punto dati di una serie temporale, ad esempio il nome dell'istanza o la zona di disponibilità di un' EC2 istanza. Un record contiene anche il nome della misura, che è il nome della misura raccolta (ad esempio, l'utilizzo della CPU di un' EC2 istanza). Inoltre, un record contiene il valore della misura e il tipo di valore, che è il tipo di dati del valore della misura. Inoltre, il record contiene il timestamp di quando la misura è stata raccolta e l'unità di timestamp, che rappresenta la granularità del timestamp. 

 I record hanno un `Version` campo, a 64 bit`long`, che è possibile utilizzare per aggiornare i punti dati. La scrittura di un record duplicato con la stessa dimensione, timestamp e nome di misura ma un valore di misura diverso avrà esito positivo solo se l'`Version`attributo del record nella richiesta di scrittura è superiore a quello del record esistente. Il valore predefinito di Timestream è quello dei record senza il campo. `Version` `1` `Version` 

## Indice
<a name="API_Record_Contents"></a>

 ** Dimensions **   <a name="timestream-Type-Record-Dimensions"></a>
Contiene l'elenco delle dimensioni per i punti dati delle serie temporali.  
Tipo: matrice di oggetti [Dimension](API_Dimension.md)  
Membri dell'array: numero massimo di 128 elementi.  
Campo obbligatorio: no

 ** MeasureName **   <a name="timestream-Type-Record-MeasureName"></a>
La misura rappresenta l'attributo di dati della serie temporale. Ad esempio, l'utilizzo della CPU di un' EC2 istanza o il numero di giri al minuto di una turbina eolica sono misure.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

 ** MeasureValue **   <a name="timestream-Type-Record-MeasureValue"></a>
 Contiene il valore di misura per il punto dati della serie temporale.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: no

 ** MeasureValues **   <a name="timestream-Type-Record-MeasureValues"></a>
 Contiene l'elenco di quattro punti dati MeasureValue delle serie temporali.   
 È consentito solo per il tipo`MULTI`. Per i valori scalari, usa direttamente l'`MeasureValue`attributo del record.   
Tipo: matrice di oggetti [MeasureValue](API_MeasureValue.md)  
Campo obbligatorio: no

 ** MeasureValueType **   <a name="timestream-Type-Record-MeasureValueType"></a>
 Contiene il tipo di dati del valore di misura per il punto dati della serie temporale. Il tipo predefinito è`DOUBLE`. Per ulteriori informazioni, consulta [Tipi di dati](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types).  
Tipo: stringa  
Valori validi: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI`   
Campo obbligatorio: no

 ** Time **   <a name="timestream-Type-Record-Time"></a>
 Contiene l'ora in cui è stato raccolto il valore di misura per il punto dati. Il valore temporale più l'unità fornisce il tempo trascorso dall'epoca. Ad esempio, se il valore temporale è `12345` e l'unità è`ms`, allora `12345 ms` sono trascorsi dall'epoca.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

 ** TimeUnit **   <a name="timestream-Type-Record-TimeUnit"></a>
 La granularità dell'unità di marcatura temporale. Indica se il valore temporale è in secondi, millisecondi, nanosecondi o altri valori supportati. Il valore predefinito è `MILLISECONDS`.   
Tipo: stringa  
Valori validi: `MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS`   
Campo obbligatorio: no

 ** Version **   <a name="timestream-Type-Record-Version"></a>
Attributo a 64 bit utilizzato per gli aggiornamenti dei record. Le richieste di scrittura per dati duplicati con un numero di versione superiore aggiorneranno il valore e la versione della misura esistenti. Nei casi in cui il valore di misura è lo stesso, `Version` verrà comunque aggiornato. Il valore predefinito è `1`.  
 `Version`deve essere uguale `1` o superiore, altrimenti riceverai un `ValidationException` errore.
Tipo: long  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Record) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Record) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Record) 

# RecordsIngested
<a name="API_RecordsIngested"></a>

Informazioni sui record acquisiti con questa richiesta.

## Indice
<a name="API_RecordsIngested_Contents"></a>

 ** MagneticStore **   <a name="timestream-Type-RecordsIngested-MagneticStore"></a>
Numero di record ingeriti nel magazzino magnetico.  
Tipo: integer  
Campo obbligatorio: no

 ** MemoryStore **   <a name="timestream-Type-RecordsIngested-MemoryStore"></a>
Numero di record inseriti nell'archivio di memoria.  
Tipo: integer  
Campo obbligatorio: no

 ** Total **   <a name="timestream-Type-RecordsIngested-Total"></a>
Numero totale di record ingeriti con successo.  
Tipo: integer  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RecordsIngested) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RecordsIngested) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RecordsIngested) 

# RejectedRecord
<a name="API_RejectedRecord"></a>

 Rappresenta i record che non sono stati inseriti correttamente in Timestream a causa di problemi di convalida dei dati che devono essere risolti prima di reinserire i dati delle serie temporali nel sistema. 

## Indice
<a name="API_RejectedRecord_Contents"></a>

 ** ExistingVersion **   <a name="timestream-Type-RejectedRecord-ExistingVersion"></a>
La versione esistente del record. Questo valore viene compilato negli scenari in cui esiste un record identico con una versione superiore a quella nella richiesta di scrittura.  
Tipo: long  
Campo obbligatorio: no

 ** Reason **   <a name="timestream-Type-RejectedRecord-Reason"></a>
 Il motivo per cui un record non è stato inserito correttamente in Timestream. Le possibili cause di errore includono:   
+ Record con dati duplicati in cui sono presenti più record con le stesse dimensioni, timestamp e nomi di misure ma: 
  + I valori di misura sono diversi
  + La versione non è presente nella richiesta *oppure* il valore della versione nel nuovo record è uguale o inferiore al valore esistente

  Se Timestream rifiuta i dati per questo caso, il `ExistingVersion` campo nella `RejectedRecords` risposta indicherà la versione del record corrente. Per forzare un aggiornamento, puoi inviare nuovamente la richiesta con una versione del record impostata su un valore maggiore di. `ExistingVersion`
+  Record con timestamp che non rientrano nella durata di conservazione dell'archivio di memoria. 
**Nota**  
Quando la finestra di conservazione viene aggiornata, riceverai un'`RejectedRecords`eccezione se tenti immediatamente di inserire dati all'interno della nuova finestra. Per evitare un'`RejectedRecords`eccezione, attendi la durata della nuova finestra per inserire nuovi dati. Per ulteriori informazioni, consulta [Best Practices for Configuring Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/best-practices.html#configuration) e [la spiegazione di come funziona lo storage](https://docs.aws.amazon.com/timestream/latest/developerguide/storage.html) in Timestream.
+  Record con dimensioni o misure che superano i limiti definiti dal Timestream. 
 Per ulteriori informazioni, vedere [Gestione degli accessi](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) nella guida per gli sviluppatori Timestream.   
Tipo: string  
Campo obbligatorio: no

 ** RecordIndex **   <a name="timestream-Type-RejectedRecord-RecordIndex"></a>
 L'indice del record nella richiesta di input per. WriteRecords Gli indici iniziano con 0.   
Tipo: integer  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RejectedRecord) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RejectedRecord) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RejectedRecord) 

# ReportConfiguration
<a name="API_ReportConfiguration"></a>

Configurazione del report per un'attività di caricamento in batch. Contiene dettagli sulla posizione in cui vengono archiviate le segnalazioni di errori.

## Indice
<a name="API_ReportConfiguration_Contents"></a>

 ** ReportS3Configuration **   <a name="timestream-Type-ReportConfiguration-ReportS3Configuration"></a>
Configurazione di una posizione S3 per scrivere report ed eventi di errore per un caricamento in batch.  
Tipo: oggetto [ReportS3Configuration](API_ReportS3Configuration.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportConfiguration) 

# ReportS3Configuration
<a name="API_ReportS3Configuration"></a>



## Indice
<a name="API_ReportS3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-ReportS3Configuration-BucketName"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 63 caratteri.  
Modello: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Campo obbligatorio: sì

 ** EncryptionOption **   <a name="timestream-Type-ReportS3Configuration-EncryptionOption"></a>
  
Tipo: stringa  
Valori validi: `SSE_S3 | SSE_KMS`   
Campo obbligatorio: no

 ** KmsKeyId **   <a name="timestream-Type-ReportS3Configuration-KmsKeyId"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Required: No

 ** ObjectKeyPrefix **   <a name="timestream-Type-ReportS3Configuration-ObjectKeyPrefix"></a>
  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 928.  
Modello: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportS3Configuration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportS3Configuration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportS3Configuration) 

# RetentionProperties
<a name="API_RetentionProperties"></a>

Le proprietà di conservazione contengono la durata per la quale i dati di serie temporali devono essere memorizzati nell’archivio magnetico e nell'archivio della memoria. 

## Indice
<a name="API_RetentionProperties_Contents"></a>

 ** MagneticStoreRetentionPeriodInDays **   <a name="timestream-Type-RetentionProperties-MagneticStoreRetentionPeriodInDays"></a>
La durata per la quale i dati devono essere memorizzati nell'archivio magnetico.   
Tipo: long  
Intervallo valido: valore minimo di 1. Valore massimo di 73000.  
Campo obbligatorio: sì

 ** MemoryStoreRetentionPeriodInHours **   <a name="timestream-Type-RetentionProperties-MemoryStoreRetentionPeriodInHours"></a>
La durata per la quale i dati devono essere memorizzati nell'archivio della memoria.   
Tipo: long  
Intervallo valido: valore minimo di 1. Valore massimo di 8766.  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RetentionProperties) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RetentionProperties) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RetentionProperties) 

# S3Configuration
<a name="API_S3Configuration"></a>

La configurazione che specifica una posizione S3.

## Indice
<a name="API_S3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-S3Configuration-BucketName"></a>
Il nome bucket del bucket S3 del cliente.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 63 caratteri.  
Modello: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Campo obbligatorio: no

 ** EncryptionOption **   <a name="timestream-Type-S3Configuration-EncryptionOption"></a>
L'opzione di crittografia per la posizione S3 del cliente. Le opzioni sono la crittografia lato server S3 con una chiave gestita o una chiave gestita S3. AWS   
Tipo: stringa  
Valori validi: `SSE_S3 | SSE_KMS`   
Campo obbligatorio: no

 ** KmsKeyId **   <a name="timestream-Type-S3Configuration-KmsKeyId"></a>
L'ID della AWS KMS chiave per la posizione S3 del cliente durante la crittografia con una chiave gestita. AWS   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: no

 ** ObjectKeyPrefix **   <a name="timestream-Type-S3Configuration-ObjectKeyPrefix"></a>
L'anteprima della chiave oggetto per la posizione S3 del cliente.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 928.  
Modello: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/S3Configuration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/S3Configuration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/S3Configuration) 

# Schema
<a name="API_Schema"></a>

 Uno schema specifica il modello di dati previsto per la tabella. 

## Indice
<a name="API_Schema_Contents"></a>

 ** CompositePartitionKey **   <a name="timestream-Type-Schema-CompositePartitionKey"></a>
Un elenco non vuoto di chiavi di partizione che definiscono gli attributi utilizzati per partizionare i dati della tabella. L'ordine dell'elenco determina la gerarchia delle partizioni. Il nome e il tipo di ciascuna chiave di partizione e l'ordine delle chiavi di partizione non possono essere modificati dopo la creazione della tabella. Tuttavia, è possibile modificare il livello di applicazione di ciascuna chiave di partizione.   
Tipo: matrice di oggetti [PartitionKey](API_PartitionKey.md)  
Membri dell’array: numero minimo di 1 elemento.  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Schema) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Schema) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Schema) 

# Table
<a name="API_Table"></a>

Rappresenta una tabella di database in Timestream. Le tabelle contengono una o più serie temporali correlate. È possibile modificare la durata di conservazione dell'archivio di memoria e dell'archivio magnetico per una tabella. 

## Indice
<a name="API_Table_Contents"></a>

 ** Arn **   <a name="timestream-Type-Table-Arn"></a>
Il nome di risorsa Amazon che identifica in modo univoco questa tabella.  
Tipo: string  
Campo obbligatorio: no

 ** CreationTime **   <a name="timestream-Type-Table-CreationTime"></a>
L'ora in cui è stata creata la tabella Timestream.   
Tipo: Timestamp  
Campo obbligatorio: no

 ** DatabaseName **   <a name="timestream-Type-Table-DatabaseName"></a>
Nome del database Timestream che contiene questa tabella.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

 ** LastUpdatedTime **   <a name="timestream-Type-Table-LastUpdatedTime"></a>
L'ora dell'ultimo aggiornamento della tabella Timestream.  
Tipo: Timestamp  
Campo obbligatorio: no

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

 ** RetentionProperties **   <a name="timestream-Type-Table-RetentionProperties"></a>
La durata di conservazione per lo store di memoria e lo store magnetico.  
Tipo: oggetto [RetentionProperties](API_RetentionProperties.md)  
Campo obbligatorio: no

 ** Schema **   <a name="timestream-Type-Table-Schema"></a>
 Lo schema della tabella.   
Tipo: oggetto [Schema](API_Schema.md)  
Campo obbligatorio: no

 ** TableName **   <a name="timestream-Type-Table-TableName"></a>
Nome della tabella Timestream.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

 ** TableStatus **   <a name="timestream-Type-Table-TableStatus"></a>
Lo stato attuale della tabella:  
+  `DELETING`- La tabella viene eliminata.
+  `ACTIVE`- Il tavolo è pronto per l'uso.
Tipo: stringa  
Valori validi: `ACTIVE | DELETING | RESTORING`   
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Table) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Table) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Table) 

# Tag
<a name="API_Tag"></a>

 Un tag è un'etichetta che si assegna alle and/or table. Each tag consists of a key and an optional value, both of which you define. With tags, you can categorize databases and/or tabelle di un database Timestream, ad esempio per scopo, proprietario o ambiente. 

## Indice
<a name="API_Tag_Contents"></a>

 ** Key **   <a name="timestream-Type-Tag-Key"></a>
 La chiave del tag. Le chiavi dei tag prevedono una distinzione tra lettere maiuscole e minuscole.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Campo obbligatorio: sì

 ** Value **   <a name="timestream-Type-Tag-Value"></a>
 Il valore del tag. I valori dei tag fanno distinzione tra maiuscole e minuscole e possono essere nulli.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Tag) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Tag) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Tag) 

# Interrogazione su Amazon Timestream
<a name="API_Types_Amazon_Timestream_Query"></a>

I seguenti tipi di dati sono supportati da Amazon Timestream Query:
+  [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>

Impostazioni di configurazione per le notifiche relative alle impostazioni dell'account.

## Indice
<a name="API_query_AccountSettingsNotificationConfiguration_Contents"></a>

 ** RoleArn **   <a name="timestream-Type-query_AccountSettingsNotificationConfiguration-RoleArn"></a>
Un Amazon Resource Name (ARN) che concede a Timestream l'autorizzazione a pubblicare notifiche. Questo campo è visibile solo se viene fornito un argomento SNS durante l'aggiornamento delle impostazioni dell'account.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: sì

 ** SnsConfiguration **   <a name="timestream-Type-query_AccountSettingsNotificationConfiguration-SnsConfiguration"></a>
Dettagli su SNS necessari per inviare la notifica.  
Tipo: oggetto [SnsConfiguration](API_query_SnsConfiguration.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) 

# ColumnInfo
<a name="API_query_ColumnInfo"></a>

 Contiene i metadati per i risultati delle query, ad esempio i nomi delle colonne, i tipi di dati e altri attributi. 

## Indice
<a name="API_query_ColumnInfo_Contents"></a>

 ** Type **   <a name="timestream-Type-query_ColumnInfo-Type"></a>
Il tipo di dati della colonna del set di risultati. Il tipo di dati può essere scalare o complesso. I tipi di dati scalari sono numeri interi, stringhe, doppi, booleani e altri. I tipi di dati complessi sono tipi come matrici, righe e altri.   
Tipo: oggetto [Type](API_query_Type.md)  
Campo obbligatorio: sì

 ** Name **   <a name="timestream-Type-query_ColumnInfo-Name"></a>
 Il nome della colonna del set di risultati. Il nome del set di risultati è disponibile per le colonne di tutti i tipi di dati ad eccezione degli array.   
Tipo: string  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ColumnInfo) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ColumnInfo) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ColumnInfo) 

# Datum
<a name="API_query_Datum"></a>

 Datum rappresenta un singolo punto dati nel risultato di una query. 

## Indice
<a name="API_query_Datum_Contents"></a>

 ** ArrayValue **   <a name="timestream-Type-query_Datum-ArrayValue"></a>
 Indica se il punto dati è una matrice.   
Tipo: matrice di oggetti [Datum](#API_query_Datum)  
Campo obbligatorio: no

 ** NullValue **   <a name="timestream-Type-query_Datum-NullValue"></a>
 Indica se il punto dati è nullo.   
Tipo: Booleano  
Campo obbligatorio: no

 ** RowValue **   <a name="timestream-Type-query_Datum-RowValue"></a>
 Indica se il punto dati è una riga.   
Tipo: oggetto [Row](API_query_Row.md)  
Campo obbligatorio: no

 ** ScalarValue **   <a name="timestream-Type-query_Datum-ScalarValue"></a>
 Indica se il punto dati è un valore scalare come intero, stringa, double o booleano.   
Tipo: string  
Campo obbligatorio: no

 ** TimeSeriesValue **   <a name="timestream-Type-query_Datum-TimeSeriesValue"></a>
 Indica se il punto dati è un tipo di dati di una serie temporale.   
Tipo: matrice di oggetti [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Datum) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Datum) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Datum) 

# DimensionMapping
<a name="API_query_DimensionMapping"></a>

Questo tipo viene utilizzato per mappare colonne dal risultato della query a una dimensione nella tabella di destinazione.

## Indice
<a name="API_query_DimensionMapping_Contents"></a>

 ** DimensionValueType **   <a name="timestream-Type-query_DimensionMapping-DimensionValueType"></a>
Tipo per la dimensione.   
Tipo: stringa  
Valori validi: `VARCHAR`   
Campo obbligatorio: sì

 ** Name **   <a name="timestream-Type-query_DimensionMapping-Name"></a>
Nome della colonna dal risultato della query.  
Tipo: stringa  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DimensionMapping) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DimensionMapping) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DimensionMapping) 

# Endpoint
<a name="API_query_Endpoint"></a>

Rappresenta un endpoint disponibile verso il quale effettuare chiamate API, nonché il TTL per quell'endpoint.

## Indice
<a name="API_query_Endpoint_Contents"></a>

 ** Address **   <a name="timestream-Type-query_Endpoint-Address"></a>
Un indirizzo endpoint.  
Tipo: stringa  
Campo obbligatorio: sì

 ** CachePeriodInMinutes **   <a name="timestream-Type-query_Endpoint-CachePeriodInMinutes"></a>
Il TTL per l'endpoint, in minuti.  
Tipo: long  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Endpoint) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Endpoint) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Endpoint) 

# ErrorReportConfiguration
<a name="API_query_ErrorReportConfiguration"></a>

Configurazione richiesta per la segnalazione degli errori.

## Indice
<a name="API_query_ErrorReportConfiguration_Contents"></a>

 ** S3Configuration **   <a name="timestream-Type-query_ErrorReportConfiguration-S3Configuration"></a>
La configurazione S3 per la segnalazione degli errori.  
Tipo: oggetto [S3Configuration](API_query_S3Configuration.md)  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportConfiguration) 

# ErrorReportLocation
<a name="API_query_ErrorReportLocation"></a>

Contiene la posizione della segnalazione degli errori per una singola chiamata di interrogazione pianificata. 

## Indice
<a name="API_query_ErrorReportLocation_Contents"></a>

 ** S3ReportLocation **   <a name="timestream-Type-query_ErrorReportLocation-S3ReportLocation"></a>
La posizione S3 in cui vengono scritte le segnalazioni di errore.  
Tipo: oggetto [S3ReportLocation](API_query_S3ReportLocation.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportLocation) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportLocation) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportLocation) 

# ExecutionStats
<a name="API_query_ExecutionStats"></a>

Statistiche per una singola esecuzione di query pianificata.

## Indice
<a name="API_query_ExecutionStats_Contents"></a>

 ** BytesMetered **   <a name="timestream-Type-query_ExecutionStats-BytesMetered"></a>
Byte misurati per una singola esecuzione di query pianificata.  
Tipo: long  
Campo obbligatorio: no

 ** CumulativeBytesScanned **   <a name="timestream-Type-query_ExecutionStats-CumulativeBytesScanned"></a>
Byte analizzati per una singola esecuzione di una query pianificata.  
Tipo: long  
Campo obbligatorio: no

 ** DataWrites **   <a name="timestream-Type-query_ExecutionStats-DataWrites"></a>
Le scritture dei dati vengono misurate per i record inseriti in una singola esecuzione di query pianificata.  
Tipo: long  
Campo obbligatorio: no

 ** ExecutionTimeInMillis **   <a name="timestream-Type-query_ExecutionStats-ExecutionTimeInMillis"></a>
Tempo totale, misurato in millisecondi, necessario per il completamento dell'esecuzione della query pianificata.  
Tipo: long  
Campo obbligatorio: no

 ** QueryResultRows **   <a name="timestream-Type-query_ExecutionStats-QueryResultRows"></a>
Numero di righe presenti nell'output dell'esecuzione di una query prima dell'inserimento nell'origine dati di destinazione.  
Tipo: long  
Campo obbligatorio: no

 ** RecordsIngested **   <a name="timestream-Type-query_ExecutionStats-RecordsIngested"></a>
Il numero di record acquisiti per una singola esecuzione di query pianificata.   
Tipo: long  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecutionStats) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecutionStats) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecutionStats) 

# LastUpdate
<a name="API_query_LastUpdate"></a>

Oggetto di configurazione che contiene l'aggiornamento più recente delle impostazioni dell'account, visibile solo se le impostazioni sono state aggiornate in precedenza.

## Indice
<a name="API_query_LastUpdate_Contents"></a>

 ** Status **   <a name="timestream-Type-query_LastUpdate-Status"></a>
Lo stato dell'ultimo aggiornamento. Può essere uno dei due `PENDING``FAILED`, o`SUCCEEDED`.  
Tipo: stringa  
Valori validi: `PENDING | FAILED | SUCCEEDED`   
Campo obbligatorio: no

 ** StatusMessage **   <a name="timestream-Type-query_LastUpdate-StatusMessage"></a>
Messaggio di errore che descrive lo stato dell'ultimo aggiornamento delle impostazioni dell'account, visibile solo se si è verificato un errore.  
Tipo: string  
Campo obbligatorio: no

 ** TargetQueryTCU **   <a name="timestream-Type-query_LastUpdate-TargetQueryTCU"></a>
Il numero di unità di TimeStream calcolo (TCUs) richieste nell'ultimo aggiornamento delle impostazioni dell'account.  
Tipo: integer  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/LastUpdate) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/LastUpdate) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/LastUpdate) 

# MixedMeasureMapping
<a name="API_query_MixedMeasureMapping"></a>

MixedMeasureMappings sono mappature che possono essere utilizzate per inserire dati in una combinazione di misure ristrette e multiple nella tabella derivata.

## Indice
<a name="API_query_MixedMeasureMapping_Contents"></a>

 ** MeasureValueType **   <a name="timestream-Type-query_MixedMeasureMapping-MeasureValueType"></a>
Tipo del valore che deve essere letto da sourceColumn. Se la mappatura è per MULTI, usa .MULTI. MeasureValueType  
Tipo: stringa  
Valori validi: `BIGINT | BOOLEAN | DOUBLE | VARCHAR | MULTI`   
Campo obbligatorio: sì

 ** MeasureName **   <a name="timestream-Type-query_MixedMeasureMapping-MeasureName"></a>
Fa riferimento al valore measure\$1name in una riga dei risultati. Questo campo è obbligatorio se fornito. MeasureNameColumn   
Tipo: string  
Campo obbligatorio: no

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-query_MixedMeasureMapping-MultiMeasureAttributeMappings"></a>
Obbligatorio quando measureValueType è MULTI. Mappature di attributi per le misure del valore MULTI.  
Tipo: matrice di oggetti [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md)  
Membri dell’array: numero minimo di 1 elemento.  
Campo obbligatorio: no

 ** SourceColumn **   <a name="timestream-Type-query_MixedMeasureMapping-SourceColumn"></a>
Questo campo fa riferimento alla colonna di origine da cui deve essere letto measure-value per la materializzazione del risultato.  
Tipo: string  
Campo obbligatorio: no

 ** TargetMeasureName **   <a name="timestream-Type-query_MixedMeasureMapping-TargetMeasureName"></a>
Nome della misura di destinazione da utilizzare. Se non viene fornito, il nome della misura di destinazione per impostazione predefinita sarà measure-name se fornito, o sourceColumn in caso contrario.   
Tipo: string  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MixedMeasureMapping) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MixedMeasureMapping) 

# MultiMeasureAttributeMapping
<a name="API_query_MultiMeasureAttributeMapping"></a>

Mappatura degli attributi per misure del valore MULTI.

## Indice
<a name="API_query_MultiMeasureAttributeMapping_Contents"></a>

 ** MeasureValueType **   <a name="timestream-Type-query_MultiMeasureAttributeMapping-MeasureValueType"></a>
Tipo dell'attributo da leggere dalla colonna di origine.  
Tipo: stringa  
Valori validi: `BIGINT | BOOLEAN | DOUBLE | VARCHAR | TIMESTAMP`   
Campo obbligatorio: sì

 ** SourceColumn **   <a name="timestream-Type-query_MultiMeasureAttributeMapping-SourceColumn"></a>
Colonna di origine da cui deve essere letto il valore dell'attributo.  
Tipo: stringa  
Campo obbligatorio: sì

 ** TargetMultiMeasureAttributeName **   <a name="timestream-Type-query_MultiMeasureAttributeMapping-TargetMultiMeasureAttributeName"></a>
Nome personalizzato da utilizzare per il nome dell'attributo nella tabella derivata. Se non viene fornito, verrà utilizzato il nome della colonna di origine.  
Tipo: string  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureAttributeMapping) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureAttributeMapping) 

# MultiMeasureMappings
<a name="API_query_MultiMeasureMappings"></a>

Deve essere fornito solo uno dei MixedMeasureMappings o MultiMeasureMappings deve essere fornito. MultiMeasureMappings può essere utilizzato per inserire dati come misure multiple nella tabella derivata.

## Indice
<a name="API_query_MultiMeasureMappings_Contents"></a>

 ** MultiMeasureAttributeMappings **   <a name="timestream-Type-query_MultiMeasureMappings-MultiMeasureAttributeMappings"></a>
Obbligatorio. Mappature di attributi da utilizzare per mappare i risultati delle query per l'acquisizione di dati per attributi con più misure.  
Tipo: matrice di oggetti [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md)  
Membri dell’array: numero minimo di 1 elemento.  
Campo obbligatorio: sì

 ** TargetMultiMeasureName **   <a name="timestream-Type-query_MultiMeasureMappings-TargetMultiMeasureName"></a>
Il nome del nome con più misure di destinazione nella tabella derivata. Questo input è obbligatorio quando non measureNameColumn viene fornito. Se MeasureNameColumn viene fornito, il valore di quella colonna verrà utilizzato come nome multimisura.  
Tipo: string  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureMappings) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureMappings) 

# NotificationConfiguration
<a name="API_query_NotificationConfiguration"></a>

Configurazione della notifica per una query pianificata. Viene inviata una notifica da Timestream quando una query pianificata viene creata, il suo stato viene aggiornato o quando viene eliminata. 

## Indice
<a name="API_query_NotificationConfiguration_Contents"></a>

 ** SnsConfiguration **   <a name="timestream-Type-query_NotificationConfiguration-SnsConfiguration"></a>
Dettagli sulla configurazione di Amazon Simple Notification Service (SNS). Questo campo è visibile solo quando viene fornito un argomento SNS durante l'aggiornamento delle impostazioni dell'account.   
Tipo: oggetto [SnsConfiguration](API_query_SnsConfiguration.md)  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/NotificationConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/NotificationConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/NotificationConfiguration) 

# ParameterMapping
<a name="API_query_ParameterMapping"></a>

Mappatura per parametri denominati.

## Indice
<a name="API_query_ParameterMapping_Contents"></a>

 ** Name **   <a name="timestream-Type-query_ParameterMapping-Name"></a>
Nome del parametro.  
Tipo: stringa  
Campo obbligatorio: sì

 ** Type **   <a name="timestream-Type-query_ParameterMapping-Type"></a>
Contiene il tipo di dati di una colonna in un set di risultati di query. Il tipo di dati può essere scalare o complesso. I tipi di dati scalari supportati sono numeri interi, booleani, string, double, timestamp, date, time e intervalli. I tipi di dati complessi supportati sono matrici, righe e serie temporali.  
Tipo: oggetto [Type](API_query_Type.md)  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ParameterMapping) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ParameterMapping) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ParameterMapping) 

# ProvisionedCapacityRequest
<a name="API_query_ProvisionedCapacityRequest"></a>

Una richiesta di aggiornamento delle impostazioni di capacità fornite per l'interrogazione dei dati.

## Indice
<a name="API_query_ProvisionedCapacityRequest_Contents"></a>

 ** TargetQueryTCU **   <a name="timestream-Type-query_ProvisionedCapacityRequest-TargetQueryTCU"></a>
La capacità di calcolo di destinazione per l'interrogazione dei dati, specificata in Timestream Compute Units (). TCUs  
Tipo: integer  
Campo obbligatorio: sì

 ** NotificationConfiguration **   <a name="timestream-Type-query_ProvisionedCapacityRequest-NotificationConfiguration"></a>
Impostazioni di configurazione per le notifiche relative all'aggiornamento della capacità fornita.  
Tipo: oggetto [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityRequest) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityRequest) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityRequest) 

# ProvisionedCapacityResponse
<a name="API_query_ProvisionedCapacityResponse"></a>

La risposta a una richiesta di aggiornamento delle impostazioni di capacità fornite per l'interrogazione dei dati.

## Indice
<a name="API_query_ProvisionedCapacityResponse_Contents"></a>

 ** ActiveQueryTCU **   <a name="timestream-Type-query_ProvisionedCapacityResponse-ActiveQueryTCU"></a>
Il numero di unità di calcolo Timestream (TCUs) fornite nell'account. Questo campo è visibile solo quando la modalità di calcolo è. `PROVISIONED`  
Tipo: integer  
Campo obbligatorio: no

 ** LastUpdate **   <a name="timestream-Type-query_ProvisionedCapacityResponse-LastUpdate"></a>
Informazioni sull'ultimo aggiornamento delle impostazioni di capacità fornite.  
Tipo: oggetto [LastUpdate](API_query_LastUpdate.md)  
Campo obbligatorio: no

 ** NotificationConfiguration **   <a name="timestream-Type-query_ProvisionedCapacityResponse-NotificationConfiguration"></a>
Un oggetto che contiene le impostazioni per le notifiche che vengono inviate ogni volta che le impostazioni della capacità fornita vengono modificate. Questo campo è visibile solo quando la modalità di calcolo è. `PROVISIONED`  
Tipo: oggetto [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityResponse) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityResponse) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityResponse) 

# QueryComputeRequest
<a name="API_query_QueryComputeRequest"></a>

Una richiesta di recupero o aggiornamento delle impostazioni della capacità di calcolo per l'interrogazione dei dati. QueryCompute è disponibile solo nella regione Asia Pacifico (Mumbai).

## Indice
<a name="API_query_QueryComputeRequest_Contents"></a>

 ** ComputeMode **   <a name="timestream-Type-query_QueryComputeRequest-ComputeMode"></a>
La modalità in cui le unità di calcolo Timestream (TCUs) vengono allocate e utilizzate all'interno di un account. Tieni presente che nella regione Asia Pacifico (Mumbai), l'operazione API riconosce solo il valore. `PROVISIONED` QueryCompute è disponibile solo nella regione Asia Pacifico (Mumbai).  
Tipo: stringa  
Valori validi: `ON_DEMAND | PROVISIONED`   
Campo obbligatorio: no

 ** ProvisionedCapacity **   <a name="timestream-Type-query_QueryComputeRequest-ProvisionedCapacity"></a>
Oggetto di configurazione che contiene le impostazioni per le unità di calcolo Timestream () TCUs fornite nell'account. QueryCompute è disponibile solo nella regione Asia Pacifico (Mumbai).  
Tipo: oggetto [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeRequest) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeRequest) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeRequest) 

# QueryComputeResponse
<a name="API_query_QueryComputeResponse"></a>

La risposta a una richiesta di recupero o aggiornamento delle impostazioni della capacità di calcolo per l'interrogazione dei dati. QueryCompute è disponibile solo nella regione Asia Pacifico (Mumbai).

## Indice
<a name="API_query_QueryComputeResponse_Contents"></a>

 ** ComputeMode **   <a name="timestream-Type-query_QueryComputeResponse-ComputeMode"></a>
La modalità in cui le unità di calcolo Timestream (TCUs) vengono allocate e utilizzate all'interno di un account. Tieni presente che nella regione Asia Pacifico (Mumbai), l'operazione API riconosce solo il valore. `PROVISIONED` QueryCompute è disponibile solo nella regione Asia Pacifico (Mumbai).  
Tipo: stringa  
Valori validi: `ON_DEMAND | PROVISIONED`   
Campo obbligatorio: no

 ** ProvisionedCapacity **   <a name="timestream-Type-query_QueryComputeResponse-ProvisionedCapacity"></a>
Oggetto di configurazione che contiene le impostazioni per le unità di calcolo Timestream () TCUs fornite nell'account. QueryCompute è disponibile solo nella regione Asia Pacifico (Mumbai).  
Tipo: oggetto [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeResponse) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeResponse) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeResponse) 

# QueryInsights
<a name="API_query_QueryInsights"></a>

 `QueryInsights`è una funzionalità di ottimizzazione delle prestazioni che consente di ottimizzare le query, ridurre i costi e migliorare le prestazioni. Con`QueryInsights`, è possibile valutare l'efficienza di ottimizzazione delle query e identificare le aree di miglioramento per migliorare le prestazioni delle query. Con`QueryInsights`, puoi anche analizzare l'efficacia delle tue query in termini di riduzione temporale e spaziale e identificare opportunità per migliorare le prestazioni. In particolare, è possibile valutare in che modo le query utilizzano strategie di indicizzazione basate sul tempo e su chiavi di partizione per ottimizzare il recupero dei dati. Per ottimizzare le prestazioni delle query, è essenziale ottimizzare i parametri temporali e spaziali che regolano l'esecuzione delle query.

Le metriche chiave fornite da sono e. `QueryInsights` `QuerySpatialCoverage` `QueryTemporalRange` `QuerySpatialCoverage`indica la parte dell'asse spaziale scansionata dalla query, mentre i valori più bassi sono più efficienti. `QueryTemporalRange`mostra l'intervallo di tempo scansionato, con intervalli più stretti che offrono prestazioni migliori.

 **Vantaggi di QueryInsights** 

Di seguito sono riportati i principali vantaggi dell'utilizzo`QueryInsights`:
+  **Identificazione delle query inefficienti**: `QueryInsights` fornisce informazioni sull'eliminazione basata sul tempo e sugli attributi delle tabelle a cui accede la query. Queste informazioni consentono di identificare le tabelle a cui si accede in modo non ottimale.
+  **Ottimizzazione del modello di dati e del partizionamento**: è possibile utilizzare `QueryInsights` le informazioni per accedere e perfezionare il modello di dati e la strategia di partizionamento.
+  **Ottimizzazione delle query: evidenzia le opportunità di utilizzare gli indici** in modo più efficace. `QueryInsights`

**Nota**  
Il numero massimo di richieste `Query` API che puoi effettuare con `QueryInsights` enabled è 1 query al secondo (QPS). Se superi questa frequenza di query, potrebbe verificarsi una limitazione.

## Indice
<a name="API_query_QueryInsights_Contents"></a>

 ** Mode **   <a name="timestream-Type-query_QueryInsights-Mode"></a>
Fornisce le seguenti modalità da abilitare: `QueryInsights`  
+  `ENABLED_WITH_RATE_CONTROL`— Abilita `QueryInsights` l'elaborazione delle interrogazioni. Questa modalità include anche un meccanismo di controllo della velocità, che limita la `QueryInsights` funzionalità a 1 query al secondo (QPS).
+  `DISABLED`— `QueryInsights` Disattiva.
Tipo: stringa  
Valori validi: `ENABLED_WITH_RATE_CONTROL | DISABLED`   
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsights) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsights) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsights) 

# QueryInsightsResponse
<a name="API_query_QueryInsightsResponse"></a>

Fornisce varie informazioni e metriche relative alla query che hai eseguito.

## Indice
<a name="API_query_QueryInsightsResponse_Contents"></a>

 ** OutputBytes **   <a name="timestream-Type-query_QueryInsightsResponse-OutputBytes"></a>
Indica la dimensione del set di risultati della query in byte. È possibile utilizzare questi dati per verificare se il set di risultati è stato modificato nell'ambito dell'esercizio di ottimizzazione delle query.  
Tipo: long  
Campo obbligatorio: no

 ** OutputRows **   <a name="timestream-Type-query_QueryInsightsResponse-OutputRows"></a>
Indica il numero totale di righe restituite come parte del set di risultati della query. È possibile utilizzare questi dati per verificare se il numero di righe nel set di risultati è cambiato nell'ambito dell'esercizio di ottimizzazione delle query.  
Tipo: long  
Campo obbligatorio: no

 ** QuerySpatialCoverage **   <a name="timestream-Type-query_QueryInsightsResponse-QuerySpatialCoverage"></a>
Fornisce informazioni sulla copertura spaziale dell'interrogazione, inclusa la tabella con una potatura spaziale non ottimale (massima). Queste informazioni possono aiutarvi a identificare le aree da migliorare nella vostra strategia di partizionamento per migliorare la potatura spaziale.   
Tipo: oggetto [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md)  
Campo obbligatorio: no

 ** QueryTableCount **   <a name="timestream-Type-query_QueryInsightsResponse-QueryTableCount"></a>
Indica il numero di tabelle nell'interrogazione.  
Tipo: long  
Campo obbligatorio: no

 ** QueryTemporalRange **   <a name="timestream-Type-query_QueryInsightsResponse-QueryTemporalRange"></a>
Fornisce informazioni sull'intervallo temporale della query, inclusa la tabella con l'intervallo di tempo più ampio (massimo). Di seguito sono riportate alcune delle potenziali opzioni per ottimizzare la potatura basata sul tempo:  
+ Aggiungi i predicati temporali mancanti.
+ Rimuovi le funzioni relative ai predicati temporali.
+ Aggiungi predicati temporali a tutte le sottoquery.
Tipo: oggetto [QueryTemporalRange](API_query_QueryTemporalRange.md)  
Campo obbligatorio: no

 ** UnloadPartitionCount **   <a name="timestream-Type-query_QueryInsightsResponse-UnloadPartitionCount"></a>
Indica le partizioni create dall'operazione. `Unload`  
Tipo: long  
Campo obbligatorio: no

 ** UnloadWrittenBytes **   <a name="timestream-Type-query_QueryInsightsResponse-UnloadWrittenBytes"></a>
Indica la dimensione, in byte, scritta dall'`Unload`operazione.  
Tipo: long  
Campo obbligatorio: no

 ** UnloadWrittenRows **   <a name="timestream-Type-query_QueryInsightsResponse-UnloadWrittenRows"></a>
Indica le righe scritte dall'`Unload`interrogazione.  
Tipo: long  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsightsResponse) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsightsResponse) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsightsResponse) 

# QuerySpatialCoverage
<a name="API_query_QuerySpatialCoverage"></a>

Fornisce informazioni sulla copertura spaziale della query, inclusa la tabella con una potatura spaziale non ottimale (massima). Queste informazioni possono aiutarvi a identificare le aree da migliorare nella vostra strategia di partizionamento per migliorare la potatura spaziale

Ad esempio, puoi fare quanto segue con le informazioni: `QuerySpatialCoverage`
+ Aggiungi measure\$1name o usa i predicati della [chiave di partizione definita dal cliente](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html) (CDPK).
+ Se hai già eseguito l'azione precedente, rimuovi le funzioni o le clausole che li circondano, ad esempio. `LIKE`

## Indice
<a name="API_query_QuerySpatialCoverage_Contents"></a>

 ** Max **   <a name="timestream-Type-query_QuerySpatialCoverage-Max"></a>
Fornisce informazioni sulla copertura spaziale della query eseguita e della tabella con la riduzione spaziale più inefficiente.  
+  `Value`— Il rapporto massimo di copertura spaziale.
+  `TableArn`— L'Amazon Resource Name (ARN) della tabella con potatura spaziale non ottimale.
+  `PartitionKey`— La chiave di partizione utilizzata per il partizionamento, che può essere predefinita o CDPK. `measure_name`
Tipo: oggetto [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverage) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverage) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverage) 

# QuerySpatialCoverageMax
<a name="API_query_QuerySpatialCoverageMax"></a>

Fornisce informazioni dettagliate sulla tabella con l'intervallo spaziale meno ottimale analizzato dalla query.

## Indice
<a name="API_query_QuerySpatialCoverageMax_Contents"></a>

 ** PartitionKey **   <a name="timestream-Type-query_QuerySpatialCoverageMax-PartitionKey"></a>
[La chiave di partizione utilizzata per il partizionamento, che può essere una chiave di partizione predefinita `measure_name` o definita dal cliente.](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html)  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** TableArn **   <a name="timestream-Type-query_QuerySpatialCoverageMax-TableArn"></a>
L'Amazon Resource Name (ARN) della tabella con la potatura spaziale meno ottimale.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: no

 ** Value **   <a name="timestream-Type-query_QuerySpatialCoverageMax-Value"></a>
Il rapporto massimo di copertura spaziale.  
Tipo: double  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverageMax) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverageMax) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverageMax) 

# QueryStatus
<a name="API_query_QueryStatus"></a>

Informazioni sullo stato della query, inclusi lo stato di avanzamento e i byte scansionati.

## Indice
<a name="API_query_QueryStatus_Contents"></a>

 ** CumulativeBytesMetered **   <a name="timestream-Type-query_QueryStatus-CumulativeBytesMetered"></a>
La quantità di dati analizzati dalla query, espressa in byte, per la quale ti verrà addebitato il costo. Si tratta di una somma cumulativa e rappresenta la quantità totale di dati che ti verrà addebitata dall'avvio della query. L'addebito viene applicato una sola volta e viene applicato al termine dell'esecuzione della query o quando la query viene annullata.   
Tipo: long  
Campo obbligatorio: no

 ** CumulativeBytesScanned **   <a name="timestream-Type-query_QueryStatus-CumulativeBytesScanned"></a>
La quantità di dati analizzati dalla query in byte. Si tratta di una somma cumulativa e rappresenta la quantità totale di byte analizzati dall'avvio della query.   
Tipo: long  
Campo obbligatorio: no

 ** ProgressPercentage **   <a name="timestream-Type-query_QueryStatus-ProgressPercentage"></a>
L'avanzamento della query, espresso in percentuale.  
Tipo: double  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryStatus) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryStatus) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryStatus) 

# QueryTemporalRange
<a name="API_query_QueryTemporalRange"></a>

Fornisce informazioni sull'intervallo temporale della query, inclusa la tabella con l'intervallo di tempo più ampio (massimo).

## Indice
<a name="API_query_QueryTemporalRange_Contents"></a>

 ** Max **   <a name="timestream-Type-query_QueryTemporalRange-Max"></a>
Incapsula le seguenti proprietà che forniscono informazioni sulla tabella con prestazioni meno ottimali sull'asse temporale:  
+  `Value`— La durata massima in nanosecondi tra l'inizio e la fine della query.
+  `TableArn`— L'Amazon Resource Name (ARN) della tabella su cui viene eseguita la query con l'intervallo di tempo più ampio.
Tipo: oggetto [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRange) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRange) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRange) 

# QueryTemporalRangeMax
<a name="API_query_QueryTemporalRangeMax"></a>

Fornisce informazioni dettagliate sulla tabella con la riduzione temporale meno ottimale analizzata dalla query.

## Indice
<a name="API_query_QueryTemporalRangeMax_Contents"></a>

 ** TableArn **   <a name="timestream-Type-query_QueryTemporalRangeMax-TableArn"></a>
L'Amazon Resource Name (ARN) della tabella su cui viene eseguita la query con l'intervallo di tempo più ampio.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: no

 ** Value **   <a name="timestream-Type-query_QueryTemporalRangeMax-Value"></a>
La durata massima in nanosecondi tra l'inizio e la fine della query.  
Tipo: long  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRangeMax) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRangeMax) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRangeMax) 

# Row
<a name="API_query_Row"></a>

Rappresenta una singola riga nei risultati della query.

## Indice
<a name="API_query_Row_Contents"></a>

 ** Data **   <a name="timestream-Type-query_Row-Data"></a>
Elenco di punti dati in una singola riga del set di risultati.  
Tipo: matrice di oggetti [Datum](API_query_Datum.md)  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Row) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Row) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Row) 

# S3Configuration
<a name="API_query_S3Configuration"></a>

Dettagli sulla posizione S3 per le segnalazioni di errore risultanti dall'esecuzione di una query. 

## Indice
<a name="API_query_S3Configuration_Contents"></a>

 ** BucketName **   <a name="timestream-Type-query_S3Configuration-BucketName"></a>
 Nome del bucket S3 in cui verranno creati le segnalazioni di errore.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 63 caratteri.  
Modello: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Campo obbligatorio: sì

 ** EncryptionOption **   <a name="timestream-Type-query_S3Configuration-EncryptionOption"></a>
 Opzioni di crittografia dei dati inattivi per le segnalazioni di errore. Se non viene specificata alcuna opzione di crittografia, Timestream sceglierà SSE\$1S3 come impostazione predefinita.   
Tipo: stringa  
Valori validi: `SSE_S3 | SSE_KMS`   
Campo obbligatorio: no

 ** ObjectKeyPrefix **   <a name="timestream-Type-query_S3Configuration-ObjectKeyPrefix"></a>
 Prefisso per la chiave di segnalazione degli errori. Timestream per impostazione predefinita aggiunge il seguente prefisso al percorso della segnalazione degli errori.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 896.  
Modello: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3Configuration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3Configuration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3Configuration) 

# S3ReportLocation
<a name="API_query_S3ReportLocation"></a>

 Posizione del report S3 per l'esecuzione della query pianificata.

## Indice
<a name="API_query_S3ReportLocation_Contents"></a>

 ** BucketName **   <a name="timestream-Type-query_S3ReportLocation-BucketName"></a>
 Nome bucket S3.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 63 caratteri.  
Modello: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Campo obbligatorio: no

 ** ObjectKey **   <a name="timestream-Type-query_S3ReportLocation-ObjectKey"></a>
Chiave S3.   
Tipo: string  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3ReportLocation) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3ReportLocation) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3ReportLocation) 

# ScheduleConfiguration
<a name="API_query_ScheduleConfiguration"></a>

Configurazione della pianificazione della query.

## Indice
<a name="API_query_ScheduleConfiguration_Contents"></a>

 ** ScheduleExpression **   <a name="timestream-Type-query_ScheduleConfiguration-ScheduleExpression"></a>
Un'espressione che indica quando attivare l'esecuzione pianificata della query. Può essere un'espressione cron o un'espressione rate.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduleConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduleConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduleConfiguration) 

# ScheduledQuery
<a name="API_query_ScheduledQuery"></a>

Query pianificata

## Indice
<a name="API_query_ScheduledQuery_Contents"></a>

 ** Arn **   <a name="timestream-Type-query_ScheduledQuery-Arn"></a>
Il nome della risorsa Amazon.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: sì

 ** Name **   <a name="timestream-Type-query_ScheduledQuery-Name"></a>
Il nome della query pianificata.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Campo obbligatorio: sì

 ** State **   <a name="timestream-Type-query_ScheduledQuery-State"></a>
Stato dell'interrogazione pianificata.   
Tipo: stringa  
Valori validi: `ENABLED | DISABLED`   
Campo obbligatorio: sì

 ** CreationTime **   <a name="timestream-Type-query_ScheduledQuery-CreationTime"></a>
L'ora di creazione dell'interrogazione pianificata.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** ErrorReportConfiguration **   <a name="timestream-Type-query_ScheduledQuery-ErrorReportConfiguration"></a>
Configurazione per la segnalazione degli errori delle query pianificate.  
Tipo: oggetto [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Campo obbligatorio: no

 ** LastRunStatus **   <a name="timestream-Type-query_ScheduledQuery-LastRunStatus"></a>
Stato dell'ultima esecuzione pianificata della query.  
Tipo: stringa  
Valori validi: `AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE`   
Campo obbligatorio: no

 ** NextInvocationTime **   <a name="timestream-Type-query_ScheduledQuery-NextInvocationTime"></a>
La prossima volta che verrà eseguita la query pianificata.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** PreviousInvocationTime **   <a name="timestream-Type-query_ScheduledQuery-PreviousInvocationTime"></a>
L'ultima volta che è stata eseguita la query pianificata.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** TargetDestination **   <a name="timestream-Type-query_ScheduledQuery-TargetDestination"></a>
Fonte di dati di destinazione in cui verrà scritto il risultato finale della query pianificata.  
Tipo: oggetto [TargetDestination](API_query_TargetDestination.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQuery) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQuery) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQuery) 

# ScheduledQueryDescription
<a name="API_query_ScheduledQueryDescription"></a>

Struttura che descrive l'interrogazione pianificata.

## Indice
<a name="API_query_ScheduledQueryDescription_Contents"></a>

 ** Arn **   <a name="timestream-Type-query_ScheduledQueryDescription-Arn"></a>
ARN di interrogazione pianificata.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: sì

 ** Name **   <a name="timestream-Type-query_ScheduledQueryDescription-Name"></a>
Nome dell'interrogazione pianificata.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Campo obbligatorio: sì

 ** NotificationConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-NotificationConfiguration"></a>
Configurazione delle notifiche.  
Tipo: oggetto [NotificationConfiguration](API_query_NotificationConfiguration.md)  
Campo obbligatorio: sì

 ** QueryString **   <a name="timestream-Type-query_ScheduledQueryDescription-QueryString"></a>
La query da eseguire.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 262144.  
Campo obbligatorio: sì

 ** ScheduleConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-ScheduleConfiguration"></a>
Configurazione della pianificazione.  
Tipo: oggetto [ScheduleConfiguration](API_query_ScheduleConfiguration.md)  
Campo obbligatorio: sì

 ** State **   <a name="timestream-Type-query_ScheduledQueryDescription-State"></a>
Stato dell'interrogazione pianificata.   
Tipo: stringa  
Valori validi: `ENABLED | DISABLED`   
Campo obbligatorio: sì

 ** CreationTime **   <a name="timestream-Type-query_ScheduledQueryDescription-CreationTime"></a>
Ora di creazione dell'interrogazione pianificata.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** ErrorReportConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-ErrorReportConfiguration"></a>
Configurazione per la segnalazione degli errori per l'interrogazione pianificata.  
Tipo: oggetto [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Campo obbligatorio: no

 ** KmsKeyId **   <a name="timestream-Type-query_ScheduledQueryDescription-KmsKeyId"></a>
Una chiave KMS fornita dal cliente e utilizzata per crittografare la risorsa di interrogazione pianificata.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: no

 ** LastRunSummary **   <a name="timestream-Type-query_ScheduledQueryDescription-LastRunSummary"></a>
Riepilogo del runtime per l'ultima esecuzione pianificata della query.   
Tipo: oggetto [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md)  
Campo obbligatorio: no

 ** NextInvocationTime **   <a name="timestream-Type-query_ScheduledQueryDescription-NextInvocationTime"></a>
La prossima volta che viene pianificata l'esecuzione della query pianificata.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** PreviousInvocationTime **   <a name="timestream-Type-query_ScheduledQueryDescription-PreviousInvocationTime"></a>
L'ultima volta che è stata eseguita la query.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** RecentlyFailedRuns **   <a name="timestream-Type-query_ScheduledQueryDescription-RecentlyFailedRuns"></a>
Riepilogo del runtime per le ultime cinque interrogazioni pianificate non riuscite.  
Tipo: matrice di oggetti [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md)  
Campo obbligatorio: no

 ** ScheduledQueryExecutionRoleArn **   <a name="timestream-Type-query_ScheduledQueryDescription-ScheduledQueryExecutionRoleArn"></a>
Ruolo IAM utilizzato da Timestream per eseguire la query di pianificazione.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: no

 ** TargetConfiguration **   <a name="timestream-Type-query_ScheduledQueryDescription-TargetConfiguration"></a>
Configurazione dell'archivio di destinazione delle query pianificate.  
Tipo: oggetto [TargetConfiguration](API_query_TargetConfiguration.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryDescription) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryDescription) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryDescription) 

# ScheduledQueryInsights
<a name="API_query_ScheduledQueryInsights"></a>

Incapsula le impostazioni per l'attivazione `QueryInsights` su un. `ExecuteScheduledQueryRequest`

## Indice
<a name="API_query_ScheduledQueryInsights_Contents"></a>

 ** Mode **   <a name="timestream-Type-query_ScheduledQueryInsights-Mode"></a>
Fornisce le seguenti modalità da abilitare: `ScheduledQueryInsights`  
+  `ENABLED_WITH_RATE_CONTROL`— Abilita `ScheduledQueryInsights` l'elaborazione delle interrogazioni. Questa modalità include anche un meccanismo di controllo della velocità, che limita la `QueryInsights` funzionalità a 1 query al secondo (QPS).
+  `DISABLED`— Disabilita`ScheduledQueryInsights`.
Tipo: stringa  
Valori validi: `ENABLED_WITH_RATE_CONTROL | DISABLED`   
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsights) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsights) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsights) 

# ScheduledQueryInsightsResponse
<a name="API_query_ScheduledQueryInsightsResponse"></a>

Fornisce varie informazioni e metriche relative a `ExecuteScheduledQueryRequest` ciò che è stato eseguito.

## Indice
<a name="API_query_ScheduledQueryInsightsResponse_Contents"></a>

 ** OutputBytes **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-OutputBytes"></a>
Indica la dimensione del set di risultati della query in byte. È possibile utilizzare questi dati per verificare se il set di risultati è stato modificato nell'ambito dell'esercizio di ottimizzazione delle query.  
Tipo: long  
Campo obbligatorio: no

 ** OutputRows **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-OutputRows"></a>
Indica il numero totale di righe restituite come parte del set di risultati della query. È possibile utilizzare questi dati per verificare se il numero di righe nel set di risultati è cambiato nell'ambito dell'esercizio di ottimizzazione delle query.  
Tipo: long  
Campo obbligatorio: no

 ** QuerySpatialCoverage **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-QuerySpatialCoverage"></a>
Fornisce informazioni sulla copertura spaziale dell'interrogazione, inclusa la tabella con una potatura spaziale non ottimale (massima). Queste informazioni possono aiutarvi a identificare le aree da migliorare nella vostra strategia di partizionamento per migliorare la potatura spaziale.  
Tipo: oggetto [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md)  
Campo obbligatorio: no

 ** QueryTableCount **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-QueryTableCount"></a>
Indica il numero di tabelle nell'interrogazione.  
Tipo: long  
Campo obbligatorio: no

 ** QueryTemporalRange **   <a name="timestream-Type-query_ScheduledQueryInsightsResponse-QueryTemporalRange"></a>
Fornisce informazioni sull'intervallo temporale della query, inclusa la tabella con l'intervallo di tempo più ampio (massimo). Di seguito sono riportate alcune delle potenziali opzioni per ottimizzare la potatura basata sul tempo:  
+ Aggiungi i predicati temporali mancanti.
+ Rimuovi le funzioni relative ai predicati temporali.
+ Aggiungi predicati temporali a tutte le sottoquery.
Tipo: oggetto [QueryTemporalRange](API_query_QueryTemporalRange.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) 

# ScheduledQueryRunSummary
<a name="API_query_ScheduledQueryRunSummary"></a>

Esegui il riepilogo per la query pianificata

## Indice
<a name="API_query_ScheduledQueryRunSummary_Contents"></a>

 ** ErrorReportLocation **   <a name="timestream-Type-query_ScheduledQueryRunSummary-ErrorReportLocation"></a>
Posizione S3 per la segnalazione degli errori.  
Tipo: oggetto [ErrorReportLocation](API_query_ErrorReportLocation.md)  
Campo obbligatorio: no

 ** ExecutionStats **   <a name="timestream-Type-query_ScheduledQueryRunSummary-ExecutionStats"></a>
Statistiche di runtime per un'esecuzione pianificata.  
Tipo: oggetto [ExecutionStats](API_query_ExecutionStats.md)  
Campo obbligatorio: no

 ** FailureReason **   <a name="timestream-Type-query_ScheduledQueryRunSummary-FailureReason"></a>
Messaggio di errore per l'interrogazione pianificata in caso di errore. Potrebbe essere necessario consultare il rapporto sugli errori per ottenere motivi di errore più dettagliati.   
Tipo: string  
Campo obbligatorio: no

 ** InvocationTime **   <a name="timestream-Type-query_ScheduledQueryRunSummary-InvocationTime"></a>
InvocationTime per questa corsa. Questa è l'ora in cui è pianificata l'esecuzione della query. Il parametro `@scheduled_runtime` può essere utilizzato nella query per ottenere il valore.   
Tipo: Timestamp  
Campo obbligatorio: no

 ** QueryInsightsResponse **   <a name="timestream-Type-query_ScheduledQueryRunSummary-QueryInsightsResponse"></a>
Fornisce varie informazioni e metriche relative al riepilogo dell'esecuzione della query pianificata.  
Tipo: oggetto [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md)  
Campo obbligatorio: no

 ** RunStatus **   <a name="timestream-Type-query_ScheduledQueryRunSummary-RunStatus"></a>
Lo stato dell'esecuzione di una query pianificata.  
Tipo: stringa  
Valori validi: `AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE`   
Campo obbligatorio: no

 ** TriggerTime **   <a name="timestream-Type-query_ScheduledQueryRunSummary-TriggerTime"></a>
L'ora effettiva in cui è stata eseguita la query.  
Tipo: Timestamp  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryRunSummary) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryRunSummary) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryRunSummary) 

# SelectColumn
<a name="API_query_SelectColumn"></a>

Dettagli della colonna restituita dalla query. 

## Indice
<a name="API_query_SelectColumn_Contents"></a>

 ** Aliased **   <a name="timestream-Type-query_SelectColumn-Aliased"></a>
Ha valore True, se la query ha utilizzato un alias per il nome della colonna. In caso contrario, falso.  
Tipo: Booleano  
Campo obbligatorio: no

 ** DatabaseName **   <a name="timestream-Type-query_SelectColumn-DatabaseName"></a>
 Database che contiene questa colonna.  
Tipo: string  
Campo obbligatorio: no

 ** Name **   <a name="timestream-Type-query_SelectColumn-Name"></a>
Nome della colonna.  
Tipo: string  
Campo obbligatorio: no

 ** TableName **   <a name="timestream-Type-query_SelectColumn-TableName"></a>
Tabella all'interno del database che contiene questa colonna.   
Tipo: string  
Campo obbligatorio: no

 ** Type **   <a name="timestream-Type-query_SelectColumn-Type"></a>
Contiene il tipo di dati di una colonna in un set di risultati di query. Il tipo di dati può essere scalare o complesso. I tipi di dati scalari supportati sono numeri interi, booleani, string, double, timestamp, date, time e intervalli. I tipi di dati complessi supportati sono matrici, righe e serie temporali.  
Tipo: oggetto [Type](API_query_Type.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SelectColumn) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SelectColumn) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SelectColumn) 

# SnsConfiguration
<a name="API_query_SnsConfiguration"></a>

Dettagli su SNS necessari per inviare la notifica.

## Indice
<a name="API_query_SnsConfiguration_Contents"></a>

 ** TopicArn **   <a name="timestream-Type-query_SnsConfiguration-TopicArn"></a>
ARN dell'argomento SNS a cui verranno inviate le notifiche sullo stato delle query pianificate.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SnsConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SnsConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SnsConfiguration) 

# Tag
<a name="API_query_Tag"></a>

Un tag è un'etichetta che si assegna alle and/or table. Each tag consists of a key and an optional value, both of which you define. Tags enable you to categorize databases and/or tabelle di un database Timestream, ad esempio per scopo, proprietario o ambiente. 

## Indice
<a name="API_query_Tag_Contents"></a>

 ** Key **   <a name="timestream-Type-query_Tag-Key"></a>
La chiave del tag. Le chiavi dei tag prevedono una distinzione tra lettere maiuscole e minuscole.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Campo obbligatorio: sì

 ** Value **   <a name="timestream-Type-query_Tag-Value"></a>
Il valore del tag. I valori dei tag fanno distinzione tra maiuscole e minuscole e possono essere nulli.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Tag) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Tag) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Tag) 

# TargetConfiguration
<a name="API_query_TargetConfiguration"></a>

Configurazione utilizzata per scrivere l'output di una query.

## Indice
<a name="API_query_TargetConfiguration_Contents"></a>

 ** TimestreamConfiguration **   <a name="timestream-Type-query_TargetConfiguration-TimestreamConfiguration"></a>
Configurazione necessaria per scrivere dati nel database e nella tabella Timestream.  
Tipo: oggetto [TimestreamConfiguration](API_query_TimestreamConfiguration.md)  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetConfiguration) 

# TargetDestination
<a name="API_query_TargetDestination"></a>

Dettagli sulla destinazione per scrivere dati per un'origine dati di destinazione. La fonte di dati attualmente supportata è Timestream.

## Indice
<a name="API_query_TargetDestination_Contents"></a>

 ** TimestreamDestination **   <a name="timestream-Type-query_TargetDestination-TimestreamDestination"></a>
Interroga i dettagli della destinazione dei risultati per l'origine dati Timestream.  
Tipo: oggetto [TimestreamDestination](API_query_TimestreamDestination.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetDestination) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetDestination) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetDestination) 

# TimeSeriesDataPoint
<a name="API_query_TimeSeriesDataPoint"></a>

Il tipo di dati timeseries rappresenta i valori di una misura nel tempo. Una serie temporale è una matrice di righe di timestamp e valori di misura, con righe ordinate in ordine crescente di tempo. A TimeSeriesDataPoint è un singolo punto dati nella serie temporale. Rappresenta una tupla di (tempo, valore di misura) in una serie temporale. 

## Indice
<a name="API_query_TimeSeriesDataPoint_Contents"></a>

 ** Time **   <a name="timestream-Type-query_TimeSeriesDataPoint-Time"></a>
Il timestamp in cui è stato raccolto il valore della misura.  
Tipo: stringa  
Campo obbligatorio: sì

 ** Value **   <a name="timestream-Type-query_TimeSeriesDataPoint-Value"></a>
Il valore di misura per il punto dati.  
Tipo: oggetto [Datum](API_query_Datum.md)  
Campo obbligatorio: sì

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimeSeriesDataPoint) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimeSeriesDataPoint) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimeSeriesDataPoint) 

# TimestreamConfiguration
<a name="API_query_TimestreamConfiguration"></a>

 Configurazione per scrivere dati nel database e nella tabella Timestream. Questa configurazione consente all'utente di mappare le colonne di selezione dei risultati della query nelle colonne della tabella di destinazione. 

## Indice
<a name="API_query_TimestreamConfiguration_Contents"></a>

 ** DatabaseName **   <a name="timestream-Type-query_TimestreamConfiguration-DatabaseName"></a>
Nome del database Timestream in cui verrà scritto il risultato della query.  
Tipo: stringa  
Campo obbligatorio: sì

 ** DimensionMappings **   <a name="timestream-Type-query_TimestreamConfiguration-DimensionMappings"></a>
 Consente di mappare le colonne dal risultato della query a una dimensione nella tabella di destinazione.   
Tipo: matrice di oggetti [DimensionMapping](API_query_DimensionMapping.md)  
Campo obbligatorio: sì

 ** TableName **   <a name="timestream-Type-query_TimestreamConfiguration-TableName"></a>
Nome della tabella Timestream in cui verrà scritto il risultato della query. La tabella deve trovarsi all'interno dello stesso database fornito nella configurazione Timestream.  
Tipo: stringa  
Campo obbligatorio: sì

 ** TimeColumn **   <a name="timestream-Type-query_TimestreamConfiguration-TimeColumn"></a>
Colonna dal risultato della query che deve essere utilizzata come colonna TIME nella tabella di destinazione. Il tipo di colonna per questo deve essere TIMESTAMP.  
Tipo: stringa  
Campo obbligatorio: sì

 ** MeasureNameColumn **   <a name="timestream-Type-query_TimestreamConfiguration-MeasureNameColumn"></a>
Nome della colonna delle misure.  
Tipo: string  
Campo obbligatorio: no

 ** MixedMeasureMappings **   <a name="timestream-Type-query_TimestreamConfiguration-MixedMeasureMappings"></a>
Specifica come mappare le misure ai record di più misure.  
Tipo: matrice di oggetti [MixedMeasureMapping](API_query_MixedMeasureMapping.md)  
Membri dell’array: numero minimo di 1 elemento.  
Campo obbligatorio: no

 ** MultiMeasureMappings **   <a name="timestream-Type-query_TimestreamConfiguration-MultiMeasureMappings"></a>
Mappatura a più misure.  
Tipo: oggetto [MultiMeasureMappings](API_query_MultiMeasureMappings.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamConfiguration) 

# TimestreamDestination
<a name="API_query_TimestreamDestination"></a>

Destinazione per l'interrogazione pianificata.

## Indice
<a name="API_query_TimestreamDestination_Contents"></a>

 ** DatabaseName **   <a name="timestream-Type-query_TimestreamDestination-DatabaseName"></a>
Nome del database Timestream.   
Tipo: string  
Campo obbligatorio: no

 ** TableName **   <a name="timestream-Type-query_TimestreamDestination-TableName"></a>
Nome della tabella Timestream.   
Tipo: string  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamDestination) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamDestination) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamDestination) 

# Type
<a name="API_query_Type"></a>

Contiene il tipo di dati di una colonna in un set di risultati di query. Il tipo di dati può essere scalare o complesso. I tipi di dati scalari supportati sono numeri interi, booleani, string, double, timestamp, date, time e intervalli. I tipi di dati complessi supportati sono matrici, righe e serie temporali.

## Indice
<a name="API_query_Type_Contents"></a>

 ** ArrayColumnInfo **   <a name="timestream-Type-query_Type-ArrayColumnInfo"></a>
Indica se la colonna è una matrice.  
Tipo: oggetto [ColumnInfo](API_query_ColumnInfo.md)  
Campo obbligatorio: no

 ** RowColumnInfo **   <a name="timestream-Type-query_Type-RowColumnInfo"></a>
Indica se la colonna è una riga.  
Tipo: matrice di oggetti [ColumnInfo](API_query_ColumnInfo.md)  
Campo obbligatorio: no

 ** ScalarType **   <a name="timestream-Type-query_Type-ScalarType"></a>
Indica se la colonna è di tipo string, integer, boolean, double, timestamp, date, time. [Per ulteriori informazioni, consulta Tipi di dati supportati.](https://docs.aws.amazon.com/timestream/latest/developerguide/supported-data-types.html)  
Tipo: stringa  
Valori validi: `VARCHAR | BOOLEAN | BIGINT | DOUBLE | TIMESTAMP | DATE | TIME | INTERVAL_DAY_TO_SECOND | INTERVAL_YEAR_TO_MONTH | UNKNOWN | INTEGER`   
Campo obbligatorio: no

 ** TimeSeriesMeasureValueColumnInfo **   <a name="timestream-Type-query_Type-TimeSeriesMeasureValueColumnInfo"></a>
Indica se la colonna è un tipo di dati di una serie temporale.  
Tipo: oggetto [ColumnInfo](API_query_ColumnInfo.md)  
Campo obbligatorio: no

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Type) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Type) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Type) 

# Errori comuni
<a name="CommonErrors"></a>

Questa sezione elenca gli errori comuni alle azioni API di tutti i AWS servizi. Per gli errori specifici di un'azione API per questo servizio, consulta l'argomento per quell'azione API.

 **AccessDeniedException**   
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.  
Codice di stato HTTP: 400

 **IncompleteSignature**   
La firma della richiesta non è conforme agli AWS standard.  
Codice di stato HTTP: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
L'elaborazione della richiesta non è riuscita a causa di un errore, un'eccezione o un guasto interno sconosciuto.  
Codice di stato HTTP: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
L'azione o l'operazione richiesta non è valida. Verifica che l'operazione sia digitata correttamente.  
Codice di stato HTTP: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
Il certificato X.509 o AWS l'ID della chiave di accesso fornito non esiste nei nostri archivi.  
Codice di stato HTTP: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
Non disponi delle autorizzazioni per eseguire questa azione.  
Codice di stato HTTP: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
L'ID della chiave di AWS accesso richiede un abbonamento al servizio.  
Codice di stato HTTP: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
La richiesta ha raggiunto il servizio più di 15 minuti dopo la data indicata sulla richiesta o più di 15 minuti dopo la data di scadenza della richiesta (ad esempio nel caso di pre-firmata URLs), oppure la data indicata sulla richiesta è tra più di 15 minuti.  
Codice di stato HTTP: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
La richiesta non è riuscita a causa di un errore temporaneo del server.  
Codice di stato HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
La richiesta è stata negata a causa del throttling della richiesta.  
Codice di stato HTTP: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
L'input non soddisfa i vincoli specificati da un servizio. AWS   
Codice di stato HTTP: 400

# Parametri comuni
<a name="CommonParameters"></a>

L'elenco seguente contiene i parametri utilizzati da tutte le azioni per firmare le richieste di Signature Version 4 con una stringa di query. Qualsiasi parametro specifico di un'operazione è riportato nell'argomento relativo all'operazione. Per ulteriori informazioni sulla versione 4 di Signature, consulta [Signing AWS API requests](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*.

 **Action**   <a name="CommonParameters-Action"></a>
azione da eseguire.  
Tipo: stringa  
Campo obbligatorio: sì

 **Version**   <a name="CommonParameters-Version"></a>
La versione dell'API per cui è scritta la richiesta, espressa nel formato YYYY-MM-DD.  
Tipo: stringa  
Campo obbligatorio: sì

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
Algoritmo hash utilizzato per creare la firma della richiesta.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Valori validi: `AWS4-HMAC-SHA256`   
Obbligatorio: condizionale

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
Il valore dell'ambito delle credenziali, che è una stringa che include la chiave di accesso, la data, la regione di destinazione, il servizio richiesto e una stringa di terminazione ("aws4\$1request"). Il valore viene espresso nel seguente formato: *chiave\$1accesso*/*AAAAMMGG*/*regione*/*servizio*/aws4\$1request.  
Per ulteriori informazioni, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella *Guida per l'utente IAM*.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
La data utilizzata per creare la firma. Il formato deve essere il formato di base ISO 8601 (YYYYMMDD'T'HHMMSS'Z'). Per esempio, la data e l'ora seguenti è un X-Amz-Date valore valido:`20120325T120000Z`.  
Condizione: X-Amz-Date è facoltativa per tutte le richieste; può essere utilizzata per sovrascrivere la data utilizzata per firmare le richieste. Se l'intestazione Date è specificata nel formato base ISO 8601, non X-Amz-Date è obbligatoria. Quando X-Amz-Date viene utilizzata, sovrascrive sempre il valore dell'intestazione Date. Per ulteriori informazioni, consulta [Elementi di una firma di richiesta AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) nella Guida per l'utente *IAM*.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
Il token di sicurezza temporaneo ottenuto tramite una chiamata a AWS Security Token Service (AWS STS). Per un elenco di servizi che supportano le credenziali di sicurezza temporanee da AWS STS, consulta la pagina [Servizi AWS che funzionano con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) nella *Guida per l'utente di IAM*.  
Condizione: se utilizzi credenziali di sicurezza temporanee di AWS STS, devi includere il token di sicurezza.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Specifica la firma con codifica esadecimale calcolata dalla stringa da firmare e dalla chiave di firma derivata.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Specifica tutte le intestazioni HTTP incluse come parte della richiesta canonica. Per ulteriori informazioni sulla specificazione delle intestazioni firmate, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella Guida per l'utente *IAM*.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Obbligatorio: condizionale