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 de Amazon EFS específico siFileSystemId se proporciona el sistema de archivosCreationToken o el. De lo contrario, devuelve las descripciones de todos los sistemas de archivos que sean propiedadRegión de AWS de laCuenta de AWS en la del punto de enlace al que está llamando.

Al recuperar todas las descripciones del sistema de archivos, puede especificar opcionalmente elMaxItems parámetro para limitar el número de descripciones de una respuesta. Este número se establece automáticamente en 100. 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 el parámetro deMarker 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, en el queDescribeFileSystems se llama primero sinMarker y, a continuación, la operación continúa llamándola con elMarker parámetro establecido en el valorNextMarker de la respuesta anterior hasta que la respuesta no tenga ningúnNextMarker.

El orden de los sistemas de archivos devueltos en la respuestaDescribeFileSystems a una llamada y el orden de los sistemas de archivos devueltos en las respuestas de una iteración de llamadas múltiples no está especificado.

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 (cadena). Se crea un token EFS Amazon.

Limitaciones 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 (cadena).

Limitaciones de longitud: longitud máxima 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) Se devolvió un token de paginación opaco de unaDescribeFileSystems operación anterior (cadena). Si está presente, especifica continuar con la lista desde donde se interrumpió la llamada devuelta.

Limitaciones 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 deben devolver en la respuesta (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 de sistemas de archivos.

Tipo: Matriz de objetos FileSystemDescription

Marker

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

Tipo: cadena

Limitaciones 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 que los devueltos en la respuesta (cadena). Puede utilizar laNextMarker en la solicitud subsiguiente para obtener las descripciones de las descripciones de la en la solicitud de la subsiguiente para obtener las descripciones.

Tipo: cadena

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

Patrón: .+

Errores

BadRequest

Se devuelve si la solicitud tiene un formato incorrecto o contiene un error, como un valor de parámetro no válido o un parámetro obligatorio faltante.

Código de estado HTTP: 400

FileSystemNotFound

Se devuelve si elFileSystemId valor especificado no existe en el formulario del solicitanteCuenta de AWS.

Código de estado HTTP: 404

InternalServerError

Se devuelve si se produce un error en el servidor.

Código de estado HTTP: 500

Ejemplos

Recuuna lista de 10 sistemas de archivos una lista de 10 sistemas de archivos

El siguiente ejemplo envía una solicitud GET alfile-systems endpoint (elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems). La solicitud especifica un parámetro deMaxItems consulta para 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: