术语表

服务拥有一个或多个 API 版本，您所用的版本指示哪些操作和参数有效。API 版本采用类似于日期的格式。例如，Amazon S3 的最新 API 版本为 2006-03-01。配置客户端对象时，指定版本。

客户端对象用于执行服务的操作。开发工具包中支持的每项服务都有一个对应的客户端对象。客户端对象具有与服务操作一一对应的方法。有关如何创建和使用客户端对象的详细信息，请参阅基本用法指南。

命令对象封装操作的执行。遵循开发工具包的基本使用模式时，您将不会直接处理命令对象。可以使用客户端的 getCommand() 方法访问命令对象，以便使用开发工具包的高级功能，如并发请求和批处理。有关更多详细信息，请参阅 Amazon SDK for PHP 版本 3 中的命令对象指南。

处理程序是一个将命令和请求实际转换为结果的函数。处理程序通常发送 HTTP 请求。处理程序可由中间件组成，以增强行为。处理程序是一个函数，它接受 Aws\CommandInterface 和 Psr\Http\Message\RequestInterface，并返回用 Aws\ResultInterface 执行或因 Aws\Exception\AwsException 原因而被拒绝的 Promise。

JMESPath 是一种针对类 JSON 数据的查询语言。Amazon SDK for PHP 使用 JMESPath 表达式查询 PHP 数据结构。JMESPath 表达式可直接通过 Aws\Result 方法用于 Aws\ResultPaginator 和 search($expression) 对象。

中间件是一类特殊的高级函数，可对传输命令的行为进行增强，并委托给“下一个”处理程序。中间件函数接受 Aws\CommandInterface 和 Psr\Http\Message\RequestInterface，并返回用 Aws\ResultInterface 执行或因 Aws\Exception\AwsException 原因而被拒绝的 Promise。

指的是服务 API 范围内的单个操作（如适用于 DynamoDB 的 CreateTable、适用于 Amazon EC2 的 RunInstances)。在开发工具包中，通过对相应服务的客户端对象调用相同名称的方法来执行操作。执行操作涉及准备 HTTP 请求并发送至服务以及解析响应。这种执行操作的过程由开发工具包通过命令对象提取。

某些 Amazon 服务操作会分页，并以截断的结果进行响应。例如，Amazon S3 的 ListObjects 操作一次最多只能返回 1000 个对象。此类操作要求使用令牌（或标记）参数发出后续请求，以检索整个结果集。Paginator 是开发工具包的一种功能，充当此流程的抽象层，使开发人员能够更轻松地使用分页的 API。可通过客户端的 getPaginator() 方法访问它们。有关更多详细信息，请参阅 Amazon SDK for PHP 版本 3 中的 Paginator 指南。

Promise 表示异步操作的最终结果。与 Promise 交互的主要方式是通过其 then 方法，该方式注册回调以接收 Promise 的最终值或无法执行该 Promise 的原因。

一个或多个地理区域支持这些服务。每个区域的服务可能拥有不同的端点/URL，用于减少应用程序中的数据延迟。配置客户端对象时，提供区域，以便开发工具包确定对该服务使用的端点。

“开发工具包”一词既可指整个Amazon SDK for PHP库，也可指 Aws\Sdk 类（文档），充当每项服务的客户端对象的工厂。您还可以通过 Sdk 类提供一组应用于其所创建的所有客户端对象的全局配置值。

参阅任何 Amazon 服务（例如 Amazon S3、Amazon DynamoDB、Amazon OpsWorks 等）的一般方式。每项服务在开发工具包中都有一个对应的客户端对象支持一个或多个 API 版本。每项服务还有一个或多个操作构成其 API。一个或多个区域支持这些服务。

执行操作时，开发工具包使用您的凭证创建请求的数字签名。该服务随后将验证签名，然后再处理您的请求。签名过程由开发工具包封装，并使用您为客户端配置的凭证自动执行。

Waiter 是开发工具包的一种功能，使您能够更轻松地处理改变资源状态并且本质上具有最终一致性或异步的操作。例如，Amazon DynamoDBCreateTable 操作会立即发回响应，但要访问该表可能需要等待几秒钟。执行 Waiter 可让您一直等到资源进入特定状态（通过休眠和轮询资源的状态）。可使用客户端的 waitUntil() 方法访问 Waiter。有关更多详细信息，请参阅 Amazon SDK for PHP 版本 3 中的 Waiter 指南。