CreateMountTarget

Cria destino de montagem para um sistema de arquivos. Depois, você pode montar o sistema de arquivos em instâncias do EC2 usando o destino de montagem.

Você pode criar um destino de montagem em cada zona de disponibilidade em sua VPC. Todas as instâncias do EC2 em uma VPC em uma determinada zona de disponibilidade compartilham um único destino de montagem para um determinado sistema de arquivos. Se tiver várias sub-redes em uma zona de disponibilidade, você poderá criar um destino de montagem em uma das sub-redes. As instâncias do EC2 não precisam estar na mesma sub-rede do destino de montagem para acessarem o sistema de arquivos.

Você pode criar somente um destino de montagem para um sistema de arquivos One Zone. Você deve criar esse destino de montagem na mesma zona de disponibilidade em que o sistema de arquivos está localizado. Use as propriedades AvailabiltyZoneId e AvailabilityZoneName no objeto de resposta DescribeFileSystems para obter essas informações. Use o subnetId associado à zona de disponibilidade do sistema de arquivos ao criar o destino de montagem.

Para obter mais informações, consulte Amazon EFS: como ele funciona.

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

Na solicitação, forneça o seguinte:

• ID do sistema de arquivos para o qual você está criando o destino de montagem.

• Um ID de sub-rede, que determina o seguinte:

  • A VPC em que o Amazon EFS cria o destino de montagem

  • A zona de disponibilidade em que o Amazon EFS cria o destino de montagem

  • Intervalo de endereços IP do qual o Amazon EFS seleciona o endereço IP do destino de montagem (se você não especificar um endereço IP na solicitação)

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

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. Ou seja, se o sistema de arquivos já tiver um ou mais destinos de montagem criados para ele, a sub-rede especificada na solicitação para adicionar outro destino de montagem deverá atender aos seguintes requisitos:

• Deve pertencer à mesma VPC que as sub-redes de destino de montagem existentes

• Não deve estar na mesma zona de disponibilidade que qualquer uma das sub-redes de destinos de montagem existentes

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

• Criará um novo destino de montagem na sub-rede especificada.

• Também criará uma nova interface de rede na sub-rede, da seguinte forma:

  • Se a solicitação fornecer um IpAddress, o Amazon EFS atribuirá o endereço IP à interface de rede. Caso contrário, o Amazon EFS atribuirá um endereço gratuito na sub-rede (da mesma forma que a chamada de CreateNetworkInterface do Amazon EC2 faz quando uma solicitação não especifica um endereço IP privado principal).

  • Se a solicitação fornecer SecurityGroups, essa interface de rede será associada a esses grupos de segurança. Caso contrário, ele pertencerá ao grupo de segurança padrão da VPC da sub-rede.

  • Atribui a descrição Mount target fsmt-id for file system fs-id em que fsmt-id é o ID do destino de montagem, e fs-id é o FileSystemId.

  • Define a propriedade requesterManaged da interface de rede como true, e o valor de requesterId como EFS.

  Cada destino de montagem do Amazon EFS tem uma interface de rede do EC2 gerenciada pelo solicitante correspondente. Depois que a interface de rede é criada, o Amazon EFS define o campo NetworkInterfaceId na descrição do destino de montagem como o ID da interface de rede, e o campo IpAddress 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.

Recomendamos criar um destino de montagem em cada uma das zonas de disponibilidade. Existem considerações de custo ao usar um sistema de arquivos em uma zona de disponibilidade por meio de um destino de montagem criado em outra zona de disponibilidade. Para ter mais informações, consulte Amazon EFS. Além disso, usando sempre destino de montagem local para a zona de disponibilidade da instância, você pode eliminar um cenário de falha parcial. Se a zona de disponibilidade na qual o destino de montagem é criado se tornar inoperante, não será possível acessar o sistema de arquivos por meio desse 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 exige permissões para as seguintes ações no Amazon EC2:

• 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",
   "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: sequência

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

Endereço IPv4 válido dentro do intervalo de endereços da sub-rede especificada.

Tipo: sequência

Restrições de tamanho: tamanho mínimo de 7. Tamanho 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

SecurityGroups

Um máximo de cinco IDs de grupos de segurança da VPC, no formato sg-xxxxxxxx. Esses devem ser da mesma VPC que a sub-rede especificada.

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.

Tipo: sequência

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",
   "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: sequência

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: sequência

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: sequência

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

Endereço no qual o sistema de arquivos pode ser montado usando o destino de montagem.

Tipo: sequência

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

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

LifeCycleState

Estado do ciclo de vida do destino de montagem.

Tipo: sequências

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

MountTargetId

ID do destino de montagem atribuída pelo sistema.

Tipo: sequência

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: sequência

OwnerId

Conta da AWS ID que possui o recurso.

Tipo: sequência

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: sequência

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: sequência

Erros

AvailabilityZonesMismatch

Retornada se a zona de disponibilidade especificada para um destino de montagem for diferente da zona de disponibilidade especificada para armazenamento One Zone. 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 uma IpAddress 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

Retornado se IpAddress não foi especificado na solicitação e não há endereços IP gratuitos na sub-rede.

Código de Status HTTP: 409

SecurityGroupLimitExceeded

Retornado se o tamanho de SecurityGroups especificado na solicitação for maior que cinco.

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

Adicionar um destino de montagem a um sistema de arquivos

A solicitação a seguir cria um destino de montagem para um sistema de arquivos. A solicitação especifica valores somente para os parâmetros necessários FileSystemId e SubnetId. A solicitação não fornece os parâmetros opcionais IpAddress e SecurityGroups. Para IpAddress, a operação usa um dos endereços IP disponíveis na sub-rede especificada. A operação usa o grupo de segurança padrão associado à VPC para o SecurityGroups.

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

{
    "MountTargetId": "fsmt-55a4413c",
    "NetworkInterfaceId": "eni-01234567",
    "FileSystemId": "fs-01234567",
    "LifeCycleState": "available",
    "SubnetId": "subnet-01234567",
    "OwnerId": "231243201240",
    "IpAddress": "172.31.22.183"
}

Adicionar um destino de montagem a um sistema de arquivos

A solicitação a seguir especifica todos os parâmetros da solicitação para criar um 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"
}

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte:

• AWS Command Line Interface

• AWS SDK para .NET

• AWS SDK para C++

• AWS SDK para Go v2

• AWS SDK para Java V2

• AWS SDK para JavaScript V3

• AWS SDK para PHP V3

• AWS SDK para Python

• AWS SDK para Ruby V3