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 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](#API_DescribeFileSystems_RequestSyntax) ** (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](#API_DescribeFileSystems_RequestSyntax) ** (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](#API_DescribeFileSystems_RequestSyntax) ** (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](#API_DescribeFileSystems_RequestSyntax) ** (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](#API_DescribeFileSystems_ResponseSyntax) ** Una serie di descrizioni del file system. Tipo: matrice di oggetti [FileSystemDescription](API_FileSystemDescription.md) ** [Marker](#API_DescribeFileSystems_ResponseSyntax) ** Presente se fornito dal chiamante nella richiesta (String). Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri. Modello: `.+` ** [NextMarker](#API_DescribeFileSystems_ResponseSyntax) ** Presente se vi sono più file system di quelli restituiti nella risposta (String). È possibile utilizzare `NextMarker` in una richiesta successiva per recuperare ulteriori descrizioni. Tipo: String 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. ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 400 ** FileSystemNotFound ** Restituito se il `FileSystemId` valore specificato non esiste in quello del richiedente. Account AWS ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 404 ** InternalServerError ** Restituito se si è verificato un errore lato server. ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. 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: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystems)