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.
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 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.
Note
Bien que les noms des opérationsCreateFileSystem, tels que, n'apparaissent pas sur le fil, ils ont une signification dans les politiques AWS Identity and Access Management (IAM). Pour de plus amples 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 du AWS SDK. APIs Par exemple, il existe une AWS CLI commande nommée create-file-system qui correspond à l'CreateFileSystemopération.
Le nom de l'opération apparaît également dans AWS 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 se présentent sous 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.rproxy.goskope.comPour obtenir la liste des Région AWS 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 API spécifique à une région définit la portée des ressources Amazon EFS qui sont accessibles lorsque vous effectuez un appel d’API. Par exemple, lorsque vous appelez l’opération DescribeFileSystems à l’aide du point de terminaison précédent, vous obtenez une liste de systèmes de fichiers dans 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 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 obtenir plus d’informations et des exemples de mise en œuvre de cet algorithme, consultez Nouvelles tentatives après erreur et Backoff exponentiel dans AWS dans la Référence générale d'Amazon Web Services.
