CreateAccessPoint - Amazon Elastic File System
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

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. Pour plus d’informations, veuillez consulter la rubrique Montage d’un système de fichiers à l’aide de points d’accès EFS.

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 approche de la limitation de 1 000 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.

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

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.

Modèle : .+

Obligatoire : oui

FileSystemId

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

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

Obligatoire : non

RootDirectory

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 leCreationInfo.

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

Obligatoire : non

Tags

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 dans le Guide de référence AWS général.

Type : tableau d’objets Tag

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

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

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

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.

Modèle : .+

FileSystemId

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

Identifie la phase du cycle de vie du point d’accès.

Type : chaîne

Valeurs valides : creating | available | updating | deleting | deleted | error

Name

Nom de ce point d’accès. Il s’agit de la valeur de la balise Name.

Type : chaîne

OwnerId

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

Identité POSIX complète, y compris l’ID utilisateur, l’ID de groupe et les ID de groupe secondaire, sur le point d’accès utilisé pour toutes les opérations de fichiers effectuées par les clients NFS utilisant le point d’accès.

Type : objet PosixUser

RootDirectory

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

Tags

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

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.

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, consultezhttps://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region.

Code d’état HTTP : 403

BadRequest

Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.

Code d’état HTTP : 400

FileSystemNotFound

Renvoyé si la FileSystemId valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.

Code d’état HTTP : 404

IncorrectFileSystemLifeCycleState

Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».

Code d’état HTTP : 409

InternalServerError

Renvoyé si une erreur s’est produite côté serveur.

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.

Code d’état HTTP : 429

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :