Creación y eliminación de puntos de acceso

Puede crear puntos de acceso de Amazon EFS mediante el AWS Management Console o el AWS CLI. También puede crear puntos de acceso mediante programación mediante los AWS SDK o la API de Amazon EFS directamente. No puede modificar un punto de acceso una vez creado. Un sistema de archivos puede tener un máximo de 1000 puntos de acceso. Para obtener más información acerca de los puntos de acceso de EFS, consulte Uso de puntos de acceso de Amazon EFS.

Los procedimientos siguientes describen cómo crear un punto de acceso mediante la consola y la AWS CLI.

Creación de un punto de acceso (consola)

Puede crear y eliminar puntos de acceso de Amazon EFS mediante la AWS Management Console API y los SDK de Amazon EFS AWS Command Line Interface (AWS CLI). No puede modificar un punto de acceso una vez creado. Un sistema de archivos puede tener un máximo de 1000 puntos de acceso.

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 la cuota de puntos de acceso indicada.

1. Abra la consola de Amazon Elastic File System en https://console.aws.amazon.com/efs/.

2. Elija Puntos de acceso para abrir la ventana Puntos de acceso.

3. Elija Crear puntos de acceso para mostrar la página Crear punto de acceso.

   También puede abrir la página Crear punto de acceso seleccionando Sistemas de archivos. Elija un Nombre o ID de sistema de archivos y, a continuación, elija Puntos de acceso y Crear punto de acceso para crear un punto de acceso para ese sistema de archivos.

   

   1. Introduzca la siguiente información en el panel Detalles:

      • Sistema de archivos: introduzca un nombre o ID de sistema de archivos y elija el sistema de archivos correspondiente. También puede elegir el sistema de archivos de la lista que aparezca al elegir el campo de entrada.

      • (Opcional) Nombre: escriba un nombre para el punto de acceso.

      • (Opcional) Ruta del directorio raíz: se puede especificar un directorio raíz para el punto de acceso; la raíz del punto de acceso predeterminada es /. Para introducir una ruta de directorio raíz, utilice el formato /foo/bar. Para obtener más información, consulte Hacer cumplir un directorio raíz con un punto de acceso.

   2. (Opcional) En el panel de Usuario de POSIX, puede especificar la identidad POSIX completa que se utilizará para aplicar la información de usuarios y grupos a todas las operaciones de archivos que realicen los clientes de NFS que utilicen el punto de acceso. Para obtener más información, consulte Hacer cumplir la identidad de un usuario mediante un punto de acceso.

      • ID de usuario: introduzca un ID de usuario POSIX numérico para el usuario.

      • ID de grupo: introduzca un ID de grupo POSIX numérico para el usuario.

      • ID de grupos secundarios: introduzca una lista opcional de identificadores de grupos secundarios separados por comas.

   3. (Opcional) Para los Permisos de creación del directorio raíz, puede especificar los permisos que se utilizarán cuando Amazon EFS cree la ruta del directorio raíz, si se ha especificado y el directorio raíz aún no existe. Para obtener más información, consulte Hacer cumplir un directorio raíz con un punto de acceso.

      nota

      Si no se especifica la propiedad ni los permisos de ningún directorio raíz, y el directorio raíz aún no existe, EFS no creará el directorio raíz. Todo intento de montar el sistema de archivos mediante el punto de acceso fallará.

      • ID de usuario propietario: introduzca el ID de usuario POSIX numérico que se utilizará como propietario del directorio raíz.

      • ID de grupo propietario: introduzca el ID de grupo POSIX numérico que se utilizará como grupo propietario del directorio raíz.

      • Permisos: introduzca el modo Unix del directorio. Una configuración común es 755. Asegúrese de que el bit de ejecución esté configurado para que el usuario del punto de acceso pueda montar.

4. Elija Crear punto de acceso para crear el punto de acceso mediante esta configuración.

Creación de un punto de acceso (CLI)

El siguiente ejemplo, el comando de CLI create-access-point crea un punto de acceso para un sistema de archivos EFS. El comando API equivalente es CreateAccessPoint.

aws efs create-access-point --file-system-id fs-abcdef0123456789a --client-token 010102020-3 \
--root-directory “Path=/efs/mobileapp/east,CreationInfo={OwnerUid=0,OwnerGid=11,Permissions=775}” \
--posix-user “Uid=22,Gid=4” \
--tags Key=Name,Value=east-users

Si la solicitud se realiza correctamente, la CLI responde con la descripción del punto de acceso.

{
    "ClientToken": "010102020-3",
    "Name": "east-users",
    "AccessPointId": "fsap-abcd1234ef5678901",
    "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111122223333:access-point/fsap-abcd1234ef5678901",
    "FileSystemId": "fs-01234567",
    "LifeCycleState": "creating",
    "OwnerId": "111122223333",
    "PosixUser": { 
      "Gid": 4,
      "Uid": 22
    },
    "RootDirectory": {
    "CreationInfo": { 
         "OwnerGid": 0,
         "OwnerUid": 11,
         "Permissions": "775"
      },
        "Path": "/efs/mobileapp/east",        
    },
    "Tags": []
}

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 la cuota de puntos de acceso indicada.

Eliminar un punto de acceso

Al eliminar un punto de acceso, los clientes que utilicen dicho punto pierden el acceso al sistema de archivos Amazon EFS para el que está configurado.

Eliminación de un punto de acceso (consola)

1. Abra la consola de Amazon Elastic File System en https://console.aws.amazon.com/efs/.

2. En el panel de navegación izquierdo, elija Puntos de acceso para abrir la página de Puntos de acceso.

3. Seleccione el punto de acceso que desee eliminar.

4. Elija Eliminar.

5. Elija Confirmar para confirmar la acción y eliminar el punto de acceso.

Eliminación de un punto de acceso (CLI)

En el siguiente ejemplo, el comando delete-access-point de la CLI elimina el punto de acceso especificado. El comando API equivalente es DeleteAccessPoint. Si el comando se ejecuta correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

aws efs delete-access-point --access-point-id fsap-092e9f80b3fb5e6f3 --client-token 010102020-3