Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # DescribeMountTargets Renvoie les descriptions de toutes les cibles de montage actuelles, ou une cible de montage spécifique, pour un système de fichiers. Lorsque vous demandez toutes les cibles de montage actuelles, l’ordre des cibles de montage renvoyées dans la réponse n’est pas spécifié. Cette opération nécessite des autorisations pour l’action `elasticfilesystem:DescribeMountTargets`, soit sur l’ID du système de fichiers que vous spécifiez dans `FileSystemId`, soit sur le système de fichiers de la cible de montage dans laquelle vous spécifiez dans `MountTargetId`. La commande CLI correspondante est`describe-mount-targets`. ## Syntaxe de la demande ``` GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1 ``` ## Paramètres de demande URI La demande utilise les paramètres URI suivants. ** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) ** (Facultatif) L’ID du point d’accès dont vous souhaitez répertorier les cibles de montage. Il doit être inclus dans votre demande si un `FileSystemId` ou `MountTargetId` n’est pas inclus dans votre demande. Accepte un ID de point d’accès ou un ARN en entrée. Contraintes de longueur : Longueur maximum de 128. Modèle : `^(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) ** (Facultatif) ID du système de fichiers dont vous souhaitez répertorier les cibles de montage (chaîne). Il doit être inclus dans votre demande si un `AccessPointId` ou `MountTargetId` n’est pas inclus. Accepte un ID de système de fichiers ou un ARN en entrée. Contraintes de longueur : Longueur maximum de 128. Modèle : `^(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) ** (Facultatif) Un jeton de pagination opaque renvoyé par une opération `DescribeMountTargets` précédente (chaîne). S’il est présent, il indique de continuer la liste à partir de l’endroit où le précédent appel de retour s’est arrêté. Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128. Modèle : `.+` ** [MaxItems](#API_DescribeMountTargets_RequestSyntax) ** (Facultatif) Nombre maximum de cibles de montage à renvoyer dans la réponse. Actuellement, ce nombre est automatiquement défini sur 10 et les autres valeurs sont ignorées. La réponse est paginée à 100 par page si vous avez plus de 100 cibles de montage. Plage valide : valeur minimum de 1. ** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) ** (Facultatif) ID de la cible de montage que vous souhaitez faire décrire (chaîne). Il doit être inclus dans votre demande si `FileSystemId` n’est pas inclus. Accepte un ID de cible de montage ou un ARN en entrée. Contraintes de longueur : longueur minimale de 13. Longueur maximale de 45. Modèle : `^fsmt-[0-9a-f]{8,40}$` ## Corps de la demande La demande n’a pas de corps de requête. ## Syntaxe de la réponse ``` 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" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [Marker](#API_DescribeMountTargets_ResponseSyntax) ** Si la demande inclut le `Marker`, la réponse renvoie cette valeur dans ce champ. Type : Chaîne Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128. Modèle : `.+` ** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) ** Renvoie les cibles de montage du système de fichiers sous forme de tableau d’objets `MountTargetDescription`. Type : tableau d’objets [MountTargetDescription](API_MountTargetDescription.md) ** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) ** Si une valeur est présente, il y a plus de cibles de montages à renvoyer. Dans une demande ultérieure, vous pouvez fournir `Marker` dans votre demande pour récupérer le prochain ensemble de cibles de montage. Type : Chaîne Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128. Modèle : `.+` ## Erreurs ** AccessPointNotFound ** Renvoyé si la `AccessPointId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur. ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP :404 ** BadRequest ** Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant. ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP : 400 ** FileSystemNotFound ** Renvoyé si la `FileSystemId` valeur spécifiée n'existe pas dans celle du Compte AWS demandeur. ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP :404 ** InternalServerError ** Renvoyé si une erreur s’est produite côté serveur. ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP : 500 ** MountTargetNotFound ** Renvoyé s’il n’y a aucune cible de montage avec l’identifiant spécifié dans celui de l’appelant Compte AWS. ** ErrorCode ** Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type. ** Message ** Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur. Code d’état HTTP :404 ## Exemples ### Récupère les descriptions des cibles de montage créées pour un système de fichiers La requête suivante récupère les descriptions des cibles de montage créées pour le système de fichiers spécifié. #### Exemple de demande ``` GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T191252Z Authorization: <...> ``` #### Exemple de réponse ``` 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" } ] } ``` ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets)