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 EC2 las instancias mediante el destino de montaje.
Puede crear un objetivo de montaje en cada zona de disponibilidad de suVPC. Todas las EC2 instancias de una VPC zona de disponibilidad determinada comparten un único destino de montaje para un sistema de archivos determinado. Si tiene varias subredes en una zona de disponibilidad, puede crear un destino de montaje en tan solo una de las subredes. EC2las instancias no necesitan estar en la misma subred que el destino de montaje para acceder a su sistema de archivos.
Solo puede crear un destino de montaje para un sistema de archivos One Zone. Debe crear ese destino de montaje en la misma zona de disponibilidad en la que encuentra el sistema de archivos. Utilice las propiedades AvailabilityZoneName
y AvailabiltyZoneId
del objeto de respuesta DescribeFileSystems para obtener esta información. Utilice el subnetId
asociado a la zona de disponibilidad del sistema de archivos al crear el destino de montaje.
Para obtener más información, consulta AmazonEFS: Cómo funciona.
Para crear un destino de montaje para un sistema de archivos, el estado del ciclo de vida del sistema de archivos debe ser available
. Para obtener más información, consulte DescribeFileSystems.
En la solicitud, proporcione lo siguiente:
-
ID del sistema de archivos para el que se crea el destino de montaje.
-
Un identificador de subred, que determina lo siguiente:
-
El objetivo VPC en el que Amazon EFS crea la montura
-
La zona de disponibilidad en la que Amazon EFS crea el objetivo de montaje
-
El rango de direcciones IP desde el que Amazon EFS selecciona la dirección IP del destino de montaje (si no especificas una dirección IP en la solicitud)
-
Tras crear el objetivo de montaje, Amazon EFS devuelve una respuesta que incluye a MountTargetId
y anIpAddress
. Esta dirección IP se utiliza al montar el sistema de archivos en una EC2 instancia. También puedes usar el DNS nombre del destino de montaje al montar el sistema de archivos. La EC2 instancia en la que monte el sistema de archivos mediante el destino de montaje puede convertir el DNS nombre del destino de montaje en su dirección IP. Para obtener más información, consulte la sección sobre Cómo funciona: información general de la implementación.
Tenga en cuenta que solo puede crear destinos de montaje para un sistema de archivos en uno 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 pertenecer a las VPC mismas 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 gratuita en la subred (del mismo modo que lo hace la EC2CreateNetworkInterface
llamada de Amazon 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 de la subred. VPC -
Asigna la descripción
Mount target fsmt-id for file system fs-id
dondefsmt-id
es el ID del destino de montaje yfs-id
es elFileSystemId
. -
Establece la propiedad
requesterManaged
de la interfaz de red entrue
y el valorrequesterId
enEFS
.
Cada destino de EFS montaje de Amazon tiene una interfaz de red gestionada por el solicitante EC2 correspondiente. Una vez creada la interfaz de red, Amazon EFS establece el
NetworkInterfaceId
campo de la descripción del objetivo de montaje en el ID de la interfaz de red y elIpAddress
campo en su dirección. Si la creación de interfaz de red produce un error, toda la operaciónCreateMountTarget
fracasa. -
nota
La llamada a CreateMountTarget
realiza una devolución solo después de crear la interfaz de red pero, mientras el estado del destino sigue siendo creating
, usted puede comprobar el estado de creación del destino de montaje llamando a la operación DescribeMountTargets, que entre otras cosas devuelve el estado del 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, consulta Amazon EFS
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 EC2 acciones de Amazon:
-
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
"
}
URIParámetros de solicitud
La solicitud no utiliza ningún URI parámetro.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en JSON formato.
- FileSystemId
-
El ID del sistema de archivos para el que se crea el destino de montaje.
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í
- IpAddress
-
IPv4Dirección válida dentro del rango de direcciones de la subred especificada.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 7. Longitud máxima de 15.
Patrón:
^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$
Obligatorio: no
- SecurityGroups
-
Hasta cinco grupos VPC IDs de seguridad del formulario
sg-xxxxxxxx
. Deben ser iguales VPC a la subred especificada.Tipo: matriz de cadenas
Miembros de la matriz: número máximo de 100 elementos.
Limitaciones de longitud: longitud mínima de 11. Longitud máxima de 43.
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 One Zone, utilice la subred asociada a la zona de disponibilidad del sistema de archivos.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 50. Longitud máxima de 80.
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 de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- AvailabilityZoneId
-
El identificador único y coherente de la zona de disponibilidad en la que reside el destino de montaje. Por ejemplo,
use1-az1
es un ID AZ para la región us-east-1 y tiene la misma ubicación en todas. Cuenta de AWSTipo: 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 una de ellas. Cuenta de AWS Por ejemplo, es Cuenta de AWS posible que la zona
us-east-1a
de disponibilidad de su ubicación no sea la misma que laus-east-1a
de otra Cuenta de AWS.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 para el que se crea el destino de montaje.
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})$
- IpAddress
-
Dirección en la que se puede montar el sistema de archivos mediante el destino de montaje.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 7. Longitud máxima de 15.
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.
Tipo: cadena
Valores válidos:
creating | available | updating | deleting | deleted | error
- MountTargetId
-
ID de destino de montaje asignado por el sistema.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 13. Longitud máxima de 45.
Patrón:
^fsmt-[0-9a-f]{8,40}$
- NetworkInterfaceId
-
El ID de la interfaz de red que Amazon EFS creó al crear el destino de montaje.
Tipo: cadena
- OwnerId
-
Cuenta de AWS ID propietario del recurso.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 255 caracteres.
Patrón:
^(\d{12})|(\d{4}-\d{4}-\d{4})$
- SubnetId
-
El ID de la subred del destino de montaje.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 50. Longitud máxima de 80.
Patrón:
^subnet-[0-9a-f]{8,40}$
- VpcId
-
El ID de nube privada virtual (VPC) en el que está configurado el destino de montaje.
Tipo: cadena
Errores
- AvailabilityZonesMismatch
-
Se devuelve si la zona de disponibilidad que se especificó para un destino de montaje es diferente de la zona de disponibilidad que se especificó para el almacenamiento One Zone. Para obtener más información, consulte Redundancia de almacenamiento regional y One Zone.
HTTPCódigo de estado: 400
- 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.
HTTPCódigo de estado: 400
- FileSystemNotFound
-
Se devuelve si el
FileSystemId
valor especificado no existe en el del Cuenta de AWS solicitante.HTTPCódigo de estado: 404
- IncorrectFileSystemLifeCycleState
-
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
HTTPCódigo de estado: 409
- InternalServerError
-
Se devuelve si se ha producido un error en el servidor.
HTTPCódigo de estado: 500
- IpAddressInUse
-
Se devuelve si la solicitud especificó una
IpAddress
que ya está en uso en la subred.HTTPCódigo de estado: 409
- MountTargetConflict
-
Se devuelve si el destino de montaje infringe una de las restricciones especificadas en función de los destinos de montaje existentes en el sistema de archivos.
HTTPCódigo de estado: 409
- NetworkInterfaceLimitExceeded
-
La cuenta que realiza la llamada ha alcanzado el límite de interfaces de red elásticas para la Región de AWS específica. Elimine algunas interfaces de red o solicite que se aumente la cuota de la cuenta. Para obtener más información, consulte Amazon VPC Quotas en la Guía del VPC usuario de Amazon (consulte la entrada Interfaces de red por región en la tabla Interfaces de red).
HTTPCódigo de estado: 409
- NoFreeAddressesInSubnet
-
Se devuelve si
IpAddress
no se especificó en la solicitud y no hay direcciones IP libres en la subred.HTTPCódigo de estado: 409
- SecurityGroupLimitExceeded
-
Se devuelve si el tamaño de
SecurityGroups
especificado en la solicitud es superior a cinco.HTTPCódigo de estado: 400
- SecurityGroupNotFound
-
Se devuelve si uno de los grupos de seguridad especificados no existe en la nube privada virtual de la subred (VPC).
HTTPCódigo de estado: 400
- SubnetNotFound
-
Se devuelve si no hay ninguna subred con el ID
SubnetId
proporcionado en la solicitud.HTTPCódigo de estado: 400
- UnsupportedAvailabilityZone
-
Se devuelve si la EFS funcionalidad de Amazon solicitada no está disponible en la zona de disponibilidad especificada.
HTTPCódigo de estado: 400
Ejemplos
Agregue 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 únicamente para los parámetros FileSystemId
y SubnetId
obligatorios. La solicitud no proporciona los parámetros IpAddress
y SecurityGroups
opcionales. Para IpAddress
, 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 al 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"
}
Agregue un destino de montaje a un sistema de archivos
La siguiente solicitud especifica todos los parámetros de la 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 cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: