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
-
(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
FileSystemIdouMountTargetIdnã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
-
(Opcional) ID do sistema de arquivos cujos destinos de montagem você deseja listar (String). Ele deve ser incluído em sua solicitação, se
AccessPointIdouMountTargetIdnã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
-
(Opcional) Token de paginação opaco retornado de uma operação
DescribeMountTargetsanterior (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
-
(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
-
(Opcional) ID do destino de montagem que você deseja descrever (String). Ele deve ser incluído em sua solicitação, se
FileSystemIdnã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
-
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
-
Retorna os destinos de montagem do sistema de arquivos como uma matriz de objetos
MountTargetDescription.Tipo: matriz de objetos MountTargetDescription
- NextMarker
-
Se um valor estiver presente, há mais destinos de montagem a serem retornados. Em uma solicitação subsequente, você pode fornecer
Markerem 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
AccessPointIdvalor 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
FileSystemIdvalor 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:
