CreateAccessPoint - Amazon Elastic File System
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

CreateAccessPoint

Crea un punto de acceso de EFS Un punto de acceso es una vista específica de la aplicación en un sistema de archivos de EFS que aplica un usuario y un grupo del sistema operativo, así como una ruta del sistema de archivos, a cualquier solicitud del sistema de archivos realizada a través del punto de acceso. El usuario y el grupo del sistema operativo invalidan cualquier información de identidad proporcionada por el cliente de NFS. La ruta del sistema de archivos se expone como directorio raíz del punto de acceso. Las aplicaciones que utilizan el punto de acceso solo pueden acceder a los datos en el directorio y subdirectorios de la propia aplicación. Para obtener más información, consulte Mounting a file system using EFS access points (Montaje de un sistema de archivos mediante puntos de acceso de EFS).

nota

Si se envían varias solicitudes para crear puntos de acceso en el mismo sistema de archivos en rápida sucesión y el sistema de archivos se acerca al límite de 1000 puntos de acceso, es posible que estas solicitudes reciban una respuesta limitadora. Esto es para garantizar que el sistema de archivos no supere el límite de puntos de acceso indicada.

Esta operación necesita permisos para la acción elasticfilesystem:CreateAccessPoint.

Los puntos de acceso se pueden etiquetar al crearlos. Si se especifican etiquetas en la acción de creación, IAM realiza una autorización adicional en la acción elasticfilesystem:TagResource para verificar que los usuarios tengan permisos para crear etiquetas. Por lo tanto, usted debe conceder permisos explícitos para utilizar la acción elasticfilesystem:TagResource. Para obtener más información, consulte Conceder permisos para etiquetar recursos durante la creación.

Sintaxis de la solicitud

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

Parámetros de solicitud del URI

La solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

ClientToken

Cadena de hasta 64 caracteres ASCII que Amazon EFS utiliza para garantizar la creación idempotente.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.

Patrón: .+

Obligatorio: sí

FileSystemId

El ID del sistema de archivos de EFS al que el punto de acceso proporciona acceso.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 128 caracteres.

Patrón: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Obligatorio: sí

PosixUser

El usuario y el grupo del sistema operativo aplicados a todas las solicitudes del sistema de archivos realizadas mediante el punto de acceso.

Tipo: objeto PosixUser

Obligatorio: no

RootDirectory

Especifica el directorio del sistema de archivos de EFS que el punto de acceso expone como directorio raíz del sistema de archivos a los clientes de NFS que utilizan el punto de acceso. Los clientes que utilizan el punto de acceso solo pueden acceder al directorio raíz e inferiores. Si RootDirectory > Path especificado no existe, Amazon EFS crea el directorio raíz utilizando la configuración de CreationInfo cuando un cliente se conecta a un punto de acceso. Al especificar un RootDirectory, debe proporcionar la Path y la CreationInfo.

Amazon EFS crea un directorio raíz solo si ha proporcionado los permisos CreationInfo: OwnUid, OwnGID para el directorio. Si no proporciona dicha información, Amazon EFS no creará el directorio raíz. Si el directorio raíz no existe, los intentos de montaje utilizando el punto de acceso fallarán.

Tipo: objeto RootDirectory

Obligatorio: no

Tags

Crea las etiquetas asociadas al punto de acceso. Cada etiqueta es un par clave-valor, cada clave debe ser única. Para obtener más información, consulte Etiquetado de recursos de AWS en la Guía de referencia general de AWS.

Tipo: matriz de objetos Tag

Obligatorio: no

Sintaxis de la respuesta

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

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

AccessPointArn

El nombre de recurso de Amazon (ARN) único asociado al punto de acceso.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 128 caracteres.

Patrón: ^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$

AccessPointId

El ID del punto de acceso, asignado por Amazon EFS.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 128 caracteres.

Patrón: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$

ClientToken

La cadena opaca especificada en la solicitud para garantizar la creación de idempotentes.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.

Patrón: .+

FileSystemId

El ID del sistema de archivos de EFS al que se aplica el punto de acceso.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 128 caracteres.

Patrón: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

LifeCycleState

Identifica la fase del ciclo de vida del punto de acceso.

Tipo: cadena

Valores válidos: creating | available | updating | deleting | deleted | error

Name

El nombre del punto de acceso. Este es el valor de la etiqueta Name.

Tipo: cadena

OwnerId

Identifica la Cuenta de AWS que posee el recurso de punto de acceso.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 255 caracteres.

Patrón: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

PosixUser

La identidad POSIX completa, incluido el ID de usuario, el ID de grupo y los ID de grupo secundarios en el punto de acceso que se utiliza para todas las operaciones de archivos por los clientes de NFS que utilizan el punto de acceso.

Tipo: objeto PosixUser

RootDirectory

El directorio del sistema de archivos de EFS que el punto de acceso expone como directorio raíz a los clientes de NFS que utilizan el punto de acceso.

Tipo: objeto RootDirectory

Tags

Las etiquetas asociadas al punto de acceso, presentadas como una matriz de objetos Tag.

Tipo: matriz de objetos Tag

Errores

AccessPointAlreadyExists

Se devuelve si el punto de acceso que está intentando crear ya existe, con el token de creación que proporcionó en la solicitud.

Código de estado HTTP: 409

AccessPointLimitExceeded

Se devuelve si Cuenta de AWS ya ha creado el número máximo de puntos de acceso permitidos por sistema de archivos. Para obtener más información, consulte https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region.

Código de estado HTTP: 403

BadRequest

Se devuelve si la solicitud tiene un formato incorrecto o contiene un error, como un valor de parámetro no válido, o falta un parámetro obligatorio.

Código de estado HTTP: 400

FileSystemNotFound

Se devuelve si el valor FileSystemId especificado no existe en el Cuenta de AWS del solicitante.

Código de estado HTTP: 404

IncorrectFileSystemLifeCycleState

Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.

Código de estado HTTP: 409

InternalServerError

Se devuelve si se ha producido un error en el servidor.

Código de estado HTTP: 500

ThrottlingException

Se devuelve cuando la acción de la API CreateAccessPoint se ejecuta demasiado rápido y el número de puntos de acceso en el sistema de archivos se acerca al límite de 120.

Código de estado HTTP: 429

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte: