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 un file system Amazon EFS specifico se viene fornito il file system CreationToken o FileSystemId. Altrimenti, restituisce le descrizioni di tutti i file system di proprietà del chiamante Account AWS nell' Regione AWS endpoint che stai chiamando.
Quando recuperi tutte le descrizioni dei file system, puoi facoltativamente specificare il parametro MaxItems per limitare il numero di descrizioni in una risposta. Questo numero viene impostato automaticamente su 100. Se rimangono altre descrizioni del file system, Amazon EFS restituisce un token NextMarker opaco nella risposta. In questo caso, è necessario inviare una richiesta successiva con il parametro Marker di richiesta impostato sul valore NextMarker.
Per recuperare un elenco delle descrizioni del file system, questa operazione viene utilizzata in un processo iterativo, in cui DescribeFileSystems viene chiamato prima senza Marker, quindi l'operazione continua a chiamare con il parametro Marker impostato sul valore NextMarker della risposta precedente fino a quando la risposta non ha NextMarker.
L'ordine dei file system restituiti nella risposta di una chiamata DescribeFileSystems e l'ordine dei file system restituiti nelle risposte di un'iterazione di più chiamate non è specificato.
Questa operazione richiede le autorizzazioni per l'operazione elasticfilesystem:DescribeFileSystems.
Sintassi della richiesta
GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- CreationToken
-
(Facoltativo) Limita l'elenco al file system con questo token di creazione (String). Quando viene creato un file system Amazon EFS, viene specificato un token.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
.+ - FileSystemId
-
(Facoltativo) ID del file system di cui desideri recuperare la descrizione (String).
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})$ - Marker
-
(Facoltativo) Un token di impaginazione opaco restituito dalla precedente operazione
DescribeFileSystems(String). Se presente, specifica di continuare l'elenco dal punto in cui era stata interrotta la chiamata.Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
.+ - MaxItems
-
(Facoltativo) Specifica il numero (intero) massimo di file system da restituire nella risposta. Questo numero viene impostato automaticamente su 100. La risposta viene impaginata a 100 per pagina se sono presenti più di 100 file system.
Intervallo valido: valore minimo di 1.
Corpo della richiesta
La richiesta non ha un corpo della richiesta.
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"FileSystems": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
],
"Marker": "string",
"NextMarker": "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.
- FileSystems
-
Una serie di descrizioni del file system.
Tipo: matrice di oggetti FileSystemDescription
- Marker
-
Presente se fornito dal chiamante nella richiesta (String).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
.+ - NextMarker
-
Presente se vi sono più file system di quelli restituiti nella risposta (String). È possibile utilizzare
NextMarkerin una richiesta successiva per recuperare ulteriori descrizioni.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
.+
Errori
- 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
FileSystemIdvalore specificato non esiste in quello del richiedente. Account AWSCodice di stato HTTP: 404
- InternalServerError
-
Restituito se si è verificato un errore lato server.
Codice di stato HTTP: 500
Esempi
Recupero di un elenco di 10 file system
L'esempio seguente invia una richiesta GET all'endpoint file-systems (elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems). La richiesta specifica un parametro MaxItems di query per limitare il numero di descrizioni del file system a 10.
Richiesta di esempio
GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191208Z
Authorization: <...>Risposta di esempio
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 499
{
"FileSystems":[
{
"OwnerId":"251839141158",
"CreationToken":"MyFileSystem1",
"FileSystemId":"fs-01234567",
"PerformanceMode" : "generalPurpose",
"CreationTime":"1403301078",
"LifeCycleState":"created",
"Name":"my first file system",
"NumberOfMountTargets":1,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
}
}
]
}Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
