Définir l’en-tête HTTP

ID du modèle : setheader

Affecte une valeur à un en-tête de et/réponse ou de requête existant, ou ajoute un nouvel en-tête de réponse et/ou de requête. Ce modèle est disponible dans Power Apps et Power Automate.

Le cas d’utilisation cible de ce modèle de stratégie consiste à remplacer ou ajouter des informations à une requête ou une réponse HTTP.

Exemples

Étudions quelques exemples qui utilisent les paramètres suivants.

headers: test=foo

connectionParameters: cat=bar

Nom de l’en-tête	Valeur de l’en-tête	En-tête résultant
test	@headers('test')moo	test=foomoo
test	moo@headers('test')	test=moofoo
cat	@connectionParameters(‘cat’, ‘’)	test=foo; cat=bar
nom	@connectionParameters(‘name’, ‘’)	test=foo; name=""

Exemples de connecteurs open source

Nous avons plusieurs exemples de ce modèle utilisé dans notre référentiel de connecteurs open source ; en voici quelques-uns.

Connecteur	Scénario
GetAccept	L’en-tête HTTP dans la réponse est remplacé par une nouvelle valeur statique
Peltarion	L’en-tête HTTP dans la requête est remplacé par l’application/json de la valeur statique, ce qui est un scénario courant
OpenText ContentServer	L’en-tête HTTP de la requête est remplacé par les paramètres de connexion de l’utilisateur final

Paramètres d’entrée

Nom	Touche	Obligatoire	Type	Description
Header name	x-ms-apimTemplateParameter.name	Vrai	String	Spécifie le nom de l’en-tête à définir.
Header value	x-ms-apimTemplateParameter.value	Vrai	String	Spécifie la valeur de l’en-tête à définir.
Action if header exists	x-ms-apimTemplateParameter.existsAction		Enum	Spécifie l’action à entreprendre lorsque l’en-tête est déjà spécifié - remplacer : remplace la valeur existante par la valeur du modèle de stratégie. - ignorer : la valeur existante n’est pas remplacée par la valeur du modèle de stratégie. - ajouter : ajoute la valeur du modèle de stratégie à une valeur existante.
Run policy on	x-ms-apimTemplate-policySection	Vrai	Enum	Spécifie quand exécuter cette stratégie - Demande : le modèle de stratégie s’exécutera avant l’envoi de la demande à l’API back-end. - Réponse : la stratégie s’exécutera après réception de la réponse de l’API back-end. - Échec : Le modèle de stratégie s'exécute uniquement lorsque l'appel à l'API back-end échoue.
Operations	x-ms-apimTemplate-operationName		Tableau	Liste des actions et déclencheurs auxquels la politique s’appliquera. Si aucune opération n'est sélectionnée, cette stratégie s'appliquera à toutes les opérations.