Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. [여기](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)에서 자세히 알아보세요. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 작업 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)