메타데이터 API

OpenShift Container Platform 4.19

메타데이터 API에 대한 참조 가이드

Red Hat OpenShift Documentation Team

법적 공지

초록

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

1장. 메타데이터 API
링크 복사

1.1. APIRequestCount [apiserver.openshift.io/v1]
링크 복사

설명: APIRequestCount는 API에 대한 요청을 추적합니다. 인스턴스 이름은 리소스와 일치하는 resource.version.group 형식이어야 합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형: object

1.2. Binding [v1]
링크 복사

설명: 바인딩은 하나의 오브젝트를 다른 오브젝트에 연결합니다. 예를 들어 Pod는 스케줄러를 통해 노드에 바인딩됩니다.
유형: object

1.3. ComponentStatus [v1]
링크 복사

설명: ComponentStatus(및 ComponentStatusList)에는 클러스터 검증 정보가 포함됩니다. 더 이상 사용되지 않음: 이 API는 v1.19 이상에서 더 이상 사용되지 않습니다.
유형: object

1.4. ConfigMap [v1]
링크 복사

설명: ConfigMap에는 사용할 Pod의 구성 데이터가 있습니다.
유형: object

1.5. ControllerRevision [apps/v1]
링크 복사

설명: ControllerRevision은 상태 데이터의 변경 불가능한 스냅샷을 구현합니다. 클라이언트는 내부 상태가 포함된 오브젝트를 직렬화 및 역직렬화해야 합니다. ControllerRevision이 성공적으로 생성되면 업데이트할 수 없습니다. API 서버는 데이터 필드를 변경하려는 모든 요청에 대한 검증에 실패합니다. 그러나 ControllerRevisions는 삭제될 수 있습니다. 업데이트 및 롤백을 위해 DaemonSet 및 StatefulSet 컨트롤러 둘 다에서 사용하기 때문에 이 오브젝트는 베타 버전입니다. 그러나 향후 릴리스의 이름 및 표시 변경 사항에 따라 달라질 수 있으며 클라이언트는 안정성에 의존하지 않아야 합니다. 주로 컨트롤러의 내부 사용을 위한 것입니다.
유형: object

1.6. 이벤트 [events.k8s.io/v1]
링크 복사

설명: 이벤트는 클러스터의 어느 곳에 있는 이벤트의 보고서입니다. 일반적으로 시스템의 일부 상태 변경을 나타냅니다. 이벤트는 보존 시간이 제한되어 있으며 메시지는 시간에 따라 진화할 수 있습니다. 이벤트 소비자는 일관된 기본 트리거 또는 해당 이유와 함께 이벤트의 지속적인 존재를 반영하는 지정된 이유와 함께 이벤트 타이밍에 의존해서는 안 됩니다. 이벤트는 유익한 모범 사례, 추가 데이터로 취급되어야 합니다.
유형: object

1.7. 이벤트 [v1]
링크 복사

설명: 이벤트는 클러스터의 어느 곳에 있는 이벤트의 보고서입니다. 이벤트는 보존 시간이 제한되어 있으며 메시지는 시간에 따라 진화할 수 있습니다. 이벤트 소비자는 일관된 기본 트리거 또는 해당 이유와 함께 이벤트의 지속적인 존재를 반영하는 지정된 이유와 함께 이벤트 타이밍에 의존해서는 안 됩니다. 이벤트는 유익한 모범 사례, 추가 데이터로 취급되어야 합니다.
유형: object

1.8. 리스 [coordination.k8s.io/v1]
링크 복사

설명: 리스는 리스 개념을 정의합니다.
유형: object

1.9. 네임스페이스 [v1]
링크 복사

설명: 네임 스페이스는 이름에 대한 범위를 제공합니다. 여러 네임스페이스를 사용하는 것은 선택 사항입니다.
유형: object

2장. APIRequestCount [apiserver.openshift.io/v1]
링크 복사

설명

APIRequestCount는 API에 대한 요청을 추적합니다. 인스턴스 이름은 리소스와 일치하는 resource.version.group 형식이어야 합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형

object

필수 항목

spec

2.1. 사양
링크 복사

Expand

속성	유형	설명
`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`	spec은 리소스의 특성을 정의합니다.
`status`	`object`	상태에는 리소스의 관찰된 상태가 포함됩니다.

2.1.1. .spec
링크 복사

설명: spec은 리소스의 특성을 정의합니다.
유형: object

Expand

속성	유형	설명
`numberOfUsersToReport`	`integer`	numberOfUsersToReport은 보고서에 포함할 사용자 수입니다. 지정되지 않았거나 0인 경우 기본값은 10입니다. 기본값은 변경될 수 있습니다.

2.1.2. .status
링크 복사

설명: 상태에는 리소스의 관찰된 상태가 포함됩니다.
유형: object

Expand

속성	유형	설명
`conditions`	`array`	조건에는 이 API 리소스의 현재 상태에 대한 세부 정보가 포함되어 있습니다.
`conditions[]`	`object`	condition에는 이 API 리소스의 현재 상태에 대한 세부 정보가 포함됩니다. --- 이 구조는 필드 경로 .status.conditions에서 배열로 직접 사용하기 위한 것입니다. 예를 들어 FooStatus struct{ // foo의 현재 상태의 관찰을 나타냅니다. // knownn .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchStrategy=merge // +listType=map // +listKey=type // +listKey=type [] `omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions"` // 기타 필드 }
`currentHour`	`object`	currentHour에는 현재 시간에 대한 요청 기록이 포함되어 있습니다. 사람이 API를 더 쉽게 읽을 수 있도록 하는 것은 문제를 해결하는지 여부를 확인하는 것입니다. 이 필드는 시간 후에 재설정됩니다.
`last24h`	`array`	last24h에는 마지막 24시간 동안의 요청 기록이 포함되어 있으며, 시간별로 인덱싱되는 12:00AM-12:59는 인덱스 0, 6am-6:59am은 인덱스 6입니다. 현재 시간의 인덱스가 라이브로 업데이트되고 requestsLastHour 필드에 복제됩니다.
`last24h[]`	`object`	PerResourceAPIRequestLog 로그는 다양한 노드에 대한 요청입니다.
`removedInRelease`	`string`	REMOVEDINRELEASE는 API가 제거될 때입니다.
`requestCount`	`integer`	RequestCount는 현재 시간, 노드 및 사용자의 모든 requestCount의 합계입니다.

2.1.3. .status.conditions
링크 복사

설명: 조건에는 이 API 리소스의 현재 상태에 대한 세부 정보가 포함되어 있습니다.
유형: array

2.1.4. .status.conditions[]
링크 복사

설명

condition에는 이 API 리소스의 현재 상태에 대한 세부 정보가 포함됩니다. --- 이 구조는 필드 경로 .status.conditions에서 배열로 직접 사용하기 위한 것입니다. 예를 들어 FooStatus struct{ // foo의 현재 상태의 관찰을 나타냅니다. // knownn .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchStrategy=merge // +listType=map // +listKey=type // +listKey=type [] omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions" // 기타 필드 }

유형

object

필수 항목

lastTransitionTime
message
reason
status
type

Expand

속성	유형	설명
`lastTransitionTime`	`string`	lastTransitionTime은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.
`message`	`string`	message는 변환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.
`observedGeneration`	`integer`	observedGeneration은 조건에 따라 설정된 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 현재 인스턴스 상태와 관련된 조건이 최신 상태가 아닙니다.
`reason`	`string`	이유에는 조건의 마지막 전환 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 예상되는 값과 의미를 정의할 수 있으며 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있지 않을 수 있습니다.
`status`	`string`	조건의 상태, True, False, 알 수 없음.
`type`	`string`	CamelCase 또는 foo.example.com/CamelCase의 조건 유형. --- many .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다. 정규 표현식이 일치하는 정규 표현식은 (dns1123SubdomainFmt/)?(qualifiedNameFmt)입니다.

2.1.5. .status.currentHour
링크 복사

설명: currentHour에는 현재 시간에 대한 요청 기록이 포함되어 있습니다. 사람이 API를 더 쉽게 읽을 수 있도록 하는 것은 문제를 해결하는지 여부를 확인하는 것입니다. 이 필드는 시간 후에 재설정됩니다.
유형: object

Expand

속성	유형	설명
`byNode`	`array`	byNode에는 노드당 요청 로그가 포함되어 있습니다.
`byNode[]`	`object`	PerNodeAPIRequestLog에는 특정 노드에 대한 요청 로그가 포함되어 있습니다.
`requestCount`	`integer`	RequestCount는 노드의 모든 requestCounts 합계입니다.

2.1.6. .status.currentHour.byNode
링크 복사

설명: byNode에는 노드당 요청 로그가 포함되어 있습니다.
유형: array

2.1.7. .status.currentHour.byNode[]
링크 복사

설명: PerNodeAPIRequestLog에는 특정 노드에 대한 요청 로그가 포함되어 있습니다.
유형: object

Expand

속성	유형	설명
`byUser`	`array`	byuser에는 .spec.numberOfUsersToReport 사용자의 요청 세부 정보가 포함되어 있습니다. apiserver의 경우 상위 사용자 목록을 재시작하는 것은 최상의 방법으로 결정되므로 목록이 부정확할 수 있습니다. 또한 일부 시스템 사용자는 목록에 명시적으로 포함될 수 있습니다.
`byUser[]`	`object`	PerUserAPIRequestCount에는 사용자 요청 로그가 포함되어 있습니다.
`nodeName`	`string`	요청이 처리되는 노드 이름입니다.
`requestCount`	`integer`	RequestCount는 모든 사용자에 대한 모든 requestCounts의 합계이며 상위 10명의 사용자도 마찬가지입니다.

2.1.8. .status.currentHour.byNode[].byUser
링크 복사

설명: byuser에는 .spec.numberOfUsersToReport 사용자의 요청 세부 정보가 포함되어 있습니다. apiserver의 경우 상위 사용자 목록을 재시작하는 것은 최상의 방법으로 결정되므로 목록이 부정확할 수 있습니다. 또한 일부 시스템 사용자는 목록에 명시적으로 포함될 수 있습니다.
유형: array

2.1.9. .status.currentHour.byNode[].byUser[]
링크 복사

설명: PerUserAPIRequestCount에는 사용자 요청 로그가 포함되어 있습니다.
유형: object

Expand

속성	유형	설명
`byVerb`	`array`	byVerb details by verb.
`byVerb[]`	`object`	PerVerbAPIRequestCount requestCounts API 요청 동사별 요청 수입니다.
`requestCount`	`integer`	모든 동사에 걸쳐 사용자의 요청 수입니다.
`userAgent`	`string`	요청을 수행한 userAgent입니다. 동일한 사용자에게 여러 개의 바이너리가 있는 경우가 많으며, 여러 컨테이너가 있는 포드를 연결합니다. 바이너리마다 다른 userAgents가 있지만 동일한 사용자가 있습니다. 또한 버전 정보가 포함된 userAgent가 있으며 userName은 변경될 가능성이 없습니다.
`사용자 이름`	`string`	요청을 한 사용자 이름입니다.

2.1.10. .status.currentHour.byNode[].byUser[].byVerb
링크 복사

설명: byVerb details by verb.
유형: array

2.1.11. .status.currentHour.byNode[].byUser[].byVerb[]
링크 복사

설명: PerVerbAPIRequestCount requestCounts API 요청 동사별 요청 수입니다.
유형: object

Expand

속성	유형	설명
`requestCount`	`integer`	동사에 대한 요청 수입니다.
`verb`	`string`	API 요청 동사(get, list, create 등)

2.1.12. .status.last24h
링크 복사

설명: last24h에는 마지막 24시간 동안의 요청 기록이 포함되어 있으며, 시간별로 인덱싱되는 12:00AM-12:59는 인덱스 0, 6am-6:59am은 인덱스 6입니다. 현재 시간의 인덱스가 라이브로 업데이트되고 requestsLastHour 필드에 복제됩니다.
유형: array

2.1.13. .status.last24h[]
링크 복사

설명: PerResourceAPIRequestLog 로그는 다양한 노드에 대한 요청입니다.
유형: object

Expand

속성	유형	설명
`byNode`	`array`	byNode에는 노드당 요청 로그가 포함되어 있습니다.
`byNode[]`	`object`	PerNodeAPIRequestLog에는 특정 노드에 대한 요청 로그가 포함되어 있습니다.
`requestCount`	`integer`	RequestCount는 노드의 모든 requestCounts 합계입니다.

2.1.14. .status.last24h[].byNode
링크 복사

설명: byNode에는 노드당 요청 로그가 포함되어 있습니다.
유형: array

2.1.15. .status.last24h[].byNode[]
링크 복사

설명: PerNodeAPIRequestLog에는 특정 노드에 대한 요청 로그가 포함되어 있습니다.
유형: object

Expand

속성	유형	설명
`byUser`	`array`	byuser에는 .spec.numberOfUsersToReport 사용자의 요청 세부 정보가 포함되어 있습니다. apiserver의 경우 상위 사용자 목록을 재시작하는 것은 최상의 방법으로 결정되므로 목록이 부정확할 수 있습니다. 또한 일부 시스템 사용자는 목록에 명시적으로 포함될 수 있습니다.
`byUser[]`	`object`	PerUserAPIRequestCount에는 사용자 요청 로그가 포함되어 있습니다.
`nodeName`	`string`	요청이 처리되는 노드 이름입니다.
`requestCount`	`integer`	RequestCount는 모든 사용자에 대한 모든 requestCounts의 합계이며 상위 10명의 사용자도 마찬가지입니다.

2.1.16. .status.last24h[].byNode[].byUser
링크 복사

설명: byuser에는 .spec.numberOfUsersToReport 사용자의 요청 세부 정보가 포함되어 있습니다. apiserver의 경우 상위 사용자 목록을 재시작하는 것은 최상의 방법으로 결정되므로 목록이 부정확할 수 있습니다. 또한 일부 시스템 사용자는 목록에 명시적으로 포함될 수 있습니다.
유형: array

2.1.17. .status.last24h[].byNode[].byUser[]
링크 복사

설명: PerUserAPIRequestCount에는 사용자 요청 로그가 포함되어 있습니다.
유형: object

Expand

속성	유형	설명
`byVerb`	`array`	byVerb details by verb.
`byVerb[]`	`object`	PerVerbAPIRequestCount requestCounts API 요청 동사별 요청 수입니다.
`requestCount`	`integer`	모든 동사에 걸쳐 사용자의 요청 수입니다.
`userAgent`	`string`	요청을 수행한 userAgent입니다. 동일한 사용자에게 여러 개의 바이너리가 있는 경우가 많으며, 여러 컨테이너가 있는 포드를 연결합니다. 바이너리마다 다른 userAgents가 있지만 동일한 사용자가 있습니다. 또한 버전 정보가 포함된 userAgent가 있으며 userName은 변경될 가능성이 없습니다.
`사용자 이름`	`string`	요청을 한 사용자 이름입니다.

2.1.18. .status.last24h[].byNode[].byUser[].byVerb
링크 복사

설명: byVerb details by verb.
유형: array

2.1.19. .status.last24h[].byNode[].byUser[].byVerb[]
링크 복사

설명: PerVerbAPIRequestCount requestCounts API 요청 동사별 요청 수입니다.
유형: object

Expand

속성	유형	설명
`requestCount`	`integer`	동사에 대한 요청 수입니다.
`verb`	`string`	API 요청 동사(get, list, create 등)

2.2. API 끝점
링크 복사

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

/apis/apiserver.openshift.io/v1/apirequestcounts
- DELETE: APIRequestCount의 컬렉션 삭제
- GET: 종류의 APIRequestCount 오브젝트 나열
- POST: APIRequestCount 생성
/apis/apiserver.openshift.io/v1/apirequestcounts/{name}
- DELETE: APIRequestCount 삭제
- GET: 지정된 APIRequestCount 읽기
- PATCH: 지정된 APIRequestCount를 부분적으로 업데이트
- PUT: 지정된 APIRequestCount를 교체
/apis/apiserver.openshift.io/v1/apirequestcounts/{name}/status
- GET: 지정된 APIRequestCount의 읽기 상태
- PATCH: 지정된 APIRequestCount의 부분 업데이트 상태
- PUT: 지정된 APIRequestCount의 상태 교체

2.2.1. /apis/apiserver.openshift.io/v1/apirequestcounts
링크 복사

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

Expand

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

HTTP 방법: GET
설명: 종류 APIRequestCount의 오브젝트 나열

Expand

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

HTTP 방법: POST
설명: APIRequestCount 생성

Expand

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

Expand

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

Expand

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

2.2.2. /apis/apiserver.openshift.io/v1/apirequestcounts/{name}
링크 복사

Expand

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

HTTP 방법: DELETE
설명: APIRequestCount 삭제

Expand

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

Expand

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

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

Expand

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

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

Expand

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

Expand

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

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

Expand

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

Expand

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

Expand

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

2.2.3. /apis/apiserver.openshift.io/v1/apirequestcounts/{name}/status
링크 복사

Expand

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

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

Expand

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

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

Expand

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

Expand

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

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

Expand

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

Expand

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

Expand

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

3장. Binding [v1]
링크 복사

설명

바인딩은 하나의 오브젝트를 다른 오브젝트에 연결합니다. 예를 들어 Pod는 스케줄러를 통해 노드에 바인딩됩니다.

유형

object

필수 항목

target

3.1. 사양
링크 복사

Expand

속성	유형	설명
`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
`target`	`object`	ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.

3.1.1. .target
링크 복사

설명: ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
유형: object

Expand

속성	유형	설명
`apiVersion`	`string`	참조의 API 버전입니다.
`fieldPath`	`string`	전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다.
`kind`	`string`	일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`name`	`string`	추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
`네임스페이스`	`string`	참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
`resourceVersion`	`string`	이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
`uid`	`string`	참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

3.2. API 끝점
링크 복사

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

/api/v1/namespaces/{namespace}/bindings
- POST: 바인딩을 생성
/api/v1/namespaces/{namespace}/pods/{name}/binding
- POST: Pod 바인딩 생성

3.2.1. /api/v1/namespaces/{namespace}/bindings
링크 복사

Expand

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

HTTP 방법: POST
설명: 바인딩 생성

Expand

표 3.2. 본문 매개변수
매개변수	유형	설명
`body`	`바인딩` 스키마

Expand

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

3.2.2. /api/v1/namespaces/{namespace}/pods/{name}/binding
링크 복사

Expand

표 3.4. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	바인딩의 이름

Expand

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

HTTP 방법: POST
설명: Pod 바인딩 생성

Expand

표 3.6. 본문 매개변수
매개변수	유형	설명
`body`	`바인딩` 스키마

Expand

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

4장. ComponentStatus [v1]
링크 복사

설명: ComponentStatus(및 ComponentStatusList)에는 클러스터 검증 정보가 포함됩니다. 더 이상 사용되지 않음: 이 API는 v1.19 이상에서 더 이상 사용되지 않습니다.
유형: object

4.1. 사양
링크 복사

Expand

속성	유형	설명
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`conditions`	`array`	관찰된 구성 요소 조건 목록
`conditions[]`	`object`	구성 요소의 상태에 대한 정보입니다.
`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

4.1.1. .conditions
링크 복사

설명: 관찰된 구성 요소 조건 목록
유형: array

4.1.2. .conditions[]
링크 복사

설명

구성 요소의 상태에 대한 정보입니다.

유형

object

필수 항목

type
status

Expand

속성	유형	설명
`error`	`string`	구성 요소에 대한 조건 오류 코드입니다. 예를 들어 상태 점검 오류 코드가 있습니다.
`message`	`string`	구성 요소의 조건에 대한 메시지입니다. 예를 들어 상태 점검에 대한 정보는 다음과 같습니다.
`status`	`string`	구성 요소의 조건 상태입니다. "Healthy": "True", "False" 또는 "Unknown"에 대한 유효한 값입니다.
`type`	`string`	구성 요소의 조건 유형입니다. 유효한 값: "Healthy"

4.2. API 끝점
링크 복사

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

/api/v1/componentstatuses
- GET: 종류의 ComponentStatus 오브젝트 나열
/api/v1/componentstatuses/{name}
- GET: 지정된 ComponentStatus를 읽습니다.

4.2.1. /api/v1/componentstatuses
링크 복사

HTTP 방법: GET
설명: kind ComponentStatus의 오브젝트 나열

Expand

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

4.2.2. /api/v1/componentstatuses/{name}
링크 복사

Expand

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

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

Expand

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

5장. ConfigMap [v1]
링크 복사

설명: ConfigMap에는 사용할 Pod의 구성 데이터가 있습니다.
유형: object

5.1. 사양
링크 복사

Expand

속성	유형	설명
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`binaryData`	`오브젝트(문자열)`	BinaryData에는 바이너리 데이터가 포함됩니다. 각 키는 영숫자 문자 '-', '_' 또는 '.'로 구성되어야 합니다. BinaryData는 UTF-8 범위에 없는 바이트 시퀀스를 포함할 수 있습니다. BinaryData에 저장된 키는 Data 필드에 있는 항목과 겹치지 않아야 하며 검증 프로세스 중에 적용됩니다. 이 필드를 사용하려면 1.10+ apiserver 및 kubelet이 필요합니다.
`data`	`오브젝트(문자열)`	데이터에는 구성 데이터가 포함되어 있습니다. 각 키는 영숫자 문자 '-', '_' 또는 '.'로 구성되어야 합니다. UTF-8이 아닌 바이트 시퀀스가 있는 값은 BinaryData 필드를 사용해야 합니다. 데이터에 저장된 키는 BinaryData 필드의 키와 겹치지 않아야 하며 유효성 검사 프로세스 중에 적용됩니다.
`변경할 수 없음`	`boolean`	변경 불가능한 true로 설정하면 ConfigMap에 저장된 데이터를 업데이트할 수 없습니다(오브젝트 메타데이터만 수정할 수 있음). true로 설정하지 않으면 언제든지 필드를 수정할 수 있습니다. nil로 설정됩니다.
`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

5.2. API 끝점
링크 복사

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

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

5.2.1. /api/v1/configmaps
링크 복사

HTTP 방법: GET
설명: 종류의 오브젝트 목록 또는 감시 ConfigMap

Expand

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

5.2.2. /api/v1/watch/configmaps
링크 복사

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

Expand

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

5.2.3. /api/v1/namespaces/{namespace}/configmaps
링크 복사

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

Expand

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

Expand

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

HTTP 방법: GET
설명: 종류의 오브젝트 목록 또는 감시 ConfigMap

Expand

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

HTTP 방법: POST
설명: ConfigMap 생성

Expand

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

Expand

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

Expand

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

5.2.4. /api/v1/watch/namespaces/{namespace}/configmaps
링크 복사

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

Expand

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

5.2.5. /api/v1/namespaces/{namespace}/configmaps/{name}
링크 복사

Expand

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

HTTP 방법: DELETE
설명: delete a ConfigMap

Expand

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

Expand

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

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

Expand

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

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

Expand

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

Expand

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

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

Expand

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

Expand

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

Expand

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

5.2.6. /api/v1/watch/namespaces/{namespace}/configmaps/{name}
링크 복사

Expand

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

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

Expand

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

6장. ControllerRevision [apps/v1]
링크 복사

설명

ControllerRevision은 상태 데이터의 변경 불가능한 스냅샷을 구현합니다. 클라이언트는 내부 상태가 포함된 오브젝트를 직렬화 및 역직렬화해야 합니다. ControllerRevision이 성공적으로 생성되면 업데이트할 수 없습니다. API 서버는 데이터 필드를 변경하려는 모든 요청에 대한 검증에 실패합니다. 그러나 ControllerRevisions는 삭제될 수 있습니다. 업데이트 및 롤백을 위해 DaemonSet 및 StatefulSet 컨트롤러 둘 다에서 사용하기 때문에 이 오브젝트는 베타 버전입니다. 그러나 향후 릴리스의 이름 및 표시 변경 사항에 따라 달라질 수 있으며 클라이언트는 안정성에 의존하지 않아야 합니다. 주로 컨트롤러의 내부 사용을 위한 것입니다.

유형

object

필수 항목

버전

6.1. 사양
링크 복사

Expand

속성	유형	설명
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`data`	`RawExtension`	데이터는 상태에 대해 직렬화된 표현입니다.
`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
`버전`	`integer`	리버전은 데이터가 나타내는 상태의 버전을 나타냅니다.

6.2. API 끝점
링크 복사

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

/apis/apps/v1/controllerrevisions
- GET: ControllerRevision 유형의 오브젝트 목록 또는 감시
/apis/apps/v1/watch/controllerrevisions
- GET: individual changes to a list of ControllerRevision. deprecated: 대신 list 작업과 함께 'watch' 매개변수를 사용합니다.
/apis/apps/v1/namespaces/{namespace}/controllerrevisions
- DELETE: ControllerRevision의 컬렉션 삭제
- GET: ControllerRevision 유형의 오브젝트 목록 또는 감시
- POST: ControllerRevision을 생성
/apis/apps/v1/watch/namespaces/{namespace}/controllerrevisions
- GET: individual changes to a list of ControllerRevision. deprecated: 대신 list 작업과 함께 'watch' 매개변수를 사용합니다.
/apis/apps/v1/namespaces/{namespace}/controllerrevisions/{name}
- DELETE: ControllerRevision 삭제
- GET: 지정된 ControllerRevision 읽기
- PATCH: 지정된 ControllerRevision을 부분적으로 업데이트
- PUT: 지정된 ControllerRevision을 교체합니다.
/apis/apps/v1/watch/namespaces/{namespace}/controllerrevisions/{name}
- GET: ControllerRevision. deprecated 개체 변경 사항을 조사: 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개변수를 단일 항목으로 필터링합니다.

6.2.1. /apis/apps/v1/controllerrevisions
링크 복사

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

Expand

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

6.2.2. /apis/apps/v1/watch/controllerrevisions
링크 복사

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

Expand

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

6.2.3. /apis/apps/v1/namespaces/{namespace}/controllerrevisions
링크 복사

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

Expand

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

Expand

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

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

Expand

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

HTTP 방법: POST
설명: ControllerRevision 생성

Expand

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

Expand

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

Expand

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

6.2.4. /apis/apps/v1/watch/namespaces/{namespace}/controllerrevisions
링크 복사

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

Expand

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

6.2.5. /apis/apps/v1/namespaces/{namespace}/controllerrevisions/{name}
링크 복사

Expand

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

HTTP 방법: DELETE
설명: ControllerRevision 삭제

Expand

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

Expand

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

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

Expand

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

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

Expand

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

Expand

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

HTTP 방법: PUT
설명: 지정된 ControllerRevision을 교체합니다.

Expand

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

Expand

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

Expand

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

6.2.6. /apis/apps/v1/watch/namespaces/{namespace}/controllerrevisions/{name}
링크 복사

Expand

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

HTTP 방법: GET
설명: ControllerRevision. deprecated 유형의 오브젝트 변경 사항을 확인합니다. 대신 목록 작업과 함께 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링된 'watch' 매개변수를 사용합니다.

Expand

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

7장. 이벤트 [events.k8s.io/v1]
링크 복사

설명

이벤트는 클러스터의 어느 곳에 있는 이벤트의 보고서입니다. 일반적으로 시스템의 일부 상태 변경을 나타냅니다. 이벤트는 보존 시간이 제한되어 있으며 메시지는 시간에 따라 진화할 수 있습니다. 이벤트 소비자는 일관된 기본 트리거 또는 해당 이유와 함께 이벤트의 지속적인 존재를 반영하는 지정된 이유와 함께 이벤트 타이밍에 의존해서는 안 됩니다. 이벤트는 유익한 모범 사례, 추가 데이터로 취급되어야 합니다.

유형

object

필수 항목

eventTime

7.1. 사양
링크 복사

Expand

속성	유형	설명
`작업`	`string`	작업은 오브젝트와 관련하여 수행/실패한 작업입니다. machine-readable 입니다. 이 필드는 새 이벤트의 경우 비어 있을 수 없으며 최대 128자를 포함할 수 있습니다.
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`deprecatedCount`	`integer`	deprecatedCount는 core.v1 이벤트 유형과 이전 버전과의 호환성을 보장하는 더 이상 사용되지 않는 필드입니다.
`deprecatedFirstTimestamp`	`시간`	deprecatedFirstTimestamp는 core.v1 이벤트 유형과의 역호환성을 보장하는 더 이상 사용되지 않는 필드입니다.
`deprecatedLastTimestamp`	`시간`	deprecatedLastTimestamp는 core.v1 이벤트 유형과의 이전 버전과의 호환성을 보장하는 더 이상 사용되지 않는 필드입니다.
`deprecatedSource`	`EventSource`	deprecatedSource는 core.v1 이벤트 유형과 이전 버전과의 호환성을 보장하는 더 이상 사용되지 않는 필드입니다.
`eventTime`	`MicroTime`	eventTime은 이 이벤트가 처음 관찰된 시간입니다. 필수 항목입니다.
`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
`참고`	`string`	이 작업의 상태에 대한 사람이 읽을 수 있는 설명입니다. 참고의 최대 길이는 1kB이지만 라이브러리는 최대 64kB 값을 처리할 준비가 되어 있어야 합니다.
`reason`	`string`	그 이유는 조치가 취해졌기 때문입니다. 사람이 읽을 수 있는 것입니다. 이 필드는 새 이벤트의 경우 비어 있을 수 없으며 최대 128자를 포함할 수 있습니다.
`regarding`	`ObjectReference`	이벤트와 관련하여 이 이벤트의 오브젝트를 포함합니다. 대부분의 경우 개체 보고 컨트롤러가 구현됩니다(예: ReplicaSetController는 ReplicaSets를 구현하며 이 이벤트는 ReplicaSet 오브젝트의 일부 변경 사항에 영향을 미치기 때문에 생성됩니다.
`관련`	`ObjectReference`	더 복잡한 작업을 위한 선택적 보조 개체입니다. 예를 들어, 오브젝트와 관련하여 관련 오브젝트 생성 또는 삭제를 트리거하는 경우입니다.
`reportingController`	`string`	reportingController는 이 이벤트를 생성한 컨트롤러의 이름입니다(예: `kubernetes.io/kubelet` ). 이 필드는 새 이벤트의 경우 비워 둘 수 없습니다.
`reportingInstance`	`string`	reportingInstance는 컨트롤러 인스턴스의 ID입니다(예: `kubelet-xyzf` ). 이 필드는 새 이벤트의 경우 비어 있을 수 없으며 최대 128자를 포함할 수 있습니다.
`시리즈`	`object`	EventSeries는 일련의 이벤트, 즉 오랜 시간 동안 지속적으로 발생하고 있는 이벤트에 대한 정보를 포함합니다. EventSeries를 업데이트하는 빈도는 이벤트 보고자에게 달려 있습니다. "k8s.io/client-go/tools/event_broadcaster.go"의 기본 이벤트 보고자는 이 구조가 하트비트에서 업데이트되는 방법을 보여주고 사용자 지정 보고자 구현을 안내할 수 있습니다.
`type`	`string`	type은 이 이벤트의 유형(Normal, Warning)이며 향후 새 유형을 추가할 수 있습니다. machine-readable 입니다. 이 필드는 새 이벤트의 경우 비워 둘 수 없습니다.

7.1.1. .series
링크 복사

설명

EventSeries는 일련의 이벤트, 즉 오랜 시간 동안 지속적으로 발생하고 있는 이벤트에 대한 정보를 포함합니다. EventSeries를 업데이트하는 빈도는 이벤트 보고자에게 달려 있습니다. "k8s.io/client-go/tools/event_broadcaster.go"의 기본 이벤트 보고자는 이 구조가 하트비트에서 업데이트되는 방법을 보여주고 사용자 지정 보고자 구현을 안내할 수 있습니다.

유형

object

필수 항목

count
lastObservedTime

Expand

속성	유형	설명
`count`	`integer`	count는 이 시리즈의 마지막 하트비트 시간까지의 발생 횟수입니다.
`lastObservedTime`	`MicroTime`	lastObservedTime은 마지막 하트비트 전에 시리즈의 마지막 이벤트가 표시되는 시간입니다.

7.2. API 끝점
링크 복사

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

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

7.2.1. /apis/events.k8s.io/v1/events
링크 복사

HTTP 방법: GET
설명: 이벤트 유형의 오브젝트 목록 또는 감시

Expand

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

7.2.2. /apis/events.k8s.io/v1/watch/events
링크 복사

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

Expand

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

7.2.3. /apis/events.k8s.io/v1/namespaces/{namespace}/events
링크 복사

HTTP 방법: DELETE
설명: 이벤트 컬렉션 삭제

Expand

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

Expand

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

HTTP 방법: GET
설명: 이벤트 유형의 오브젝트 목록 또는 감시

Expand

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

HTTP 방법: POST
설명: 이벤트 생성

Expand

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

Expand

표 7.7. 본문 매개변수
매개변수	유형	설명
`body`	`이벤트` 스키마

Expand

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

7.2.4. /apis/events.k8s.io/v1/watch/namespaces/{namespace}/events
링크 복사

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

Expand

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

7.2.5. /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}
링크 복사

Expand

표 7.10. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	이벤트 이름

HTTP 방법: DELETE
설명: 이벤트 삭제

Expand

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

Expand

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

HTTP 방법: GET
설명: 지정된 이벤트 읽기

Expand

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

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

Expand

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

Expand

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

HTTP 방법: PUT
설명: 지정된 이벤트 교체

Expand

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

Expand

표 7.17. 본문 매개변수
매개변수	유형	설명
`body`	`이벤트` 스키마

Expand

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

7.2.6. /apis/events.k8s.io/v1/watch/namespaces/{namespace}/events/{name}
링크 복사

Expand

표 7.19. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	이벤트 이름

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

Expand

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

8장. 이벤트 [v1]
링크 복사

설명

이벤트는 클러스터의 어느 곳에 있는 이벤트의 보고서입니다. 이벤트는 보존 시간이 제한되어 있으며 메시지는 시간에 따라 진화할 수 있습니다. 이벤트 소비자는 일관된 기본 트리거 또는 해당 이유와 함께 이벤트의 지속적인 존재를 반영하는 지정된 이유와 함께 이벤트 타이밍에 의존해서는 안 됩니다. 이벤트는 유익한 모범 사례, 추가 데이터로 취급되어야 합니다.

유형

object

필수 항목

메타데이터
involvedObject

8.1. 사양
링크 복사

Expand

속성	유형	설명
`작업`	`string`	Regarding 오브젝트와 관련하여 수행된 작업/실패.
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`count`	`integer`	이 이벤트가 발생한 횟수입니다.
`eventTime`	`MicroTime`	이 이벤트가 처음 관찰된 시간입니다.
`firstTimestamp`	`시간`	이벤트가 처음 기록된 시간입니다. (서버 수령 시간은 TypeMeta입니다.)
`involvedObject`	`object`	ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
`kind`	`string`	kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`lastTimestamp`	`시간`	이 이벤트가 가장 최근에 발생한 시점이 기록되었습니다.
`message`	`string`	이 작업의 상태에 대한 사람이 읽을 수 있는 설명입니다.
`메타데이터`	`ObjectMeta`	표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`reason`	`string`	이는 오브젝트의 현재 상태로 전환하는 이유를 제공하는 짧은 머신 이해할 수 있는 문자열이어야 합니다.
`관련`	`object`	ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
`reportingComponent`	`string`	이 이벤트를 발송한 컨트롤러의 이름입니다(예: `kubernetes.io/kubelet` ).
`reportingInstance`	`string`	컨트롤러 인스턴스의 ID(예: `kubelet-xyzf` )
`시리즈`	`object`	EventSeries는 일련의 이벤트, 즉 오랜 시간 동안 지속적으로 발생하고 있는 이벤트에 대한 정보를 포함합니다.
`소스`	`object`	EventSource 이벤트에 대한 정보가 포함되어 있습니다.
`type`	`string`	이 이벤트의 유형 (Normal, Warning) 새 유형을 나중에 추가할 수 있습니다.

8.1.1. .involvedObject
링크 복사

설명: ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
유형: object

Expand

속성	유형	설명
`apiVersion`	`string`	참조의 API 버전입니다.
`fieldPath`	`string`	전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다.
`kind`	`string`	일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`name`	`string`	추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
`네임스페이스`	`string`	참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
`resourceVersion`	`string`	이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
`uid`	`string`	참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

8.1.2. .related
링크 복사

설명: ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
유형: object

Expand

속성	유형	설명
`apiVersion`	`string`	참조의 API 버전입니다.
`fieldPath`	`string`	전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다.
`kind`	`string`	일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`name`	`string`	추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
`네임스페이스`	`string`	참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
`resourceVersion`	`string`	이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
`uid`	`string`	참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

8.1.3. .series
링크 복사

설명: EventSeries는 일련의 이벤트, 즉 오랜 시간 동안 지속적으로 발생하고 있는 이벤트에 대한 정보를 포함합니다.
유형: object

Expand

속성	유형	설명
`count`	`integer`	마지막 하트비트 시간까지 이 시리즈의 발생 횟수
`lastObservedTime`	`MicroTime`	마지막으로 관찰된 시간

8.1.4. .source
링크 복사

설명: EventSource 이벤트에 대한 정보가 포함되어 있습니다.
유형: object

Expand

속성	유형	설명
`component`	`string`	이벤트가 생성되는 구성 요소입니다.
`host`	`string`	이벤트가 생성되는 노드 이름입니다.

8.2. API 끝점
링크 복사

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

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

8.2.1. /api/v1/events
링크 복사

HTTP 방법: GET
설명: 이벤트 유형의 오브젝트 목록 또는 감시

Expand

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

8.2.2. /api/v1/watch/events
링크 복사

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

Expand

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

8.2.3. /api/v1/namespaces/{namespace}/events
링크 복사

HTTP 방법: DELETE
설명: 이벤트 컬렉션 삭제

Expand

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

Expand

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

HTTP 방법: GET
설명: 이벤트 유형의 오브젝트 목록 또는 감시

Expand

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

HTTP 방법: POST
설명: 이벤트 생성

Expand

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

Expand

표 8.7. 본문 매개변수
매개변수	유형	설명
`body`	`이벤트` 스키마

Expand

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

8.2.4. /api/v1/watch/namespaces/{namespace}/events
링크 복사

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

Expand

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

8.2.5. /api/v1/namespaces/{namespace}/events/{name}
링크 복사

Expand

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

HTTP 방법: DELETE
설명: 이벤트 삭제

Expand

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

Expand

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

HTTP 방법: GET
설명: 지정된 이벤트 읽기

Expand

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

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

Expand

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

Expand

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

HTTP 방법: PUT
설명: 지정된 이벤트 교체

Expand

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

Expand

표 8.17. 본문 매개변수
매개변수	유형	설명
`body`	`이벤트` 스키마

Expand

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

8.2.6. /api/v1/watch/namespaces/{namespace}/events/{name}
링크 복사

Expand

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

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

Expand

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

9장. 리스 [coordination.k8s.io/v1]
링크 복사

설명: 리스는 리스 개념을 정의합니다.
유형: object

9.1. 사양
링크 복사

Expand

속성	유형	설명
`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`	LeaseSpec은 Lease의 사양입니다.

9.1.1. .spec
링크 복사

설명: LeaseSpec은 Lease의 사양입니다.
유형: object

Expand

속성	유형	설명
`acquireTime`	`MicroTime`	acquireTime은 현재 리스를 인수한 시간입니다.
`holderIdentity`	`string`	holderIdentity에는 현재 임대 소유자의 ID가 포함되어 있습니다. Coordinated Leader Election을 사용하는 경우 소유자 ID는 선택한 LeaseCandidate.metadata.name 필드와 같아야 합니다.
`leaseDurationSeconds`	`integer`	leaseDurationSeconds는 임대 후보가 강제로 취득하기 위해 기다려야 하는 기간입니다. 이는 마지막 갱신 시간을 기준으로 측정됩니다.
`leaseTransitions`	`integer`	LeaseTransitions는 소유자 간 리스 전환 횟수입니다.
`preferredHolder`	`string`	PreferredHolder는 리스 홀더가 더 최적의 홀더를 가지고 있으며 포기해야 한다는 신호를 보냅니다. 이 필드는 Strategy도 설정된 경우에만 설정할 수 있습니다.
`renewTime`	`MicroTime`	renewTime은 리스의 현재 소유자가 임대를 마지막으로 업데이트한 시간입니다.
`전략`	`string`	전략은 조정된 리더 선택을 위한 리더를 선택하는 전략을 나타냅니다. 필드를 지정하지 않으면 이 리스에 대한 활성 조정이 없습니다. (alpha) 이 필드를 사용하려면 CoordinatedLeaderElection 기능 게이트를 활성화해야 합니다.

9.2. API 끝점
링크 복사

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

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

9.2.1. /apis/coordination.k8s.io/v1/leases
링크 복사

HTTP 방법: GET
설명: Lease 유형의 오브젝트 목록 또는 감시

Expand

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

9.2.2. /apis/coordination.k8s.io/v1/watch/leases
링크 복사

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

Expand

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

9.2.3. /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
링크 복사

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

Expand

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

Expand

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

HTTP 방법: GET
설명: Lease 유형의 오브젝트 목록 또는 감시

Expand

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

HTTP 방법: POST
설명: 자주하는 질문

Expand

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

Expand

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

Expand

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

9.2.4. /apis/coordination.k8s.io/v1/watch/namespaces/{namespace}/leases
링크 복사

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

Expand

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

9.2.5. /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
링크 복사

Expand

표 9.10. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	관련 리뷰: Name of the Lease

HTTP 방법: DELETE
설명: 자주하는 질문

Expand

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

Expand

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

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

Expand

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

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

Expand

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

Expand

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

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

Expand

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

Expand

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

Expand

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

9.2.6. /apis/coordination.k8s.io/v1/watch/namespaces/{namespace}/leases/{name}
링크 복사

Expand

표 9.19. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	관련 리뷰: Name of the Lease

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

Expand

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

10장. 네임스페이스 [v1]
링크 복사

설명: 네임 스페이스는 이름에 대한 범위를 제공합니다. 여러 네임스페이스를 사용하는 것은 선택 사항입니다.
유형: object

10.1. 사양
링크 복사

Expand

속성	유형	설명
`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`	NamespaceSpec은 네임스페이스의 특성을 설명합니다.
`status`	`object`	NamespaceStatus는 네임스페이스의 현재 상태에 대한 정보입니다.

10.1.1. .spec
링크 복사

설명: NamespaceSpec은 네임스페이스의 특성을 설명합니다.
유형: object

Expand

속성	유형	설명
`종료자`	`배열(문자열)`	종료자는 스토리지에서 오브젝트를 영구적으로 제거하려면 비어 있어야 하는 불투명 값 목록입니다. 자세한 내용은 https://kubernetes.io/docs/tasks/administer-cluster/namespaces/

10.1.2. .status
링크 복사

설명: NamespaceStatus는 네임스페이스의 현재 상태에 대한 정보입니다.
유형: object

Expand

속성 유형 설명

conditions

array

네임스페이스의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

NamespaceCondition에는 네임스페이스 상태에 대한 세부 정보가 포함되어 있습니다.

phase

string

phase는 네임스페이스의 현재 라이프사이클 단계입니다. 자세한 내용은 https://kubernetes.io/docs/tasks/administer-cluster/namespaces/

가능한 enum 값: - "Active" 는 시스템에서 사용할 수 있는 네임스페이스를 의미합니다 - "Terminating" 은 네임스페이스가 정상 종료를 수행 중임을 의미합니다.

10.1.3. .status.conditions
링크 복사

설명: 네임스페이스의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형: array

10.1.4. .status.conditions[]
링크 복사

설명

NamespaceCondition에는 네임스페이스 상태에 대한 세부 정보가 포함되어 있습니다.

유형

object

필수 항목

type
status

Expand

속성	유형	설명
`lastTransitionTime`	`시간`	조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다.
`message`	`string`	마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.
`reason`	`string`	조건의 마지막 전환에 대한 고유하고 한단어, CamelCase 이유.
`status`	`string`	조건의 상태, True, False, 알 수 없음.
`type`	`string`	네임스페이스 컨트롤러 조건의 유형입니다.

10.2. API 끝점
링크 복사

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

/api/v1/namespaces
- GET: 네임스페이스 유형의 오브젝트 나열 또는 감시
- POST: 네임스페이스 생성
/api/v1/watch/namespaces
- GET: 더 이상 사용되지 않는 네임스페이스 목록에 대한 개별 변경 사항을 조사합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하십시오.
/api/v1/namespaces/{name}
- DELETE: 네임스페이스 삭제
- GET: 지정된 네임스페이스 읽기
- PATCH: 지정된 네임스페이스를 부분적으로 업데이트
- PUT: 지정된 네임스페이스를 교체
/api/v1/watch/namespaces/{name}
- GET: 네임스페이스 유형의 오브젝트를 감시합니다. 더 이상 사용되지 않는 오브젝트: 'fieldSelector' 매개변수를 사용하여 목록 작업과 함께 'watch' 매개변수를 대신 사용하여 단일 항목으로 필터링합니다.
/api/v1/namespaces/{name}/status
- GET: 지정된 네임스페이스의 읽기 상태
- PATCH: 지정된 네임스페이스의 부분적으로 업데이트됨
- PUT: 지정된 네임스페이스의 상태
/api/v1/namespaces/{name}/finalize
- PUT: 지정된 네임스페이스의 완료

10.2.1. /api/v1/namespaces
링크 복사

HTTP 방법: GET
설명: 네임스페이스 유형의 오브젝트 나열 또는 감시

Expand

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

HTTP 방법: POST
설명: 네임스페이스 생성

Expand

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

Expand

표 10.3. 본문 매개변수
매개변수	유형	설명
`body`	`네임스페이스` 스키마

Expand

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

10.2.2. /api/v1/watch/namespaces
링크 복사

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

Expand

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

10.2.3. /api/v1/namespaces/{name}
링크 복사

Expand

표 10.6. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	네임스페이스 이름

HTTP 방법: DELETE
설명: 네임스페이스 삭제

Expand

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

Expand

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

HTTP 방법: GET
설명: 지정된 네임스페이스 읽기

Expand

표 10.9. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`네임스페이스` 스키마
401 - 무단	빈

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

Expand

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

Expand

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

HTTP 방법: PUT
설명: 지정된 네임스페이스 교체

Expand

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

Expand

표 10.13. 본문 매개변수
매개변수	유형	설명
`body`	`네임스페이스` 스키마

Expand

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

10.2.4. /api/v1/watch/namespaces/{name}
링크 복사

Expand

표 10.15. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	네임스페이스 이름

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

Expand

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

10.2.5. /api/v1/namespaces/{name}/status
링크 복사

Expand

표 10.17. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	네임스페이스 이름

HTTP 방법: GET
설명: 지정된 네임스페이스의 읽기 상태

Expand

표 10.18. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`네임스페이스` 스키마
401 - 무단	빈

HTTP 방법: PATCH
설명: 지정된 네임스페이스의 부분적으로 업데이트

Expand

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

Expand

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

HTTP 방법: PUT
설명: 지정된 네임스페이스의 상태 교체

Expand

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

Expand

표 10.22. 본문 매개변수
매개변수	유형	설명
`body`	`네임스페이스` 스키마

Expand

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

10.2.6. /api/v1/namespaces/{name}/finalize
링크 복사

Expand

표 10.24. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	네임스페이스 이름

Expand

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

HTTP 방법: PUT
설명: 지정된 네임스페이스의 종료를 교체

Expand

표 10.26. 본문 매개변수
매개변수	유형	설명
`body`	`네임스페이스` 스키마

Expand

표 10.27. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`네임스페이스` 스키마
201 - 생성됨	`네임스페이스` 스키마
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