API Management 정책 정의에서 정책 구성 재사용

적용 대상: 모든 API Management 계층

이 문서에서는 API Management 정책 정의에서 정책 조각을 만들고 사용하는 방법을 보여 줍니다. 정책 조각은 하나 이상의 API Management 정책 구성을 포함하는 중앙에서 관리되고 재사용 가능한 XML 코드 조각입니다.

정책 조각을 사용하면 XML 코드를 반복하거나 다시 입력할 필요 없이 정책을 일관되게 구성하고 정책 정의를 유지 관리할 수 있습니다.

정책 조각:

제한 사항:

필수 조건

API Management 인스턴스 및 백 엔드 API가 아직 없는 경우 다음을 참조하세요.

필수는 아니지만 하나 이상의 정책 정의를 구성할 수 있습니다. 정책 조각을 만들 때 이러한 정의에서 정책 요소를 복사할 수 있습니다.

API Management 인스턴스의 왼쪽 탐색 메뉴에 있는 API에서 정책 조각>+ 만들기를 선택합니다.
새 정책 조각 만들기 창에서 정책 조각의 이름과 선택 사항인 설명을 입력합니다. 이름은 API Management 인스턴스 내에서 고유해야 합니다.

이름 예: ForwardContext
XML 정책 조각 편집기에서 <fragment> 및 </fragment> 태그 사이에 하나 이상의 정책 XML 요소를 입력하거나 붙여넣습니다.

예를 들어 다음 조각에는 컨텍스트 정보를 백 엔드 서비스로 전달하기 위한 set-header 정책 구성이 포함되어 있습니다. 이 조각은 인바운드 정책 섹션에 포함됩니다. 이 예의 정책 식은 기본 제공 context 변수에 액세스합니다.
```
<fragment>
    <set-header name="x-request-context-data" exists-action="override">
      <value>@(context.User.Id)</value>
      <value>@(context.Deployment.Region)</value>
    </set-header>
</fragment>
```
만들기를 실행합니다. 조각이 정책 조각 목록에 추가됩니다.

정책 정의에 정책 조각을 삽입하도록 include-fragment 정책을 구성합니다. 정책 정의에 대한 자세한 내용은 정책 설정 또는 편집을 참조하세요.

예를 들어 인바운드 정책 섹션에 ForwardContext라는 정책 조각을 삽입합니다.

<policies>
    <inbound>
        <include-fragment fragment-id="ForwardContext" />
        <base />
    </inbound>
[...]

팁

정책 정의에 표시된 포함된 조각의 콘텐츠를 보려면 정책 편집기에서 실제 정책 계산을 선택합니다.

정책 조각을 만든 후 정책 조각의 속성을 보고 업데이트하거나 언제든지 정책 단편을 삭제할 수 있습니다.

정책 조각의 속성을 보려면:

정책 조각을 편집하려면:

참고 항목

업데이트는 조각이 포함된 모든 정책 정의에 영향을 줍니다.

정책 조각을 삭제하려면:

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