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 estdescribe-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
-
(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
FileSystemIdouMountTargetIdn’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
-
(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
AccessPointIdouMountTargetIdn’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
-
(Facultatif) Un jeton de pagination opaque renvoyé par une opération
DescribeMountTargetspré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 minimum de 1. Longueur maximale de 128.
Modèle :
.+ - MaxItems
-
(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
-
(Facultatif) ID de la cible de montage que vous souhaitez faire décrire (chaîne). Il doit être inclus dans votre demande si
FileSystemIdn’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
-
Si la demande inclut le
Marker, la réponse renvoie cette valeur dans ce champ.Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.
Modèle :
.+ - MountTargets
-
Renvoie les cibles de montage du système de fichiers sous forme de tableau d’objets
MountTargetDescription.Type : tableau d’objets MountTargetDescription
- NextMarker
-
Si une valeur est présente, il y a plus de cibles de montages à renvoyer. Dans une demande ultérieure, vous pouvez fournir
Markerdans votre demande pour récupérer le prochain ensemble de cibles de montage.Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.
Modèle :
.+
Erreurs
- AccessPointNotFound
-
Renvoyé si la
AccessPointIdvaleur 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
FileSystemIdvaleur 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 :
