Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. [여기](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)에서 자세히 알아보세요. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # API 참조 이 섹션은 Amazon Timestream에 대한 API 참조 문서를 포함합니다. Timestream에는 쿼리와 쓰기라는 두 가지 API. + **Write API**를 사용하면 테이블 생성, 리소스 태그 지정 및 Timestream에 레코드 쓰기와 같은 작업을 수행할 수 있습니다. + **Query API**를 사용하면 쿼리 작업을 수행할 수 있습니다. **참고** 두 API 모두 DescribeEndpoints 작업을 포함합니다. *쿼리와 쓰기 모두에서 DescribeEndpoints 작업은 동일합니다.* 데이터 유형, 일반적인 오류 및 파라미터와 함께 아래에서 각 API에 대해 자세히 알아볼 수 있습니다. **참고** 모든 AWS 서비스에 공통적인 오류 코드는 [AWS 지원 섹션을](https://docs.aws.amazon.com/awssupport/latest/APIReference/CommonErrors.html) 참조하세요. **Topics** + [작업](API_Operations.md) + [데이터 타입](API_Types.md) + [일반적인 오류 유형](CommonErrors.md) + [공통 파라미터](CommonParameters.md) # 작업 Amazon Timestream 쓰기는 다음 작업을 지원합니다. + [CreateBatchLoadTask](API_CreateBatchLoadTask.md) + [CreateDatabase](API_CreateDatabase.md) + [CreateTable](API_CreateTable.md) + [DeleteDatabase](API_DeleteDatabase.md) + [DeleteTable](API_DeleteTable.md) + [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) + [DescribeDatabase](API_DescribeDatabase.md) + [DescribeEndpoints](API_DescribeEndpoints.md) + [DescribeTable](API_DescribeTable.md) + [ListBatchLoadTasks](API_ListBatchLoadTasks.md) + [ListDatabases](API_ListDatabases.md) + [ListTables](API_ListTables.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateDatabase](API_UpdateDatabase.md) + [UpdateTable](API_UpdateTable.md) + [WriteRecords](API_WriteRecords.md) 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) # Amazon Timestream Write Amazon Timestream 쓰기는 다음 작업을 지원합니다. + [CreateBatchLoadTask](API_CreateBatchLoadTask.md) + [CreateDatabase](API_CreateDatabase.md) + [CreateTable](API_CreateTable.md) + [DeleteDatabase](API_DeleteDatabase.md) + [DeleteTable](API_DeleteTable.md) + [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) + [DescribeDatabase](API_DescribeDatabase.md) + [DescribeEndpoints](API_DescribeEndpoints.md) + [DescribeTable](API_DescribeTable.md) + [ListBatchLoadTasks](API_ListBatchLoadTasks.md) + [ListDatabases](API_ListDatabases.md) + [ListTables](API_ListTables.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateDatabase](API_UpdateDatabase.md) + [UpdateTable](API_UpdateTable.md) + [WriteRecords](API_WriteRecords.md) # CreateBatchLoadTask 새 Timestream 배치 로드 태스크를 생성합니다. 배치 로드 태스크는 S3 위치의 CSV 소스에서 데이터를 처리하고 Timestream 테이블에 씁니다. 소스에서 대상으로의 매핑은 배치 로드 태스크에서 정의됩니다. 오류와 이벤트는 S3 위치의 보고서에 작성됩니다. 보고서의 경우 AWS KMS 키가 지정되지 않은 경우가 옵션`SSE_S3`일 때 보고서가 S3 관리형 키로 암호화됩니다. 그렇지 않으면 오류가 발생합니다. 자세한 내용은 [AWS 관리형 키](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)를 참조하세요. [서비스 할당량이 적용](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)됩니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html)을 참조하세요. ## 구문 요청 ``` { "ClientToken": "string", "DataModelConfiguration": { "DataModel": { "DimensionMappings": [ { "DestinationColumn": "string", "SourceColumn": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TimeColumn": "string", "TimeUnit": "string" }, "DataModelS3Configuration": { "BucketName": "string", "ObjectKey": "string" } }, "DataSourceConfiguration": { "CsvConfiguration": { "ColumnSeparator": "string", "EscapeChar": "string", "NullValue": "string", "QuoteChar": "string", "TrimWhiteSpace": boolean }, "DataFormat": "string", "DataSourceS3Configuration": { "BucketName": "string", "ObjectKeyPrefix": "string" } }, "RecordVersion": number, "ReportConfiguration": { "ReportS3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } }, "TargetDatabaseName": "string", "TargetTableName": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) ** 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 필수 여부: 아니요 ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** 유형: [DataModelConfiguration](API_DataModelConfiguration.md)객체 필수 여부: 아니요 ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** 배치 로드 태스크의 데이터 소스에 대한 구성 세부 정보를 정의합니다. 타입: [DataSourceConfiguration](API_DataSourceConfiguration.md)객체 필수 항목 여부: 예 ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) ** 유형: Long 필수 여부: 아니요 ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** 배치 로드 태스크에 대한 보고서 구성입니다. 여기에는 오류 보고서가 저장되는 위치에 대한 세부 정보가 포함됩니다. 타입: [ReportConfiguration](API_ReportConfiguration.md)객체 필수 항목 여부: 예 ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) ** 배치 로드 태스크의 대상 Timestream 데이터베이스입니다. 유형: String 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 예 ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) ** 배치 로드 태스크의 대상 Timestream 테이블입니다. 유형: String 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 예 ## 응답 구문 ``` { "TaskId": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) ** 배치 로드 태스크의 ID입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이 32. 패턴: `[A-Z0-9]+` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** ConflictException ** Timestream은 이미 존재하는 리소스를 포함하기 때문에 이 요청을 처리할 수 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ServiceQuotaExceededException ** 이 계정에 대한 리소스의 인스턴스 할당량을 초과했습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask) # CreateDatabase 새 Timestream 데이터베이스를 생성합니다. AWS KMS 키가 지정되지 않은 경우 데이터베이스는 계정에 있는 Timestream 관리형 AWS KMS 키로 암호화됩니다. 자세한 내용은 [AWS 관리형 키](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)를 참조하세요. [서비스 할당량이 적용](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)됩니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html)을 참조하세요. ## 구문 요청 ``` { "DatabaseName": "string", "KmsKeyId": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [DatabaseName](#API_CreateDatabase_RequestSyntax) ** Timestream 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 예 ** [KmsKeyId](#API_CreateDatabase_RequestSyntax) ** 데이터베이스의 AWS KMS 키입니다. AWS KMS 키가 지정되지 않은 경우 데이터베이스는 계정에 있는 Timestream 관리형 AWS KMS 키로 암호화됩니다. 자세한 내용은 [AWS 관리형 키](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)를 참조하세요. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 ** [Tags](#API_CreateDatabase_RequestSyntax) ** 테이블에 레이블을 지정할 키-값 페어의 목록입니다. 타입: [Tag](API_Tag.md)객체 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Database](#API_CreateDatabase_ResponseSyntax) ** 새로 생성된 Timestream 데이터베이스입니다. 타입: [Database](API_Database.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** ConflictException ** Timestream은 이미 존재하는 리소스를 포함하기 때문에 이 요청을 처리할 수 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ServiceQuotaExceededException ** 이 계정에 대한 리소스의 인스턴스 할당량을 초과했습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateDatabase) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateDatabase) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateDatabase) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateDatabase) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateDatabase) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateDatabase) # CreateTable 사용자 계정의 기존 데이터베이스에 새 테이블을 추가합니다. 에서 AWS 계정테이블 이름은 동일한 데이터베이스에 있는 경우 각 리전 내에서 최소한 고유해야 합니다. 테이블이 별도의 데이터베이스에 있는 경우 동일한 리전에서 동일한 테이블 이름을 가질 수 있습니다. 테이블을 생성하는 동안 테이블 이름, 데이터베이스 이름 및 보존 속성을 지정해야 합니다. [서비스 할당량이 적용](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)됩니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html)을 참조하세요. ## 구문 요청 ``` { "DatabaseName": "string", "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [DatabaseName](#API_CreateTable_RequestSyntax) ** Timestream 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 예 ** [MagneticStoreWriteProperties](#API_CreateTable_RequestSyntax) ** 마그네틱 스토어 쓰기를 활성화할 때 테이블에 설정할 속성이 들어 있습니다. 유형: [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)객체 필수 여부: 아니요 ** [RetentionProperties](#API_CreateTable_RequestSyntax) ** 메모리 스토어와 마그네틱 스토어에 시계열 데이터를 저장해야 하는 기간입니다. 유형: [RetentionProperties](API_RetentionProperties.md)객체 필수 여부: 아니요 ** [Schema](#API_CreateTable_RequestSyntax) ** 테이블의 스키마입니다. 유형: [Schema](API_Schema.md)객체 필수 여부: 아니요 ** [TableName](#API_CreateTable_RequestSyntax) ** Timestream 테이블의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256입니다. 패턴: `[a-zA-Z0-9_.-]+` 필수 여부: 예 ** [Tags](#API_CreateTable_RequestSyntax) ** 테이블에 레이블을 지정할 키-값 페어의 목록입니다. 타입: [Tag](API_Tag.md)객체 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "Table": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Table](#API_CreateTable_ResponseSyntax) ** 새로 생성된 Timestream 테이블입니다. 타입: [Table](API_Table.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** ConflictException ** Timestream은 이미 존재하는 리소스를 포함하기 때문에 이 요청을 처리할 수 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ServiceQuotaExceededException ** 이 계정에 대한 리소스의 인스턴스 할당량을 초과했습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateTable) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateTable) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateTable) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateTable) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateTable) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateTable) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateTable) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateTable) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateTable) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateTable) # DeleteDatabase 지정된 Timestream 데이터베이스를 삭제합니다. *이는 되돌릴 수 없는 작업입니다. 데이터베이스를 삭제한 후에는 테이블의 시계열 데이터를 복구할 수 없습니다.* **참고** 데이터베이스의 모든 테이블을 먼저 삭제해야 합니다. 그렇지 않으면 ValidationException 오류가 발생합니다. 분산 재시도의 특성으로 인해 작업은 성공 또는 ResourceNotFoundException을 반환할 수 있습니다. 클라이언트는 이를 동등한 것으로 간주해야 합니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html)을 참조하세요. ## 구문 요청 ``` { "DatabaseName": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [DatabaseName](#API_DeleteDatabase_RequestSyntax) ** 삭제할 Timestream 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 항목 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DeleteDatabase) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteDatabase) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteDatabase) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteDatabase) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteDatabase) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteDatabase) # DeleteTable 지정된 Timestream 테이블을 삭제합니다. 이는 되돌릴 수 없는 작업입니다. Timestream 데이터베이스 테이블을 삭제한 후에는 테이블에 저장된 시계열 데이터를 복구할 수 없습니다. **참고** 분산 재시도의 특성으로 인해 작업은 성공 또는 ResourceNotFoundException을 반환할 수 있습니다. 클라이언트는 이를 동등한 것으로 간주해야 합니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html)을 참조하세요. ## 구문 요청 ``` { "DatabaseName": "string", "TableName": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [DatabaseName](#API_DeleteTable_RequestSyntax) ** Timestream 데이터베이스를 삭제할 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 항목 여부: 예 ** [TableName](#API_DeleteTable_RequestSyntax) ** 삭제할 Timestream 테이블의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 항목 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DeleteTable) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteTable) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteTable) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteTable) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteTable) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteTable) # DescribeBatchLoadTask 구성, 매핑, 진행 상황 및 기타 세부 정보를 포함하여 배치 로드 태스크에 대한 정보를 반환합니다. [서비스 할당량이 적용](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)됩니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-batch-load.html)을 참조하세요. ## 구문 요청 ``` { "TaskId": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [TaskId](#API_DescribeBatchLoadTask_RequestSyntax) ** 배치 로드 태스크의 ID입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이 32. 패턴: `[A-Z0-9]+` 필수 여부: 예 ## 응답 구문 ``` { "BatchLoadTaskDescription": { "CreationTime": number, "DataModelConfiguration": { "DataModel": { "DimensionMappings": [ { "DestinationColumn": "string", "SourceColumn": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TimeColumn": "string", "TimeUnit": "string" }, "DataModelS3Configuration": { "BucketName": "string", "ObjectKey": "string" } }, "DataSourceConfiguration": { "CsvConfiguration": { "ColumnSeparator": "string", "EscapeChar": "string", "NullValue": "string", "QuoteChar": "string", "TrimWhiteSpace": boolean }, "DataFormat": "string", "DataSourceS3Configuration": { "BucketName": "string", "ObjectKeyPrefix": "string" } }, "ErrorMessage": "string", "LastUpdatedTime": number, "ProgressReport": { "BytesMetered": number, "FileFailures": number, "ParseFailures": number, "RecordIngestionFailures": number, "RecordsIngested": number, "RecordsProcessed": number }, "RecordVersion": number, "ReportConfiguration": { "ReportS3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } }, "ResumableUntil": number, "TargetDatabaseName": "string", "TargetTableName": "string", "TaskId": "string", "TaskStatus": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [BatchLoadTaskDescription](#API_DescribeBatchLoadTask_ResponseSyntax) ** 배치 로드 태스크에 대한 설명입니다. 타입: [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeBatchLoadTask) # DescribeDatabase 데이터베이스 이름, 데이터베이스가 생성된 시간, 데이터베이스 내에서 발견된 총 테이블 수를 포함하여 데이터베이스에 대한 정보를 반환합니다. [서비스 할당량이 적용](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)됩니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html)을 참조하세요. ## 구문 요청 ``` { "DatabaseName": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [DatabaseName](#API_DescribeDatabase_RequestSyntax) ** Timestream 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 여부: 예 ## 응답 구문 ``` { "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Database](#API_DescribeDatabase_ResponseSyntax) ** Timestream 테이블의 이름입니다. 타입: [Database](API_Database.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeDatabase) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeDatabase) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeDatabase) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeDatabase) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeDatabase) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeDatabase) # DescribeEndpoints Timestream API 직접 호출에 사용할 수 있는 엔드포인트 목록을 반환합니다. 이 API 작업은 쓰기 API와 쿼리 API 모두를 통해 사용할 수 있습니다. 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 ``` { "Endpoints": [ { "Address": "string", "CachePeriodInMinutes": number } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Endpoints](#API_DescribeEndpoints_ResponseSyntax) ** `DescribeEndpoints` 요청이 이루어지면 `Endpoints` 객체가 반환됩니다. 타입: [Endpoint](API_Endpoint.md) 객체 배열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeEndpoints) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeEndpoints) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeEndpoints) # DescribeTable 테이블 이름, 데이터베이스 이름, 메모리 스토어 및 마그네틱 스토어의 보존 기간 등 테이블에 대한 정보를 반환합니다. [서비스 할당량이 적용](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)됩니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html)을 참조하세요. ## 구문 요청 ``` { "DatabaseName": "string", "TableName": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [DatabaseName](#API_DescribeTable_RequestSyntax) ** Timestream 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 항목 여부: 예 ** [TableName](#API_DescribeTable_RequestSyntax) ** Timestream 테이블의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 여부: 예 ## 응답 구문 ``` { "Table": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Table](#API_DescribeTable_ResponseSyntax) ** Timestream 테이블입니다. 타입: [Table](API_Table.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeTable) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeTable) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeTable) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeTable) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeTable) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeTable) # ListBatchLoadTasks 배치 로드 태스크 목록과 이름, 상태, 태스크를 재개할 수 있는 시기 및 기타 세부 정보를 제공합니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-batch-load-tasks.html)을 참조하세요. ## 구문 요청 ``` { "MaxResults": number, "NextToken": "string", "TaskStatus": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [MaxResults](#API_ListBatchLoadTasks_RequestSyntax) ** 출력에서 반환되는 항목의 총 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 출력에 NextToken이 제공됩니다. 페이지 매김을 재개하려면 후속 API 간접 호출의 인수로 NextToken 값을 제공합니다. 타입: 정수 유효 범위: 최소값 1. 최댓값은 100입니다. 필수 여부: 아니요 ** [NextToken](#API_ListBatchLoadTasks_RequestSyntax) ** 페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이는 이전에 잘린 응답의 NextToken입니다. 유형: 문자열 필수 항목 여부: 아니요 ** [TaskStatus](#API_ListBatchLoadTasks_RequestSyntax) ** 배치 로드 태스크의 상태입니다. 타입: 문자열 유효 값: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 필수 항목 여부: 아니요 ## 응답 구문 ``` { "BatchLoadTasks": [ { "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "ResumableUntil": number, "TableName": "string", "TaskId": "string", "TaskStatus": "string" } ], "NextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [BatchLoadTasks](#API_ListBatchLoadTasks_ResponseSyntax) ** 배치 로드 태스크 세부 정보 목록입니다. 타입: [BatchLoadTask](API_BatchLoadTask.md)객체 배열 ** [NextToken](#API_ListBatchLoadTasks_ResponseSyntax) ** 페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 다음 ListBatchLoadTasksRequest를 제공합니다. 유형: 문자열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListBatchLoadTasks) # ListDatabases Timestream 데이터베이스 목록을 반환합니다. [서비스 할당량이 적용](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)됩니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html)을 참조하세요. ## 구문 요청 ``` { "MaxResults": number, "NextToken": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [MaxResults](#API_ListDatabases_RequestSyntax) ** 출력에서 반환되는 항목의 총 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 출력에 NextToken이 제공됩니다. 페이지 매김을 재개하려면 후속 API 간접 호출의 인수로 NextToken 값을 제공합니다. 타입: 정수 유효한 범위: 최소값은 1. 최대값은 20. 필수 여부: 아니요 ** [NextToken](#API_ListDatabases_RequestSyntax) ** 페이지 매김 토큰입니다. 페이지 매김을 재개하려면 후속 API 간접 호출의 인수로 NextToken 값을 제공합니다. 유형: 문자열 필수사항: 아니요 ## 응답 구문 ``` { "Databases": [ { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } ], "NextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Databases](#API_ListDatabases_ResponseSyntax) ** 데이터베이스 이름 목록입니다. 타입: [Database](API_Database.md)객체 배열 ** [NextToken](#API_ListDatabases_ResponseSyntax) ** 페이지 매김 토큰입니다. 이 파라미터는 응답이 잘릴 때 반환됩니다. 유형: 문자열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListDatabases) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListDatabases) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListDatabases) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListDatabases) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListDatabases) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListDatabases) # ListTables 각 테이블의 이름, 상태 및 보존 속성과 함께 테이블 목록을 제공합니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html)을 참조하세요. ## 구문 요청 ``` { "DatabaseName": "string", "MaxResults": number, "NextToken": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [DatabaseName](#API_ListTables_RequestSyntax) ** Timestream 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 여부: 아니요 ** [MaxResults](#API_ListTables_RequestSyntax) ** 출력에서 반환되는 항목의 총 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 출력에 NextToken이 제공됩니다. 페이지 매김을 재개하려면 후속 API 간접 호출의 인수로 NextToken 값을 제공합니다. 타입: 정수 유효한 범위: 최소값은 1. 최대값은 20. 필수 여부: 아니요 ** [NextToken](#API_ListTables_RequestSyntax) ** 페이지 매김 토큰입니다. 페이지 매김을 재개하려면 후속 API 간접 호출의 인수로 NextToken 값을 제공합니다. 유형: 문자열 필수사항: 아니요 ## 응답 구문 ``` { "NextToken": "string", "Tables": [ { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [NextToken](#API_ListTables_ResponseSyntax) ** 페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이는 이전에 잘린 응답의 NextToken입니다. 유형: 문자열 ** [Tables](#API_ListTables_ResponseSyntax) ** 테이블의 목록입니다. 타입: [Table](API_Table.md) 객체 배열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListTables) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTables) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTables) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTables) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTables) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTables) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTables) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTables) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTables) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTables) # ListTagsForResource Timestream 리소스의 모든 태그를 나열합니다. ## 구문 요청 ``` { "ResourceARN": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) ** 목록으로 나열할 태그가 있는 Timestream 리소스입니다. 이 값은 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1011입니다. 필수 항목 여부: 예 ## 응답 구문 ``` { "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** 현재 Timestream 리소스와 연결된 태그입니다. 타입: [Tag](API_Tag.md)객체 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListTagsForResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTagsForResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTagsForResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTagsForResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTagsForResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTagsForResource) # ResumeBatchLoadTask ## 구문 요청 ``` { "TaskId": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [TaskId](#API_ResumeBatchLoadTask_RequestSyntax) ** 재개할 배치 로드 태스크의 ID입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이 32. 패턴: `[A-Z0-9]+` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ResumeBatchLoadTask) # TagResource 태그 세트를 Timestream 리소스에 연결합니다. 이러한 사용자 정의 태그를 활성화하면 Billing and Cost Management 콘솔에 표시되어 비용 할당을 추적할 수 있습니다. ## 구문 요청 ``` { "ResourceARN": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ResourceARN](#API_TagResource_RequestSyntax) ** 태그를 추가해야 하는 Timestream 리소스를 식별합니다. 이 값은 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1011입니다. 필수 항목 여부: 예 ** [Tags](#API_TagResource_RequestSyntax) ** Timestream 리소스에 할당할 태그입니다. 타입: [Tag](API_Tag.md)객체 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ServiceQuotaExceededException ** 이 계정에 대한 리소스의 인스턴스 할당량을 초과했습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/TagResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/TagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/TagResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/TagResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/TagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/TagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/TagResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/TagResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/TagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/TagResource) # UntagResource Timestream 리소스에서 태그의 연결을 제거합니다. ## 구문 요청 ``` { "ResourceARN": "string", "TagKeys": [ "string" ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ResourceARN](#API_UntagResource_RequestSyntax) ** 태그를 제거할 Timestream 리소스입니다. 이 값은 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1011입니다. 필수 항목 여부: 예 ** [TagKeys](#API_UntagResource_RequestSyntax) ** 태그 키 목록입니다. 키가 이 목록의 멤버인 리소스의 기존 태그는 Timestream 리소스에서 제거됩니다. 유형: 문자열 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 길이 제약: 최소 길이 1. 최대 길이는 128. 필수 항목 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ServiceQuotaExceededException ** 이 계정에 대한 리소스의 인스턴스 할당량을 초과했습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UntagResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UntagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UntagResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UntagResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UntagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UntagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UntagResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UntagResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UntagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UntagResource) # UpdateDatabase 기존 데이터베이스의 AWS KMS 키를 수정합니다. 데이터베이스를 업데이트하는 동안 사용할 새 AWS KMS 키의 데이터베이스 이름과 식별자()를 지정해야 합니다`KmsKeyId`. 동시 `UpdateDatabase` 요청이 있는 경우 최초 라이터가 우선 적용됩니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html)을 참조하세요. ## 구문 요청 ``` { "DatabaseName": "string", "KmsKeyId": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [DatabaseName](#API_UpdateDatabase_RequestSyntax) ** 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 항목 여부: 예 ** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) ** 데이터베이스에 저장된 데이터를 암호화하는 데 사용할 새 AWS KMS 키(`KmsKeyId`)의 식별자입니다. 데이터베이스에 현재 등록된 `KmsKeyId`가 요청의 `KmsKeyId`와 동일한 경우 업데이트가 발생하지 않습니다. 다음 중 하나를 사용하여 `KmsKeyId`를 지정할 수 있습니다. + 키 ID: `1234abcd-12ab-34cd-56ef-1234567890ab` + 키 ARN: `arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` + 별칭 이름: `alias/ExampleAlias` + 별칭 ARN: `arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias` 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 항목 여부: 예 ## 응답 구문 ``` { "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Database](#API_UpdateDatabase_ResponseSyntax) ** 테이블의 최상위 컨테이너입니다. 데이터베이스와 테이블은 Amazon Timestream의 기본 관리 개념입니다. 데이터베이스의 모든 테이블은 동일한 AWS KMS 키로 암호화됩니다. 타입: [Database](API_Database.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ServiceQuotaExceededException ** 이 계정에 대한 리소스의 인스턴스 할당량을 초과했습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UpdateDatabase) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateDatabase) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateDatabase) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateDatabase) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateDatabase) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateDatabase) # UpdateTable Timestream 테이블의 메모리 스토어와 마그네틱 스토어의 보존 기간을 수정합니다. 보존 기간의 변경 사항은 즉시 적용됩니다. 예를 들어 메모리 스토어의 보존 기간을 처음 2시간으로 설정한 다음 24시간으로 변경한 경우 메모리 스토어는 24시간의 데이터를 보관할 수 있지만 이 변경 후 22시간이 지나면 24시간의 데이터로 채워집니다. Timestream은 메모리 스토어를 채우기 위해 마그네틱 스토어에서 데이터를 검색하지 않습니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html)을 참조하세요. ## 구문 요청 ``` { "DatabaseName": "string", "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [DatabaseName](#API_UpdateTable_RequestSyntax) ** Timestream 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 항목 여부: 예 ** [MagneticStoreWriteProperties](#API_UpdateTable_RequestSyntax) ** 마그네틱 스토어 쓰기를 활성화할 때 테이블에 설정할 속성이 들어 있습니다. 유형: [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)객체 필수 여부: 아니요 ** [RetentionProperties](#API_UpdateTable_RequestSyntax) ** 메모리 스토어 및 마그네틱 스토어의 보존 기간입니다. 유형: [RetentionProperties](API_RetentionProperties.md)객체 필수 여부: 아니요 ** [Schema](#API_UpdateTable_RequestSyntax) ** 테이블의 스키마입니다. 유형: [Schema](API_Schema.md)객체 필수 여부: 아니요 ** [TableName](#API_UpdateTable_RequestSyntax) ** Timestream 테이블의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 여부: 예 ## 응답 구문 ``` { "Table": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Table](#API_UpdateTable_ResponseSyntax) ** 업데이트된 Timestream 테이블입니다. 타입: [Table](API_Table.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UpdateTable) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateTable) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateTable) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateTable) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateTable) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateTable) # WriteRecords 시계열 데이터를 Timestream에 쓸 수 있습니다. 시스템에 삽입할 단일 데이터 포인트 또는 데이터 포인트 배치를 지정할 수 있습니다. Timestream은 데이터베이스에 쓰기를 간접적으로 호출할 때 지정하는 데이터 요소의 차원 이름 및 데이터 유형을 기반으로 Timestream 테이블의 열 이름 및 데이터 유형을 자동으로 탐지하는 유연한 스키마를 제공합니다. Timestream은 최종 일관성 읽기 시맨틱을 지원합니다. 즉, Timestream에 데이터 배치를 작성한 직후 데이터를 쿼리할 때 쿼리 결과에 최근에 완료된 쓰기 작업의 결과가 반영되지 않을 수 있습니다. 결과에는 일부 오래된 데이터도 포함될 수 있습니다. 잠시 후 쿼리 요청을 반복하면 결과가 최신 데이터를 반환합니다. [서비스 할당량이 적용](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)됩니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html)을 참조하세요. **업서트** `WriteRecords` 요청에서 `Version` 파라미터를 사용하여 데이터 포인트를 업데이트할 수 있습니다. Timestream은 각 레코드와 함께 버전 번호를 추적합니다. 요청의 레코드에 지정되지 않은 경우 `1`은 기본적으로 `Version`으로 설정됩니다. Timestream은 기존 레코드에 대해 더 높은 `Version` 번호가 포함된 쓰기 요청을 수신하면 해당 레코드의 측정값과 `Version`을 함께 업데이트합니다. 측정값이 기존 레코드의 값과 동일한 업데이트 요청을 수신하면 Timestream은 기존 `Version` 값보다 큰 경우 `Version`을 계속 업데이트합니다. `Version` 값이 지속적으로 증가하는 한 원하는 횟수만큼 데이터 포인트를 업데이트할 수 있습니다. 예를 들어 요청에 `Version`을 표시하지 않고 새 레코드를 작성한다고 가정해 보겠습니다. Timestream은 이 레코드를 저장하고 `Version`을 `1`로 설정합니다. 이제 측정값이 다른 동일한 레코드의 `WriteRecords` 요청으로 이 레코드를 업데이트하려고 하지만 이전과 마찬가지로 `Version`을 제공하지 않는다고 가정해 보겠습니다. 이 경우 업데이트된 레코드의 버전이 기존 버전 값보다 크지 않으므로 Timestream은 `RejectedRecordsException`과 함께 이 업데이트를 거부합니다. 그러나 `Version`을 `2`로 설정하여 업데이트 요청을 다시 보내면 Timestream은 레코드 값을 성공적으로 업데이트하고 `Version`은 `2`로 설정됩니다. 다음으로, 동일한 레코드와 동일한 측정값이 있지만 `Version`이 `3`으로 설정된 `WriteRecords` 요청을 전송했다고 가정해 보겠습니다. 이 경우 Timestream은 `Version`만 `3`으로 업데이트합니다. 추가 업데이트 시 `3`보다 큰 버전 번호를 전송해야 하거나 업데이트 요청에 `RejectedRecordsException`이 수신됩니다. ## 구문 요청 ``` { "CommonAttributes": { "Dimensions": [ { "DimensionValueType": "string", "Name": "string", "Value": "string" } ], "MeasureName": "string", "MeasureValue": "string", "MeasureValues": [ { "Name": "string", "Type": "string", "Value": "string" } ], "MeasureValueType": "string", "Time": "string", "TimeUnit": "string", "Version": number }, "DatabaseName": "string", "Records": [ { "Dimensions": [ { "DimensionValueType": "string", "Name": "string", "Value": "string" } ], "MeasureName": "string", "MeasureValue": "string", "MeasureValues": [ { "Name": "string", "Type": "string", "Value": "string" } ], "MeasureValueType": "string", "Time": "string", "TimeUnit": "string", "Version": number } ], "TableName": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [CommonAttributes](#API_WriteRecords_RequestSyntax) ** 요청의 모든 레코드에서 공유되는 공통 치수, 차원, 시간 및 버전 속성을 포함하는 레코드입니다. 지정된 측정 및 차원 속성은 데이터가 Timestream에 작성될 때 레코드 객체의 측정 및 차원 속성과 병합됩니다. 차원이 겹치지 않거나 `ValidationException`이 발생합니다. 즉, 레코드에는 고유한 이름을 가진 차원이 포함되어야 합니다. 유형: [Record](API_Record.md)객체 필수 여부: 아니요 ** [DatabaseName](#API_WriteRecords_RequestSyntax) ** Timestream 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 항목 여부: 예 ** [Records](#API_WriteRecords_RequestSyntax) ** 각 시계열 데이터 포인트에 대한 고유한 치수, 차원, 시간 및 버전 속성을 포함하는 레코드 배열입니다. 타입: [Record](API_Record.md)객체 배열 어레이 멤버: 최소 항목 수 1개. 최대수는 100개입니다. 필수 항목 여부: 예 ** [TableName](#API_WriteRecords_RequestSyntax) ** Timestream 테이블의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 여부: 예 ## 응답 구문 ``` { "RecordsIngested": { "MagneticStore": number, "MemoryStore": number, "Total": number } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [RecordsIngested](#API_WriteRecords_ResponseSyntax) ** 이 요청에서 수집된 레코드에 대한 정보입니다. 타입: [RecordsIngested](API_RecordsIngested.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 이 작업을 수행할 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다. HTTP 상태 코드: 500 ** InvalidEndpointException ** 요청된 엔드포인트가 유효하지 않습니다. HTTP 상태 코드: 400 ** RejectedRecordsException ** 다음과 같은 경우 WriteRecords에서 이 예외가 발생합니다. + 동일한 차원, 타임스탬프 및 측정 이름을 가진 여러 레코드가 있지만 다음과 같은 중복 데이터가 있는 레코드: + 측정값이 다릅니다. + 요청에 버전이 *없거나* 새 레코드의 버전 값이 기존 값보다 작거나 같음 이 경우 Timestream이 데이터를 거부하면 `RejectedRecords` 응답의 `ExistingVersion` 필드에 현재 레코드의 버전이 표시됩니다. 업데이트를 강제로 수행하려면 레코드 세트의 버전을 `ExistingVersion`보다 큰 값으로 설정하여 요청을 재전송하면 됩니다. + 메모리 스토어의 보존 기간을 벗어나는 타임스탬프가 있는 레코드입니다. + Timestream 정의 한도를 초과하는 차원 또는 측정이 있는 레코드입니다. 자세한 내용은 Amazon Timestream 개발자 안내서의 [할당량](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)을 참조하세요. ** RejectedRecords ** HTTP 상태 코드: 400 ** ResourceNotFoundException ** 작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/WriteRecords) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/WriteRecords) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/WriteRecords) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/WriteRecords) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/WriteRecords) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/WriteRecords) # Amazon Timestream Query 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 발급된 쿼리를 취소합니다. 취소 요청은 취소 요청이 실행되기 전에 쿼리 실행이 완료되지 않은 경우에만 제공됩니다. 취소는 멱등성 작업이므로 후속 취소 요청은 쿼리가 이미 취소되었음을 나타내는 `CancellationMessage`를 반환합니다. 자세한 내용은 [코드 샘플](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.cancel-query.html)을 참조하세요. ## 구문 요청 ``` { "QueryId": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [QueryId](#API_query_CancelQuery_RequestSyntax) ** 취소해야 하는 쿼리의 ID입니다. `QueryID`는 쿼리 결과의 일부로 반환됩니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `[a-zA-Z0-9]+` 필수 여부: 예 ## 응답 구문 ``` { "CancellationMessage": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [CancellationMessage](#API_query_CancelQuery_ResponseSyntax) ** `QueryId`에 지정된 쿼리에 대한 `CancelQuery` 요청이 이미 실행되면 `CancellationMessage`가 반환됩니다. 유형: 문자열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 계정 설정에 액세스하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 구성된 일정에 따라 사용자를 대신하여 실행될 예약된 쿼리를 생성합니다. Timestream은 쿼리를 실행하기 위해`ScheduledQueryExecutionRoleArn` 파라미터의 일부로 제공된 실행 역할을 수임합니다. `NotificationConfiguration` 파라미터를 사용하여 예약된 쿼리 작업에 대한 알림을 구성할 수 있습니다. ## 구문 요청 ``` { "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" } } } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) ** ClientToken을 사용하면 CreateScheduledQuery에 대한 호출이 멱등성을 가지게 됩니다. 즉, 동일한 요청을 반복적으로 수행해도 결과가 동일합니다. 동일한 CreateScheduledQuery 요청을 여러 개 생성하는 것은 단일 요청을 생성하는 것과 같은 효과를 냅니다. + `ClientToken` 없이 CreateScheduledQuery를 호출하면 Query SDK가 사용자를 대신하여 `ClientToken`을 생성합니다. + 8시간 후 동일한 `ClientToken`이 있는 요청은 새 요청으로 처리됩니다. 유형: 문자열 길이 제약: 최소 길이는 32입니다. 최대 길이 128. 필수 여부: 아니요 ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 오류 보고를 위한 구성입니다. 쿼리 결과를 작성할 때 문제가 발생하면 오류 보고서가 생성됩니다. 타입: [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)객체 필수 항목 여부: 예 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) ** 예약된 쿼리 리소스를 저장 시 암호화하는 데 사용되는 Amazon KMS 키입니다. Amazon KMS 키를 지정하지 않으면 예약된 쿼리 리소스가 Timestream 소유의 Amazon KMS 키로 암호화됩니다. KMS 키를 식별하려면 키 ID, 키 ARN, 별칭 이름 또는 별칭 ARN을 사용합니다. 별칭 이름을 사용할 때 이름 앞에 *alias/*를 붙입니다. ErrorReportConfiguration이 `SSE_KMS`를 암호화 유형으로 사용하는 경우 동일한 KmsKeyId를 사용하여 저장 시 오류 보고서를 암호화합니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) ** 예약된 쿼리의 이름입니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 필수 여부: 예 ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 예약된 쿼리에 대한 알림 구성입니다. 쿼리 실행이 완료되거나 상태가 업데이트되거나 삭제할 때 Timestream에서 알림을 보냅니다. 타입: [NotificationConfiguration](API_query_NotificationConfiguration.md)객체 필수 항목 여부: 예 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) ** 실행할 쿼리 문자열입니다. 쿼리 문자열 `@` 문자와 식별자로 파라미터 이름을 지정할 수 있습니다. 명명된 파라미터 `@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) ** 쿼리에 대한 일정 구성입니다. 타입: [ScheduleConfiguration](API_query_ScheduleConfiguration.md)객체 필수 항목 여부: 예 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) ** 예약된 쿼리를 실행할 때 Timestream이 수임할 IAM 역할의 ARN입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 항목 여부: 예 ** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) ** 예약된 쿼리에 레이블을 지정할 키-값 페어의 목록입니다. 타입: [Tag](API_query_Tag.md)객체 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 쿼리의 결과를 쓰는 데 사용되는 구성입니다. 유형: [TargetConfiguration](API_query_TargetConfiguration.md)객체 필수 항목 여부: 아니요 ## 응답 구문 ``` { "Arn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) ** 생성된 예약 쿼리의 ARN입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 계정 설정에 액세스하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 400 ** ConflictException ** 취소된 쿼리에 대한 결과를 폴링할 수 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ServiceQuotaExceededException ** 서비스 할당량을 초과했습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 지정된 예약된 쿼리를 삭제합니다. 이는 되돌릴 수 없는 작업입니다. ## 구문 요청 ``` { "ScheduledQueryArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) ** 예약된 쿼리의 ARN입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 항목 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 계정 설정에 액세스하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 요청한 리소스를 찾을 수 없습니다. ** ScheduledQueryArn ** 예약된 쿼리의 ARN입니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 쿼리 요금 모델과 서비스가 쿼리 워크로드에 사용할 수 있는 구성된 최대 TCU를 포함하는 계정의 설정을 설명합니다. 워크로드에 사용된 컴퓨팅 유닛 기간에 대해서만 요금이 부과됩니다. ## Response Syntax ``` { "MaxQueryTCU": number, "QueryCompute": { "ComputeMode": "string", "ProvisionedCapacity": { "ActiveQueryTCU": number, "LastUpdate": { "Status": "string", "StatusMessage": "string", "TargetQueryTCU": number }, "NotificationConfiguration": { "RoleArn": "string", "SnsConfiguration": { "TopicArn": "string" } } } }, "QueryPricingModel": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [MaxQueryTCU](#API_query_DescribeAccountSettings_ResponseSyntax) ** 서비스가 언제든지 쿼리를 처리하는 데 사용할 [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) ** 쿼리 워크로드에 대한 계정의 Timestream 컴퓨팅 유닛(TCU)에 대한 사용 설정을 포함하는 객체입니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다. 유형: [QueryComputeResponse](API_query_QueryComputeResponse.md)객체 ** [QueryPricingModel](#API_query_DescribeAccountSettings_ResponseSyntax) ** 계정의 쿼리에 대한 요금 모델입니다. `QueryPricingModel` 파라미터는 여러 Timestream 작업에서 사용하지만 `UpdateAccountSettings` API 작업은 `COMPUTE_UNITS` 이외의 값을 인식하지 못합니다. 타입: 문자열 유효 값: `BYTES_SCANNED | COMPUTE_UNITS` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 계정 설정에 액세스하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ## 참고 언어별 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 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 ``` { "Endpoints": [ { "Address": "string", "CachePeriodInMinutes": number } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Endpoints](#API_query_DescribeEndpoints_ResponseSyntax) ** `DescribeEndpoints` 요청이 이루어지면 `Endpoints` 객체가 반환됩니다. 타입: [Endpoint](API_query_Endpoint.md) 객체 배열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 예약된 쿼리에 대한 자세한 정보를 제공합니다. ## 구문 요청 ``` { "ScheduledQueryArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) ** 예약된 쿼리의 ARN입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 항목 여부: 예 ## 응답 구문 ``` { "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" } } } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [ScheduledQuery](#API_query_DescribeScheduledQuery_ResponseSyntax) ** 예약된 쿼리입니다. 타입: [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) 객체 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 계정 설정에 액세스하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 요청한 리소스를 찾을 수 없습니다. ** ScheduledQueryArn ** 예약된 쿼리의 ARN입니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 이 API를 사용하여 예약된 쿼리를 수동으로 실행할 수 있습니다. `QueryInsights`를 활성화한 경우 이 API는 Amazon SNS 알림의 일부로 실행한 쿼리와 관련된 인사이트 및 지표도 반환합니다. `QueryInsights`는 쿼리의 성능 튜닝을 지원합니다. `QueryInsights`에 대한 자세한 내용은 [쿼리 인사이트를 사용하여 Amazon Timestream에서 쿼리 최적화](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html)를 참조하세요. ## 구문 요청 ``` { "ClientToken": "string", "InvocationTime": number, "QueryInsights": { "Mode": "string" }, "ScheduledQueryArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) ** 사용하지 않음 유형: 문자열 길이 제약: 최소 길이는 32입니다. 최대 길이 128. 필수 여부: 아니요 ** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) ** UTC의 타임스탬프입니다. 쿼리는 이 타임스탬프에서 간접적으로 호출된 것처럼 실행됩니다. 유형: 타임스탬프 필수 항목 여부: 예 ** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) ** `QueryInsights`를 활성화하기 위한 설정을 캡슐화합니다. `QueryInsights`를 활성화하면 실행한 쿼리에 대한 Amazon SNS 알림의 일부로 인사이트와 지표가 반환됩니다. `QueryInsights`를 사용하여 쿼리 성능 및 비용을 조정할 수 있습니다. 유형: [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md)객체 필수 여부: 아니요 ** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) ** 예약된 쿼리의 ARN입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 항목 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 계정 설정에 액세스하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 요청한 리소스를 찾을 수 없습니다. ** ScheduledQueryArn ** 예약된 쿼리의 ARN입니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 예 ### ENABLED\$1WITH\$1RATE\$1CONTROL 모드에 대한 예약된 쿼리 알림 메시지 다음 예제에서는 `QueryInsights` 파라미터의 `ENABLED_WITH_RATE_CONTROL` 모드에 대한 성공적인 예약 쿼리 알림 메시지를 보여줍니다. ``` "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 } } } ``` ### DISABLED 모드에 대한 예약된 쿼리 알림 메시지 다음 예제에서는 `QueryInsights` 파라미터의 `DISABLED` 모드에 대한 성공적인 예약 쿼리 알림 메시지를 보여줍니다. ``` "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 } } } ``` ### ENABLED\$1WITH\$1RATE\$1CONTROL 모드에 대한 실패 알림 메시지 다음 예제에서는 `QueryInsights` 파라미터의 `ENABLED_WITH_RATE_CONTROL` 모드에 대해 실패한 예약된 쿼리 알림 메시지를 보여줍니다. ``` "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" } } ``` ### 비활성화 모드에 대한 실패 알림 메시지 다음 예제에서는 `QueryInsights` 파라미터의 `DISABLED` 모드에 대해 실패한 예약된 쿼리 알림 메시지를 보여줍니다. ``` "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" } } ``` ## 참고 언어별 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 호출자의 Amazon 계정 및 리전에서 예약된 모든 쿼리 목록을 가져옵니다. `ListScheduledQueries`는 최종적으로 일관됩니다. ## 구문 요청 ``` { "MaxResults": number, "NextToken": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) ** 출력에서 반환할 최대 항목 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 출력에 `NextToken`이 제공됩니다. 페이지 매김을 재개하려면 후속 `ListScheduledQueriesRequest` 직접 호출에 대한 인수로 `NextToken` 값을 제공합니다. 타입: 정수 유효한 범위: 최소값은 1입니다. 최대값은 1000입니다. 필수 여부: 아니요 ** [NextToken](#API_query_ListScheduledQueries_RequestSyntax) ** 페이지 매김을 재개하기 위한 페이지 매김 토큰입니다. 유형: 문자열 필수사항: 아니요 ## 응답 구문 ``` { "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" } } } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [NextToken](#API_query_ListScheduledQueries_ResponseSyntax) ** 페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이는 이전에 잘린 응답의 NextToken입니다. 유형: 문자열 ** [ScheduledQueries](#API_query_ListScheduledQueries_ResponseSyntax) ** 예약된 쿼리 목록입니다. 타입: [ScheduledQuery](API_query_ScheduledQuery.md) 객체 배열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 계정 설정에 액세스하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 Timestream 쿼리 리소스의 모든 태그를 나열합니다. ## 구문 요청 ``` { "MaxResults": number, "NextToken": "string", "ResourceARN": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) ** 반환할 최대 태그 수입니다. 타입: 정수 유효 범위: 최소값 1. 최대값은 200입니다. 필수 여부: 아니요 ** [NextToken](#API_query_ListTagsForResource_RequestSyntax) ** 페이지 매김을 재개하기 위한 페이지 매김 토큰입니다. 유형: 문자열 필수 항목 여부: 아니요 ** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) ** 목록으로 나열할 태그가 있는 Timestream 리소스입니다. 이 값은 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 항목 여부: 예 ## 응답 구문 ``` { "NextToken": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [NextToken](#API_query_ListTagsForResource_ResponseSyntax) ** 후속 `ListTagsForResourceResponse` 직접 호출로 페이지 매김을 재개하는 페이지 매김 토큰입니다. 유형: 문자열 ** [Tags](#API_query_ListTagsForResource_ResponseSyntax) ** 현재 Timestream 리소스와 연결된 태그입니다. 타입: [Tag](API_query_Tag.md)객체 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 요청한 리소스를 찾을 수 없습니다. ** ScheduledQueryArn ** 예약된 쿼리의 ARN입니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 나중에 실행할 수 있도록 Timestream에서 저장할 파라미터가 포함된 쿼리를 제출할 수 있는 동기식 작업입니다. Timestream은 `ValidateOnly`가 `true`로 설정된 이 작업의 사용만 지원합니다. ## 구문 요청 ``` { "QueryString": "string", "ValidateOnly": boolean } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [QueryString](#API_query_PrepareQuery_RequestSyntax) ** 준비된 문으로 사용할 Timestream 쿼리 문자열입니다. 쿼리 문자열 `@` 문자와 식별자로 파라미터 이름을 지정할 수 있습니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 262144자입니다. 필수 항목 여부: 예 ** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) ** 이 값을 `true`로 설정하면 Timestream은 쿼리 문자열이 유효한 Timestream 쿼리인지만 검증하고 나중에 사용할 수 있도록 준비된 쿼리를 저장하지 않습니다. 유형: 부울 필수 항목 여부: 아니요 ## 응답 구문 ``` { "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" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Columns](#API_query_PrepareQuery_ResponseSyntax) ** 제출된 쿼리 문자열의 SELECT 절 열 목록입니다. 타입: [SelectColumn](API_query_SelectColumn.md)객체 배열 ** [Parameters](#API_query_PrepareQuery_ResponseSyntax) ** 제출된 쿼리 문자열에 사용되는 파라미터 목록입니다. 타입: [ParameterMapping](API_query_ParameterMapping.md)객체 배열 ** [QueryString](#API_query_PrepareQuery_ResponseSyntax) ** 준비하려는 쿼리 문자열입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 262144자입니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 계정 설정에 액세스하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 `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` 오류가 발생합니다. ## 구문 요청 ``` { "ClientToken": "string", "MaxRows": number, "NextToken": "string", "QueryInsights": { "Mode": "string" }, "QueryString": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ClientToken](#API_query_Query_RequestSyntax) ** `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) ** `Query` 출력에서 반환되는 총 행 수입니다. `MaxRows` 값이 지정된 `Query`를 처음 실행하면 두 가지 경우에 쿼리의 결과 세트가 반환됩니다. + 결과의 크기가 `1MB`보다 작습니다. + 결과 세트의 행 수가 `maxRows` 값보다 작습니다. 그렇지 않으면 `Query`의 초기 간접 호출은 `NextToken`만 반환하며, 이후 직접 호출에서 결과 세트를 가져오는 데 사용할 수 있습니다. 페이지 매김을 재개하려면 후속 명령에 `NextToken` 값을 제공합니다. 행 크기가 큰 경우(예: 행에 열이 많은 경우) Timestream은 응답 크기가 1MB 제한을 초과하지 않도록 더 적은 수의 행을 반환할 수 있습니다. `MaxRows`가 제공되지 않으면 Timestream은 1MB 제한을 충족하는 데 필요한 수의 행을 전송합니다. 타입: 정수 유효한 범위: 최소값은 1입니다. 최대값은 1000입니다. 필수 여부: 아니요 ** [NextToken](#API_query_Query_RequestSyntax) ** 결과 세트를 반환하는 데 사용되는 페이지 매김 토큰입니다. `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) ** `QueryInsights`를 활성화하기 위한 설정을 캡슐화합니다. `QueryInsights`를 활성화하면 실행한 쿼리에 대한 쿼리 결과 외에도 인사이트와 지표가 반환됩니다. `QueryInsights`를 사용하여 쿼리 성능을 조정할 수 있습니다. 유형: [QueryInsights](API_query_QueryInsights.md)객체 필수 여부: 아니요 ** [QueryString](#API_query_Query_RequestSyntax) ** Timestream에서 실행할 쿼리입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 262144자입니다. 필수 항목 여부: 예 ## 응답 구문 ``` { "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" } ] } ] } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [ColumnInfo](#API_query_Query_ResponseSyntax) ** 반환된 결과 세트의 열 데이터 유형입니다. 타입: [ColumnInfo](API_query_ColumnInfo.md)객체 배열 ** [NextToken](#API_query_Query_ResponseSyntax) ** `Query` 직접 호출 시 다시 사용하여 다음 결과 세트를 가져올 수 있는 페이지 매김 토큰입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. ** [QueryId](#API_query_Query_ResponseSyntax) ** 지정된 쿼리의 고유 ID입니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `[a-zA-Z0-9]+` ** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) ** 실행한 쿼리와 관련된 인사이트 및 지표가 포함된 `QueryInsights`를 캡슐화합니다. 유형: [QueryInsightsResponse](API_query_QueryInsightsResponse.md)객체 ** [QueryStatus](#API_query_Query_ResponseSyntax) ** 쿼리 상태에 대한 정보로, 진행률과 스캔된 바이트 수를 포함합니다. 유형: [QueryStatus](API_query_QueryStatus.md)객체 ** [Rows](#API_query_Query_ResponseSyntax) ** 쿼리에서 반환되는 결과 세트 행입니다. 타입: [Row](API_query_Row.md) 객체 배열 ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 계정 설정에 액세스하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 400 ** ConflictException ** 취소된 쿼리에 대한 결과를 폴링할 수 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** QueryExecutionException ** Timestream이 쿼리를 성공적으로 실행할 수 없습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 태그 세트를 Timestream 리소스와 연결합니다. 이러한 사용자 정의 태그를 활성화하면 Billing and Cost Management 콘솔에 표시되어 비용 할당을 추적할 수 있습니다. ## 구문 요청 ``` { "ResourceARN": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ResourceARN](#API_query_TagResource_RequestSyntax) ** 태그를 추가해야 하는 Timestream 리소스를 식별합니다. 이 값은 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 항목 여부: 예 ** [Tags](#API_query_TagResource_RequestSyntax) ** Timestream 리소스에 할당할 태그입니다. 타입: [Tag](API_query_Tag.md)객체 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 요청한 리소스를 찾을 수 없습니다. ** ScheduledQueryArn ** 예약된 쿼리의 ARN입니다. HTTP 상태 코드: 400 ** ServiceQuotaExceededException ** 서비스 할당량을 초과했습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 Timestream 쿼리 리소스에서 태그 연결을 제거합니다. ## 구문 요청 ``` { "ResourceARN": "string", "TagKeys": [ "string" ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ResourceARN](#API_query_UntagResource_RequestSyntax) ** 태그를 제거할 Timestream 리소스입니다. 이 값은 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 항목 여부: 예 ** [TagKeys](#API_query_UntagResource_RequestSyntax) ** 태그 키 목록입니다. 키가 이 목록의 멤버인 리소스의 기존 태그는 Timestream 리소스에서 제거됩니다. 유형: 문자열 배열 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 길이 제약: 최소 길이 1. 최대 길이는 128. 필수 항목 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 요청한 리소스를 찾을 수 없습니다. ** ScheduledQueryArn ** 예약된 쿼리의 ARN입니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 쿼리 요금에 TCU 사용하도록 계정을 전환하고 구성한 최대 쿼리 컴퓨팅 유닛을 수정합니다. `MaxQueryTCU`의 값을 원하는 구성으로 줄이면 새 값이 적용되는 데 최대 24시간이 걸릴 수 있습니다. **참고** 쿼리 요금에 TCU 사용하도록 계정을 전환한 후에는 쿼리 요금에 스캔된 바이트 사용으로 전환할 수 없습니다. ## 구문 요청 ``` { "MaxQueryTCU": number, "QueryCompute": { "ComputeMode": "string", "ProvisionedCapacity": { "NotificationConfiguration": { "RoleArn": "string", "SnsConfiguration": { "TopicArn": "string" } }, "TargetQueryTCU": number } }, "QueryPricingModel": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) ** 서비스가 언제든지 쿼리를 처리하는 데 사용할 최대 컴퓨팅 유닛 수입니다. 쿼리를 실행하려면 최소 용량을 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) ** 계정의 쿼리 요금 모델 및 프로비저닝된 Timestream 컴퓨팅 유닛(TCU)을 포함하여 계정에 구성된 쿼리 컴퓨팅 설정을 수정합니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다. 이 API는 멱등성이 있습니다. 즉, 동일한 요청을 여러 번 수행하면 요청을 한 번 수행하는 것과 동일한 효과가 있습니다. 유형: [QueryComputeRequest](API_query_QueryComputeRequest.md)객체 필수 여부: 아니요 ** [QueryPricingModel](#API_query_UpdateAccountSettings_RequestSyntax) ** 계정의 쿼리에 대한 요금 모델입니다. `QueryPricingModel` 파라미터는 여러 Timestream 작업에서 사용하지만 `UpdateAccountSettings` API 작업은 `COMPUTE_UNITS` 이외의 값을 인식하지 못합니다. 타입: 문자열 유효 값: `BYTES_SCANNED | COMPUTE_UNITS` 필수 항목 여부: 아니요 ## 응답 구문 ``` { "MaxQueryTCU": number, "QueryCompute": { "ComputeMode": "string", "ProvisionedCapacity": { "ActiveQueryTCU": number, "LastUpdate": { "Status": "string", "StatusMessage": "string", "TargetQueryTCU": number }, "NotificationConfiguration": { "RoleArn": "string", "SnsConfiguration": { "TopicArn": "string" } } } }, "QueryPricingModel": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [MaxQueryTCU](#API_query_UpdateAccountSettings_ResponseSyntax) ** 서비스가 쿼리를 처리하는 데 언제든지 사용할 구성된 최대 컴퓨팅 유닛 수입니다. 유형: 정수 ** [QueryCompute](#API_query_UpdateAccountSettings_ResponseSyntax) ** 계정의 데이터를 쿼리하기 위해 업데이트된 계정 설정을 확인합니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다. 유형: [QueryComputeResponse](API_query_QueryComputeResponse.md)객체 ** [QueryPricingModel](#API_query_UpdateAccountSettings_ResponseSyntax) ** 계정의 요금 모델입니다. 타입: 문자열 유효 값: `BYTES_SCANNED | COMPUTE_UNITS` ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 계정 설정에 액세스하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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 예약된 쿼리를 업데이트합니다. ## 구문 요청 ``` { "ScheduledQueryArn": "string", "State": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) ** 예약 쿼리의 ARN입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 항목 여부: 예 ** [State](#API_query_UpdateScheduledQuery_RequestSyntax) ** 예약된 쿼리의 상태입니다. 타입: 문자열 유효 값: `ENABLED | DISABLED` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요. ** AccessDeniedException ** 계정 설정에 액세스하는 데 필요한 권한이 없습니다. HTTP 상태 코드: 400 ** InternalServerException ** 요청 처리 중 내부 서버 오류가 발생했습니다. HTTP 상태 코드: 400 ** InvalidEndpointException ** 요청된 엔드포인트가 잘못되었습니다. HTTP 상태 코드: 400 ** ResourceNotFoundException ** 요청한 리소스를 찾을 수 없습니다. ** ScheduledQueryArn ** 예약된 쿼리의 ARN입니다. HTTP 상태 코드: 400 ** ThrottlingException ** 과도한 요청으로 인해 요청이 제한되었습니다. HTTP 상태 코드: 400 ** ValidationException ** 유효하지 않거나 잘못된 형식의 요청입니다. HTTP 상태 코드: 400 ## 참고 언어별 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) # 데이터 타입 Amazon Timestream 쓰기는 다음 데이터 유형을 지원합니다. + [BatchLoadProgressReport](API_BatchLoadProgressReport.md) + [BatchLoadTask](API_BatchLoadTask.md) + [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) + [CsvConfiguration](API_CsvConfiguration.md) + [Database](API_Database.md) + [DataModel](API_DataModel.md) + [DataModelConfiguration](API_DataModelConfiguration.md) + [DataModelS3Configuration](API_DataModelS3Configuration.md) + [DataSourceConfiguration](API_DataSourceConfiguration.md) + [DataSourceS3Configuration](API_DataSourceS3Configuration.md) + [Dimension](API_Dimension.md) + [DimensionMapping](API_DimensionMapping.md) + [Endpoint](API_Endpoint.md) + [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) + [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) + [MeasureValue](API_MeasureValue.md) + [MixedMeasureMapping](API_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_MultiMeasureMappings.md) + [PartitionKey](API_PartitionKey.md) + [Record](API_Record.md) + [RecordsIngested](API_RecordsIngested.md) + [RejectedRecord](API_RejectedRecord.md) + [ReportConfiguration](API_ReportConfiguration.md) + [ReportS3Configuration](API_ReportS3Configuration.md) + [RetentionProperties](API_RetentionProperties.md) + [S3Configuration](API_S3Configuration.md) + [Schema](API_Schema.md) + [Table](API_Table.md) + [Tag](API_Tag.md) Amazon Timestream 쿼리는 다음 데이터 유형을 지원합니다. + [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) + [ColumnInfo](API_query_ColumnInfo.md) + [Datum](API_query_Datum.md) + [DimensionMapping](API_query_DimensionMapping.md) + [Endpoint](API_query_Endpoint.md) + [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) + [ErrorReportLocation](API_query_ErrorReportLocation.md) + [ExecutionStats](API_query_ExecutionStats.md) + [LastUpdate](API_query_LastUpdate.md) + [MixedMeasureMapping](API_query_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_query_MultiMeasureMappings.md) + [NotificationConfiguration](API_query_NotificationConfiguration.md) + [ParameterMapping](API_query_ParameterMapping.md) + [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) + [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) + [QueryComputeRequest](API_query_QueryComputeRequest.md) + [QueryComputeResponse](API_query_QueryComputeResponse.md) + [QueryInsights](API_query_QueryInsights.md) + [QueryInsightsResponse](API_query_QueryInsightsResponse.md) + [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) + [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) + [QueryStatus](API_query_QueryStatus.md) + [QueryTemporalRange](API_query_QueryTemporalRange.md) + [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) + [Row](API_query_Row.md) + [S3Configuration](API_query_S3Configuration.md) + [S3ReportLocation](API_query_S3ReportLocation.md) + [ScheduleConfiguration](API_query_ScheduleConfiguration.md) + [ScheduledQuery](API_query_ScheduledQuery.md) + [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) + [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) + [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) + [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) + [SelectColumn](API_query_SelectColumn.md) + [SnsConfiguration](API_query_SnsConfiguration.md) + [Tag](API_query_Tag.md) + [TargetConfiguration](API_query_TargetConfiguration.md) + [TargetDestination](API_query_TargetDestination.md) + [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) + [TimestreamConfiguration](API_query_TimestreamConfiguration.md) + [TimestreamDestination](API_query_TimestreamDestination.md) + [Type](API_query_Type.md) # Amazon Timestream Write Amazon Timestream 쓰기는 다음 데이터 유형을 지원합니다. + [BatchLoadProgressReport](API_BatchLoadProgressReport.md) + [BatchLoadTask](API_BatchLoadTask.md) + [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) + [CsvConfiguration](API_CsvConfiguration.md) + [Database](API_Database.md) + [DataModel](API_DataModel.md) + [DataModelConfiguration](API_DataModelConfiguration.md) + [DataModelS3Configuration](API_DataModelS3Configuration.md) + [DataSourceConfiguration](API_DataSourceConfiguration.md) + [DataSourceS3Configuration](API_DataSourceS3Configuration.md) + [Dimension](API_Dimension.md) + [DimensionMapping](API_DimensionMapping.md) + [Endpoint](API_Endpoint.md) + [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) + [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) + [MeasureValue](API_MeasureValue.md) + [MixedMeasureMapping](API_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_MultiMeasureMappings.md) + [PartitionKey](API_PartitionKey.md) + [Record](API_Record.md) + [RecordsIngested](API_RecordsIngested.md) + [RejectedRecord](API_RejectedRecord.md) + [ReportConfiguration](API_ReportConfiguration.md) + [ReportS3Configuration](API_ReportS3Configuration.md) + [RetentionProperties](API_RetentionProperties.md) + [S3Configuration](API_S3Configuration.md) + [Schema](API_Schema.md) + [Table](API_Table.md) + [Tag](API_Tag.md) # BatchLoadProgressReport 배치 로드 태스크의 진행 상황에 대한 세부 정보입니다. ## 내용 ** BytesMetered ** 유형: Long 필수 여부: 아니요 ** FileFailures ** 유형: Long 필수 여부: 아니요 ** ParseFailures ** 유형: Long 필수 여부: 아니요 ** RecordIngestionFailures ** 유형: Long 필수 여부: 아니요 ** RecordsIngested ** 유형: Long 필수 여부: 아니요 ** RecordsProcessed ** 유형: Long 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadProgressReport) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadProgressReport) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadProgressReport) # BatchLoadTask 배치 로드 태스크에 대한 세부 정보입니다. ## 내용 ** CreationTime ** Timestream 배치 로드 태스크가 생성된 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** DatabaseName ** 배치 로드 태스크가 데이터를 로드하는 데이터베이스의 데이터베이스 이름입니다. 유형: 문자열 필수 여부: 아니요 ** LastUpdatedTime ** Timestream 배치 로드 태스크가 마지막으로 업데이트된 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** ResumableUntil ** 유형: 타임스탬프 필수 여부: 아니요 ** TableName ** 배치 로드 태스크가 데이터를 로드하는 테이블의 테이블 이름입니다. 유형: 문자열 필수 여부: 아니요 ** TaskId ** 배치 로드 태스크의 ID입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이 32. 패턴: `[A-Z0-9]+` 필수 여부: 아니요 ** TaskStatus ** 배치 로드 태스크의 상태입니다. 타입: 문자열 유효 값: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTask) # BatchLoadTaskDescription 배치 로드 태스크에 대한 세부 정보입니다. ## 내용 ** CreationTime ** Timestream 배치 로드 태스크가 생성된 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** DataModelConfiguration ** 배치 로드 태스크에 대한 데이터 모델 구성입니다. 여기에는 배치 로드 태스크의 데이터 모델이 저장되는 위치에 대한 세부 정보가 포함됩니다. 유형: [DataModelConfiguration](API_DataModelConfiguration.md)객체 필수 여부: 아니요 ** DataSourceConfiguration ** 배치 로드 태스크의 데이터 소스에 대한 구성 세부 정보입니다. 유형: [DataSourceConfiguration](API_DataSourceConfiguration.md)객체 필수 여부: 아니요 ** ErrorMessage ** 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 ** LastUpdatedTime ** Timestream 배치 로드 태스크가 마지막으로 업데이트된 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** ProgressReport ** 유형: [BatchLoadProgressReport](API_BatchLoadProgressReport.md)객체 필수 여부: 아니요 ** RecordVersion ** 유형: Long 필수 여부: 아니요 ** ReportConfiguration ** 배치 로드 태스크에 대한 보고서 구성입니다. 여기에는 오류 보고서가 저장되는 위치에 대한 세부 정보가 포함됩니다. 유형: [ReportConfiguration](API_ReportConfiguration.md)객체 필수 여부: 아니요 ** ResumableUntil ** 유형: 타임스탬프 필수 여부: 아니요 ** TargetDatabaseName ** 유형: 문자열 필수 여부: 아니요 ** TargetTableName ** 유형: 문자열 필수 여부: 아니요 ** TaskId ** 배치 로드 태스크의 ID입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이 32. 패턴: `[A-Z0-9]+` 필수 여부: 아니요 ** TaskStatus ** 배치 로드 태스크의 상태입니다. 타입: 문자열 유효 값: `CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTaskDescription) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTaskDescription) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTaskDescription) # CsvConfiguration 열 구분 기호가 쉼표이고 레코드 구분 기호가 줄 바꿈 문자인 구분된 데이터 형식입니다. ## 내용 ** ColumnSeparator ** 열 구분자는 쉼표(','), 파이프('\$1'), 세미콜론(';'), 탭('/t') 또는 공백(' ') 중 하나일 수 있습니다. 유형: 문자열 길이 제약 조건: 고정 길이는 1입니다. 필수 여부: 아니요 ** EscapeChar ** 이스케이프 문자는 다음 중 하나일 수 있습니다. 유형: 문자열 길이 제약 조건: 고정 길이는 1입니다. 필수 여부: 아니요 ** NullValue ** 공백(' ')일 수 있습니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 아니요 ** QuoteChar ** 작은따옴표(') 또는 큰따옴표(")일 수 있습니다. 유형: 문자열 길이 제약 조건: 고정 길이는 1입니다. 필수 여부: 아니요 ** TrimWhiteSpace ** 선행 및 후행 공백을 잘라내도록 지정합니다. 유형: 부울 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CsvConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CsvConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CsvConfiguration) # Database 테이블의 최상위 컨테이너입니다. 데이터베이스와 테이블은 Amazon Timestream의 기본 관리 개념입니다. 데이터베이스의 모든 테이블은 동일한 AWS KMS 키로 암호화됩니다. ## 내용 ** Arn ** 이 데이터베이스를 고유하게 식별하는 Amazon 리소스 이름입니다. 유형: 문자열 필수 여부: 아니요 ** CreationTime ** 데이터베이스가 생성된 시간으로, Unix 에포크 시간으로 계산됩니다. 유형: 타임스탬프 필수 여부: 아니요 ** DatabaseName ** Timestream 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 여부: 아니요 ** KmsKeyId ** 데이터베이스에 저장된 데이터를 암호화하는 데 사용되는 AWS KMS 키의 식별자입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 ** LastUpdatedTime ** 이 데이터베이스가 업데이트된 마지막 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** TableCount ** Timestream 데이터베이스 내에서 발견된 총 테이블 수입니다. 유형: Long 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Database) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Database) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Database) # DataModel 배치 로드 태스크에 대한 데이터 모델입니다. ## 내용 ** DimensionMappings ** 차원에 대한 소스-대상 매핑입니다. 타입: [DimensionMapping](API_DimensionMapping.md)객체 배열 어레이 멤버: 최소 항목 수 1개. 필수 여부: 예 ** MeasureNameColumn ** 유형: String 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 아니요 ** MixedMeasureMappings ** 측정값에 대한 소스-대상 매핑입니다. 타입: [MixedMeasureMapping](API_MixedMeasureMapping.md)객체 배열 배열 구성원: 최소수는 1개입니다. 필수 여부: 아니요 ** MultiMeasureMappings ** 다중 측정 레코드에 대한 소스-대상 매핑입니다. 유형: [MultiMeasureMappings](API_MultiMeasureMappings.md)객체 필수 여부: 아니요 ** TimeColumn ** 시간에 매핑할 소스 열입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 아니요 ** TimeUnit ** 타임스탬프 단위의 세부 수준입니다. 시간 값이 초, 밀리초, 나노초 또는 기타 지원되는 값인지 나타냅니다. 기본값은 `MILLISECONDS`입니다. 타입: 문자열 유효 값: `MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModel) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModel) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModel) # DataModelConfiguration ## 내용 ** DataModel ** 유형: [DataModel](API_DataModel.md)객체 필수 여부: 아니요 ** DataModelS3Configuration ** 유형: [DataModelS3Configuration](API_DataModelS3Configuration.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelConfiguration) # DataModelS3Configuration ## 내용 ** BucketName ** 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 63입니다. 패턴: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 필수 여부: 아니요 ** ObjectKey ** 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelS3Configuration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelS3Configuration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelS3Configuration) # DataSourceConfiguration 데이터 소스에 대한 구성 세부 정보를 정의합니다. ## 내용 ** DataFormat ** 현재 CSV입니다. 타입: 문자열 유효 값: `CSV` 필수 여부: 예 ** DataSourceS3Configuration ** 로드할 데이터가 들어 있는 파일의 S3 위치 구성입니다. 타입: [DataSourceS3Configuration](API_DataSourceS3Configuration.md)객체 필수 여부: 예 ** CsvConfiguration ** 열 구분 기호가 쉼표이고 레코드 구분 기호가 줄 바꿈 문자인 구분된 데이터 형식입니다. 유형: [CsvConfiguration](API_CsvConfiguration.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceConfiguration) # DataSourceS3Configuration ## 내용 ** BucketName ** 고객 S3 버킷의 버킷 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 63입니다. 패턴: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 필수 여부: 예 ** ObjectKeyPrefix ** 유형: String 길이 제약: 최소 길이 1. 최대 길이는 1024입니다. 패턴: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceS3Configuration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceS3Configuration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceS3Configuration) # Dimension 시계열의 메타데이터 속성을 나타냅니다. 예를 들어 EC2 인스턴스의 이름 및 가용 영역 또는 풍력 터빈 제조업체 이름은 차원입니다. ## 내용 ** Name ** 차원은 시계열의 메타데이터 속성을 나타냅니다. 예를 들어 EC2 인스턴스의 이름 및 가용 영역 또는 풍력 터빈 제조업체 이름은 차원입니다. 차원 이름에 대한 제약 조건은 [명명 제약 조건](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming)을 참조하세요. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 60입니다. 필수 여부: 예 ** Value ** 차원의 값입니다. 유형: 문자열 필수 항목 여부: 예 ** DimensionValueType ** 시계열 데이터 포인트에 대한 차원의 데이터 유형입니다. 타입: 문자열 유효 값: `VARCHAR` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Dimension) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Dimension) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Dimension) # DimensionMapping ## 내용 ** DestinationColumn ** 유형: 문자열 길이 제약: 최소 길이 1. 필수 여부: 아니요 ** SourceColumn ** 유형: 문자열 길이 제약: 최소 길이 1. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DimensionMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DimensionMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DimensionMapping) # Endpoint API 직접 호출을 수행할 사용 가능한 대상 엔드포인트와 해당 엔드포인트의 TTL을 나타냅니다. ## 내용 ** Address ** 엔드포인트 주소입니다. 유형: 문자열 필수 항목 여부: 예 ** CachePeriodInMinutes ** 엔드포인트의 TTL(분)입니다. 타입: Long 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Endpoint) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Endpoint) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Endpoint) # MagneticStoreRejectedDataLocation 마그네틱 스토어 쓰기 중 비동기적으로 거부된 레코드에 대한 오류 보고서를 작성할 위치입니다. ## 내용 ** S3Configuration ** 마그네틱 스토어 쓰기 중 비동기적으로 거부된 레코드에 대한 오류 보고서를 작성할 S3 위치의 구성입니다. 유형: [S3Configuration](API_S3Configuration.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) # MagneticStoreWriteProperties 마그네틱 스토어 쓰기를 구성하기 위한 테이블의 속성 세트입니다. ## 내용 ** EnableMagneticStoreWrites ** 마그네틱 스토어 쓰기를 활성화하는 플래그입니다. 유형: 부울 필수 여부: 예 ** MagneticStoreRejectedDataLocation ** 마그네틱 스토어 쓰기 중 비동기적으로 거부된 레코드에 대한 오류 보고서를 작성할 위치입니다. 유형: [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreWriteProperties) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreWriteProperties) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreWriteProperties) # MeasureValue 시계열의 데이터 속성을 나타냅니다. 예를 들어 EC2 인스턴스의 CPU 사용률이 풍력 터빈의 RPM은 측정입니다. MeasureValue는 이름과 값을 모두 가집니다. MeasureValue는 `MULTI` 유형에만 허용됩니다. `MULTI` 유형을 사용하면 동일한 시계열과 관련된 여러 데이터 속성을 단일 레코드에 전달할 수 있습니다. ## 내용 ** Name ** MeasureValue의 이름입니다. MeasureValue 이름에 대한 제약 조건은 Amazon Timestream 개발자 안내서의 [명명 제약 조건](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming)을 참조하세요. 유형: 문자열 길이 제약: 최소 길이 1. 필수 여부: 예 ** Type ** 시계열 데이터 포인트에 대한 MeasureValue의 데이터 유형을 포함합니다. 타입: 문자열 유효 값: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI` 필수 여부: 예 ** Value ** MeasureValue의 값입니다. 자세한 내용은 [데이터 유형](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types)을 참조하세요. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MeasureValue) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MeasureValue) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MeasureValue) # MixedMeasureMapping ## 내용 ** MeasureValueType ** 타입: 문자열 유효 값: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI` 필수 여부: 예 ** MeasureName ** 유형: String 길이 제약: 최소 길이 1. 필수 여부: 아니요 ** MultiMeasureAttributeMappings ** 타입: [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md)객체 배열 배열 구성원: 최소수는 1개입니다. 필수 여부: 아니요 ** SourceColumn ** 유형: 문자열 길이 제약: 최소 길이 1. 필수 여부: 아니요 ** TargetMeasureName ** 유형: 문자열 길이 제약: 최소 길이 1. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MixedMeasureMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MixedMeasureMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MixedMeasureMapping) # MultiMeasureAttributeMapping ## 내용 ** SourceColumn ** 유형: 문자열 길이 제약: 최소 길이 1. 필수 여부: 예 ** MeasureValueType ** 타입: 문자열 유효 값: `DOUBLE | BIGINT | BOOLEAN | VARCHAR | TIMESTAMP` 필수 여부: 아니요 ** TargetMultiMeasureAttributeName ** 유형: 문자열 길이 제약: 최소 길이 1. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureAttributeMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureAttributeMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureAttributeMapping) # MultiMeasureMappings ## 내용 ** MultiMeasureAttributeMappings ** 타입: [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md)객체 배열 어레이 멤버: 최소 항목 수 1개. 필수 여부: 예 ** TargetMultiMeasureName ** 유형: String 길이 제약: 최소 길이 1. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureMappings) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureMappings) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureMappings) # PartitionKey 테이블의 데이터를 파티셔닝하는 데 사용되는 속성입니다. 차원 키는 dimension-name으로 지정된 차원 값을 파티션 키로 사용하여 데이터를 파티셔닝하는 반면, 측정값 키는 측정값 이름(‘measure\$1name’ 열의 값)을 사용하여 데이터를 파티셔닝합니다. ## 내용 ** Type ** 파티션 키의 유형입니다. 옵션은 DIMENSION(차원 키)와 MEAABILITY(측정 키)입니다. 타입: 문자열 유효 값: `DIMENSION | MEASURE` 필수 여부: 예 ** EnforcementInRecord ** 수집된 레코드에서 차원 키 사양에 대한 적용 수준입니다. 옵션은 REQUIRED(차원 키를 반드시 지정해야 함)와 OPTIONAL(차원 키를 지정하지 않아도 됨)입니다. 타입: 문자열 유효 값: `REQUIRED | OPTIONAL` 필수 여부: 아니요 ** Name ** 차원 키에 사용되는 속성의 이름입니다. 유형: 문자열 길이 제약: 최소 길이 1. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/PartitionKey) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/PartitionKey) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/PartitionKey) # Record Timestream에 작성되는 시계열 데이터 포인트를 나타냅니다. 각 레코드에는 차원 배열이 포함되어 있습니다. 차원은 EC2 인스턴스의 인스턴스 이름 또는 가용 영역과 같은 시계열 데이터 포인트의 메타데이터 속성을 나타냅니다. 레코드에는 수집되는 측정의 이름도 포함됩니다(예: EC2 인스턴스의 CPU 사용률). 또한 레코드에는 측정값과 측정값의 데이터 유형인 값 유형이 포함됩니다. 또한 레코드에는 측정값이 수집된 시점의 타임스탬프와 타임스탬프의 세분성을 나타내는 타임스탬프 단위가 포함됩니다. 레코드에는 데이터 포인트를 업데이트하는 데 사용할 수 있는 64비트 `long`인 `Version` 필드가 있습니다. 차원, 타임스탬프 및 측정 이름이 같지만 측정값이 다른 중복 레코드의 쓰기는 쓰기 요청에 있는 레코드의 `Version` 속성이 기존 레코드의 속성보다 높은 경우에만 성공합니다. `Version` 필드가 없는 레코드의 경우 Timestream은 기본적으로 `Version` `1`을 사용합니다. ## 내용 ** Dimensions ** 시계열 데이터 포인트의 차원 목록을 포함합니다. 타입: [Dimension](API_Dimension.md)객체 배열 어레이 멤버: 최대 항목 수 128개. 필수 여부: 아니요 ** MeasureName ** 측정은 시계열의 데이터 속성을 나타냅니다. 예를 들어 EC2 인스턴스의 CPU 사용률이 풍력 터빈의 RPM은 측정입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 아니요 ** MeasureValue ** 시계열 데이터 포인트에 대한 측정값을 포함합니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 ** MeasureValues ** 시계열 데이터 포인트에 대한 MeasureValue 목록을 포함합니다. 이는 유형 `MULTI`에만 허용됩니다. 스칼라 값의 경우 레코드의 `MeasureValue` 속성을 직접 사용합니다. 타입: [MeasureValue](API_MeasureValue.md)객체 배열 필수 여부: 아니요 ** MeasureValueType ** 시계열 데이터 포인트에 대한 측정값의 데이터 유형을 포함합니다. 기본 유형은 `DOUBLE`입니다. 자세한 내용은 [데이터 유형](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types)을 참조하세요. 타입: 문자열 유효 값: `DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI` 필수 여부: 아니요 ** Time ** 데이터 포인트의 측정값이 수집된 시간을 포함합니다. 시간 값과 단위는 에포크 이후 경과된 시간을 제공합니다. 예를 들어 시간 값이 `12345`이고 단위가 `ms`이면 에포크 이후 `12345 ms`가 경과한 것입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 아니요 ** TimeUnit ** 타임스탬프 단위의 세부 수준입니다. 시간 값이 초, 밀리초, 나노초 또는 기타 지원되는 값인지 나타냅니다. 기본값은 `MILLISECONDS`입니다. 타입: 문자열 유효 값: `MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS` 필수 여부: 아니요 ** Version ** 레코드 업데이트에 사용되는 64비트 속성입니다. 버전 번호가 더 높은 중복 데이터에 쓰기 요청은 기존 측정값과 버전을 업데이트합니다. 측정값이 동일한 경우에도 `Version`은 계속 업데이트됩니다. 기본값은 `1`입니다. `Version`은 `1` 이상이어야 합니다. 그렇지 않으면 `ValidationException` 오류가 발생합니다. 유형: Long 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Record) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Record) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Record) # RecordsIngested 이 요청에서 수집된 레코드에 대한 정보입니다. ## 내용 ** MagneticStore ** 마그네틱 스토어로 수집된 레코드 수입니다. 유형: Integer 필수 여부: 아니요 ** MemoryStore ** 메모리 스토어로 수집된 레코드 수입니다. 유형: Integer 필수 여부: 아니요 ** Total ** 성공적으로 수집된 레코드의 총 수입니다. 유형: Integer 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RecordsIngested) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RecordsIngested) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RecordsIngested) # RejectedRecord 시계열 데이터를 시스템에 다시 삽입하기 전에 해결해야 하는 데이터 검증 문제로 인해 Timestream에 성공적으로 삽입되지 않은 레코드를 나타냅니다. ## 내용 ** ExistingVersion ** 레코드의 기존 버전입니다. 이 값은 쓰기 요청의 버전보다 버전이 높은 동일한 레코드가 존재하는 시나리오에서 채워집니다. 유형: Long 필수 여부: 아니요 ** Reason ** 레코드가 Timestream에 성공적으로 삽입되지 않은 이유입니다. 가능한 실패 원인은 다음과 같습니다. + 동일한 차원, 타임스탬프 및 측정 이름을 가진 레코드가 여러 개 있는 중복 데이터가 있지만 다음과 같은 특징을 가진 레코드 + 측정값이 다름 + 요청에 버전이 *없거나* 새 레코드의 버전 값이 기존 값과 같거나 낮음 Timestream이 이 사례에 대한 데이터를 거부하면 `RejectedRecords` 응답의 `ExistingVersion` 필드에 현재 레코드의 버전이 표시됩니다. 업데이트를 강제로 수행하려면 레코드 세트의 버전을 `ExistingVersion`보다 큰 값으로 설정하여 요청을 재전송하면 됩니다. + 메모리 스토어의 보존 기간을 벗어난 타임스탬프를 가진 레코드 **참고** 보존 기간이 업데이트되면 새 기간 내에 데이터를 즉시 수집하려고 하면 `RejectedRecords` 예외가 발생합니다. `RejectedRecords` 예외를 방지하려면 새 기간이 끝날 때까지 기다렸다가 새 데이터를 수집합니다. 자세한 내용은 [Timestream 구성 모범 사례](https://docs.aws.amazon.com/timestream/latest/developerguide/best-practices.html#configuration)와 [Timestream에서 스토리지가 작동하는 방식](https://docs.aws.amazon.com/timestream/latest/developerguide/storage.html)에 대한 설명을 참조하세요. + Timestream에서 정의한 제한을 초과하는 차원 또는 측정이 있는 레코드 자세한 내용은 Timestream 개발자 안내서의 [액세스 관리](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)를 참조하세요. 유형: 문자열 필수 여부: 아니요 ** RecordIndex ** WriteRecords에 대한 입력 요청 내 레코드의 인덱스 인덱스는 0으로 시작합니다. 유형: Integer 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RejectedRecord) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RejectedRecord) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RejectedRecord) # ReportConfiguration 배치 로드 태스크에 대한 보고서 구성입니다. 여기에는 오류 보고서가 저장되는 위치에 대한 세부 정보가 포함됩니다. ## 내용 ** ReportS3Configuration ** 배치 로드에 대한 오류 보고서와 이벤트를 작성하기 위한 S3 위치 구성입니다. 유형: [ReportS3Configuration](API_ReportS3Configuration.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportConfiguration) # ReportS3Configuration ## 내용 ** BucketName ** 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 63입니다. 패턴: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 필수 여부: 예 ** EncryptionOption ** 타입: 문자열 유효 값: `SSE_S3 | SSE_KMS` 필수 여부: 아니요 ** KmsKeyId ** 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 ** ObjectKeyPrefix ** 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 928. 패턴: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportS3Configuration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportS3Configuration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportS3Configuration) # RetentionProperties 보존 속성에는 마그네틱 스토어와 메모리 스토어에 시계열 데이터를 저장해야 하는 기간이 포함됩니다. ## 내용 ** MagneticStoreRetentionPeriodInDays ** 마그네틱 스토어에 데이터가 저장되어야 하는 기간입니다. 타입: Long 유효 범위: 최소값 1. 최댓값은 73000입니다. 필수 여부: 예 ** MemoryStoreRetentionPeriodInHours ** 메모리 스토어에 데이터가 저장되어야 하는 기간입니다. 타입: Long 유효 범위: 최소값 1. 최대값은 8766입니다. 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RetentionProperties) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RetentionProperties) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RetentionProperties) # S3Configuration S3 위치를 지정하는 구성입니다. ## 내용 ** BucketName ** 고객 S3 버킷의 버킷 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 63입니다. 패턴: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 필수 여부: 아니요 ** EncryptionOption ** 고객 S3 위치에 대한 암호화 옵션입니다. 옵션은 S3 관리형 키 또는 AWS 관리형 키를 사용한 S3 서버 측 암호화입니다. 타입: 문자열 유효 값: `SSE_S3 | SSE_KMS` 필수 여부: 아니요 ** KmsKeyId ** AWS 관리형 키로 암호화할 때 고객 S3 위치의 AWS KMS 키 ID입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 ** ObjectKeyPrefix ** 고객 S3 위치의 객체 키 미리 보기입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 928. 패턴: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/S3Configuration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/S3Configuration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/S3Configuration) # Schema 스키마는 테이블의 예상 데이터 모델을 지정합니다. ## 내용 ** CompositePartitionKey ** 테이블 데이터를 파티셔닝하는 데 사용되는 속성을 정의하는 비어 있지 않은 파티션 키 목록입니다. 목록의 순서에 따라 파티션 계층 구조가 결정됩니다. 테이블을 생성한 후에는 각 파티션 키의 이름 및 유형과 파티션 키 순서를 변경할 수 없습니다. 그러나 각 파티션 키의 적용 수준은 변경할 수 있습니다. 타입: [PartitionKey](API_PartitionKey.md)객체 배열 배열 구성원: 최소수는 1개입니다. 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Schema) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Schema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Schema) # Table Timestream의 데이터베이스 테이블을 나타냅니다. 테이블에는 하나 이상의 관련 시계열이 포함됩니다. 테이블에 대한 메모리 스토어와 마그네틱 스토어의 보존 기간을 수정할 수 있습니다. ## 내용 ** Arn ** 이 테이블을 고유하게 식별하는 Amazon 리소스 이름입니다. 유형: 문자열 필수 여부: 아니요 ** CreationTime ** Timestream 테이블이 생성된 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** DatabaseName ** 이 테이블을 포함하는 Timestream 데이터베이스의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 여부: 아니요 ** LastUpdatedTime ** Timestream 테이블이 마지막으로 업데이트된 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** MagneticStoreWriteProperties ** 마그네틱 스토어 쓰기를 활성화할 때 테이블에 설정할 속성이 들어 있습니다. 유형: [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md)객체 필수 여부: 아니요 ** RetentionProperties ** 메모리 저장소 및 마그네틱 저장소에 대한 보존 기간입니다. 유형: [RetentionProperties](API_RetentionProperties.md)객체 필수 여부: 아니요 ** Schema ** 테이블의 스키마입니다. 유형: [Schema](API_Schema.md)객체 필수 여부: 아니요 ** TableName ** Timestream 테이블의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256. 필수 여부: 아니요 ** TableStatus ** 테이블의 현재 상태입니다. + `DELETING` - 테이블이 삭제되고 있습니다. + `ACTIVE` - 테이블을 사용할 준비가 되었습니다. 타입: 문자열 유효 값: `ACTIVE | DELETING | RESTORING` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Table) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Table) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Table) # Tag 태그는 Timestream 데이터베이스 및/또는 테이블에 할당하는 레이블입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 태그를 사용하면 데이터베이스 및/또는 테이블을 용도, 소유자 또는 환경 등에 따라 분류할 수 있습니다. ## 내용 ** Key ** 태그의 키입니다. 태그 키는 대소문자를 구별합니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 128. 필수 여부: 예 ** Value ** 태그의 값입니다. 태그 값은 대소문자를 구분하며 null일 수 있습니다. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256. 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Tag) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Tag) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Tag) # Amazon Timestream Query Amazon Timestream 쿼리는 다음 데이터 유형을 지원합니다. + [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) + [ColumnInfo](API_query_ColumnInfo.md) + [Datum](API_query_Datum.md) + [DimensionMapping](API_query_DimensionMapping.md) + [Endpoint](API_query_Endpoint.md) + [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) + [ErrorReportLocation](API_query_ErrorReportLocation.md) + [ExecutionStats](API_query_ExecutionStats.md) + [LastUpdate](API_query_LastUpdate.md) + [MixedMeasureMapping](API_query_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_query_MultiMeasureMappings.md) + [NotificationConfiguration](API_query_NotificationConfiguration.md) + [ParameterMapping](API_query_ParameterMapping.md) + [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) + [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) + [QueryComputeRequest](API_query_QueryComputeRequest.md) + [QueryComputeResponse](API_query_QueryComputeResponse.md) + [QueryInsights](API_query_QueryInsights.md) + [QueryInsightsResponse](API_query_QueryInsightsResponse.md) + [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) + [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) + [QueryStatus](API_query_QueryStatus.md) + [QueryTemporalRange](API_query_QueryTemporalRange.md) + [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) + [Row](API_query_Row.md) + [S3Configuration](API_query_S3Configuration.md) + [S3ReportLocation](API_query_S3ReportLocation.md) + [ScheduleConfiguration](API_query_ScheduleConfiguration.md) + [ScheduledQuery](API_query_ScheduledQuery.md) + [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) + [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) + [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) + [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) + [SelectColumn](API_query_SelectColumn.md) + [SnsConfiguration](API_query_SnsConfiguration.md) + [Tag](API_query_Tag.md) + [TargetConfiguration](API_query_TargetConfiguration.md) + [TargetDestination](API_query_TargetDestination.md) + [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) + [TimestreamConfiguration](API_query_TimestreamConfiguration.md) + [TimestreamDestination](API_query_TimestreamDestination.md) + [Type](API_query_Type.md) # AccountSettingsNotificationConfiguration 계정 설정과 관련된 알림에 대한 구성 설정입니다. ## 내용 ** RoleArn ** 알림을 게시할 수 있는 Timestream 권한을 부여하는 Amazon 리소스 이름(ARN)입니다. 계정 설정을 업데이트할 때 SNS 주제가 제공된 경우에만 이 필드가 표시됩니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 예 ** SnsConfiguration ** 알림을 보내는 데 필요한 SNS의 세부 정보입니다. 유형: [SnsConfiguration](API_query_SnsConfiguration.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) # ColumnInfo 열 이름, 데이터 유형. 기타 속성 등의 쿼리 결과에 대한 메타데이터를 포함합니다. ## 내용 ** Type ** 결과 세트 열의 데이터 유형입니다. 데이터 유형은 스칼라 또는 복소수일 수 있습니다. 스칼라 데이터 유형은 integer, string, double, Booleans 등입니다. 복소수 데이터 유형은 배열, 행 등입니다. 타입: [Type](API_query_Type.md)객체 필수 여부: 예 ** Name ** 결과 세트 열의 이름입니다. 결과 세트의 이름은 배열을 제외한 모든 데이터 유형의 열에 사용할 수 있습니다. 유형: 문자열 필수 항목 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ColumnInfo) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ColumnInfo) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ColumnInfo) # Datum 데이텀은 쿼리 결과에서 단일 데이터 포인트를 나타냅니다. ## 내용 ** ArrayValue ** 데이터 포인트가 배열인지 여부를 나타냅니다. 타입: [Datum](#API_query_Datum)객체 배열 필수 여부: 아니요 ** NullValue ** 데이터 포인트가 null인지 여부를 나타냅니다. 유형: 부울 필수 여부: 아니요 ** RowValue ** 데이터 포인트가 행인지 여부를 나타냅니다. 유형: [Row](API_query_Row.md)객체 필수 여부: 아니요 ** ScalarValue ** 데이터 포인트가 integer, string, double, Boolean 등의 스칼라 값인지 여부를 나타냅니다. 유형: 문자열 필수 여부: 아니요 ** TimeSeriesValue ** 데이터 포인트가 시계열 데이터 유형인지 여부를 나타냅니다. 타입: [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md)객체 배열 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Datum) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Datum) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Datum) # DimensionMapping 이 유형은 쿼리 결과의 열을 대상 테이블의 차원에 매핑하는 데 사용됩니다. ## 내용 ** DimensionValueType ** 차원의 유형입니다. 타입: 문자열 유효 값: `VARCHAR` 필수 여부: 예 ** Name ** 쿼리 결과의 열 이름입니다. 유형: 문자열 필수 항목 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DimensionMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DimensionMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DimensionMapping) # Endpoint API 직접 호출을 수행할 사용 가능한 대상 엔드포인트와 해당 엔드포인트의 TTL을 나타냅니다. ## 내용 ** Address ** 엔드포인트 주소입니다. 유형: 문자열 필수 항목 여부: 예 ** CachePeriodInMinutes ** 엔드포인트의 TTL(분)입니다. 타입: Long 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Endpoint) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Endpoint) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Endpoint) # ErrorReportConfiguration 오류 보고에 필요한 구성입니다. ## 내용 ** S3Configuration ** 오류 보고서에 대한 S3 구성입니다. 타입: [S3Configuration](API_query_S3Configuration.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportConfiguration) # ErrorReportLocation 단일 예약된 쿼리 직접 호출에 대한 오류 보고서의 위치를 포함합니다. ## 내용 ** S3ReportLocation ** 오류 보고서가 작성되는 S3 위치입니다. 유형: [S3ReportLocation](API_query_S3ReportLocation.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportLocation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportLocation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportLocation) # ExecutionStats 단일 예약된 쿼리 실행에 대한 통계입니다. ## 내용 ** BytesMetered ** 단일 예약된 쿼리 실행에 대해 측정된 바이트 수입니다. 유형: Long 필수 여부: 아니요 ** CumulativeBytesScanned ** 단일 예약된 쿼리 실행에 대해 스캔된 바이트 수입니다. 유형: Long 필수 여부: 아니요 ** DataWrites ** 단일 예약된 쿼리 실행에서 수집된 레코드에 대해 측정된 데이터 쓰기 횟수입니다. 유형: Long 필수 여부: 아니요 ** ExecutionTimeInMillis ** 예약된 쿼리 실행이 완료되는 데 필요한 총 시간(밀리초)입니다. 유형: Long 필수 여부: 아니요 ** QueryResultRows ** 대상 데이터 소스로 수집하기 전에 쿼리 실행 결과 출력에 존재하는 행 수입니다. 유형: Long 필수 여부: 아니요 ** RecordsIngested ** 단일 예약된 쿼리 실행에 대해 수집된 레코드 수입니다. 유형: Long 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecutionStats) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecutionStats) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecutionStats) # LastUpdate 가장 최근의 계정 설정 업데이트를 포함하는 구성 객체이며, 설정이 이전에 업데이트된 경우에만 표시됩니다. ## 내용 ** Status ** 마지막 업데이트의 상태입니다. `PENDING`, `FAILED` 또는 `SUCCEEDED`일 수 있습니다. 타입: 문자열 유효 값: `PENDING | FAILED | SUCCEEDED` 필수 여부: 아니요 ** StatusMessage ** 마지막 계정 설정 업데이트 상태를 설명하는 오류 메시지이며, 오류가 발생한 경우에만 표시됩니다. 유형: 문자열 필수 여부: 아니요 ** TargetQueryTCU ** 마지막 계정 설정 업데이트에서 요청된 TimeStream 컴퓨팅 유닛(TCU) 수입니다. 유형: Integer 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/LastUpdate) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/LastUpdate) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/LastUpdate) # MixedMeasureMapping MixedMeasureMappings는 파생 테이블에서 좁은 측정과 다중 측정의 혼합으로 데이터를 모으는 데 사용할 수 있는 매핑입니다. ## 내용 ** MeasureValueType ** sourceColumn에서 읽을 값의 유형입니다. 매핑이 MULTI용인 경우 MeasureValueType.MULTI를 사용합니다. 타입: 문자열 유효 값: `BIGINT | BOOLEAN | DOUBLE | VARCHAR | MULTI` 필수 여부: 예 ** MeasureName ** 결과 행의 measure\$1name 값을 참조합니다. MeasureNameColumn이 제공된 경우 이 필드는 필수입니다. 유형: 문자열 필수 여부: 아니요 ** MultiMeasureAttributeMappings ** measureValueType이 MULTI인 경우 필수입니다. MULTI 값 측정에 대한 속성 매핑입니다. 타입: [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md)객체 배열 배열 구성원: 최소수는 1개입니다. 필수 여부: 아니요 ** SourceColumn ** 이 필드는 결과 구체화를 위해 측정값을 읽을 소스 열을 나타냅니다. 유형: 문자열 필수 여부: 아니요 ** TargetMeasureName ** 사용할 대상 측정 이름입니다. 제공되지 않은 경우 대상 측정 이름은 기본적으로 제공되는 경우 측정 이름이고 그렇지 않은 경우 sourceColumn입니다. 유형: 문자열 필수 항목 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MixedMeasureMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MixedMeasureMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MixedMeasureMapping) # MultiMeasureAttributeMapping MULTI 값 측정에 대한 속성 매핑입니다. ## 내용 ** MeasureValueType ** 소스 열에서 읽을 속성의 유형입니다. 타입: 문자열 유효 값: `BIGINT | BOOLEAN | DOUBLE | VARCHAR | TIMESTAMP` 필수 여부: 예 ** SourceColumn ** 속성 값을 읽을 소스 열입니다. 유형: 문자열 필수 항목 여부: 예 ** TargetMultiMeasureAttributeName ** 파생 테이블의 속성 이름에 사용할 사용자 지정 이름입니다. 제공되지 않으면 소스 열 이름이 사용됩니다. 유형: 문자열 필수 항목 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureAttributeMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureAttributeMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureAttributeMapping) # MultiMeasureMappings MixedMeasureMappings 또는 MultiMeasureMappings 중 하나만 제공되어야 합니다. MultiMeasureMappings를 사용하여 파생 테이블의 다중 측정으로 데이터를 모을 수 있습니다. ## 내용 ** MultiMeasureAttributeMappings ** 필수 사항입니다. 다중 측정 속성에 대한 데이터를 모으기 위해 쿼리 결과를 매핑하는 데 사용할 속성 매핑입니다. 타입: [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md)객체 배열 어레이 멤버: 최소 항목 수 1개. 필수 여부: 예 ** TargetMultiMeasureName ** 파생 테이블에 있는 대상 다중 측정 이름입니다. measureNameColumn이 제공되는 경우 이 입력은 필수입니다. MeasureNameColumn이 제공되는 경우 해당 열의 값이 다중 측정 이름으로 사용됩니다. 유형: 문자열 필수 항목 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureMappings) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureMappings) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureMappings) # NotificationConfiguration 예약된 쿼리에 대한 알림 구성입니다. 예약된 쿼리가 생성되거나 상태가 업데이트 또는 삭제될 때 Timestream에서 알림을 보냅니다. ## 내용 ** SnsConfiguration ** Amazon Simple Notification Service(SNS) 구성에 대한 세부 정보입니다. 계정 설정을 업데이트할 때 SNS 주제가 제공된 경우에만 이 필드가 표시됩니다. 타입: [SnsConfiguration](API_query_SnsConfiguration.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/NotificationConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/NotificationConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/NotificationConfiguration) # ParameterMapping 명명된 파라미터에 대한 매핑입니다. ## 내용 ** Name ** 파라미터 이름입니다. 유형: 문자열 필수 항목 여부: 예 ** Type ** 쿼리 결과 세트에 있는 열의 데이터 유형을 포함합니다. 데이터 유형은 스칼라 또는 복소수일 수 있습니다. 지원되는 스칼라 데이터 유형은 integer, Boolean, string, double, timestamp, date, time 및 interval입니다. 지원되는 복소수 데이터 유형은 배열, 행 및 시계열입니다. 타입: [Type](API_query_Type.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ParameterMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ParameterMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ParameterMapping) # ProvisionedCapacityRequest 데이터 쿼리를 위해 프로비저닝된 용량 설정을 업데이트하는 요청입니다. ## 내용 ** TargetQueryTCU ** 데이터 쿼리를 위한 목표 컴퓨팅 용량으로, Timestream 컴퓨팅 유닛(TCU) 단위로 지정됩니다. 유형: 정수 필수 여부: 예 ** NotificationConfiguration ** 프로비저닝된 용량 업데이트와 관련된 알림에 대한 구성 설정입니다. 유형: [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityRequest) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityRequest) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityRequest) # ProvisionedCapacityResponse 데이터 쿼리를 위해 프로비저닝된 용량 설정을 업데이트하는 요청에 대한 응답입니다. ## 내용 ** ActiveQueryTCU ** 계정에서 프로비저닝된 Timestream 컴퓨팅 유닛(TCU) 수입니다. 컴퓨팅 모드가 `PROVISIONED`인 경우에만 이 필드가 표시됩니다. 유형: Integer 필수 여부: 아니요 ** LastUpdate ** 프로비저닝된 용량 설정의 마지막 업데이트에 대한 정보입니다. 유형: [LastUpdate](API_query_LastUpdate.md)객체 필수 여부: 아니요 ** NotificationConfiguration ** 프로비저닝된 용량 설정이 수정될 때마다 전송되는 알림에 대한 설정이 포함된 객체입니다. 컴퓨팅 모드가 `PROVISIONED`인 경우에만 이 필드가 표시됩니다. 유형: [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityResponse) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityResponse) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityResponse) # QueryComputeRequest 데이터 쿼리를 위해 컴퓨팅 용량 설정을 검색하거나 업데이트하는 요청입니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다. ## 내용 ** ComputeMode ** 계정 내에서 Timestream 컴퓨팅 유닛(TCU)이 할당되고 사용되는 모드입니다. 참고로 아시아 태평양(뭄바이) 리전에서는 API 작업이 `PROVISIONED` 값만 인식합니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다. 타입: 문자열 유효 값: `ON_DEMAND | PROVISIONED` 필수 여부: 아니요 ** ProvisionedCapacity ** 계정에서 프로비저닝된 Timestream 컴퓨팅 유닛(TCU)에 대한 설정이 포함된 구성 객체입니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다. 유형: [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeRequest) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeRequest) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeRequest) # QueryComputeResponse 데이터 쿼리를 위해 컴퓨팅 용량 설정을 검색하거나 업데이트하는 요청에 대한 응답입니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다. ## 내용 ** ComputeMode ** 계정 내에서 Timestream 컴퓨팅 유닛(TCU)이 할당되고 사용되는 모드입니다. 참고로 아시아 태평양(뭄바이) 리전에서는 API 작업이 `PROVISIONED` 값만 인식합니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다. 타입: 문자열 유효 값: `ON_DEMAND | PROVISIONED` 필수 여부: 아니요 ** ProvisionedCapacity ** 계정에서 프로비저닝된 Timestream 컴퓨팅 유닛(TCU)에 대한 설정이 포함된 구성 객체입니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다. 유형: [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeResponse) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeResponse) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeResponse) # QueryInsights `QueryInsights`는 쿼리를 최적화하여 비용을 절감하고 성능을 개선하는 데 도움이 되는 성능 튜닝 기능입니다. `QueryInsights`를 사용하면 쿼리의 정리 효율성을 평가하고 쿼리 성능 향상을 위한 개선 영역을 파악할 수 있습니다. `QueryInsights`를 사용하면 시간 및 공간 정리 측면에서 쿼리의 효과를 분석하고 성능을 개선할 기회를 식별할 수도 있습니다. 특히 쿼리가 시간 기반 및 파티션 키 기반 인덱싱 전략을 얼마나 잘 활용하여 데이터 검색을 최적화하는지 평가할 수 있습니다. 쿼리 성능을 최적화하려면 쿼리 실행을 제어하는 시간적 및 공간적 파라미터를 모두 미세 조정하는 것이 필수적입니다. `QueryInsights`에서 제공하는 주요 지표는 `QuerySpatialCoverage`와 `QueryTemporalRange`입니다. `QuerySpatialCoverage`는 쿼리가 공간 축을 얼마나 많이 스캔하는지를 나타내며, 값이 낮을수록 효율성이 높습니다. `QueryTemporalRange`는 스캔한 시간 범위를 보여주며, 범위가 좁을수록 성능이 향상됩니다. **QueryInsights의 이점** 다음은 `QueryInsights` 사용에 따른 주요 이점입니다. + **비효율적인 쿼리 식별** - `QueryInsights`는 쿼리에서 액세스하는 테이블의 시간 기반 및 속성 기반 정리에 대한 정보를 제공합니다. 이 정보는 액세스 효율이 낮은 테이블을 식별하는 데 도움이 됩니다. + **데이터 모델 및 파티셔닝 최적화** - `QueryInsights` 정보를 사용하여 데이터 모델 및 파티셔닝 전략에 액세스하고 미세 조정할 수 있습니다. + **쿼리 튜닝** - `QueryInsights`는 인덱스를 보다 효과적으로 사용할 수 있는 기회를 강조합니다. **참고** `QueryInsights`가 활성화된 상태에서 수행할 수 있는 최대 `Query` API 요청 수는 초당 쿼리(QPS) 1개입니다. 이 쿼리 속도를 초과하면 스로틀링이 발생할 수 있습니다. ## 내용 ** Mode ** `QueryInsights`를 활성화하기 위한 다음 모드를 제공합니다. + `ENABLED_WITH_RATE_CONTROL` - 처리 중인 쿼리에 대해 `QueryInsights`를 활성화합니다. 이 모드에는 `QueryInsights` 기능의 초당 쿼리(QPS) 수를 1개로 제한하는 속도 제어 메커니즘도 포함되어 있습니다. + `DISABLED` - `QueryInsights`를 비활성화합니다. 타입: 문자열 유효 값: `ENABLED_WITH_RATE_CONTROL | DISABLED` 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsights) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsights) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsights) # QueryInsightsResponse 실행한 쿼리와 관련된 다양한 인사이트와 지표를 제공합니다. ## 내용 ** OutputBytes ** 쿼리 결과 세트의 크기(바이트)를 나타냅니다. 이 데이터를 사용하여 쿼리 튜닝 과정에서 결과 세트가 변경되었는지 확인할 수 있습니다. 유형: Long 필수 여부: 아니요 ** OutputRows ** 쿼리 결과 세트의 일부로 반환된 총 행 수를 나타냅니다. 이 데이터를 사용하여 쿼리 튜닝 과정에서 결과 세트의 행 수가 변경되었는지 확인할 수 있습니다. 유형: Long 필수 여부: 아니요 ** QuerySpatialCoverage ** 쿼리의 공간 커버리지에 대한 인사이트를 제공하며, 여기에는 공간 정리가 최적이 아닌(최대) 테이블이 포함됩니다. 이 정보는 공간 정리를 개선하기 위해 파티셔닝 전략에서 개선이 필요한 영역을 식별하는 데 도움이 될 수 있습니다. 유형: [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md)객체 필수 여부: 아니요 ** QueryTableCount ** 쿼리의 테이블 수를 나타냅니다. 유형: Long 필수 여부: 아니요 ** QueryTemporalRange ** 쿼리의 임시 범위에 대한 인사이트를 제공하며, 여기에는 임시 범위가 가장 큰(테이블) 테이블이 포함됩니다. 다음은 시간 기반 정리 최적화를 위한 몇 가지 잠재적 옵션입니다. + 누락된 시간 조건자를 추가합니다. + 시간 조건자 주변의 함수를 제거합니다. + 모든 하위 쿼리에 시간 조건자를 추가합니다. 유형: [QueryTemporalRange](API_query_QueryTemporalRange.md)객체 필수 여부: 아니요 ** UnloadPartitionCount ** `Unload` 작업에서 생성된 파티션을 나타냅니다. 유형: Long 필수 여부: 아니요 ** UnloadWrittenBytes ** `Unload` 작업에서 쓴 크기(바이트)를 나타냅니다. 유형: Long 필수 여부: 아니요 ** UnloadWrittenRows ** `Unload` 쿼리에서 쓴 행을 나타냅니다. 유형: Long 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsightsResponse) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsightsResponse) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsightsResponse) # QuerySpatialCoverage 쿼리의 공간 커버리지에 대한 인사이트를 제공하며, 여기에는 공간 정리가 최적이 아닌(최대) 테이블이 포함됩니다. 이 정보는 공간 정리를 개선하기 위해 파티셔닝 전략에서 개선이 필요한 영역을 식별하는 데 도움이 될 수 있습니다. 예를 들어, `QuerySpatialCoverage` 정보를 사용하여 다음을 수행할 수 있습니다. + measure\$1name을 추가하거나 [고객 정의 파티션 키](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html)(CDPK) 조건자를 사용합니다. + 이미 앞의 작업을 수행했다면 `LIKE`와 같은 주변 함수나 절을 제거합니다. ## 내용 ** Max ** 실행된 쿼리와 공간 정리가 가장 비효율적인 테이블의 공간 커버리지에 대한 인사이트를 제공합니다. + `Value` - 공간 커버리지의 최대 비율입니다. + `TableArn` - 공간 정리가 최적화되지 않은 테이블의 Amazon 리소스 이름(ARN)입니다. + `PartitionKey` - 파티셔닝에 사용되는 파티션 키로, 기본값인 `measure_name` 또는 CDPK일 수 있습니다. 유형: [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverage) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverage) # QuerySpatialCoverageMax 쿼리에서 스캔한 공간 범위가 가장 최적이 아닌 테이블에 대한 인사이트를 제공합니다. ## 내용 ** PartitionKey ** 파티셔닝에 사용되는 파티션 키로, 기본값인 `measure_name` 또는 [고객 정의 파티션 키](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html)일 수 있습니다. 유형: 문자열 배열 필수 여부: 아니요 ** TableArn ** 공간 정리가 가장 최적이 아닌 테이블의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 ** Value ** 공간 커버리지의 최대 비율입니다. 유형: 더블 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverageMax) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverageMax) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverageMax) # QueryStatus 쿼리 상태에 대한 정보로, 진행률과 스캔된 바이트 수를 포함합니다. ## 내용 ** CumulativeBytesMetered ** 쿼리에서 스캔한 데이터 양(바이트)에 따라 요금이 부과됩니다. 이는 누적 합계이며, 쿼리가 시작된 이후로 요금이 청구될 데이터의 총량을 나타냅니다. 요금은 한 번만 부과되며, 쿼리 실행이 완료될 때 또는 쿼리가 취소될 때 적용됩니다. 유형: Long 필수 여부: 아니요 ** CumulativeBytesScanned ** 쿼리에서 스캔한 데이터 양(바이트)입니다. 이는 누적 합계이며, 쿼리가 시작된 이후 스캔된 총 바이트 수를 나타냅니다. 유형: Long 필수 여부: 아니요 ** ProgressPercentage ** 백분율로 표시되는 쿼리 진행률입니다. 유형: 더블 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryStatus) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryStatus) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryStatus) # QueryTemporalRange 쿼리의 임시 범위에 대한 인사이트를 제공하며, 여기에는 임시 범위가 가장 큰(테이블) 테이블이 포함됩니다. ## 내용 ** Max ** 시간 축에서 가장 성능이 저조한 테이블에 대한 인사이트를 제공하는 다음 속성을 캡슐화합니다. + `Value` - 쿼리 시작과 종료 사이의 최대 지속 시간(나노초)입니다. + `TableArn` - 가장 넓은 시간 범위로 쿼리된 테이블의 Amazon 리소스 이름(ARN)입니다. 유형: [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRange) # QueryTemporalRangeMax 쿼리에서 스캔한 시간 정리가 가장 최적이 아닌 테이블에 대한 인사이트를 제공합니다. ## 내용 ** TableArn ** 가장 넓은 시간 범위로 쿼리된 테이블의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 ** Value ** 쿼리 시작과 종료 사이의 최대 지속 시간(나노초)입니다. 유형: Long 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRangeMax) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRangeMax) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRangeMax) # Row 쿼리 결과에서 단일 행을 나타냅니다. ## 내용 ** Data ** 결과 세트의 단일 행에 포함된 데이터 포인트 목록입니다. 타입: [Datum](API_query_Datum.md)객체 배열 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Row) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Row) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Row) # S3Configuration 쿼리 실행으로 인한 오류 보고서의 S3 위치에 대한 세부 정보입니다. ## 내용 ** BucketName ** 오류 보고서가 생성될 S3 버킷의 이름입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 63입니다. 패턴: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 필수 여부: 예 ** EncryptionOption ** 오류 보고서에 대한 저장 시 암호화 옵션입니다. 암호화 옵션이 지정되지 않은 경우 Timestream은 기본적으로 SSE\$1S3를 선택합니다. 타입: 문자열 유효 값: `SSE_S3 | SSE_KMS` 필수 여부: 아니요 ** ObjectKeyPrefix ** 오류 보고서 키의 접두사입니다. Timestream은 기본적으로 오류 보고서 경로에 다음 접두사를 추가합니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 896. 패턴: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3Configuration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3Configuration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3Configuration) # S3ReportLocation 예약된 쿼리 실행에 대한 S3 보고서 위치입니다. ## 내용 ** BucketName ** S3 버킷 이름 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 63입니다. 패턴: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 필수 여부: 아니요 ** ObjectKey ** S3 키입니다. 유형: 문자열 필수 항목 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3ReportLocation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3ReportLocation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3ReportLocation) # ScheduleConfiguration 쿼리 일정의 구성입니다. ## 내용 ** ScheduleExpression ** 예약된 쿼리 실행을 트리거할 시기를 나타내는 표현식입니다. cron 표현식 또는 rate 표현식일 수 있습니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256. 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduleConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduleConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduleConfiguration) # ScheduledQuery 예약된 쿼리 ## 내용 ** Arn ** Amazon 리소스 이름입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 예 ** Name ** 예약된 쿼리의 이름입니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 필수 여부: 예 ** State ** 예약된 쿼리의 상태입니다. 타입: 문자열 유효 값: `ENABLED | DISABLED` 필수 여부: 예 ** CreationTime ** 예약된 쿼리의 생성 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** ErrorReportConfiguration ** 예약된 쿼리 오류 보고에 대한 구성입니다. 유형: [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)객체 필수 여부: 아니요 ** LastRunStatus ** 마지막으로 예약된 쿼리 실행의 상태입니다. 타입: 문자열 유효 값: `AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE` 필수 여부: 아니요 ** NextInvocationTime ** 예약된 쿼리가 실행될 다음 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** PreviousInvocationTime ** 예약된 쿼리가 마지막으로 실행된 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** TargetDestination ** 최종 예약된 쿼리 결과가 작성될 대상 데이터 소스입니다. 유형: [TargetDestination](API_query_TargetDestination.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQuery) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQuery) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQuery) # ScheduledQueryDescription 예약된 쿼리를 설명하는 구조입니다. ## 내용 ** Arn ** 예약된 쿼리 ARN입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 예 ** Name ** 예약된 쿼리의 이름입니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 필수 여부: 예 ** NotificationConfiguration ** 알림 구성입니다. 타입: [NotificationConfiguration](API_query_NotificationConfiguration.md)객체 필수 여부: 예 ** QueryString ** 실행할 쿼리입니다. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이는 262144자입니다. 필수 여부: 예 ** ScheduleConfiguration ** 일정 구성입니다. 타입: [ScheduleConfiguration](API_query_ScheduleConfiguration.md)객체 필수 여부: 예 ** State ** 예약된 쿼리의 상태입니다. 타입: 문자열 유효 값: `ENABLED | DISABLED` 필수 여부: 예 ** CreationTime ** 예약된 쿼리의 생성 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** ErrorReportConfiguration ** 예약된 쿼리의 오류 보고 구성입니다. 유형: [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)객체 필수 여부: 아니요 ** KmsKeyId ** 예약된 쿼리 리소스를 암호화하는 데 사용되는 고객 제공 KMS 키입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 ** LastRunSummary ** 마지막으로 예약된 쿼리 실행에 대한 런타임 요약입니다. 유형: [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md)객체 필수 여부: 아니요 ** NextInvocationTime ** 예약된 쿼리가 실행되도록 예약된 다음 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** PreviousInvocationTime ** 쿼리가 실행된 마지막 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ** RecentlyFailedRuns ** 마지막으로 실패한 5건의 예약된 쿼리 실행에 대한 런타임 요약입니다. 타입: [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md)객체 배열 필수 여부: 아니요 ** ScheduledQueryExecutionRoleArn ** Timestream이 예약된 쿼리를 실행하는 데 사용하는 IAM 역할입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 아니요 ** TargetConfiguration ** 예약된 쿼리 대상 스토어 구성입니다. 유형: [TargetConfiguration](API_query_TargetConfiguration.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryDescription) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryDescription) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryDescription) # ScheduledQueryInsights `ExecuteScheduledQueryRequest`에서 `QueryInsights`를 활성화하기 위한 설정을 캡슐화합니다. ## 내용 ** Mode ** `ScheduledQueryInsights`를 활성화하기 위한 다음 모드를 제공합니다. + `ENABLED_WITH_RATE_CONTROL` - 처리 중인 쿼리에 대해 `ScheduledQueryInsights`를 활성화합니다. 이 모드에는 `QueryInsights` 기능의 초당 쿼리(QPS) 수를 1개로 제한하는 속도 제어 메커니즘도 포함되어 있습니다. + `DISABLED` - `ScheduledQueryInsights`를 비활성화합니다. 타입: 문자열 유효 값: `ENABLED_WITH_RATE_CONTROL | DISABLED` 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsights) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsights) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsights) # ScheduledQueryInsightsResponse 실행된 `ExecuteScheduledQueryRequest`와 관련된 다양한 인사이트와 지표를 제공합니다. ## 내용 ** OutputBytes ** 쿼리 결과 세트의 크기(바이트)를 나타냅니다. 이 데이터를 사용하여 쿼리 튜닝 과정에서 결과 세트가 변경되었는지 확인할 수 있습니다. 유형: Long 필수 여부: 아니요 ** OutputRows ** 쿼리 결과 세트의 일부로 반환된 총 행 수를 나타냅니다. 이 데이터를 사용하여 쿼리 튜닝 과정에서 결과 세트의 행 수가 변경되었는지 확인할 수 있습니다. 유형: Long 필수 여부: 아니요 ** QuerySpatialCoverage ** 쿼리의 공간 커버리지에 대한 인사이트를 제공하며, 여기에는 공간 정리가 최적이 아닌(최대) 테이블이 포함됩니다. 이 정보는 공간 정리를 개선하기 위해 파티셔닝 전략에서 개선이 필요한 영역을 식별하는 데 도움이 될 수 있습니다. 유형: [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md)객체 필수 여부: 아니요 ** QueryTableCount ** 쿼리의 테이블 수를 나타냅니다. 유형: Long 필수 여부: 아니요 ** QueryTemporalRange ** 쿼리의 임시 범위에 대한 인사이트를 제공하며, 여기에는 임시 범위가 가장 큰(테이블) 테이블이 포함됩니다. 다음은 시간 기반 정리 최적화를 위한 몇 가지 잠재적 옵션입니다. + 누락된 시간 조건자를 추가합니다. + 시간 조건자 주변의 함수를 제거합니다. + 모든 하위 쿼리에 시간 조건자를 추가합니다. 유형: [QueryTemporalRange](API_query_QueryTemporalRange.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) # ScheduledQueryRunSummary 예약된 쿼리에 대한 실행 요약 ## 내용 ** ErrorReportLocation ** 오류 보고를 위한 S3 위치입니다. 유형: [ErrorReportLocation](API_query_ErrorReportLocation.md)객체 필수 여부: 아니요 ** ExecutionStats ** 예약된 실행에 대한 런타임 통계입니다. 유형: [ExecutionStats](API_query_ExecutionStats.md)객체 필수 여부: 아니요 ** FailureReason ** 예약된 쿼리가 실패할 경우 표시되는 오류 메시지입니다. 더 자세한 오류 원인을 확인하려면 오류 보고서를 살펴봐야 할 수도 있습니다. 유형: 문자열 필수 여부: 아니요 ** InvocationTime ** 이 실행에 대한 InvocationTime입니다. 쿼리가 실행되도록 예약된 시간입니다. 파라미터 `@scheduled_runtime`은 쿼리에서 값을 가져오는 데 사용할 수 있습니다. 유형: 타임스탬프 필수 여부: 아니요 ** QueryInsightsResponse ** 예약된 쿼리의 실행 요약과 관련된 다양한 인사이트와 지표를 제공합니다. 유형: [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md)객체 필수 여부: 아니요 ** RunStatus ** 예약된 쿼리 실행의 상태입니다. 타입: 문자열 유효 값: `AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE` 필수 여부: 아니요 ** TriggerTime ** 쿼리가 실행된 실제 시간입니다. 유형: 타임스탬프 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryRunSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryRunSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryRunSummary) # SelectColumn 쿼리에서 반환되는 열의 세부 정보입니다. ## 내용 ** Aliased ** 쿼리에서 열 이름을 별칭으로 지정한 경우 true입니다. 그렇지 않으면 false입니다. 유형: 부울 필수 여부: 아니요 ** DatabaseName ** 이 열이 있는 데이터베이스입니다. 유형: 문자열 필수 여부: 아니요 ** Name ** 열의 이름입니다. 유형: 문자열 필수 여부: 아니요 ** TableName ** 이 열이 있는 데이터베이스 내의 테이블입니다. 유형: 문자열 필수 여부: 아니요 ** Type ** 쿼리 결과 세트에 있는 열의 데이터 유형을 포함합니다. 데이터 유형은 스칼라 또는 복소수일 수 있습니다. 지원되는 스칼라 데이터 유형은 integer, Boolean, string, double, timestamp, date, time 및 interval입니다. 지원되는 복소수 데이터 유형은 배열, 행 및 시계열입니다. 유형: [Type](API_query_Type.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SelectColumn) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SelectColumn) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SelectColumn) # SnsConfiguration 알림을 보내는 데 필요한 SNS의 세부 정보입니다. ## 내용 ** TopicArn ** 예약된 쿼리 상태 알림이 전송될 SNS 주제 ARN입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SnsConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SnsConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SnsConfiguration) # Tag 태그는 Timestream 데이터베이스 및/또는 테이블에 할당하는 레이블입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 태그를 사용하면 데이터베이스 및/또는 테이블을 용도, 소유자 또는 환경 등에 따라 분류할 수 있습니다. ## 내용 ** Key ** 태그의 키입니다. 태그 키는 대소문자를 구별합니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 128. 필수 여부: 예 ** Value ** 태그의 값입니다. 태그 값은 대소문자를 구분하며 null일 수 있습니다. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256. 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Tag) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Tag) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Tag) # TargetConfiguration 쿼리의 출력을 쓰는 데 사용되는 구성입니다. ## 내용 ** TimestreamConfiguration ** Timestream 데이터베이스 및 테이블에 데이터를 쓰는 데 필요한 구성입니다. 타입: [TimestreamConfiguration](API_query_TimestreamConfiguration.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetConfiguration) # TargetDestination 대상 데이터 소스에 대한 데이터를 쓰기 위한 대상 세부 정보입니다. 현재 지원되는 데이터 소스는 Timestream입니다. ## 내용 ** TimestreamDestination ** Timestream 데이터 소스에 대한 쿼리 결과 대상 세부 정보입니다. 유형: [TimestreamDestination](API_query_TimestreamDestination.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetDestination) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetDestination) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetDestination) # TimeSeriesDataPoint 시계열 데이터 유형은 시간 경과에 따른 측정값을 나타냅니다. 시계열은 타임스탬프 및 측정값의 행 배열이며 행은 오름차순으로 정렬됩니다. TimeSeriesDataPoint는 시계열의 단일 데이터 포인트입니다. 시계열에서 (시간, 측정값)의 튜플을 나타냅니다. ## 내용 ** Time ** 측정값이 수집된 시점의 타임스탬프입니다. 유형: 문자열 필수 항목 여부: 예 ** Value ** 데이터 포인트의 측정값입니다. 타입: [Datum](API_query_Datum.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimeSeriesDataPoint) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimeSeriesDataPoint) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimeSeriesDataPoint) # TimestreamConfiguration Timestream 데이터베이스 및 테이블에 데이터를 쓰기 위한 구성입니다. 이 구성을 통해 사용자는 쿼리 결과 선택 열을 대상 테이블 열에 매핑할 수 있습니다. ## 내용 ** DatabaseName ** 쿼리 결과를 쓸 Timeststream 데이터베이스의 이름입니다. 유형: 문자열 필수 항목 여부: 예 ** DimensionMappings ** 이는 쿼리 결과의 열을 대상 테이블의 차원으로 매핑할 수 있도록 하기 위한 것입니다. 타입: [DimensionMapping](API_query_DimensionMapping.md)객체 배열 필수 여부: 예 ** TableName ** 쿼리 결과를 쓸 Timeststream 테이블의 이름입니다. 테이블은 Timestream 구성에서 제공되는 동일한 데이터베이스 내에 있어야 합니다. 유형: 문자열 필수 항목 여부: 예 ** TimeColumn ** 대상 테이블에서 시간 열로 사용해야 하는 쿼리 결과의 열입니다. 이에 대한 열 유형은 TIMESTAMP여야 합니다. 유형: 문자열 필수 항목 여부: 예 ** MeasureNameColumn ** 측정 열의 이름입니다. 유형: 문자열 필수 여부: 아니요 ** MixedMeasureMappings ** 다중 측정 레코드에 측정값을 매핑하는 방법을 지정합니다. 타입: [MixedMeasureMapping](API_query_MixedMeasureMapping.md)객체 배열 배열 구성원: 최소수는 1개입니다. 필수 여부: 아니요 ** MultiMeasureMappings ** 다중 측정 매핑입니다. 유형: [MultiMeasureMappings](API_query_MultiMeasureMappings.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamConfiguration) # TimestreamDestination 예약된 쿼리의 대상입니다. ## 내용 ** DatabaseName ** Timestream 데이터베이스 이름입니다. 유형: 문자열 필수 여부: 아니요 ** TableName ** Timestream 테이블 이름입니다. 유형: 문자열 필수 항목 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamDestination) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamDestination) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamDestination) # Type 쿼리 결과 세트에 있는 열의 데이터 유형을 포함합니다. 데이터 유형은 스칼라 또는 복소수일 수 있습니다. 지원되는 스칼라 데이터 유형은 integer, Boolean, string, double, timestamp, date, time 및 interval입니다. 지원되는 복소수 데이터 유형은 배열, 행 및 시계열입니다. ## 내용 ** ArrayColumnInfo ** 열이 배열인지 여부를 나타냅니다. 유형: [ColumnInfo](API_query_ColumnInfo.md)객체 필수 여부: 아니요 ** RowColumnInfo ** 열이 행인지 여부를 나타냅니다. 타입: [ColumnInfo](API_query_ColumnInfo.md)객체 배열 필수 여부: 아니요 ** ScalarType ** 열이 string, integer, Boolean, double, timestamp, date, time 유형인지 여부를 나타냅니다. 자세한 내용은 [지원되는 데이터 유형](https://docs.aws.amazon.com/timestream/latest/developerguide/supported-data-types.html)을 참조하세요. 타입: 문자열 유효 값: `VARCHAR | BOOLEAN | BIGINT | DOUBLE | TIMESTAMP | DATE | TIME | INTERVAL_DAY_TO_SECOND | INTERVAL_YEAR_TO_MONTH | UNKNOWN | INTEGER` 필수 여부: 아니요 ** TimeSeriesMeasureValueColumnInfo ** 열이 시계열 데이터 유형인지 여부를 나타냅니다. 유형: [ColumnInfo](API_query_ColumnInfo.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Type) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Type) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Type) # 일반적인 오류 유형 이 섹션에는이 AWS 서비스가 반환할 수 있는 일반적인 오류 유형이 나열되어 있습니다. 모든 서비스가 여기에 나열된 모든 오류 유형을 반환하는 것은 아닙니다. 이 서비스의 API 작업에 대한 오류는 해당 API 작업에 대한 주제를 참조하세요. **AccessDeniedException** 이 작업을 수행하려면 권한이 있어야 합니다. IAM 정책에 필요한 권한이 포함되어 있는지 확인합니다. HTTP 상태 코드: 403 **ExpiredTokenException** 요청에 포함된 보안 토큰이 만료되었습니다. 새 보안 토큰을 요청하고 다시 시도하세요. HTTP 상태 코드: 403 **IncompleteSignature** 요청 서명이 AWS 표준을 준수하지 않습니다. 유효한 AWS 자격 증명을 사용하고 있고 요청의 형식이 올바른지 확인합니다. SDK를 사용하는 경우 최신 상태인지 확인합니다. HTTP 상태 코드: 403 **InternalFailure** 내부 서버 문제로 인해 현재 요청을 처리할 수 없습니다. 나중에 다시 시도해 주세요. 문제가 지속되면 AWS Support에 문의하세요. HTTP 상태 코드: 500 **MalformedHttpRequestException** 요청 본문을 처리할 수 없습니다. 이는 일반적으로 지정된 콘텐츠 인코딩 알고리즘을 사용하여 요청 본문의 압축을 풀 수 없는 경우에 발생합니다. 콘텐츠 인코딩 헤더가 사용된 압축 형식과 일치하는지 확인합니다. HTTP 상태 코드: 400 **NotAuthorized** 이 작업을 수행할 권한이 없습니다. IAM 정책에 필요한 권한이 포함되어 있는지 확인합니다. HTTP 상태 코드: 401 **OptInRequired** AWS 계정에이 서비스에 대한 구독이 필요합니다. 계정에서 서비스를 활성화했는지 확인합니다. HTTP 상태 코드: 403 **RequestAbortedException** 응답이 반환되기 전에 요청이 중단되었습니다. 이는 일반적으로 클라이언트가 연결을 닫을 때 발생합니다. HTTP 상태 코드: 400 **RequestEntityTooLargeException** 요청 엔티티가 너무 큽니다. 요청 본문의 크기를 줄이고 다시 시도하세요. HTTP 상태 코드: 413 **RequestTimeoutException** 요청 시간이 초과되었습니다. 서버가 예상 기간 내에 전체 요청을 받지 못했습니다. 다시 시도하세요. HTTP 상태 코드: 408 **ServiceUnavailable** 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도해 주세요. HTTP 상태 코드: 503 **ThrottlingException** 요청 속도가 너무 높습니다. AWS SDKs 자동으로 재시도합니다. 요청 횟수를 줄입니다. HTTP 상태 코드: 400 **UnknownOperationException** 작업 또는 작업이 인식되지 않습니다. 작업 이름의 철자가 올바르고 사용 중인 API 버전에서 지원되는지 확인합니다. HTTP 상태 코드: 404 **UnrecognizedClientException** 제공한 X.509 인증서 또는 AWS 액세스 키 ID가 레코드에 없습니다. 유효한 자격 증명을 사용하고 있고 만료되지 않았는지 확인합니다. HTTP 상태 코드: 403 **ValidationError** 입력이 필수 형식 또는 제약 조건을 충족하지 않습니다. 모든 필수 파라미터가 포함되어 있고 값이 유효한지 확인합니다. HTTP 상태 코드: 400 # 공통 파라미터 다음 목록에는 모든 작업이 쿼리 문자열을 사용하여 Signature Version 4 요청에 서명하는 데 사용하는 파라미터가 포함되어 있습니다. 작업별 파라미터는 그 작업에 대한 항목에 나열되어 있습니다. 서명 버전 4에 대한 자세한 내용은 *IAM 사용 설명서*의 [AWS API 요청 서명을](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) 참조하세요. **X-Amz-Algorithm** 요청 서명을 생성하는 데 사용된 해시 알고리즘입니다. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 유효 값: `AWS4-HMAC-SHA256` 필수 항목 여부: 조건부 **X-Amz-Credential** 자격 증명 범위 값이며 액세스 키, 날짜, 대상으로 하는 리전, 요청하는 서비스 및 종료 문자열("aws4\$1request")이 포함된 문자열입니다. 값은 다음 형식으로 표시됩니다. *access\$1key*/*YYYYMMDD*/*region*/*service*/aws4\$1request. 자세한 내용은 *IAM 사용 설명서*의 [서명된 AWS API 요청 생성을](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) 참조하세요. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-Date** 서명을 만드는 데 사용되는 날짜입니다. 형식은 ISO 8601 기본 형식(YYYYMMDD'T'HHMMSS'Z')이어야 합니다. 예를 들어 다음 날짜 시간은 유효한 X-Amz-Date 값: `20120325T120000Z`. 조건: X-Amz-Date는 모든 요청에서 옵션이지만 서명 요청에 사용되는 날짜보다 우선할 때 사용됩니다. 날짜 헤더가 ISO 8601 기본 형식으로 지정된 경우 X-Amz-Date가 필요하지 않습니다. X-Amz-Date를 사용하는 경우 항상 Date 헤더의 값을 재정의합니다. 자세한 내용은 *IAM 사용 설명서*[의 AWS API 요청 서명 요소를](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) 참조하세요. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-Security-Token** AWS Security Token Service ()에 대한 호출을 통해 얻은 임시 보안 토큰입니다AWS STS. AWS STS의 임시 보안 인증 정보를 지원하는 서비스 목록은 **IAM 사용 설명서의 [IAM으로 작업하는AWS 서비스](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)를 참조하세요. 조건:에서 임시 보안 자격 증명을 사용하는 경우 보안 토큰을 포함해야 AWS STS합니다. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-Signature** 서명할 문자열과 파생된 서명 키에서 계산된 16진수로 인코딩된 서명을 지정합니다. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-SignedHeaders** 표준 요청의 일부로 포함된 모든 HTTP 헤더를 지정합니다. 서명된 헤더 지정에 대한 자세한 내용은 *IAM 사용 설명서*의 [서명된 AWS API 요청 생성을](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) 참조하세요. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 필수 항목 여부: 조건부