13.2. API 끝점

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

/apis/batch/v1/jobs
- GET: 작업 유형의 오브젝트 나열 또는 감시
/apis/batch/v1/watch/jobs
- GET: individual changes to a list of Job. deprecated: 대신 list 작업과 함께 'watch' 매개변수를 사용합니다.
/apis/batch/v1/namespaces/{namespace}/jobs
- DELETE: 작업 컬렉션 삭제
- GET: 작업 유형의 오브젝트 나열 또는 감시
- POST: 작업 생성
/apis/batch/v1/watch/namespaces/{namespace}/jobs
- GET: individual changes to a list of Job. deprecated: 대신 list 작업과 함께 'watch' 매개변수를 사용합니다.
/apis/batch/v1/namespaces/{namespace}/jobs/{name}
- DELETE: 작업 삭제
- GET: 지정된 작업 읽기
- PATCH: 지정된 작업을 부분적으로 업데이트
- PUT: 지정된 작업 교체
/apis/batch/v1/watch/namespaces/{namespace}/jobs/{name}
- GET: 더 이상 사용되지 않는 종류의 오브젝트를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
/apis/batch/v1/namespaces/{namespace}/jobs/{name}/status
- GET: 지정된 작업의 읽기 상태
- PATCH: 지정된 작업의 부분 업데이트 상태
- PUT: 지정된 작업의 상태

13.2.1. /apis/batch/v1/jobs

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

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

13.2.2. /apis/batch/v1/watch/jobs

HTTP 방법: GET
설명: Job. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.

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

13.2.3. /apis/batch/v1/namespaces/{namespace}/jobs

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

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

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

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

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

HTTP 방법: POST
설명: 작업 생성

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

표 13.7. 본문 매개변수
매개변수	유형	설명
`body`	`작업` 스키마

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

13.2.4. /apis/batch/v1/watch/namespaces/{namespace}/jobs

HTTP 방법: GET
설명: Job. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.

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

13.2.5. /apis/batch/v1/namespaces/{namespace}/jobs/{name}

표 13.10. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	작업 이름

HTTP 방법: DELETE
설명: 작업 삭제

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

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

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

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

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

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

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

HTTP 방법: PUT
설명: 지정된 작업 교체

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

표 13.17. 본문 매개변수
매개변수	유형	설명
`body`	`작업` 스키마

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

13.2.6. /apis/batch/v1/watch/namespaces/{namespace}/jobs/{name}

표 13.19. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	작업 이름

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

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

13.2.7. /apis/batch/v1/namespaces/{namespace}/jobs/{name}/status

표 13.21. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	작업 이름

HTTP 방법: GET
설명: 지정된 작업의 읽기 상태

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

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

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

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

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

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

표 13.26. 본문 매개변수
매개변수	유형	설명
`body`	`작업` 스키마

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

13.2. API 끝점

13.2.1. /apis/batch/v1/jobs

13.2.2. /apis/batch/v1/watch/jobs

13.2.3. /apis/batch/v1/namespaces/{namespace}/jobs

13.2.4. /apis/batch/v1/watch/namespaces/{namespace}/jobs

13.2.5. /apis/batch/v1/namespaces/{namespace}/jobs/{name}

13.2.6. /apis/batch/v1/watch/namespaces/{namespace}/jobs/{name}

13.2.7. /apis/batch/v1/namespaces/{namespace}/jobs/{name}/status

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

Red Hat 소개

Red Hat legal and privacy links

Red Hat legal and privacy links