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`. El comando de la CLI correspondiente es `describe-mount-targets`. ## 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](#API_DescribeMountTargets_RequestSyntax) ** (Opcional) El ID del punto de acceso cuyos objetivos de montaje desea enumerar. Debe incluirse en la solicitud si un `FileSystemId` o `MountTargetId` no 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](#API_DescribeMountTargets_RequestSyntax) ** (Opcional) ID del sistema de archivos cuyos objetivos de montaje desea enumerar (cadena). Debe incluirse en la solicitud si un `AccessPointId` o `MountTargetId` no 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](#API_DescribeMountTargets_RequestSyntax) ** (Opcional) Un token de paginación opaco devuelto por una operación `DescribeMountTargets` anterior (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](#API_DescribeMountTargets_RequestSyntax) ** (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](#API_DescribeMountTargets_RequestSyntax) ** (Opcional) ID del objetivo de montaje que quiere describir (cadena). Debe incluirse en la solicitud si un `FileSystemId` no 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", "Ipv6Address": "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](#API_DescribeMountTargets_ResponseSyntax) ** Si la solicitud incluía un `Marker`, la respuesta devuelve ese valor en este campo. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128. Patrón: `.+` ** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) ** Devuelve los objetivos de montaje del sistema de archivos como un conjunto de objetos `MountTargetDescription`. Tipo: matriz de objetos [MountTargetDescription](API_MountTargetDescription.md) ** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) ** Si hay un valor, hay más objetivos de montaje que devolver. En una solicitud posterior, puede proporcionar `Marker` en su solicitud para recuperar el siguiente conjunto de objetivos de montaje. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128. Patrón: `.+` ## Errores ** AccessPointNotFound ** Se devuelve si el `AccessPointId` valor especificado no existe en el del Cuenta de AWS solicitante. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. 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. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. Código de estado HTTP: 400 ** FileSystemNotFound ** Se devuelve si el `FileSystemId` valor especificado no existe en el del solicitante. Cuenta de AWS ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. Código de estado HTTP: 404 ** InternalServerError ** Se devuelve si se ha producido un error en el servidor. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. 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. ** ErrorCode ** El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo. ** Message ** El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error. 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 uno de los idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos 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)