Patch Allow List API

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

2.1에서 도입됨 {: .label .label-purple }

allow list 구성을 업데이트해요.

이 API는 슈퍼어드민 전용이에요. 사용자 이름과 비밀번호가 아니라 어드민 인증서로 인증하세요. 자세한 내용은 API 액세스 제어를 참조하세요. {: .note}

PATCH /_plugins/_security/api/allowlist

요청 본문은 필수이고, JSON 객체의 배열이에요. 각 객체에는 다음 필드가 들어 있어요.

필드	데이터 타입	설명	필수
`op`	String	수행할 연산이에요. 유효한 값은 `add`, `remove`, `replace`, `move`, `copy`, `test`예요.	예
`path`	String	수정할 경로예요. 예를 들어 `/config/enabled`, `/config/requests`가 있어요. 경로는 JSON Pointer 문법을 사용하기 때문에 요청 경로에 슬래시가 있으면 `~1`로 이스케이프해야 해요. 예를 들어 `/_cat/shards` 항목의 경로는 `/config/requests/~1_cat~1shards`예요.	예
`value`	Object or array	새 값이에요. `add`, `replace`, `test` 연산에는 필수예요.	아니요

다음 요청은 /_cat/shards 엔드포인트를 allow list에 추가해요:

PATCH _plugins/_security/api/allowlist
[
  {
    "op": "add",
    "path": "/config/requests/~1_cat~1shards",
    "value": [
      "GET"
    ]
  }
]

{% include copy-curl.html security=true %}

{
  "status": "OK",
  "message": "Resource updated."
}