Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateTable
Aggiunge una nuova tabella a un database esistente nel tuo account. In un Account AWS, i nomi delle tabelle devono essere almeno univoci all'interno di ogni regione se si trovano nello stesso database. Potresti avere nomi di tabella identici nella stessa regione se le tabelle si trovano in database separati. Durante la creazione della tabella, è necessario specificare il nome della tabella, il nome del database e le proprietà di conservazione. Si applicano le quote di servizio. Consulta l'esempio di codice per i dettagli.
Sintassi della richiesta
{
"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"
}
]
}Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati nel JSON formato.
- DatabaseName
-
Nome del database Timestream.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: sì
- MagneticStoreWriteProperties
-
Contiene le proprietà da impostare nella tabella quando si abilitano le scritture dello store magnetico.
Tipo: oggetto MagneticStoreWriteProperties
Campo obbligatorio: no
- RetentionProperties
-
La durata per la quale i dati delle serie temporali devono essere archiviati nell'archivio di memoria e nell'archivio magnetico.
Tipo: oggetto RetentionProperties
Campo obbligatorio: no
- Schema
-
Lo schema della tabella.
Tipo: oggetto Schema
Campo obbligatorio: no
- TableName
-
Nome della tabella Timestream.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: sì
- Tags
-
Un elenco di coppie chiave-valore per etichettare la tabella.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Campo obbligatorio: no
Sintassi della risposta
{
"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"
}
}Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- AccessDeniedException
-
Non sei autorizzato a eseguire questa azione.
HTTPCodice di stato: 400
- ConflictException
-
Timestream non è stato in grado di elaborare questa richiesta perché contiene una risorsa già esistente.
HTTPCodice di stato: 400
- InternalServerException
-
Timestream non è stato in grado di elaborare completamente questa richiesta a causa di un errore interno del server.
HTTPCodice di stato: 500
- InvalidEndpointException
-
L'endpoint richiesto non era valido.
HTTPCodice di stato: 400
- InvalidEndpointException
-
L'endpoint richiesto non era valido.
HTTPCodice di stato: 400
- ResourceNotFoundException
-
L'operazione ha tentato di accedere a una risorsa inesistente. La risorsa potrebbe non essere specificata correttamente o il relativo stato potrebbe non esserlo. ACTIVE
HTTPCodice di stato: 400
- ServiceQuotaExceededException
-
La quota di risorse dell'istanza è stata superata per questo account.
HTTPCodice di stato: 400
- ThrottlingException
-
Troppe richieste sono state fatte da un utente e hanno superato le quote di servizio. La richiesta è stata sottoposta a throttling.
HTTPCodice di stato: 400
- ValidationException
-
Una richiesta non valida o non valida.
HTTPCodice di stato: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
