Pour des fonctionnalités similaires à celles d'Amazon Timestream pour, pensez à Amazon Timestream LiveAnalytics pour InfluxDB. Il permet une ingestion simplifiée des données et des temps de réponse aux requêtes à un chiffre en millisecondes pour des analyses en temps réel. Pour en savoir plus, [cliquez ici](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Requête Amazon Timestream
Les actions suivantes sont prises en charge par 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
Annule une requête qui a été émise. L'annulation n'est accordée que si l'exécution de la requête n'est pas terminée avant que la demande d'annulation ne soit émise. L'annulation étant une opération idempotente, les demandes d'annulation suivantes renverront un`CancellationMessage`, indiquant que la requête a déjà été annulée. Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.cancel-query.html) pour plus de détails.
## Syntaxe de la requête
```
{
"QueryId": "string"
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [QueryId](#API_query_CancelQuery_RequestSyntax) **
L'ID de la requête qui doit être annulée. `QueryID`est renvoyé dans le cadre du résultat de la requête.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.
Modèle : `[a-zA-Z0-9]+`
Obligatoire : oui
## Syntaxe de la réponse
```
{
"CancellationMessage": "string"
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [CancellationMessage](#API_query_CancelQuery_ResponseSyntax) **
A `CancellationMessage` est renvoyé lorsqu'une `CancelQuery` demande pour la requête spécifiée par `QueryId` a déjà été émise.
Type : Chaîne
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CancelQuery)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CancelQuery)
# CreateScheduledQuery
Créez une requête planifiée qui sera exécutée en votre nom selon la planification configurée. Timestream endosse le rôle d'exécution fourni dans le cadre du paramètre `ScheduledQueryExecutionRoleArn` pour exécuter la requête. Vous pouvez utiliser le paramètre `NotificationConfiguration` pour configurer la notification pour vos opérations de requêtes planifiées.
## Syntaxe de la requête
```
{
"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"
}
}
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) **
L'utilisation de a ClientToken rend l'appel à CreateScheduledQuery idempotent, en d'autres termes, le fait de faire la même demande à plusieurs reprises produira le même résultat. Le fait de faire plusieurs CreateScheduledQuery demandes identiques a le même effet qu'une seule demande.
+ S'il CreateScheduledQuery est appelé sans un`ClientToken`, le Query SDK en génère un `ClientToken` en votre nom.
+ Après 8 heures, toute demande avec le même `ClientToken` est considérée comme une nouvelle demande.
Type : Chaîne
Contraintes de longueur : longueur minimale de 32. Longueur maximale de 128.
Obligatoire : non
** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **
Configuration pour le signalement d'erreurs. Des rapports d'erreurs seront générés lorsqu'un problème est rencontré au moment de l'écriture des résultats de la requête.
Type : objet [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)
Obligatoire : oui
** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) **
La clé Amazon KMS utilisée pour chiffrer la ressource de requête planifiée, au repos. Si la clé Amazon KMS n'est pas spécifiée, la ressource de requête planifiée sera chiffrée avec une clé Amazon KMS détenue par Timestream. Pour spécifier une clé KMS, utilisez l'ID de clé, l'ARN de clé, le nom d'alias ou l'ARN d'alias. Lorsque vous utilisez un nom d'alias, préfixez-le avec *alias/*.
S'il est ErrorReportConfiguration utilisé `SSE_KMS` comme type de chiffrement, le même KmsKeyId est utilisé pour chiffrer le rapport d'erreur au repos.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Obligatoire : non
** [Name](#API_query_CreateScheduledQuery_RequestSyntax) **
Nom de la requête planifiée.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.
Modèle : `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`
Obligatoire : oui
** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **
Configuration de la notification pour la requête planifiée. Une notification est envoyée par Timestream lorsque l'exécution d'une requête se termine, lorsque l'état est mis à jour ou lorsque vous la supprimez.
Type : objet [NotificationConfiguration](API_query_NotificationConfiguration.md)
Obligatoire : oui
** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) **
La chaîne de requête à exécuter. Les noms de paramètres peuvent être spécifiés dans le caractère `@` de la chaîne de requête suivi d'un identifiant. Le paramètre nommé `@scheduled_runtime` est réservé et peut être utilisé dans la requête pour obtenir l'heure à laquelle l'exécution de la requête est planifiée.
L'horodatage calculé en fonction du ScheduleConfiguration paramètre sera la valeur du `@scheduled_runtime` paramètre pour chaque requête exécutée. Par exemple, imaginez une instance d'une requête planifiée s'exécutant le 01/12/2021 à minuit. Pour cette instance, le paramètre `@scheduled_runtime` est initialisé à l'horodatage 01/12/2021 à minuit lors de l'appel de la requête.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 262 144.
Obligatoire : oui
** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **
Configuration du planning pour la requête.
Type : objet [ScheduleConfiguration](API_query_ScheduleConfiguration.md)
Obligatoire : oui
** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **
L'ARN du rôle IAM que Timestream endossera lors de l'exécution de la requête planifiée.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Obligatoire : oui
** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) **
Une liste de paires clé-valeur pour étiqueter la requête planifiée.
Type : tableau d’objets [Tag](API_query_Tag.md)
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.
Obligatoire : non
** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **
Configuration utilisée pour écrire le résultat d'une requête.
Type : objet [TargetConfiguration](API_query_TargetConfiguration.md)
Obligatoire : non
## Syntaxe de la réponse
```
{
"Arn": "string"
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) **
ARN pour la requête planifiée créée.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** ConflictException **
Impossible d'interroger les résultats d'une requête annulée.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ServiceQuotaExceededException **
Vous avez dépassé le quota de service.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery)
# DeleteScheduledQuery
Supprime une requête planifiée donnée. Il s'agit d'une opération irréversible.
## Syntaxe de la requête
```
{
"ScheduledQueryArn": "string"
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) **
L'ARN de la requête planifiée.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Obligatoire : oui
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ResourceNotFoundException **
La ressource demandée est introuvable.
** ScheduledQueryArn **
L'ARN de la requête planifiée.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DeleteScheduledQuery)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DeleteScheduledQuery)
# DescribeAccountSettings
Décrit les paramètres de votre compte, notamment le modèle de tarification des requêtes et le maximum configuré que TCUs le service peut utiliser pour votre charge de travail de requêtes.
Vous êtes facturé uniquement pour la durée des unités de calcul utilisées pour vos charges de travail.
## Syntaxe de la réponse
```
{
"MaxQueryTCU": number,
"QueryCompute": {
"ComputeMode": "string",
"ProvisionedCapacity": {
"ActiveQueryTCU": number,
"LastUpdate": {
"Status": "string",
"StatusMessage": "string",
"TargetQueryTCU": number
},
"NotificationConfiguration": {
"RoleArn": "string",
"SnsConfiguration": {
"TopicArn": "string"
}
}
}
},
"QueryPricingModel": "string"
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [MaxQueryTCU](#API_query_DescribeAccountSettings_ResponseSyntax) **
Le nombre maximum d'[unités de calcul Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/tcu.html) (TCUs) que le service utilisera à tout moment pour répondre à vos requêtes. Pour exécuter des requêtes, vous devez définir une capacité minimale de 4 TCU. Vous pouvez définir le nombre maximum de TCU en multiples de 4, par exemple 4, 8, 16, 32, etc. Cette configuration s'applique uniquement à l'utilisation à la demande de (TCUs).
Type : Integer
** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) **
Objet contenant les paramètres d'utilisation des unités de calcul Timestream (TCUs) de votre compte pour la charge de travail des requêtes. QueryCompute est disponible uniquement dans la région Asie-Pacifique (Mumbai).
Type : objet [QueryComputeResponse](API_query_QueryComputeResponse.md)
** [QueryPricingModel](#API_query_DescribeAccountSettings_ResponseSyntax) **
Le modèle de tarification pour les requêtes relatives à votre compte.
Le `QueryPricingModel` paramètre est utilisé par plusieurs opérations Timestream ; toutefois, l'opération `UpdateAccountSettings` d'API ne reconnaît aucune valeur autre que. `COMPUTE_UNITS`
Type : Chaîne
Valeurs valides : `BYTES_SCANNED | COMPUTE_UNITS`
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeAccountSettings)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeAccountSettings)
# DescribeEndpoints
DescribeEndpoints renvoie une liste des points de terminaison disponibles pour effectuer des appels d'API Timestream. Cette API est disponible à la fois via Write et Query.
Les Timestream étant SDKs conçus pour fonctionner de manière transparente avec l'architecture du service, y compris la gestion et le mappage des points de terminaison du service, *il n'est pas recommandé d'utiliser cette API sauf si* :
+ Vous utilisez des [points de terminaison VPC ()AWS PrivateLink](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) avec Timestream
+ Votre application utilise un langage de programmation qui n'est pas encore compatible avec le SDK
+ Vous avez besoin d'un meilleur contrôle de la mise en œuvre côté client
Pour des informations détaillées sur comment et quand utiliser et implémenter DescribeEndpoints, consultez [The Endpoint Discovery Pattern](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery).
## Syntaxe de la réponse
```
{
"Endpoints": [
{
"Address": "string",
"CachePeriodInMinutes": number
}
]
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [Endpoints](#API_query_DescribeEndpoints_ResponseSyntax) **
Un `Endpoints` objet est renvoyé lorsqu'une `DescribeEndpoints` demande est faite.
Type : tableau d’objets [Endpoint](API_query_Endpoint.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeEndpoints)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeEndpoints)
# DescribeScheduledQuery
Fournit des informations détaillées sur une requête planifiée.
## Syntaxe de la requête
```
{
"ScheduledQueryArn": "string"
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) **
L'ARN de la requête planifiée.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Obligatoire : oui
## Syntaxe de la réponse
```
{
"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"
}
}
}
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [ScheduledQuery](#API_query_DescribeScheduledQuery_ResponseSyntax) **
La requête planifiée.
Type : objet [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ResourceNotFoundException **
La ressource demandée est introuvable.
** ScheduledQueryArn **
L'ARN de la requête planifiée.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeScheduledQuery)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeScheduledQuery)
# ExecuteScheduledQuery
Vous pouvez utiliser cette API pour exécuter une requête planifiée manuellement.
Si vous l'avez activée`QueryInsights`, cette API renvoie également des informations et des statistiques relatives à la requête que vous avez exécutée dans le cadre d'une notification Amazon SNS. `QueryInsights`aide à optimiser les performances de votre requête. Pour en savoir plus`QueryInsights`, consultez la section [Utilisation des informations relatives aux requêtes pour optimiser les requêtes dans Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).
## Syntaxe de la requête
```
{
"ClientToken": "string",
"InvocationTime": number,
"QueryInsights": {
"Mode": "string"
},
"ScheduledQueryArn": "string"
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) **
Non utilisé.
Type : Chaîne
Contraintes de longueur : longueur minimale de 32. Longueur maximale de 128.
Obligatoire : non
** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) **
Horodatage en UTC. La requête sera exécutée comme si elle avait été invoquée à cet horodatage.
Type : Timestamp
Obligatoire : oui
** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) **
Encapsule les paramètres à activer`QueryInsights`.
Activation des informations et des statistiques sur les `QueryInsights` retours dans le cadre de la notification Amazon SNS pour la requête que vous avez exécutée. Vous pouvez l'utiliser `QueryInsights` pour ajuster les performances et le coût de vos requêtes.
Type : objet [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md)
Obligatoire : non
** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) **
ARN de la requête planifiée.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Obligatoire : oui
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ResourceNotFoundException **
La ressource demandée est introuvable.
** ScheduledQueryArn **
L'ARN de la requête planifiée.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Exemples
### Message de notification de requête planifiée pour le mode ENABLED\$1WITH\$1RATE\$1CONTROL
L'exemple suivant montre un message de notification de requête planifiée réussie pour le `ENABLED_WITH_RATE_CONTROL` mode du `QueryInsights` paramètre.
```
"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
}
}
}
```
### Message de notification de requête planifiée pour le mode DISABLED
L'exemple suivant montre un message de notification de requête planifiée réussie pour le `DISABLED` mode du `QueryInsights` paramètre.
```
"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
}
}
}
```
### Message de notification d'échec pour le mode ENABLED\$1WITH\$1RATE\$1CONTROL
L'exemple suivant montre un message de notification de requête planifiée ayant échoué pour le `ENABLED_WITH_RATE_CONTROL` mode du `QueryInsights` paramètre.
```
"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"
}
}
```
### Message de notification d'échec pour le mode DISABLED
L'exemple suivant montre un message de notification de requête planifiée ayant échoué pour le `DISABLED` mode du `QueryInsights` paramètre.
```
"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"
}
}
```
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecuteScheduledQuery)
# ListScheduledQueries
Obtient une liste de toutes les requêtes planifiées dans le compte Amazon et la région de l'appelant. `ListScheduledQueries`est finalement cohérent.
## Syntaxe de la requête
```
{
"MaxResults": number,
"NextToken": "string"
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) **
Le nombre maximum d'éléments à renvoyer dans la sortie. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, un `NextToken` est fourni dans la sortie. Pour reprendre la pagination, fournissez la `NextToken` valeur comme argument de l'appel suivant à`ListScheduledQueriesRequest`.
Type : entier
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.
Obligatoire : non
** [NextToken](#API_query_ListScheduledQueries_RequestSyntax) **
Un jeton de pagination pour reprendre la pagination.
Type : chaîne
Obligatoire : non
## Syntaxe de la réponse
```
{
"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"
}
}
}
]
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [NextToken](#API_query_ListScheduledQueries_ResponseSyntax) **
Jeton permettant de spécifier où commencer la pagination. Il s'agit du NextToken résultat d'une réponse tronquée précédemment.
Type : Chaîne
** [ScheduledQueries](#API_query_ListScheduledQueries_ResponseSyntax) **
Liste de requêtes planifiées.
Type : tableau d’objets [ScheduledQuery](API_query_ScheduledQuery.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListScheduledQueries)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListScheduledQueries)
# ListTagsForResource
Répertoriez tous les tags d'une ressource de requête Timestream.
## Syntaxe de la requête
```
{
"MaxResults": number,
"NextToken": "string",
"ResourceARN": "string"
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) **
Le nombre maximum de balises à renvoyer.
Type : entier
Plage valide : valeur minimum de 1. Valeur maximale fixée à 200.
Obligatoire : non
** [NextToken](#API_query_ListTagsForResource_RequestSyntax) **
Un jeton de pagination pour reprendre la pagination.
Type : chaîne
Obligatoire : non
** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) **
La ressource Timestream avec les balises à répertorier. Cette valeur est un Amazon Resource Name (ARN).
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Obligatoire : oui
## Syntaxe de la réponse
```
{
"NextToken": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [NextToken](#API_query_ListTagsForResource_ResponseSyntax) **
Un jeton de pagination permettant de reprendre la pagination avec un appel ultérieur à. `ListTagsForResourceResponse`
Type : Chaîne
** [Tags](#API_query_ListTagsForResource_ResponseSyntax) **
Les balises actuellement associées à la ressource Timestream.
Type : tableau d’objets [Tag](API_query_Tag.md)
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ResourceNotFoundException **
La ressource demandée est introuvable.
** ScheduledQueryArn **
L'ARN de la requête planifiée.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListTagsForResource)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListTagsForResource)
# PrepareQuery
Opération synchrone qui vous permet de soumettre une requête avec des paramètres à stocker par Timestream pour une exécution ultérieure. Timestream ne prend en charge l'utilisation de cette opération que si elle est `ValidateOnly` définie sur. `true`
## Syntaxe de la requête
```
{
"QueryString": "string",
"ValidateOnly": boolean
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [QueryString](#API_query_PrepareQuery_RequestSyntax) **
Chaîne de requête Timestream que vous souhaitez utiliser comme instruction préparée. Les noms de paramètres peuvent être spécifiés dans le caractère `@` de la chaîne de requête suivi d'un identifiant.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 262 144.
Obligatoire : oui
** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) **
En définissant cette valeur sur`true`, Timestream validera uniquement que la chaîne de requête est une requête Timestream valide, et ne stockera pas la requête préparée pour une utilisation ultérieure.
Type : booléen
Obligatoire : non
## Syntaxe de la réponse
```
{
"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"
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [Columns](#API_query_PrepareQuery_ResponseSyntax) **
Liste des colonnes de clause SELECT de la chaîne de requête soumise.
Type : tableau d’objets [SelectColumn](API_query_SelectColumn.md)
** [Parameters](#API_query_PrepareQuery_ResponseSyntax) **
Liste des paramètres utilisés dans la chaîne de requête soumise.
Type : tableau d’objets [ParameterMapping](API_query_ParameterMapping.md)
** [QueryString](#API_query_PrepareQuery_ResponseSyntax) **
Chaîne de requête que vous souhaitez préparer.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 262 144.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/PrepareQuery)
# Query
`Query`est une opération synchrone qui vous permet d'exécuter une requête sur vos données Amazon Timestream.
Si vous l'avez activée`QueryInsights`, cette API renvoie également des informations et des statistiques relatives à la requête que vous avez exécutée. `QueryInsights`aide à optimiser les performances de votre requête. Pour en savoir plus`QueryInsights`, consultez la section [Utilisation des informations relatives aux requêtes pour optimiser les requêtes dans Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).
**Note**
Le nombre maximum de demandes d'`Query`API que vous êtes autorisé à effectuer lorsque `QueryInsights` cette option est activée est d'une requête par seconde (QPS). Si vous dépassez ce taux de requêtes, cela peut entraîner un ralentissement.
`Query`expirera au bout de 60 secondes. Vous devez mettre à jour le délai d'expiration par défaut dans le SDK pour qu'il prenne en charge un délai d'attente de 60 secondes. Consultez l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html) pour plus de détails.
Votre demande de requête échouera dans les cas suivants :
+ Si vous soumettez une `Query` demande avec le même jeton client en dehors de la fenêtre d'idempuissance de 5 minutes.
+ Si vous soumettez une `Query` demande avec le même jeton client, mais que vous modifiez d'autres paramètres, dans le délai d'idempotentie de 5 minutes.
+ Si la taille de la ligne (y compris les métadonnées de la requête) dépasse 1 Mo, la requête échouera avec le message d'erreur suivant :
`Query aborted as max page response size has been exceeded by the output result row`
+ Si le principal IAM de l'initiateur de requête et le lecteur de résultats ne sont pas identiques and/or , l'initiateur de requête et le lecteur de résultats n'ont pas la même chaîne de requête dans les demandes de requête, la requête échouera avec une erreur. `Invalid pagination token`
## Syntaxe de la requête
```
{
"ClientToken": "string",
"MaxRows": number,
"NextToken": "string",
"QueryInsights": {
"Mode": "string"
},
"QueryString": "string"
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [ClientToken](#API_query_Query_RequestSyntax) **
Chaîne unique, distinguant majuscules et minuscules, de 64 caractères ASCII maximum spécifiée lors d'une `Query` demande. Fournir un `ClientToken` fait passer l'appel à `Query` *idempotent*. Cela signifie que l'exécution répétée de la même requête produira le même résultat. En d'autres termes, le fait de faire plusieurs `Query` demandes identiques a le même effet qu'une seule demande. Lorsque vous l'utilisez `ClientToken` dans une requête, notez les points suivants :
+ Si l'API Query est instanciée sans un`ClientToken`, le Query SDK en génère un en votre `ClientToken` nom.
+ Si l'`Query`invocation ne contient que le `ClientToken` mais n'inclut pas un`NextToken`, cet appel de `Query` est supposé être une nouvelle requête exécutée.
+ Si l'invocation contient`NextToken`, cette invocation particulière est supposée être une invocation ultérieure d'un appel antérieur à l'API Query, et un ensemble de résultats est renvoyé.
+ Au bout de 4 heures, toute demande contenant la même chose `ClientToken` est traitée comme une nouvelle demande.
Type : Chaîne
Contraintes de longueur : longueur minimale de 32. Longueur maximale de 128.
Obligatoire : non
** [MaxRows](#API_query_Query_RequestSyntax) **
Le nombre total de lignes à renvoyer dans la `Query` sortie. L'exécution initiale de `Query` avec une `MaxRows` valeur spécifiée renverra le jeu de résultats de la requête dans deux cas :
+ La taille du résultat est inférieure à`1MB`.
+ Le nombre de lignes du jeu de résultats est inférieur à la valeur de`maxRows`.
Sinon, l'appel initial de renvoie `Query` uniquement a`NextToken`, qui peut ensuite être utilisé lors des appels suivants pour récupérer le jeu de résultats. Pour reprendre la pagination, entrez la `NextToken` valeur dans la commande suivante.
Si la taille de la ligne est grande (par exemple, une ligne comporte de nombreuses colonnes), Timestream peut renvoyer moins de lignes afin d'empêcher la taille de réponse de dépasser la limite de 1 Mo. Si `MaxRows` ce n'est pas le cas, Timestream enverra le nombre de lignes nécessaire pour respecter la limite de 1 Mo.
Type : entier
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.
Obligatoire : non
** [NextToken](#API_query_Query_RequestSyntax) **
Un jeton de pagination utilisé pour renvoyer un ensemble de résultats. Lorsque l'`Query`API est invoquée en utilisant`NextToken`, cette invocation particulière est supposée être une invocation ultérieure d'un appel précédent à`Query`, et un ensemble de résultats est renvoyé. Toutefois, si l'`Query`invocation ne contient que le`ClientToken`, cet appel de `Query` est supposé être une nouvelle requête exécutée.
Notez les points suivants lors de l'utilisation NextToken dans une requête :
+ Un jeton de pagination peut être utilisé pour un maximum de cinq `Query` invocations, OU pour une durée maximale d'une heure, selon la première éventualité.
+ L'utilisation de la même option `NextToken` renverra le même ensemble d'enregistrements. Pour continuer à paginer dans le jeu de résultats, vous devez utiliser le plus récent. `nextToken`
+ Supposons qu'`Query`un appel renvoie deux `NextToken` valeurs, `TokenA` et`TokenB`. S'il `TokenB` est utilisé lors d'un appel ultérieur, `Query` il `TokenA` est alors invalidé et ne peut pas être réutilisé.
+ Pour demander un ensemble de résultats antérieur à partir d'une requête après le début de la pagination, vous devez réinvoquer l'API Query.
+ La dernière `NextToken` doit être utilisée pour paginer jusqu'à ce qu'elle `null` soit renvoyée, après quoi une nouvelle `NextToken` doit être utilisée.
+ Si le principal IAM de l'initiateur de requête et le lecteur de résultats ne sont pas identiques and/or , l'initiateur de requête et le lecteur de résultats n'ont pas la même chaîne de requête dans les demandes de requête, la requête échouera avec une erreur. `Invalid pagination token`
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Obligatoire : non
** [QueryInsights](#API_query_Query_RequestSyntax) **
Encapsule les paramètres à activer`QueryInsights`.
L'activation `QueryInsights` renvoie des informations et des métriques en plus des résultats de requête pour la requête que vous avez exécutée. Vous pouvez l'utiliser `QueryInsights` pour optimiser les performances de vos requêtes.
Type : objet [QueryInsights](API_query_QueryInsights.md)
Obligatoire : non
** [QueryString](#API_query_Query_RequestSyntax) **
Requête à exécuter par Timestream.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 262 144.
Obligatoire : oui
## Syntaxe de la réponse
```
{
"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"
}
]
}
]
}
]
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [ColumnInfo](#API_query_Query_ResponseSyntax) **
Les types de données de colonne du jeu de résultats renvoyé.
Type : tableau d’objets [ColumnInfo](API_query_ColumnInfo.md)
** [NextToken](#API_query_Query_ResponseSyntax) **
Un jeton de pagination qui peut être réutilisé lors d'un `Query` appel pour obtenir la prochaine série de résultats.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
** [QueryId](#API_query_Query_ResponseSyntax) **
Un identifiant unique pour la requête donnée.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.
Modèle : `[a-zA-Z0-9]+`
** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) **
Encapsule `QueryInsights` contenant des informations et des mesures relatives à la requête que vous avez exécutée.
Type : objet [QueryInsightsResponse](API_query_QueryInsightsResponse.md)
** [QueryStatus](#API_query_Query_ResponseSyntax) **
Informations sur l'état de la requête, y compris la progression et les octets analysés.
Type : objet [QueryStatus](API_query_QueryStatus.md)
** [Rows](#API_query_Query_ResponseSyntax) **
Les lignes du jeu de résultats renvoyées par la requête.
Type : tableau d’objets [Row](API_query_Row.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** ConflictException **
Impossible d'interroger les résultats d'une requête annulée.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** QueryExecutionException **
Timestream n'a pas pu exécuter correctement la requête.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/Query)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/Query)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Query)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/Query)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Query)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/Query)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/Query)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/Query)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/Query)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Query)
# TagResource
Associez un ensemble de balises à une ressource Timestream. Vous pouvez ensuite activer ces balises définies par l'utilisateur afin qu'elles apparaissent sur la console Billing and Cost Management pour le suivi de la répartition des coûts.
## Syntaxe de la requête
```
{
"ResourceARN": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [ResourceARN](#API_query_TagResource_RequestSyntax) **
Identifie la ressource Timestream à laquelle les balises doivent être ajoutées. Cette valeur est un Amazon Resource Name (ARN).
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Obligatoire : oui
** [Tags](#API_query_TagResource_RequestSyntax) **
Les balises à attribuer à la ressource Timestream.
Type : tableau d’objets [Tag](API_query_Tag.md)
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.
Obligatoire : oui
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ResourceNotFoundException **
La ressource demandée est introuvable.
** ScheduledQueryArn **
L'ARN de la requête planifiée.
Code d’état HTTP : 400
** ServiceQuotaExceededException **
Vous avez dépassé le quota de service.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/TagResource)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/TagResource)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TagResource)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/TagResource)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TagResource)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/TagResource)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/TagResource)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/TagResource)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/TagResource)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TagResource)
# UntagResource
Supprime l'association de balises d'une ressource de requête Timestream.
## Syntaxe de la requête
```
{
"ResourceARN": "string",
"TagKeys": [ "string" ]
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [ResourceARN](#API_query_UntagResource_RequestSyntax) **
La ressource Timestream dont les balises seront supprimées. Cette valeur est un Amazon Resource Name (ARN).
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Obligatoire : oui
** [TagKeys](#API_query_UntagResource_RequestSyntax) **
Liste des clés de tags. Les balises existantes de la ressource dont les clés sont membres de cette liste seront supprimées de la ressource Timestream.
Type : tableau de chaînes
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.
Obligatoire : oui
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ResourceNotFoundException **
La ressource demandée est introuvable.
** ScheduledQueryArn **
L'ARN de la requête planifiée.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UntagResource)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UntagResource)
# UpdateAccountSettings
Transfère votre compte pour l'utiliser TCUs pour la tarification des requêtes et modifie le nombre maximal d'unités de calcul des requêtes que vous avez configurées. Si vous réduisez la valeur de `MaxQueryTCU` à la configuration souhaitée, la nouvelle valeur peut prendre jusqu'à 24 heures pour être effective.
**Note**
Une fois que vous avez transféré votre compte à des TCUs fins de tarification des requêtes, vous ne pouvez plus passer à l'utilisation d'octets scannés pour la tarification des requêtes.
## Syntaxe de la requête
```
{
"MaxQueryTCU": number,
"QueryCompute": {
"ComputeMode": "string",
"ProvisionedCapacity": {
"NotificationConfiguration": {
"RoleArn": "string",
"SnsConfiguration": {
"TopicArn": "string"
}
},
"TargetQueryTCU": number
}
},
"QueryPricingModel": "string"
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) **
Le nombre maximum d'unités de calcul que le service utilisera à tout moment pour répondre à vos requêtes. Pour exécuter des requêtes, vous devez définir une capacité minimale de 4 TCU. Vous pouvez définir le nombre maximum de TCU en multiples de 4, par exemple 4, 8, 16, 32, etc. La valeur maximale prise en charge `MaxQueryTCU` est de 1000. Pour demander une augmentation de cette limite souple, contactez le AWS Support. Pour plus d'informations sur le quota par défaut pour MaxQueryTCU, consultez la section Quotas par défaut. Cette configuration s'applique uniquement à l'utilisation à la demande des unités de calcul Timestream ()TCUs.
La valeur maximale prise en charge `MaxQueryTCU` est de 1000. Pour demander une augmentation de cette limite souple, contactez le AWS Support. Pour plus d'informations sur le quota par défaut pour`maxQueryTCU`, consultez la section [Quotas par défaut](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.default).
Type : Integer
Obligatoire : non
** [QueryCompute](#API_query_UpdateAccountSettings_RequestSyntax) **
Modifie les paramètres de calcul des requêtes configurés dans votre compte, y compris le modèle de tarification des requêtes et les unités de calcul Timestream (TCUs) fournies dans votre compte. QueryCompute est disponible uniquement dans la région Asie-Pacifique (Mumbai).
Cette API est idempotente, ce qui signifie que le fait de faire la même demande plusieurs fois aura le même effet que de faire la demande une seule fois.
Type : objet [QueryComputeRequest](API_query_QueryComputeRequest.md)
Obligatoire : non
** [QueryPricingModel](#API_query_UpdateAccountSettings_RequestSyntax) **
Modèle de tarification pour les requêtes relatives à un compte.
Le `QueryPricingModel` paramètre est utilisé par plusieurs opérations Timestream ; toutefois, l'opération `UpdateAccountSettings` API ne reconnaît aucune valeur autre que. `COMPUTE_UNITS`
Type : Chaîne
Valeurs valides : `BYTES_SCANNED | COMPUTE_UNITS`
Obligatoire : non
## Syntaxe de la réponse
```
{
"MaxQueryTCU": number,
"QueryCompute": {
"ComputeMode": "string",
"ProvisionedCapacity": {
"ActiveQueryTCU": number,
"LastUpdate": {
"Status": "string",
"StatusMessage": "string",
"TargetQueryTCU": number
},
"NotificationConfiguration": {
"RoleArn": "string",
"SnsConfiguration": {
"TopicArn": "string"
}
}
}
},
"QueryPricingModel": "string"
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [MaxQueryTCU](#API_query_UpdateAccountSettings_ResponseSyntax) **
Le nombre maximal configuré d'unités de calcul que le service utilisera à tout moment pour répondre à vos requêtes.
Type : Integer
** [QueryCompute](#API_query_UpdateAccountSettings_ResponseSyntax) **
Confirme les paramètres de compte mis à jour pour interroger les données de votre compte. QueryCompute est disponible uniquement dans la région Asie-Pacifique (Mumbai).
Type : objet [QueryComputeResponse](API_query_QueryComputeResponse.md)
** [QueryPricingModel](#API_query_UpdateAccountSettings_ResponseSyntax) **
Le modèle de tarification d'un compte.
Type : Chaîne
Valeurs valides : `BYTES_SCANNED | COMPUTE_UNITS`
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateAccountSettings)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateAccountSettings)
# UpdateScheduledQuery
Mettez à jour une requête planifiée.
## Syntaxe de la requête
```
{
"ScheduledQueryArn": "string",
"State": "string"
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) **
ARN de la requête planifiée.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Obligatoire : oui
** [State](#API_query_UpdateScheduledQuery_RequestSyntax) **
État de la requête planifiée.
Type : Chaîne
Valeurs valides : `ENABLED | DISABLED`
Obligatoire : oui
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ResourceNotFoundException **
La ressource demandée est introuvable.
** ScheduledQueryArn **
L'ARN de la requête planifiée.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateScheduledQuery)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateScheduledQuery)