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
URIParámetros de solicitud
La solicitud utiliza los siguientes URI parámetros.
- 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 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 identificador de sistema de archivos o 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. Longitud máxima 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 identificador de destino de montaje o 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 de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- 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. Longitud máxima 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. Longitud máxima de 128.
Patrón:
.+
Errores
- AccessPointNotFound
-
Se devuelve si el
AccessPointIdvalor especificado no existe en el del Cuenta de AWS solicitante.HTTPCódigo de estado: 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.
HTTPCódigo de estado: 400
- FileSystemNotFound
-
Se devuelve si el
FileSystemIdvalor especificado no existe en el del Cuenta de AWS solicitante.HTTPCódigo de estado: 404
- InternalServerError
-
Se devuelve si se ha producido un error en el servidor.
HTTPCódigo de estado: 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.
HTTPCódigo de estado: 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 cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
