As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Glossário **Versão da API** Os serviços têm uma ou mais versões de API, e a versão que você está usando determina quais operações e parâmetros são válidos. As versões da API são formatadas como uma data. Por exemplo, a versão mais recente da API do Amazon S3 é `2006-03-01`. [Especifique uma versão](guide_configuration.md#cfg-version) ao configurar um objeto do cliente. **Cliente** Os objetos de clientes são usados para executar operações para um serviço. Cada serviço compatível com o SDK tem um objeto de cliente correspondente. Os objetos de clientes têm métodos que correspondem um para um com as operações do serviço. Consulte o tópico [Criar um cliente de serviço básico](making-service-requests.md#creating-a-client) para começar a usar clientes. **Command** Os objetos de comandos encapsulam a execução de uma operação. Ao executar uma operação de serviço conforme descrito na seção [fazer solicitação](making-service-requests.md#executing-service-operations), você não lidará diretamente com objetos de comando. Os objetos de comando podem ser acessados usando o método `getCommand()` de um cliente para usar recursos avançados do SDK, como solicitações simultâneas e processamento em lotes. Consulte o guia [Objetos de comando no AWS SDK para PHP Versão 3](guide_commands.md) para obter mais detalhes. **Manipulador** Um manipulador é uma função que executa a transformação real de um comando e de uma solicitação em um resultado. Um manipulador normalmente envia solicitações HTTP. Os manipuladores podem ser compostos com middleware para aumentar seu comportamento. Um manipulador é uma função que aceita uma `Aws\CommandInterface` e uma `Psr\Http\Message\RequestInterface` e retorna uma promessa que é cumprida com uma `Aws\ResultInterface` ou rejeitada com uma razão de `Aws\Exception\AwsException`. **JMESPath** [JMESPath](http://jmespath.org/) é uma linguagem de consulta de dados do tipo JSON. O AWS SDK para PHP usa expressões do JMESPath para consultar estruturas de dados do PHP. As expressões de JMESPath podem ser usadas diretamente nos objetos `Aws\Result` e `Aws\ResultPaginator` por meio do método `search($expression)`. **Middleware** Middleware é um tipo especial de função de alto nível que aumenta o comportamento de transferência de um comando e delegação para um manipulador "próximo". As funções de middleware aceitam uma `Aws\CommandInterface` e uma `Psr\Http\Message\RequestInterface` e retornam uma promessa que é cumprida com uma `Aws\ResultInterface` ou rejeitada com um motivo de `Aws\Exception\AwsException`. **Operação** Refere-se a uma única operação em uma API do serviço (por exemplo, `CreateTable` para o DynamoDB, `RunInstances` para o Amazon EC2). No SDK, as operações são executadas chamando um método com o mesmo nome no objeto do cliente do serviço correspondente. A execução de uma operação envolve a preparação e o envio de uma solicitação HTTP ao serviço e a análise da resposta. Esse processo de execução de uma operação é abstraído pelo SDK por meio de objetos de **comando**. **Paginador** Algumas operações de serviços da AWS são paginadas e respondem com resultados truncados. Por exemplo, a operação do `ListObjects` do Amazon S3 retorna só até 1000 objetos por vez. Operações como estas exigem fazer solicitações subsequentes com parâmetros de token (ou marcador) para recuperar todo o conjunto de resultados. Paginadores são um recurso do SDK que atuam como uma abstração sobre esse processo para facilitar o uso de APIs paginadas aos desenvolvedores. Eles são acessados por meio do método `getPaginator()` do cliente. Consulte o guia [Paginadores no AWS SDK para PHP Versão 3](guide_paginators.md) para obter mais detalhes. **Promessa** Uma promessa representa o resultado eventual de uma operação assíncrona. A principal maneira de interagir com uma promessa é por meio de seu método, que registra retornos de chamada para receber o valor eventual de uma promessa ou o motivo pelo qual a promessa não pode ser cumprida. **Região** Os serviços são suportados em [uma ou mais regiões geográficas](https://docs.aws.amazon.com/general/latest/gr/rande.html). Os serviços podem ter diferentes endpoints/URLs em cada região, que existem para reduzir a latência de dados nos aplicativos. [Forneça uma região](guide_configuration.md#cfg-region) ao configurar um objeto do cliente para que o SDK possa determinar qual endpoint usar com o serviço. **SDK** O termo "SDK" pode se referir à biblioteca do AWS SDK para PHP como um todo, mas também se refere à classe `Aws\Sdk` [(documentação)](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.Sdk.html), que atua como uma fábrica para os objetos de cliente para cada **serviço**. A classe `Sdk` também permite que você forneça um conjunto de [valores globais da configuração](guide_configuration.md) que são aplicados a todos os objetos de cliente que ela cria. **Serviço** A forma geral de fazer referência a qualquer um dos serviços da AWS (por exemplo, Amazon S3, Amazon DynamoDB, AWS OpsWorks etc.). Cada serviço tem um objeto de **cliente** correspondente no SDK que oferece suporte a uma ou mais **versões da API**. Cada serviço também tem uma ou mais **operações** que compõem sua API. Os serviços são suportados em uma ou mais **regiões**. **Assinatura** Ao executar operações, o SDK usa suas credenciais para criar uma assinatura digital de sua solicitação. Em seguida, o serviço verifica a assinatura antes de processar a solicitação. O processo de assinatura é encapsulado pelo SDK e ocorre automaticamente usando as credenciais que você configura para o cliente. **Waiter** Os waiters são um recurso do SDK que facilitam o trabalho com operações que alteram o estado de um recurso e que são *eventualmente consistentes* ou *assíncronos* por natureza. Por exemplo, a operação `CreateTable` do Amazon DynamoDB retorna uma resposta imediatamente, mas a tabela pode não estar pronta para acesso por vários segundos. A execução de um waiter permite que você aguarde até que um recurso entre em um estado específico suspendendo e sondando o status do recurso. Os waiters são acessados por meio do método `waitUntil()` do cliente. Consulte o guia [Waiters no AWS SDK para PHP Versão 3](guide_waiters.md) para obter mais detalhes. Para ter acesso à terminologia mais recente da AWS, consulte o [Glossário da AWS](https://docs.aws.amazon.com/general/latest/gr/glos-chap.html) na Referência geral da AWS.