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 arquivos específico do Amazon EFS 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 permanecerem, o Amazon EFS retornará um `NextMarker`, 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 ``` ## Parâmetros da Solicitação de URI A solicitação usa os seguintes parâmetros de URI: ** [CreationToken](#API_DescribeFileSystems_RequestSyntax) ** (Opcional) Restringe a lista ao sistema de arquivos com esse token de criação (String). Você especifica um token de criação ao criar um sistema de arquivos do Amazon EFS. Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64. Padrão: `.+` ** [FileSystemId](#API_DescribeFileSystems_RequestSyntax) ** (Opcional) ID do sistema de arquivos cuja descrição você deseja recuperar (String). Restrições de Tamanho: Tamanho máximo de 128. Padrão: `^(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) ** (Opcional) Token de paginação opaco retornado de uma `DescribeFileSystems` operação anterior (String). Se presente, especifica a continuação da lista de onde a chamada retornada foi interrompida. Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128. Padrão: `.+` ** [MaxItems](#API_DescribeFileSystems_RequestSyntax) ** (Opcional) Especifica o número máximo de sistemas de arquivos a serem retornados na resposta (inteiro). Esse número é automaticamente definido como 100. A resposta é paginada em 100 por página se você tiver mais de 100 sistemas de arquivos. Faixa válida: valor mínimo de 1. ## 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 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [FileSystems](#API_DescribeFileSystems_ResponseSyntax) ** Uma matriz de descrições do sistema de arquivos. Tipo: matriz de objetos [FileSystemDescription](API_FileSystemDescription.md) ** [Marker](#API_DescribeFileSystems_ResponseSyntax) ** Presente se fornecido pelo chamador na solicitação (String). Tipo: string Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128. Padrão: `.+` ** [NextMarker](#API_DescribeFileSystems_ResponseSyntax) ** Presente se houver mais sistemas de arquivos do que os retornados na resposta (String). Você pode usar o `NextMarker` na solicitação subsequente para buscar as descrições. Tipo: string Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128. Padrão: `.+` ## Erros ** BadRequest ** Retornado se a solicitação estiver malformada ou contiver um erro, como um valor de parâmetro inválido ou um parâmetro obrigatório ausente. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de status HTTP: 400 ** FileSystemNotFound ** Retornado se o `FileSystemId` valor especificado não existir no valor do Conta da AWS solicitante. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de status HTTP: 404 ** InternalServerError ** Retornado se ocorreu um erro no lado do servidor. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de status HTTP: 500 ## Exemplos ### Recupere uma lista de 10 sistemas de arquivos O exemplo a seguir envia uma solicitação GET para o endpoint do `file-systems` (`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 essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystems)