다음을 통해 공유


상태 코드 설정

적용 대상: 모든 API Management 계층

set-status 정책은 HTTP 상태 코드를 지정된 값으로 설정합니다.

참고 항목

정책 문에 제공된 순서대로 정책의 요소 및 자식 요소를 설정합니다. API Management 정책을 설정하거나 편집하는 방법에 대해 자세히 알아봅니다.

정책 문

<set-status code="HTTP status code" reason="description"/>

특성

특성 설명 필수 항목 기본값
코드 정수. 반환할 HTTP 상태 코드입니다. 정책 식이 허용됩니다. 해당 없음
reason 문자열입니다. 상태 코드를 반환하는 이유에 대한 설명입니다. 정책 식이 허용됩니다. 해당 없음

사용

예시

이 예에서는 인증 토큰이 유효하지 않은 경우 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>

정책 작업에 대한 자세한 내용은 다음을 참조하세요.