UpdateAccountSettings - Amazon Timestream
Sintaxe da solicitaçãoParâmetros da solicitaçãoSintaxe da respostaElementos de respostaErrosConsulte também

Para recursos semelhantes aos do Amazon Timestream para LiveAnalytics, considere o Amazon Timestream para InfluxDB. Ele oferece ingestão de dados simplificada e tempos de resposta de consulta de um dígito em milissegundos para análises em tempo real. Saiba mais aqui.

UpdateAccountSettings

Realiza a transição de sua conta para usar TCUs para preços de consulta e modifica o máximo de unidades computacionais de consulta que você configurou. Se você reduzir o valor de MaxQueryTCU para a configuração desejada, o novo valor poderá levar até 24 horas para entrar em vigor.

nota

Depois de fazer a transição de sua conta para usar TCUs para preços de consultas, você não pode fazer a transição para o uso de bytes escaneados para preços de consultas.

Sintaxe da solicitação

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

Parâmetros da solicitação

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte Parâmetros comuns.

A solicitação aceita os dados a seguir no formato JSON.

MaxQueryTCU

O número máximo de unidades de computação que o serviço usará em qualquer momento para atender às suas consultas. Para executar consultas, você deve definir uma capacidade mínima de 4 TCU. É possível estabelecer o número máximo de TCU em múltiplos de 4, como 4, 8, 16, 32 e assim por diante. O valor máximo compatível para MaxQueryTCU é de 1000. Entre em contato com o AWS Support para solicitar um aumento desse limite. Para obter mais informações sobre cotas padrão para maxQueryTCU, consulte Cotas padrão. Essa configuração é aplicável somente para o uso sob demanda de unidades de computação de fluxo de tempo (TCUs).

O valor máximo compatível de MaxQueryTCU é de 1000. Entre em contato com o AWS Support para solicitar um aumento desse limite. Para obter mais informações sobre cotas padrão paramaxQueryTCU, consulte Cotas padrão.

Tipo: inteiro

Obrigatório: não

QueryCompute

Modifica as configurações de computação de consulta definidas em sua conta, incluindo o modelo de preços de consulta e as unidades de computação de fluxo de tempo (TCUs) provisionadas em sua conta. QueryCompute está disponível agora na região da Ásia-Pacífico (Mumbai).

nota

Essa API é idempotente, o que significa que fazer a mesma solicitação várias vezes terá o mesmo efeito que fazer a solicitação uma vez.

Tipo: objeto QueryComputeRequest

Obrigatório: não

QueryPricingModel

O modelo de preços para consultas em uma conta.

nota

O parâmetro QueryPricingModel é usado por várias operações do Timestream, no entanto, a operação da API UpdateAccountSettings não reconhece nenhum valor além de COMPUTE_UNITS.

Tipo: string

Valores válidos: BYTES_SCANNED | COMPUTE_UNITS

Obrigatório: não

Sintaxe da resposta

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

Elementos de resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

MaxQueryTCU

O número máximo configurado de unidades de computação que o serviço usará em qualquer momento para atender às suas consultas.

Tipo: inteiro

QueryCompute

Confirma as configurações atualizadas da conta para consultar dados em sua conta. QueryCompute está disponível agora na região da Ásia-Pacífico (Mumbai).

Tipo: objeto QueryComputeResponse

QueryPricingModel

O modelo de preços de uma conta.

Tipo: string

Valores válidos: BYTES_SCANNED | COMPUTE_UNITS

Erros

Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.

AccessDeniedException

Você não tem as permissões necessárias para acessar as configurações da conta.

Código de status HTTP: 400

InternalServerException

Ocorreu um erro interno ao processar a solicitação.

Código de status HTTP: 400

InvalidEndpointException

O endpoint solicitado é inválido.

Código de status HTTP: 400

ThrottlingException

A solicitação foi restringida devido a solicitações excessivas.

Código de status HTTP: 400

ValidationException

Solicitação inválida ou malformada.

Código de status HTTP: 400

Consulte também

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte: