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