Glossario

I servizi includono una o più versioni dell'API e la versione in uso determina quali operazioni e parametri sono validi. Le versioni dell'API presentano la formattazione di una data. Ad esempio, l'ultima versione dell'API per Amazon S3 è2006-03-01. Specificare una versione quando si configura un oggetto client.

Gli oggetti client vengono utilizzati per eseguire operazioni per un servizio. Ogni servizio che è supportato in SDK ha un oggetto client corrispondente. Gli oggetti client dispongono di metodi che corrispondono ne-to-one alle operazioni del servizio. Consulta la guida all'utilizzo di base per i dettagli su come creare e utilizzare gli oggetti client.

Gli oggetti di comando incapsulano l'esecuzione di un'operazione. Quando si seguono i modelli di utilizzo di base di SDK, non si gestiranno direttamente gli oggetti di comando. È possibile accedere agli oggetti di comando utilizzando il metodo getCommand() di un client, in modo da utilizzare caratteristiche avanzate di SDK, ad esempio le richieste simultanee e il batching. Per maggiori dettagli, consulta gli oggetti di comando nella guida della AWS SDK for PHP versione 3.

Un gestore è una funzione che esegue l'effettiva trasformazione di un comando e richiesta in un risultato. Un gestore in genere invia richieste HTTP. I gestori possono essere composti con middleware per potenziare il comportamento. Un gestore è una funzione che accetta un Aws\CommandInterface e un Psr\Http\Message\RequestInterface e restituisce una promessa che viene soddisfatta con un Aws\ResultInterface o respinta con un motivo Aws\Exception\AwsException.

JMESPath è un linguaggio di query per i dati tipo JSON. AWS SDK for PHP utilizza espressioni JMESPath per eseguire query sulle strutture dei dati di PHP. Le espressioni JMESPath possono essere utilizzate direttamente su oggetti Aws\Result e Aws\ResultPaginator mediante il metodo search($expression).

Il middleware è uno speciale tipo di funzioni di alto livello che migliorano il comportamento di trasferimento di un comando e di delega a un gestore "successivo". Le funzioni middleware accettano Aws\CommandInterface e Psr\Http\Message\RequestInterface e restituiscono una promessa che viene soddisfatta con Aws\ResultInterface o respinta con un motivo Aws\Exception\AwsException.

Si riferisce a una singola operazione all'interno dell'API di un servizio (ad esempio, CreateTable per DynamoDB, RunInstances per Amazon EC2). In SDK, le operazioni vengono eseguite chiamando il metodo con lo stesso nome sull'oggetto client del servizio corrispondente. L'esecuzione di un'operazione prevede la preparazione e l'invio di una richiesta HTTP al servizio e l'analisi della risposta. Questo processo di esecuzione di un'operazione viene estrapolato da SDK tramite oggetti di comando.

Alcune operazioni AWS di servizio sono impaginate e rispondono con risultati troncati. Ad esempio, il ListObjects funzionamento di Amazon S3 restituisce solo fino a 1000 oggetti alla volta. Operazioni come queste richiedono di effettuare le richieste successive con parametri di token (o contrassegni) per recuperare l'intero set di risultati. Gli impaginatori sono una funzionalità del kit SDK che fungono da astrazione su questo processo per rendere più facile per gli sviluppatori usare le API impaginate. Sono accessibili mediante il metodo getPaginator() del client. Consulta gli impaginatori nella guida della AWS SDK for PHP versione 3 per maggiori dettagli.

Una promessa rappresenta l'eventuale risultato di un'operazione asincrona. La modalità principale di interazione con una promessa è attraverso il metodo "then", che registra callback per ricevere il valore eventuale di una promessa o il motivo per cui la promessa non può essere soddisfatta.

I servizi sono supportati in una o più regioni geografiche. I servizi possono avere diversi endpoint/URL in ciascuna regione, che hanno lo scopo di ridurre la latenza dei dati nelle applicazioni. Fornire una regione quando si configura un oggetto client, in modo che SDK possa determinare quale endpoint utilizzare con il servizio.

Il termine "SDK" può riferirsi alla libreria AWS SDK for PHP nel suo complesso, ma anche alla classe Aws\Sdk (documenti), che funge da factory degli oggetti client per ciascun servizio. La classe Sdk consente inoltre di fornire un set di valori di configurazione globali che vengono applicati a tutti gli oggetti client che crea.

Un modo generico per fare riferimento a uno qualsiasi dei AWS servizi (ad esempio Amazon S3, Amazon DynamoDB e così via). AWS OpsWorks Ogni servizio presenta un oggetto client corrispondente in SDK che supporta una o più versioni dell'API. Ogni servizio include inoltre una o più operazioni che costituiscono l'API. I servizi sono supportati in una o più regioni.

Durante l'esecuzione di operazioni, SDK utilizza le tue credenziali per creare una firma digitale della tua richiesta. Quindi, il servizio verifica la firma prima di elaborare la richiesta. Il processo di firma viene incapsulato da SDK e viene eseguito automaticamente utilizzando le credenziali configurate per il client.

Uno waiter è una caratteristica di SDK che semplifica l'utilizzo di operazioni che modificano lo stato di una risorsa ed è per sua natura coerente o asincrono. Ad esempio, l'CreateTableoperazione Amazon DynamoDB invia immediatamente una risposta, ma la tabella potrebbe non essere pronta per l'accesso per diversi secondi. L'esecuzione di uno waiter consente di attendere fino a quando una risorsa non si trova in uno stato specifico mediante la sospensione e il polling dello stato della risorsa. È possibile accedere agli waiter utilizzando il metodo waitUntil() del client. Consulta la guida Waiters in the AWS SDK for PHP Version 3 per maggiori dettagli.