CreateAccessPoint - Amazon Elastic File System

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 directorio de la aplicación y cualquier subdirectorio. Para obtener más información, consulteMontaje de un sistema de archivos mediante puntos de acceso EFS.

nota

Si varias solicitudes para crear puntos de acceso en el mismo sistema de archivos se envían de forma rápida y el sistema de archivos está cerca del límite de 120 puntos de acceso, es posible que se produzca una respuesta limitante para 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.

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.

Type: Cadena

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

Type: Cadena

Restricciones de longitud: La longitud máxima es 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 grupo del sistema operativo se aplican 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 archivo deRootDirectory >Pathespecificado no existe, EFS lo crea y aplica elCreationInfoconfiguración cuando un cliente se conecta a un punto de acceso. Al especificar unRootDirectory, debe proporcionar el dispositivoPath, y elCreationInfo.

Amazon EFS crea un directorio raíz solo si ha proporcionado CreationInfo: OwnId, ownGID y permisos 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, consulteEtiquetadoAWSrecursosen la AWSGuía de referencia general.

Type: Matriz deTagobjects

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

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

Type: Cadena

Restricciones de longitud: La longitud máxima es de 128 caracteres.

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

AccessPointId

Identificador del punto de acceso, asignado por Amazon EFS.

Type: Cadena

Restricciones de longitud: La longitud máxima es 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.

Type: Cadena

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

Type: Cadena

Restricciones de longitud: La longitud máxima es 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.

Type: Cadena

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

Name

El nombre del punto de acceso. Este es el valor de laNameetiqueta.

Type: Cadena

OwnerId

Identificó elCuenta de AWSque posee el recurso de punto de acceso.

Type: Cadena

Restricciones de longitud: La longitud máxima es 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

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

Type: Matriz deTagobjects

Errores

AccessPointAlreadyExists

Devuelto 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

Devuelta si el dispositivoCuenta de AWSya 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 está mal formada o contiene un error, como un valor de parámetro no válido o un parámetro obligatorio que falta.

Código de estado HTTP: 400

FileSystemNotFound

Devuelta si el especificadoFileSystemIdEl valor no existe en el solicitanteCuenta de AWS.

Código de estado HTTP: 404

IncorrectFileSystemLifeCycleState

Devuelta si el estado de ciclo de vida del sistema de archivos no está «disponible».

Código de estado HTTP: 409

InternalServerError

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

Código de estado HTTP: 500

ThrottlingException

Devuelto cuando elCreateAccessPointLa acción de la API se llama demasiado rápido y el número de puntos de acceso del sistema de archivos se acerca alLí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: