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 deCreateNetworkInterface
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 quefsmt-id
é o ID do destino de montagem, efs-id
é oFileSystemId
. -
Define a propriedade
requesterManaged
da interface de rede comotrue
, e o valor derequesterId
comoEFS
.
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 campoIpAddress
como seu endereço. Se a criação da interface de rede falhar, toda a operaçãoCreateMountTarget
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
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: 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
-
Endereço IPv4 válido dentro do intervalo de endereços da sub-rede especificada.
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
- 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: 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",
"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
é um ID de AZ para a região us-east-1 e tem o mesmo local em cada conta da 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 independentemente de nomes para cada Conta da AWS. Por exemplo, a zona de disponibilidade da
us-east-1a
para sua Conta da AWS pode não ter o mesmo local físico que aus-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
-
Endereço no qual o sistema de arquivos pode ser montado usando o destino 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}$
- LifeCycleState
-
Estado do ciclo de vida do destino de montagem.
Tipo: string
Valores Válidos:
creating | available | updating | deleting | deleted | error
- 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
-
ID da Conta da AWS 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
-
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 valor especificado de
FileSystemId
não existir na 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 SDKs específicos de linguagem AWS, consulte: