Glossary - Amazon适用于 PHP 的开发工具包
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Glossary

API 版本

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

客户端

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

命令

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

凭证

要与交互,请参阅Amazon服务、使用凭证向服务进行身份验证或Amazon访问密钥。访问密钥包含两个部分:访问密钥 ID(识别您的账户)和秘密访问密钥(用于在执行操作时创建签名)。配置客户端对象时,提供凭证

Handler

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

JMESPath

JMESPath 是一种针对类 JSON 数据的查询语言。这些区域有:Amazon适用 SDK for PHP 使用 JMESPath 表达式查询 PHP 数据结构。JMESPath 表达式可直接通过 Aws\Result 方法用于 Aws\ResultPaginatorsearch($expression) 对象。

中间件

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

操作

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

Paginator

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

Promise

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

区域

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

开发工具包

术语 “SDK” 可以指Amazon适 SDK for PHP 库的软件开发工具包作为一个整体,但也引用Aws\Sdkclass(文档),它充当每个服务。您还可以通过 Sdk 类提供一组应用于其所创建的所有客户端对象的全局配置值

服务

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

签名

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

Waiter

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

有关最新的Amazon术语,请参阅Amazon术语表中的Amazon一般参考。