14.2. API 끝점

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

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

14.2.1. /api/v1/pods

HTTP 방법: GET
설명: Pod 유형의 오브젝트 나열 또는 감시

표 14.1. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`PodList` 스키마
401 - 무단	빈

14.2.2. /api/v1/watch/pods

HTTP 방법: GET
설명: Pod 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.

표 14.2. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`WatchEvent` 스키마
401 - 무단	빈

14.2.3. /api/v1/namespaces/{namespace}/pods

HTTP 방법: DELETE
설명: Pod 컬렉션 삭제

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

표 14.4. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`상태` 스키마
401 - 무단	빈

HTTP 방법: GET
설명: Pod 유형의 오브젝트 나열 또는 감시

표 14.5. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`PodList` 스키마
401 - 무단	빈

HTTP 방법: POST
설명: Pod 생성

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

표 14.7. 본문 매개변수
매개변수	유형	설명
`body`	`Pod` 스키마

표 14.8. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`Pod` 스키마
201 - 생성됨	`Pod` 스키마
202 - 승인됨	`Pod` 스키마
401 - 무단	빈

14.2.4. /api/v1/watch/namespaces/{namespace}/pods

HTTP 방법: GET
설명: Pod 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.

표 14.9. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`WatchEvent` 스키마
401 - 무단	빈

14.2.5. /api/v1/namespaces/{namespace}/pods/{name}

표 14.10. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	Pod 이름

HTTP 방법: DELETE
설명: Pod 삭제

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

표 14.12. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`Pod` 스키마
202 - 승인됨	`Pod` 스키마
401 - 무단	빈

HTTP 방법: GET
설명: 지정된 Pod 읽기

표 14.13. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`Pod` 스키마
401 - 무단	빈

HTTP 방법: PATCH
설명: 지정된 Pod를 부분적으로 업데이트

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

표 14.15. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`Pod` 스키마
201 - 생성됨	`Pod` 스키마
401 - 무단	빈

HTTP 방법: PUT
설명: 지정된 Pod를 교체

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

표 14.17. 본문 매개변수
매개변수	유형	설명
`body`	`Pod` 스키마

표 14.18. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`Pod` 스키마
201 - 생성됨	`Pod` 스키마
401 - 무단	빈

14.2.6. /api/v1/namespaces/{namespace}/pods/{name}/log

표 14.19. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	Pod 이름

HTTP 방법: GET
설명: 지정된 Pod의 로그 읽기

표 14.20. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`string`
401 - 무단	빈

14.2.7. /api/v1/watch/namespaces/{namespace}/pods/{name}

표 14.21. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	Pod 이름

HTTP 방법: GET
설명: 더 이상 사용되지 않는 Pod의 오브젝트 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.

표 14.22. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`WatchEvent` 스키마
401 - 무단	빈

14.2.8. /api/v1/namespaces/{namespace}/pods/{name}/status

표 14.23. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	Pod 이름

HTTP 방법: GET
설명: 지정된 Pod의 상태 확인

표 14.24. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`Pod` 스키마
401 - 무단	빈

HTTP 방법: PATCH
설명: 지정된 Pod의 부분적으로 업데이트 상태

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

표 14.26. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`Pod` 스키마
201 - 생성됨	`Pod` 스키마
401 - 무단	빈

HTTP 방법: PUT
설명: 지정된 Pod의 상태 교체

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

표 14.28. 본문 매개변수
매개변수	유형	설명
`body`	`Pod` 스키마

표 14.29. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`Pod` 스키마
201 - 생성됨	`Pod` 스키마
401 - 무단	빈

14.2.9. /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

표 14.30. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	Pod 이름

HTTP 방법: GET
설명: 지정된 Pod의 ephemeralcontainers 읽기

표 14.31. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`Pod` 스키마
401 - 무단	빈

HTTP 방법: PATCH
설명: 지정된 Pod의 임시containers를 부분적으로 업데이트

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

표 14.33. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`Pod` 스키마
201 - 생성됨	`Pod` 스키마
401 - 무단	빈

HTTP 방법: PUT
설명: 지정된 Pod의 ephemeralcontainers 교체

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

표 14.35. 본문 매개변수
매개변수	유형	설명
`body`	`Pod` 스키마

표 14.36. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`Pod` 스키마
201 - 생성됨	`Pod` 스키마
401 - 무단	빈

14.2. API 끝점

14.2.1. /api/v1/pods

14.2.2. /api/v1/watch/pods

14.2.3. /api/v1/namespaces/{namespace}/pods

14.2.4. /api/v1/watch/namespaces/{namespace}/pods

14.2.5. /api/v1/namespaces/{namespace}/pods/{name}

14.2.6. /api/v1/namespaces/{namespace}/pods/{name}/log

14.2.7. /api/v1/watch/namespaces/{namespace}/pods/{name}

14.2.8. /api/v1/namespaces/{namespace}/pods/{name}/status

14.2.9. /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Red Hat legal and privacy links

Red Hat legal and privacy links