일정 및 할당량 API


OpenShift Container Platform 4.12

일정 및 할당량 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/v1beta1]

설명
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/v1beta1]

설명
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

 

spec

object

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

status

object

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

2.1.1. .spec

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

quota

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

Expand
표 2.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

AppliedClusterResourceQuotaList schema

401 - 무단

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

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

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

Expand
표 2.4. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

AppliedClusterResourceQuotaList schema

401 - 무단

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

name

string

AppliedClusterResourceQuota의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

Expand
표 2.7. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 AppliedClusterResourceQuota 읽기
Expand
표 2.8. 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
필수 항목
  • quota
  • 선택기
Expand
속성유형설명

quota

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

Expand
표 3.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ClusterResourceQuota 유형의 오브젝트 나열
Expand
표 3.4. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

ClusterResourceQuotaList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

ClusterResourceQuota schema

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

200 - OK

ClusterResourceQuota schema

201 - 생성됨

ClusterResourceQuota schema

202 - 승인됨

ClusterResourceQuota schema

401 - 무단

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

Expand
표 3.9. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

name

string

ClusterResourceQuota의 이름

Expand
표 3.12. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

dryRun

string

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

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ClusterResourceQuota 읽기
Expand
표 3.16. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

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

200 - OK

ClusterResourceQuota schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

ClusterResourceQuota schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

ClusterResourceQuota schema

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

200 - OK

ClusterResourceQuota schema

201 - 생성됨

ClusterResourceQuota schema

401 - 무단

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

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

name

string

ClusterResourceQuota의 이름

Expand
표 3.25. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

name

string

ClusterResourceQuota의 이름

Expand
표 3.28. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 ClusterResourceQuota의 상태 읽기
Expand
표 3.29. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

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

200 - OK

ClusterResourceQuota schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

ClusterResourceQuota schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

ClusterResourceQuota schema

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

200 - OK

ClusterResourceQuota schema

201 - 생성됨

ClusterResourceQuota schema

401 - 무단

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

설명
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
속성유형설명

nonResourceRules

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/v1beta1/flowschemas

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

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

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

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

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

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

Expand
표 4.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

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

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
FlowSchema 유형의 개체 목록 또는 감시
Expand
표 4.5. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

FlowSchemaList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

FlowSchema schema

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

200 - OK

FlowSchema schema

201 - 생성됨

FlowSchema schema

202 - 승인됨

FlowSchema schema

401 - 무단

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

Expand
표 4.10. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

name

string

FlowSchema의 이름

Expand
표 4.13. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

dryRun

string

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

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

FlowSchema schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

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

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

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

body

패치 스키마

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

200 - OK

FlowSchema schema

201 - 생성됨

FlowSchema schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

FlowSchema schema

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

200 - OK

FlowSchema schema

201 - 생성됨

FlowSchema schema

401 - 무단

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

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

name

string

FlowSchema의 이름

Expand
표 4.25. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

name

string

FlowSchema의 이름

Expand
표 4.28. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

200 - OK

FlowSchema schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

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

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

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

body

패치 스키마

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

200 - OK

FlowSchema schema

201 - 생성됨

FlowSchema schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

FlowSchema schema

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

200 - OK

FlowSchema schema

201 - 생성됨

FlowSchema schema

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를 나타냅니다.

