Glosario

Los servicios tienen una o varias versiones de la API, y la versión que se usa determina qué operaciones y parámetros son válidos. La versión de la API se indican con el formato de una fecha. Por ejemplo, la última versión de la API para Amazon S3 es 2006-03-01. Especifique una versión al configurar un objeto de cliente.

Los objetos cliente se usan para ejecutar operaciones para un servicio. Cada servicio contemplado en el SDK tiene un objeto de cliente correspondiente. Los objetos cliente tienen métodos que se corresponden directamente con las operaciones del servicio. Consulte la guía de uso básico para obtener más información acerca de cómo crear y utilizar objetos de cliente.

Los objetos comando encapsulan la ejecución de una operación. Si sigue los patrones de uso básicos del SDK, no tratará directamente con objetos comando. Para el acceso a los objetos comando pude usarse el método getCommand() de un cliente y así poder usar características avanzadas del SDK, como solicitudes simultáneas y procesamiento por lotes. Para obtener información detallada, consulte Objetos comando en la versión 3 de AWS SDK for PHP.

Un controlador es una función que realiza la transformación real de un comando y una solicitud en un resultado. Un controlador suele enviar solicitudes HTTP. Los controladores pueden incluir middleware para aumentar su comportamiento. Un controlador es una función que acepta una Aws\CommandInterface y una Psr\Http\Message\RequestInterface y devuelve una promesa que se cumple con una Aws\ResultInterface o se rechaza con un motivo Aws\Exception\AwsException.

JMESPath es un lenguaje de consultas para datos de tipo JSON. AWS SDK for PHP utiliza expresiones JMESPath para consultar estructuras de datos PHP. Las expresiones JMESPath se pueden utilizar directamente en los objetos Aws\Result y Aws\ResultPaginator a través del método search($expression).

El middleware es un tipo especial de función de alto nivel que aumenta el comportamiento de la transferencia de un comando y lo delega al "siguiente" controlador. Las funciones de middleware aceptan una Aws\CommandInterface y una Psr\Http\Message\RequestInterface y devuelven una promesa que se cumple con una Aws\ResultInterface o se rechaza con un motivo Aws\Exception\AwsException.

Se refiere a una sola operación dentro de la API de un servicio (por ejemplo, CreateTable para DynamoDB, RunInstances para Amazon EC2). En el SDK, las operaciones se ejecutan llamando al método con el mismo nombre del objeto cliente del servicio correspondiente. La ejecución de una operación implica la preparación y el envío de una solicitud HTTP al servicio y el análisis de la respuesta. El SDK abstrae este proceso de ejecutar una operación mediante objetos comando.

Algunas operaciones de servicios de AWS están paginadas y responden con resultados truncados. Por ejemplo, la operación de Amazon S3 ListObjects solo devuelve un máximo de 1000 objetos a la vez. Las operaciones como esta requieren realizar las solicitudes posteriores con parámetros de token (o marcador) para recuperar todo el conjunto de los resultados. Los paginadores son una característica del SDK que actúan como una abstracción sobre este proceso para facilitar a los desarrolladores utilizar API paginadas. El acceso a ellos se consigue con el método getPaginator() del cliente. Para obtener información más detallada, consulte la guía Paginadores en la versión 3 de AWS SDK for PHP.

Una promesa representa el resultado final de una operación asíncrona. La forma principal de interactuar con una promesa es a través de su método "then", que registra devoluciones de llamada para recibir el valor final de la promesa o la razón por la que no puede cumplirse.

Los servicios están disponibles en una o varias regiones geográficas. Los servicios pueden tener diferentes puntos de enlace o URL en cada región a fin de reducir la latencia de datos de las aplicaciones. Proporcione una región al configurar un objeto de cliente para que el SDK pueda determinar el punto de enlace que se debe utilizar con el servicio.

El término "SDK" puede referirse a la biblioteca AWS SDK for PHP en su conjunto, pero también a la clase Aws\Sdk (docs), que actúa como una fábrica para los objetos cliente de cada servicio. La clase Sdk también permite indicar un conjunto de valores de configuración globales que se aplican a todos los objetos cliente que crea.

Término general para referirse a cualquiera de los servicios de AWS (por ejemplo, Amazon S3, Amazon DynamoDB AWS OpsWorks, etc.). Cada servicio tiene un objeto de cliente correspondiente en el SDK que es compatible con una o varias versiones de la API. Cada servicio también tiene una o varias operaciones que componen su API. Los servicios están disponibles en una o más regiones.

Cuando ejecutan operaciones, el SDK utiliza sus credenciales para crear una firma digital de la solicitud. El servicio verifica entonces la firma antes de procesar su solicitud. El SDK encapsula este proceso de firma, que se sigue de forma automática usando las credenciales que ha configurado para el cliente.

Los esperadores son una característica del SDK que facilitan el trabajo con las operaciones que cambian el estado de un recurso y que presentan consistencia final o son de naturaleza asíncrona. Por ejemplo, la operación de Amazon DynamoDBCreateTable envía una respuesta inmediata, pero es posible que la tabla no esté lista para acceder a ella hasta hasata pasados varios segundos. El uso de un esperador permite esperar hasta que un recurso alcance un estado determinado, manteniéndose inactivo y sondeando el estado del recurso. El acceso a los esperadores se hace con el método waitUntil() del cliente. Para obtener información detallada, consulte Esperadores en la versión 3 de AWS SDK for PHP.