1.8. 매핑 규칙 정의
매핑 규칙은 API에 대한 액세스를 추적 및 제한하기 위한 지정된 메서드 및 메트릭과 끝점에 대한 호출을 연결합니다. 백엔드 및 제품 수준에서 매핑 규칙을 정의할 수 있습니다. 백엔드 수준에서 매핑 규칙을 정의할 때의 장점은 여러 제품에 백엔드를 추가할 수 있다는 점입니다. API의 요청에 따라 사용 정보를 수집하는 메트릭 또는 방법에 대한 자세한 내용은 제품 및 백엔드 수준에서 모두 3scale API 사용에 대한 매핑 규칙을 적용하는 방법을 참조하십시오.
사전 요구 사항
- 백엔드. 이를 생성하려면 제품의 백엔드 생성을 참조하십시오.
절차
- 대시보드에서 원하는 백엔드 를 클릭하여 매핑 규칙을 정의합니다.
- 탐색 패널에서 매핑 규칙을 클릭합니다.
- 매핑 규칙 만들기를 클릭합니다.
다음 설정을 지정합니다.
-
verb : HTTP 요청 동사(
GET
,POST
,DELETE
또는PUT
)입니다. -
pattern: 일치시킬 패턴입니다. 예:
/hello
. - 증가시킬 메트릭 또는 방법: 지표 또는 메서드 이름입니다.
-
증가 단위: 메트릭 증가 수입니다. 예를 들면
1
입니다. - 마지막?: 요청이 Last? 로 표시된 규칙과 일치하면 APIcast가 처리를 중지하고 나머지 매핑 규칙에서도 일치 항목을 검색하지 않습니다.
- position : 매핑 규칙을 정렬하기 위해 매핑 규칙의 실행 위치를 나타냅니다.
-
verb : HTTP 요청 동사(
- 매핑 규칙 만들기를 클릭합니다.
다음 단계
이러한 단계를 수행한 후 매핑 규칙이 [Your_API_backend] > Mapping Rules의 백엔드에 추가됩니다. 매핑 규칙은 현재 백엔드를 사용하는 각 제품에도 사용할 수 있습니다. 제품 수준에서 매핑 규칙을 활성화하려면 [ your_product_name] > Integration > Configuration의 제품 탭에서 최신 구성을 승격합니다.
예제
구성을 승격한 후 3scale은 제품 수준에서 백엔드 매핑 규칙을 활성화합니다. 매핑 규칙은 제품에 지정된 백엔드 경로를 따릅니다. 예를 들어 다음과 같은 구성이 있다고 가정합니다.
-
백엔드의 매핑 규칙 패턴:
/thousands
-
경로와 함께 제품에 백엔드가 추가됨:
/unit price
제품 수준의 매핑 규칙은 /unit price/thousands
입니다.