Sintaxe da Solicitação Parâmetros da solicitação de URI Corpo da Solicitação Sintaxe da Resposta Elementos de Resposta Erros Exemplos Consulte também

CreateMountTarget

Cria destino de montagem para um sistema de arquivos. Em seguida, você pode montar o sistema de arquivos nas EC2 instâncias usando o destino de montagem. Para obter mais informações sobre alvos de montagem, consulte Gerenciando alvos de montagem.

Para criar um destino de montagem para um sistema de arquivos EFS, o estado do ciclo de vida do sistema de arquivos deve ser. available Para obter mais informações, consulte DescribeFileSystems.

Depois de criar o destino de montagem, o Amazon EFS retorna uma resposta que inclui um MountTargetId e um endereço IP (IpAddressouIpv6Address). Você usa esse endereço IP ao montar o sistema de arquivos em uma EC2 instância. Você também pode usar o nome DNS do destino de montagem ao montar o sistema de arquivos. A EC2 instância na qual você monta o sistema de arquivos usando o destino de montagem pode resolver o nome DNS do destino de montagem em seu endereço IP. Para obter mais informações, consulte Como o Amazon EFS funciona.

Observe que você pode criar destinos de montagem para um sistema de arquivos em apenas uma VPC, e pode haver apenas um destino de montagem por zona de disponibilidade. Para obter mais informações, consulte Criação de alvos de montagem.

Se a solicitação atender aos requisitos, o Amazon EFS fará o seguinte:

Criará um novo destino de montagem na sub-rede especificada.
Cria uma nova interface de rede na sub-rede com o seguinte:
- A descrição Mount target fsmt-id for file system fs-id onde fsmt-id está o ID de destino da montagem e fs-id é FileSystemId o.
- A requesterManaged propriedade da interface de rede definida como e o requesterId valor definido comoEFS. true
Cada destino de montagem tem uma interface de rede correspondente gerenciada pelo solicitante EC2 . Depois que a interface de rede é criada, o Amazon EFS define o NetworkInterfaceId campo na descrição do destino de montagem como o ID da interface de rede e o endereço IP como seu endereço. Se a criação da interface de rede falhar, toda a operação CreateMountTarget falhará.

nota

A chamada CreateMountTarget retorna somente depois da criação da interface de rede, mas enquanto o estado do destino de montagem ainda for creating, você poderá verificar o status da criação do destino de montagem chamando a operação DescribeMountTargets, o que, entre outras coisas, retorna o estado do destino de montagem.

Essa operação exige permissões para a seguinte ação no sistema de arquivos:

elasticfilesystem:CreateMountTarget

Essa operação também requer permissões para as seguintes EC2 ações da Amazon:

ec2:DescribeSubnets
ec2:DescribeNetworkInterfaces
ec2:CreateNetworkInterface

Sintaxe da Solicitação


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 da solicitação de URI

A solicitação não usa nenhum parâmetro de URI.

Corpo da Solicitação

A solicitação aceita os dados a seguir no formato JSON.

FileSystemId

O ID do sistema de arquivos para o qual você cria o destino de montagem.

Tipo: String

Restrições de tamanho: tamanho máximo de 128.

Padrão: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Exigido: Sim

IpAddress

Se o IpAddressType para o destino de montagem for IPv4 (IPV4_ONLYouDUAL_STACK), especifique o IPv4 endereço a ser usado. Se você não especificar umIpAddress, o Amazon EFS selecionará um endereço IP não utilizado da sub-rede especificada para. SubnetId

Tipo: String

Restrições de comprimento: comprimento mínimo de 7. Comprimento máximo de 15.

Padrão: ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

Obrigatório: Não

IpAddressType

O tipo de endereço IP do destino de montagem. Os valores possíveis são IPV4_ONLY (somente IPv4 endereços), IPV6_ONLY (somente IPv6 endereços) e DUAL_STACK (pilha dupla, ambos IPv4 e IPv6 endereços). Se você não especificar umIpAddressType, então será IPV4_ONLY usado.

nota

O IPAddressType deve corresponder ao tipo de IP da sub-rede. Além disso, o IPAddressType parâmetro substitui o valor definido como o endereço IP padrão para a sub-rede na VPC. Por exemplo, se IPAddressType for IPV4_ONLY e AssignIpv6AddressOnCreation IPv4 fortrue, será usado para o alvo de montagem. Para obter mais informações, consulte Modificar os atributos de endereçamento IP da sua sub-rede.

Tipo: String

Valores Válidos: IPV4_ONLY | IPV6_ONLY | DUAL_STACK

Obrigatório: Não

Ipv6Address

Se o IPAddressType para o destino de montagem for IPv6 (IPV6_ONLYouDUAL_STACK), especifique o IPv6 endereço a ser usado. Se você não especificar umIpv6Address, o Amazon EFS selecionará um endereço IP não utilizado da sub-rede especificada para. SubnetId

Tipo: String

Restrições de tamanho: tamanho mínimo 3. Comprimento máximo de 39.

Obrigatório: Não

SecurityGroups

Grupo de segurança VPC IDs, do formulário. sg-xxxxxxxx Eles devem ser para a mesma VPC da sub-rede especificada. O número máximo de grupos de segurança depende da cota da conta. Para obter mais informações, consulte Cotas da Amazon VPC no Guia do usuário da Amazon VPC (consulte a tabela de grupos de segurança). Se você não especificar um grupo de segurança, o Amazon EFS usará o grupo de segurança padrão para a VPC da sub-rede.

Tipo: matriz de strings

Membros da matriz: número máximo de 100 itens.

Restrições de tamanho: tamanho mínimo de 11. Tamanho máximo de 43.

Padrão: ^sg-[0-9a-f]{8,40}

Obrigatório: Não

SubnetId

O ID da sub-rede na qual adicionar o destino de montagem. Para sistemas de arquivos One Zone, use a sub-rede associada à zona de disponibilidade do sistema de arquivos. O tipo de sub-rede deve ser do mesmo tipo que o. IpAddressType

Tipo: String

Restrições de tamanho: tamanho mínimo de 15. Tamanho máximo de 47.

Padrão: ^subnet-[0-9a-f]{8,40}$

Exigido: Sim

Sintaxe da Resposta


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 Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

AvailabilityZoneId

O identificador exclusivo e consistente da zona de disponibilidade em que o alvo de montagem reside. Por exemplo, use1-az1 é uma ID AZ para a região us-east-1 e tem a mesma localização em todas. Conta da AWS

Tipo: String

AvailabilityZoneName

O nome da zona de disponibilidade na qual o destino de montagem está localizado. As zonas de disponibilidade são mapeadas de forma independente com os nomes de cada uma Conta da AWS. Por exemplo, a zona de disponibilidade da us-east-1a sua Conta da AWS pode não ser a mesma localização us-east-1a de outra Conta da AWS.

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.

Padrão: .+

FileSystemId

O ID do sistema de arquivos para o qual você cria o destino de montagem.

Tipo: String

Restrições de tamanho: tamanho máximo de 128.

Padrão: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

IpAddress

O IPv4 endereço do alvo de montagem.

Tipo: String

Restrições de comprimento: comprimento mínimo de 7. Comprimento máximo de 15.

Padrão: ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

Ipv6Address

O IPv6 endereço do alvo de montagem.

Tipo: String

Restrições de tamanho: tamanho mínimo 3. Comprimento máximo de 39.

LifeCycleState

Estado do ciclo de vida do destino de montagem.

Tipo: String

MountTargetId

ID do destino de montagem atribuída pelo sistema.

Tipo: String

Restrições de tamanho: tamanho mínimo de 13. Tamanho máximo de 45.

Padrão: ^fsmt-[0-9a-f]{8,40}$

NetworkInterfaceId

O ID da interface de rede que o Amazon EFS gerou ao criar o destino de montagem.

Tipo: String

OwnerId

Conta da AWS ID que possui o recurso.

Tipo: String

Restrições de tamanho: tamanho máximo de 14.

Padrão: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

SubnetId

O ID da sub-rede do destino de montagem.

Tipo: String

Restrições de tamanho: tamanho mínimo de 15. Tamanho máximo de 47.

Padrão: ^subnet-[0-9a-f]{8,40}$

VpcId

O ID da nuvem privada virtual (VPC) em que o destino de montagem está configurado.

Tipo: String

Erros

AvailabilityZonesMismatch

Retornado se a zona de disponibilidade especificada para o destino de montagem for diferente da zona de disponibilidade do sistema de arquivos. Para obter mais informações, consulte Redundância de armazenamento regional e de One Zone.

Código de status HTTP: 400

BadRequest

Retornado se a solicitação estiver malformada ou contiver um erro, como um valor de parâmetro inválido ou um parâmetro obrigatório ausente.

Código de status HTTP: 400

FileSystemNotFound

Retornado se o FileSystemId valor especificado não existir no valor do Conta da AWS solicitante.

Código de status HTTP: 404

IncorrectFileSystemLifeCycleState

Retornado se o estado do ciclo de vida do sistema de arquivos não estiver “disponível”.

Código de Status HTTP: 409

InternalServerError

Retornado se ocorreu um erro no lado do servidor.

Código de status HTTP: 500

IpAddressInUse

Retornada se a solicitação especificou um endereço IP (IpAddressouIpv6Address) que já está em uso na sub-rede.

Código de Status HTTP: 409

MountTargetConflict

Retornado se o destino de montagem violar uma das restrições especificadas com base nos destinos de montagem existentes no sistema de arquivos.

Código de Status HTTP: 409

NetworkInterfaceLimitExceeded

A conta de chamada atingiu o limite de interfaces de rede elástica para a Região da AWS específica. Exclua algumas interfaces de rede ou solicite que a cota da conta seja aumentada. Para obter mais informações, consulte Cotas da Amazon VPC no Guia do usuário da Amazon VPC (consulte a entrada Interfaces de rede por região na tabela Interfaces de rede).

Código de Status HTTP: 409

NoFreeAddressesInSubnet

Não retornou IpAddress ou Ipv6Address foi fornecido na solicitação e não há endereços IP gratuitos na sub-rede especificada.

Código de Status HTTP: 409

SecurityGroupLimitExceeded

Retornado se o número SecurityGroups especificado na solicitação for maior que o limite, que se baseia na cota da conta. Exclua alguns grupos de segurança ou solicite que a cota da conta seja aumentada. Para obter mais informações, consulte Cotas da Amazon VPC no Guia do usuário da Amazon VPC (consulte a tabela de grupos de segurança).

Código de status HTTP: 400

SecurityGroupNotFound

Retornado se um dos grupos de segurança especificados não existir na nuvem privada virtual (VPC) da sub-rede.

Código de status HTTP: 400

SubnetNotFound

Retornado se não houver sub-rede com o ID de SubnetId fornecido na solicitação.

Código de status HTTP: 400

UnsupportedAvailabilityZone

Retornado se a funcionalidade solicitada do Amazon EFS não estiver disponível na zona de disponibilidade especificada.

Código de status HTTP: 400

Exemplos

Crie um destino de montagem em um IPv4 endereço disponível em uma sub-rede

A solicitação a seguir especifica somente o sistema de arquivos e a sub-rede do destino de montagem. O destino é criado em um IPv4 endereço disponível na sub-rede especificada, com o grupo de segurança padrão associado à VPC.

Exemplo de solicitação


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"}

Resposta da amostra


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"
}

Crie um alvo de montagem em um IPv4 endereço específico

A solicitação a seguir especifica o sistema de arquivos, a sub-rede, o grupo de segurança e o IPv4 endereço a serem usados para o destino de montagem.

Exemplo de solicitação


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"
   ]
}

Resposta da amostra


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"
}

Crie um alvo de montagem em um IPv6 endereço específico

A solicitação a seguir especifica o sistema de arquivos, a sub-rede, o grupo de segurança e o IPv6 endereço a serem usados para o destino de montagem.

Exemplo de solicitação


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"
   ]
}

Resposta da amostra


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"
}

Crie um destino de montagem em um IPv4 endereço disponível na sub-rede de pilha dupla

A solicitação a seguir especifica o sistema de arquivos, a sub-rede e o tipo de endereço do destino de montagem. O destino é criado em um IPv4 endereço disponível na sub-rede de pilha dupla especificada, com o grupo de segurança padrão associado à VPC.

Exemplo de solicitação


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"}

Resposta da amostra


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"
}

Crie um destino de montagem em IPv4 e IPv6 endereços específicos na sub-rede de pilha dupla

A solicitação a seguir especifica o sistema de arquivos, a sub-rede, o grupo de segurança, o IPv4 endereço e o IPv6 endereço do destino de montagem. O destino é criado nos IPv6 endereços especificados IPv4 e em uma sub-rede de pilha dupla.

Exemplo de solicitação


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"
   ]
}

Resposta da amostra


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"
}

Consulte também

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

CreateFileSystem

CreateReplicationConfiguration