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á. # DescribeMountTargets Retorna as descrições de todos os destinos de montagem atuais ou de um determinado destino de montagem de um sistema de arquivos. Ao solicitar todos os destinos de montagem atuais, a ordem dos destinos de montagem retornados na resposta não é especificada. Essa operação requer permissões para a ação `elasticfilesystem:DescribeMountTargets` no ID do sistema de arquivos especificado em `FileSystemId` ou no sistema de arquivos do destino de montagem especificado em `MountTargetId`. O comando CLI correspondente é `describe-mount-targets`. ## Sintaxe da Solicitação ``` GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1 ``` ## Parâmetros da Solicitação de URI A solicitação usa os seguintes parâmetros de URI: ** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) ** (Opcional) O ID do ponto de acesso cujos destinos de montagem você deseja listar. Ele deve ser incluído em sua solicitação se um `FileSystemId` ou `MountTargetId` não estiver incluído em sua solicitação. Aceita um ID de ponto de acesso ou ARN como entrada. Restrições de Tamanho: Tamanho máximo de 128. Padrão: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` ** [FileSystemId](#API_DescribeMountTargets_RequestSyntax) ** (Opcional) ID do sistema de arquivos cujos destinos de montagem você deseja listar (String). Ele deve ser incluído em sua solicitação, se `AccessPointId` ou `MountTargetId` não forem incluídos. Aceita um ID de sistema de arquivos ou ARN como entrada. 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_DescribeMountTargets_RequestSyntax) ** (Opcional) Token de paginação opaco retornado de uma operação `DescribeMountTargets` anterior (String). Se presente, ele especifica continuar a lista de onde a chamada retornada anterior parou. Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128. Padrão: `.+` ** [MaxItems](#API_DescribeMountTargets_RequestSyntax) ** (Opcional) O número máximo de destinos de montagem a ser retornado na resposta. Atualmente, esse número é automaticamente definido como 10 e outros valores são ignorados. A resposta é paginada em 100 por página se você tiver mais de 100 destinos de montagem. Faixa válida: valor mínimo de 1. ** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) ** (Opcional) ID do destino de montagem que você deseja descrever (String). Ele deve ser incluído em sua solicitação, se `FileSystemId` não estiver incluído. Aceita um ID de destino de montagem ou ARN como entrada. Restrições de tamanho: tamanho mínimo de 13. Tamanho máximo de 45. Padrão: `^fsmt-[0-9a-f]{8,40}$` ## Corpo da Solicitação Essa solicitação não tem corpo. ## Sintaxe da resposta ``` HTTP/1.1 200 Content-type: application/json { "Marker": "string", "MountTargets": [ { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "FileSystemId": "string", "IpAddress": "string", "Ipv6Address": "string", "LifeCycleState": "string", "MountTargetId": "string", "NetworkInterfaceId": "string", "OwnerId": "string", "SubnetId": "string", "VpcId": "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. ** [Marker](#API_DescribeMountTargets_ResponseSyntax) ** Se a solicitação incluiu `Marker`, a resposta retornará esse valor nesse campo. Tipo: string Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128. Padrão: `.+` ** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) ** Retorna os destinos de montagem do sistema de arquivos como uma matriz de objetos `MountTargetDescription`. Tipo: matriz de objetos [MountTargetDescription](API_MountTargetDescription.md) ** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) ** Se um valor estiver presente, há mais destinos de montagem a serem retornados. Em uma solicitação subsequente, você pode fornecer `Marker` em sua solicitação com este valor para recuperar o próximo conjunto de destinos de montagem. Tipo: string Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128. Padrão: `.+` ## Erros ** AccessPointNotFound ** Retornado se o `AccessPointId` 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 ** 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 ** MountTargetNotFound ** Retornado se não houver um destino de montagem com o ID especificado encontrado na Conta da AWS do chamador. ** 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 ## Exemplos ### Recuperar descrições de destinos de montagem criados para um sistema de arquivos A solicitação a seguir recupera as descrições dos destinos de montagem criados para o sistema de arquivos especificado. #### Exemplo de solicitação ``` GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T191252Z Authorization: <...> ``` #### Resposta da amostra ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 357 { "MountTargets":[ { "OwnerId":"251839141158", "MountTargetId":"fsmt-01234567", "FileSystemId":"fs-01234567", "SubnetId":"subnet-01234567", "LifeCycleState":"added", "IpAddress":"10.0.2.42", "NetworkInterfaceId":"eni-1bcb7772" } ] } ``` ## 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/DescribeMountTargets) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets)