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 EFS archivos de Amazon específico si FileSystemId se proporciona el sistema de archivos CreationToken o el. De lo contrario, devuelve descripciones de todos los sistemas de archivos propiedad Región de AWS de la persona que llama Cuenta de AWS en el punto final al que llamas.

Al recuperar todas las descripciones de los sistemas de archivos, si lo desea, puede especificar el parámetro MaxItems para limitar el número de descripciones en una respuesta. Este número se establece automáticamente en 100. Si quedan más descripciones del sistema de archivos, Amazon EFS devuelve un NextMarker token opaco en la respuesta. En este caso, debe enviar una solicitud posterior con el parámetro de solicitud Marker establecido en el valor de NextMarker.

Para recuperar una lista de las descripciones del sistema de archivos, esta operación se utiliza en un proceso iterativo, en el que DescribeFileSystems se llama primero sin el Marker y, a continuación, la operación continúa llamándola con el parámetro Marker establecido en el valor de NextMarker de la respuesta anterior hasta que la respuesta no tenga ningún NextMarker.

El orden de los sistemas de archivos devueltos en la respuesta a una llamada a DescribeFileSystems y el orden de los sistemas de archivos devueltos en las respuestas de una iteración de varias llamadas no están especificados.

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

URIParámetros de la solicitud

La solicitud utiliza los siguientes URI parámetros.

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",
         "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"
}

Elementos de respuesta

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

El servicio devuelve los siguientes datos en JSON formato.

Errores

Ejemplos

Recupere una lista de 10 sistemas de archivos

El siguiente ejemplo envía una GET solicitud al file-systems punto final (elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems). La solicitud especifica un parámetro de consulta MaxItems 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": 29313618372,
            "ValueInArchive": 201156,
            "ValueInIA": 675432,
            "ValueInStandard": 29312741784
         }
      }
   ]
}

Véase también

Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: