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

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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 propio directorio de la aplicación y en los subdirectorios. 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 reciba una respuesta limitada a estas solicitudes. Esto es para garantizar que el sistema de archivos no supere el límite de puntos de acceso establecido.

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 elasticfilesystem:TagResource acción para verificar que los usuarios tengan permisos para crear etiquetas. Por lo tanto, debe conceder permisos explícitos para usar la elasticfilesystem:TagResource acción. 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 una creación idempotente.

Tipo: String

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

Patrón: .+

Obligatorio: sí

FileSystemId

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

Tipo: String

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 se aplicaron 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 Amazon 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 el RootDirectory > Path especificada no existe, EFS lo crea y aplica la CreationInfo configuración cuando un cliente se conecta a un punto de acceso. Al especificar unRootDirectory, debe proporcionar elPath, y elCreationInfo.

Amazon EFS crea un directorio raíz solo si ha proporcionado los permisosCreationInfo: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 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 AWSRecursos sobre etiquetado en la Guía de referencia AWS general.

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: String

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: String

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: String

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

Patrón: .+

FileSystemId

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

Tipo: String

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: String

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

Name

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

Tipo: String

OwnerId

Identifica Cuenta de AWS el propietario del recurso del punto de acceso.

Tipo: String

Limitaciones de longitud: longitud máxima de 14 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 Amazon 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 intenta crear ya existe, con el token de creación que proporcionó en la solicitud.

Código de estado HTTP: 409

AccessPointLimitExceeded

Se devuelve si ya Cuenta de AWS ha creado el número máximo de puntos de acceso permitido por sistema de archivos. Para obtener más información, consultehttps://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 un parámetro obligatorio faltante.

Código de estado HTTP: 400

FileSystemNotFound

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

Código de estado HTTP: 404

IncorrectFileSystemLifeCycleState

Se devuelve si el estado del ciclo de vida del sistema de archivos no es «disponible».

Código de estado HTTP: 409

InternalServerError

Se devuelve si se produce un error en el servidor.

Código de estado HTTP: 500

ThrottlingException

Se devuelve cuando la acción de la CreateAccessPoint API se llama 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 lenguaje específico, consulte: