22.2. API 끝점

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

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

22.2.1. /api/v1/services

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

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

22.2.2. /api/v1/watch/services

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

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

22.2.3. /api/v1/namespaces/{namespace}/services

HTTP 방법: DELETE
설명: 서비스 컬렉션 삭제

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

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

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

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

HTTP 방법: POST
설명: 서비스 생성

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

표 22.7. 본문 매개변수
매개변수	유형	설명
`body`	`서비스` 스키마

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

22.2.4. /api/v1/watch/namespaces/{namespace}/services

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

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

22.2.5. /api/v1/namespaces/{namespace}/services/{name}

표 22.10. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	서비스 이름

HTTP 방법: DELETE
설명: 서비스 삭제

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

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

HTTP 방법: GET
설명: 지정된 서비스 읽기

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

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

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

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

HTTP 방법: PUT
설명: 지정된 서비스를 교체

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

표 22.17. 본문 매개변수
매개변수	유형	설명
`body`	`서비스` 스키마

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

22.2.6. /api/v1/watch/namespaces/{namespace}/services/{name}

표 22.19. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	서비스 이름

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

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

22.2.7. /api/v1/namespaces/{namespace}/services/{name}/status

표 22.21. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	서비스 이름

HTTP 방법: GET
설명: 지정된 서비스의 읽기 상태

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

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

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

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

HTTP 방법: PUT
설명: 지정된 서비스의 상태 교체

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

표 22.26. 본문 매개변수
매개변수	유형	설명
`body`	`서비스` 스키마

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

22.2. API 끝점

22.2.1. /api/v1/services

22.2.2. /api/v1/watch/services

22.2.3. /api/v1/namespaces/{namespace}/services

22.2.4. /api/v1/watch/namespaces/{namespace}/services

22.2.5. /api/v1/namespaces/{namespace}/services/{name}

22.2.6. /api/v1/watch/namespaces/{namespace}/services/{name}

22.2.7. /api/v1/namespaces/{namespace}/services/{name}/status

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

Red Hat 소개

Red Hat legal and privacy links

Red Hat legal and privacy links