명령 옵션

DNS_DOMAIN_ID

DNS 도메인의 ID입니다. 필수.

--json

속도 제한 규칙을 정의하는 데 사용되는 JSON 파일 또는 JSON 문자열.

• JSON 데이터에서 필수 입력 항목은 match, threshold, period 및 action 입니다:
  • match: 속도 제한 규칙이 임계값 산정에 어떤 트래픽을 포함할지 결정합니다.
    • request: HTTP 요청과 일치합니다.
      • methods: HTTP 메서드는 [POST,PUT] 의 일부이거나 [_ALL_] 의 전부일 수 있습니다. 이 필드는 속도 제한 규칙을 작성하는 데 있어서 필수가 아닙니다. 올바른 값은 GET, POST, PUT, DELETE, PATCH, HEAD, _ALL_입니다.
      • schemes: HTTP 스킴은, [HTTPS] 중 하나이거나, [HTTP,HTTPS] 둘 모두이거나, [_ALL_] 모두일 수 있습니다. 이 필드는 필수가 아닙니다.
      • url: 호스트와 경로로 구성된 주소를 일치시키는 ‘ URL ’ 패턴입니다. 예를 들어, example.org/path 과 같은 경우입니다. 와일드카드는 해당되는 트래픽과 일치하도록 확장되며, 조회 문자열은 비교되지 않습니다. 구역에 대한 모든 트래픽에 대해서는 *를 사용하십시오. 최대 길이는 1024 입니다.
    • response: 클라이언트에 반환되기 전에 HTTP 응답을 일치시킵니다. 이 항목이 정의된 경우에는 트래픽의 전체 계산이 이 단계에서 수행됩니다.
      • status: HTTP 상태 코드는, 하나 [403], 여러 개 [401,403] 를 지정할 수 있으며, 이 값을 지정하지 않으면 모두를 의미합니다. 이 필드는 필수가 아닙니다. 최소값은 100 이고, 최대값은 999 입니다.
      • headers: 일치시킬 응답 헤더의 배열. 응답이 헤더 기준을 충족하지 않는 경우, 해당 요청은 속도 제한 규칙의 적용 대상에서 제외됩니다. 헤더 일치 기준에는 다음 속성이 포함됩니다.
        • name: 일치시킬 응답 헤더의 이름.
        • op: 일치 연산자에서, eq는 ‘같음’을, ne는 ‘다름’을 의미합니다. 올바른 값은 eq 및 ne입니다.
        • value: 정확히 일치하는 헤더의 값입니다.
  • threshold: 속도 제한 완화 조치가 발동되는 임계값으로, 특정 기간과 결합되어 적용됩니다. 예를 들어, 기간별 기준치입니다. 최소값은 2 이고, 최대값은 1000000 입니다.
  • period: 일치하는 트래픽을 집계하는 데 걸리는 시간(초 단위). 이 기간 내에 카운트가 임계값을 초과하면 해당 조치가 실행됩니다. 최소값은 10 이고, 최대값은 86400 입니다.
  • action: 지정된 기간 내 일치하는 트래픽의 임계값을 초과했을 때 수행되는 조치.
    • mode: 수행된 작업의 유형. 올바른 값은 simulate, ban, challenge, js_challenge입니다.
    • timeout: 완화 조치를 수행하는 데 소요되는 시간을 초 단위로, 정수 값으로 지정합니다. 타임아웃은 해당 기간과 같거나 그보다 길 수 있습니다. 이 필드는 모드가 ‘ simulate ’ 또는 ‘ ban ’일 때만 유효합니다. 최소값은 10 이고, 최대값은 86400 입니다.
    • response: 반환할 사용자 정의 콘텐츠 유형 및 본문. 이는 구역에 대한 사용자 정의 오류를 대체합니다. 이 필드는 필수가 아닙니다. 이를 생략하면 기본 HTML 오류 페이지가 사용됩니다. 이 필드는 mode가 simulate 또는 ban인 경우에만 유효합니다.
      • content_type: 본문의 콘텐츠 유형으로, 다음 중 하나여야 합니다: text/plain, text/xml, application/json.
      • body: 돌아올 몸. 해당 컨텐츠는 content_type을 따라야 합니다. 최대 길이는 10240 입니다.
• 선택적 필드는 id, disabled, description, correlate 및 bypass입니다.
  • id: 속도 제한 규칙의 식별자.
  • disabled: 이 속도 제한 규칙이 현재 비활성화되어 있는지 여부.
  • description: 속도 제한 규칙의 적용 사유를 설명하는 데 사용할 수 있는 메모입니다.
  • correlate: NAT 기반 속도 제한을 활성화할지 여부.
    • by: 유효한 값은 nat 입니다.
  • bypass: 속도 제한을 우회할 수 있게 해주는 기준. 예를 들어, 특정 URL 집합에는 속도 제한을 적용해서는 안 된다는 것을 표현할 때.
    • name: 유효한 값은 url 입니다.
    • value: 우회할 URL.

샘플 JSON 데이터:

{
   "id": "92f17202ed8bd63d69a66b86a49a8f6b",
   "disabled": false,
   "description": "Prevent multiple login failures to mitigate brute force attacks",
   "bypass": [
      {
         "name": "url",
         "value": "api.example.com/*"
      }
   ],
   "threshold": 60,
   "period": 900,
   "correlate": {
      "by": "nat"
   },
   "action": [
      {
         "mode": "simulate",
         "timeout": 86400,
         "response": {
            "content_type": "text/plain",
            "body": "<error>This request has been rate-limited.</error>"
         }
      }
   ],
   "match": {
      "request": {
               "methods": [
                  "GET"
               ],
               "schemes": [
                  "HTTP",
                  "HTTPS"
               ],
               "url": "*.example.org/path*"
      },
      "response": {
         "status": [
               403, 401
         ],
         "headers": [
            {
               "name": "Cf-Cache-Status",
               "op": "eq",
               "value": "HIT"
            }
         ]
      }
   }
}

-i, --instance

인스턴스 이름 또는 ID입니다. 인스턴스 이름이나 ID가 설정되지 않은 경우, ibmcloud cis instance-set INSTANCE 로 지정된 컨텍스트 인스턴스가 사용됩니다.

--output

출력 형식입니다. 현재 ‘ json ’만이 지원되는 값입니다.

명령 옵션

DNS_DOMAIN_ID

DNS 도메인의 ID입니다. 필수.

RATELIMIT_RULE_ID

속도 제한 규칙의 ID입니다. 필수.

--json

속도 제한 규칙을 정의하는 데 사용되는 JSON 파일 또는 JSON 문자열입니다.

• JSON 데이터에서 필수 입력 항목은 match, threshold, period 및 action 입니다:
  • match: 속도 제한 규칙이 임계값 산정에 어떤 트래픽을 포함할지 결정합니다.
    • request: HTTP 요청과 일치합니다.
      • methods: HTTP 메서드는 [POST,PUT] 의 일부이거나 [ALL] 의 전부일 수 있습니다. 이 필드는 속도 제한 규칙을 작성하는 데 있어서 필수가 아닙니다. 올바른 값은 GET, POST, PUT, DELETE, PATCH, HEAD, ALL입니다.
      • schemes: HTTP 스킴은, 하나 [HTTPS], 둘 모두 [HTTP,HTTPS] 또는 모두 [_ALL_] 일 수 있습니다. 이 필드는 필수가 아닙니다.
      • url: 일치 대상인 URL 패턴은 호스트와 경로로 구성되었으며, 예를 들어 example.org/path 과 같습니다. 와일드카드는 해당되는 트래픽과 일치하도록 확장되며, 조회 문자열은 비교되지 않습니다. 구역에 대한 모든 트래픽에 대해서는 *를 사용하십시오. 최대 길이는 1024 입니다.
    • response: 클라이언트에 반환되기 전에 HTTP 응답을 일치시킵니다. 이 필드가 정의된 경우, 트래픽 계수는 이 단계에서 모두 수행됩니다.
      • status: HTTP 상태 코드는, 하나 [403], 여러 개 [401,403] 를 지정할 수 있으며, 이 값을 지정하지 않으면 모두를 의미합니다. 이 필드는 필수가 아닙니다. 최소값은 100 이고, 최대값은 999 입니다.
      • headers: 일치시킬 응답 헤더의 배열. 응답이 헤더 기준을 충족하지 않는 경우, 해당 요청은 속도 제한 규칙의 적용 대상에서 제외됩니다. 헤더 일치 기준에는 다음과 같은 속성들이 포함됩니다.
        • name: 일치시킬 응답 헤더의 이름.
        • op: 일치 연산자에서, eq는 ‘같음’을, ne는 ‘다름’을 의미합니다. 올바른 값은 eq 및 ne입니다.
        • value: 정확히 일치하는 헤더의 값입니다.
  • threshold: 기간과 결합되어 속도 제한 완화 조치를 발동시키는 임계값입니다. 예를 들어, 기간별 기준치입니다. 최소값은 2 이고, 최대값은 1000000 입니다.
  • period: 일치하는 트래픽을 집계하는 데 걸리는 시간(초 단위). 이 기간 내에 카운트가 임계값을 초과하면 해당 조치가 실행됩니다. 최소값은 1 이고, 최대값은 3600 입니다.
  • action: 정의된 기간 내에 일치하는 트래픽의 임계값을 초과할 경우 해당 조치가 수행됩니다.
    • mode: 수행된 작업의 유형. 유효한 값은 simulate, ban, challenge, js_challenge 입니다.
    • timeout: 완화 조치를 수행하는 데 걸리는 시간(초 단위)을 정수 값으로 표시합니다. 타임아웃이 해당 기간과 같거나 그보다 큽니다. 이 필드는 mode가 simulate 또는 ban인 경우에만 유효합니다. 최소값은 10 이고, 최대값은 86400 입니다.
    • response: 반환할 사용자 정의 콘텐츠 유형 및 본문. 이는 구역에 대한 사용자 정의 오류를 대체합니다. 이 필드는 필수가 아닙니다. 이를 생략하면 기본 HTML 오류 페이지가 사용됩니다. 이 필드는 mode가 simulate 또는 ban인 경우에만 유효합니다.
      • content_type: 본문의 콘텐츠 유형으로, 다음 중 하나여야 합니다: text/plain, text/xml, application/json.
      • body: 돌아올 몸. 해당 컨텐츠는 content_type을 따라야 합니다. 최대 길이는 10240 입니다.
