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.
ListAccesses
Répertorie les détails de tous les accès que vous avez sur votre serveur.
Syntaxe de la requête
{
"MaxResults": number
,
"NextToken": "string
",
"ServerId": "string
"
}
Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- MaxResults
-
Spécifie le nombre maximal de SID d'accès à renvoyer.
Type : entier
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.
Obligatoire : non
- NextToken
-
Lorsque vous pouvez obtenir des résultats supplémentaires à partir de l'
ListAccesses
appel, unNextToken
paramètre est renvoyé dans la sortie. Vous pouvez ensuite transmettre une commande ultérieure auNextToken
paramètre pour continuer à répertorier les accès supplémentaires.Type : chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 6 144.
Obligatoire : non
- ServerId
-
Identifiant unique attribué par le système à un serveur auquel des utilisateurs sont assignés.
Type : chaîne
Contraintes de longueur : longueur fixe de 19.
Modèle :
s-([0-9a-f]{17})
Obligatoire : oui
Syntaxe de la réponse
{
"Accesses": [
{
"ExternalId": "string",
"HomeDirectory": "string",
"HomeDirectoryType": "string",
"Role": "string"
}
],
"NextToken": "string",
"ServerId": "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.
- Accesses
-
Renvoie les accès et leurs propriétés pour la
ServerId
valeur que vous spécifiez.Type : tableau d’objets ListedAccess
- NextToken
-
Lorsque vous pouvez obtenir des résultats supplémentaires à partir de l'
ListAccesses
appel, unNextToken
paramètre est renvoyé dans la sortie. Vous pouvez ensuite transmettre une commande ultérieure auNextToken
paramètre pour continuer à répertorier les accès supplémentaires.Type : chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 6 144.
- ServerId
-
Identifiant unique attribué par le système à un serveur auquel des utilisateurs sont assignés.
Type : chaîne
Contraintes de longueur : longueur fixe de 19.
Modèle :
s-([0-9a-f]{17})
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InternalServiceError
-
Cette exception est levée lorsqu'une erreur se produit dans le AWS Transfer Family service.
Code d’état HTTP : 500
- InvalidNextTokenException
-
Le
NextToken
paramètre transmis n'est pas valide.Code d’état HTTP : 400
- InvalidRequestException
-
Cette exception est levée lorsque le client soumet une demande mal formée.
Code d’état HTTP : 400
- ResourceNotFoundException
-
Cette exception est levée lorsqu'aucune ressource n'est trouvée par le service AWS Transfer Family.
Code d’état HTTP : 400
- ServiceUnavailableException
-
La demande a échoué car le service AWS Transfer Family n'est pas disponible.
Code d’état HTTP : 500
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :