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
Cria um ponto de EFS acesso. Um ponto de acesso é uma visão específica do aplicativo em um sistema de EFS arquivos 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 todas as informações de identidade fornecidas pelo NFS cliente. 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 Montando um sistema de arquivos usando pontos de EFS acesso.
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 as tags forem especificadas na ação de criação, IAM executará uma autorização adicional na elasticfilesystem:TagResource ação 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"
}
]
}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.
- ClientToken
-
Uma sequência de até 64 ASCII caracteres que a Amazon EFS usa para garantir a criação idempotente.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.
Padrão:
.+Exigido: Sim
- FileSystemId
-
O ID do sistema de EFS arquivos ao qual o ponto de acesso fornece acesso.
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
- 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 EFS arquivos que o ponto de acesso expõe como o diretório raiz do seu sistema de arquivos para NFS clientes 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>Pathespecificado não existir, a Amazon o EFS cria e aplica asCreationInfoconfigurações quando um cliente se conecta a um ponto de acesso. Ao especificar umRootDirectory, você deve fornecer oPathe oCreationInfo.EFSA Amazon cria um diretório raiz somente se você tiver fornecido as permissões CreationInfo: OwnUidGID, Próprio e para o diretório. Se você não fornecer essas informações, a 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 de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
- AccessPointArn
-
O nome de recurso exclusivo da Amazon (ARN) associado ao ponto de acesso.
Tipo: string
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 pela AmazonEFS.
Tipo: string
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: string
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.
Padrão:
.+ - FileSystemId
-
O ID do sistema de EFS arquivos ao qual o ponto de acesso se aplica.
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})$ - 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: string
- OwnerId
-
Identifica quem é proprietário do recurso de ponto de acesso. Conta da AWS
Tipo: string
Restrições de tamanho: tamanho máximo de 14.
Padrão:
^(\d{12})|(\d{4}-\d{4}-\d{4})$ - PosixUser
-
A POSIX identidade completa, incluindo a ID do usuário, a ID do grupo e o grupo secundário IDs no ponto de acesso que é usado para todas as operações de arquivo pelos NFS clientes que usam o ponto de acesso.
Tipo: objeto PosixUser
- RootDirectory
-
O diretório no sistema de EFS arquivos que o ponto de acesso expõe como diretório raiz para NFS clientes 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.
HTTPCódigo de status: 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.
HTTPCódigo de status: 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.
HTTPCódigo de status: 400
- FileSystemNotFound
-
Retornado se o
FileSystemIdvalor 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
- ThrottlingException
-
Retornado quando a
CreateAccessPointAPI ação é chamada muito rapidamente e o número de pontos de acesso no sistema de arquivos está próximo do limite de 120.HTTPCódigo de status: 429
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte:
