클러스터 API

OpenShift Container Platform 4.17

클러스터 API에 대한 참조 가이드

Red Hat OpenShift Documentation Team

법적 공지

초록

이 문서에서는 OpenShift Container Platform 클러스터 API 오브젝트 및 세부 사양에 대해 설명합니다.

1장. 클러스터 API

1.1. IPAddress [ipam.cluster.x-k8s.io/v1beta1]

설명: IPAddress는 ipaddress API의 스키마입니다.
유형: object

1.2. IPAddressClaim [ipam.cluster.x-k8s.io/v1beta1]

설명: IPAddressClaim은 ipaddressclaim API의 스키마입니다.
유형: object

2장. IPAddress [ipam.cluster.x-k8s.io/v1beta1]

설명: IPAddress는 ipaddress API의 스키마입니다.
유형: object

2.1. 사양

속성	유형	설명
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`string`	kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`메타데이터`	`ObjectMeta`	표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec`	`object`	IPAddressSpec은 IPAddress의 원하는 상태입니다.

2.1.1. .spec

설명

IPAddressSpec은 IPAddress의 원하는 상태입니다.

유형

object

필수 항목

address
claimRef
poolRef
prefix

속성	유형	설명
`address`	`string`	주소는 IP 주소입니다.
`claimRef`	`object`	claimRef는 이 IPAddress가 생성된 클레임에 대한 참조입니다.
`gateway`	`string`	게이트웨이는 주소가 들어오는 네트워크의 네트워크 게이트웨이입니다.
`poolRef`	`object`	PoolRef는 이 IPAddress가 생성된 풀에 대한 참조입니다.
`prefix`	`integer`	prefix는 주소의 접두사입니다.

2.1.2. .spec.claimRef

설명: claimRef는 이 IPAddress가 생성된 클레임에 대한 참조입니다.
유형: object

속성	유형	설명
`name`	`string`	추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

2.1.3. .spec.poolRef

설명

PoolRef는 이 IPAddress가 생성된 풀에 대한 참조입니다.

유형

object

필수 항목

kind
name

속성	유형	설명
`apiGroup`	`string`	APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다.
`kind`	`string`	kind는 참조되는 리소스 유형입니다.
`name`	`string`	name은 참조되는 리소스의 이름입니다.

2.2. API 끝점

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

/apis/ipam.cluster.x-k8s.io/v1beta1/ipaddresses
- GET: 종류의 IPAddress 오브젝트 나열
/apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddresses
- DELETE: IPAddress 컬렉션 삭제
- GET: 종류의 IPAddress 오브젝트 나열
- POST: IPAddress 생성
/apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddresses/{name}
- DELETE: IPAddress 삭제
- GET: 지정된 IPAddress 읽기
- PATCH: 지정된 IPAddress를 부분적으로 업데이트
- PUT: 지정된 IPAddress를 교체

2.2.1. /apis/ipam.cluster.x-k8s.io/v1beta1/ipaddresses

HTTP 방법: GET
설명: 종류의 IPAddress 개체 나열

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

2.2.2. /apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddresses

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

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

HTTP 방법: GET
설명: 종류의 IPAddress 개체 나열

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

HTTP 방법: POST
설명: IPAddress 만들기

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

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

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

2.2.3. /apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddresses/{name}

표 2.7. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	IPAddress의 이름

HTTP 방법: DELETE
설명: IPAddress 삭제

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

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

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

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

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

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

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

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

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

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

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

3장. IPAddressClaim [ipam.cluster.x-k8s.io/v1beta1]

설명: IPAddressClaim은 ipaddressclaim API의 스키마입니다.
유형: object

3.1. 사양

속성	유형	설명
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`string`	kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`메타데이터`	`ObjectMeta`	표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec`	`object`	IPAddressClaimSpec은 IPAddressClaim의 원하는 상태입니다.
`status`	`object`	IPAddressClaimStatus는 IPAddressClaim의 관찰된 상태입니다.

3.1.1. .spec

설명

IPAddressClaimSpec은 IPAddressClaim의 원하는 상태입니다.

유형

object

필수 항목

poolRef

속성	유형	설명
`poolRef`	`object`	PoolRef는 IP 주소를 생성해야 하는 풀에 대한 참조입니다.

3.1.2. .spec.poolRef

설명

PoolRef는 IP 주소를 생성해야 하는 풀에 대한 참조입니다.

유형

object

필수 항목

kind
name

속성	유형	설명
`apiGroup`	`string`	APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다.
`kind`	`string`	kind는 참조되는 리소스 유형입니다.
`name`	`string`	name은 참조되는 리소스의 이름입니다.

3.1.3. .status

설명: IPAddressClaimStatus는 IPAddressClaim의 관찰된 상태입니다.
유형: object

속성	유형	설명
`addressRef`	`object`	AddressRef는 이 클레임을 위해 생성된 주소에 대한 참조입니다.
`conditions`	`array`	조건은 IPAddressClaim의 현재 상태를 요약합니다.
`conditions[]`	`object`	Condition은 Cluster API 리소스 작동 상태를 관찰합니다.

3.1.4. .status.addressRef

설명: AddressRef는 이 클레임을 위해 생성된 주소에 대한 참조입니다.
유형: object

속성	유형	설명
`name`	`string`	추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

3.1.5. .status.conditions

설명: 조건은 IPAddressClaim의 현재 상태를 요약합니다.
유형: array

3.1.6. .status.conditions[]

설명

Condition은 Cluster API 리소스 작동 상태를 관찰합니다.

유형

object

필수 항목

lastTransitionTime
status
type

속성	유형	설명
`lastTransitionTime`	`string`	조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.
`message`	`string`	전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 이 필드는 비어 있을 수 있습니다.
`reason`	`string`	CamelCase에서 조건의 마지막 전환 이유는 다음과 같습니다. 특정 API는 이 필드가 보장된 API로 간주되는지 여부를 선택할 수 있습니다. 이 필드는 비어 있지 않을 수 있습니다.
`심각도`	`string`	심각도는 이유 코드에 대한 명시적 분류를 제공하므로 사용자 또는 머신이 현재 상황을 즉시 이해하고 그에 따라 조치를 취할 수 있습니다. 심각도 필드는 Status=False인 경우에만 설정해야 합니다.
`status`	`string`	조건의 상태, True, False, 알 수 없음.
`type`	`string`	CamelCase 또는 foo.example.com/CamelCase의 조건 유형입니다. 많은 .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다.

3.2. API 끝점

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

/apis/ipam.cluster.x-k8s.io/v1beta1/ipaddressclaims
- GET: IPAddressClaim 유형의 오브젝트 나열
/apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims
- DELETE: IPAddressClaim의 컬렉션 삭제
- GET: IPAddressClaim 유형의 오브젝트 나열
- POST: IPAddressClaim 생성
/apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims/{name}
- DELETE: IPAddressClaim 삭제
- GET: 지정된 IPAddressClaim 읽기
- PATCH: 지정된 IPAddressClaim을 부분적으로 업데이트
- PUT: 지정된 IPAddressClaim을 교체
/apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims/{name}/status
- GET: 지정된 IPAddressClaim의 읽기 상태
- PATCH: 지정된 IPAddressClaim의 부분 업데이트 상태
- PUT: 지정된 IPAddressClaim의 상태 교체

3.2.1. /apis/ipam.cluster.x-k8s.io/v1beta1/ipaddressclaims

HTTP 방법: GET
설명: IPAddressClaim 유형의 오브젝트 나열

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

3.2.2. /apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims

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

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

HTTP 방법: GET
설명: IPAddressClaim 유형의 오브젝트 나열

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

HTTP 방법: POST
설명: IPAddressClaim 생성

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

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

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

3.2.3. /apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims/{name}

표 3.7. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	IPAddressClaim의 이름

HTTP 방법: DELETE
설명: IPAddressClaim 삭제

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

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

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

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

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

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

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

HTTP 방법: PUT
설명: 지정된 IPAddressClaim을 교체

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

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

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

3.2.4. /apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims/{name}/status

표 3.16. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	IPAddressClaim의 이름

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

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

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

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

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

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

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

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

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

Legal Notice

OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).

Modified versions must remove all Red Hat trademarks.

Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.

Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

클러스터 API