Sintaxis de la solicitud Parámetros de solicitud del URI Cuerpo de la solicitud Sintaxis de la respuesta Elementos de respuesta Errores Ejemplos Véase también

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. Para obtener más información sobre los objetivos de montaje, consulta Administrar los objetivos de montaje.

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

Tras crear el destino de montaje, Amazon EFS devuelve una respuesta que incluye una MountTargetId y una dirección IP (IpAddressoIpv6Address). Esta dirección IP se utiliza al montar el sistema de archivos en una EC2 instancia. También puede utilizar el nombre DNS del destino de montaje al montar el sistema de archivos. La EC2 instancia en la que se monta el sistema de archivos mediante el destino de montaje puede convertir el nombre DNS del objetivo de montaje en su dirección IP. Para obtener más información, consulte Cómo funciona Amazon EFS.

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. Para obtener más información, consulte Creación de objetivos de montaje.

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

Crea un nuevo destino de montaje en la subred especificada.
Crea una nueva interfaz de red en la subred con lo siguiente:
- La descripción, Mount target fsmt-id for file system fs-id donde fsmt-id está el ID del objetivo de montaje y fs-id es el. FileSystemId
- La requesterManaged propiedad de la interfaz de red establecida en y el requesterId valor establecido enEFS. true
Cada destino de montaje 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 destino de montaje en el ID de la interfaz de red y la dirección IP en su dirección. Si la creación de interfaz de red produce un error, toda la operación CreateMountTarget 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.

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",
   "IpAddressType": "string",
   "Ipv6Address": "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

Si el IpAddressType objetivo del montaje es IPv4 (IPV4_ONLYoDUAL_STACK), especifique la IPv4 dirección que se va a utilizar. Si no especifica unaIpAddress, Amazon EFS seleccionará una dirección IP no utilizada de la subred especificada paraSubnetId.

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

IpAddressType

El tipo de dirección IP del destino de montaje. Los valores posibles son IPV4_ONLY (solo IPv4 direcciones), IPV6_ONLY (solo IPv6 direcciones) y DUAL_STACK (pila doble, ambas IPv4 IPv6 direcciones). Si no especificas unIpAddressType, entonces IPV4_ONLY se usa.

nota

IPAddressTypeDebe coincidir con el tipo de IP de la subred. Además, el IPAddressType parámetro anula el valor establecido como dirección IP predeterminada para la subred de la VPC. Por ejemplo, si IPAddressType es IPV4_ONLY y estrue, entonces AssignIpv6AddressOnCreation IPv4 se usa para el destino de montaje. Para obtener más información, consulte Modificación de los atributos de las direcciones IP de sus subredes.

Tipo: cadena

Valores válidos: IPV4_ONLY | IPV6_ONLY | DUAL_STACK

Obligatorio: no

Ipv6Address

Si el IPAddressType objetivo del montaje es IPv6 (IPV6_ONLYoDUAL_STACK), especifique la IPv6 dirección que se va a utilizar. Si no especifica unaIpv6Address, Amazon EFS seleccionará una dirección IP no utilizada de la subred especificada paraSubnetId.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 3. Longitud máxima de 39.

Obligatorio: no

SecurityGroups

Grupo de seguridad de VPC IDs, del formulario. sg-xxxxxxxx Deben ser para la misma VPC que la subred especificada. La cantidad máxima de grupos de seguridad depende de 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 tabla Grupos de seguridad). Si no especifica un grupo de seguridad, Amazon EFS utilizará el grupo de seguridad predeterminado para la VPC de la subred.

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. El tipo de subred debe ser del mismo tipo que el. IpAddressType

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",
   "Ipv6Address": "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 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 AWS

Tipo: 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 la us-east-1a de otra Cuenta de AWS.

Tipo: cadena

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

La IPv4 dirección del objetivo 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}$

Ipv6Address

La IPv6 dirección del objetivo de montaje.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 3. Longitud máxima de 39.

LifeCycleState

Estado del ciclo de vida del destino de montaje.

Tipo: cadena

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 creó Amazon EFS cuando creó 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 la nube privada virtual (VPC) en la que está configurado el destino de montaje.

Tipo: cadena

Errores

AvailabilityZonesMismatch

Se devuelve si la zona de disponibilidad que se especificó para el destino de montaje es diferente de la zona de disponibilidad del sistema de archivos. Para obtener más información, consulte Redundancia de almacenamiento regional y One Zone.

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 falta un parámetro obligatorio.

Código de estado HTTP: 400

FileSystemNotFound

Se devuelve si el FileSystemId valor especificado no existe en la 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

IpAddressInUse

Se devuelve si la solicitud especificó una dirección IP (IpAddressoIpv6Address) 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 destinos de montaje existentes en el sistema de archivos.

Código de estado HTTP: 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 Cuotas de Amazon VPC en la Guía del usuario de Amazon VPC (consulte la entrada Interfaces de red por región en la tabla Interfaces de red).

Código de estado HTTP: 409

NoFreeAddressesInSubnet

No se Ipv6Address devolvió IpAddress o se proporcionó en la solicitud y no hay direcciones IP libres en la subred especificada.

Código de estado HTTP: 409

SecurityGroupLimitExceeded

Se devuelve si el número SecurityGroups especificado en la solicitud es superior al límite, que se basa en la cuota de la cuenta. Elimine algunos grupos de seguridad 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 tabla Grupos de seguridad).

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

Cree un objetivo de montaje en una IPv4 dirección disponible en una subred

La siguiente solicitud especifica solo el sistema de archivos y la subred del destino de montaje. El destino se crea en una IPv4 dirección disponible en la subred especificada, con el grupo de seguridad predeterminado asociado a la VPC.

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

{
    "OwnerId": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "NetworkInterfaceId":"eni-1bcb7772"
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

Cree un destino de montaje en una dirección específica IPv4

La siguiente solicitud especifica el sistema de archivos, la subred, el grupo de seguridad y la IPv4 dirección que se van a utilizar para el 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"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

Cree un destino de montaje en una dirección específica IPv6

La siguiente solicitud especifica el sistema de archivos, la subred, el grupo de seguridad y la IPv6 dirección que se van a utilizar para el 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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "IpAddressType": "IPV6_ONLY",
   "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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "NetworkInterfaceId":"eni-1bcb7772"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

Cree un destino de montaje en una IPv4 dirección disponible en una subred de doble pila

La siguiente solicitud especifica el sistema de archivos, la subred y el tipo de dirección del destino de montaje. El destino se crea en una IPv4 dirección disponible en la subred de doble pila especificada, con el grupo de seguridad predeterminado asociado a la VPC.

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

{
    "OwnerId": "251839141158",
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId":"subnet-fd04ff94",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

Cree un objetivo de montaje en direcciones IPv4 específicas y IPv6 en una subred de doble pila

La siguiente solicitud especifica el sistema de archivos, la subred, el grupo de seguridad, la dirección y la IPv4 dirección del destino de IPv6 montaje. El destino se crea en las IPv6 direcciones IPv4 E especificadas en una subred de doble pila.

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",
   "IpAddressType": "DUAL_STACK",
   "IpAddress": "10.0.1.25",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "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": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "10.0.1.25",
    "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

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:

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

CreateFileSystem

CreateReplicationConfiguration