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.
Solo puede crear un destino de montaje para crear un destino de montaje para crear un destino de montaje para EFS un destino de montaje para crear un destino de montaje para crear un destino de montaje Debe crear ese destino de montaje en la misma zona de disponibilidad en la que se encuentra el sistema de archivos. Utilice lasAvailabiltyZoneId
propiedadesAvailabilityZoneName
y del objeto deDescribeFileSystems respuesta para obtener esta información. Utilice la zona de disponibilidadsubnetId
asociada al sistema de archivos al crear el destino de montaje.
Para obtener más información, consulte Amazon EFS: cómo funciona.
Para crear un destino de montaje para crear un destino de montaje para crear un destino de montaje para crear un destino de montaje para crear un destino de montaje para crear un destino de montaje para crear un destino de montaje paraavailable
Para obtener más información, consulte DescribeFileSystems.
En la solicitud, proporcione lo siguiente:
-
El ID del sistema de archivos para el que va a crear el destino de montaje.
-
Un identificador 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 disponibilidad en que Amazon EFS crea el destino
-
El intervalo de direcciones IP a partir del cual 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, consulte la sección sobre Cómo funciona: información general de la 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 llamadaCreateNetworkInterface
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
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 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 campoIpAddress
en la dirección. Si la creación de interfaz de red produce un error, toda la operaciónCreateMountTarget
fracasa. -
LaCreateMountTarget
llamada solo se devuelve después de crear la interfaz de red, pero mientras el estado objetivo del montaje esté inactivocreating
, puede comprobar el estado de creación del objetivo de montaje llamando a laDescribeMountTargets operación, que, entre otras cosas, devuelve el estado objetivo 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
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.
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
-
Dirección IPv4 válida en el intervalo de direcciones de la subred especificada.
Tipo: cadena
Limitaciones de longitud máxima es de 7. La longitud longitud máxima es de 15 máxima es 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 ID de grupo de seguridad de la VPC, de la forma
sg-xxxxxxxx
. Estos deben ser para la misma VPC que la subred especificada.Tipo: matriz de cadenas
Miembros de la matriz: número máximo de 100 elementos.
Limitaciones de longitud máxima es de 11. La longitud longitud máxima es de 43 43 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 que utilizan clases de almacenamiento de Única zona, utilice la subred asociada a la zona de disponibilidad del sistema de archivos.
Tipo: cadena
Limitaciones de longitud máxima es de 15. La longitud longitud máxima es de 47 47 47.
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
-
El identificador único y coherente de la zona de disponibilidad en la que reside el destino del montaje. Por ejemplo,
use1-az1
es un ID de zona de disponibilidad para la región us-east-1 que se ID de zona de disponibilidad para la región us-east-1 que se ID de zona de disponibilidad para la región us-east-1 queCuenta de AWS se IDTipo: cadena
- AvailabilityZoneName
-
El nombre de zona de disponibilidad en la que se encuentra el destino de disponibilidad en la que se encuentra el destino de disponibilidad en la que se encuentra Las zonas de disponibilidad se asignan de forma independiente a los nombres de cada unaCuenta de AWS. Por ejemplo, esCuenta de AWS posible que la zona de disponibilidad para la zona de disponibilidad
us-east-1a
para la zona de disponibilidad para la zona de disponibilidad para la zona de disponibilidadus-east-1a
para la zona de disponibilidadCuenta de AWS para suTipo: cadena
Limitaciones 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 se crea el sistema de archivos para el que se crea el sistema de archivos para el que se crea
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 máxima es de 7. La longitud longitud máxima es de 15 máxima es de 15
Patrón:
^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$
- LifeCycleState
-
El ciclo de vida del ciclo de longitud máxima es del ciclo de vida del destino de longitud.
Tipo: cadena
Valores válidos:
creating | available | updating | deleting | deleted | error
- MountTargetId
-
ID de objetivo de montaje asignado por el sistema.
Tipo: cadena
Limitaciones de longitud máxima es de 13. La longitud longitud longitud máxima es de 45 45
Patrón:
^fsmt-[0-9a-f]{8,40}$
- NetworkInterfaceId
-
El ID de red que Amazon EFS creó la interfaz de red que Amazon EFS creó la interfaz de red que Amazon EFS creó la interfaz de red que Amazon EFS
Tipo: cadena
- OwnerId
-
Cuenta de AWSEl ID del ID que posee el recurso.
Tipo: cadena
Limitaciones de longitud máxima es de 14.
Patrón:
^(\d{12})|(\d{4}-\d{4}-\d{4})$
- SubnetId
-
El ID de subred del subred del destino de montaje.
Tipo: cadena
Limitaciones de longitud máxima es de 15. La longitud longitud máxima es de 47 47 47.
Patrón:
^subnet-[0-9a-f]{8,40}$
- VpcId
-
El ID de nube virtual VPC) en el que se configura el ID de nube virtual VPC) en el que se configura el ID de nube virtual VPC) en
Tipo: cadena
Errores
- AvailabilityZonesMismatch
-
Se devuelve si la zona de disponibilidad que se especificó para un objetivo de montaje es diferente de la zona de disponibilidad que se especificó para el almacenamiento de una zona. Para obtener más información, consulte Redundancia de almacenamiento regional y de una zona.
Código de estado HTTP: 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 un parámetro obligatorio faltante.
Código de estado HTTP: 400
- FileSystemNotFound
-
Se devuelve si el
FileSystemId
valor especificado no existe en la del solicitanteCuenta de AWS.Código de estado HTTP: 404
- IncorrectFileSystemLifeCycleState
-
Se devuelve si el estado del ciclo de vida del sistema de archivos no es «disponible».
Código de estado HTTP: 409
- InternalServerError
-
Se devuelve si se produce un error en el servidor.
Código de estado HTTP: 500
- IpAddressInUse
-
Se devuelve si la solicitud especificó una
IpAddress
que ya está en uso en la subred.Código de estado HTTP: 409
- MountTargetConflict
-
Se devuelve si el destino de montaje infringe una de las restricciones especificadas en función de los objetivos de montaje existentes del sistema de archivos.
Código de estado HTTP: 409
- NetworkInterfaceLimitExceeded
-
La cuenta de llamada ha alcanzado el límite de interfaces de red elásticas para la específicaRegión de AWS. Elimine algunas interfaces de red o solicite que se aumente la cuota de la cuenta. Para obtener más información, consulte Cuotas de Amazon VPC en la Guía del usuario de Amazon VPC (consulte la entrada Interfaces de red por región de la tabla Interfaces de red).
Código de estado HTTP: 409
- NoFreeAddressesInSubnet
-
Se devuelve si no
IpAddress
se especificó en la solicitud y no hay direcciones IP libres en la subred.Código de estado HTTP: 409
- SecurityGroupLimitExceeded
-
Se devuelve si el tamaño
SecurityGroups
especificado en la solicitud es superior a cinco.Código de estado HTTP: 400
- SecurityGroupNotFound
-
Se devuelve si uno de los grupos de seguridad especificados no existe en la nube privada virtual (VPC) de la subred.
Código de estado HTTP: 400
- SubnetNotFound
-
Se devuelve si no hay ninguna subred con el ID
SubnetId
proporcionado 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
Ejemplos
Agregar 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 losSubnetId
parámetrosFileSystemId
y requisitos. La solicitud no proporciona losSecurityGroups
parámetrosIpAddress
ni opcionales. EnIpAddress
longitud, la operación utiliza una dirección IP disponibles en la subred especificada. Además, la operación utiliza el grupo de seguridad predeterminado asociado a la VPC para la operaciónSecurityGroups
.
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"
}
Agregar un destino de montaje a un sistema de archivos
La siguiente solicitud especifica todos los parámetros de solicitud para crear un objetivo 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: