As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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.
Você pode criar um alvo de montagem em cada zona de disponibilidade do seuVPC. Todas as EC2 instâncias 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. EC2as instâncias não precisam estar na mesma sub-rede do destino de montagem para acessar seu 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 AmazonEFS: How it Works.
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:
-
O VPC em que a Amazon EFS cria o alvo de montagem
-
A zona de disponibilidade na qual a Amazon EFS cria a meta de montagem
-
O intervalo de endereços IP a partir do qual a 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 alvo de montagem, a Amazon EFS retorna uma resposta que inclui a MountTargetId
e IpAddress
a. Você usa esse endereço IP ao montar o sistema de arquivos em uma EC2 instância. Você também pode usar o DNS nome 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 DNS nome do destino de montagem em 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 umVPC, e só pode haver 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 às VPC mesmas sub-redes dos destinos 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, a Amazon fará EFS 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
, a Amazon EFS atribuirá esse endereço IP à interface de rede. Caso contrário, a Amazon EFS atribui um endereço gratuito na sub-rede (da mesma forma que a EC2CreateNetworkInterface
chamada da Amazon faz quando uma solicitação não especifica um endereço IP privado primário). -
Se a solicitação fornecer
SecurityGroups
, essa interface de rede será associada a esses grupos de segurança. Caso contrário, ele pertence ao grupo de segurança padrão da sub-rede. VPC -
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 EFS montagem da Amazon tem uma interface de rede correspondente gerenciada pelo solicitanteEC2. Depois que a interface de rede é criada, a Amazon EFS define o
NetworkInterfaceId
campo na descrição do alvo de montagem como o ID da interface de rede e oIpAddress
campo 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 obter 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 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
",
"SecurityGroups": [ "string
" ],
"SubnetId": "string
"
}
URIParâmetros de solicitação
A solicitação não usa nenhum URI parâmetro.
Corpo da Solicitação
A solicitação aceita os seguintes dados no JSON formato.
- 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
-
IPv4Endereço 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
-
Até cinco grupos VPC de segurançaIDs, do formulário
sg-xxxxxxxx
. Eles devem ser iguais VPC aos especificados na 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.
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 de 200.
Os dados a seguir são retornados em JSON formato 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 AWSTipo: 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çãous-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: sequências
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 a Amazon EFS criou quando criou 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
-
A ID da nuvem privada virtual (VPC) na qual 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.
HTTPCódigo de status: 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.
HTTPCódigo de status: 400
- FileSystemNotFound
-
Retornado se o
FileSystemId
valor especificado não existir no valor do Conta da AWS solicitante.HTTPCódigo de status: 404
- IncorrectFileSystemLifeCycleState
-
Retornado se o estado do ciclo de vida do sistema de arquivos não estiver “disponível”.
HTTPCódigo de status: 409
- InternalServerError
-
Retornado se ocorreu um erro no lado do servidor.
HTTPCódigo de status: 500
- IpAddressInUse
-
Retornada se a solicitação especificou uma
IpAddress
que já está em uso na sub-rede.HTTPCódigo de status: 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.
HTTPCódigo de status: 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 VPCCotas da Amazon no Guia VPC do usuário da Amazon (consulte a entrada Interfaces de rede por região na tabela Interfaces de rede).
HTTPCódigo de status: 409
- NoFreeAddressesInSubnet
-
Retornado se
IpAddress
não foi especificado na solicitação e não há endereços IP gratuitos na sub-rede.HTTPCódigo de status: 409
- SecurityGroupLimitExceeded
-
Retornado se o tamanho de
SecurityGroups
especificado na solicitação for maior que cinco.HTTPCódigo de status: 400
- SecurityGroupNotFound
-
Retornado se um dos grupos de segurança especificados não existir na nuvem privada virtual da sub-rede (VPC).
HTTPCódigo de status: 400
- SubnetNotFound
-
Retornado se não houver sub-rede com o ID de
SubnetId
fornecido na solicitação.HTTPCódigo de status: 400
- UnsupportedAvailabilityZone
-
Retornado se a EFS funcionalidade solicitada pela Amazon não estiver disponível na zona de disponibilidade especificada.
HTTPCódigo de status: 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. Além disso, a operação usa o grupo de segurança padrão associado ao VPC para SecurityGroups
o.
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 isso API em um idioma específico AWS SDKs, consulte o seguinte: