Criar pontos de acesso - 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á.

Criar pontos de acesso

Você pode criar e excluir pontos de acesso do Amazon EFS usando o AWS Management Console, o AWS Command Line Interface (AWS CLI) e a API do Amazon EFS SDKs e. Você não pode modificar um ponto de acesso depois de criado. Um sistema de arquivos pode ter no máximo 10.000 pontos de acesso, a menos que você solicite um aumento.

nota

Se várias solicitações para criar pontos de acesso no mesmo sistema de arquivos forem enviadas em rápida sucessão e o sistema de arquivos estiver próximo do limite de pontos de acesso, você poderá enfrentar uma resposta limitada para essas solicitações. Isso é para garantir que o sistema de arquivos não exceda a cota de ponto de acesso declarada.

Para obter mais informações sobre os pontos de acesso do EFS, consulte Trabalhar com pontos de acesso.

  1. Abra o console do Amazon Elastic File System em https://console.aws.amazon.com/efs/.

  2. Escolha Pontos de acesso para abrir a janela Pontos de acesso.

  3. Na página Pontos de acesso, escolha Criar ponto de acesso.

    Você também pode abrir a página Criar ponto de acesso escolhendo Sistemas de arquivos. Escolha um Nome ou ID do sistema de arquivos e Pontos de acesso e Criar ponto de acesso para criar um ponto de acesso para esse sistema de arquivos.

    1. Insira as informações a seguir no painel Detalhes:

      • Sistema de arquivos: insira um nome ou ID do sistema de arquivos e escolha o arquivo correspondente. Você também pode escolher o sistema de arquivos na lista que aparece quando você escolhe o campo de entrada.

      • (Opcional) Nome: insira um nome para o ponto de acesso.

      • (Opcional) Caminho do diretório raiz: você pode especificar um diretório raiz para o ponto de acesso. A raiz padrão do ponto de acesso é /. Para inserir um caminho do diretório raiz, use o formato /foo/bar. Para obter mais informações, consulte Impor um diretório raiz com um ponto de acesso.

    2. (Opcional) No painel do Usuário POSIX, você pode especificar a identidade POSIX completa a ser usada para impor informações de usuários e grupos para todas as operações de arquivo por clientes NFS que estão usando o ponto de acesso. Para obter mais informações, consulte Impor uma identidade de usuário usando um ponto de acesso.

      • ID do usuário: insira um ID numérico POSIX para o usuário.

      • ID do grupo: insira um ID numérico POSIX para o grupo.

      • Grupo secundário IDs — Insira uma lista opcional separada por vírgulas do grupo secundário. IDs

    3. (Opcional) Para Permissões de criação do diretório raiz, você pode especificar as permissões a serem usadas quando o Amazon EFS criar o caminho do diretório raiz, se especificado, e o diretório raiz ainda não existir. Para obter mais informações, consulte Impor um diretório raiz com um ponto de acesso.

      nota

      Se você não especificar nenhuma propriedade e permissão do diretório raiz e o diretório raiz ainda não existir, o EFS não criará o diretório raiz. Qualquer tentativa de montar o sistema de arquivos usando o ponto de acesso apresentará falha.

      • ID do usuário do proprietário: insira um ID numérico POSIX para o proprietário do diretório raiz.

      • ID do grupo do proprietário: insira um ID numérico POSIX para o grupo proprietário do diretório raiz.

      • Permissões: insira o modo Unix do diretório. Uma configuração comum é 755. Verifique se o bit de execução está definido para o usuário do ponto de acesso para que ele possa montar.

  4. Escolha Criar ponto de acesso para criar o ponto de acesso usando essa configuração.

No exemplo a seguir, o comando create-access-point da CLI cria um ponto de acesso para o sistema de arquivos EFS. O comando de API equivalente é CreateAccessPoint.

aws efs create-access-point --file-system-id fs-abcdef0123456789a --client-token 010102020-3 \
--root-directory “Path=/efs/mobileapp/east,CreationInfo={OwnerUid=0,OwnerGid=11,Permissions=775}” \
--posix-user “Uid=22,Gid=4” \
--tags Key=Name,Value=east-users

Se a solicitação for bem-sucedida, a CLI responderá com a descrição do ponto de acesso.

{
    "ClientToken": "010102020-3",
    "Name": "east-users",
    "AccessPointId": "fsap-abcd1234ef5678901",
    "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111122223333:access-point/fsap-abcd1234ef5678901",
    "FileSystemId": "fs-01234567",
    "LifeCycleState": "creating",
    "OwnerId": "111122223333",
    "PosixUser": { 
      "Gid": 4,
      "Uid": 22
    },
    "RootDirectory": {
    "CreationInfo": { 
         "OwnerGid": 0,
         "OwnerUid": 11,
         "Permissions": "775"
      },
        "Path": "/efs/mobileapp/east",        
    },
    "Tags": []
}
nota

Se várias solicitações para criar pontos de acesso no mesmo sistema de arquivos forem enviadas em rápida sucessão e o sistema de arquivos estiver próximo do limite de pontos de acesso, você poderá enfrentar uma resposta limitada para essas solicitações. Isso é para garantir que o sistema de arquivos não exceda a cota de ponto de acesso declarada.