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.
ListSecurityPolicies
Répertorie les politiques de sécurité associées à vos serveurs et connecteurs SFTP. Pour plus d'informations sur les politiques de sécurité, voir Utilisation des politiques de sécurité pour les serveurs ou Utilisation des politiques de sécurité pour les connecteurs SFTP.
Syntaxe de la requête
{
"MaxResults": number
,
"NextToken": "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 de politiques de sécurité à renvoyer en réponse à la
ListSecurityPolicies
requête.Type : entier
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.
Obligatoire : non
- NextToken
-
Lorsque des résultats supplémentaires sont obtenus à partir de la
ListSecurityPolicies
commande, unNextToken
paramètre est renvoyé dans la sortie. Vous pouvez ensuite transmettre leNextToken
paramètre dans une commande suivante pour continuer à répertorier les politiques de sécurité supplémentaires.Type : chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 6 144.
Obligatoire : non
Syntaxe de la réponse
{
"NextToken": "string",
"SecurityPolicyNames": [ "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.
- NextToken
-
Lorsque vous pouvez obtenir des résultats supplémentaires à partir de l'
ListSecurityPolicies
opération, unNextToken
paramètre est renvoyé dans la sortie. Dans une commande suivante, vous pouvez transmettre leNextToken
paramètre pour continuer à répertorier les politiques de sécurité.Type : chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 6 144.
- SecurityPolicyNames
-
Un ensemble de politiques de sécurité répertoriées.
Type : tableau de chaînes
Contraintes de longueur : longueur minimale de 0. Longueur maximum de 100.
Modèle :
Transfer[A-Za-z0-9]*SecurityPolicy-[A-Za-z0-9-]+
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
- ServiceUnavailableException
-
La demande a échoué car le service AWS Transfer Family n'est pas disponible.
Code d’état HTTP : 500
Exemples
Exemple
L'exemple suivant répertorie les noms de toutes les politiques de sécurité disponibles.
Exemple de demande
aws transfer list-security-policies
Exemple de réponse
{
"SecurityPolicyNames": [
"TransferSecurityPolicy-2023-05",
"TransferSecurityPolicy-2022-03",
"TransferSecurityPolicy-FIPS-2024-01",
"TransferSecurityPolicy-2024-01",
"TransferSecurityPolicy-PQ-SSH-FIPS-Experimental-2023-04",
"TransferSecurityPolicy-PQ-SSH-Experimental-2023-04",
"TransferSecurityPolicy-FIPS-2020-06",
"TransferSecurityPolicy-2020-06",
"TransferSecurityPolicy-2018-11",
"TransferSecurityPolicy-FIPS-2023-05"
]
}
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 :