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à.

DescribeFileSystems

Restituisce la descrizione di uno specifico EFS file system Amazon, se FileSystemId viene fornito il file system CreationToken o il. 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 NextMarker token 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

URIParametri della richiesta

La richiesta utilizza i seguenti URI parametri.

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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

Errori

Esempi

Recupero di un elenco di 10 file system

L'esempio seguente invia una GET richiesta all'file-systemsendpoint (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 opzione API in una delle lingue specifiche AWS SDKs, consulta quanto segue: