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:

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:

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

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:

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

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.

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.

Erros

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 SDKs específicos de linguagem AWS, consulte: