8.2. API 끝점

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

/apis/apps/v1/deployments
- GET: 배포 유형의 오브젝트 목록 또는 감시
/apis/apps/v1/watch/deployments
- GET: Deployment. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
/apis/apps/v1/namespaces/{namespace}/deployments
- DELETE: Deployment 컬렉션 삭제
- GET: 배포 유형의 오브젝트 목록 또는 감시
- POST: Deployment 생성
/apis/apps/v1/watch/namespaces/{namespace}/deployments
- GET: Deployment. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
/apis/apps/v1/namespaces/{namespace}/deployments/{name}
- DELETE: Deployment 삭제
- GET: 지정된 배포 읽기
- PATCH: 지정된 배포를 부분적으로 업데이트
- PUT: 지정된 배포를 교체
/apis/apps/v1/watch/namespaces/{namespace}/deployments/{name}
- GET: 유형의 Deployment. deprecated 개체 변경 사항을 조사합니다. 대신 목록 작업과 함께 'watch' 매개 변수를 사용하고 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
/apis/apps/v1/namespaces/{namespace}/deployments/{name}/status
- GET: 지정된 배포의 읽기 상태
- PATCH: 지정된 배포의 부분 업데이트 상태
- PUT: 지정된 배포의 상태

8.2.1. /apis/apps/v1/deployments

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

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

8.2.2. /apis/apps/v1/watch/deployments

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

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

8.2.3. /apis/apps/v1/namespaces/{namespace}/deployments

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

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

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

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

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

HTTP 방법: POST
설명: 배포 생성

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

표 8.7. 본문 매개변수
매개변수	유형	설명
`body`	`배포` 스키마

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

8.2.4. /apis/apps/v1/watch/namespaces/{namespace}/deployments

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

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

8.2.5. /apis/apps/v1/namespaces/{namespace}/deployments/{name}

표 8.10. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	배포 이름

HTTP 방법: DELETE
설명: 배포 삭제

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

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

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

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

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

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

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

HTTP 방법: PUT
설명: 지정된 배포 교체

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

표 8.17. 본문 매개변수
매개변수	유형	설명
`body`	`배포` 스키마

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

8.2.6. /apis/apps/v1/watch/namespaces/{namespace}/deployments/{name}

표 8.19. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	배포 이름

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

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

8.2.7. /apis/apps/v1/namespaces/{namespace}/deployments/{name}/status

표 8.21. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	배포 이름

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

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

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

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

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

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

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

표 8.26. 본문 매개변수
매개변수	유형	설명
`body`	`배포` 스키마

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

8.2. API 끝점

8.2.1. /apis/apps/v1/deployments

8.2.2. /apis/apps/v1/watch/deployments

8.2.3. /apis/apps/v1/namespaces/{namespace}/deployments

8.2.4. /apis/apps/v1/watch/namespaces/{namespace}/deployments

8.2.5. /apis/apps/v1/namespaces/{namespace}/deployments/{name}

8.2.6. /apis/apps/v1/watch/namespaces/{namespace}/deployments/{name}

8.2.7. /apis/apps/v1/namespaces/{namespace}/deployments/{name}/status

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

Red Hat 소개

Red Hat legal and privacy links

Red Hat legal and privacy links