CreateMountTarget - Amazon Elastic File System

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 umIpAddress, 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 EC2 CreateNetworkInterface 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 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 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 o IpAddress campo 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 obter 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 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áriosg-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 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

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: