詞彙表

服務具有一個以上的 API 版本，您使用的版本會指出哪些操作和參數有效。API 版本格式類似日期。例如，Amazon S3 的最新 API 版本是2006-03-01。設定用戶端物件時，請指定一個版本。

用戶端物件是用來為服務執行操作。開發套件中支援的每項服務都有對應的用戶端物件。客戶端對象具有ne-to-one與服務操作對應 o 的方法。如需如何建立與使用用戶端物件的詳細資訊，請參閱基本使用指南。

命令物件封裝了一個操作執行。遵循軟體開發套件的基本使用模式時，您將無法直接處理命令物件。命令物件可使用用戶端的 getCommand() 方法存取，以使用開發套件的進階功能，如並行請求和批次處理。有關更多詳細信息，請參閱AWS SDK for PHP版本 3 指南中的命令對象。

透過處理常式函數，使用者可以將命令與請求實際轉換為結果；且處理常式通常會傳送 HTTP 請求。為了增強自身行為，處理常式可以由中介軟體組成。處理常式是一個函數，它接受 Aws\CommandInterface 和 Psr\Http\Message\RequestInterface 並回傳一個以 Aws\ResultInterface 履行或以 Aws\Exception\AwsException 理由拒絕的 promise。

JMESPath 是一種 JSON 類似資料的查詢語言。AWS 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 中的單一作業 (例如，CreateTable針對 DynamoDB，適RunInstances用於 Amazon EC2)。在軟體開發套件中，透過呼叫對應服務用戶端物件上的相同名稱方法來執行操作。執行操作牽涉準備和傳送 HTTP 請求到服務並剖析回應。這個執行操作的過程是由軟體開發套件透過命令物件以抽象化。

部分AWS服務作業會分頁，並以截斷的結果回應。例如，Amazon S3 的ListObjects操作一次最多只能傳回 1000 個物件。諸如此類的操作需要透過字符 (或標記) 參數進行後續請求，以擷取整組結果。分頁程式是軟體開發套件的一項功能，可做為此程序的抽象表示，讓開發人員更輕鬆地使用分頁 API。它們透過用戶端的 getPaginator() 方法存取。如需詳細資訊，請參閱第 3 AWS SDK for PHP 版指南中的分頁器。

Promise 代表非同步操作的最終結果。與 promise 互動的主要方式是透過其 then 方法，該方法會註冊回呼以接收 promise 的最終值或 promise 無法履行的理由。

服務在一個以上的地理區域受支援。服務在每個區域可能有不同的端點/URL，這些端點/URL 的存在可以減少應用程式中的資料延遲。設定用戶端物件時，請提供一個區域，以便軟體開發套件可以決定將哪個端點用於該服務。

「軟體開發套件」一詞可能是指整套AWS SDK for PHP程式庫，或者是指 Aws\Sdk 類別 (文件)，其會做為各項服務用戶端物件的工廠。Sdk 類別也可讓您提供一組全域組態值，套用到其建立的所有用戶端物件。

參照任何AWS服務的一般方式 (例如，Amazon S3、亞馬遜 DynamoDB AWS OpsWorks 等)。各項服務在開發套件中都有對應的用戶端物件，可支援一個以上的 API 版本。各服務亦由一項或多項操作構成其 API。服務在一個以上的區域受支援。

執行操作時，此軟體開發套件會使用您的登入資料建立您的請求數位簽章。此服務會在處理您的請求之前驗證簽章。簽章程序是由軟體開發套件封裝，並在使用您為用戶端設定的登入資料時自動發生。

等待程式是開發套件的一項功能，可以更輕鬆地處理變更資源狀態並最終一致或非同步的操作。例如，Amazon DynamoDB CreateTable 作業會立即傳回回應，但資料表可能在幾秒鐘內未準備好存取。執行等待程式允許您透過睡眠和輪詢資源狀態來等待資源進入特定狀態。等待程式使用用戶端的 waitUntil() 方法存取。有關更多詳細信息，請參閱第 3 AWS SDK for PHP 版指南中的服務員。