DescribeAccessPoints - Amazon Elastic File System
Sintassi della richiestaParametri della richiesta URICorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

DescribeAccessPoints

Restituisce la descrizione di un punto di accesso Amazon EFS specifico, se AccessPointId viene fornito. Se si fornisce un EFS FileSystemId, restituisce le descrizioni di tutti i punti di accesso per quel file system. È possibile fornire un AccessPointId o un FileSystemId nella richiesta, ma non entrambi.

Questa operazione richiede le autorizzazioni per l'operazione elasticfilesystem:DescribeAccessPoints.

Sintassi della richiesta

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

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

AccessPointId

(Facoltativo) Specifica un punto di accesso EFS da descrivere nella risposta; si esclude a vicenda con FileSystemId.

Limitazioni di lunghezza: lunghezza massima di 128.

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

FileSystemId

(Facoltativo) Se si fornisce un FileSystemId, EFS restituisce tutti i punti di accesso per quel file system; si esclude a vicenda con AccessPointId.

Limitazioni di lunghezza: lunghezza massima di 128.

Modello: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

MaxResults

(Facoltativo) Quando recuperi tutti i punti di accesso per un file system, puoi facoltativamente specificare il parametro MaxItems per limitare il numero di oggetti restituiti in una risposta. Il valore predefinito è 100.

Intervallo valido: valore minimo di 1.

NextToken

NextToken è presente se la risposta è impaginata. È possibile utilizzare NextMarker in una richiesta successiva per recuperare la pagina successiva di descrizioni dei punti di accesso.

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.

Modello: .+

Corpo della richiesta

La richiesta non ha un corpo della richiesta.

Sintassi della risposta

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"
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

AccessPoints

Una serie di descrizioni dei punti di accesso.

Tipo: matrice di oggetti AccessPointDescription

NextToken

Presente se ci sono più punti di accesso di quelli restituiti nella risposta. È possibile utilizzare il NextMarker nella richiesta successiva per recuperare le descrizioni aggiuntive.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.

Modello: .+

Errori

AccessPointNotFound

Restituito se il AccessPointId valore specificato non esiste nel richiedente. Account AWS

Codice di stato HTTP: 404

BadRequest

Restituito se la richiesta non è valida o contiene un errore, ad esempio un valore di parametro non valido o un parametro obbligatorio mancante.

Codice di stato HTTP: 400

FileSystemNotFound

Restituito se il FileSystemId valore specificato non esiste in quello del richiedente. Account AWS

Codice di stato HTTP: 404

InternalServerError

Restituito se si è verificato un errore lato server.

Codice di stato HTTP: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: