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à.
API EFS
L'API Amazon EFS è un protocollo di rete basato su HTTP (RFC 2616)
L'API Amazon EFS è 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.
L'operazione specifica di Amazon EFS a cui è associata una determinata richiesta è determinata da una combinazione del metodo della richiesta (GET, PUT, POST o DELETE) e a quale dei vari modelli corrisponde il suo URI di richiesta. Se l'operazione è PUT o POST, Amazon EFS estrae gli argomenti delle chiamate dal segmento del percorso URI della richiesta, dai parametri della query e dall'oggetto JSON nel corpo della richiesta.
Nota
Anche se il nome dell'operazione, come ad esempio CreateFileSystem, non viene visualizzato nello scambio in rete, i nomi di queste operazioni sono significativi per le policy 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 della riga di comando e negli elementi delle APIAWS SDK. Ad esempio, è disponibile un comando AWS CLI denominato create-file-system mappato all'operazione CreateFileSystem.
Il nome dell'operazione viene visualizzato anche neiAWS CloudTrail registri delle chiamate API 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 specificiRegioni AWS e assumono la forma seguente.
elasticfilesystem.aws-region.amazonaws.com
Ad esempio, l'endS S S S s s s s s s s s S S S S S S S S S S S S S S S S S S S S S S S S S S S S
elasticfilesystem.us-west-2.amazonaws.com
Per un elenco diRegione AWS quelli supportati da Amazon EFS (dove puoi creare e gestire file system), consulta Amazon Elastic File System nel Riferimenti generali di AWS.
L'endpoint API specifico per regione definisce l'ambito delle risorse Amazon EFS accessibili quando si effettua una chiamata API. Ad esempio, quando chiami l'DescribeFileSystemsoperazione utilizzando l'endpoint precedente, ottieni un elenco di file system nella regione degli Stati Uniti occidentali (Oregon) che sono stati creati nel tuo 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.
Utilizzo della frequenza di richiesta dell'API di interrogazione per Amazon EFS
Le richieste API di Amazon EFS sono limitate per ciascunaAccount AWS area geografica per migliorare le prestazioni del servizio. Tutte le chiamate API Amazon EFS insieme, indipendentemente dal fatto che provengano da un'applicazioneAWS CLI, dalla console Amazon EFS o dalla console Amazon EFS, non devono superare la velocità massima consentita di richieste API. La velocità massima di richiesta API può variare daRegioni AWS. Le richieste API effettuate sono attribuite al sottostanteAccount 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.
Riprovi o elaborazione in batch
L'applicazione potrebbe dover riprovare una richiesta API in caso di esito negativo o elaborare più risorse (ad esempio, tutti i 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 di un intervallo di sonno
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, vedere Error Retries and Exponential BackoffAWS inRiferimenti generali di Amazon Web Services.
