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

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

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

UpdateAccountSettings

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

참고

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

구문 요청

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

요청 파라미터

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

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

MaxQueryTCU

서비스가 언제든지 쿼리를 처리하는 데 사용할 최대 컴퓨팅 유닛 수입니다. 쿼리를 실행하려면 최소 용량을 4TCU로 설정해야 합니다. 예를 들어 4, 8, 16, 32 등과 같이 최대 TCU 수를 4의 배수로 설정할 수 있습니다. MaxQueryTCU에 대해 지원되는 최댓값은 1,000입니다. 이 소프트 한도 증가를 요청하려면 AWS Support에 문의하세요. maxQueryTCU의 기본 할당량에 대한 자세한 내용은 기본 할당량을 참조하세요. 이 구성은 Timestream 컴퓨팅 유닛(TCU)의 온디맨드 사용에만 적용됩니다.

MaxQueryTCU에 대해 지원되는 최댓값은 1,000입니다. 이 소프트 한도 증가를 요청하려면 AWS Support에 문의하세요. maxQueryTCU의 기본 할당량에 대한 자세한 내용은 기본 할당량을 참조하세요.

유형: Integer

필수 여부: 아니요

QueryCompute

계정의 쿼리 요금 모델 및 프로비저닝된 Timestream 컴퓨팅 유닛(TCU)을 포함하여 계정에 구성된 쿼리 컴퓨팅 설정을 수정합니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다.

참고

이 API는 멱등성이 있습니다. 즉, 동일한 요청을 여러 번 수행하면 요청을 한 번 수행하는 것과 동일한 효과가 있습니다.

유형: QueryComputeRequest객체

필수 여부: 아니요

QueryPricingModel

계정의 쿼리에 대한 요금 모델입니다.

참고

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

서비스가 쿼리를 처리하는 데 언제든지 사용할 구성된 최대 컴퓨팅 유닛 수입니다.

유형: 정수

QueryCompute

계정의 데이터를 쿼리하기 위해 업데이트된 계정 설정을 확인합니다. 이제 아시아 태평양(뭄바이) 리전에서 QueryCompute를 사용할 수 있습니다.

유형: QueryComputeResponse객체

QueryPricingModel

계정의 요금 모델입니다.

타입: 문자열

유효 값: BYTES_SCANNED | COMPUTE_UNITS

오류

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

AccessDeniedException

계정 설정에 액세스하는 데 필요한 권한이 없습니다.

HTTP 상태 코드: 400

InternalServerException

요청 처리 중 내부 서버 오류가 발생했습니다.

HTTP 상태 코드: 400

InvalidEndpointException

요청된 엔드포인트가 잘못되었습니다.

HTTP 상태 코드: 400

ThrottlingException

과도한 요청으로 인해 요청이 제한되었습니다.

HTTP 상태 코드: 400

ValidationException

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

HTTP 상태 코드: 400

참고

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