Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# UpdateTable
**Important**
***Cette section fait référence à l'API version 2011-12-05 qui est obsolète et ne doit pas être utilisée pour de nouvelles applications.***
**Pour une documentation sur l'API de bas niveau actuelle, consultez la [Référence d'API Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).**
## Description
Met à jour le débit approvisionné pour la table donnée. La définition du débit pour une table vous aide à gérer les performances et fait partie de la fonction de débit approvisionné de DynamoDB. Pour de plus amples informations, consultez [Mode de capacité provisionnée DynamoDB](provisioned-capacity-mode.md).
Les valeurs de débit approvisionné peuvent faire l'objet d'une mise à niveau en fonction des maxima et minima répertoriés dans [Quotas dans Amazon DynamoDB](ServiceQuotas.md).
Pour que cette opération réussisse, la table doit être dans l'état `ACTIVE`. L'opération UpdateTable est asynchrone. Lors de son exécution, la table est dans l'état `UPDATING`. Quand la table est dans l'état `UPDATING`, elle a encore le débit approvisionné d'avant l'appel. Le nouveau paramètre de débit approvisionné ne prend effet que quand la table revient à l'état `ACTIVE` après l'opération UpdateTable.
## Requêtes
### Syntaxe
```
// This header is abbreviated.
// For a sample of a complete header, see API de bas niveau de DynamoDB.
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}
}
```
****
| Name (Nom) | Description | Obligatoire |
| --- | --- | --- |
| TableName | Nom de la table à mettre à jour. Type : String | Oui |
| ProvisionedThroughput | Nouveau débit pour la table spécifiée, composé de valeurs pour `ReadCapacityUnits` et `WriteCapacityUnits`. Consultez [Mode de capacité provisionnée DynamoDB](provisioned-capacity-mode.md).Type : Array | Oui |
| ProvisionedThroughput :ReadCapacityUnits | Définit le nombre minimum de `ReadCapacityUnits` cohérentes consommées par seconde pour la table spécifiée avant que DynamoDB équilibre la charge avec d'autres opérations. Des opérations de lecture éventuellement cohérente nécessitant moins d'effort qu'une opération de lecture cohérente, un paramètre de 50 `ReadCapacityUnits` par seconde fournit 100 `ReadCapacityUnits` éventuellement cohérentes par seconde. Type : nombre | Oui |
| ProvisionedThroughput :WriteCapacityUnits | Définit le nombre minimum de `WriteCapacityUnits` consommées par seconde pour la table spécifiée avant que DynamoDB équilibre la charge avec d'autres opérations. Type : nombre | Oui |
## Réponses
### Syntaxe
```
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"}}
```
****
| Name (Nom) | Description |
| --- | --- |
| CreationDateTime | Date de création de la table.Type : nombre |
| KeySchema | Structure (simple ou composite) de la clé primaire pour la table. Une paire nom-valeur pour l'élément `HashKeyElement` est obligatoire, et une paire nom-valeur pour l'élément `RangeKeyElement` est facultatif (obligatoire uniquement pour les clés primaires composites). La taille maximum de clé de hachage est de 2 048 octets. La taille maximum de clé de plage est de 1 024 octets. Les deux limites sont appliquées séparément (c'est-à-dire que vous pouvez avoir une taille de clé combinée de hachage et de plage égale à 2 048 \$1 1 024 octets). Pour plus d'informations sur les clés primaires, consultez [Clé primaire](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Type : mappage de `HashKeyElement`, ou de `HashKeyElement` et `RangeKeyElement` pour une clé primaire composite. |
| ProvisionedThroughput | Paramètres de débit actuels pour la table spécifiée, incluant des valeurs pour `LastIncreaseDateTime` (le cas échéant), `LastDecreaseDateTime` (le cas échéant), Type : Array |
| TableName | Nom de la table mise à jour. Type : String |
| TableStatus | État actuel de la table (CREATING, ACTIVE, DELETING ou UPDATING), qui devrait être UPDATING. Utilisez l'opération [DescribeTables](API_DescribeTables_v20111205.md) pour vérifier l'état de la table. Type : String |
## Erreurs spéciales
****
| Erreur | Description |
| --- | --- |
| ResourceNotFoundException | La table spécifiée n'a pas été trouvée. |
| ResourceInUseException | La table n'est pas dans l'état ACTIVE. |
## Exemples
### Exemple de demande
```
// This header is abbreviated.
// For a sample of a complete header, see API de bas niveau de DynamoDB.
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}
}
```
### Exemple de réponse
```
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"}
}
```
## Actions connexes
+ [CreateTable](API_CreateTable_v20111205.md)
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)