Action d'API personnalisée

Adressez une requête HTTP authentifiée à l'API de comptes Trend Micro.

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 comme /{insert_remaining_URL}.

Vous pouvez spécifier les paramètres de la requête dans l'URL relative à l'aide de ?, ou en tant que paire clé-valeur dans l'entrée Requête.

Par exemple, pour le point de terminaison de l'API de comptes Trend Micro /v3.0/iam/accounts, l'entrée pour l'URL relative est /accounts.

Texte TRUE
En-têtes

Spécifiez tous les en-têtes obligatoires autres que Authorization ou Content-Type, car ce connecteur les gère déjà.

Par exemple, { "TMV1-Filter": "status eq 'enabled'" }.

 Objet FALSE
Requête

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

Par exemple, { "top": 50 }

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

Réponse

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 un succès où une nouvelle ressource a été créée.
  • Une erreur 403 Forbidden indique que la requête HTTP n'a pas été traitée parce que les permissions nécessaires étaient manquantes.

Pour une liste complète des codes de statut possibles, voir 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

Données retournées par votre requête HTTP sélectionnée.

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

 Objet