Définir l’URL de l’hôte

ID du modèle : dynamichosturl

Remplace l’URL de l’hôte par l’URL générée à partir du modèle. Ce modèle est disponible dans Power Apps et Power Automate.

Les cas d’utilisation cibles pour ce modèle sont des scénarios dans lesquels la requête doit être acheminée vers une URL d’hôte back-end qui est dynamique et dépend d’un ou plusieurs paramètres de connexion, paramètres de requête ou en-têtes. Le paramètre de modèle d’URL prend en charge les expressions pour rendre possible ce scénario et le paramètre opérations vous permet de réduire l’application à un sous-ensemble spécifique d’opérations si nécessaire.

Si vous utilisez ce modèle, gardez à l’esprit que l’url hôte définie dans le connecteur ne sera plus pertinente pour les opérations correspondantes puisqu’elle sera toujours remplacée par la valeur évaluée par ce modèle.

Notez que cette stratégie ne prend actuellement pas en charge les URL de passerelle.

Exemples

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

headers: test=foo; port=1234

connectionParameters : cat = bar ; subPath = chemin

queryParameters: domain=pqr

Modèle d’URL	URL de l’hôte résultante
https://@header(’test’).abc.xyz:@header(’port’)	https://foo.abc.xyz:1234
https://@connectionParameters(’cat’).abc.xyz	https://bar.abc.xyz
https://test.abc.xyz	https://test.abc.xyz
https://@header(’test’).abc.@queryParameters(’domain’)/@connectionParameters(’subPath’)	https://foo.abc.pqr/path
https://@header(’test123’, ’default’).abc.xyz	https://default.abc.xyz

Exemples de connecteurs open source

Nous avons plusieurs exemples de ce modèle utilisé dans notre référentiel de connecteurs open source.

Connecteur	Scénario
Coffre de clés	L’URL de l’hôte dépend du nom du coffre de clés qui est un paramètre de connexion
Engagement Cloud	L’URL de l’hôte dépend de la région, qui est transmise sous forme d’en-tête
Analyse de texte Cognitive Services	L’URL de l’hôte est fournie par l’utilisateur en tant que paramètre de connexion, mais a également une valeur par défaut

Paramètres d’entrée

Nom	Touche	Obligatoire	Type	Description
Url Template	x-ms-apimTemplateParameter.urlTemplate	Vrai	String	Spécifie le modèle à partir duquel l’URL hôte sera générée. Ce paramètre prend en charge les expressions. Pour en savoir plus sur les expressions, cliquez ici.
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.