Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. [여기](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)에서 자세히 알아보세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Timestream Query
<a name="API_Operations_Amazon_Timestream_Query"></a>

Amazon Timestream 쿼리는 다음 작업을 지원합니다.
+  [CancelQuery](API_query_CancelQuery.md) 
+  [CreateScheduledQuery](API_query_CreateScheduledQuery.md) 
+  [DeleteScheduledQuery](API_query_DeleteScheduledQuery.md) 
+  [DescribeAccountSettings](API_query_DescribeAccountSettings.md) 
+  [DescribeEndpoints](API_query_DescribeEndpoints.md) 
+  [DescribeScheduledQuery](API_query_DescribeScheduledQuery.md) 
+  [ExecuteScheduledQuery](API_query_ExecuteScheduledQuery.md) 
+  [ListScheduledQueries](API_query_ListScheduledQueries.md) 
+  [ListTagsForResource](API_query_ListTagsForResource.md) 
+  [PrepareQuery](API_query_PrepareQuery.md) 
+  [Query](API_query_Query.md) 
+  [TagResource](API_query_TagResource.md) 
+  [UntagResource](API_query_UntagResource.md) 
+  [UpdateAccountSettings](API_query_UpdateAccountSettings.md) 
+  [UpdateScheduledQuery](API_query_UpdateScheduledQuery.md) 

# CancelQuery
<a name="API_query_CancelQuery"></a>

 발급된 쿼리를 취소합니다. 취소 요청은 취소 요청이 실행되기 전에 쿼리 실행이 완료되지 않은 경우에만 제공됩니다. 취소는 멱등성 작업이므로 후속 취소 요청은 쿼리가 이미 취소되었음을 나타내는 `CancellationMessage`를 반환합니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.cancel-query.html)을 참조하세요.

## 구문 요청
<a name="API_query_CancelQuery_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_CancelQuery_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [QueryId](#API_query_CancelQuery_RequestSyntax) **   <a name="timestream-query_CancelQuery-request-QueryId"></a>
 취소해야 하는 쿼리의 ID입니다. `QueryID`는 쿼리 결과의 일부로 반환됩니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `[a-zA-Z0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_query_CancelQuery_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_query_CancelQuery_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CancellationMessage](#API_query_CancelQuery_ResponseSyntax) **   <a name="timestream-query_CancelQuery-response-CancellationMessage"></a>
 `QueryId`에 지정된 쿼리에 대한 `CancelQuery` 요청이 이미 실행되면 `CancellationMessage`가 반환됩니다.  
유형: 문자열

## 오류
<a name="API_query_CancelQuery_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
계정 설정에 액세스하는 데 필요한 권한이 없습니다.  
HTTP 상태 코드: 400

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_CancelQuery_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CancelQuery) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CancelQuery) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CancelQuery) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CancelQuery) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CancelQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CancelQuery) 

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

 구성된 일정에 따라 사용자를 대신하여 실행될 예약된 쿼리를 생성합니다. Timestream은 쿼리를 실행하기 위해`ScheduledQueryExecutionRoleArn` 파라미터의 일부로 제공된 실행 역할을 수임합니다. `NotificationConfiguration` 파라미터를 사용하여 예약된 쿼리 작업에 대한 알림을 구성할 수 있습니다.

## 구문 요청
<a name="API_query_CreateScheduledQuery_RequestSyntax"></a>

```
{
   "ClientToken": "string",
   "ErrorReportConfiguration": { 
      "S3Configuration": { 
         "BucketName": "string",
         "EncryptionOption": "string",
         "ObjectKeyPrefix": "string"
      }
   },
   "KmsKeyId": "string",
   "Name": "string",
   "NotificationConfiguration": { 
      "SnsConfiguration": { 
         "TopicArn": "string"
      }
   },
   "QueryString": "string",
   "ScheduleConfiguration": { 
      "ScheduleExpression": "string"
   },
   "ScheduledQueryExecutionRoleArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TargetConfiguration": { 
      "TimestreamConfiguration": { 
         "DatabaseName": "string",
         "DimensionMappings": [ 
            { 
               "DimensionValueType": "string",
               "Name": "string"
            }
         ],
         "MeasureNameColumn": "string",
         "MixedMeasureMappings": [ 
            { 
               "MeasureName": "string",
               "MeasureValueType": "string",
               "MultiMeasureAttributeMappings": [ 
                  { 
                     "MeasureValueType": "string",
                     "SourceColumn": "string",
                     "TargetMultiMeasureAttributeName": "string"
                  }
               ],
               "SourceColumn": "string",
               "TargetMeasureName": "string"
            }
         ],
         "MultiMeasureMappings": { 
            "MultiMeasureAttributeMappings": [ 
               { 
                  "MeasureValueType": "string",
                  "SourceColumn": "string",
                  "TargetMultiMeasureAttributeName": "string"
               }
            ],
            "TargetMultiMeasureName": "string"
         },
         "TableName": "string",
         "TimeColumn": "string"
      }
   }
}
```

## 요청 파라미터
<a name="API_query_CreateScheduledQuery_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ClientToken"></a>
ClientToken을 사용하면 CreateScheduledQuery에 대한 호출이 멱등성을 가지게 됩니다. 즉, 동일한 요청을 반복적으로 수행해도 결과가 동일합니다. 동일한 CreateScheduledQuery 요청을 여러 개 생성하는 것은 단일 요청을 생성하는 것과 같은 효과를 냅니다.  
+  `ClientToken` 없이 CreateScheduledQuery를 호출하면 Query SDK가 사용자를 대신하여 `ClientToken`을 생성합니다.
+  8시간 후 동일한 `ClientToken`이 있는 요청은 새 요청으로 처리됩니다.
유형: 문자열  
길이 제약: 최소 길이는 32입니다. 최대 길이 128.  
필수 여부: 아니요

 ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ErrorReportConfiguration"></a>
오류 보고를 위한 구성입니다. 쿼리 결과를 작성할 때 문제가 발생하면 오류 보고서가 생성됩니다.  
타입: [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)객체  
필수 항목 여부: 예

 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-KmsKeyId"></a>
예약된 쿼리 리소스를 저장 시 암호화하는 데 사용되는 Amazon KMS 키입니다. Amazon KMS 키를 지정하지 않으면 예약된 쿼리 리소스가 Timestream 소유의 Amazon KMS 키로 암호화됩니다. KMS 키를 식별하려면 키 ID, 키 ARN, 별칭 이름 또는 별칭 ARN을 사용합니다. 별칭 이름을 사용할 때 이름 앞에 *alias/*를 붙입니다.  
ErrorReportConfiguration이 `SSE_KMS`를 암호화 유형으로 사용하는 경우 동일한 KmsKeyId를 사용하여 저장 시 오류 보고서를 암호화합니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 여부: 아니요

 ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Name"></a>
예약된 쿼리의 이름입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
필수 여부: 예

 ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-NotificationConfiguration"></a>
예약된 쿼리에 대한 알림 구성입니다. 쿼리 실행이 완료되거나 상태가 업데이트되거나 삭제할 때 Timestream에서 알림을 보냅니다.  
타입: [NotificationConfiguration](API_query_NotificationConfiguration.md)객체  
필수 항목 여부: 예

 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-QueryString"></a>
실행할 쿼리 문자열입니다. 쿼리 문자열 `@` 문자와 식별자로 파라미터 이름을 지정할 수 있습니다. 명명된 파라미터 `@scheduled_runtime`은 예약되어 있으며 쿼리 실행이 예약된 시간을 가져오기 위해 쿼리에서 사용할 수 있습니다.  
ScheduleConfiguration 파라미터에 따라 계산된 타임스탬프는 각 쿼리 실행에 대한 `@scheduled_runtime` 파라미터의 값이 됩니다. 2021-12-01 00:00:00에 실행되는 예약된 쿼리의 인스턴스를 예로 들 수 있습니다. 이 인스턴스에 대해 쿼리를 호출할 때 `@scheduled_runtime` 파라미터는 타임스탬프 2021-12-01 00:00:00으로 초기화됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 262144자입니다.  
필수 항목 여부: 예

 ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduleConfiguration"></a>
쿼리에 대한 일정 구성입니다.  
타입: [ScheduleConfiguration](API_query_ScheduleConfiguration.md)객체  
필수 항목 여부: 예

 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduledQueryExecutionRoleArn"></a>
예약된 쿼리를 실행할 때 Timestream이 수임할 IAM 역할의 ARN입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 항목 여부: 예

 ** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Tags"></a>
예약된 쿼리에 레이블을 지정할 키-값 페어의 목록입니다.  
타입: [Tag](API_query_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-TargetConfiguration"></a>
쿼리의 결과를 쓰는 데 사용되는 구성입니다.  
유형: [TargetConfiguration](API_query_TargetConfiguration.md)객체  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_query_CreateScheduledQuery_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_query_CreateScheduledQuery_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) **   <a name="timestream-query_CreateScheduledQuery-response-Arn"></a>
생성된 예약 쿼리의 ARN입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.

## 오류
<a name="API_query_CreateScheduledQuery_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
계정 설정에 액세스하는 데 필요한 권한이 없습니다.  
HTTP 상태 코드: 400

 ** ConflictException **   
 취소된 쿼리에 대한 결과를 폴링할 수 없습니다.  
HTTP 상태 코드: 400

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ServiceQuotaExceededException **   
서비스 할당량을 초과했습니다.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_CreateScheduledQuery_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery) 

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

지정된 예약된 쿼리를 삭제합니다. 이는 되돌릴 수 없는 작업입니다.

## 구문 요청
<a name="API_query_DeleteScheduledQuery_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_DeleteScheduledQuery_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) **   <a name="timestream-query_DeleteScheduledQuery-request-ScheduledQueryArn"></a>
예약된 쿼리의 ARN입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 항목 여부: 예

## 응답 요소
<a name="API_query_DeleteScheduledQuery_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_query_DeleteScheduledQuery_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
계정 설정에 액세스하는 데 필요한 권한이 없습니다.  
HTTP 상태 코드: 400

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
요청한 리소스를 찾을 수 없습니다.    
 ** ScheduledQueryArn **   
예약된 쿼리의 ARN입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_DeleteScheduledQuery_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DeleteScheduledQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DeleteScheduledQuery) 

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

쿼리 요금 모델과 서비스가 쿼리 워크로드에 사용할 수 있는 구성된 최대 TCU를 포함하는 계정의 설정을 설명합니다.

워크로드에 사용된 컴퓨팅 유닛 기간에 대해서만 요금이 부과됩니다.

## Response Syntax
<a name="API_query_DescribeAccountSettings_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_query_DescribeAccountSettings_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [MaxQueryTCU](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-MaxQueryTCU"></a>
서비스가 언제든지 쿼리를 처리하는 데 사용할 [Timestream 컴퓨팅 유닛](https://docs.aws.amazon.com/timestream/latest/developerguide/tcu.html)(TCU)의 최대 수입니다. 쿼리를 실행하려면 최소 용량을 4TCU로 설정해야 합니다. 예를 들어 4, 8, 16, 32 등과 같이 최대 TCU 수를 4의 배수로 설정할 수 있습니다. 이 구성은 (TCU)의 온디맨드 사용에만 적용됩니다.  
유형: 정수

 ** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryCompute"></a>
쿼리 워크로드에 대한 계정의 Timestream 컴퓨팅 유닛(TCU)에 대한 사용 설정을 포함하는 객체입니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다.  
유형: [QueryComputeResponse](API_query_QueryComputeResponse.md)객체

 ** [QueryPricingModel](#API_query_DescribeAccountSettings_ResponseSyntax) **   <a name="timestream-query_DescribeAccountSettings-response-QueryPricingModel"></a>
계정의 쿼리에 대한 요금 모델입니다.  
`QueryPricingModel` 파라미터는 여러 Timestream 작업에서 사용하지만 `UpdateAccountSettings` API 작업은 `COMPUTE_UNITS` 이외의 값을 인식하지 못합니다.
타입: 문자열  
유효 값: `BYTES_SCANNED | COMPUTE_UNITS` 

## 오류
<a name="API_query_DescribeAccountSettings_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
계정 설정에 액세스하는 데 필요한 권한이 없습니다.  
HTTP 상태 코드: 400

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_DescribeAccountSettings_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeAccountSettings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeAccountSettings) 

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

DescribeEndpoints는 Timestream API 직접 호출에 사용할 수 있는 엔드포인트 목록을 반환합니다. 이 API는 Write 및 Query를 통해 사용할 수 있습니다.

Timestream SDK는 서비스 엔드포인트의 관리와 매핑을 포함하여 서비스의 아키텍처와 투명하게 연동되도록 설계되었으므로 *다음과 같은 경우가 아니면 이 API를 사용하지 않는 것이 좋습니다*.
+ [Timestream과 함께 VPC 엔드포인트(AWS PrivateLink)](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints)를 사용하고 있는 경우 
+ 애플리케이션에서 아직 SDK를 지원하지 않는 프로그래밍 언어를 사용하는 경우
+ 클라이언트 측 구현에 대한 더 나은 제어가 필요한 경우

DescribeEndpoints를 사용하고 구현하는 방법과 시점에 대한 자세한 내용은 [엔드포인트 검색 패턴](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery)을 참조하세요.

## Response Syntax
<a name="API_query_DescribeEndpoints_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_query_DescribeEndpoints_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Endpoints](#API_query_DescribeEndpoints_ResponseSyntax) **   <a name="timestream-query_DescribeEndpoints-response-Endpoints"></a>
`DescribeEndpoints` 요청이 이루어지면 `Endpoints` 객체가 반환됩니다.  
타입: [Endpoint](API_query_Endpoint.md) 객체 배열

## 오류
<a name="API_query_DescribeEndpoints_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_DescribeEndpoints_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeEndpoints) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeEndpoints) 

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

예약된 쿼리에 대한 자세한 정보를 제공합니다.

## 구문 요청
<a name="API_query_DescribeScheduledQuery_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_DescribeScheduledQuery_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) **   <a name="timestream-query_DescribeScheduledQuery-request-ScheduledQueryArn"></a>
예약된 쿼리의 ARN입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 항목 여부: 예

## 응답 구문
<a name="API_query_DescribeScheduledQuery_ResponseSyntax"></a>

```
{
   "ScheduledQuery": { 
      "Arn": "string",
      "CreationTime": number,
      "ErrorReportConfiguration": { 
         "S3Configuration": { 
            "BucketName": "string",
            "EncryptionOption": "string",
            "ObjectKeyPrefix": "string"
         }
      },
      "KmsKeyId": "string",
      "LastRunSummary": { 
         "ErrorReportLocation": { 
            "S3ReportLocation": { 
               "BucketName": "string",
               "ObjectKey": "string"
            }
         },
         "ExecutionStats": { 
            "BytesMetered": number,
            "CumulativeBytesScanned": number,
            "DataWrites": number,
            "ExecutionTimeInMillis": number,
            "QueryResultRows": number,
            "RecordsIngested": number
         },
         "FailureReason": "string",
         "InvocationTime": number,
         "QueryInsightsResponse": { 
            "OutputBytes": number,
            "OutputRows": number,
            "QuerySpatialCoverage": { 
               "Max": { 
                  "PartitionKey": [ "string" ],
                  "TableArn": "string",
                  "Value": number
               }
            },
            "QueryTableCount": number,
            "QueryTemporalRange": { 
               "Max": { 
                  "TableArn": "string",
                  "Value": number
               }
            }
         },
         "RunStatus": "string",
         "TriggerTime": number
      },
      "Name": "string",
      "NextInvocationTime": number,
      "NotificationConfiguration": { 
         "SnsConfiguration": { 
            "TopicArn": "string"
         }
      },
      "PreviousInvocationTime": number,
      "QueryString": "string",
      "RecentlyFailedRuns": [ 
         { 
            "ErrorReportLocation": { 
               "S3ReportLocation": { 
                  "BucketName": "string",
                  "ObjectKey": "string"
               }
            },
            "ExecutionStats": { 
               "BytesMetered": number,
               "CumulativeBytesScanned": number,
               "DataWrites": number,
               "ExecutionTimeInMillis": number,
               "QueryResultRows": number,
               "RecordsIngested": number
            },
            "FailureReason": "string",
            "InvocationTime": number,
            "QueryInsightsResponse": { 
               "OutputBytes": number,
               "OutputRows": number,
               "QuerySpatialCoverage": { 
                  "Max": { 
                     "PartitionKey": [ "string" ],
                     "TableArn": "string",
                     "Value": number
                  }
               },
               "QueryTableCount": number,
               "QueryTemporalRange": { 
                  "Max": { 
                     "TableArn": "string",
                     "Value": number
                  }
               }
            },
            "RunStatus": "string",
            "TriggerTime": number
         }
      ],
      "ScheduleConfiguration": { 
         "ScheduleExpression": "string"
      },
      "ScheduledQueryExecutionRoleArn": "string",
      "State": "string",
      "TargetConfiguration": { 
         "TimestreamConfiguration": { 
            "DatabaseName": "string",
            "DimensionMappings": [ 
               { 
                  "DimensionValueType": "string",
                  "Name": "string"
               }
            ],
            "MeasureNameColumn": "string",
            "MixedMeasureMappings": [ 
               { 
                  "MeasureName": "string",
                  "MeasureValueType": "string",
                  "MultiMeasureAttributeMappings": [ 
                     { 
                        "MeasureValueType": "string",
                        "SourceColumn": "string",
                        "TargetMultiMeasureAttributeName": "string"
                     }
                  ],
                  "SourceColumn": "string",
                  "TargetMeasureName": "string"
               }
            ],
            "MultiMeasureMappings": { 
               "MultiMeasureAttributeMappings": [ 
                  { 
                     "MeasureValueType": "string",
                     "SourceColumn": "string",
                     "TargetMultiMeasureAttributeName": "string"
                  }
               ],
               "TargetMultiMeasureName": "string"
            },
            "TableName": "string",
            "TimeColumn": "string"
         }
      }
   }
}
```

## 응답 요소
<a name="API_query_DescribeScheduledQuery_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ScheduledQuery](#API_query_DescribeScheduledQuery_ResponseSyntax) **   <a name="timestream-query_DescribeScheduledQuery-response-ScheduledQuery"></a>
예약된 쿼리입니다.  
타입: [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) 객체

## 오류
<a name="API_query_DescribeScheduledQuery_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
계정 설정에 액세스하는 데 필요한 권한이 없습니다.  
HTTP 상태 코드: 400

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
요청한 리소스를 찾을 수 없습니다.    
 ** ScheduledQueryArn **   
예약된 쿼리의 ARN입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_DescribeScheduledQuery_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeScheduledQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeScheduledQuery) 

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

 이 API를 사용하여 예약된 쿼리를 수동으로 실행할 수 있습니다.

`QueryInsights`를 활성화한 경우 이 API는 Amazon SNS 알림의 일부로 실행한 쿼리와 관련된 인사이트 및 지표도 반환합니다. `QueryInsights`는 쿼리의 성능 튜닝을 지원합니다. `QueryInsights`에 대한 자세한 내용은 [쿼리 인사이트를 사용하여 Amazon Timestream에서 쿼리 최적화](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html)를 참조하세요.

## 구문 요청
<a name="API_query_ExecuteScheduledQuery_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_ExecuteScheduledQuery_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ClientToken"></a>
사용하지 않음   
유형: 문자열  
길이 제약: 최소 길이는 32입니다. 최대 길이 128.  
필수 여부: 아니요

 ** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-InvocationTime"></a>
UTC의 타임스탬프입니다. 쿼리는 이 타임스탬프에서 간접적으로 호출된 것처럼 실행됩니다.  
유형: 타임스탬프  
필수 항목 여부: 예

 ** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-QueryInsights"></a>
`QueryInsights`를 활성화하기 위한 설정을 캡슐화합니다.  
`QueryInsights`를 활성화하면 실행한 쿼리에 대한 Amazon SNS 알림의 일부로 인사이트와 지표가 반환됩니다. `QueryInsights`를 사용하여 쿼리 성능 및 비용을 조정할 수 있습니다.  
유형: [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md)객체  
필수 여부: 아니요

 ** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) **   <a name="timestream-query_ExecuteScheduledQuery-request-ScheduledQueryArn"></a>
예약된 쿼리의 ARN입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 항목 여부: 예

## 응답 요소
<a name="API_query_ExecuteScheduledQuery_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_query_ExecuteScheduledQuery_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
계정 설정에 액세스하는 데 필요한 권한이 없습니다.  
HTTP 상태 코드: 400

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
요청한 리소스를 찾을 수 없습니다.    
 ** ScheduledQueryArn **   
예약된 쿼리의 ARN입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

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

### ENABLED\$1WITH\$1RATE\$1CONTROL 모드에 대한 예약된 쿼리 알림 메시지
<a name="API_query_ExecuteScheduledQuery_Example_1"></a>

다음 예제에서는 `QueryInsights` 파라미터의 `ENABLED_WITH_RATE_CONTROL` 모드에 대한 성공적인 예약 쿼리 알림 메시지를 보여줍니다.

```
"SuccessNotificationMessage": {
    "type": "MANUAL_TRIGGER_SUCCESS",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-49c6ed55-c2e7-4cc2-9956-4a0ecea13420-80e05b035236a4c3",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1723710546,
        "triggerTimeMillis": 1723710547490,
        "runStatus": "MANUAL_TRIGGER_SUCCESS",
        "executionStats": {
            "executionTimeInMillis": 17343,
            "dataWrites": 1024,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 600,
            "recordsIngested": 1,
            "queryResultRows": 1
        },
        "queryInsightsResponse": {
            "querySpatialCoverage": {
                "max": {
                    "value": 1.0,
                    "tableArn": "arn:aws:timestream:<Region>:<Account>:database/BaseDb/table/BaseTable",
                    "partitionKey": [
                        "measure_name"
                    ]
                }
            },
            "queryTemporalRange": {
                "max": {
                    "value": 2399999999999,
                    "tableArn": "arn:aws:timestream:<Region>:<Account>:database/BaseDb/table/BaseTable"
                }
            },
            "queryTableCount": 1,
            "outputRows": 1,
            "outputBytes": 59
        }
    }
}
```

### DISABLED 모드에 대한 예약된 쿼리 알림 메시지
<a name="API_query_ExecuteScheduledQuery_Example_2"></a>

다음 예제에서는 `QueryInsights` 파라미터의 `DISABLED` 모드에 대한 성공적인 예약 쿼리 알림 메시지를 보여줍니다.

```
"SuccessNotificationMessage": {
    "type": "MANUAL_TRIGGER_SUCCESS",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-fa109d9e-6528-4a0d-ac40-482fa05e657f-140faaeecdc5b2a7",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1723711401,
        "triggerTimeMillis": 1723711402144,
        "runStatus": "MANUAL_TRIGGER_SUCCESS",
        "executionStats": {
            "executionTimeInMillis": 17992,
            "dataWrites": 1024,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 600,
            "recordsIngested": 1,
            "queryResultRows": 1
        }
    }
}
```

### ENABLED\$1WITH\$1RATE\$1CONTROL 모드에 대한 실패 알림 메시지
<a name="API_query_ExecuteScheduledQuery_Example_3"></a>

다음 예제에서는 `QueryInsights` 파라미터의 `ENABLED_WITH_RATE_CONTROL` 모드에 대해 실패한 예약된 쿼리 알림 메시지를 보여줍니다.

```
"FailureNotificationMessage": {
    "type": "MANUAL_TRIGGER_FAILURE",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1727915513,
        "triggerTimeMillis": 1727915513894,
        "runStatus": "MANUAL_TRIGGER_FAILURE",
        "executionStats": {
            "executionTimeInMillis": 10777,
            "dataWrites": 0,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 0,
            "recordsIngested": 0,
            "queryResultRows": 4
        },
        "errorReportLocation": {
            "s3ReportLocation": {
                "bucketName": "amzn-s3-demo-bucket",
                "objectKey": "4my-organization-f7a3c5d065a1a95e/1727915513/MANUAL/1727915513894/5e14b3df-b147-49f4-9331-784f749b68ae"
            }
        },
        "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details"
    }
}
```

### 비활성화 모드에 대한 실패 알림 메시지
<a name="API_query_ExecuteScheduledQuery_Example_4"></a>

다음 예제에서는 `QueryInsights` 파라미터의 `DISABLED` 모드에 대해 실패한 예약된 쿼리 알림 메시지를 보여줍니다.

```
"FailureNotificationMessage": {
    "type": "MANUAL_TRIGGER_FAILURE",
    "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d",
    "scheduledQueryRunSummary": {
        "invocationEpochSecond": 1727915194,
        "triggerTimeMillis": 1727915195119,
        "runStatus": "MANUAL_TRIGGER_FAILURE",
        "executionStats": {
            "executionTimeInMillis": 10777,
            "dataWrites": 0,
            "bytesMetered": 0,
            "cumulativeBytesScanned": 0,
            "recordsIngested": 0,
            "queryResultRows": 4
        },
        "errorReportLocation": {
            "s3ReportLocation": {
                "bucketName": "amzn-s3-demo-bucket",
                "objectKey": "4my-organization-b7e27a1d79be226d/1727915194/MANUAL/1727915195119/08dea9f5-9a0a-4e63-a5f7-ded23247bb98"
            }
        },
        "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details"
    }
}
```

## 참고
<a name="API_query_ExecuteScheduledQuery_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ExecuteScheduledQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecuteScheduledQuery) 

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

호출자의 Amazon 계정 및 리전에서 예약된 모든 쿼리 목록을 가져옵니다. `ListScheduledQueries`는 최종적으로 일관됩니다.

## 구문 요청
<a name="API_query_ListScheduledQueries_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_ListScheduledQueries_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-MaxResults"></a>
출력에서 반환할 최대 항목 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 출력에 `NextToken`이 제공됩니다. 페이지 매김을 재개하려면 후속 `ListScheduledQueriesRequest` 직접 호출에 대한 인수로 `NextToken` 값을 제공합니다.  
타입: 정수  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.  
필수 여부: 아니요

 ** [NextToken](#API_query_ListScheduledQueries_RequestSyntax) **   <a name="timestream-query_ListScheduledQueries-request-NextToken"></a>
 페이지 매김을 재개하기 위한 페이지 매김 토큰입니다.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<a name="API_query_ListScheduledQueries_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "ScheduledQueries": [ 
      { 
         "Arn": "string",
         "CreationTime": number,
         "ErrorReportConfiguration": { 
            "S3Configuration": { 
               "BucketName": "string",
               "EncryptionOption": "string",
               "ObjectKeyPrefix": "string"
            }
         },
         "LastRunStatus": "string",
         "Name": "string",
         "NextInvocationTime": number,
         "PreviousInvocationTime": number,
         "State": "string",
         "TargetDestination": { 
            "TimestreamDestination": { 
               "DatabaseName": "string",
               "TableName": "string"
            }
         }
      }
   ]
}
```

## 응답 요소
<a name="API_query_ListScheduledQueries_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_query_ListScheduledQueries_ResponseSyntax) **   <a name="timestream-query_ListScheduledQueries-response-NextToken"></a>
페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이는 이전에 잘린 응답의 NextToken입니다.  
유형: 문자열

 ** [ScheduledQueries](#API_query_ListScheduledQueries_ResponseSyntax) **   <a name="timestream-query_ListScheduledQueries-response-ScheduledQueries"></a>
예약된 쿼리 목록입니다.  
타입: [ScheduledQuery](API_query_ScheduledQuery.md) 객체 배열

## 오류
<a name="API_query_ListScheduledQueries_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
계정 설정에 액세스하는 데 필요한 권한이 없습니다.  
HTTP 상태 코드: 400

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_ListScheduledQueries_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListScheduledQueries) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListScheduledQueries) 

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

Timestream 쿼리 리소스의 모든 태그를 나열합니다.

## 구문 요청
<a name="API_query_ListTagsForResource_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_ListTagsForResource_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-MaxResults"></a>
반환할 최대 태그 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최대값은 200입니다.  
필수 여부: 아니요

 ** [NextToken](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-NextToken"></a>
페이지 매김을 재개하기 위한 페이지 매김 토큰입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) **   <a name="timestream-query_ListTagsForResource-request-ResourceARN"></a>
목록으로 나열할 태그가 있는 Timestream 리소스입니다. 이 값은 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 항목 여부: 예

