DescribeFileSystems - Amazon Elastic File System

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

DescribeFileSystems

Devuelve la descripción de un sistema de archivos Amazon EFS específico si el sistema de archivosCreationTokeno elFileSystemIdse encuentra. De lo contrario, devuelve las descripciones de todos los sistemas de archivos que sean propiedad delCuenta de AWSen laRegión de AWSdel punto de enlace al que está llamando.

Al recuperar todas las descripciones del sistema de archivos, puede especificar si lo desea elMaxItemspara limitar el número de descripciones de una respuesta. Actualmente, este número se establece automáticamente en 10. Si quedan más descripciones del sistema de archivos, Amazon EFS devuelve unNextMarker, un token opaco, en la respuesta. En este caso, debe enviar una solicitud posterior con elMarkerparámetro de solicitud establecido en el valor deNextMarker.

Para recuperar una lista de las descripciones del sistema de archivos, esta operación se utiliza en un proceso iterativo, dondeDescribeFileSystemsse llama primero sin elMarkery luego la operación continúa llamándola con elMarkerparámetro establecido en el valor de laNextMarkerdesde la respuesta anterior hasta que la respuesta no tengaNextMarker.

El orden de los sistemas de archivos devuelto en respuesta de unoDescribeFileSystemsy no se ha especificado el orden de los sistemas de archivos devuelto en las respuestas de una iteración de varias llamadas.

Esta operación necesita permisos para la acción elasticfilesystem:DescribeFileSystems.

Sintaxis de la solicitud

GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

CreationToken

(Opcional) Restringe la lista al sistema de archivos con este token de creación (String). Especifique un token de creación al crear un sistema de archivos de Amazon EFS.

Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.

Patrón: .+

FileSystemId

(Opcional) ID del sistema de archivos cuya descripción desea recuperar (String).

Restricciones de longitud: La longitud máxima es de 128 caracteres.

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

Marker

(Opcional) Token de paginación opaco devuelto de un anteriorDescribeFileSystemsoperation (String). Si está presente, especifica que se continuará la lista desde la que se ha dejado la llamada devuelta.

Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 128 caracteres.

Patrón: .+

MaxItems

(Opcional) Especifica el número máximo de sistemas de archivos que se devuelven en la respuesta (número entero). Este número se establece automáticamente en 100. La respuesta se pagina a 100 por página si tiene más de 100 sistemas de archivos.

Rango válido: Valor mínimo de 1.

Cuerpo de la solicitud

La solicitud no tiene un cuerpo de la solicitud.

Sintaxis de la respuesta

HTTP/1.1 200 Content-type: application/json { "FileSystems": [ { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "CreationTime": number, "CreationToken": "string", "Encrypted": boolean, "FileSystemArn": "string", "FileSystemId": "string", "KmsKeyId": "string", "LifeCycleState": "string", "Name": "string", "NumberOfMountTargets": number, "OwnerId": "string", "PerformanceMode": "string", "ProvisionedThroughputInMibps": number, "SizeInBytes": { "Timestamp": number, "Value": number, "ValueInIA": number, "ValueInStandard": number }, "Tags": [ { "Key": "string", "Value": "string" } ], "ThroughputMode": "string" } ], "Marker": "string", "NextMarker": "string" }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

FileSystems

Una serie de descripciones del sistema de archivos.

Type: Matriz deFileSystemDescriptionobjects

Marker

Presente si la persona que llama lo proporciona en la solicitud (String).

Type: Cadena

Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 128 caracteres.

Patrón: .+

NextMarker

Presente si hay más sistemas de archivos de los devueltos en la respuesta (String). Puede utilizar elNextMarkeren la solicitud posterior para obtener las descripciones.

Type: Cadena

Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 128 caracteres.

Patrón: .+

Errors

BadRequest

Se devuelve si la solicitud está mal formada o contiene un error, como un valor de parámetro no válido o un parámetro obligatorio que falta.

Código de estado HTTP: 400

FileSystemNotFound

Devuelto si el especificadoFileSystemIdEl valor no existe en elCuenta de AWS.

Código de estado HTTP: 404

InternalServerError

Se devuelve si se ha producido un error en el lado del servidor.

Código de estado HTTP: 500

Examples

Recupere una lista de 10 sistemas de archivos

En el siguiente ejemplo se envía una solicitud GET alfile-systemsPunto de enlace (elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems). La solicitud especifica unMaxItemspara limitar el número de descripciones del sistema de archivos a 10.

Solicitud de muestra

GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T191208Z Authorization: <...>

Respuesta de ejemplo

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": 29313417216, "ValueInIA": 675432, "ValueInStandard": 29312741784 } } ] }

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: