템플릿 ID: setheader
기존 응답 및/또는 요청 헤더에 값을 할당하거나 새 응답 및/또는 요청 헤더를 추가합니다. 이 템플릿은 Power Apps 및 Power Automate에서 사용할 수 있습니다.
이 정책 템플릿의 대상 사용 사례는 HTTP 요청 또는 응답에 정보를 재정의하거나 추가하는 것입니다.
예제
다음 매개 변수를 사용하는 몇 가지 예를 살펴보겠습니다.
headers: test=foo
connectionParameters: cat=bar
| 헤더 이름 | 헤더 값 | 결과 헤더 |
| 테스트 | @headers('test')moo | test=foomoo |
| 테스트 | moo@headers('test') | test=moofoo |
| cat | @connectionParameters(‘cat’, ‘’) | test=foo; cat=bar |
| 이름 | @connectionParameters(‘name’, ‘’) | test=foo; name="" |
오픈 소스 커넥터의 예
저희는 오픈소스 커넥터 저장소 에서 이 템플릿을 여러 개 사용하고 있으며, 그 중 몇 가지를 소개합니다.
| 커넥터 | 시나리오 | |
| 수락하기 | 응답의 HTTP 헤더가 새 정적 값으로 대체됩니다. | |
| 펠타리온 | 요청의 HTTP 헤더는 일반적인 시나리오인 정적 값 애플리케이션/JSON에 의해 다시 정의됩니다. | |
| OpenText 콘텐츠 서버 | 요청의 HTTP 헤더는 최종 사용자의 연결 설정에 의해 다시 정의됩니다. |
입력 매개 변수
| 이름 | 열쇠 | 필요함 | 종류 | 설명 |
|---|---|---|---|---|
Header name |
x-ms-apimTemplateParameter.name | True | String | 설정할 헤더의 이름을 지정합니다. |
Header value |
x-ms-apimTemplateParameter.value | True | String | 설정할 헤더의 값을 지정합니다. |
Action if header exists |
x-ms-apimTemplateParameter.existsAction | 열거형 | 헤더가 이미 지정된 경우 수행할 작업을 지정합니다. - 재정의: 기존 값을 정책 템플릿의 값으로 바꿉니다. - 건너뛰기: 기존 값은 정책 템플릿의 값으로 대체되지 않습니다. - 추가: 정책 템플릿의 값을 기존 값에 추가합니다. |
|
Run policy on |
x-ms-apimTemplate-policySection | True | 열거형 | 이 정책을 실행할 시기를 지정합니다. - 요청: 요청이 백엔드 API로 전송되기 전에 정책 템플릿이 실행됩니다. - 응답: 백엔드 API에서 응답을 받은 후 정책이 실행됩니다. - 실패: 백엔드 API 호출에 실패한 경우에만 정책 템플릿이 실행됩니다. |
Operations |
x-ms-apimTemplate-operationName | 배열 | 정책이 적용될 조치 및 트리거 목록. 작업을 선택하지 않으면 이 정책이 모든 작업에 적용됩니다. |