UpdateTable - Amazon Timestream
구문 요청요청 파라미터응답 구문응답 요소오류참고

Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. 여기에서 자세히 알아보세요.

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

UpdateTable

Timestream 테이블의 메모리 스토어와 마그네틱 스토어의 보존 기간을 수정합니다. 보존 기간의 변경 사항은 즉시 적용됩니다. 예를 들어 메모리 스토어의 보존 기간을 처음 2시간으로 설정한 다음 24시간으로 변경한 경우 메모리 스토어는 24시간의 데이터를 보관할 수 있지만 이 변경 후 22시간이 지나면 24시간의 데이터로 채워집니다. Timestream은 메모리 스토어를 채우기 위해 마그네틱 스토어에서 데이터를 검색하지 않습니다.

자세한 내용은 코드 샘플을 참조하세요.

구문 요청

{
   "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"
}

요청 파라미터

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

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

DatabaseName

Timestream 데이터베이스의 이름입니다.

유형: 문자열

길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256.

필수 여부: 예

MagneticStoreWriteProperties

마그네틱 스토어 쓰기를 활성화할 때 테이블에 설정할 속성이 들어 있습니다.

유형: MagneticStoreWriteProperties객체

필수 여부: 아니요

RetentionProperties

메모리 스토어 및 마그네틱 스토어의 보존 기간입니다.

유형: RetentionProperties객체

필수 여부: 아니요

Schema

테이블의 스키마입니다.

유형: Schema객체

필수 여부: 아니요

TableName

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

업데이트된 Timestream 테이블입니다.

타입: Table 객체

오류

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

AccessDeniedException

이 작업을 수행할 권한이 없습니다.

HTTP 상태 코드: 400

InternalServerException

내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다.

HTTP 상태 코드: 500

InvalidEndpointException

요청된 엔드포인트가 유효하지 않습니다.

HTTP 상태 코드: 400

ResourceNotFoundException

작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다.

HTTP 상태 코드: 400

ThrottlingException

사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다.

HTTP 상태 코드: 400

ValidationException

유효하지 않거나 잘못된 형식의 요청입니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.