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. Um sistema de arquivos pode ter até 10 mil pontos de acesso, a menos que você solicite um aumento. Para saber mais, consulte [Montar um sistema de arquivos usando pontos de acesso do EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html). **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 de 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](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html). ## 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](#API_CreateAccessPoint_RequestSyntax) ** Uma sequência de até 64 caracteres ASCII que o Amazon EFS usa para garantir a criação idempotente. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64. Padrão: `.+` Obrigatório: Sim ** [FileSystemId](#API_CreateAccessPoint_RequestSyntax) ** O ID do sistema de arquivos do EFS 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})$` Obrigatório: Sim ** [PosixUser](#API_CreateAccessPoint_RequestSyntax) ** 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](API_PosixUser.md) Obrigatório: não ** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) ** 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](API_RootDirectory.md) Obrigatório: não ** [Tags](#API_CreateAccessPoint_RequestSyntax) ** 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](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) no *Guia de referência AWS geral*. Tipo: matriz de objetos [Tag](API_Tag.md) 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](#API_CreateAccessPoint_ResponseSyntax) ** O nome do recurso 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](#API_CreateAccessPoint_ResponseSyntax) ** O ID do ponto de acesso, atribuído pelo Amazon EFS. 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](#API_CreateAccessPoint_ResponseSyntax) ** A string opaca especificada na solicitação para garantir a criação idempotente. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64. Padrão: `.+` ** [FileSystemId](#API_CreateAccessPoint_ResponseSyntax) ** O ID do sistema de arquivos do EFS 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](#API_CreateAccessPoint_ResponseSyntax) ** Identifica a fase do ciclo de vida do ponto de acesso. Tipo: string Valores válidos: `creating | available | updating | deleting | deleted | error` ** [Name](#API_CreateAccessPoint_ResponseSyntax) ** O nome deste ponto de acesso. Esse é o valor da tag `Name`. Tipo: string ** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) ** 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](#API_CreateAccessPoint_ResponseSyntax) ** A identidade POSIX completa, incluindo o ID do usuário, o ID do grupo e o grupo secundário IDs no ponto de acesso que é usado para todas as operações de arquivo pelos clientes NFS que usam o ponto de acesso. Tipo: objeto [PosixUser](API_PosixUser.md) ** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) ** 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](API_RootDirectory.md) ** [Tags](#API_CreateAccessPoint_ResponseSyntax) ** As tags associadas ao ponto de acesso, apresentadas como uma matriz de objetos de tag. Tipo: matriz de objetos [Tag](API_Tag.md) ## 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. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. 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](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. 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. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de status HTTP: 400 ** FileSystemNotFound ** Retornado se o `FileSystemId` valor especificado não existir no valor do Conta da AWS solicitante. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de status HTTP: 404 ** IncorrectFileSystemLifeCycleState ** Retornado se o estado do ciclo de vida do sistema de arquivos não estiver “disponível”. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de Status HTTP: 409 ** InternalServerError ** Retornado se ocorreu um erro no lado do servidor. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. 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](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de status HTTP: 429 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint)