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á.
Retorna a descrição de um ponto de acesso específico do Amazon EFS, se o AccessPointId for fornecido. Se você fornecer um FileSystemId do EFS, ele retornará 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
Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- AccessPointId
-
(Opcional) Especifica um ponto de acesso EFS 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 um
FileSystemId, o 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
MaxItemspara 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
NextTokenestará presente se a resposta for paginada. Você pode usar oNextMarkerna solicitação subsequente para buscar a próxima página de descrições de ponto de acesso.Restrições de Tamanho: Tamanho mínimo 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 200.
Os dados a seguir são retornados no formato JSON 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
AccessPointIdvalor especificado não existir no valor do Conta da AWS solicitante.Código de status HTTP: 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.
Código de status HTTP: 400
- FileSystemNotFound
-
Retornado se o
FileSystemIdvalor especificado não existir no valor do Conta da AWS solicitante.Código de status HTTP: 404
- InternalServerError
-
Retornado se ocorreu um erro no lado do servidor.
Código de status HTTP: 500
Consulte também
Para obter mais informações sobre como usar essa API em uma linguagem específica AWS SDKs, consulte o seguinte:
