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. 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: string
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>Pathespecificado no existe, Amazon EFS crea el directorio raíz utilizando la configuración deCreationInfocuando un cliente se conecta a un punto de acceso. Al especificar unRootDirectory, debe proporcionar laPathy laCreationInfo.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
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 los AWS recursos de 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: 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: string
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 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
-
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 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.
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
FileSystemIdvalor especificado no existe en el 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 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
CreateAccessPointse 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 uno de los AWS SDK específicos del idioma, consulta lo siguiente:
