Action d'API personnalisée

Adressez une requête HTTP authentifiée à l'API Tenable Vulnerability Management.

Options

Champ Définition Type Obligatoire
Type de requête

Type de requête (menu déroulant) : Il s'agit de l'une des méthodes de requête HTTP prises en charge, ou verbes HTTP, dans un appel API personnalisé (voir Méthodes de requête HTTP) :

  • GET - récupère des données d'un serveur web en fonction de vos paramètres. Cette méthode demande une représentation de la ressource spécifiée. Si une requête réussit, vous recevez un message de réponse 200 (OK) avec le contenu demandé.

  • POST - envoie des données à un serveur web en fonction de vos paramètres (par exemple, charger un fichier). Plusieurs requêtes POST peuvent aboutir à un résultat différent d'un seul POST, vous devriez donc être prudent pour ne pas envoyer plusieurs requêtes POST par inadvertance. Si une requête réussit, vous recevez un message de réponse 200 (OK).

  • PUT - envoie des données à stocker à un emplacement spécifique sur un serveur web en fonction de vos paramètres (par exemple, charger un fichier). La différence entre les requêtes PUT et POST est que PUT est idempotente. Cela signifie que pour les requêtes réussies, le résultat d'une seule requête PUT est le même que plusieurs requêtes PUT identiques. Si une requête réussit, vous recevez un message de réponse 200 (OK), 201 (Created) ou 204 (No Content).

  • PATCH - applique des modifications partielles à une ressource sur un serveur web en fonction de vos paramètres. PATCH n'est pas idempotente, ce qui signifie que plusieurs requêtes PATCH pourraient avoir des conséquences non souhaitées. Si un PATCH réussit, vous recevez un message de réponse 200 (OK) ou 204 (No Content).

  • DELETE - supprime la ressource spécifiée du serveur web en fonction de vos paramètres (si la ressource existe). Si un DELETE réussit, vous recevez un message de réponse 200 (OK).

 Liste déroulante TRUE

Entrée

Champ Définition Type Obligatoire
Requête
URL relative

L'adresse (URL) du serveur Web que vous essayez d'appeler. Spécifiez l'URL relative sous la forme /{insert_remaining_URL}.

Pour spécifier les paramètres de la requête, vous pouvez soit utiliser ? dans l'URL relative ou les spécifiez comme paires clé-valeur dans l'entrée de Query.

Texte TRUE
En-têtes

Spécifiez tous les en-têtes requis en plus des X-ApiKeys, car ce connecteur gère déjà cela.

 Objet FALSE
Requête

Indiquez tout paramètre de requête supplémentaire à inclure dans le format d'objet sous forme de paires clé-valeur.

 Objet FALSE
Corps

Spécifiez un corps de requête au format JSON. Cette entrée n'est pas disponible pour les requêtes GET.

 Objet FALSE

Sortie

Champ Définition Type
Sorties
Code de statut

Résultat de l'opération. Le connecteur retourne un code de statut HTTP qui indique si l'action effectuée par la carte a réussi ou échoué. Par exemple :

  • Un code de statut 201 Created indique une réussite lorsqu'une ressource a été créée.

  • Une erreur 403 Forbidden indique que la requête HTTP n'a pas été traitée, car les autorisations nécessaires étaient manquantes.

Pour obtenir la liste complète des codes de statut possibles, consultez Codes de statut HTTP.

 Nombre
En-têtes

Contexte détaillé du code de statut, sans lien avec le corps de la sortie. Les en-têtes de réponse dépendent de l'option de requête HTTP sélectionnée. Tous les en-têtes ne sont pas des en-têtes de réponse. Ceci est semblable à {"Content-Type":"application/json"}.

 Objet
Corps

Les données renvoyées par votre requête HTTP sélectionnée.

Par exemple, les données d'une requête GET.

 Objet