## 응답 구문
<a name="API_query_ListTagsForResource_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_query_ListTagsForResource_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-NextToken"></a>
후속 `ListTagsForResourceResponse` 직접 호출로 페이지 매김을 재개하는 페이지 매김 토큰입니다.  
유형: 문자열

 ** [Tags](#API_query_ListTagsForResource_ResponseSyntax) **   <a name="timestream-query_ListTagsForResource-response-Tags"></a>
현재 Timestream 리소스와 연결된 태그입니다.  
타입: [Tag](API_query_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

## 오류
<a name="API_query_ListTagsForResource_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
요청한 리소스를 찾을 수 없습니다.    
 ** ScheduledQueryArn **   
예약된 쿼리의 ARN입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_ListTagsForResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListTagsForResource) 

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

나중에 실행할 수 있도록 Timestream에서 저장할 파라미터가 포함된 쿼리를 제출할 수 있는 동기식 작업입니다. Timestream은 `ValidateOnly`가 `true`로 설정된 이 작업의 사용만 지원합니다.

## 구문 요청
<a name="API_query_PrepareQuery_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_PrepareQuery_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [QueryString](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-QueryString"></a>
준비된 문으로 사용할 Timestream 쿼리 문자열입니다. 쿼리 문자열 `@` 문자와 식별자로 파라미터 이름을 지정할 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 262144자입니다.  
필수 항목 여부: 예

 ** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-ValidateOnly"></a>
이 값을 `true`로 설정하면 Timestream은 쿼리 문자열이 유효한 Timestream 쿼리인지만 검증하고 나중에 사용할 수 있도록 준비된 쿼리를 저장하지 않습니다.  
유형: 부울  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_query_PrepareQuery_ResponseSyntax"></a>

```
{
   "Columns": [ 
      { 
         "Aliased": boolean,
         "DatabaseName": "string",
         "Name": "string",
         "TableName": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "Parameters": [ 
      { 
         "Name": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "QueryString": "string"
}
```

## 응답 요소
<a name="API_query_PrepareQuery_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Columns](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Columns"></a>
제출된 쿼리 문자열의 SELECT 절 열 목록입니다.  
타입: [SelectColumn](API_query_SelectColumn.md)객체 배열

 ** [Parameters](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Parameters"></a>
제출된 쿼리 문자열에 사용되는 파라미터 목록입니다.  
타입: [ParameterMapping](API_query_ParameterMapping.md)객체 배열

 ** [QueryString](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-QueryString"></a>
준비하려는 쿼리 문자열입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 262144자입니다.

## 오류
<a name="API_query_PrepareQuery_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
계정 설정에 액세스하는 데 필요한 권한이 없습니다.  
HTTP 상태 코드: 400

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_PrepareQuery_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/PrepareQuery) 

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

 `Query`는 Amazon Timestream 데이터에 대해 쿼리를 실행할 수 있는 동기식 작업입니다.

`QueryInsights`를 활성화한 경우 이 API는 실행한 쿼리와 관련된 인사이트 및 지표도 반환합니다. `QueryInsights`는 쿼리의 성능 튜닝에 도움이 됩니다. `QueryInsights`에 대한 자세한 내용은 [쿼리 인사이트를 사용하여 Amazon Timestream에서 쿼리 최적화](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html)를 참조하세요.

**참고**  
`QueryInsights`가 활성화된 상태에서 수행할 수 있는 최대 `Query` API 요청 수는 초당 쿼리(QPS) 1개입니다. 이 쿼리 속도를 초과하면 스로틀링이 발생할 수 있습니다.

 `Query`는 60초 후에 시간 초과됩니다. 60초의 제한 시간을 지원하도록 SDK의 기본 제한 시간을 업데이트해야 합니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html)을 참조하세요.

다음과 같은 경우 쿼리 요청이 실패합니다.
+  5분 멱등성 기간을 벗어나 동일한 클라이언트 토큰으로 `Query` 요청을 제출하는 경우.
+  동일한 클라이언트 토큰으로 `Query` 요청을 제출하지만 5분 멱등성 기간 내에 다른 파라미터를 변경하는 경우.
+  행 크기(쿼리 메타데이터 포함)가 1MB를 초과하면 쿼리가 실패하고 다음 오류 메시지가 표시됩니다.

   `Query aborted as max page response size has been exceeded by the output result row` 
+  쿼리 이니시에이터와 결과 리더의 IAM 위탁자가 동일하지 않거나 쿼리 이니시에이터와 결과 리더의 쿼리 요청에 동일한 쿼리 문자열이 없는 경우 쿼리가 실패하고 `Invalid pagination token` 오류가 발생합니다.

## 구문 요청
<a name="API_query_Query_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_Query_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ClientToken](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-ClientToken"></a>
 `Query` 요청 시 지정된 최대 64개의 ASCII 문자로 구성된 고유한 대소문자 구분 문자열입니다. `ClientToken`을 제공하면 `Query` *멱등성*이 직접적으로 호출됩니다. 즉, 동일한 쿼리를 반복적으로 실행하면 동일한 결과가 생성됩니다. 즉, 동일한 `Query` 요청을 여러 개 생성하는 것은 단일 요청을 생성하는 것과 같은 효과를 냅니다. 쿼리에서 `ClientToken`을 사용하는 경우 다음 사항에 유의하세요.  
+  Query API가 `ClientToken` 없이 인스턴스화되면 Query SDK가 사용자를 대신하여 `ClientToken`을 생성합니다.
+ `Query` 간접 호출에 `ClientToken`만 포함되고 `NextToken`은 포함되지 않는 경우 `Query`의 간접 호출은 새 쿼리 실행으로 간주됩니다.
+ 간접 호출에 `NextToken`이 포함된 경우 해당 특정 간접 호출은 Query API에 대한 이전 집적 호출의 후속 간접 호출로 간주되고 결과 세트가 반환됩니다.
+  4시간 후 동일한가 있는 모든 요청은 새 요청으로 `ClientToken` 처리됩니다.
유형: 문자열  
길이 제약: 최소 길이는 32입니다. 최대 길이 128.  
필수 여부: 아니요

 ** [MaxRows](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-MaxRows"></a>
 `Query` 출력에서 반환되는 총 행 수입니다. `MaxRows` 값이 지정된 `Query`를 처음 실행하면 두 가지 경우에 쿼리의 결과 세트가 반환됩니다.  
+ 결과의 크기가 `1MB`보다 작습니다.
+ 결과 세트의 행 수가 `maxRows` 값보다 작습니다.
그렇지 않으면 `Query`의 초기 간접 호출은 `NextToken`만 반환하며, 이후 직접 호출에서 결과 세트를 가져오는 데 사용할 수 있습니다. 페이지 매김을 재개하려면 후속 명령에 `NextToken` 값을 제공합니다.  
행 크기가 큰 경우(예: 행에 열이 많은 경우) Timestream은 응답 크기가 1MB 제한을 초과하지 않도록 더 적은 수의 행을 반환할 수 있습니다. `MaxRows`가 제공되지 않으면 Timestream은 1MB 제한을 충족하는 데 필요한 수의 행을 전송합니다.  
타입: 정수  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.  
필수 여부: 아니요

 ** [NextToken](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-NextToken"></a>
 결과 세트를 반환하는 데 사용되는 페이지 매김 토큰입니다. `NextToken`을 사용하여 `Query` API를 간접적으로 호출하면 해당 특정 간접 호출은 `Query`에 대한 이전 직접 호출의 후속 간접 호출로 간주되고 결과 세트가 반환됩니다. 그러나 `Query` 간접 호출에 `ClientToken`만 포함된 경우 `Query`의 간접 호출은 새 쿼리 실행으로 간주됩니다.  
쿼리에서 NextToken을 사용할 때 다음 사항에 유의하세요.  
+ 페이지 매김 토큰은 최대 5개의 `Query` 간접 호출 또는 최대 1시간 중 먼저 도래하는 기간에 사용할 수 있습니다.
+ 동일한 `NextToken`을 사용하면 동일한 레코드 세트가 반환됩니다. 결과 세트를 계속 페이지 매김하려면 최신 `nextToken`을 사용해야 합니다.
+ `Query` 간접 호출이 `TokenA` 및 `TokenB`라는 두 `NextToken` 값을 반환한다고 가정해 보겠습니다. 후속 `Query` 간접 호출에서 `TokenB`를 사용하는 경우 `TokenA`는 무효화되며 재사용할 수 없습니다.
+ 페이지 매김이 시작된 후 쿼리에서 이전 결과 세트를 요청하려면 Query API를 다시 간접적으로 호출해야 합니다.
+ `null`이 반환될 때까지 최신 `NextToken`을 사용하여 페이지를 매겨야 합니다. 이때 새 `NextToken`을 사용해야 합니다.
+  쿼리 이니시에이터와 결과 리더의 IAM 위탁자가 동일하지 않거나 쿼리 이니시에이터와 결과 리더의 쿼리 요청에 동일한 쿼리 문자열이 없는 경우 쿼리가 실패하고 `Invalid pagination token` 오류가 발생합니다.
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 여부: 아니요

 ** [QueryInsights](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryInsights"></a>
`QueryInsights`를 활성화하기 위한 설정을 캡슐화합니다.  
`QueryInsights`를 활성화하면 실행한 쿼리에 대한 쿼리 결과 외에도 인사이트와 지표가 반환됩니다. `QueryInsights`를 사용하여 쿼리 성능을 조정할 수 있습니다.  
유형: [QueryInsights](API_query_QueryInsights.md)객체  
필수 여부: 아니요

 ** [QueryString](#API_query_Query_RequestSyntax) **   <a name="timestream-query_Query-request-QueryString"></a>
 Timestream에서 실행할 쿼리입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 262144자입니다.  
필수 항목 여부: 예

## 응답 구문
<a name="API_query_Query_ResponseSyntax"></a>

```
{
   "ColumnInfo": [ 
      { 
         "Name": "string",
         "Type": { 
            "ArrayColumnInfo": "ColumnInfo",
            "RowColumnInfo": [ 
               "ColumnInfo"
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": "ColumnInfo"
         }
      }
   ],
   "NextToken": "string",
   "QueryId": "string",
   "QueryInsightsResponse": { 
      "OutputBytes": number,
      "OutputRows": number,
      "QuerySpatialCoverage": { 
         "Max": { 
            "PartitionKey": [ "string" ],
            "TableArn": "string",
            "Value": number
         }
      },
      "QueryTableCount": number,
      "QueryTemporalRange": { 
         "Max": { 
            "TableArn": "string",
            "Value": number
         }
      },
      "UnloadPartitionCount": number,
      "UnloadWrittenBytes": number,
      "UnloadWrittenRows": number
   },
   "QueryStatus": { 
      "CumulativeBytesMetered": number,
      "CumulativeBytesScanned": number,
      "ProgressPercentage": number
   },
   "Rows": [ 
      { 
         "Data": [ 
            { 
               "ArrayValue": [ 
                  "Datum"
               ],
               "NullValue": boolean,
               "RowValue": "Row",
               "ScalarValue": "string",
               "TimeSeriesValue": [ 
                  { 
                     "Time": "string",
                     "Value": "Datum"
                  }
               ]
            }
         ]
      }
   ]
}
```

## 응답 요소
<a name="API_query_Query_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ColumnInfo](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-ColumnInfo"></a>
 반환된 결과 세트의 열 데이터 유형입니다.  
타입: [ColumnInfo](API_query_ColumnInfo.md)객체 배열

 ** [NextToken](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-NextToken"></a>
 `Query` 직접 호출 시 다시 사용하여 다음 결과 세트를 가져올 수 있는 페이지 매김 토큰입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.

 ** [QueryId](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryId"></a>
 지정된 쿼리의 고유 ID입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `[a-zA-Z0-9]+` 

 ** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryInsightsResponse"></a>
실행한 쿼리와 관련된 인사이트 및 지표가 포함된 `QueryInsights`를 캡슐화합니다.  
유형: [QueryInsightsResponse](API_query_QueryInsightsResponse.md)객체

 ** [QueryStatus](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-QueryStatus"></a>
쿼리 상태에 대한 정보로, 진행률과 스캔된 바이트 수를 포함합니다.  
유형: [QueryStatus](API_query_QueryStatus.md)객체

 ** [Rows](#API_query_Query_ResponseSyntax) **   <a name="timestream-query_Query-response-Rows"></a>
 쿼리에서 반환되는 결과 세트 행입니다.  
타입: [Row](API_query_Row.md) 객체 배열

## 오류
<a name="API_query_Query_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
계정 설정에 액세스하는 데 필요한 권한이 없습니다.  
HTTP 상태 코드: 400

 ** ConflictException **   
 취소된 쿼리에 대한 결과를 폴링할 수 없습니다.  
HTTP 상태 코드: 400

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** QueryExecutionException **   
 Timestream이 쿼리를 성공적으로 실행할 수 없습니다.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_Query_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/Query) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/Query) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Query) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/Query) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Query) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/Query) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/Query) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/Query) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/Query) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Query) 

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

