As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
UpdateTable
Modifica a duração da retenção do armazenamento de memória e do armazenamento magnético da sua tabela Timestream. Observe que a alteração na duração da retenção entra em vigor imediatamente. Por exemplo, se o período de retenção do armazenamento de memória foi inicialmente definido para 2 horas e depois alterado para 24 horas, o armazenamento de memória será capaz de armazenar 24 horas de dados, mas será preenchido com 24 horas de dados 22 horas após a alteração ter sido feita. O Timestream não recupera dados do armazenamento magnético para preencher o armazenamento de memória.
Consulte a amostra de código para obter detalhes.
Sintaxe da Solicitação
{
"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"
}Parâmetros da solicitação
Para obter informações sobre os parâmetros comuns a todas as ações, consulte Parâmetros Comuns.
A solicitação aceita os seguintes dados no JSON formato.
- DatabaseName
-
O nome do banco de dados do Timestream.
Tipo: string
Restrições de tamanho: comprimento mínimo de 3. Tamanho máximo de 256.
Obrigatório: Sim
- MagneticStoreWriteProperties
-
Contém propriedades a serem definidas na tabela ao habilitar gravações de armazenamento magnético.
Tipo: objeto MagneticStoreWriteProperties
Obrigatório: Não
- RetentionProperties
-
A duração da retenção do armazenamento de memória e do armazenamento magnético.
Tipo: objeto RetentionProperties
Obrigatório: Não
- Schema
-
O esquema da tabela.
Tipo: objeto Schema
Obrigatório: Não
- TableName
-
O nome da tabela do Timestream.
Tipo: string
Restrições de tamanho: comprimento mínimo de 3. Tamanho máximo de 256.
Exigido: Sim
Sintaxe da Resposta
{
"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"
}
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- AccessDeniedException
-
Você não está autorizado a realizar essa ação.
HTTPCódigo de status: 400
- InternalServerException
-
O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.
HTTPCódigo de status: 500
- InvalidEndpointException
-
O endpoint solicitado não era válido.
HTTPCódigo de status: 400
- ResourceNotFoundException
-
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não estarACTIVE.
HTTPCódigo de status: 400
- ThrottlingException
-
Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.
HTTPCódigo de status: 400
- ValidationException
-
Uma solicitação inválida ou malformada.
HTTPCódigo de status: 400
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte:
