Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

API Amazon EFS

L’API Amazon EFS est un protocole réseau basé sur HTTP (RFC 2616). Pour chaque appel d'API, vous envoyez une requête HTTP au point de terminaison d'API Amazon EFS spécifique à la région pour savoir Région AWS où vous souhaitez gérer les systèmes de fichiers. L’API utilise des documents JSON (RFC 4627) pour les corps de requête/réponse HTTP.

L’API Amazon EFS est un modèle RPC. Dans ce modèle, il existe un ensemble fixe d’opérations et la syntaxe de chaque opération est connue des clients sans aucune interaction préalable. Dans la section suivante, vous pouvez trouver une description de chaque opération d’API à l’aide d’une notation RPC abstraite. Chacune a un nom d’opération qui n’apparaît pas dans le transfert. Pour chaque opération, la rubrique spécifie le mapping d’éléments de requête HTTP.

L’opération Amazon EFS spécifique à laquelle est mappée une requête donnée est déterminée par une combinaison de la méthode de la demande (GET, PUT, POST ou DELETE) et de la correspondance de Request-URI avec l’un des différents modèles. Si l’opération est PUT ou POST, Amazon EFS extrait les arguments d’appel du segment de chemin Request-URI, les paramètres de requête, ainsi que l’objet JSON dans le corps de la requête.

Points de terminaison d'API

Un point de terminaison est une URL qui sert de point d'entrée à un service AWS Web. Amazon EFS prend en charge les types de terminaux suivants :

Lorsque vous faites une demande, vous pouvez spécifier le point de terminaison à utiliser. Si vous ne spécifiez aucun point de IPv4 terminaison, celui-ci est utilisé par défaut. Pour utiliser un autre type de point de terminaison, vous devez le spécifier dans votre demande. Pour obtenir un exemple de la façon de procéder, consultez Spécification des points de terminaison. Pour un tableau des points de terminaison disponibles, consultez la section Points de terminaison et quotas Amazon EFS.

IPv4 points de terminaison

IPv4 les terminaux ne prennent en charge que IPv4 le trafic. IPv4 les points de terminaison sont disponibles pour toutes les régions. Le format du IPv4 point de terminaison dépend de la région.

Points de terminaison à double pile (IPv4 et IPv6)

Les terminaux à double pile prennent en charge à la fois le trafic IPv4 et IPv6 le trafic. Lorsque vous envoyez une demande à un point de terminaison à double pile, l'URL du point de terminaison correspond à une IPv4 adresse IPv6 ou à une adresse, selon le protocole utilisé par votre réseau et votre client. Le format du point de terminaison à double pile dépend de la région.

Spécification des points de terminaison

Les exemples suivants montrent comment spécifier un point de terminaison pour la région USA Ouest (Californie du Nord) (us-west-1) à l'aide du pour Amazon EFS. AWS CLI

IPv4

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

Double pile

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

Version de l’API

La version de l’API utilisée pour un appel est identifiée par le premier segment de chemin de l’URI de la demande, et sa forme est une date ISO 8601. Pour obtenir un exemple, consultez CreateFileSystem.

La documentation décrit l’API version 2015-02-01.

Rubriques en relation

Les sections suivantes fournissent des descriptions d’opérations d’API, indiquent comment créer une signature pour l’authentification de la requête et comment accorder des autorisations pour ces opérations d’API à l’aide de stratégies IAM.

Utilisation du débit de demandes d’API de requête pour Amazon EFS

Les demandes d'API Amazon EFS sont limitées pour chaque Compte AWS région afin d'améliorer les performances du service. Tous les appels d'API Amazon EFS effectués ensemble, qu'ils proviennent d'une application, de la AWS CLI console Amazon EFS ou de la console Amazon EFS, ne doivent pas dépasser le taux de demandes d'API maximal autorisé. Le taux maximal de demandes d'API peut varier d'un pays à l'autre Régions AWS. Les demandes d'API effectuées sont attribuées au sous-jacent Compte AWS.

Si une demande d’API dépasse le taux de demandes d’API pour sa catégorie, la demande renvoie le code d’erreur ThrottlingException. Pour éviter cette erreur, assurez-vous que votre application n’effectue pas de nouvelles tentatives de demandes d’API à un taux élevé. Vous pouvez le faire en utilisant l’interrogation avec soin et en utilisant les tentatives d’interruption exponentielle.

Interrogation

Votre application peut avoir besoin d’appeler une opération d’API de façon répétée pour vérifier une mise à jour du statut. Avant de démarrer l’interrogation, indiquez la durée potentielle de la demande. Lorsque vous commencez l’interrogation, utilisez un intervalle de veille approprié entre les demandes successives. Pour obtenir de meilleurs résultats, utilisez un intervalle de veille croissant.

Nouvelles tentatives ou traitement par lots

Votre application peut avoir besoin de relancer une demande d’API après un échec ou de traiter plusieurs ressources (par exemple, l’ensemble de vos systèmes de fichiers Amazon EFS). Pour réduire le taux de demandes d’API, utilisez un intervalle de veille approprié entre les demandes successives. Pour obtenir de meilleurs résultats, utilisez un intervalle de veille croissant ou variable.

Calcul de l’intervalle de veille

Lorsque vous devez interroger ou relancer une demande d’API, nous vous recommandons d’utiliser un algorithme d’interruption exponentielle pour calculer l’intervalle de sommeil entre les appels d’API. L’idée sous-jacente consiste à utiliser des temps d’attente progressivement plus longs entre les tentatives en cas de réponses d’erreur consécutives. Pour plus d'informations et des exemples d'implémentation de cet algorithme, consultez la section Comportement de la nouvelle tentative dans le Référence générale d'Amazon Web Services.