CreateAccessPoint - Amazon Elastic File System
Sintaxe da SolicitaçãoParâmetros da solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

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á.

CreateAccessPoint

Criar um ponto de acesso do EFS Um ponto de acesso é uma visualização específica da aplicação em um sistema de arquivos do EFS que aplica um usuário e grupo do sistema operacional, e um caminho do sistema de arquivos, a qualquer solicitação do sistema de arquivos feita por meio do ponto de acesso. O usuário e o grupo do sistema operacional substituem qualquer informação de identidade fornecida pelo cliente NFS. O caminho do sistema de arquivos é exposto como o diretório raiz do ponto de acesso. Os aplicativos que usam o ponto de acesso só podem acessar dados no próprio diretório do aplicativo e em quaisquer subdiretórios. Para saber mais, consulte Montar um sistema de arquivos usando pontos de acesso do EFS.

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 1.000 pontos de acesso, você poderá enfrentar um controle de utilização para essas solicitações. Isso é para garantir que o sistema de arquivos não exceda o limite de pontos de acesso declarado.

Essa operação exige permissões para a ação elasticfilesystem:CreateAccessPoint.

Os pontos de acesso podem ser marcados na criação. Se tags forem especificadas na ação de criação, o IAM realizará autorização adicional na ação elasticfilesystem:TagResource para verificar se os usuários têm permissões para criar tags. Portanto, os usuários também precisam ter permissões para usar a ação elasticfilesystem:TagResource. Para obter mais informações, consulte Conceder permissões para marcar recursos durante a criação.

Sintaxe da Solicitação

POST /2015-02-01/access-points HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "FileSystemId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "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.

ClientToken

Uma sequência de até 64 caracteres ASCII que o Amazon EFS usa para garantir a criação idempotente.

Tipo: sequência

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.

Padrão: .+

Exigido: Sim

FileSystemId

O ID do sistema de arquivos do EFS ao qual o ponto de acesso se aplica.

Tipo: sequência

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

PosixUser

O usuário e o grupo do sistema operacional se aplicaram a todas as solicitações do sistema de arquivos feitas usando o ponto de acesso.

Tipo: objeto PosixUser

Obrigatório: Não

RootDirectory

Especifica o diretório no sistema de arquivos do EFS que o ponto de acesso expõe como o diretório raiz do seu sistema de arquivos para clientes NFS que usam o ponto de acesso. Os clientes que usam o ponto de acesso só podem acessar o diretório raiz e abaixo dele. Se o RootDirectory > Path especificado não existir, o Amazon EFS o criará usando as configurações CreationInfo quando um cliente se conectar a um ponto de acesso. Ao especificar um RootDirectory, você deve fornecer o Path e o CreationInfo.

O Amazon EFS cria um diretório raiz somente se você tiver fornecido CreationInfo: OwnUid, ownGid e permissões para o diretório. Se você não fornecer essas informações, o Amazon EFS não criará o diretório raiz. Se o diretório raiz não existir, as tentativas de montar usando o ponto de acesso apresentarão falha.

Tipo: objeto RootDirectory

Obrigatório: Não

Tags

Cria etiquetas associadas ao ponto de acesso. Cada tag é um par de valores-chave, cada chave deve ser única. Para obter mais informações, consulte AWS Recursos de marcação no Guia de referência AWS geral.

Tipo: matriz de objetos Tag

Obrigatório: Não

Sintaxe da Resposta

HTTP/1.1 200
Content-type: application/json

{
   "AccessPointArn": "string",
   "AccessPointId": "string",
   "ClientToken": "string",
   "FileSystemId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "OwnerId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "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.

AccessPointArn

O nome do recurso da Amazon (ARN) associado ao ponto de acesso.

Tipo: sequência

Restrições de tamanho: tamanho máximo de 128.

Padrão: ^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$

AccessPointId

O ID do ponto de acesso, atribuído pelo Amazon EFS.

Tipo: sequência

Restrições de tamanho: tamanho máximo de 128.

Padrão: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$

ClientToken

A string opaca especificada na solicitação para garantir a criação idempotente.

Tipo: sequência

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.

Padrão: .+

FileSystemId

O ID do sistema de arquivos do EFS ao qual o ponto de acesso se aplica.

Tipo: sequência

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})$

LifeCycleState

Identifica a fase do ciclo de vida do ponto de acesso.

Tipo: sequências

Valores Válidos: creating | available | updating | deleting | deleted | error

Name

O nome deste ponto de acesso. Esse é o valor da tag Name.

Tipo: sequência

OwnerId

Identifica quem é proprietário do recurso de ponto de acesso. Conta da AWS

Tipo: sequência

Restrições de tamanho: tamanho máximo de 14.

Padrão: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

PosixUser

A identidade POSIX completa, incluindo o ID de usuário, o ID de grupo e os IDs de grupo secundários no ponto de acesso, que é usada para todas as operações de arquivo por clientes NFS que utilizam o ponto de acesso.

Tipo: objeto PosixUser

RootDirectory

O diretório no sistema de arquivos do EFS que o ponto de acesso expõe como o diretório raiz para clientes NFS que usam o ponto de acesso.

Tipo: objeto RootDirectory

Tags

As tags associadas ao ponto de acesso, apresentadas como uma matriz de objetos de tag.

Tipo: matriz de objetos Tag

Erros

AccessPointAlreadyExists

Retornado se o ponto de acesso que você está tentando criar já existir, com o token de criação fornecido na solicitação.

Código de Status HTTP: 409

AccessPointLimitExceeded

Retornado se o já Conta da AWS tiver criado o número máximo de pontos de acesso permitidos por sistema de arquivos. Para obter informações, consulte https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region.

Código de Status HTTP: 403

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 FileSystemId valor especificado não existir no valor do 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

ThrottlingException

Retornado quando a ação CreateAccessPoint da API é chamada muito rapidamente e o número de pontos de acesso no sistema de arquivos está próximo do limite de 120.

Código de status HTTP: 429

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: