CreateAccessPoint - Amazon Elastic File System
Syntaxe de la requêteURIParamètres de demandeCorps de la requêteSyntaxe de la réponseEléments de réponseErreursconsultez 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 EFS d'accès. Un point d'accès est une vue spécifique à une application d'un système de EFS fichiers qui applique un utilisateur et un groupe du système d'exploitation, ainsi qu'un chemin de 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 NFS client. 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 en savoir plus, consultez la section Montage d'un système de fichiers EFS à l'aide de points d'accès.

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 des balises sont spécifiées dans l'action de création, IAM octroie une autorisation supplémentaire à l'elasticfilesystem:TagResourceaction 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 requête

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"
      }
   ]
}

URIParamètres de demande

La demande n'utilise aucun URI paramètre.

Corps de la requête

La demande accepte les données suivantes au JSON format suivant.

ClientToken

Chaîne de 64 ASCII caractères maximum EFS utilisée par Amazon 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 EFS fichiers auquel le point d'accès fournit l'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

Spécifie le répertoire du système de EFS fichiers que le point d'accès expose en tant que répertoire racine de votre système de fichiers aux NFS clients 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 le EFS crée et applique les CreationInfo paramètres 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 code CreationInfo : OwnUid, le nom propre GID 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 sous JSON forme formatée par le service.

AccessPointArn

Le nom unique de la ressource Amazon (ARN) 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 AmazonEFS.

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 EFS fichiers auquel s'applique le point d'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})$

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

POSIXIdentité complète, y compris l'ID utilisateur, l'ID de groupe et le groupe secondaire du point d'accès utilisé pour toutes les opérations IDs sur les fichiers par les NFS clients utilisant le point d'accès.

Type : objet PosixUser

RootDirectory

Répertoire du système de EFS fichiers que le point d'accès expose en tant que répertoire racine aux NFS clients 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.

HTTPCode de statut : 409

AccessPointLimitExceeded

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

HTTPCode de statut : 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.

HTTPCode de statut : 400

FileSystemNotFound

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

HTTPCode de statut : 404

IncorrectFileSystemLifeCycleState

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

HTTPCode de statut : 409

InternalServerError

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

HTTPCode de statut : 500

ThrottlingException

Renvoyé lorsque l'CreateAccessPointAPIaction 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.

HTTPCode de statut : 429

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :