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à.
# 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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 [Tipi di errore 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)