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 y subdirectorios de la propia aplicación. Un sistema de archivos puede tener un máximo de 10 000 puntos de acceso, a menos que solicite un aumento. Para obtener más información, consulte [Mounting a file system using EFS access points](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) (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 puntos de acceso, es posible que estas solicitudes reciban una limitación como respuesta. 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](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html). ## 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](#API_CreateAccessPoint_RequestSyntax) ** 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](#API_CreateAccessPoint_RequestSyntax) ** 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](#API_CreateAccessPoint_RequestSyntax) ** 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](API_PosixUser.md) Obligatorio: no ** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) ** 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 CreationInfo: OwnUid, OwnGID y los 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](API_RootDirectory.md) Obligatorio: no ** [Tags](#API_CreateAccessPoint_RequestSyntax) ** 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 los [AWS recursos de etiquetado](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) en la Guía de referencia * AWS general*. Tipo: matriz de objetos [Tag](API_Tag.md) 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](#API_CreateAccessPoint_ResponseSyntax) ** 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](#API_CreateAccessPoint_ResponseSyntax) ** 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](#API_CreateAccessPoint_ResponseSyntax) ** 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](#API_CreateAccessPoint_ResponseSyntax) ** 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](#API_CreateAccessPoint_ResponseSyntax) ** Identifica la fase del ciclo de vida del punto de acceso. Tipo: cadena Valores válidos: `creating | available | updating | deleting | deleted | error` ** [Name](#API_CreateAccessPoint_ResponseSyntax) ** El nombre del punto de acceso. Este es el valor de la etiqueta `Name`. Tipo: cadena ** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) ** Identifica al Cuenta de AWS propietario del recurso del 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](#API_CreateAccessPoint_ResponseSyntax) ** La identidad POSIX completa, incluidos el ID de usuario, el ID de grupo y el grupo IDs secundario del punto de acceso que utilizan los clientes de NFS para todas las operaciones de archivos que utilizan el punto de acceso. Tipo: objeto [PosixUser](API_PosixUser.md) ** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) ** 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](API_RootDirectory.md) ** [Tags](#API_CreateAccessPoint_ResponseSyntax) ** Las etiquetas asociadas al punto de acceso, presentadas como una matriz de objetos Tag. Tipo: matriz de objetos [Tag](API_Tag.md) ## 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. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. Código de estado HTTP: 409 ** AccessPointLimitExceeded ** Se devuelve si ya Cuenta de AWS se 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](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. 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. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. Código de estado HTTP: 400 ** FileSystemNotFound ** Se devuelve si el `FileSystemId` valor especificado no existe en el del Cuenta de AWS solicitante. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. Código de estado HTTP: 404 ** IncorrectFileSystemLifeCycleState ** Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. Código de estado HTTP: 409 ** InternalServerError ** Se devuelve si se ha producido un error en el servidor. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. 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](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. Código de estado HTTP: 429 ## Véase también Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint)