UpdateTable

Important

This section refers to API version 2011-12-05, which is deprecated and should not be used for new applications.

Pour obtenir de la documentation sur le bas niveau actuelAPI, consultez le manuel Amazon DynamoDB Reference API.

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, veuillez consulter 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.

La table doit être en bon ACTIVE état pour que cette opération réussisse. 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 : 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. 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 : String
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 : 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 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"}
}

Actions connexes

• CreateTable

• DescribeTables

• DeleteTable