UpdateTable - Amazon DynamoDB
DescriptionRequêtesRéponsesErreurs spécialesExemplesActions connexes

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.

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 plus d’informations, consultez Mode de capacité provisionnée DynamoDB.

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 de service, de compte et de table dans Amazon DynamoDB.

Pour que cette opération réussisse, la table doit être dans l'état ACTIVE. UpdateTable est une opération asynchrone ; lors de l'exécution de l'opération, la table est dans l'UPDATINGétat. 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 provisionné n'entre en vigueur que lorsque la table revient à son ACTIVE état après l'UpdateTable opération.

Requêtes

Syntaxe

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB de bas niveau 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}
}
Name (Nom) Description Obligatoire
TableName

Nom de la table à mettre à jour.

Type : chaîne

Oui
ProvisionedThroughput

Nouveau débit pour la table spécifiée, composé de valeurs pour ReadCapacityUnits et WriteCapacityUnits. veuillez consulter Mode de capacité provisionnée DynamoDB.

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 024 octets). Pour plus d'informations sur les clés primaires, consultez Clé primaire.

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 : chaîne
TableStatus État actuel de la table (CREATING, ACTIVE, DELETING ou UPDATING), qui devrait être UPDATING.

Utilisez l'opération DescribeTables pour vérifier l'état de la table.

Type : chaîne

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 DynamoDB de bas niveau 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}
}

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"}
}