오브젝트(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

Expand
표 5.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

LimitRangeList schema

401 - 무단

5.2.2. /api/v1/watch/limitranges

Expand
표 5.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

Expand
표 5.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

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

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
LimitRange 유형의 오브젝트 나열 또는 감시
Expand
표 5.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

LimitRangeList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

LimitRange schema

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

200 - OK

LimitRange schema

201 - 생성됨

LimitRange schema

202 - 승인됨

LimitRange schema

401 - 무단

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

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

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

Expand
표 5.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

name

string

LimitRange의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

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

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

dryRun

string

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

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

LimitRange schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

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

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

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

body

패치 스키마

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

200 - OK

LimitRange schema

201 - 생성됨

LimitRange schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

LimitRange schema

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

200 - OK

LimitRange schema

201 - 생성됨

LimitRange schema

401 - 무단

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

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

name

string

LimitRange의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

Expand
표 5.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
다음과 같은 LimitRange 오브젝트를 확인합니다. 더 이상 사용되지 않는 오브젝트를 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
Expand
표 5.32. 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입니다.

value

integer

이 우선순위 클래스의 값입니다. 이는 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

Expand
표 6.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

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

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
PriorityClass 유형의 오브젝트 나열 또는 감시
Expand
표 6.5. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

PriorityClassList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

Priorityclass 스키마

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

200 - OK

Priorityclass 스키마

201 - 생성됨

Priorityclass 스키마

202 - 승인됨

Priorityclass 스키마

401 - 무단

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

Expand
표 6.10. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

name

string

PriorityClass의 이름

Expand
표 6.13. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

dryRun

string

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

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

Priorityclass 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

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

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

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

body

패치 스키마

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

200 - OK

Priorityclass 스키마

201 - 생성됨

Priorityclass 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

Priorityclass 스키마

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

200 - OK

Priorityclass 스키마

201 - 생성됨

Priorityclass 스키마

401 - 무단

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

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

name

string

PriorityClass의 이름

Expand
표 6.25. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

설명
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

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

type

string

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

7.1.2. .spec.limited

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

assuredConcurrencyShares

integer

GuaranteeConcurrencyShares (ACS)는 지정된 시간에 시행할 수 있는 이 우선 순위 수준의 요청 수에 대한 제한인 실행 제한을 구성합니다. ACS는 양수여야 합니다. 서버의 동시성 제한(SCL)은 보장된 동시성 공유에 비례하여 동시성 제어 우선 순위 수준으로 나뉩니다. 이렇게 하면 신뢰할 수 있는 동시성 값(ACV)이 생성됩니다. --- 이러한 우선 순위 수준에 대해 한 번에 실행될 수 있는 요청 수입니다.

ACV(l) = ceil(SCL * ACS(l) / ( 합계[priority level k] ACS(k) )

더 많은 수의 ACS는 더 많은 예약 동시 요청(다른 모든 PL을 희생함)을 의미합니다. 이 필드의 기본값은 30입니다.

limitResponse

object

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

7.1.3. .spec.limited.limitResponse

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

Queuing

object

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

type

string

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

7.1.4. .spec.limited.limitResponse.queuing

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

handSize

integer

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

queueLengthLimit

integer

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

대기열

integer

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

7.1.5. .status

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

conditions

array

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

conditions[]

object

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

7.1.6. .status.conditions

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

7.1.7. .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/v1beta1/prioritylevelconfigurations

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

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

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

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

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

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

Expand
표 7.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

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

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
PriorityLevelConfiguration 유형의 오브젝트 나열 또는 감시
Expand
표 7.5. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

PriorityLevelConfigurationList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

PriorityLevelConfiguration schema

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

200 - OK

PriorityLevelConfiguration schema

201 - 생성됨

PriorityLevelConfiguration schema

202 - 승인됨

PriorityLevelConfiguration schema

401 - 무단

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

Expand
표 7.10. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

name

string

PriorityLevelConfiguration의 이름

Expand
표 7.13. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

dryRun

string

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

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

PriorityLevelConfiguration schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

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

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

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

body

패치 스키마

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

200 - OK

PriorityLevelConfiguration schema

201 - 생성됨

PriorityLevelConfiguration schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

PriorityLevelConfiguration schema

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

200 - OK

PriorityLevelConfiguration schema

201 - 생성됨

PriorityLevelConfiguration schema

401 - 무단

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

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

name

string

PriorityLevelConfiguration의 이름

Expand
표 7.25. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

name

string

PriorityLevelConfiguration의 이름

Expand
표 7.28. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

200 - OK

PriorityLevelConfiguration schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

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

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

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

body

패치 스키마

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

200 - OK

PriorityLevelConfiguration schema

201 - 생성됨

PriorityLevelConfiguration schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

PriorityLevelConfiguration schema

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

200 - OK

PriorityLevelConfiguration schema

201 - 생성됨

PriorityLevelConfiguration schema

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

Expand
표 8.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

ResourceQuotaList 스키마

401 - 무단

8.2.2. /api/v1/watch/resourcequotas

Expand
표 8.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

Expand
표 8.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

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

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ResourceQuota 유형의 오브젝트 나열 또는 감시
Expand
표 8.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

ResourceQuotaList 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

ResourceQuota schema

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

200 - OK

ResourceQuota schema

201 - 생성됨

ResourceQuota schema

202 - 승인됨

ResourceQuota schema

401 - 무단

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

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

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

Expand
표 8.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

name

string

ResourceQuota의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

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

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

dryRun

string

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

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

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

body

DeleteOptions 스키마

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

200 - OK

ResourceQuota schema

202 - 승인됨

ResourceQuota schema

401 - 무단

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

200 - OK

ResourceQuota schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

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

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

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

body

패치 스키마

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

200 - OK

ResourceQuota schema

201 - 생성됨

ResourceQuota schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

ResourceQuota schema

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

200 - OK

ResourceQuota schema

201 - 생성됨

ResourceQuota schema

401 - 무단

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

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

name

string

ResourceQuota의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

Expand
표 8.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

name

string

ResourceQuota의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

Expand
표 8.34. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

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

200 - OK

ResourceQuota schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

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

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

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

body

패치 스키마

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

200 - OK

ResourceQuota schema

201 - 생성됨

ResourceQuota schema

401 - 무단

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

dryRun

string

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

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

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

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

body

ResourceQuota schema

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

200 - OK

ResourceQuota schema

201 - 생성됨

ResourceQuota schema

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