• 선택적 필드는 disabled, description, correlate 및 bypass입니다.
  • disabled: 이 속도 제한 규칙이 현재 비활성화되어 있는지 여부.
  • description: 속도 제한 규칙의 적용 사유를 설명하는 데 사용할 수 있는 메모입니다.
  • correlate: NAT 기반 속도 제한을 활성화할지 여부.
    • by: 유효한 값은 nat 입니다.
  • bypass: 속도 제한을 우회할 수 있게 해주는 기준. 예를 들어, 특정 URL 집합에는 속도 제한을 적용해서는 안 된다는 것을 표현할 때.
    • name: 유효한 값은 url 입니다.
    • value: 우회할 URL.

샘플 JSON 데이터:

{
   "disabled": false,
   "description": "Prevent multiple login failures to mitigate brute force attacks",
   "bypass": [
      {
         "name": "url",
         "value": "api.example.com/*"
      }
   ],
   "threshold": 60,
   "period": 900,
   "correlate": {
      "by": "nat"
   },
   "action": [
      {
         "mode": "simulate",
         "timeout": 86400,
         "response": {
            "content_type": "text/plain",
            "body": "<error>This request has been rate-limited.</error>"
         }
      }
   ],
   "match": {
      "request": {
               "methods": [
                  "GET"
               ],
               "schemes": [
                  "HTTP",
                  "HTTPS"
               ],
               "url": "*.example.org/path*"
      },
      "response": {
         "status": [
               403, 401
         ],
         "headers": [
            {
               "name": "Cf-Cache-Status",
               "op": "eq",
               "value": "HIT"
            }
         ]
      }
   }
}

-i, --instance

인스턴스 이름 또는 ID입니다. 설정되지 않은 경우, ibmcloud cis instance-set INSTANCE 로 지정된 컨텍스트 인스턴스가 사용됩니다.

--output

출력 형식을 지정하십시오. ‘ JSON ’만 지원됩니다.

명령 옵션

DNS_DOMAIN_ID

DNS 도메인의 ID입니다. 필수.

RATELIMIT_RULE_ID

속도 제한 규칙의 ID입니다. 필수.

-i, --instance

인스턴스 이름 또는 ID입니다. 설정되지 않은 경우, ibmcloud cis instance-set INSTANCE 로 지정된 컨텍스트 인스턴스가 사용됩니다.

자세한 내용은 CLI 속도 제한을 참조하십시오.