Ustawianie nagłówka HTTP

Identyfikator szablonu: setheader

Przypisuje wartość do istniejącego nagłówka odpowiedzi i/lub żądania bądź dodaje nowy nagłówek odpowiedzi i/lub żądania. Ten szablon jest dostępny w Power Apps i Power Automate.

Docelowa sprawa użycia tego szablonu zasad dotyczy zastępowania lub dodawania informacji do żądania lub odpowiedzi HTTP.

Przykłady

Przyjrzyjmy się kilku przykładom, które używają następujących parametrów.

headers: test=foo

connectionParameters: cat=bar

Nazwa nagłówka	Wartość nagłówka	Wynikowy nagłówek
test	@headers('test')moo	test=foomoo
test	moo@headers('test')	test=moofoo
cat	@connectionParameters(‘cat’, ‘’)	test=foo; cat=bar
Nazwa	@connectionParameters(‘name’, ‘’)	test=foo; name=""

Przykłady z łączników typu open source

Mamy wiele wystąpień tego szablonu używanych w naszym repozytorium łączników typu open source, a oto kilka z nich.

Łącznik	Scenariusz
DostaćZaakceptuj	Nagłówek HTTP w odpowiedzi jest zastępowany przez nową wartość statyczną
Peltarion (Peltarion)	Nagłówek HTTP w żądaniu jest zastępowany przez statyczną aplikację wartości/json, co jest często występującym scenariuszem
Serwer zawartości OpenText	Nagłówek HTTP w żądaniu jest zastępowany przez ustawienia połączenia użytkownika końcowego

Parametry wejściowe

Nazwa/nazwisko	Klawisz	Wymagani	Pisz	Opis
Header name	x-ms-apimTemplateParameter.name	Prawda	String	Określa nazwę nagłówka, który ma być ustawiony.
Header value	x-ms-apimTemplateParameter.value	Prawda	String	Określa wartość nagłówka, który ma być ustawiony.
Action if header exists	x-ms-apimTemplateParameter.existsAction		Wyliczenie	Określa akcję, która ma zostać wykonana po określeniu nagłówka - zastąpienie: zastępuje istniejącą wartość wartością z szablonu zasad. - pominięcie: istniejąca wartość nie jest zastąpiona wartością z szablonu zasad. - dołączenie: Dołącza wartość z szablonu zasad do istniejącej wartości.
Run policy on	x-ms-apimTemplate-policySection	Prawda	Wyliczenie	Określa, kiedy należy uruchomić tę zasadę - Żądanie: szablon zasad będzie uruchamiany przed wysłaniem żądania do interfejsu API wewnętrznej bazy danych. - Odpowiedź: zasady zostaną wykonane po otrzymaniu odpowiedzi od interfejsu API wewnętrznej bazy danych. - Błąd: szablon zasad będzie uruchamiany tylko wtedy, gdy wywołanie do interfejsu API wewnętrznej bazy danych zakończy się niepowodzeniem.
Operations	x-ms-apimTemplate-operationName		Tablica	Lista akcji i wyzwalaczy, do których mają zastosowanie te zasady. Jeśli nie zostanie wybrana żadna operacja, te zasady będą miały zastosowanie do wszystkich operacji.