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.
DescribeMountTargets
Devuelve las descripciones de todos los destinos de montaje actuales o un destino de montaje específico, de un sistema de archivos. Al solicitar todos los objetivos de montaje actuales, no se especifica el orden de los objetivos de montaje devueltos en la respuesta.
Esta operación requiere permisos para la acción elasticfilesystem:DescribeMountTargets, ya sea en el ID del sistema de archivos que especifique en FileSystemId o en el sistema de archivos del destino de montaje que especifique en MountTargetId.
Sintaxis de la solicitud
GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- AccessPointId
-
(Opcional) El ID del punto de acceso cuyos objetivos de montaje desea enumerar. Debe incluirse en la solicitud si un
FileSystemIdoMountTargetIdno se han incluido en la solicitud. Acepta un ID de punto de acceso o un ARN como entrada.Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^(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 del sistema de archivos cuyos objetivos de montaje desea enumerar (cadena). Debe incluirse en la solicitud si un
AccessPointIdoMountTargetIdno se han incluido. Acepta un ID de sistema de archivos o un ARN como entrada.Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$ - Marker
-
(Opcional) Un token de paginación opaco devuelto por una operación
DescribeMountTargetsanterior (cadena). Si está presente, especifica continuar la lista desde donde terminó la llamada de devolución anterior.Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.
Patrón:
.+ - MaxItems
-
(Opcional) El número máximo de destinos de montaje que se devuelven en una respuesta. Actualmente, este número se establece automáticamente en 10 y el resto de valores se ignoran. La respuesta se pagina a 100 por página si tiene más de 100 destinos de montaje.
Rango válido: valor mínimo de 1.
- MountTargetId
-
(Opcional) ID del objetivo de montaje que quiere describir (cadena). Debe incluirse en la solicitud si un
FileSystemIdno se ha incluido. Acepta un ID de destino de montaje o un ARN como entrada.Limitaciones de longitud: longitud mínima de 13. Longitud máxima de 45.
Patrón:
^fsmt-[0-9a-f]{8,40}$
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
{
"Marker": "string",
"MountTargets": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "string"
}
],
"NextMarker": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- Marker
-
Si la solicitud incluía un
Marker, la respuesta devuelve ese valor en este campo.Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.
Patrón:
.+ - MountTargets
-
Devuelve los objetivos de montaje del sistema de archivos como un conjunto de objetos
MountTargetDescription.Tipo: matriz de objetos MountTargetDescription
- NextMarker
-
Si hay un valor, hay más objetivos de montaje que devolver. En una solicitud posterior, puede proporcionar
Markeren su solicitud para recuperar el siguiente conjunto de objetivos de montaje.Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.
Patrón:
.+
Errores
- AccessPointNotFound
-
Se devuelve si el valor
AccessPointIdespecificado no existe en el Cuenta de AWS del solicitante.Código de estado HTTP: 404
- BadRequest
-
Se devuelve si la solicitud tiene un formato incorrecto o contiene un error, como un valor de parámetro no válido, o falta un parámetro obligatorio.
Código de estado HTTP: 400
- FileSystemNotFound
-
Se devuelve si el valor
FileSystemIdespecificado no existe en el Cuenta de AWS del solicitante.Código de estado HTTP: 404
- InternalServerError
-
Se devuelve si se ha producido un error en el servidor.
Código de estado HTTP: 500
- MountTargetNotFound
-
Se devuelve si no hay un objetivo de montaje con el ID especificado que se encoentró en la Cuenta de AWS de la persona que llama.
Código de estado HTTP: 404
Ejemplos
Recupera las descripciones de los objetivos de montaje creados para un sistema de archivos
La siguiente solicitud recupera las descripciones de los objetivos de montaje creados para el sistema de archivos especificado.
Solicitud de muestra
GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191252Z
Authorization: <...>Respuesta de ejemplo
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"
}
]
}
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
