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)
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 correspond une demande donnée est déterminée par la combinaison de la méthode de la demande (GET, PUT, POST ou DELETE) et du modèle auquel correspond son URI de demande parmi les 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, des paramètres de requête et de l'objet JSON dans le corps de la requête.
Note
Bien que les noms d'opération, tels que CreateFileSystem, n'apparaissent pas dans le transfert, ces noms ont une signification dans les stratégies AWS Identity and Access Management (IAM). Pour plus d'informations, veuillez consulter Gestion des identités et des accès pour Amazon EFS.
Le nom de l'opération est également utilisé pour nommer les commandes dans les outils de ligne de commande et les éléments des API duAWS SDK. Par exemple, une commande de l'AWS CLI nommée create-file-system est mappée à l'opération CreateFileSystem.
Le nom de l'opération apparaît également dansAWS CloudTrail les journaux des appels d'API Amazon EFS.
Point de terminaison d'API
Le point de terminaison API est le nom DNS utilisé en tant que hôte dans l'URI HTTP pour les appels d'API. Ces points de terminaison d'API sont spécifiques àRégions AWS et prennent la forme suivante.
elasticfilesystem.aws-region.amazonaws.com
Par exemple, le point de terminaison d'API Amazon EFS pour la région USA Ouest (Oregon) est le suivant.
elasticfilesystem.us-west-2.amazonaws.com
Pour obtenir laRégion AWS liste des systèmes pris en charge par Amazon EFS (où vous pouvez créer et gérer des systèmes de fichiers), consultez Amazon Elastic File System dans le Références générales AWS.
Le point de terminaison d'API spécifique à la région définit l'étendue des ressources Amazon EFS accessibles lorsque vous effectuez un appel d'API. Par exemple, lorsque vous appelez l'DescribeFileSystemsopération à l'aide du point de terminaison précédent, vous obtenez une liste des systèmes de fichiers de la région USA Ouest (Oregon) qui ont été créés dans votre compte.
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 de 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 taux de demandes de l'API de requête pour Amazon EFS
Les demandes d'API Amazon EFS sont limitées pour chaqueCompte AWS région afin d'améliorer les performances du service. Tous les appels d'API Amazon EFS combinés, qu'ils proviennent d'une application, de laAWS CLI console Amazon EFS ou de la console Amazon EFS, ne doivent pas dépasser le taux de demandes d'API maximum autorisé. Le taux maximal de demandes d'API peut varier d'un endroit à l'autreRégions AWS. Les demandes d'API effectuées sont attribuées au sous-jacentCompte 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.
Réessais ou traitement par lots
Il se peut que votre application doive réessayer une demande d'API en cas d'échec, ou pour traiter plusieurs ressources (par exemple, tous 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 sommeil
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 Error Retries and Exponential BackoffAWS dans le Référence générale d'Amazon Web Services.
