비율 한계

온라인에서 편집하기

비율 한계 정책을 사용하여 API 어셈블리 플로우의 임의 지점에서 하나 이상의 비율, 버스트 또는 개수 한계를 적용하십시오. 비율 및 버스트 한계는 지정된 기간의 API에 대해 수행할 수 있는 호출 수를 제한하는 반면, 개수 한계는 총 호출 수에 대해 엄격한 한계를 부과합니다.

게이트웨이 지원

표 1. 이 정책을 지원하는 게이트웨이와 해당 정책 버전을 보여주는 표
게이트웨이 정책 버전
DataPower® API Gateway 2.0.0

2.1.0 (DataPower API Gateway 버전 10.0.1.0 이상)

2.2.0 (DataPower API Gateway 버전 10.0.2.0 이상)

2.3.0 (DataPower API Gateway 버전 10.5.0.0

이 항목에서는 어셈블리 사용자 인터페이스에서 정책을 구성하는 방법을 설명합니다. OpenAPI 소스에서 정책을 구성하는 방법에 대한 자세한 내용은 ratelimit을 참조하십시오.

정보

정의된 비율, 버스트, 개수 한계는 어셈블리 플로우에서 뒤에 나오는 항목에 적용됩니다. 예를 들어, 비율 한계 정책이 호출 정책 앞에 배치되고 호출 정책에 의해 작성된 호출이 비율 한계 정책에 의해 정의된 한계를 초과하는 경우 API 호출 자체가 실패합니다.

참고: API ConnectAI Gateway의 비율 한계 및 버스트 한계에 대한 정보는 API및 플랜에 대한 비율 한계 이해를 참조하십시오.

특성

다음 표에서는 정책 특성을 나열하고, 특성이 필수인지 여부를 표시하며, 올바른 입력 값과 기본 입력 값을 지정하고, 값의 데이터 유형을 지정합니다.

표 2. 요청 제한 정책 속성
특성 레이블 필수 설명 데이터 유형
제목 아니오 해당 정책의 제목입니다.

기본값은 ratelimit입니다.

 문자열
설명 아니오 정책의 설명입니다. 문자열
소스 예 이 정책에 포함되는 모든 비율 한계, 버스트 한계, 개수 한계 정의의 위치입니다. 다음 옵션 중 하나를 선택하십시오.
  • 이름별 카탈로그: 적용할 한계는 게이트웨이 구성에서 API Connect 카탈로그를 나타내는 오브젝트인 DataPower API Gateway의 적절한 api-collection 오브젝트에 정의됩니다.

    ` api-collection object`에서 속도, 버스트 또는 카운트 제한을 구성하는 방법에 대한 자세한 내용은 DataPower 의 “속도, 버스트 또는 카운트 제한 구성(Configuring a rate, burst, or count limit)” 섹션( API Gateway )을 참조하십시오.

  • 이름별 플랜: 적용할 한계는 호출 애플리케이션이 구독되는 플랜에 정의된 어셈블리 버스트 한계 또는 어셈블리 개수 한계입니다. 계획에서 어셈블리 버스트 한계 및 어셈블리 개수 한계를 구성하는 방법에 대한 세부사항은 드래프트 제품 편집을 참조하십시오.
    주: 다음 조건은 이름별 플랜 비율 한계 정책에 적용됩니다.
    • 제한되는 API를 포함하는 모든 플랜에는 이름 지정된 비율 한계가 적용되어야 합니다.
    • 이름별 플랜 비율 한계 정책은 자동으로 생성된 제품과 함께 사용할 수 없습니다.
  • 이름별 게이트웨이: 적용할 한계는 DataPower API Gateway 게이트웨이의 apiconnect라는 apigw 오브젝트에 정의되어 있습니다.

    ` apigw object`에서 속도, 버스트 또는 카운트 제한을 구성하는 방법에 대한 자세한 내용은 DataPower 의 “속도, 버스트 또는 카운트 제한 구성(Configuring a rate, burst, or count limit)” 섹션( API Gateway )을 참조하십시오.

  • 플랜 기본값: 적용되는 비율 및 버스트 한계는 호출 애플리케이션이 구독되는 플랜에 구성된 기본 한계입니다. 기본 플랜 비율 및 버스트 한계를 구성하는 방법에 대한 세부사항은 드래프트 제품 편집을 참조하십시오.
    참고: 이 옵션을 사용해도 적용될 수 있는 자동 사전 플로우 비율 한계 정책이 사용 안함으로 설정되지 않으며, 이로 인해 비율 한계 적용이 반복될 수 있습니다. 프리플로우 정책에 대한 자세한 내용은 ‘프리플로우 정책 사용자 지정’을 참조하십시오.
 문자열
속도 제한 이름 예1 소스 특성이 이름별 카탈로그로 설정된 경우, DataPower API Gateway 구성에 정의된 비율 한계의 이름입니다.

비율 한계 이름 필드를 표시하려면 비율 한계 추가를 클릭하십시오. 원하는 만큼 많은 비율 한계를 추가할 수 있습니다.

1하나 이상의 비율, 버스트 또는 개수 한계를 제공해야 합니다.

 문자열
버스트 한계 이름 예2 소스 특성이 이름별 카탈로그로 설정된 경우 DataPower API Gateway 구성에 정의된 버스트 한계의 이름입니다.

소스가 이름별 플랜으로 설정된 경우 플랜에서 어셈블리 버스트 한계 이름입니다.

버스트 한계 이름 필드를 표시하려면 버스트 한계 추가를 클릭하십시오. 원하는 만큼 많은 버스트 한계를 추가할 수 있습니다.

2하나 이상의 비율, 버스트 또는 개수 한계를 제공해야 합니다.

 문자열
개수 한계 이름 예3 소스 특성이 이름별 카탈로그로 설정된 경우 DataPower API Gateway 구성에 정의된 개수 한계의 이름입니다.

소스가 이름별 플랜으로 설정된 경우 플랜에서 어셈블리 개수 한계 이름입니다.

개수 한계 이름 필드를 표시하려면 개수 한계 추가를 클릭하십시오. 원하는 만큼 많은 개수 한계를 추가할 수 있습니다.

3하나 이상의 비율, 버스트 또는 개수 한계를 제공해야 합니다.

 문자열
조작 아니오 비율 한계의 경우 다음 옵션 중 하나를 선택하십시오.
  • Consume: 정책은 비율 한계 이름 필드에서 지정한 비율 한계가 정의한 간격으로 남은 사용 가능한 요청 밸런스를 줄입니다.

    남은 밸런스가 줄어드는 크기는 지정된 비율 한계가 정의한 가중치 표현식에서 생성된 값입니다.

  • 보충: 정책은 비율 한계 이름 필드에서 지정한 비율 한계가 정의한 간격으로 남은 사용 가능한 요청 밸런스를 늘립니다.

    남은 밸런스가 늘어나는 크기는 지정된 비율 한계가 정의한 가중치 표현식에서 생성된 값입니다.

    보충 오퍼레이션의 목적은, 이전 이용 오퍼레이션에서 계산된 크기가 너무 높다고 판단되면 남은 밸런스의 적절한 크기를 복원하는 것입니다. 예를 들어, 한계가 100인 어셈블리 비율 한계의 경우 가중치가 60인 이용 오퍼레이션은 50개의 요청을 사용하고 간격에 대해 40개 요청을 남깁니다. 후속 보충 오퍼레이션에서 가중치 표현식이 15로 계산되면(즉, 실제 요청 사용은 45개만으로 가중치 표현식에서 계산됨) 보충 오퍼레이션은 남은 밸러스(55개)까지 남은 요청을 15개만큼 늘립니다.

    보충 오퍼레이션은 어셈블리 비율 한계 체계에 정의된 원래 한계를 넘어서 허용되는 남은 요청을 늘릴 수 없습니다. 이 예제에서 보충 오퍼레이션은 100개를 넘어서 요청을 보충할 수 없습니다. 가중치 표현식이 1보다 작은 값으로 평가되면 보충 오퍼레이션을 건너뜁니다.

    기본값은 이용입니다.

개수 한계의 경우 다음 옵션 중 하나를 선택하십시오.
  • 증분: 현재 개수는 개수 한계 이름 필드에 지정된 개수 한계에 정의된 가중치 표현식에서 생성된 값으로 증분됩니다.
  • 감소: 현재 개수는 개수 한계 이름 필드에 지정된 개수 한계에 정의된 가중치 표현식에서 생성된 값으로 감소됩니다.

기본적으로 카운트 한계는 어셈블리 중 증분시킨 전체량에 의해 자동으로 API 어셈블리의 마지막에 감소되며 어셈블리에서 정의된 감소 오퍼레이션을 뺍니다. 어셈블리의 특정 지점에서 감소되길 원하지 않으면 감소 오퍼레이션을 명시적으로 정의할 필요가 없습니다. 그러나 자동 감소 기능이 명시적으로 카운트 한계 구성에서 사용 안함으로 설정되면, 해당 감소 오퍼레이션을 포함해야 하며, 그렇지 않으면 카운트 한계에 도달되면 차후 모든 호출이 차단됩니다. 카운트 제한 구성에 대한 자세한 내용은 DataPower 의 ‘속도, 버스트 또는 카운트 제한 구성(Configuring a rate, burst, or count limit)’ 섹션을 참조하십시오. API Gateway.

기본값은 Increment입니다.

버스트 한계의 경우 유일한 옵션은 이용입니다. 즉, 적용되는 한계는 버스트 한계 이름 필드에서 지정한 버스트 한계에 적용된 항목입니다.

 문자열