2.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

/api/v1/nodes
- DELETE: 노드 컬렉션 삭제
- GET: 종류 노드의 개체 나열 또는 조사
- POST: 노드 생성
/api/v1/watch/nodes
- GET: 노드 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않음: 대신 목록 작업에 'watch' 매개변수를 사용합니다.
/api/v1/nodes/{name}
- DELETE: 노드 삭제
- GET: 지정된 노드를 읽기
- PATCH: 지정된 노드를 부분적으로 업데이트
- PUT: 지정된 노드를 교체합니다.
/api/v1/watch/nodes/{name}
- GET: 종류 Node의 오브젝트에 대한 변경 사항을 조사합니다. 더 이상 사용되지 않음: 대신 'watch' 매개변수를 목록 작업과 함께 사용하고 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
/api/v1/nodes/{name}/status
- GET: 지정된 노드의 상태 읽기
- PATCH : 지정된 노드의 상태를 부분적으로 업데이트합니다.
- PUT: 지정된 노드의 상태를 교체

표 2.1. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식되지 않는 dryRun 지시어로 인해 오류 응답이 생성되고 요청이 추가로 처리되지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

표 2.2. HTTP 응답
HTTP 코드	반환 본문
200 - 확인	`상태` 스키마
401 - 허용되지 않음	비어있는

표 2.3. HTTP 응답
HTTP 코드	반환 본문
200 - 확인	`NodeList` 스키마
401 - 허용되지 않음	비어있는

표 2.4. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식되지 않는 dryRun 지시어로 인해 오류 응답이 생성되고 요청이 추가로 처리되지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	fieldValidation은 알 수 없거나 중복 필드가 포함된 요청(POST/PUT/PATCH)에서 오브젝트를 처리하는 방법을 서버에 지시합니다. 유효한 값은 다음과 같습니다. - Ignore: 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 발생하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - Warn: 오브젝트에서 삭제된 알 수 없는 필드와 발생한 중복 필드마다 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+의 기본값 - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 확인되지 않거나 중복된 필드가 모두 포함됩니다.

표 2.5. 본문 매개변수
매개변수	유형	설명
`body`	`노드` 스키마