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. # CreateAccessPoint Crée un point d’accès EFS. Un point d’accès est une vue spécifique à l’application dans un système de fichiers EFS qui applique un utilisateur et un groupe de système d’exploitation, ainsi qu’un chemin d’accès au système de fichiers, à toute demande de système de fichiers effectuée via le point d’accès. L’utilisateur et le groupe du système d’exploitation remplacent toutes les informations d’identité fournies par le client NFS. Le chemin d’accès du système de fichiers est exposé en tant que répertoire racine du point d’accès. Les applications qui utilisent le point d’accès ne peuvent accéder qu’aux données de leur propre répertoire et de leurs éventuels sous-répertoires. Un système de fichiers peut avoir un maximum de 10 000 points d'accès, sauf si vous demandez une augmentation. Pour plus d’informations, veuillez consulter la rubrique Mo[ntage d’un système de fichiers à l’aide de points d’accès EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html). **Note** Si plusieurs demandes de création de points d'accès sur le même système de fichiers sont envoyées en succession rapide et que le système de fichiers est proche de la limite des points d'accès, il est possible que la réponse à ces demandes soit limitée. Cela permet de garantir que le système de fichiers ne dépasse pas le quota de points d’accès indiqué. Cette opération exige des autorisations pour l’action `elasticfilesystem:CreateAccessPoint`. Les points d’accès peuvent être balisés lors de leur création. Si les balises sont spécifiées dans l’action de création d’action, IAM effectue une autorisation supplémentaire sur l’action `elasticfilesystem:TagResource` pour vérifier si les utilisateurs sont autorisés à créer des balises. Par conséquent, vous devez octroyer des autorisations explicites d’utiliser l’action `elasticfilesystem:TagResource`. Pour plus d’informations, consultez [Octroi d’autorisations pour baliser les ressources lors de la création](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html). ## Syntaxe de la demande ``` POST /2015-02-01/access-points HTTP/1.1 Content-type: application/json { "ClientToken": "string", "FileSystemId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Paramètres de demande URI La demande n’utilise pas de paramètres URI. ## Corps de la demande Cette demande accepte les données suivantes au format JSON. ** [ClientToken](#API_CreateAccessPoint_RequestSyntax) ** Chaîne de 64 caractères ASCII maximum utilisée par Amazon EFS pour garantir une création idempotente. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères. Modèle : `.+` Obligatoire : oui ** [FileSystemId](#API_CreateAccessPoint_RequestSyntax) ** ID du système de fichiers EFS auquel le point d’accès donne un accès. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` Obligatoire : oui ** [PosixUser](#API_CreateAccessPoint_RequestSyntax) ** L’utilisateur et le groupe du système d’exploitation appliqués à toutes les demandes de système de fichiers effectuées via le point d’accès. Type : objet [PosixUser](API_PosixUser.md) Obligatoire : non ** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) ** Détermine le répertoire du système de fichiers EFS que le point d’accès expose en tant que répertoire racine de votre système de fichiers aux clients NFS utilisant le point d’accès. Les clients utilisant le point d’accès peuvent uniquement accéder au répertoire racine et en dessous. Si le `RootDirectory` > `Path` spécifié n’existe pas, Amazon EFS le crée et applique les paramètres `CreationInfo` lorsqu’un client se connecte à un point d’accès. Lorsque vous spécifiez un `RootDirectory`, vous devez fournir le `Path`, et le`CreationInfo`. Amazon EFS crée un répertoire racine uniquement si vous avez fourni le CreationInfo : OwnUid, le OwnGid et les autorisations pour le répertoire. Si vous ne fournissez pas ces informations, Amazon EFS ne crée pas le répertoire racine. Si le répertoire racine n’existe pas, les tentatives de Montage au Moyen du point d’accès échoueront. Type : objet [RootDirectory](API_RootDirectory.md) Obligatoire : non ** [Tags](#API_CreateAccessPoint_RequestSyntax) ** Crée des balises associées au point d’accès. Chaque balise est une paire clé-valeur, chaque clé doit être unique. Pour plus d'informations, consultez la section [AWS Ressources relatives au balisage](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) dans le *Guide de référence AWS général*. Type : tableau d’objets [Tag](API_Tag.md) Obligatoire : non ## Syntaxe de la réponse ``` HTTP/1.1 200 Content-type: application/json { "AccessPointArn": "string", "AccessPointId": "string", "ClientToken": "string", "FileSystemId": "string", "LifeCycleState": "string", "Name": "string", "OwnerId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [AccessPointArn](#API_CreateAccessPoint_ResponseSyntax) ** Le Amazon Resource Name (ARN) unique associé au point d’accès. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$` ** [AccessPointId](#API_CreateAccessPoint_ResponseSyntax) ** L’ID du point d’accès, attribué par Amazon EFS. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` ** [ClientToken](#API_CreateAccessPoint_ResponseSyntax) ** Chaîne opaque spécifiée dans la demande pour garantir la création idempotente. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères. Modèle : `.+` ** [FileSystemId](#API_CreateAccessPoint_ResponseSyntax) ** ID du système de fichiers EFS auquel le point d’accès s’applique. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [LifeCycleState](#API_CreateAccessPoint_ResponseSyntax) ** Identifie la phase du cycle de vie du point d’accès. Type : Chaîne Valeurs valides : `creating | available | updating | deleting | deleted | error` ** [Name](#API_CreateAccessPoint_ResponseSyntax) ** Nom de ce point d’accès. Il s’agit de la valeur de la balise `Name`. Type : Chaîne ** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) ** Identifie Compte AWS le propriétaire de la ressource du point d'accès. Type : Chaîne Contraintes de longueur : longueur maximale de 14. Modèle : `^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [PosixUser](#API_CreateAccessPoint_ResponseSyntax) ** L'identité POSIX complète, y compris l'ID utilisateur, l'ID de groupe et le groupe secondaire IDs sur le point d'accès utilisé pour toutes les opérations sur les fichiers par les clients NFS utilisant le point d'accès. Type : objet [PosixUser](API_PosixUser.md) ** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) ** Répertoire du système de fichiers Amazon EFS que le point d’accès expose en tant que répertoire racine aux clients NFS utilisant le point d’accès. Type : objet [RootDirectory](API_RootDirectory.md) ** [Tags](#API_CreateAccessPoint_ResponseSyntax) ** Les balises associées au point d’accès, présentées sous la forme d’un tableau d’objets Tag. Type : tableau d’objets [Tag](API_Tag.md) ## Erreurs ** AccessPointAlreadyExists ** Renvoyé si le point d’accès que vous essayez de créer existe déjà, avec le jeton de création que vous avez fourni dans la demande. ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP : 409 ** AccessPointLimitExceeded ** Renvoyé si le Compte AWS nombre maximum de points d'accès autorisés par système de fichiers a déjà été créé. Pour en savoir plus, consultez[https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP : 403 ** BadRequest ** Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant. ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP : 400 ** FileSystemNotFound ** Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur. ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP :404 ** IncorrectFileSystemLifeCycleState ** Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ». ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP : 409 ** InternalServerError ** Renvoyé si une erreur s’est produite côté serveur. ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP : 500 ** ThrottlingException ** Renvoyé lorsque l’action `CreateAccessPoint` API est appelée trop rapidement et que le nombre de points d’accès sur le système de fichiers approche de la [limite de 120](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP : 429 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint)