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 Amazon EFS

L'API EFS Amazon è un protocollo di rete basato su HTTP (RFC 2616). Per ogni chiamata API, effettui una richiesta HTTP all'endpoint API Amazon EFS specifico della regione Regione AWS in cui desideri gestire i file system. L'API fa riferimento ai documenti JSON (RFC 4627) per la definizione dei contenuti delle richieste/risposte HTTP.

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.

Endpoint API

Un endpoint è un URL che funge da punto di ingresso per un servizio AWS Web. Amazon EFS supporta i seguenti tipi di endpoint:

Quando si effettua una richiesta, è possibile specificare l'endpoint da utilizzare. Se non si specifica un endpoint, l' IPv4 endpoint viene utilizzato per impostazione predefinita. Per utilizzare un tipo di endpoint diverso, devi specificarlo nella richiesta. Per esempi su come eseguire questa operazione, consulta Specificazione degli endpoint. Per una tabella degli endpoint disponibili, consulta Endpoint e quote Amazon EFS.

IPv4 endpoint

IPv4 gli endpoint supportano solo il IPv4 traffico. IPv4 gli endpoint sono disponibili per tutte le regioni. Il formato dell' IPv4 endpoint dipende dalla regione.

Endpoint dual-stack (e) IPv4 IPv6

Gli endpoint dual-stack supportano sia il traffico che il traffico. IPv4 IPv6 Quando effettui una richiesta a un endpoint dual-stack, l'URL dell'endpoint si risolve in un indirizzo IPv6 o in un IPv4 indirizzo, a seconda del protocollo utilizzato dalla rete e dal client. Il formato dell'endpoint dual-stack dipende dalla regione.

Specificazione degli endpoint

Gli esempi seguenti mostrano come specificare un endpoint per la regione Stati Uniti occidentali (California settentrionale) (us-west-1) utilizzando per Amazon EFS. AWS CLI

IPv4

aws efs get-rest-apis --region us-west-1 --endpoint-url https://elasticfilesystem.us-west-1.amazonaws.com

Dual-stack

aws efs get-rest-apis --region us-west-1 --endpoint-url https://efs.us-west-1.api.aws

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 Retry behavior in.Riferimenti generali di Amazon Web Services