상태 코드 설정
적용 대상: 모든 API Management 계층
set-status 정책은 HTTP 상태 코드를 지정된 값으로 설정합니다.
참고 항목
정책 문에 제공된 순서대로 정책의 요소 및 자식 요소를 설정합니다. API Management 정책을 설정하거나 편집하는 방법에 대해 자세히 알아봅니다.
정책 문
<set-status code="HTTP status code" reason="description"/>
특성
| 특성 | 설명 | 필수 항목 | 기본값 |
|---|---|---|---|
| 코드 | 정수. 반환할 HTTP 상태 코드입니다. 정책 식이 허용됩니다. | 예 | 해당 없음 |
| reason | 문자열입니다. 상태 코드를 반환하는 이유에 대한 설명입니다. 정책 식이 허용됩니다. | 예 | 해당 없음 |
사용
- 정책 섹션: inbound, outbound, backend, on-error
- 정책 범위: 전역, 작업 영역, 제품, API, 작업
- 게이트웨이: 클래식, v2, 사용량, 자체 호스팅, 작업 영역
예시
이 예에서는 인증 토큰이 유효하지 않은 경우 401 응답을 반환하는 방법을 보여 줍니다. 자세한 내용은 Azure API Management 서비스에서 외부 서비스 사용을 참조하세요.
<choose>
<when condition="@((bool)((IResponse)context.Variables["tokenstate"]).Body.As<JObject>()["active"] == false)">
<return-response response-variable-name="existing response variable">
<set-status code="401" reason="Unauthorized" />
<set-header name="WWW-Authenticate" exists-action="override">
<value>Bearer error="invalid_token"</value>
</set-header>
</return-response>
</when>
</choose>
관련 정책
관련 콘텐츠
정책 작업에 대한 자세한 내용은 다음을 참조하세요.
- 자습서: API 변환 및 보호
- 정책 문 및 해당 설정에 대한 전체 목록에 대한 정책 참조
- 정책 식
- 정책 설정 또는 편집
- 정책 구성 재사용
- 정책 코드 조각 리포지토리
- Azure API Management 정책 도구 키트
- Azure의 Microsoft Copilot을 사용하는 작성자 정책