As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

DescribeFileSystems

Retorna a descrição de um sistema de EFS arquivos específico da Amazon se o sistema de arquivos CreationToken ou o FileSystemId for fornecido. Caso contrário, ele retornará descrições de todos os sistemas de arquivos pertencentes ao chamador Conta da AWS no Região da AWS endpoint que você está chamando.

Ao recuperar todas as descrições do sistema de arquivos, você pode especificar opcionalmente o parâmetro MaxItems para limitar o número de descrições em uma resposta. Esse número é automaticamente definido como 100. Se mais descrições do sistema de arquivos permaneceremNextMarker, a Amazon EFS retornará um token opaco na resposta. Nesse caso, você deve enviar uma solicitação subsequente com o parâmetro de solicitação Marker definido como o valor de NextMarker.

Para recuperar uma lista das descrições do sistema de arquivos, essa operação é usada em um processo iterativo, em que DescribeFileSystems é chamada primeiro sem o Marker e, em seguida, a operação continua a chamá-la com o parâmetro Marker definido como o valor de NextMarker da resposta anterior até que a resposta não tenha NextMarker.

A ordem dos sistemas de arquivos retornados na resposta de uma chamada DescribeFileSystems e a ordem retornada nas respostas de uma iteração de várias chamadas não é especificada.

Essa operação exige permissões para a ação elasticfilesystem:DescribeFileSystems.

Sintaxe da Solicitação

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

URIParâmetros de solicitação

A solicitação usa os seguintes URI parâmetros.

Corpo da Solicitação

Essa solicitação não tem corpo.

Sintaxe da resposta

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 Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.

Os dados a seguir são retornados em JSON formato pelo serviço.

Erros

Exemplos

Recupere uma lista de 10 sistemas de arquivos

O exemplo a seguir envia uma GET solicitação para o file-systems endpoint (elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems). A solicitação especifica um parâmetro de consulta MaxItems para limitar o número de descrições do sistema de arquivos a 10.

Exemplo de solicitação

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

Resposta da amostra

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
         }
      }
   ]
}

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: