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

CreateMountTarget

Crea un destino de montaje para un sistema de archivos. A continuación, puede montar el sistema de archivos en instancias EC2 mediante el destino de montaje.

Puede crear un destino de montaje en cada zona de disponibilidad de su VPC. Todas las instancias EC2 en una VPC dentro de una determinada zona de disponibilidad comparten un solo destino de montaje para un determinado sistema de archivos. Si tiene varias subredes en una zona de disponibilidad, puede crear un destino de montaje en tan solo una de las subredes. Las instancias EC2 no tienen por qué estar en la misma subred que el destino de montaje para acceder a su sistema de archivos.

Puede crear solo un destino de montaje para un sistema de archivos de EFS mediante clases de almacenamiento de zona. Debe crear ese destino de montaje en la misma zona de disponibilidad en la que se encuentra el sistema de archivos. UsarAvailabilityZoneNameyAvailabiltyZoneIdpropiedades en elDescribeFileSystemsobjeto de respuesta para obtener esta información. UsarsubnetIdasociada a la zona de disponibilidad del sistema de archivos al crear el destino de montaje.

Para obtener más información, consulteAmazon EFS: Funcionamiento.

Para crear un destino de montaje para un sistema de archivos, el estado del ciclo de vida del sistema de archivos debe seravailable. Para obtener más información, consulte DescribeFileSystems.

En la solicitud, proporcione lo siguiente:

  • El ID del sistema de archivos para el que se crea el destino de montaje.

  • Un ID de subred, que determina lo siguiente:

    • La VPC en la que Amazon EFS crea el destino de montaje

    • La zona de disponibilidad en la que Amazon EFS crea el destino de montaje

    • El intervalo de direcciones IP a partir del que Amazon EFS selecciona la dirección IP del destino de montaje (si no especifica una dirección IP en la solicitud)

Después de crear el destino de montaje, Amazon EFS devuelve una respuesta que incluye un valor MountTargetId y un valor IpAddress. Puede utilizar esta dirección IP al montar el sistema de archivos en una instancia EC2. También puede utilizar el nombre DNS del destino de montaje al montar el sistema de archivos. La instancia EC2 en la que se monta el sistema de archivos mediante el destino de montaje puede resolver el nombre DNS del destino de montaje en su dirección IP. Para obtener más información, consulteFuncionamiento: Información general de implementación.

Tenga en cuenta que puede crear destinos de montaje para un sistema de archivos en una sola VPC y que solo puede haber un destino de montaje por zona de disponibilidad. Es decir, si el sistema de archivos ya tiene uno o varios destinos de montaje creados, la subred especificada en la solicitud para añadir otro destino de montaje debe cumplir los requisitos siguientes:

  • Debe pertenecen a la misma VPC que las subredes de los destinos de montaje existentes

  • No debe estar en la misma zona de disponibilidad que cualquiera de las subredes de los destinos de montaje existentes

Si la solicitud cumple los requisitos, Amazon EFS hace lo siguiente:

  • Crea un nuevo destino de montaje en la subred especificada.

  • Crea también una nueva interfaz de red en la subred como sigue:

    • Si la solicitud proporciona una IpAddress, Amazon EFS asigna esa dirección IP a la interfaz de red. De lo contrario, Amazon EFS asigna una dirección libre en la subred (de la misma forma que lo hace la llamada CreateNetworkInterface de Amazon EC2 cuando una solicitud no especifica una dirección IP privada principal).

    • Si la solicitud proporciona SecurityGroups, esta interfaz de red se asocia a esos grupos de seguridad. De lo contrario, pertenece al grupo de seguridad predeterminado para la VPC de la subred.

    • Asigna la descripción Mount target fsmt-id for file system fs-id donde fsmt-id es el ID del destino de montaje y fs-id es el FileSystemId.

    • Establece la propiedad requesterManaged de la interfaz de red en true y el valor requesterId en EFS.

    Cada destino de montaje de Amazon EFS tiene la correspondiente interfaz de red de EC2 administrada por el solicitante. Después de crear la interfaz de red, Amazon EFS establece el campo NetworkInterfaceId de la descripción del destino de montaje en el ID de interfaz de red y el campo IpAddress en la dirección. Si la creación de interfaz de red produce un error, toda la operación CreateMountTarget fracasa.

nota

LaCreateMountTargetla llamada solo devuelve después de crear la interfaz de red, pero mientras el estado de destino de montaje sigue siendocreating, puede comprobar el estado de creación del objetivo de montaje llamando alDescribeMountTargets, que, entre otras cosas, devuelve el estado de destino de montaje.

Le recomendamos crear un destino de montaje en cada una de las zonas de disponibilidad. Existen consideraciones de costos al usar un sistema de archivos en una zona de disponibilidad por medio de un destino de montaje creado en otra zona de disponibilidad. Para obtener más información, consulte Amazon EFS. Además, usando siempre un destino de montaje local en la zona de disponibilidad de la instancia, elimina un escenario de error parcial. Si la zona de disponibilidad en la que se crea el destino de montaje deja de funcionar, no tendrá acceso a su sistema de archivos a través de dicho destino de montaje.

Esta operación requiere permisos para las siguientes acciones en el sistema de archivos:

  • elasticfilesystem:CreateMountTarget

Esta operación también requiere permisos para las siguientes acciones de Amazon EC2:

  • ec2:DescribeSubnets

  • ec2:DescribeNetworkInterfaces

  • ec2:CreateNetworkInterface

Sintaxis de la solicitud

POST /2015-02-01/mount-targets HTTP/1.1 Content-type: application/json { "FileSystemId": "string", "IpAddress": "string", "SecurityGroups": [ "string" ], "SubnetId": "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.

FileSystemId

El ID del sistema de archivos para el que se crea el destino de montaje.

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í

IpAddress

Dirección IPv4 válida en el intervalo de direcciones de la subred especificada.

Type: Cadena

Restricciones de longitud: Longitud mínima de 7. La longitud máxima es de 15 caracteres.

Patrón: ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

Obligatorio: No

SecurityGroups

Hasta cinco ID de grupo de seguridad de la VPC, de la forma sg-xxxxxxxx. Estos deben ser para la misma VPC que la subred especificada.

Type: Matriz de cadenas

Miembros de matrices: Número máximo de 100 elementos.

Restricciones de longitud: Longitud mínima de 11. La longitud máxima es de 43 caracteres.

Patrón: ^sg-[0-9a-f]{8,40}

Obligatorio: No

SubnetId

El ID de la subred a la que se añade el destino de montaje. Para los sistemas de archivos que utilizan clases de almacenamiento de Única zona, utilice la subred asociada a la zona de disponibilidad del sistema de archivos.

Type: Cadena

Restricciones de longitud: Longitud mínima de 15. La longitud máxima es de 47 caracteres.

Patrón: ^subnet-[0-9a-f]{8,40}$

Obligatorio: Sí

Sintaxis de la respuesta

HTTP/1.1 200 Content-type: application/json { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "FileSystemId": "string", "IpAddress": "string", "LifeCycleState": "string", "MountTargetId": "string", "NetworkInterfaceId": "string", "OwnerId": "string", "SubnetId": "string", "VpcId": "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.

AvailabilityZoneId

Identificador único y coherente de la zona de disponibilidad en la que reside el destino de montaje. Por ejemplo,use1-az1es un ID de zona de disponibilidad para la región us-east-1 que tiene la misma ubicación en cadaCuenta de AWS.

Type: Cadena

AvailabilityZoneName

El nombre de la zona de disponibilidad en la que se encuentra el destino de montaje. Las zonas de disponibilidad se asignan de forma independiente a los nombres de cada unaCuenta de AWS. Por ejemplo, la zona de disponibilidadus-east-1apara tuCuenta de AWSpodría no ser la misma ubicación queus-east-1apara otroCuenta de AWS.

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 para el que está destinado el destino de montaje.

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})$

IpAddress

La dirección en la que se puede montar el sistema de archivos mediante el destino de montaje.

Type: Cadena

Restricciones de longitud: Longitud mínima de 7. La longitud máxima es de 15 caracteres.

Patrón: ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

LifeCycleState

Estado del ciclo de vida del destino de montaje.

Type: Cadena

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

MountTargetId

ID de destino de montaje asignado por el sistema.

Type: Cadena

Restricciones de longitud: Longitud mínima de 13. La longitud máxima es de 45 caracteres.

Patrón: ^fsmt-[0-9a-f]{8,40}$

NetworkInterfaceId

El ID de la interfaz de red que creó Amazon EFS cuando creó el destino de montaje.

Type: Cadena

OwnerId

Cuenta de AWSID que posee el recurso.

Type: Cadena

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

Patrón: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

SubnetId

El ID de la subred del destino de montaje.

Type: Cadena

Restricciones de longitud: Longitud mínima de 15. La longitud máxima es de 47 caracteres.

Patrón: ^subnet-[0-9a-f]{8,40}$

VpcId

El ID de nube virtual privada (VPC) en el que está configurado el destino de montaje.

Type: Cadena

Errors

AvailabilityZonesMismatch

Devuelto si la zona de disponibilidad especificada para un destino de montaje es diferente de la zona de disponibilidad especificada para las clases de almacenamiento One Zone. Para obtener más información, consulteRedundancia de almacenamiento regional y de una zona.

Código de estado HTTP: 400

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 la especificadaFileSystemIdEl valor no existe en el solicitanteCuenta de AWS.

Código de estado HTTP: 404

IncorrectFileSystemLifeCycleState

Se devuelve 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

IpAddressInUse

Devuelta si la solicitud especificó unaIpAddressque ya está en uso en la subred.

Código de estado HTTP: 409

MountTargetConflict

Se devuelve si el objetivo de montaje infringiría una de las restricciones especificadas en función de los destinos de montaje existentes del sistema de archivos.

Código de estado HTTP: 409

NetworkInterfaceLimitExceeded

La cuenta de llamada ha alcanzado el límite de las interfaces de red elásticas para elRegión de AWS. El cliente debería intentar eliminar algunas interfaces de red elásticas o aumentar el límite de la cuenta. Para obtener más información, consulteLímites de Amazon VPCen laAmazon VPC User Guide(consulte las interfaces de red por entrada de VPC en la tabla).

Código de estado HTTP: 409

NoFreeAddressesInSubnet

Devuelta siIpAddressno se especificó en la solicitud y no hay direcciones IP gratuitas en la subred.

Código de estado HTTP: 409

SecurityGroupLimitExceeded

Devuelto si el tamaño deSecurityGroupsespecificado en la solicitud es superior a cinco.

Código de estado HTTP: 400

SecurityGroupNotFound

Se devuelve si no existe uno de los grupos de seguridad especificados en la VPC de subred.

Código de estado HTTP: 400

SubnetNotFound

Devuelto si no hay una subred con IDSubnetIdproporcionado en la solicitud.

Código de estado HTTP: 400

UnsupportedAvailabilityZone

Se devuelve si la funcionalidad de Amazon EFS solicitada no está disponible en la zona de disponibilidad especificada.

Código de estado HTTP: 400

Examples

Añadir un destino de montaje a un sistema de archivos

La siguiente solicitud crea un destino de montaje para un sistema de archivos. La solicitud especifica valores solo para el requeridoFileSystemIdySubnetIdparámetros. La solicitud no proporciona la opción opcionalIpAddressySecurityGroupsparámetros. ParaIpAddress, la operación utiliza una de las direcciones IP disponibles en la subred especificada. Además, la operación utiliza el grupo de seguridad predeterminado asociado a la VPC para elSecurityGroups.

Solicitud de muestra

POST /2015-02-01/mount-targets HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T221118Z Authorization: <...> Content-Type: application/json Content-Length: 160 {"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}

Respuesta de ejemplo

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 252 { "MountTargetId": "fsmt-55a4413c", "NetworkInterfaceId": "eni-01234567", "FileSystemId": "fs-01234567", "LifeCycleState": "available", "SubnetId": "subnet-01234567", "OwnerId": "231243201240", "IpAddress": "172.31.22.183" }

Añadir un destino de montaje a un sistema de archivos

En la siguiente solicitud se especifican todos los parámetros de solicitud para crear un destino de montaje.

Solicitud de muestra

POST /2015-02-01/mount-targets HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T221118Z Authorization: <...> Content-Type: application/json Content-Length: 160 { "FileSystemId":"fs-01234567", "SubnetId":"subnet-01234567", "IpAddress":"10.0.2.42", "SecurityGroups":[ "sg-01234567" ] }

Respuesta de ejemplo

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 252 { "OwnerId":"251839141158", "MountTargetId":"fsmt-9a13661e", "FileSystemId":"fs-01234567", "SubnetId":"subnet-fd04ff94", "LifeCycleState":"available", "IpAddress":"10.0.2.42", "NetworkInterfaceId":"eni-1bcb7772" }

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: