DescribeAccessPoints - Amazon Elastic File System
Sintaxe da SolicitaçãoURIParâmetros de solicitaçãoCorpo 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á.

DescribeAccessPoints

Retorna a descrição de um ponto de EFS acesso específico da Amazon, se AccessPointId for fornecido. Se você fornecer um EFSFileSystemId, ele retornará as descrições de todos os pontos de acesso desse sistema de arquivos. Você pode fornecer um AccessPointId ou um FileSystemId na solicitação, mas não ambos.

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

Sintaxe da Solicitação

GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

URIParâmetros de solicitação

A solicitação usa os seguintes URI parâmetros.

AccessPointId

(Opcional) Especifica um ponto de EFS acesso a ser descrito na resposta; mutuamente exclusivo com. FileSystemId

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

FileSystemId

(Opcional) Se você fornecer umFileSystemId, EFS retornará todos os pontos de acesso desse sistema de arquivos; mutuamente exclusivos comAccessPointId.

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

MaxResults

(Opcional) Ao recuperar todos os pontos de acesso de um sistema de arquivos, você pode especificar opcionalmente o parâmetro MaxItems para limitar o número de objetos retornados em uma resposta. O valor padrão é 100.

Faixa válida: valor mínimo de 1.

NextToken

O NextToken estará presente se a resposta for paginada. Você pode usar o NextMarker na solicitação subsequente para buscar a próxima página de descrições de ponto de acesso.

Restrições de comprimento: tamanho mínimo de 1. O tamanho máximo é 128.

Padrão: .+

Corpo da Solicitação

Essa solicitação não tem corpo.

Sintaxe da resposta

HTTP/1.1 200
Content-type: application/json

{
   "AccessPoints": [ 
      { 
         "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"
            }
         ]
      }
   ],
   "NextToken": "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.

AccessPoints

Uma matriz de descrições de pontos de acesso.

Tipo: matriz de objetos AccessPointDescription

NextToken

Presente se houver mais pontos de acesso do que os retornados na resposta. Você pode usar o NextMarker na solicitação subsequente para buscar as descrições adicionais.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.

Padrão: .+

Erros

AccessPointNotFound

Retornado se o AccessPointId valor especificado não existir no valor do Conta da AWS solicitante.

HTTPCódigo de status: 404

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

InternalServerError

Retornado se ocorreu um erro no lado do servidor.

HTTPCódigo de status: 500

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: