일정 및 할당량 API


OpenShift Container Platform 4.15

일정 및 할당량 API에 대한 참조 가이드

Red Hat OpenShift Documentation Team

초록

이 문서에서는 OpenShift Container Platform 일정 및 할당량 API 오브젝트 및 세부 사양에 대해 설명합니다.

1장. 일정 및 할당량 API

1.1. AppliedClusterResourceQuota [quota.openshift.io/v1]

설명

AppliedClusterResourceQuota는 프로젝션을 위해 프로젝트 범위에서 ClusterResourceQuota를 미러링합니다. 이를 통해 project-admin은 어떤 ClusterResourceQuotas가 프로젝트 및 관련 사용량에 적용되는지 알 수 있습니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.2. ClusterResourceQuota [quota.openshift.io/v1]

설명
ClusterResourceQuota는 클러스터 범위에서 ResourceQuota를 미러링합니다. 이 오브젝트는 할당량 평가를 다시 사용할 수 있도록 합성 ResourceQuota 오브젝트로 쉽게 변환할 수 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.3. FlowSchema [flowcontrol.apiserver.k8s.io/v1beta3]

설명
FlowSchema는 흐름 그룹의 스키마를 정의합니다. 흐름은 유사한 특성을 가진 인바운드 API 요청 세트로 구성되며, FlowSchema 이름 및 "플로우 구분자"라는 한 쌍의 문자열로 식별됩니다.
유형
object

1.4. LimitRange [v1]

설명
LimitRange는 네임스페이스에서 각 유형의 리소스에 대한 리소스 사용량 제한을 설정합니다.
유형
object

1.5. PriorityClass [scheduling.k8s.io/v1]

설명
priorityclass는 우선순위 클래스 이름에서 우선순위 정수 값으로의 매핑을 정의합니다. 값은 유효한 정수일 수 있습니다.
유형
object

1.6. PriorityLevelConfiguration [flowcontrol.apiserver.k8s.io/v1beta3]

설명
PriorityLevelConfiguration은 우선순위 수준의 구성을 나타냅니다.
유형
object

1.7. ResourceQuota [v1]

설명
ResourceQuota는 네임스페이스별로 적용되는 집계 할당량 제한 사항 설정
유형
object

2장. AppliedClusterResourceQuota [quota.openshift.io/v1]

설명

AppliedClusterResourceQuota는 프로젝션을 위해 프로젝트 범위에서 ClusterResourceQuota를 미러링합니다. 이를 통해 project-admin은 어떤 ClusterResourceQuotas가 프로젝트 및 관련 사용량에 적용되는지 알 수 있습니다.

호환성 수준 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

ClusterResourceQuotaSpec은 원하는 할당량 제한을 정의합니다.

status

object

ClusterResourceQuotaStatus는 실제 적용 할당량 및 현재 사용량을 정의합니다.

2.1.1. .spec

설명
ClusterResourceQuotaSpec은 원하는 할당량 제한을 정의합니다.
유형
object
필수 항목
  • 선택기
  • 할당량
Expand
속성유형설명

할당량

ResourceQuotaSpec

할당량은 원하는 할당량을 정의합니다.

선택기

object

ClusterResourceQuotaSelector는 프로젝트를 선택하는 데 사용됩니다. LabelSelector 또는 AnnotationSelector 중 하나 이상이 있어야 합니다. 하나만 있는 경우 유일한 선택 기준입니다. 둘 다 지정하는 경우 프로젝트는 두 제한 사항과 일치해야 합니다.

2.1.2. .spec.selector

설명
ClusterResourceQuotaSelector는 프로젝트를 선택하는 데 사용됩니다. LabelSelector 또는 AnnotationSelector 중 하나 이상이 있어야 합니다. 하나만 있는 경우 유일한 선택 기준입니다. 둘 다 지정하는 경우 프로젝트는 두 제한 사항과 일치해야 합니다.
유형
object
Expand
속성유형설명

annotations

오브젝트(문자열)

AnnotationSelector는 주석으로 프로젝트를 선택하는 데 사용됩니다.

labels

LabelSelector

labelSelector는 레이블별로 프로젝트를 선택하는 데 사용됩니다.

2.1.3. .status

설명
ClusterResourceQuotaStatus는 실제 적용 할당량 및 현재 사용량을 정의합니다.
유형
object
필수 항목
  • 합계
Expand
속성유형설명

네임스페이스

array

네임스페이스는 프로젝트별 사용량을 분할합니다. 이 분할을 통해 모든 프로젝트를 다시 계산하지 않고도 단일 프로젝트 내에서 삭제 조정을 신속하게 해결할 수 있습니다. 이는 지정된 프로젝트의 deltas를 가져오는 데 사용할 수 있습니다.

namespaces[]

object

ResourceQuotaStatusByNamespace는 특정 프로젝트에 대한 상태 제공

합계

resourceQuotaStatus

Total은 모든 프로젝트에서 실제 적용 할당량과 현재 사용량을 정의합니다.

2.1.4. .status.namespaces

설명
네임스페이스는 프로젝트별 사용량을 분할합니다. 이 분할을 통해 모든 프로젝트를 다시 계산하지 않고도 단일 프로젝트 내에서 삭제 조정을 신속하게 해결할 수 있습니다. 이는 지정된 프로젝트의 deltas를 가져오는 데 사용할 수 있습니다.
유형
array

2.1.5. .status.namespaces[]

설명
ResourceQuotaStatusByNamespace는 특정 프로젝트에 대한 상태 제공
유형
object
필수 항목
  • 네임스페이스
  • status
Expand
속성유형설명

네임스페이스

string

이 상태가 적용되는 프로젝트의 네임스페이스

status

resourceQuotaStatus

Status는 이 프로젝트에서 사용한 리소스 수를 나타냅니다.

2.2. API 끝점

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

  • /apis/quota.openshift.io/v1/appliedclusterresourcequotas

    • GET: AppliedClusterResourceQuota 유형의 오브젝트 나열
  • /apis/quota.openshift.io/v1/namespaces/{namespace}/appliedclusterresourcequotas

    • GET: AppliedClusterResourceQuota 유형의 오브젝트 나열
  • /apis/quota.openshift.io/v1/namespaces/{namespace}/appliedclusterresourcequotas/{name}

    • GET: 지정된 AppliedClusterResourceQuota 읽기

2.2.1. /apis/quota.openshift.io/v1/appliedclusterresourcequotas

HTTP 방법
GET
설명
AppliedClusterResourceQuota 유형의 오브젝트 나열
Expand
표 2.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

AppliedClusterResourceQuotaList schema

401 - 무단

2.2.2. /apis/quota.openshift.io/v1/namespaces/{namespace}/appliedclusterresourcequotas

HTTP 방법
GET
설명
AppliedClusterResourceQuota 유형의 오브젝트 나열
Expand
표 2.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

AppliedClusterResourceQuotaList schema

401 - 무단

Expand
표 2.3. 글로벌 경로 매개변수
매개변수유형설명

name

string

AppliedClusterResourceQuota의 이름

HTTP 방법
GET
설명
지정된 AppliedClusterResourceQuota 읽기
Expand
표 2.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

AppliedClusterResourceQuota schema

401 - 무단

3장. ClusterResourceQuota [quota.openshift.io/v1]

설명
ClusterResourceQuota는 클러스터 범위에서 ResourceQuota를 미러링합니다. 이 오브젝트는 할당량 평가를 다시 사용할 수 있도록 합성 ResourceQuota 오브젝트로 쉽게 변환할 수 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • 메타데이터
  • spec

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

spec

object

spec은 원하는 할당량을 정의합니다.

status

object

status는 실제 적용 할당량 및 현재 사용량을 정의합니다.

3.1.1. .spec

설명
spec은 원하는 할당량을 정의합니다.
유형
object
필수 항목
  • 할당량
  • 선택기
Expand
속성유형설명

할당량

object

할당량은 원하는 할당량을 정의합니다.

선택기

object

selector는 프로젝트와 일치시키는 데 사용되는 선택기입니다. 수십 개의 규모에서만 활성 프로젝트를 선택해야 합니다(활성 프로젝트가 더 적은 수의 프로젝트를 선택할 수 있음). 이러한 프로젝트는 이 리소스를 통해 오브젝트 생성을 수행합니다.

3.1.2. .spec.quota

설명
할당량은 원하는 할당량을 정의합니다.
유형
object
Expand
속성유형설명

hard

integer-or-string

hard는 이름이 지정된 각 리소스에 대해 원하는 하드 제한 세트입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/policy/resource-quotas/

scopeSelector

object

scopeSelector는 할당량으로 추적되지만 가능한 값과 함께 ScopeSelectorOperator를 사용하여 표현해야 하는 각 오브젝트와 같은 필터 컬렉션이기도 합니다. 리소스가 일치하려면 범위 AND scopeSelector( spec에 지정된 경우) 둘 다 일치해야 합니다.

범위

배열(문자열)

할당량으로 추적되는 각 오브젝트와 일치해야 하는 필터 컬렉션입니다. 지정하지 않으면 할당량이 모든 오브젝트와 일치합니다.

3.1.3. .spec.quota.scopeSelector

설명
scopeSelector는 할당량으로 추적되지만 가능한 값과 함께 ScopeSelectorOperator를 사용하여 표현해야 하는 각 오브젝트와 같은 필터 컬렉션이기도 합니다. 리소스가 일치하려면 범위 AND scopeSelector( spec에 지정된 경우) 둘 다 일치해야 합니다.
유형
object
Expand
속성유형설명

matchExpressions

array

리소스 범위에 따른 범위 선택기 요구 사항 목록입니다.

matchExpressions[]

object

scoped-resource selector 요구 사항은 범위 이름 및 값과 관련된 값, 범위 이름 및 연산자를 포함하는 선택기입니다.

3.1.4. .spec.quota.scopeSelector.matchExpressions

설명
리소스 범위에 따른 범위 선택기 요구 사항 목록입니다.
유형
array

3.1.5. .spec.quota.scopeSelector.matchExpressions[]

설명
scoped-resource selector 요구 사항은 범위 이름 및 값과 관련된 값, 범위 이름 및 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • operator
  • scopeName
Expand
속성유형설명

operator

string

값 집합에 대한 범위 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다.

scopeName

string

선택기가 적용되는 범위의 이름입니다.

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

3.1.6. .spec.selector

설명
selector는 프로젝트와 일치시키는 데 사용되는 선택기입니다. 수십 개의 규모에서만 활성 프로젝트를 선택해야 합니다(활성 프로젝트가 더 적은 수의 프로젝트를 선택할 수 있음). 이러한 프로젝트는 이 리소스를 통해 오브젝트 생성을 수행합니다.
유형
object
Expand
속성유형설명

annotations

정의되지 않음(문자열)

AnnotationSelector는 주석으로 프로젝트를 선택하는 데 사용됩니다.

labels

``

labelSelector는 레이블별로 프로젝트를 선택하는 데 사용됩니다.

3.1.7. .status

설명
status는 실제 적용 할당량 및 현재 사용량을 정의합니다.
유형
object
필수 항목
  • 합계
Expand
속성유형설명

네임스페이스

``

네임스페이스는 프로젝트별 사용량을 분할합니다. 이 분할을 통해 모든 프로젝트를 다시 계산하지 않고도 단일 프로젝트 내에서 삭제 조정을 신속하게 해결할 수 있습니다. 이는 지정된 프로젝트의 deltas를 가져오는 데 사용할 수 있습니다.

합계

object

Total은 모든 프로젝트에서 실제 적용 할당량과 현재 사용량을 정의합니다.

3.1.8. .status.total

설명
Total은 모든 프로젝트에서 실제 적용 할당량과 현재 사용량을 정의합니다.
유형
object
Expand
속성유형설명

hard

integer-or-string

hard는 이름이 지정된 각 리소스에 대해 강제 적용된 하드 제한 세트입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/policy/resource-quotas/

사용됨

integer-or-string

이는 네임스페이스에서 리소스를 현재 관찰하는 총 사용량입니다.

3.2. API 끝점

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

  • /apis/quota.openshift.io/v1/clusterresourcequotas

    • DELETE: ClusterResourceQuota의 컬렉션 삭제
    • GET: ClusterResourceQuota 유형의 오브젝트 나열
    • POST: ClusterResourceQuota 만들기
  • /apis/quota.openshift.io/v1/watch/clusterresourcequotas

    • GET: ClusterResourceQuota 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /apis/quota.openshift.io/v1/clusterresourcequotas/{name}

    • DELETE: ClusterResourceQuota 삭제
    • GET: 지정된 ClusterResourceQuota 읽기
    • PATCH: 지정된 ClusterResourceQuota를 부분적으로 업데이트
    • PUT: 지정된 ClusterResourceQuota를 교체
  • /apis/quota.openshift.io/v1/watch/clusterresourcequotas/{name}

    • GET: ClusterResourceQuota 유형의 오브젝트 변경 사항을 조사합니다. 더 이상 사용되지 않는 ClusterResourceQuota: 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/quota.openshift.io/v1/clusterresourcequotas/{name}/status

    • GET: 지정된 ClusterResourceQuota의 읽기 상태
    • PATCH: 지정된 ClusterResourceQuota의 부분적으로 업데이트 상태
    • PUT: 지정된 ClusterResourceQuota의 상태 교체

3.2.1. /apis/quota.openshift.io/v1/clusterresourcequotas

HTTP 방법
DELETE
설명
ClusterResourceQuota의 컬렉션 삭제
Expand
표 3.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ClusterResourceQuota 유형의 오브젝트 나열
Expand
표 3.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterResourceQuotaList 스키마

401 - 무단

HTTP 방법
POST
설명
ClusterResourceQuota 만들기
Expand
표 3.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 3.4. 본문 매개변수
매개변수유형설명

body

ClusterResourceQuota 스키마

 
Expand
표 3.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterResourceQuota 스키마

201 - 생성됨

ClusterResourceQuota 스키마

202 - 승인됨

ClusterResourceQuota 스키마

401 - 무단

3.2.2. /apis/quota.openshift.io/v1/watch/clusterresourcequotas

HTTP 방법
GET
설명
ClusterResourceQuota 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
Expand
표 3.6. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

3.2.3. /apis/quota.openshift.io/v1/clusterresourcequotas/{name}

Expand
표 3.7. 글로벌 경로 매개변수
매개변수유형설명

name

string

ClusterResourceQuota의 이름

HTTP 방법
DELETE
설명
ClusterResourceQuota 삭제
Expand
표 3.8. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

Expand
표 3.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ClusterResourceQuota 읽기
Expand
표 3.10. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterResourceQuota 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ClusterResourceQuota를 부분적으로 업데이트
Expand
표 3.11. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 3.12. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterResourceQuota 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ClusterResourceQuota를 교체
Expand
표 3.13. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 3.14. 본문 매개변수
매개변수유형설명

body

ClusterResourceQuota 스키마

 
Expand
표 3.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterResourceQuota 스키마

201 - 생성됨

ClusterResourceQuota 스키마

401 - 무단

3.2.4. /apis/quota.openshift.io/v1/watch/clusterresourcequotas/{name}

Expand
표 3.16. 글로벌 경로 매개변수
매개변수유형설명

name

string

ClusterResourceQuota의 이름

HTTP 방법
GET
설명
ClusterResourceQuota. deprecated 유형의 오브젝트 변경 사항을 확인합니다. 대신 목록 작업과 함께 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 'watch' 매개변수를 사용합니다.
Expand
표 3.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

3.2.5. /apis/quota.openshift.io/v1/clusterresourcequotas/{name}/status

Expand
표 3.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

ClusterResourceQuota의 이름

HTTP 방법
GET
설명
지정된 ClusterResourceQuota의 상태 읽기
Expand
표 3.19. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterResourceQuota 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ClusterResourceQuota의 부분적으로 업데이트 상태
Expand
표 3.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 3.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterResourceQuota 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ClusterResourceQuota의 상태 교체
Expand
표 3.22. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 3.23. 본문 매개변수
매개변수유형설명

body

ClusterResourceQuota 스키마

 
Expand
표 3.24. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterResourceQuota 스키마

201 - 생성됨

ClusterResourceQuota 스키마

401 - 무단

4장. FlowSchema [flowcontrol.apiserver.k8s.io/v1beta3]

설명
FlowSchema는 흐름 그룹의 스키마를 정의합니다. 흐름은 유사한 특성을 가진 인바운드 API 요청 세트로 구성되며, FlowSchema 이름 및 "플로우 구분자"라는 한 쌍의 문자열로 식별됩니다.
유형
object

4.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

FlowSchemaSpec은 FlowSchema의 사양이 어떻게 표시되는지 설명합니다.

status

object

FlowSchemaStatus는 FlowSchema의 현재 상태를 나타냅니다.

4.1.1. .spec

설명
FlowSchemaSpec은 FlowSchema의 사양이 어떻게 표시되는지 설명합니다.
유형
object
필수 항목
  • priorityLevelConfiguration
Expand
속성유형설명

distinguisherMethod

object

FlowDistinguisherMethod는 흐름 구분 방법을 지정합니다.

matchingPrecedence

integer

matchingPrecedence 는 지정된 요청과 일치하는 FlowSchemas 중에서 선택하는 데 사용됩니다. 선택한 FlowSchema는 숫자가 가장 낮은 것 중 하나입니다 (저희가 논리적으로 가장 높은 수준) MatchingPrecedence. 각 MatchingPrecedence 값은 [1,10000]에서 범위를 지정해야 합니다. 우선순위를 지정하지 않으면 기본값으로 1000으로 설정됩니다.

priorityLevelConfiguration

object

PriorityLevelConfigurationReference에는 사용 중인 "request-priority"를 가리키는 정보가 포함되어 있습니다.

규칙

array

규칙은 이 흐름 스키마와 일치하는 요청을 설명합니다. 이 FlowSchema는 규칙 중 하나 이상이 요청과 일치하는 경우에만 요청과 일치합니다. 빈 슬라이스인 경우 FlowSchema와 일치하는 요청이 없습니다.

rules[]

object

PolicyRulesWithSubjects는 apiserver 요청에 적용되는 테스트를 규정합니다. 테스트에서는 요청, 요청 동사 및 조치를 취할 리소스를 고려합니다. 이 PolicyRulesWithSubjects는 (a) 주체의 하나 이상의 멤버가 요청과 일치하는 경우에만 요청과 일치합니다. (b) resourceRules 또는 nonResourceRules의 멤버가 요청과 일치합니다.

4.1.2. .spec.distinguisherMethod

설명
FlowDistinguisherMethod는 흐름 구분 방법을 지정합니다.
유형
object
필수 항목
  • type
Expand
속성유형설명

type

string

type 은 흐름 구분 메서드의 유형입니다. 지원되는 유형은 "ByUser" 및 "ByNamespace"입니다. 필수 항목입니다.

4.1.3. .spec.priorityLevelConfiguration

설명
PriorityLevelConfigurationReference에는 사용 중인 "request-priority"를 가리키는 정보가 포함되어 있습니다.
유형
object
필수 항목
  • name
Expand
속성유형설명

name

string

name 은 참조되는 우선순위 수준 구성의 이름입니다.

4.1.4. .spec.rules

설명
규칙은 이 흐름 스키마와 일치하는 요청을 설명합니다. 이 FlowSchema는 규칙 중 하나 이상이 요청과 일치하는 경우에만 요청과 일치합니다. 빈 슬라이스인 경우 FlowSchema와 일치하는 요청이 없습니다.
유형
array

4.1.5. .spec.rules[]

설명
PolicyRulesWithSubjects는 apiserver 요청에 적용되는 테스트를 규정합니다. 테스트에서는 요청, 요청 동사 및 조치를 취할 리소스를 고려합니다. 이 PolicyRulesWithSubjects는 (a) 주체의 하나 이상의 멤버가 요청과 일치하는 경우에만 요청과 일치합니다. (b) resourceRules 또는 nonResourceRules의 멤버가 요청과 일치합니다.
유형
object
필수 항목
  • 제목
Expand
속성유형설명

비ResourceRules

array

nonResourceRules 는 동사 및 대상 비 리소스 URL에 따라 일치하는 요청을 식별하는 NonResourcePolicyRules 목록입니다.

nonResourceRules[]

object

NonResourcePolicyRule는 동사 및 대상 비 리소스 URL에 따라 리소스가 아닌 요청과 일치하는 서술자입니다. NonResourcePolicyRule은 (a) 동사의 둘 다와 일치하고 (b) nonResourceURLs의 멤버 중 하나 이상이 요청과 일치하는 경우에만 요청을 찾습니다.

resourceRules

array

resourceRules 는 동사 및 대상 리소스에 따라 일치하는 요청을 식별하는 ResourcePolicyRules의 슬라이스입니다. resourceRulesnonResourceRules 중 하나 이상이 비어 있지 않아야 합니다.

resourceRules[]

object

ResourcePolicyRule는 일부 리소스 요청과 일치하여 요청의 동사 및 대상 리소스를 테스트하는 서술자입니다. ResourcePolicyRule은 (a) 동사의 멤버가 요청과 일치하는 경우 리소스 요청과 일치합니다. (b) apiGroups 중 하나 이상의 멤버가 요청과 일치하고 (c) 리소스의 멤버가 요청과 일치하고 (d1) 요청 중 하나 이상(d1)이 네임스페이스(즉,)를 지정하지 않는 경우 리소스 요청을 찾습니다. namespace=="") 및 clusterScope가 true 또는 (d2) 이면 요청은 네임스페이스를 지정하고, 네임스페이스의 멤버가 요청의 네임스페이스와 일치합니다.

제목

array

주체는 이 규칙에 중점을 둔 일반 사용자, serviceaccount 또는 그룹 목록입니다. 이 슬라이스에는 멤버가 하나 이상 있어야 합니다. system:authenticated 및 system:unauthenticated 사용자 그룹을 모두 포함하는 슬라이스는 모든 요청과 일치합니다. 필수 항목입니다.

subjects[]

object

subject는 요청 인증 시스템에 의해 식별된 요청의 출처와 일치합니다. 오리케이터와 일치하는 세 가지 방법, 즉 사용자, 그룹 또는 서비스 계정입니다.

4.1.6. .spec.rules[].nonResourceRules

설명
nonResourceRules 는 동사 및 대상 비 리소스 URL에 따라 일치하는 요청을 식별하는 NonResourcePolicyRules 목록입니다.
유형
array

4.1.7. .spec.rules[].nonResourceRules[]

설명
NonResourcePolicyRule는 동사 및 대상 비 리소스 URL에 따라 리소스가 아닌 요청과 일치하는 서술자입니다. NonResourcePolicyRule은 (a) 동사의 둘 다와 일치하고 (b) nonResourceURLs의 멤버 중 하나 이상이 요청과 일치하는 경우에만 요청을 찾습니다.
유형
object
필수 항목
  • verbs
  • nonResourceURLs
Expand
속성유형설명

nonResourceURLs

배열(문자열)

nonResourceURLs 는 사용자가 액세스할 수 있어야 하고 비어 있지 않을 수 있는 url 접두사 세트입니다. 예를 들어 - "/healthz"는 합법적입니다. "/hea*"는 불법입니다. "/hea/ "도 아무 것도 일치하지 않습니다. "/healthz/ "는 모든 구성 요소별 상태 점검과 일치합니다. "*"는 모든 리소스가 아닌 URL과 일치합니다. 존재하는 경우 유일한 항목이어야 합니다. 필수 항목입니다.

verbs

배열(문자열)

동사 는 일치하는 동사 목록이며 비어 있지 않을 수 있습니다. "*"는 모든 동사와 일치합니다. 이 항목이 있는 경우 유일한 항목이어야 합니다. 필수 항목입니다.

4.1.8. .spec.rules[].resourceRules

설명
resourceRules 는 동사 및 대상 리소스에 따라 일치하는 요청을 식별하는 ResourcePolicyRules의 슬라이스입니다. resourceRulesnonResourceRules 중 하나 이상이 비어 있지 않아야 합니다.
유형
array

4.1.9. .spec.rules[].resourceRules[]

설명
ResourcePolicyRule는 일부 리소스 요청과 일치하여 요청의 동사 및 대상 리소스를 테스트하는 서술자입니다. ResourcePolicyRule은 (a) 동사의 멤버가 요청과 일치하는 경우 리소스 요청과 일치합니다. (b) apiGroups 중 하나 이상의 멤버가 요청과 일치하고 (c) 리소스의 멤버가 요청과 일치하고 (d1) 요청 중 하나 이상(d1)이 네임스페이스(즉,)를 지정하지 않는 경우 리소스 요청을 찾습니다. namespace=="") 및 clusterScope가 true 또는 (d2) 이면 요청은 네임스페이스를 지정하고, 네임스페이스의 멤버가 요청의 네임스페이스와 일치합니다.
유형
object
필수 항목
  • verbs
  • apiGroups
  • resources
Expand
속성유형설명

apiGroups

배열(문자열)

apiGroups 는 일치하는 API 그룹 목록이며 비어 있지 않을 수 있습니다. "*"가 모든 API 그룹과 일치하고 있는 경우 유일한 항목이어야 합니다. 필수 항목입니다.

clusterScope

boolean

clusterScope 는 네임스페이스를 지정하지 않는 요청과 일치할지 여부를 나타냅니다(리소스가 네임스페이스가 아니거나 요청이 모든 네임스페이스를 대상으로 하기 때문에 발생함). 이 필드를 생략하거나 false인 경우 namespaces 필드에 비어 있지 않은 목록이 포함되어야 합니다.

네임스페이스

배열(문자열)

네임스페이스 는 일치하는 항목을 제한하는 대상 네임스페이스 목록입니다. (a) 이 목록에 해당 대상 네임스페이스 또는 (b) 이 목록에 ""이 포함된 경우에만 대상 네임스페이스를 지정하는 요청입니다. ""은/는 지정된 네임스페이스와 일치하지만 네임스페이스를 지정하지 않는 요청과 일치하지 않습니다 (이에 대한 clusterScope 필드 참조). 이 목록은 비어 있을 수 있지만 clusterScope 가 true인 경우에만 해당됩니다.

resources

배열(문자열)

리소스는 필요한 경우 하위 리소스가 포함된 일치하는 리소스(예: 소문자 및 복수) 목록입니다. 예를 들면 [서비스", "노드/상태" ]입니다. 이 목록은 비어 있지 않을 수 있습니다. "*"는 모든 리소스와 일치하며 존재하는 경우 유일한 항목이어야 합니다. 필수 항목입니다.

verbs

배열(문자열)

동사 는 일치하는 동사 목록이며 비어 있지 않을 수 있습니다. "*"는 모든 동사와 일치하며, 존재하는 경우 유일한 항목이어야 합니다. 필수 항목입니다.

4.1.10. .spec.rules[].subjects

설명
주체는 이 규칙에 중점을 둔 일반 사용자, serviceaccount 또는 그룹 목록입니다. 이 슬라이스에는 멤버가 하나 이상 있어야 합니다. system:authenticated 및 system:unauthenticated 사용자 그룹을 모두 포함하는 슬라이스는 모든 요청과 일치합니다. 필수 항목입니다.
유형
array

4.1.11. .spec.rules[].subjects[]

설명
subject는 요청 인증 시스템에 의해 식별된 요청의 출처와 일치합니다. 오리케이터와 일치하는 세 가지 방법, 즉 사용자, 그룹 또는 서비스 계정입니다.
유형
object
필수 항목
  • kind
Expand
속성유형설명

group

object

GroupSubject는 그룹 관련 주제에 대한 자세한 정보를 보유하고 있습니다.

kind

string

kind 는 다른 필드 중 비어 있지 않은 필드를 나타냅니다. 필수 항목

serviceAccount

object

ServiceAccountSubject에는 service-account-kind 제목에 대한 자세한 정보가 포함되어 있습니다.

user

object

UserSubject는 사용자 관련 주제에 대한 자세한 정보를 보유하고 있습니다.

4.1.12. .spec.rules[].subjects[].group

설명
GroupSubject는 그룹 관련 주제에 대한 자세한 정보를 보유하고 있습니다.
유형
object
필수 항목
  • name
Expand
속성유형설명

name

string

name은 모든 사용자 그룹과 일치하는 사용자 그룹 또는 "*"입니다. 잘 알려진 그룹 이름은 https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go 을 참조하십시오. 필수 항목입니다.

4.1.13. .spec.rules[].subjects[].serviceAccount

설명
ServiceAccountSubject에는 service-account-kind 제목에 대한 자세한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • 네임스페이스
  • name
Expand
속성유형설명

name

string

name 은 이름에 관계없이 일치하는 ServiceAccount 오브젝트 또는 "*"의 이름입니다. 필수 항목입니다.

네임스페이스

string

namespace 는 ServiceAccount 오브젝트와 일치하는 네임스페이스입니다. 필수 항목입니다.

4.1.14. .spec.rules[].subjects[].user

설명
UserSubject는 사용자 관련 주제에 대한 자세한 정보를 보유하고 있습니다.
유형
object
필수 항목
  • name
Expand
속성유형설명

name

string

name 은 일치하는 사용자 이름 또는 모든 사용자 이름과 일치하는 "*"입니다. 필수 항목입니다.

4.1.15. .status

설명
FlowSchemaStatus는 FlowSchema의 현재 상태를 나타냅니다.
유형
object
Expand
속성유형설명

conditions

array

조건은 FlowSchema의 현재 상태 목록입니다.

conditions[]

object

FlowSchemaCondition은 FlowSchema의 조건을 설명합니다.

4.1.16. .status.conditions

설명
조건은 FlowSchema의 현재 상태 목록입니다.
유형
array

4.1.17. .status.conditions[]

설명
FlowSchemaCondition은 FlowSchema의 조건을 설명합니다.
유형
object
Expand
속성유형설명

lastTransitionTime

시간

lastTransitionTime 은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다.

message

string

message 는 마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.

reason

string

이유는 조건의 마지막 전환에 대한 고유한 한 단어, CamelCase 이유입니다.

status

string

Status 는 조건의 상태입니다. True, False, 알 수 없음 필수 항목입니다.

type

string

type 은 조건의 유형입니다. 필수 항목입니다.

4.2. API 끝점

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

  • /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas

    • DELETE: FlowSchema의 컬렉션 삭제
    • GET: FlowSchema 유형의 오브젝트 목록 또는 감시
    • POST: FlowSchema를 생성
  • /apis/flowcontrol.apiserver.k8s.io/v1beta3/watch/flowschemas

    • GET: 더 이상 사용되지 않는 FlowSchema.com 목록의 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}

    • DELETE: FlowSchema 삭제
    • GET: 지정된 FlowSchema 읽기
    • PATCH: 지정된 FlowSchema를 부분적으로 업데이트
    • PUT: 지정된 FlowSchema를 교체합니다.
  • /apis/flowcontrol.apiserver.k8s.io/v1beta3/watch/flowschemas/{name}

    • GET: 더 이상 사용되지 않는 FlowSchema. deprecated 개체를 변경합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개 변수가 있는 단일 항목으로 필터링됩니다.
  • /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}/status

    • GET: 지정된 FlowSchema의 읽기 상태
    • PATCH: 지정된 FlowSchema의 부분 업데이트 상태
    • PUT: 지정된 FlowSchema의 상태

4.2.1. /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas

HTTP 방법
DELETE
설명
FlowSchema 컬렉션 삭제
Expand
표 4.1. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

Expand
표 4.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
FlowSchema 유형의 개체 목록 또는 감시
Expand
표 4.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

FlowSchemaList 스키마

401 - 무단

HTTP 방법
POST
설명
FlowSchema 만들기
Expand
표 4.4. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 4.5. 본문 매개변수
매개변수유형설명

body

FlowSchema 스키마

 
Expand
표 4.6. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

FlowSchema 스키마

201 - 생성됨

FlowSchema 스키마

202 - 승인됨

FlowSchema 스키마

401 - 무단

4.2.2. /apis/flowcontrol.apiserver.k8s.io/v1beta3/watch/flowschemas

HTTP 방법
GET
설명
더 이상 사용되지 않는 FlowSchema.list에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
Expand
표 4.7. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

4.2.3. /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}

Expand
표 4.8. 글로벌 경로 매개변수
매개변수유형설명

name

string

FlowSchema의 이름

HTTP 방법
DELETE
설명
FlowSchema 삭제
Expand
표 4.9. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

Expand
표 4.10. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 FlowSchema 읽기
Expand
표 4.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

FlowSchema 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 FlowSchema를 부분적으로 업데이트
Expand
표 4.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 4.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

FlowSchema 스키마

201 - 생성됨

FlowSchema 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 FlowSchema를 교체합니다.
Expand
표 4.14. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 4.15. 본문 매개변수
매개변수유형설명

body

FlowSchema 스키마

 
Expand
표 4.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

FlowSchema 스키마

201 - 생성됨

FlowSchema 스키마

401 - 무단

4.2.4. /apis/flowcontrol.apiserver.k8s.io/v1beta3/watch/flowschemas/{name}

Expand
표 4.17. 글로벌 경로 매개변수
매개변수유형설명

name

string

FlowSchema의 이름

HTTP 방법
GET
설명
더 이상 사용되지 않는 종류의 개체를 감시합니다. 대신 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
Expand
표 4.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

4.2.5. /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}/status

Expand
표 4.19. 글로벌 경로 매개변수
매개변수유형설명

name

string

FlowSchema의 이름

HTTP 방법
GET
설명
지정된 FlowSchema의 읽기 상태
Expand
표 4.20. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

FlowSchema 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 FlowSchema의 부분적으로 업데이트 상태
Expand
표 4.21. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 4.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

FlowSchema 스키마

201 - 생성됨

FlowSchema 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 FlowSchema의 상태 교체
Expand
표 4.23. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 4.24. 본문 매개변수
매개변수유형설명

body

FlowSchema 스키마

 
Expand
표 4.25. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

FlowSchema 스키마

201 - 생성됨

FlowSchema 스키마

401 - 무단

5장. LimitRange [v1]

설명
LimitRange는 네임스페이스에서 각 유형의 리소스에 대한 리소스 사용량 제한을 설정합니다.
유형
object

5.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

LimitRangeSpec은 종류와 일치하는 리소스의 min/max 사용 제한을 정의합니다.

5.1.1. .spec

설명
LimitRangeSpec은 종류와 일치하는 리소스의 min/max 사용 제한을 정의합니다.
유형
object
필수 항목
  • limits
Expand
속성유형설명

limits

array

제한은 적용되는 LimitRangeItem 오브젝트 목록입니다.

limits[]

object

LimitRangeItem은 종류와 일치하는 리소스에 대한 min/max 사용 제한을 정의합니다.

5.1.2. .spec.limits

설명
제한은 적용되는 LimitRangeItem 오브젝트 목록입니다.
유형
array

5.1.3. .spec.limits[]

설명
LimitRangeItem은 종류와 일치하는 리소스에 대한 min/max 사용 제한을 정의합니다.
유형
object
필수 항목
  • type
Expand
속성유형설명

default

오브젝트(Quantity)

리소스 제한이 생략된 경우 리소스 이름별 기본 리소스 요구 사항 제한 값입니다.

defaultRequest

오브젝트(Quantity)

리소스 요청이 생략된 경우 defaultRequest는 리소스 이름별 기본 리소스 요구 사항 요청 값입니다.

Max

오브젝트(Quantity)

리소스 이름으로 이 종류의 최대 사용 제한 조건입니다.

maxLimitRequestRatio

오브젝트(Quantity)

maxLimitRequestRatio를 지정하면 named 리소스에 0이 아닌 요청과 제한이 모두 있어야 합니다. 여기서 제한은 열거된 값보다 작거나 같습니다. 이 값은 이름이 지정된 리소스의 max burst를 나타냅니다.

min

오브젝트(Quantity)

리소스 이름별로 이러한 종류의 사용 제약 조건의 최소 사용 제한 사항입니다.

type

string

이 제한이 적용되는 리소스 유형입니다.

5.2. API 끝점

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

  • /api/v1/limitranges

    • GET: LimitRange 유형의 오브젝트 목록 또는 감시
  • /api/v1/watch/limitranges

    • GET: LimitRange 목록의 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /api/v1/namespaces/{namespace}/limitranges

    • DELETE: LimitRange의 컬렉션 삭제
    • GET: LimitRange 유형의 오브젝트 목록 또는 감시
    • POST: LimitRange 생성
  • /api/v1/watch/namespaces/{namespace}/limitranges

    • GET: LimitRange 목록의 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /api/v1/namespaces/{namespace}/limitranges/{name}

    • DELETE: LimitRange 삭제
    • GET: 지정된 LimitRange 읽기
    • PATCH: 지정된 LimitRange를 부분적으로 업데이트
    • PUT: 지정된 LimitRange를 교체
  • /api/v1/watch/namespaces/{namespace}/limitranges/{name}

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

5.2.1. /api/v1/limitranges

HTTP 방법
GET
설명
LimitRange 유형의 오브젝트 나열 또는 감시
Expand
표 5.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

LimitRangeList schema

401 - 무단

5.2.2. /api/v1/watch/limitranges

HTTP 방법
GET
설명
LimitRange 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 'watch' 매개변수를 대신 목록 작업과 함께 사용합니다.
Expand
표 5.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

5.2.3. /api/v1/namespaces/{namespace}/limitranges

HTTP 방법
DELETE
설명
LimitRange 컬렉션 삭제
Expand
표 5.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

Expand
표 5.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
LimitRange 유형의 오브젝트 나열 또는 감시
Expand
표 5.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

LimitRangeList schema

401 - 무단

HTTP 방법
POST
설명
LimitRange 생성
Expand
표 5.6. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 5.7. 본문 매개변수
매개변수유형설명

body

LimitRange 스키마

 
Expand
표 5.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

LimitRange 스키마

201 - 생성됨

LimitRange 스키마

202 - 승인됨

LimitRange 스키마

401 - 무단

5.2.4. /api/v1/watch/namespaces/{namespace}/limitranges

HTTP 방법
GET
설명
LimitRange 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 'watch' 매개변수를 대신 목록 작업과 함께 사용합니다.
Expand
표 5.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

5.2.5. /api/v1/namespaces/{namespace}/limitranges/{name}

Expand
표 5.10. 글로벌 경로 매개변수
매개변수유형설명

name

string

LimitRange의 이름

HTTP 방법
DELETE
설명
LimitRange 삭제
Expand
표 5.11. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

Expand
표 5.12. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 LimitRange 읽기
Expand
표 5.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

LimitRange 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 LimitRange를 부분적으로 업데이트
Expand
표 5.14. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 5.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

LimitRange 스키마

201 - 생성됨

LimitRange 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 LimitRange를 교체
Expand
표 5.16. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 5.17. 본문 매개변수
매개변수유형설명

body

LimitRange 스키마

 
Expand
표 5.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

LimitRange 스키마

201 - 생성됨

LimitRange 스키마

401 - 무단

5.2.6. /api/v1/watch/namespaces/{namespace}/limitranges/{name}

Expand
표 5.19. 글로벌 경로 매개변수
매개변수유형설명

name

string

LimitRange의 이름

HTTP 방법
GET
설명
다음과 같은 LimitRange 오브젝트를 확인합니다. 더 이상 사용되지 않는 오브젝트를 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
Expand
표 5.20. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

6장. PriorityClass [scheduling.k8s.io/v1]

설명
priorityclass는 우선순위 클래스 이름에서 우선순위 정수 값으로의 매핑을 정의합니다. 값은 유효한 정수일 수 있습니다.
유형
object
필수 항목
  • value

6.1. 사양

Expand
속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

description

string

Description은 일반적으로 이 우선순위 클래스를 사용해야 하는 시기에 대한 지침을 제공하는 임의의 문자열입니다.

globalDefault

boolean

globalDefault는 이 PriorityClass를 우선순위 클래스가 없는 Pod의 기본 우선순위로 간주해야 하는지 여부를 지정합니다. 하나의 PriorityClass만 globalDefault 로 표시할 수 있습니다. 그러나 globalDefault 필드가 true로 설정된 두 개 이상의 Priority 클래스가 있는 경우 이러한 글로벌 기본 우선 순위 클래스의 최소 값이 기본 우선 순위로 사용됩니다.

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

preemptionPolicy

string

preemptionPolicy는 우선순위가 낮은 Pod를 선점하는 정책입니다. Never, PreemptLowerPriority 중 하나입니다. 설정되지 않은 경우 기본값은 PreemptLowerPriority입니다.

가능한 enum 값: - "Never" 는 Pod가 우선순위가 낮은 다른 Pod를 선점하지 않음을 의미합니다. - "PreemptLowerPriority" 는 Pod가 우선순위가 낮은 다른 Pod를 선점할 수 있음을 의미합니다.

value

integer

value는 이 우선순위 클래스의 정수 값을 나타냅니다. 이는 Pod 사양에 이 클래스의 이름이 있을 때 Pod가 수신하는 실제 우선순위입니다.

6.2. API 끝점

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

  • /apis/scheduling.k8s.io/v1/priorityclasses

    • DELETE: PriorityClass의 컬렉션 삭제
    • GET: PriorityClass 유형의 오브젝트 목록 또는 감시
    • POST: PriorityClass 생성
  • /apis/scheduling.k8s.io/v1/watch/priorityclasses

    • GET: PriorityClass. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/scheduling.k8s.io/v1/priorityclasses/{name}

    • DELETE: PriorityClass 삭제
    • GET: 지정된 PriorityClass 읽기
    • PATCH: 지정된 PriorityClass를 부분적으로 업데이트
    • PUT: 지정된 PriorityClass를 교체합니다.
  • /apis/scheduling.k8s.io/v1/watch/priorityclasses/{name}

    • GET: kind PriorityClass. deprecated 오브젝트의 변경 사항을 감시합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.

6.2.1. /apis/scheduling.k8s.io/v1/priorityclasses

HTTP 방법
DELETE
설명
PriorityClass의 컬렉션 삭제
Expand
표 6.1. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

Expand
표 6.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
PriorityClass 유형의 오브젝트 나열 또는 감시
Expand
표 6.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PriorityClassList schema

401 - 무단

HTTP 방법
POST
설명
PriorityClass 생성
Expand
표 6.4. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 6.5. 본문 매개변수
매개변수유형설명

body

Priorityclass 스키마

 
Expand
표 6.6. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Priorityclass 스키마

201 - 생성됨

Priorityclass 스키마

202 - 승인됨

Priorityclass 스키마

401 - 무단

6.2.2. /apis/scheduling.k8s.io/v1/watch/priorityclasses

HTTP 방법
GET
설명
PriorityClass. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
Expand
표 6.7. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

6.2.3. /apis/scheduling.k8s.io/v1/priorityclasses/{name}

Expand
표 6.8. 글로벌 경로 매개변수
매개변수유형설명

name

string

PriorityClass의 이름

HTTP 방법
DELETE
설명
PriorityClass 삭제
Expand
표 6.9. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

Expand
표 6.10. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 PriorityClass 읽기
Expand
표 6.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Priorityclass 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 PriorityClass를 부분적으로 업데이트
Expand
표 6.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 6.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Priorityclass 스키마

201 - 생성됨

Priorityclass 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 PriorityClass를 교체
Expand
표 6.14. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 6.15. 본문 매개변수
매개변수유형설명

body

Priorityclass 스키마

 
Expand
표 6.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Priorityclass 스키마

201 - 생성됨

Priorityclass 스키마

401 - 무단

6.2.4. /apis/scheduling.k8s.io/v1/watch/priorityclasses/{name}

Expand
표 6.17. 글로벌 경로 매개변수
매개변수유형설명

name

string

PriorityClass의 이름

HTTP 방법
GET
설명
kind PriorityClass. deprecated 오브젝트의 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
Expand
표 6.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

7장. PriorityLevelConfiguration [flowcontrol.apiserver.k8s.io/v1beta3]

설명
PriorityLevelConfiguration은 우선순위 수준의 구성을 나타냅니다.
유형
object

7.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

PriorityLevelConfigurationSpec은 우선 순위 수준의 구성을 지정합니다.

status

object

PriorityLevelConfigurationStatus는 "request-priority"의 현재 상태를 나타냅니다.

7.1.1. .spec

설명
PriorityLevelConfigurationSpec은 우선 순위 수준의 구성을 지정합니다.
유형
object
필수 항목
  • type
Expand
속성유형설명

제외

object

ExemptPriorityLevelConfiguration은 예외 요청 처리의 구성 가능한 측면을 설명합니다. 필수 제외 구성 개체에서 여기에 있는 필드의 값은 나머지 사양 과 달리 권한 있는 사용자가 수정할 수 있습니다.

제한됨

object

LimitedPriorityLevelConfiguration은 제한에 따라 요청을 처리하는 방법을 지정합니다. 두 가지 문제를 해결했습니다. - 이 우선 순위 수준에 대한 요청은 어떻게 제한됩니까? - 제한을 초과하는 요청으로 어떻게 해야 합니까?

type

string

type 은 이 우선순위 수준이 요청 실행 시 제한될 수 있는지 여부를 나타냅니다. "Exempt" 값은 이 우선순위 수준의 요청이 제한의 영향을 받지 않고 다른 우선 순위 수준에서 사용 가능한 용량에서 중단되지 않음을 의미합니다. "제한된" 값은 (a) 이 우선 순위 수준의 요청에 제한이 적용되며 (b) 서버의 제한된 용량 중 일부를 이 우선 순위 수준에서 독점적으로 사용할 수 있음을 의미합니다. 필수 항목입니다.

7.1.2. .spec.exempt

설명
ExemptPriorityLevelConfiguration은 예외 요청 처리의 구성 가능한 측면을 설명합니다. 필수 제외 구성 개체에서 여기에 있는 필드의 값은 나머지 사양 과 달리 권한 있는 사용자가 수정할 수 있습니다.
유형
object
Expand
속성유형설명

lendablePercent

integer

lendablePercent 는 다른 우선 순위 수준에서 빌릴 수 있는 수준의 NominalCL의 일부를 규정합니다. 이 필드의 값은 0에서 100 사이여야 하며 기본값은 0입니다. 이 수준의 LendableConcurrencyLimit (LendableConcurrencyLimit)으로 알려진 이 수준에서 다른 수준이 빌릴 수 있는 자리 수는 다음과 같이 정의됩니다.

LendableCL(i) = round( NominalCL(i) * lendablePercent(i)/100.0 )

nominalConcurrencyShares

integer

nominalConcurrencyShares (NCS)는 이 수준의 NominalConcurrencyLimit (NominalConcurrencyLimit) 계산에 기여합니다. 이는 이 우선 순위 수준에 대해 임시로 예약된 실행소 수입니다. 이는 이 우선 순위 수준에서의 디스패치를 제한하지는 않지만 차용 메커니즘을 통해 다른 우선 순위 수준에 영향을 미칩니다. 서버의 동시성 제한(ServerCL)은 자신의 CryostatS 값에 비례하여 모든 우선순위 레벨로 나뉩니다.

NominalCL(i) = ceil( ServerCL * NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)

숫자가 클수록 다른 모든 우선 순위 수준을 희생하여 더 큰 nominal concurrency 제한을 의미합니다. 이 필드의 기본값은 0입니다.

7.1.3. .spec.limited

설명
LimitedPriorityLevelConfiguration은 제한에 따라 요청을 처리하는 방법을 지정합니다. 두 가지 문제를 해결했습니다. - 이 우선 순위 수준에 대한 요청은 어떻게 제한됩니까? - 제한을 초과하는 요청으로 어떻게 해야 합니까?
유형
object
Expand
속성유형설명

borrowingLimitPercent

integer

borrowingLimitPercent 가 있는 경우, 이 우선순위 수준이 다른 우선 순위 수준에서 빌릴 수 있는 이 우선순위 등급의 수에 대한 제한을 구성합니다. 제한은 이 수준의 BorrowingConcurrencyLimit (BorrowingConcurrencyLimit)이라고 하며, 이 수준이 언제든지 빌릴 수 있는 총 seat 수에 대한 제한입니다. 이 필드에는 수준의 nominal 동시성 제한에 대한 해당 제한 비율이 있습니다. 이 필드가 음수가 아닌 경우 음수가 아닌 정수를 유지해야 하며 제한은 다음과 같이 계산됩니다.

BorrowingCL(i) = round( NominalCL(i) * borrowingLimitPercent(i)/100.0 )

이 필드의 값은 100을 초과할 수 있습니다. 즉, 이 우선순위 수준이 자체 nominal concurrency limit(NominalCL)보다 큰 여러 개의 seat을 빌릴 수 있습니다. 이 필드가 nil 을 남겨 두면 제한이 효과적으로 무한합니다.

lendablePercent

integer

lendablePercent 는 다른 우선 순위 수준에서 빌릴 수 있는 수준의 NominalCL의 일부를 규정합니다. 이 필드의 값은 0에서 100 사이여야 하며 기본값은 0입니다. 이 수준의 LendableConcurrencyLimit (LendableConcurrencyLimit)으로 알려진 이 수준에서 다른 수준이 빌릴 수 있는 자리 수는 다음과 같이 정의됩니다.

LendableCL(i) = round( NominalCL(i) * lendablePercent(i)/100.0 )

limitResponse

object

LimitResponse는 현재 실행할 수 없는 요청을 처리하는 방법을 정의합니다.

nominalConcurrencyShares

integer

nominalConcurrencyShares (NCS)는 이 수준의 NominalConcurrencyLimit (NominalConcurrencyLimit) 계산에 기여합니다. 이 우선 순위 수준에서 사용할 수 있는 실행소의 수입니다. 이는 이 우선순위 수준에서 디스패치된 요청과 다른 우선 순위의 차용지에서 디스패치된 요청에도 사용됩니다. 서버의 동시성 제한(ServerCL)은 자신의 CryostatS 값에 비례하여 제한적인 우선 순위 수준으로 나뉩니다.

NominalCL(i) = ceil( ServerCL * NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)

숫자가 클수록 다른 모든 우선 순위 수준을 희생하여 더 큰 nominal concurrency 제한을 의미합니다. 이 필드의 기본값은 30입니다.

7.1.4. .spec.limited.limitResponse

설명
LimitResponse는 현재 실행할 수 없는 요청을 처리하는 방법을 정의합니다.
유형
object
필수 항목
  • type
Expand
속성유형설명

Queuing

object

QueuingConfiguration에는 큐링을 위한 구성 매개변수가 포함되어 있습니다.

type

string

type 은 "Queue" 또는 "Reject"입니다. "queue"는 도착 시 실행할 수 없는 요청이 실행되거나 큐잉 제한에 도달할 때까지 큐에 보관됩니다. "거부"는 도착 시 실행할 수 없는 요청이 거부됩니다. 필수 항목입니다.

7.1.5. .spec.limited.limitResponse.queuing

설명
QueuingConfiguration에는 큐링을 위한 구성 매개변수가 포함되어 있습니다.
유형
object
Expand
속성유형설명

handSize

integer

handSize 는 요청을 큐로 분할하는 작은 양의 숫자입니다. 이 우선 순위 수준에서 요청을 큐에 추가할 때 요청의 흐름 식별자(문자열 쌍)가 해시되고 해시 값은 대기열 목록을 축소하고 여기에 지정된 크기의 핸드를 처리하는 데 사용됩니다. 요청은 가장 짧은 대기열 중 하나에 배치됩니다. handSize대기열 보다 커야 하며, 몇 개의 과도한 흐름이 대부분의 큐를 포화하지 않도록 해야 합니다. 이 필드 설정에 대한 보다 광범위한 지침은 사용자용 설명서를 참조하십시오. 이 필드의 기본값은 8입니다.

queueLengthLimit

integer

queueLengthLimit 은 한 번에 이 우선순위 수준의 지정된 큐에서 대기할 수 있는 최대 요청 수입니다. 이 값은 양수여야 합니다. 지정하지 않으면 기본값은 50입니다.

대기열

integer

는 이 우선 순위 수준의 대기열 수입니다. 큐는 각 apiserver마다 독립적으로 존재합니다. 값은 양수여야 합니다. 이를 1로 효과적으로 설정하면 shufflesharding이 방지되므로 관련 흐름 스키마의 고유 방법이 중요하지 않습니다. 이 필드의 기본값은 64입니다.

7.1.6. .status

설명
PriorityLevelConfigurationStatus는 "request-priority"의 현재 상태를 나타냅니다.
유형
object
Expand
속성유형설명

conditions

array

conditions 는 "request-priority"의 현재 상태입니다.

conditions[]

object

PriorityLevelConfigurationCondition은 우선순위 수준의 조건을 정의합니다.

7.1.7. .status.conditions

설명
conditions 는 "request-priority"의 현재 상태입니다.
유형
array

7.1.8. .status.conditions[]

설명
PriorityLevelConfigurationCondition은 우선순위 수준의 조건을 정의합니다.
유형
object
Expand
속성유형설명

lastTransitionTime

시간

lastTransitionTime 은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다.

message

string

message 는 마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.

reason

string

이유는 조건의 마지막 전환에 대한 고유한 한 단어, CamelCase 이유입니다.

status

string

Status 는 조건의 상태입니다. True, False, 알 수 없음 필수 항목입니다.

type

string

type 은 조건의 유형입니다. 필수 항목입니다.

7.2. API 끝점

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

  • /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations

    • DELETE: PriorityLevelConfiguration의 컬렉션 삭제
    • GET: PriorityLevelConfiguration 유형의 오브젝트 목록 또는 감시
    • POST: PriorityLevelConfiguration 생성
  • /apis/flowcontrol.apiserver.k8s.io/v1beta3/watch/prioritylevelconfigurations

    • GET: PriorityLevelConfiguration 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}

    • DELETE: PriorityLevelConfiguration 삭제
    • GET: 지정된 PriorityLevelConfiguration을 읽습니다.
    • PATCH: 지정된 PriorityLevelConfiguration을 부분적으로 업데이트
    • PUT: 지정된 PriorityLevelConfiguration을 교체합니다.
  • /apis/flowcontrol.apiserver.k8s.io/v1beta3/watch/prioritylevelconfigurations/{name}

    • GET: kind PriorityLevelConfiguration. deprecated 오브젝트의 변경 사항을 감시합니다. 더 이상 사용되지 않는 'watch' 매개변수를 대신 목록 작업과 함께 사용하여 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링됩니다.
  • /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}/status

    • GET: 지정된 PriorityLevelConfiguration의 읽기 상태
    • PATCH: 지정된 PriorityLevelConfiguration의 부분 업데이트 상태
    • PUT: 지정된 PriorityLevelConfiguration의 상태 교체

7.2.1. /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations

HTTP 방법
DELETE
설명
PriorityLevelConfiguration 컬렉션 삭제
Expand
표 7.1. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

Expand
표 7.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
PriorityLevelConfiguration 유형의 오브젝트 나열 또는 감시
Expand
표 7.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PriorityLevelConfigurationList 스키마

401 - 무단

HTTP 방법
POST
설명
PriorityLevelConfiguration 생성
Expand
표 7.4. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 7.5. 본문 매개변수
매개변수유형설명

body

PriorityLevelConfiguration 스키마

 
Expand
표 7.6. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PriorityLevelConfiguration 스키마

201 - 생성됨

PriorityLevelConfiguration 스키마

202 - 승인됨

PriorityLevelConfiguration 스키마

401 - 무단

7.2.2. /apis/flowcontrol.apiserver.k8s.io/v1beta3/watch/prioritylevelconfigurations

HTTP 방법
GET
설명
PriorityLevelConfiguration. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
Expand
표 7.7. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

7.2.3. /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}

Expand
표 7.8. 글로벌 경로 매개변수
매개변수유형설명

name

string

PriorityLevelConfiguration의 이름

HTTP 방법
DELETE
설명
PriorityLevelConfiguration 삭제
Expand
표 7.9. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

Expand
표 7.10. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 PriorityLevelConfiguration 읽기
Expand
표 7.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PriorityLevelConfiguration 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 PriorityLevelConfiguration을 부분적으로 업데이트
Expand
표 7.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 7.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PriorityLevelConfiguration 스키마

201 - 생성됨

PriorityLevelConfiguration 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 PriorityLevelConfiguration을 교체
Expand
표 7.14. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 7.15. 본문 매개변수
매개변수유형설명

body

PriorityLevelConfiguration 스키마

 
Expand
표 7.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PriorityLevelConfiguration 스키마

201 - 생성됨

PriorityLevelConfiguration 스키마

401 - 무단

7.2.4. /apis/flowcontrol.apiserver.k8s.io/v1beta3/watch/prioritylevelconfigurations/{name}

Expand
표 7.17. 글로벌 경로 매개변수
매개변수유형설명

name

string

PriorityLevelConfiguration의 이름

HTTP 방법
GET
설명
kind PriorityLevelConfiguration. deprecated 오브젝트의 변경 사항을 확인합니다. 대신 목록 작업과 함께 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링된 'watch' 매개변수를 사용합니다.
Expand
표 7.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

7.2.5. /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}/status

Expand
표 7.19. 글로벌 경로 매개변수
매개변수유형설명

name

string

PriorityLevelConfiguration의 이름

HTTP 방법
GET
설명
지정된 PriorityLevelConfiguration의 읽기 상태
Expand
표 7.20. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PriorityLevelConfiguration 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 PriorityLevelConfiguration의 부분적으로 업데이트 상태
Expand
표 7.21. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 7.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PriorityLevelConfiguration 스키마

201 - 생성됨

PriorityLevelConfiguration 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 PriorityLevelConfiguration의 상태 교체
Expand
표 7.23. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 7.24. 본문 매개변수
매개변수유형설명

body

PriorityLevelConfiguration 스키마

 
Expand
표 7.25. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PriorityLevelConfiguration 스키마

201 - 생성됨

PriorityLevelConfiguration 스키마

401 - 무단

8장. ResourceQuota [v1]

설명
ResourceQuota는 네임스페이스별로 적용되는 집계 할당량 제한 사항 설정
유형
object

8.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

ResourceQuotaSpec은 할당량을 적용하는 데 필요한 하드 제한을 정의합니다.

status

object

ResourceQuotaStatus는 적용된 하드 제한과 사용을 확인합니다.

8.1.1. .spec

설명
ResourceQuotaSpec은 할당량을 적용하는 데 필요한 하드 제한을 정의합니다.
유형
object
Expand
속성유형설명

hard

오브젝트(Quantity)

hard는 이름이 지정된 각 리소스에 대해 원하는 하드 제한 세트입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/policy/resource-quotas/

scopeSelector

object

범위 선택기는 scoped-resource 선택기 요구 사항으로 표시되는 선택기의 AND를 나타냅니다.

범위

배열(문자열)

할당량으로 추적되는 각 오브젝트와 일치해야 하는 필터 컬렉션입니다. 지정하지 않으면 할당량이 모든 오브젝트와 일치합니다.

8.1.2. .spec.scopeSelector

설명
범위 선택기는 scoped-resource 선택기 요구 사항으로 표시되는 선택기의 AND를 나타냅니다.
유형
object
Expand
속성유형설명

matchExpressions

array

리소스 범위에 따른 범위 선택기 요구 사항 목록입니다.

matchExpressions[]

object

scoped-resource selector 요구 사항은 범위 이름 및 값과 관련된 값, 범위 이름 및 연산자를 포함하는 선택기입니다.

8.1.3. .spec.scopeSelector.matchExpressions

설명
리소스 범위에 따른 범위 선택기 요구 사항 목록입니다.
유형
array

8.1.4. .spec.scopeSelector.matchExpressions[]

설명
scoped-resource selector 요구 사항은 범위 이름 및 값과 관련된 값, 범위 이름 및 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • scopeName
  • operator
Expand
속성유형설명

operator

string

값 집합에 대한 범위 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다.

가능한 열거 값: - "DoesNotExist" - "Exists" - "In" - "NotIn"

scopeName

string

선택기가 적용되는 범위의 이름입니다.

가능한 enum 값: - "BestEffort" 서비스의 최적의 품질을 가진 모든 Pod 오브젝트 - "CrossNamespacePodAffinity" 가 언급된 교차 네임스페이스 Pod(유사성)affinity가 있는 모든 Pod 오브젝트와 일치합니다. - "NotBestEffort" 는 최적이 없는 모든 Pod 오브젝트와 일치합니다. 서비스 품질 - "NotTerminating" spec.activeDeadlineSeconds가 nil - "PriorityClass" 인 모든 Pod 오브젝트와 우선순위 클래스가 "Terminating" 인 모든 Pod 오브젝트와 spec.activeDeadlineSeconds >=0인 모든 Pod 오브젝트와 일치합니다.

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

8.1.5. .status

설명
ResourceQuotaStatus는 적용된 하드 제한과 사용을 확인합니다.
유형
object
Expand
속성유형설명

hard

오브젝트(Quantity)

hard는 이름이 지정된 각 리소스에 대해 강제 적용된 하드 제한 세트입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/policy/resource-quotas/

사용됨

오브젝트(Quantity)

이는 네임스페이스에서 리소스를 현재 관찰하는 총 사용량입니다.

8.2. API 끝점

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

  • /api/v1/resourcequotas

    • GET: ResourceQuota 유형의 오브젝트 목록 또는 감시
  • /api/v1/watch/resourcequotas

    • GET: ResourceQuota 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /api/v1/namespaces/{namespace}/resourcequotas

    • DELETE: ResourceQuota의 컬렉션 삭제
    • GET: ResourceQuota 유형의 오브젝트 목록 또는 감시
    • POST: ResourceQuota 생성
  • /api/v1/watch/namespaces/{namespace}/resourcequotas

    • GET: ResourceQuota 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /api/v1/namespaces/{namespace}/resourcequotas/{name}

    • DELETE: ResourceQuota 삭제
    • GET: 지정된 ResourceQuota 읽기
    • PATCH: 지정된 ResourceQuota를 부분적으로 업데이트
    • PUT: 지정된 ResourceQuota를 교체
  • /api/v1/watch/namespaces/{namespace}/resourcequotas/{name}

    • GET: kind ResourceQuota. deprecated 오브젝트의 변경 사항을 조사합니다. 대신 목록 작업과 함께 'watch' 매개 변수를 사용하고 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
  • /api/v1/namespaces/{namespace}/resourcequotas/{name}/status

    • GET: 지정된 ResourceQuota의 읽기 상태
    • PATCH: 지정된 ResourceQuota의 부분적으로 업데이트
    • PUT: 지정된 ResourceQuota의 상태

8.2.1. /api/v1/resourcequotas

HTTP 방법
GET
설명
ResourceQuota 유형의 오브젝트 나열 또는 감시
Expand
표 8.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ResourceQuotaList 스키마

401 - 무단

8.2.2. /api/v1/watch/resourcequotas

HTTP 방법
GET
설명
ResourceQuota 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
Expand
표 8.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

8.2.3. /api/v1/namespaces/{namespace}/resourcequotas

HTTP 방법
DELETE
설명
ResourceQuota의 컬렉션 삭제
Expand
표 8.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

Expand
표 8.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ResourceQuota 유형의 오브젝트 나열 또는 감시
Expand
표 8.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ResourceQuotaList 스키마

401 - 무단

HTTP 방법
POST
설명
ResourceQuota 생성
Expand
표 8.6. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 8.7. 본문 매개변수
매개변수유형설명

body

ResourceQuota 스키마

 
Expand
표 8.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ResourceQuota 스키마

201 - 생성됨

ResourceQuota 스키마

202 - 승인됨

ResourceQuota 스키마

401 - 무단

8.2.4. /api/v1/watch/namespaces/{namespace}/resourcequotas

HTTP 방법
GET
설명
ResourceQuota 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
Expand
표 8.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

8.2.5. /api/v1/namespaces/{namespace}/resourcequotas/{name}

Expand
표 8.10. 글로벌 경로 매개변수
매개변수유형설명

name

string

ResourceQuota의 이름

HTTP 방법
DELETE
설명
ResourceQuota 삭제
Expand
표 8.11. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

Expand
표 8.12. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ResourceQuota 스키마

202 - 승인됨

ResourceQuota 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ResourceQuota 읽기
Expand
표 8.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ResourceQuota 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ResourceQuota를 부분적으로 업데이트
Expand
표 8.14. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 8.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ResourceQuota 스키마

201 - 생성됨

ResourceQuota 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ResourceQuota를 교체
Expand
표 8.16. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 8.17. 본문 매개변수
매개변수유형설명

body

ResourceQuota 스키마

 
Expand
표 8.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ResourceQuota 스키마

201 - 생성됨

ResourceQuota 스키마

401 - 무단

8.2.6. /api/v1/watch/namespaces/{namespace}/resourcequotas/{name}

Expand
표 8.19. 글로벌 경로 매개변수
매개변수유형설명

name

string

ResourceQuota의 이름

HTTP 방법
GET
설명
리소스 할당량 유형의 오브젝트를 감시합니다. 더 이상 사용되지 않는 오브젝트를 확인합니다. 대신 목록 작업과 함께 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 'watch' 매개변수를 사용합니다.
Expand
표 8.20. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

8.2.7. /api/v1/namespaces/{namespace}/resourcequotas/{name}/status

Expand
표 8.21. 글로벌 경로 매개변수
매개변수유형설명

name

string

ResourceQuota의 이름

HTTP 방법
GET
설명
지정된 ResourceQuota의 읽기 상태
Expand
표 8.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ResourceQuota 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ResourceQuota의 부분적으로 업데이트 상태
Expand
표 8.23. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 8.24. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ResourceQuota 스키마

201 - 생성됨

ResourceQuota 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ResourceQuota의 상태 교체
Expand
표 8.25. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 8.26. 본문 매개변수
매개변수유형설명

body

ResourceQuota 스키마

 
Expand
표 8.27. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ResourceQuota 스키마

201 - 생성됨

ResourceQuota 스키마

401 - 무단

Legal Notice

Copyright © 2025 Red Hat

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.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

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

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat