Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
L'API EFS Amazon è un protocollo di rete basato su HTTP (RFC 2616)
Le API Amazon EFS fanno riferimento a un modello RPC. In questo modello è presente un insieme fisso di operazioni e la sintassi per ciascuna operazione è nota ai client senza alcuna precedente interazione. Nella sezione seguente, è possibile trovare una descrizione di ciascuna operazione API realizzata tramite una notazione RPC astratta. Ad ognuna è associato un nome operazione che non appare nello scambio in rete. Per ogni operazione, l'argomento specifica la mappatura rispetto agli elementi della richiesta HTTP.
La specifica operazione Amazon EFS sulla quale viene mappata una specifica richiesta è determinata da una combinazione di metodo della richiesta (GET, PUT, POST o DELETE) e modello corrispondente all'URI della richiesta, tra i tanti disponibili. Se l'operazione è PUT o POST, Amazon EFS estrae gli argomenti di chiamata dal segmento del percorso Request-URI, dai parametri delle query e dall'oggetto JSON nel corpo della richiesta.
Nota
Sebbene i nomi delle operazioni, ad esempioCreateFileSystem, non compaiano sul web, questi nomi sono significativi nelle politiche AWS Identity and Access Management (IAM). Per ulteriori informazioni, consulta Gestione delle identità e degli accessi per Amazon EFS.
Il nome dell'operazione viene utilizzato anche per denominare i comandi negli strumenti a riga di comando e negli elementi dell'SDK. AWS APIs Ad esempio, esiste un AWS CLI comando denominato create-file-system che corrisponde all'operazione. CreateFileSystem
Il nome dell'operazione appare anche nei AWS CloudTrail log delle chiamate API di Amazon EFS.
API endpoint
L'endpoint API è il nome sul DNS usato come host nell'URI HTTP per le chiamate API. Questi endpoint API sono specifici Regioni AWS e assumono il seguente formato.
elasticfilesystem.aws-region.amazonaws.com
Ad esempio, l'endpoint per l’API Amazon EFS nella regione Stati Uniti occidentali (Oregon) è il seguente.
elasticfilesystem---us-west-2.amazonaws.com.rproxy.goskope.comPer un elenco dei file supportati da Amazon Regione AWS EFS (in cui è possibile creare e gestire file system), consulta Amazon Elastic File System nel Riferimenti generali di AWS.
L'endpoint dell'API specifico della regione definisce l'ambito delle risorse EFS che sono accessibili quando si effettua una chiamata API. Ad esempio, quando si richiama l'operazione DescribeFileSystems utilizzando l'endpoint precedente, è possibile ottenere un elenco dei file system nella regione Stati Uniti occidentali (Oregon) creati nel proprio account.
Versione API
La versione dell'API utilizzata per una chiamata è identificata dal primo segmento di percorso dell'URI della richiesta e il suo formato è una data ISO 8601. Per un esempio, consulta CreateFileSystem.
La documentazione descrive la versione API 2015-02-01.
Argomenti correlati
Le seguenti sezioni forniscono una descrizione delle operazioni delle API, di come creare una firma per l'autenticazione di una richiesta e di come concedere le autorizzazioni a tali operazioni delle API tramite le policy IAM.
Gestione della frequenza massima di richieste della Query API per Amazon EFS
Le richieste API di Amazon EFS vengono limitate per ciascuna Account AWS regione per migliorare le prestazioni del servizio. Tutte le chiamate API di Amazon EFS insieme, indipendentemente dal fatto che provengano da un'applicazione AWS CLI, dalla console o dalla console Amazon EFS, non devono superare la frequenza massima di richieste API consentita. La frequenza massima di richieste API può variare da uno all'altro Regioni AWS. Le richieste API effettuate vengono attribuite al sottostante Account AWS.
Se una richiesta API supera il numero massimo di richieste API per la sua categoria, la richiesta restituisce il codice di errore ThrottlingException. Per evitare questo errore, assicurarsi che l'applicazione non riprovi ad eseguire richieste API con un'elevata frequenza. È possibile ottenere questo risultato ponendo attenzione all'utilizzo del polling e utilizzando una strategia di backoff esponenziale nella ripetizione dei tentativi.
Polling
L'applicazione potrebbe aver bisogno di chiamare ripetutamente un'operazione tramite API per verificare la presenza di un aggiornamento nello stato. Prima di avviare il polling, lasciare alla richiesta il tempo necessario per il suo potenziale completamento. Quando si inizia il polling, utilizzare un intervallo di attesa appropriato tra le richieste successive. Per ottimizzare i risultati, utilizzare un intervallo di attesa incrementale.
Tentativi ripetuti o elaborazione batch
L'applicazione potrebbe aver bisogno di riprovare a eseguire una richiesta API dopo una prima esecuzione con esito negativo o per elaborare più risorse (ad esempio, tutti i propri file system Amazon EFS). Per ridurre la frequenza delle richieste API, utilizzare un intervallo di attesa appropriato tra le richieste successive. Per ottimizzare i risultati, utilizzare un intervallo di attesa incrementale o variabile.
Calcolo dell'intervallo di attesa
Quando è necessario eseguire il polling o rieseguire una richiesta API, è consigliato l'uso di un algoritmo di backoff esponenziale per calcolare l'intervallo di tempo di attesa tra le chiamate API. L'idea che sottende al backoff esponenziale è di utilizzare attese progressivamente più lunghe tra i tentativi per le risposte di errore consecutive. Per ulteriori informazioni ed esempi di implementazione di questo algoritmo, consulta Tentativi ripetuti in caso di errore e backoff esponenziale in AWS in Riferimenti generali di Amazon Web Services.
