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 es2006-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. Consulte laObjetos comando deAWS SDK for PHPversión 3guía para obtener más información.

Para interactuar conAWSservicios, autenticarse en el servicio con sus credenciales oAWSclaves de acceso. Las claves de acceso constan de dos partes: su ID de clave de acceso, que identifica su cuenta, y su clave de acceso secreta, que se utiliza para crear firmas cuando se ejecutan operaciones. Proporcione las credenciales cuando configure un objeto de cliente.

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,CreateTablepara DynamoDB,RunInstancespara 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.

AlgunoAWSLas operaciones de servicio se paginan y responden con resultados truncados. Por ejemplo, las de Amazon S3ListObjectsoperación de devuelve un máximo de 1000 objetos cada 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. Consulte laPaginadores en elAWS SDK for PHPversión 3guía para obtener más información.

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.

Forma general de referirse a cualquiera de lasAWSservicios (por ejemplo, Amazon S3, Amazon DynamoDB,AWSOpsWorks, 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, Amazon DynamoDBCreateTableenvía una respuesta inmediata, pero la tabla puede no estar lista para el acceso hasta que transcurren 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. Consulte laEsperadores enAWS SDK for PHPversión 3guía para obtener más información.