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à.
# Operazioni
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
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
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
```
{
"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
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) **
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Obbligatorio: no
** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **
Tipo: oggetto [DataModelConfiguration](API_DataModelConfiguration.md)
Obbligatorio: no
** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **
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) **
Tipo: long
Obbligatorio: no
** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **
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) **
Database Target Timestream per un'attività di caricamento in batch.
Tipo: stringa
Modello: `[a-zA-Z0-9_.-]+`
Obbligatorio: sì
** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) **
Tabella Target Timestream per un'attività di caricamento in batch.
Tipo: stringa
Modello: `[a-zA-Z0-9_.-]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"TaskId": "string"
}
```
## Elementi di risposta
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) **
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
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
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
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
```
{
"DatabaseName": "string",
"KmsKeyId": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parametri della richiesta
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) **
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) **
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) **
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
```
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}
```
## Elementi di risposta
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) **
Il database Timestream appena creato.
Tipo: oggetto [Database](API_Database.md)
## Errori
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
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
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
```
{
"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
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) **
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) **
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) **
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) **
Lo schema della tabella.
Tipo: oggetto [Schema](API_Schema.md)
Obbligatorio: no
** [TableName](#API_CreateTable_RequestSyntax) **
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) **
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
```
{
"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
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) **
La tabella Timestream appena creata.
Tipo: oggetto [Table](API_Table.md)
## Errori
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
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
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
```
{
"DatabaseName": "string"
}
```
## Parametri della richiesta
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) **
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
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
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
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
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
```
{
"DatabaseName": "string",
"TableName": "string"
}
```
## Parametri della richiesta
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) **
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) **
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
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
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
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
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
```
{
"TaskId": "string"
}
```
## Parametri della richiesta
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) **
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
```
{
"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
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) **
Descrizione dell'operazione di caricamento in batch.
Tipo: oggetto [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md)
## Errori
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
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
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
```
{
"DatabaseName": "string"
}
```
## Parametri della richiesta
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) **
Nome del database Timestream.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.
Obbligatorio: sì
## Sintassi della risposta
```
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}
```
## Elementi di risposta
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) **
Nome della tabella Timestream.
Tipo: oggetto [Database](API_Database.md)
## Errori
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
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
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
```
{
"Endpoints": [
{
"Address": "string",
"CachePeriodInMinutes": number
}
]
}
```
## Elementi di risposta
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) **
Un `Endpoints` oggetto viene restituito quando viene effettuata una `DescribeEndpoints` richiesta.
Tipo: matrice di oggetti [Endpoint](API_Endpoint.md)
## Errori
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
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
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
```
{
"DatabaseName": "string",
"TableName": "string"
}
```
## Parametri della richiesta
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) **
Nome del database Timestream.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.
Obbligatorio: sì
** [TableName](#API_DescribeTable_RequestSyntax) **
Nome della tabella Timestream.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.
Obbligatorio: sì
## Sintassi della risposta
```
{
"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
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) **
La tabella Timestream.
Tipo: oggetto [Table](API_Table.md)
## Errori
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
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
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
```
{
"MaxResults": number,
"NextToken": "string",
"TaskStatus": "string"
}
```
## Parametri della richiesta
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) **
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) **
Token per specificare dove iniziare l'impaginazione. Questo è il risultato di una risposta precedentemente NextToken troncata.
▬Tipo: stringa
Obbligatorio: no
** [TaskStatus](#API_ListBatchLoadTasks_RequestSyntax) **
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
```
{
"BatchLoadTasks": [
{
"CreationTime": number,
"DatabaseName": "string",
"LastUpdatedTime": number,
"ResumableUntil": number,
"TableName": "string",
"TaskId": "string",
"TaskStatus": "string"
}
],
"NextToken": "string"
}
```
## Elementi di risposta
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) **
Un elenco di dettagli dell'attività di caricamento in batch.
Tipo: matrice di oggetti [BatchLoadTask](API_BatchLoadTask.md)
** [NextToken](#API_ListBatchLoadTasks_ResponseSyntax) **
Token per specificare dove iniziare l'impaginazione. Fornisci il successivo ListBatchLoadTasksRequest.
Tipo: String
## Errori
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
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
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
```
{
"MaxResults": number,
"NextToken": "string"
}
```
## Parametri della richiesta
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) **
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) **
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
```
{
"Databases": [
{
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
],
"NextToken": "string"
}
```
## Elementi di risposta
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) **
Un elenco di nomi di database.
Tipo: matrice di oggetti [Database](API_Database.md)
** [NextToken](#API_ListDatabases_ResponseSyntax) **
Il token di impaginazione. Questo parametro viene restituito quando la risposta viene troncata.
Tipo: String
## Errori
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
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
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
```
{
"DatabaseName": "string",
"MaxResults": number,
"NextToken": "string"
}
```
## Parametri della richiesta
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) **
Nome del database Timestream.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.
Obbligatorio: no
** [MaxResults](#API_ListTables_RequestSyntax) **
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) **
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
```
{
"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
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) **
Token per specificare dove iniziare l'impaginazione. Questo è il risultato di una risposta precedentemente NextToken troncata.
Tipo: String
** [Tables](#API_ListTables_ResponseSyntax) **
Un elenco di tabelle.
Tipo: matrice di oggetti [Table](API_Table.md)
## Errori
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
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
Elenca tutti i tag su una risorsa Timestream.
## Sintassi della richiesta
```
{
"ResourceARN": "string"
}
```
## Parametri della richiesta
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) **
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
```
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Elementi di risposta
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) **
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
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
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
## Sintassi della richiesta
```
{
"TaskId": "string"
}
```
## Parametri della richiesta
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) **
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
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
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
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
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
```
{
"ResourceARN": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parametri della richiesta
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) **
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) **
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
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
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
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
Rimuove l'associazione di tag da una risorsa Timestream.
## Sintassi della richiesta
```
{
"ResourceARN": "string",
"TagKeys": [ "string" ]
}
```
## Parametri della richiesta
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) **
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) **
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
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
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
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
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
```
{
"DatabaseName": "string",
"KmsKeyId": "string"
}
```
## Parametri della richiesta
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) **
Nome del database.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.
Obbligatorio: sì
** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) **
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
```
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}
```
## Elementi di risposta
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) **
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
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
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
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
```
{
"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
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) **
Nome del database Timestream.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.
Obbligatorio: sì
** [MagneticStoreWriteProperties](#API_UpdateTable_RequestSyntax) **
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) **
La durata di conservazione dell'archivio di memoria e dell'archivio magnetico.
Tipo: oggetto [RetentionProperties](API_RetentionProperties.md)
Obbligatorio: no
** [Schema](#API_UpdateTable_RequestSyntax) **
Lo schema della tabella.
Tipo: oggetto [Schema](API_Schema.md)
Obbligatorio: no
** [TableName](#API_UpdateTable_RequestSyntax) **
Nome della tabella Timestream.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.
Obbligatorio: sì
## Sintassi della risposta
```
{
"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
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) **
La tabella Timestream aggiornata.
Tipo: oggetto [Table](API_Table.md)
## Errori
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
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
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
```
{
"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
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) **
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) **
Nome del database Timestream.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.
Obbligatorio: sì
** [Records](#API_WriteRecords_RequestSyntax) **
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) **
Nome della tabella Timestream.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.
Obbligatorio: sì
## Sintassi della risposta
```
{
"RecordsIngested": {
"MagneticStore": number,
"MemoryStore": number,
"Total": number
}
}
```
## Elementi di risposta
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) **
Informazioni sui record acquisiti da questa richiesta.
Tipo: oggetto [RecordsIngested](API_RecordsIngested.md)
## Errori
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
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
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
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
```
{
"QueryId": "string"
}
```
## Parametri della richiesta
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) **
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
```
{
"CancellationMessage": "string"
}
```
## Elementi di risposta
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 `CancellationMessage` viene restituito quando è già `QueryId` stata emessa una `CancelQuery` richiesta per la query specificata da.
Tipo: String
## Errori
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
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
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
```
{
"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
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) **
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) **
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) **
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) **
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) **
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) **
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) **
La configurazione della pianificazione per la query.
Tipo: oggetto [ScheduleConfiguration](API_query_ScheduleConfiguration.md)
Obbligatorio: sì
** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **
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) **
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) **
Configurazione utilizzata per scrivere il risultato di una query.
Tipo: oggetto [TargetConfiguration](API_query_TargetConfiguration.md)
Obbligatorio: no
## Sintassi della risposta
```
{
"Arn": "string"
}
```
## Elementi di risposta
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) **
ARN per la query pianificata creata.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.
## Errori
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
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
Elimina una determinata query pianificata. Si tratta di un'operazione irreversibile.
## Sintassi della richiesta
```
{
"ScheduledQueryArn": "string"
}
```
## Parametri della richiesta
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) **
L'ARN della query pianificata.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.
Obbligatorio: sì
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
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
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
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
```
{
"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
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) **
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) **
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) **
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
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
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
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
```
{
"Endpoints": [
{
"Address": "string",
"CachePeriodInMinutes": number
}
]
}
```
## Elementi di risposta
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) **
Un `Endpoints` oggetto viene restituito quando viene effettuata una `DescribeEndpoints` richiesta.
Tipo: matrice di oggetti [Endpoint](API_query_Endpoint.md)
## Errori
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
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
Fornisce informazioni dettagliate su un'interrogazione pianificata.
## Sintassi della richiesta
```
{
"ScheduledQueryArn": "string"
}
```
## Parametri della richiesta
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) **
L'ARN della query pianificata.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.
Obbligatorio: sì
## Sintassi della risposta
```
{
"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
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) **
L'interrogazione pianificata.
Tipo: oggetto [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md)
## Errori
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
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
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
```
{
"ClientToken": "string",
"InvocationTime": number,
"QueryInsights": {
"Mode": "string"
},
"ScheduledQueryArn": "string"
}
```
## Parametri della richiesta
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) **
Non utilizzato.
Tipo: String
Vincoli di lunghezza: lunghezza minima di 32. La lunghezza massima è 128 caratteri.
Obbligatorio: no
** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) **
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) **
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) **
ARN della query pianificata.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.
Obbligatorio: sì
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
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
### Messaggio di notifica di interrogazione pianificata per la modalità ENABLED\$1WITH\$1RATE\$1CONTROL
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:::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:::database/BaseDb/table/BaseTable",
"partitionKey": [
"measure_name"
]
}
},
"queryTemporalRange": {
"max": {
"value": 2399999999999,
"tableArn": "arn:aws:timestream:::database/BaseDb/table/BaseTable"
}
},
"queryTableCount": 1,
"outputRows": 1,
"outputBytes": 59
}
}
}
```
### Messaggio di notifica delle interrogazioni pianificate per la modalità DISABLED
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:::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
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:::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
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:::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
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
Ottiene un elenco di tutte le domande pianificate nell'account Amazon e nella regione del chiamante. `ListScheduledQueries`alla fine è coerente.
## Sintassi della richiesta
```
{
"MaxResults": number,
"NextToken": "string"
}
```
## Parametri della richiesta
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) **
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) **
Un token di impaginazione per riprendere l'impaginazione.
▬Tipo: stringa
Obbligatorio: no
## Sintassi della risposta
```
{
"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
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) **
Token per specificare dove iniziare l'impaginazione. Questo è il risultato di una NextToken risposta precedentemente troncata.
Tipo: String
** [ScheduledQueries](#API_query_ListScheduledQueries_ResponseSyntax) **
Un elenco di interrogazioni pianificate.
Tipo: matrice di oggetti [ScheduledQuery](API_query_ScheduledQuery.md)
## Errori
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
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
Elenca tutti i tag su una risorsa di query Timestream.
## Sintassi della richiesta
```
{
"MaxResults": number,
"NextToken": "string",
"ResourceARN": "string"
}
```
## Parametri della richiesta
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) **
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) **
Un token di impaginazione per riprendere l'impaginazione.
▬Tipo: stringa
Obbligatorio: no
** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) **
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
```
{
"NextToken": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Elementi di risposta
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) **
Un token di impaginazione per riprendere l'impaginazione con una chiamata successiva a. `ListTagsForResourceResponse`
Tipo: String
** [Tags](#API_query_ListTagsForResource_ResponseSyntax) **
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
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
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
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
```
{
"QueryString": "string",
"ValidateOnly": boolean
}
```
## Parametri della richiesta
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) **
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) **
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
```
{
"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
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) **
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) **
Un elenco di parametri utilizzati nella stringa di query inviata.
Tipo: matrice di oggetti [ParameterMapping](API_query_ParameterMapping.md)
** [QueryString](#API_query_PrepareQuery_ResponseSyntax) **
La stringa di query che si desidera preparare.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 262144.
## Errori
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
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
`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
```
{
"ClientToken": "string",
"MaxRows": number,
"NextToken": "string",
"QueryInsights": {
"Mode": "string"
},
"QueryString": "string"
}
```
## Parametri della richiesta
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) **
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) **
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) **
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) **
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) **
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
```
{
"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
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) **
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) **
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) **
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) **
Incapsula `QueryInsights` contenente informazioni e metriche relative alla query che hai eseguito.
Tipo: oggetto [QueryInsightsResponse](API_query_QueryInsightsResponse.md)
** [QueryStatus](#API_query_Query_ResponseSyntax) **
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) **
Le righe del set di risultati restituite dalla query.
Tipo: matrice di oggetti [Row](API_query_Row.md)
## Errori
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
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
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
```
{
"ResourceARN": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parametri della richiesta
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) **
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) **
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
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
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
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
Rimuove l'associazione di tag da una risorsa di query Timestream.
## Sintassi della richiesta
```
{
"ResourceARN": "string",
"TagKeys": [ "string" ]
}
```
## Parametri della richiesta
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) **
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) **
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
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
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
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
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
```
{
"MaxQueryTCU": number,
"QueryCompute": {
"ComputeMode": "string",
"ProvisionedCapacity": {
"NotificationConfiguration": {
"RoleArn": "string",
"SnsConfiguration": {
"TopicArn": "string"
}
},
"TargetQueryTCU": number
}
},
"QueryPricingModel": "string"
}
```
## Parametri della richiesta
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) **
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) **
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) **
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
```
{
"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
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) **
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) **
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) **
Il modello di prezzo per un account.
Tipo: String
Valori validi: `BYTES_SCANNED | COMPUTE_UNITS`
## Errori
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
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
Aggiorna un'interrogazione pianificata.
## Sintassi della richiesta
```
{
"ScheduledQueryArn": "string",
"State": "string"
}
```
## Parametri della richiesta
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) **
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) **
Stato dell'interrogazione pianificata.
Tipo: String
Valori validi: `ENABLED | DISABLED`
Obbligatorio: sì
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
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
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)