태그 세트를 Timestream 리소스와 연결합니다. 이러한 사용자 정의 태그를 활성화하면 Billing and Cost Management 콘솔에 표시되어 비용 할당을 추적할 수 있습니다.

## 구문 요청
<a name="API_query_TagResource_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_TagResource_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceARN](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-ResourceARN"></a>
태그를 추가해야 하는 Timestream 리소스를 식별합니다. 이 값은 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 항목 여부: 예

 ** [Tags](#API_query_TagResource_RequestSyntax) **   <a name="timestream-query_TagResource-request-Tags"></a>
Timestream 리소스에 할당할 태그입니다.  
타입: [Tag](API_query_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 예

## 응답 요소
<a name="API_query_TagResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_query_TagResource_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
요청한 리소스를 찾을 수 없습니다.    
 ** ScheduledQueryArn **   
예약된 쿼리의 ARN입니다.
HTTP 상태 코드: 400

 ** ServiceQuotaExceededException **   
서비스 할당량을 초과했습니다.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_TagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/TagResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TagResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/TagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/TagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/TagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TagResource) 

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

Timestream 쿼리 리소스에서 태그 연결을 제거합니다.

## 구문 요청
<a name="API_query_UntagResource_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_UntagResource_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceARN](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-ResourceARN"></a>
태그를 제거할 Timestream 리소스입니다. 이 값은 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 항목 여부: 예

 ** [TagKeys](#API_query_UntagResource_RequestSyntax) **   <a name="timestream-query_UntagResource-request-TagKeys"></a>
태그 키 목록입니다. 키가 이 목록의 멤버인 리소스의 기존 태그는 Timestream 리소스에서 제거됩니다.  
유형: 문자열 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
길이 제약: 최소 길이 1. 최대 길이는 128.  
필수 항목 여부: 예

## 응답 요소
<a name="API_query_UntagResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_query_UntagResource_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
요청한 리소스를 찾을 수 없습니다.    
 ** ScheduledQueryArn **   
예약된 쿼리의 ARN입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_UntagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UntagResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UntagResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UntagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UntagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UntagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UntagResource) 

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

쿼리 요금에 TCU 사용하도록 계정을 전환하고 구성한 최대 쿼리 컴퓨팅 유닛을 수정합니다. `MaxQueryTCU`의 값을 원하는 구성으로 줄이면 새 값이 적용되는 데 최대 24시간이 걸릴 수 있습니다.

**참고**  
쿼리 요금에 TCU 사용하도록 계정을 전환한 후에는 쿼리 요금에 스캔된 바이트 사용으로 전환할 수 없습니다.

## 구문 요청
<a name="API_query_UpdateAccountSettings_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_UpdateAccountSettings_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-MaxQueryTCU"></a>
서비스가 언제든지 쿼리를 처리하는 데 사용할 최대 컴퓨팅 유닛 수입니다. 쿼리를 실행하려면 최소 용량을 4TCU로 설정해야 합니다. 예를 들어 4, 8, 16, 32 등과 같이 최대 TCU 수를 4의 배수로 설정할 수 있습니다. `MaxQueryTCU`에 대해 지원되는 최댓값은 1,000입니다. 이 소프트 제한에 대한 증가를 요청하려면 AWS Support에 문의하세요. maxQueryTCU의 기본 할당량에 대한 자세한 내용은 기본 할당량을 참조하세요. 이 구성은 Timestream 컴퓨팅 유닛(TCU)의 온디맨드 사용에만 적용됩니다.  
`MaxQueryTCU`에 대해 지원되는 최댓값은 1,000입니다. 이 소프트 제한에 대한 증가를 요청하려면 AWS Support에 문의하세요. `maxQueryTCU`의 기본 할당량에 대한 자세한 내용은 [기본 할당량](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.default)을 참조하세요.  
유형: 정수  
필수 항목 여부: 아니요

 ** [QueryCompute](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryCompute"></a>
계정의 쿼리 요금 모델 및 프로비저닝된 Timestream 컴퓨팅 유닛(TCU)을 포함하여 계정에 구성된 쿼리 컴퓨팅 설정을 수정합니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다.  
이 API는 멱등성이 있습니다. 즉, 동일한 요청을 여러 번 수행하면 요청을 한 번 수행하는 것과 동일한 효과가 있습니다.
유형: [QueryComputeRequest](API_query_QueryComputeRequest.md)객체  
필수 여부: 아니요

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_RequestSyntax) **   <a name="timestream-query_UpdateAccountSettings-request-QueryPricingModel"></a>
계정의 쿼리에 대한 요금 모델입니다.  
`QueryPricingModel` 파라미터는 여러 Timestream 작업에서 사용하지만 `UpdateAccountSettings` API 작업은 `COMPUTE_UNITS` 이외의 값을 인식하지 못합니다.
타입: 문자열  
유효 값: `BYTES_SCANNED | COMPUTE_UNITS`   
필수 항목 여부: 아니요

## 응답 구문
<a name="API_query_UpdateAccountSettings_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_query_UpdateAccountSettings_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-MaxQueryTCU"></a>
서비스가 쿼리를 처리하는 데 언제든지 사용할 구성된 최대 컴퓨팅 유닛 수입니다.  
유형: 정수

 ** [QueryCompute](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryCompute"></a>
계정의 데이터를 쿼리하기 위해 업데이트된 계정 설정을 확인합니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다.  
유형: [QueryComputeResponse](API_query_QueryComputeResponse.md)객체

 ** [QueryPricingModel](#API_query_UpdateAccountSettings_ResponseSyntax) **   <a name="timestream-query_UpdateAccountSettings-response-QueryPricingModel"></a>
계정의 요금 모델입니다.  
타입: 문자열  
유효 값: `BYTES_SCANNED | COMPUTE_UNITS` 

## 오류
<a name="API_query_UpdateAccountSettings_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
계정 설정에 액세스하는 데 필요한 권한이 없습니다.  
HTTP 상태 코드: 400

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_UpdateAccountSettings_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateAccountSettings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateAccountSettings) 

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

예약된 쿼리를 업데이트합니다.

## 구문 요청
<a name="API_query_UpdateScheduledQuery_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_query_UpdateScheduledQuery_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-ScheduledQueryArn"></a>
예약 쿼리의 ARN입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 항목 여부: 예

 ** [State](#API_query_UpdateScheduledQuery_RequestSyntax) **   <a name="timestream-query_UpdateScheduledQuery-request-State"></a>
예약된 쿼리의 상태입니다.  
타입: 문자열  
유효 값: `ENABLED | DISABLED`   
필수 여부: 예

## 응답 요소
<a name="API_query_UpdateScheduledQuery_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_query_UpdateScheduledQuery_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
계정 설정에 액세스하는 데 필요한 권한이 없습니다.  
HTTP 상태 코드: 400

 ** InternalServerException **   
요청 처리 중 내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 400

 ** InvalidEndpointException **   
요청된 엔드포인트가 잘못되었습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
요청한 리소스를 찾을 수 없습니다.    
 ** ScheduledQueryArn **   
예약된 쿼리의 ARN입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
과도한 요청으로 인해 요청이 제한되었습니다.  
HTTP 상태 코드: 400

 ** ValidationException **   
 유효하지 않거나 잘못된 형식의 요청입니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_query_UpdateScheduledQuery_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateScheduledQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateScheduledQuery)