UpdateTable - Amazon DynamoDB
DescrizioneRichiesteRisposteErrori specialiEsempiOperazioni correlate

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à.

UpdateTable

Importante

In questa sezione si fa riferimento alla versione API 2011-12-05, che è obsoleta e non deve essere utilizzata per le nuove applicazioni.

Per informazioni sull'API di basso livello corrente, consulta la Amazon DynamoDB API Reference.

Descrizione

Aggiorna la velocità effettiva assegnata per la tabella specificata. L'impostazione della velocità effettiva per una tabella consente di gestire le prestazioni e fa parte della caratteristica di velocità effettiva assegnata di DynamoDB. Per ulteriori informazioni, consulta Modalità di capacità fornita da DynamoDB.

I valori della velocità effettiva assegnata possono essere aggiornati o declassati in base ai valori massimi e minimi elencati in Quote di servizio, account e tabelle in Amazon DynamoDB.

Perché questa operazione abbia esito positivo, la tabella deve trovarsi nello stato ACTIVE. UpdateTable è un'operazione asincrona; durante l'esecuzione dell'operazione, la tabella è nello stato. UPDATING Mentre la tabella si trova nello stato UPDATING, la tabella ha ancora la velocità effettiva assegnata prima della chiamata. La nuova impostazione del throughput assegnato è attiva solo quando la tabella torna allo stato dopo l'ACTIVEoperazione. UpdateTable

Richieste

Sintassi

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB di basso livello API.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.UpdateTable
content-type: application/x-amz-json-1.0

{"TableName":"Table1",
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15}
}
Nome Descrizione Richiesto
TableName

Il nome della tabella da aggiornare.

▬Tipo: stringa

Sì
ProvisionedThroughput

La nuova velocità effettiva per la tabella specificata, costituita dai valori per ReadCapacityUnits e WriteCapacityUnits. Per informazioni, consulta Modalità di capacità fornita da DynamoDB.

Tipo: Array

Sì
ProvisionedThroughput :ReadCapacityUnits

Imposta il numero minimo di ReadCapacityUnits con consistenza consumate al secondo per la tabella specificata prima che DynamoDB bilanci il carico con altre operazioni.

Le operazioni di lettura a consistenza finale richiedono meno sforzo rispetto a un'operazione di lettura consistente, quindi un'impostazione di 50 ReadCapacityUnits consistente al secondo fornisce 100 ReadCapacityUnits a consistenza finale al secondo.

Tipo: numero

Sì
ProvisionedThroughput :WriteCapacityUnits

Imposta il numero minimo di WriteCapacityUnits consumate al secondo per la tabella specificata prima che DynamoDB bilanci il carico con altre operazioni.

Tipo: numero

Sì

Risposte

Sintassi

HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
Content-Type: application/json
Content-Length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT

{"TableDescription":
    {"CreationDateTime":1.321657838135E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"AttributeValue1","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"AttributeValue2","AttributeType":"N"}},
    "ProvisionedThroughput":
        {"LastDecreaseDateTime":1.321661704489E9,
        "LastIncreaseDateTime":1.321663607695E9,
        "ReadCapacityUnits":5,
        "WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableStatus":"UPDATING"}}
Nome Descrizione
CreationDateTime

La data in cui è stata creata la tabella.

Tipo: numero
KeySchema

La struttura della chiave primaria (semplice o composita) per la tabella. Una coppia nome-valore per HashKeyElement è obbligatoria mentre una coppia nome-valore per RangeKeyElement è facoltativa (richiesta solo per le chiavi primarie composite). La dimensione massima della chiave hash è 2048 byte. La dimensione massima della chiave di intervallo è 1024 byte. Entrambi i limiti sono applicati separatamente (cioè è possibile avere una chiave hash + intervallo combinato, ovvero 2048+1024). Per ulteriori informazioni sulle chiavi primarie, vedere Chiave primaria.

Tipo: mappa di HashKeyElement, oppure HashKeyElement e RangeKeyElement per una chiave primaria composita.
ProvisionedThroughput

Impostazioni del throughput corrente per la tabella specificata, inclusi i valori per LastIncreaseDateTime (se applicabile), LastDecreaseDateTime (se applicabile),

Tipo: Array

TableName

Il nome della tabella aggiornata.

▬Tipo: stringa
TableStatus Lo stato corrente della tabella (CREATING, ACTIVE, DELETING o UPDATING), che dovrebbe essere UPDATING.

Utilizza l'operazione DescribeTables per controllare lo stato della tabella.

▬Tipo: stringa

Errori speciali

Errore Descrizione
ResourceNotFoundException La tabella specificata non è stata trovata.
ResourceInUseException La tabella non si trova nello stato ACTIVE.

Esempi

Richiesta di esempio

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB di basso livello API.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.UpdateTable
content-type: application/x-amz-json-1.0

{"TableName":"comp1",
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15}
}

Risposta di esempio

HTTP/1.1 200 OK
content-type: application/x-amz-json-1.0
content-length: 390
Date: Sat, 19 Nov 2011 00:46:47 GMT

{"TableDescription":
    {"CreationDateTime":1.321657838135E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":
        {"LastDecreaseDateTime":1.321661704489E9,
        "LastIncreaseDateTime":1.321663607695E9,
        "ReadCapacityUnits":5,
        "WriteCapacityUnits":10},
    "TableName":"comp1",
    "TableStatus":"UPDATING"}
}