인바운드 REST API 속도 제한 생성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 2분
  • 요율 제한 규칙을 생성하여 시간당 처리되는 인바운드 REST API 요청 수를 제한합니다.

    시작하기 전에

    필요한 역할: rate_limit_admin

    이 태스크 정보

    모든 사용자, 특정 역할이 있는 사용자 또는 모든 사용자에 대한 속도 제한을 설정합니다.
    주:
    요청이 인스턴스에 도달하면 각 노드는 사용자당 속도 제한 수를 유지합니다. 30초마다 카운트가 데이터베이스에 커밋됩니다. 따라서 속도 제한 규칙이 최대 30초 동안 적용되지 않을 수 있습니다.

    프로시저

    1. 다음으로 이동 모두 > 시스템 웹 서비스 > REST > 요율 제한 규칙.
    2. 새로 만들기를 클릭하고 다음 필드 값을 입력합니다.
      표 1. REST API 속도 제한 규칙 양식
      필드 설명
      REST API 자원 값은 다음 필드에 입력한 값에서 파생됩니다.
      이름 요율 제한 규칙의 고유한 이름입니다.
      REST API 인스턴스에 대한 모든 외부 연결 REST API 목록에서 선택한 REST API입니다.
      버전 REST API의 버전입니다. 나열된 값은 선택한 REST API 에 따라 달라집니다.
      자원 버전에 대한 자원입니다. 나열된 값은 선택한 버전에 따라 다릅니다.
      테이블 대상으로 지정할 테이블입니다. 테이블 APIREST API로 선택한 경우에만 나타납니다.
      임포트 세트 테이블 대상으로 지정할 임포트 세트 테이블입니다. 임포트 세트 APIREST API로 선택한 경우에만 나타납니다.
      활성 속도 제한 규칙이 활성 상태임을 나타내는 확인란입니다.

      요율 제한 규칙은 생성하자마자 기본적으로 활성화됩니다. 요율 제한 규칙을 비활성화하여 요율 제한 적용을 중지하거나 요율 제한 규칙을 활성화하여 요율 제한 적용을 재개할 수 있습니다.

      시간당 요청 제한 시간당 허용되는 최대 요청 수입니다.
      주:
      이 필드의 값을 업데이트할 때마다 요청 ServiceNow AI Platform 수가 0으로 재설정되고 현재 시간의 모든 위반이 삭제됩니다.
      적용 대상 이 규칙에 의해 제한되는 사용자:
      • 단일 사용자는 특정 사용자에게 속도 제한을 적용합니다.
      • 역할이 있는 사용자는 특정 역할을 가진 모든 사용자에게 속도 제한을 적용합니다.
      • 모든 사용자는 모든 사용자에게 요율 제한을 적용합니다.
      역할 요율 제한이 적용되는 역할입니다. 적용 대상 필드에서 역할을 가진 사용자를 선택한 경우에만 나타납니다.
      사용자 요율 제한이 적용되는 사용자입니다. 적용 대상 필드에서 단일 사용자를 선택한 경우에만 나타납니다.
    3. 제출을 클릭합니다.
      새로운 요율 제한이 적용됩니다.

    다음에 수행할 작업

    규칙을 제출하면 는 ServiceNow AI Platform 규칙 기록에 다음 관련 목록을 추가합니다.
    요율 제한 수
    이 속도 제한 규칙의 영향을 받는 인바운드 REST API 요청 수를 사용자별로 나열합니다.
    요율 제한 위반
    이 속도 제한 규칙의 위반을 사용자별로 나열합니다.

    이러한 관련 목록을 사용하여 를 수행할 수 있습니다 인바운드 REST API 요율 제한 횟수 및 위반 모니터링.