Patch Distinguished Names API
출처: 문서
본문
패치 고유 이름 API
1.0에서 도입됨 {: .label .label-purple }
허용 목록의 고유 이름을 교체하지 않고 업데이트합니다. 클러스터 이름을 지정하여 하나의 클러스터에 대한 고유 이름을 업데이트하거나, 클러스터 이름을 생략하여 대량 업데이트를 수행할 수 있습니다.
이 API는 슈퍼관리자용으로 예약되어 있습니다. 사용자 이름과 비밀번호 대신 관리자 인증서로 인증하세요. 자세한 내용은 API 액세스 제어를 참조하세요. {: .note}
엔드포인트
PATCH /_plugins/_security/api/nodesdn
PATCH /_plugins/_security/api/nodesdn/{cluster_name}
경로 매개변수
다음 표에서는 사용 가능한 경로 매개변수를 설명합니다.
| 매개변수 | 데이터 타입 | 필수 여부 | 설명 |
|---|---|---|---|
cluster_name |
String | 아니요 | 노드 고유 이름을 업데이트하려는 클러스터의 이름입니다. 생략하면 요청이 여러 클러스터를 수정할 수 있습니다. |
요청 본문 필드
요청 본문은 필수입니다. JSON 객체의 배열입니다. 각 객체에는 다음 필드가 포함됩니다.
| 필드 | 데이터 타입 | 설명 | 필수 여부 |
|---|---|---|---|
op |
String | 수행할 작업입니다. 유효한 값은 add, remove, replace, move, copy, test입니다. |
예 |
path |
String | 수정할 경로입니다. 클러스터 이름을 지정하면 경로는 해당 클러스터를 기준으로 합니다(예: /nodes_dn/0). 클러스터 이름을 생략하면 경로는 클러스터 이름으로 시작합니다(예: /cluster1/nodes_dn/0). |
예 |
value |
Array | 업데이트에 사용되는 새 값입니다. add, replace, test 작업에 필요합니다. |
아니요 |
예제 요청
다음 요청은 cluster1 허용 목록의 첫 번째 고유 이름을 교체합니다.
PATCH _plugins/_security/api/nodesdn/cluster1
[
{
"op":"replace",
"path":"/nodes_dn/0",
"value": ["CN=Karen Berge,CN=admin,DC=corp,DC=Fabrikam,DC=COM", "CN=George Wall,CN=admin,DC=corp,DC=Fabrikam,DC=COM"]
}
]
{% include copy-curl.html security=true %}
다음 요청은 대량 업데이트의 일부로 동일한 변경을 수행합니다.
PATCH _plugins/_security/api/nodesdn
[
{
"op":"replace",
"path":"/cluster1/nodes_dn/0",
"value": ["CN=Karen Berge,CN=admin,DC=corp,DC=Fabrikam,DC=COM", "CN=George Wall,CN=admin,DC=corp,DC=Fabrikam,DC=COM"]
}
]
{% include copy-curl.html security=true %}
예제 응답
하나의 클러스터에 대한 허용 목록을 업데이트하는 요청은 응답에 해당 클러스터 이름을 포함합니다.
{
"status": "OK",
"message": "'cluster1' updated."
}
대량 요청은 변경된 클러스터를 명명하지 않습니다.
{
"status": "OK",
"message": "Resource updated."
}
응답 본문 필드
응답 본문은 다음 필드가 포함된 JSON 객체입니다.
| 필드 | 데이터 타입 | 설명 |
|---|---|---|
status |
String | 요청의 상태입니다. 성공적인 요청은 OK를 반환합니다. |
message |
String | 작업 결과를 설명하는 메시지입니다. |