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à.
Restituisce la descrizione di uno specifico punto di EFS accesso Amazon, se fornito. AccessPointId Se ne fornisci uno EFSFileSystemId, 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
URIParametri della richiesta
La richiesta utilizza i seguenti URI parametri.
- AccessPointId
-
(Facoltativo) Specifica un punto di EFS accesso da descrivere nella risposta; si esclude a vicenda con.
FileSystemIdLimitazioni 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 escludono a vicenda con.AccessPointIdLimitazioni 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
MaxItemsper 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 utilizzareNextMarkerin 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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal 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
AccessPointIdvalore specificato non esiste nel richiedente. Account AWSHTTPCodice di stato: 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.
HTTPCodice di stato: 400
- FileSystemNotFound
-
Restituito se il
FileSystemIdvalore specificato non esiste in quello del richiedente. Account AWSHTTPCodice di stato: 404
- InternalServerError
-
Restituito se si è verificato un errore lato server.
HTTPCodice di stato: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
