DynamoDB API

为了在应用程序中使用DynamoDB，Amazon DynamoDB提供了一些API，主要可以分为以下三类

控制层面

控制层面的操作用于创建和管理DynamoDB表

• CreateTable 创建新表(必须指定表名、主键和吞吐量设置)，或者创建一个或多个二级索引并为表启用DynamoDB流
• DescribeTable 返回有关表的信息，例如表的主键架构，吞吐量设置，索引信息等(必须提供表名)
• ListTables 返回列表中所有表的名称
• DescribeLimits 返回当前AWS账户和区域的当前读取和写入容量限制
• UpdateTable 修改表或其索引的设置、创建或删除表上的新索引或修改表DynamoDB流设置(必须提供表名)
• DeleteTable 从DynamoDB中删除表及其所有依赖对象(必须提供表名)

数据层面

创建数据

• PutItem 将单个项目写入到表中(必须指定主键属性)
• BatchWriteItem 将最多25个项目写入到表中

读取数据

• GetItem 从表中检索单个项目(必须指定主键属性)，可以检索整个项目的所有属性，也可以只检索项目中的部分属性。
• BatchGetItem 从一个或多个表中检索最多100个项目
• Query 检索具有特定分区键的所有项目(必须指定分区键值)，可以检索整个项目的所有属性，也可以只检索项目中的部分属性，或者也可以对排序键值应用条件，以便只检索具有相同分区键的数据子集。也可以对表使用该操作，前提是该表同时具有分区键和排序键。还可以对索引使用该操作，前提是该索引同时具有分区键和排序键。
• Scan 检索指定表或索引中的所有项目，可以检索项目的所有属性，也可以值检索部分属性。或者，可以应用筛选条件只返回感兴趣的值丢弃其他不需要的值。

更新数据

• UpdateItem 修改项目中的一个或多个属性(必须指定主键属性) 。可以添加新属性或者修改或删除现有属性，可以执行条件更新，当满足条件时才更新项目，也可以使用一个原子计数器，该计数器可以在不干扰其他写入请求的情况下递增或递减数字属性。

删除数据

• DeleteItem 从表中删除单个项目(必须指定主键属性)
• BatchWriteItem 从一个或多个表中删除最多25个项目

DynamoDB流

• ListStreams 返回所有流的列表或返回特定表的流
• DescribeStream 返回有关流的信息，例如流的 Amazon 资源名称 (ARN) 和您的应用程序可开始读取前几条流记录的位置
• GetShardIterator 返回一个分区迭代器，这是应用程序用来检索记录的数据结构
• GetRecords 使用分区迭代器检索一条或多条流记录