autoscale API


OpenShift Container Platform 4.14

autoscale API에 대한 참조 가이드

Red Hat OpenShift Documentation Team

초록

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

1장. autoscale API

1.1. ClusterAutoscaler [autoscaling.openshift.io/v1]

설명
ClusterAutoscaler는 clusterautoscalers API의 스키마입니다.
유형
object

1.2. MachineAutoscaler [autoscaling.openshift.io/v1beta1]

설명
MachineAutoscaler는 machineautoscalers API의 스키마입니다.
유형
object

1.3. HorizontalPodAutoscaler [autoscaling/v2]

설명
HorizontalPodAutoscaler는 지정된 메트릭을 기반으로 scale 하위 리소스를 구현하는 모든 리소스의 복제본 수를 자동으로 관리하는 수평 Pod 자동 스케일러의 구성입니다.
유형
object

1.4. 확장 [autoscaling/v1]

설명
scale은 리소스에 대한 확장 요청을 나타냅니다.
유형
object

2장. ClusterAutoscaler [autoscaling.openshift.io/v1]

설명
ClusterAutoscaler는 clusterautoscalers API의 스키마입니다.
유형
object

2.1. 사양

속성유형설명

apiVersion

string

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

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

원하는 ClusterAutoscaler 리소스 상태

status

object

가장 최근에 관찰된 ClusterAutoscaler 리소스의 상태

2.1.1. .spec

설명
원하는 ClusterAutoscaler 리소스 상태
유형
object
속성유형설명

balanceSimilarNodeGroups

boolean

balanceSimilarNodeGroups는 --balance-similar-node-groups cluster-autoscaler 기능을 활성화/비활성화합니다. 이 기능은 동일한 인스턴스 유형 및 동일한 레이블 세트를 사용하여 노드 그룹을 자동으로 식별하고 해당 노드 그룹의 각 크기를 균형 있게 유지합니다.

balancingIgnoredLabels

배열(문자열)

나열된 각 라벨에 대해 cluster-autoscaler에 "--balancing-ignore-label <label name>" 플래그를 설정합니다. 이 옵션은 노드 그룹 유사성을 고려할 때 클러스터 자동 스케일러가 무시해야 하는 레이블을 지정합니다. 예를 들어 "topology.csi.aws.com/zone" 라벨이 있는 노드가 있는 경우 클러스터 자동 스케일러가 해당 값을 기반으로 노드를 다른 노드 그룹으로 분할하지 못하도록 이 레이블의 이름을 추가할 수 있습니다.

ignoreDaemonsetsUtilization

boolean

--ignore-daemonsets-utilization CA 기능 플래그를 활성화/사용할 수 있습니다. 축소에 대한 리소스 사용률을 계산할 때 CA가 DaemonSet Pod를 무시해야 합니다. 기본적으로 false

logVerbosity

integer

자동 스케일러 로그 수준을 설정합니다. 기본값은 1이며 DEBUGGING에는 수준 4가 권장되며 레벨 6은 거의 모든 것을 활성화합니다. 이 옵션은 CLUSTER_AUTOSCALER_VERBOSITY 환경 변수로 설정된 로그 수준보다 우선합니다.

maxNodeProvisionTime

string

노드가 프로비저닝될 때까지 CA가 대기하는 최대 시간

maxPodGracePeriod

integer

축소 전 Pod의 정상 종료 시간 제공

podPriorityThreshold

integer

사용자가 클러스터 자동 스케일러 작업을 트리거하지 않아야 하는 "best-effort" Pod를 예약할 수 있도록 허용하려면 사용 가능한 예비 리소스가 있을 때만 실행됩니다. 자세한 정보는 https://github.com/kubernetes/autoscaler/blob/master/cluster-autoscaler/FAQ.md#how-does-cluster-autoscaler-work-with-pod-priority-and-preemption

resourceLimits

object

자동 스케일링 리소스 제약 조건

scaleDown

object

축소 작업 구성

skipNodesWithLocalStorage

boolean

--skip-nodes-with-local-storage CA 기능 플래그를 활성화/사용할 수 있습니다. true 클러스터 자동 스케일러가 로컬 스토리지가 있는 Pod가 있는 노드를 삭제하지 않는 경우(예: 자동 스케일러에서 기본적으로 EmptyDir 또는 HostPath. true)

2.1.2. .spec.resourceLimits

설명
자동 스케일링 리소스 제약 조건
유형
object
속성유형설명

코어

object

<min>:<max> 형식의 최소 및 최대 코어 수입니다. 클러스터 자동 스케일러는 이러한 수를 초과하여 클러스터를 확장하지 않습니다.

gpus

array

클러스터의 최소 및 최대 GPU 수 :<min>:<max> 형식으로 {p> 되어 있습니다. 클러스터 자동 스케일러는 이러한 수를 초과하여 클러스터를 확장하지 않습니다. 여러 번 전달할 수 있습니다.

gpus[]

object

 

maxNodesTotal

integer

모든 노드 그룹의 최대 노드 수입니다. 클러스터 자동 스케일러는 이 수를 초과하여 클러스터를 늘리지 않습니다.

메모리

object

클러스터의 최소 및 최대 메모리 수 <min>:<max> 형식으로 되어 있습니다. 클러스터 자동 스케일러는 이러한 수를 초과하여 클러스터를 확장하지 않습니다.

2.1.3. .spec.resourceLimits.cores

설명
<min>:<max> 형식의 최소 및 최대 코어 수입니다. 클러스터 자동 스케일러는 이러한 수를 초과하여 클러스터를 확장하지 않습니다.
유형
object
필수 항목
  • Max
  • min
속성유형설명

Max

integer

 

min

integer

 

2.1.4. .spec.resourceLimits.gpus

설명
클러스터의 최소 및 최대 GPU 수 :<min>:<max> 형식으로 {p> 되어 있습니다. 클러스터 자동 스케일러는 이러한 수를 초과하여 클러스터를 확장하지 않습니다. 여러 번 전달할 수 있습니다.
유형
array

2.1.5. .spec.resourceLimits.gpus[]

설명
유형
object
필수 항목
  • Max
  • min
  • type
속성유형설명

Max

integer

 

min

integer

 

type

string

최소 및 최대 제한과 연결할 GPU 유형입니다. 이 값은 클러스터 자동 스케일러가 Node 오브젝트에서 레이블 값으로 검색하여 GPU 용량이 있을 노드를 식별하는 데 사용됩니다. 예를 들어 유형 필드와 동일한 레이블 값이 있는 키 cluster-api/accelerator 레이블을 전송하는 노드는 클러스터 자동 스케일러의 리소스 제한으로 계산됩니다.

2.1.6. .spec.resourceLimits.memory

설명
클러스터의 최소 및 최대 메모리 수 <min>:<max> 형식으로 되어 있습니다. 클러스터 자동 스케일러는 이러한 수를 초과하여 클러스터를 확장하지 않습니다.
유형
object
필수 항목
  • Max
  • min
속성유형설명

Max

integer

 

min

integer

 

2.1.7. .spec.scaleDown

설명
축소 작업 구성
유형
object
필수 항목
  • enabled
속성유형설명

delayAfterAdd

string

평가 축소를 축소한 후의 기간

delayAfterDelete

string

평가를 축소하는 노드 삭제 후의 시간, 기본값은 scan-interval

delayAfterFailure

string

평가를 축소하는 실패 후의 기간

enabled

boolean

CA에서 클러스터를 축소해야 합니다.

unneededTime

string

노드를 축소할 수 있기 전에 필요하지 않은 노드 수

utilizationThreshold

string

요청된 리소스 수를 용량으로 나눈 총으로 정의된 노드 사용률 수준, 아래 노드를 축소할 수 있음

2.1.8. .status

설명
가장 최근에 관찰된 ClusterAutoscaler 리소스의 상태
유형
object

2.2. API 끝점

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

  • /apis/autoscaling.openshift.io/v1/clusterautoscalers

    • DELETE: ClusterAutoscaler의 컬렉션 삭제
    • GET: ClusterAutoscaler의 오브젝트 나열
    • POST: ClusterAutoscaler 만들기
  • /apis/autoscaling.openshift.io/v1/clusterautoscalers/{name}

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

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

2.2.1. /apis/autoscaling.openshift.io/v1/clusterautoscalers

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

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

기본값이 설정되지 않음

sendInitialEvents

boolean

sendInitialEvents=truewatch=true 와 함께 설정할 수 있습니다. 이 경우 감시 스트림은 합성 이벤트로 시작하여 컬렉션에 있는 개체의 현재 상태를 생성합니다. 이러한 모든 이벤트가 전송되면 합성 " emailmark" 이벤트가 전송됩니다. 북마크는 오브젝트 세트에 해당하는 ResourceVersion(RV)을 보고하고 "k8s.io/initial-events-end": "true" 주석으로 표시됩니다. 이후 감시 스트림은 정상적으로 진행되어 모니터링되는 오브젝트에 변경(RV에 제출)에 해당하는 감시 이벤트를 보냅니다.

sendInitialEvents 옵션을 설정할 때 resourceVersionMatch 옵션도 설정해야 합니다. 감시 요청의 의미 체계는 다음과 같습니다. - resourceVersionMatch = NotOlderThan은 "제공된 resourceVersion'만큼 새로운 데이터로 해석되며 북마크 이벤트는 상태가 'resourceVersion에 동기화될 때 적어도 ListOptions에서 제공하는 것과 같이 새로운 것으로 전송됩니다. resourceVersion 이 설정되지 않은 경우, 이는 "consistent read"로 해석되고, 요청이 처리되기 시작할 때 상태가 최소한 현재와 동기화될 때 북마크 이벤트는 전송됩니다. - resourceVersionMatch 가 다른 값으로 설정되거나 설정되지 않은 오류를 반환합니다.

resourceVersion="" 또는 resourceVersion="0"( 이전의 호환성 이유로) 및 false인 경우 기본값은 true입니다.

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ClusterAutoscaler 유형의 오브젝트 나열
표 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

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

limit

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

기본값이 설정되지 않음

sendInitialEvents

boolean

sendInitialEvents=truewatch=true 와 함께 설정할 수 있습니다. 이 경우 감시 스트림은 합성 이벤트로 시작하여 컬렉션에 있는 개체의 현재 상태를 생성합니다. 이러한 모든 이벤트가 전송되면 합성 " emailmark" 이벤트가 전송됩니다. 북마크는 오브젝트 세트에 해당하는 ResourceVersion(RV)을 보고하고 "k8s.io/initial-events-end": "true" 주석으로 표시됩니다. 이후 감시 스트림은 정상적으로 진행되어 모니터링되는 오브젝트에 변경(RV에 제출)에 해당하는 감시 이벤트를 보냅니다.

sendInitialEvents 옵션을 설정할 때 resourceVersionMatch 옵션도 설정해야 합니다. 감시 요청의 의미 체계는 다음과 같습니다. - resourceVersionMatch = NotOlderThan은 "제공된 resourceVersion'만큼 새로운 데이터로 해석되며 북마크 이벤트는 상태가 'resourceVersion에 동기화될 때 적어도 ListOptions에서 제공하는 것과 같이 새로운 것으로 전송됩니다. resourceVersion 이 설정되지 않은 경우, 이는 "consistent read"로 해석되고, 요청이 처리되기 시작할 때 상태가 최소한 현재와 동기화될 때 북마크 이벤트는 전송됩니다. - resourceVersionMatch 가 다른 값으로 설정되거나 설정되지 않은 오류를 반환합니다.

resourceVersion="" 또는 resourceVersion="0"( 이전의 호환성 이유로) 및 false인 경우 기본값은 true입니다.

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

ClusterAutoscalerList 스키마

401 - 무단

HTTP 방법
POST
설명
ClusterAutoscaler 만들기
표 2.6. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ClusterAutoscaler 스키마

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

200 - OK

ClusterAutoscaler 스키마

201 - 생성됨

ClusterAutoscaler 스키마

202 - 승인됨

ClusterAutoscaler 스키마

401 - 무단

2.2.2. /apis/autoscaling.openshift.io/v1/clusterautoscalers/{name}

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

name

string

ClusterAutoscaler의 이름

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

string

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

HTTP 방법
DELETE
설명
ClusterAutoscaler 삭제
표 2.11. 쿼리 매개변수
매개변수유형설명

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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ClusterAutoscaler 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

force

boolean

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

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

body

패치 스키마

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

200 - OK

ClusterAutoscaler 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ClusterAutoscaler 교체
표 2.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ClusterAutoscaler 스키마

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

200 - OK

ClusterAutoscaler 스키마

201 - 생성됨

ClusterAutoscaler 스키마

401 - 무단

2.2.3. /apis/autoscaling.openshift.io/v1/clusterautoscalers/{name}/status

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

name

string

ClusterAutoscaler의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ClusterAutoscaler 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

force

boolean

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

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

body

패치 스키마

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

200 - OK

ClusterAutoscaler 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ClusterAutoscaler 스키마

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

200 - OK

ClusterAutoscaler 스키마

201 - 생성됨

ClusterAutoscaler 스키마

401 - 무단

3장. MachineAutoscaler [autoscaling.openshift.io/v1beta1]

설명
MachineAutoscaler는 machineautoscalers API의 스키마입니다.
유형
object

3.1. 사양

속성유형설명

apiVersion

string

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

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

확장 가능한 리소스의 제약 조건 사양

status

object

확장 가능한 리소스의 최근 관찰된 상태

3.1.1. .spec

설명
확장 가능한 리소스의 제약 조건 사양
유형
object
필수 항목
  • maxReplicas
  • minReplicas
  • scaleTargetRef
속성유형설명

maxReplicas

integer

maxReplicas는 확장 가능한 리소스의 최대 복제본 수를 제한합니다.

minReplicas

integer

minReplicas는 확장 가능한 리소스의 최소 복제본 수를 제한합니다.

scaleTargetRef

object

scaleTargetRef에는 확장 가능한 리소스에 대한 참조가 있습니다.

3.1.2. .spec.scaleTargetRef

설명
scaleTargetRef에는 확장 가능한 리소스에 대한 참조가 있습니다.
유형
object
필수 항목
  • kind
  • name
속성유형설명

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

name

string

name은 오브젝트의 이름을 지정합니다(예: worker-us-east-1a). 확장 가능 리소스는 단일 네임스페이스에 있어야 합니다.

3.1.3. .status

설명
확장 가능한 리소스의 최근 관찰된 상태
유형
object
속성유형설명

lastTargetRef

object

LastTargetRef에는 최근에 관찰된 확장 가능 리소스에 대한 참조가 있습니다.

3.1.4. .status.lastTargetRef

설명
LastTargetRef에는 최근에 관찰된 확장 가능 리소스에 대한 참조가 있습니다.
유형
object
필수 항목
  • kind
  • name
속성유형설명

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

name

string

name은 오브젝트의 이름을 지정합니다(예: worker-us-east-1a). 확장 가능 리소스는 단일 네임스페이스에 있어야 합니다.

3.2. API 끝점

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

  • /apis/autoscaling.openshift.io/v1beta1/machineautoscalers

    • GET: MachineAutoscaler 유형의 오브젝트 나열
  • /apis/autoscaling.openshift.io/v1beta1/namespaces/{namespace}/machineautoscalers

    • DELETE: MachineAutoscaler의 컬렉션 삭제
    • GET: MachineAutoscaler 유형의 오브젝트 나열
    • POST: MachineAutoscaler 생성
  • /apis/autoscaling.openshift.io/v1beta1/namespaces/{namespace}/machineautoscalers/{name}

    • DELETE: delete a MachineAutoscaler
    • GET: 지정된 MachineAutoscaler 읽기
    • PATCH: 지정된 MachineAutoscaler를 부분적으로 업데이트
    • PUT: 지정된 MachineAutoscaler를 교체
  • /apis/autoscaling.openshift.io/v1beta1/namespaces/{namespace}/machineautoscalers/{name}/status

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

3.2.1. /apis/autoscaling.openshift.io/v1beta1/machineautoscalers

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

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

기본값이 설정되지 않음

sendInitialEvents

boolean

sendInitialEvents=truewatch=true 와 함께 설정할 수 있습니다. 이 경우 감시 스트림은 합성 이벤트로 시작하여 컬렉션에 있는 개체의 현재 상태를 생성합니다. 이러한 모든 이벤트가 전송되면 합성 " emailmark" 이벤트가 전송됩니다. 북마크는 오브젝트 세트에 해당하는 ResourceVersion(RV)을 보고하고 "k8s.io/initial-events-end": "true" 주석으로 표시됩니다. 이후 감시 스트림은 정상적으로 진행되어 모니터링되는 오브젝트에 변경(RV에 제출)에 해당하는 감시 이벤트를 보냅니다.

sendInitialEvents 옵션을 설정할 때 resourceVersionMatch 옵션도 설정해야 합니다. 감시 요청의 의미 체계는 다음과 같습니다. - resourceVersionMatch = NotOlderThan은 "제공된 resourceVersion'만큼 새로운 데이터로 해석되며 북마크 이벤트는 상태가 'resourceVersion에 동기화될 때 적어도 ListOptions에서 제공하는 것과 같이 새로운 것으로 전송됩니다. resourceVersion 이 설정되지 않은 경우, 이는 "consistent read"로 해석되고, 요청이 처리되기 시작할 때 상태가 최소한 현재와 동기화될 때 북마크 이벤트는 전송됩니다. - resourceVersionMatch 가 다른 값으로 설정되거나 설정되지 않은 오류를 반환합니다.

resourceVersion="" 또는 resourceVersion="0"( 이전의 호환성 이유로) 및 false인 경우 기본값은 true입니다.

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

MachineAutoscalerList schema

401 - 무단

3.2.2. /apis/autoscaling.openshift.io/v1beta1/namespaces/{namespace}/machineautoscalers

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

네임스페이스

string

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

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

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

기본값이 설정되지 않음

sendInitialEvents

boolean

sendInitialEvents=truewatch=true 와 함께 설정할 수 있습니다. 이 경우 감시 스트림은 합성 이벤트로 시작하여 컬렉션에 있는 개체의 현재 상태를 생성합니다. 이러한 모든 이벤트가 전송되면 합성 " emailmark" 이벤트가 전송됩니다. 북마크는 오브젝트 세트에 해당하는 ResourceVersion(RV)을 보고하고 "k8s.io/initial-events-end": "true" 주석으로 표시됩니다. 이후 감시 스트림은 정상적으로 진행되어 모니터링되는 오브젝트에 변경(RV에 제출)에 해당하는 감시 이벤트를 보냅니다.

sendInitialEvents 옵션을 설정할 때 resourceVersionMatch 옵션도 설정해야 합니다. 감시 요청의 의미 체계는 다음과 같습니다. - resourceVersionMatch = NotOlderThan은 "제공된 resourceVersion'만큼 새로운 데이터로 해석되며 북마크 이벤트는 상태가 'resourceVersion에 동기화될 때 적어도 ListOptions에서 제공하는 것과 같이 새로운 것으로 전송됩니다. resourceVersion 이 설정되지 않은 경우, 이는 "consistent read"로 해석되고, 요청이 처리되기 시작할 때 상태가 최소한 현재와 동기화될 때 북마크 이벤트는 전송됩니다. - resourceVersionMatch 가 다른 값으로 설정되거나 설정되지 않은 오류를 반환합니다.

resourceVersion="" 또는 resourceVersion="0"( 이전의 호환성 이유로) 및 false인 경우 기본값은 true입니다.

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

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

기본값이 설정되지 않음

sendInitialEvents

boolean

sendInitialEvents=truewatch=true 와 함께 설정할 수 있습니다. 이 경우 감시 스트림은 합성 이벤트로 시작하여 컬렉션에 있는 개체의 현재 상태를 생성합니다. 이러한 모든 이벤트가 전송되면 합성 " emailmark" 이벤트가 전송됩니다. 북마크는 오브젝트 세트에 해당하는 ResourceVersion(RV)을 보고하고 "k8s.io/initial-events-end": "true" 주석으로 표시됩니다. 이후 감시 스트림은 정상적으로 진행되어 모니터링되는 오브젝트에 변경(RV에 제출)에 해당하는 감시 이벤트를 보냅니다.

sendInitialEvents 옵션을 설정할 때 resourceVersionMatch 옵션도 설정해야 합니다. 감시 요청의 의미 체계는 다음과 같습니다. - resourceVersionMatch = NotOlderThan은 "제공된 resourceVersion'만큼 새로운 데이터로 해석되며 북마크 이벤트는 상태가 'resourceVersion에 동기화될 때 적어도 ListOptions에서 제공하는 것과 같이 새로운 것으로 전송됩니다. resourceVersion 이 설정되지 않은 경우, 이는 "consistent read"로 해석되고, 요청이 처리되기 시작할 때 상태가 최소한 현재와 동기화될 때 북마크 이벤트는 전송됩니다. - resourceVersionMatch 가 다른 값으로 설정되거나 설정되지 않은 오류를 반환합니다.

resourceVersion="" 또는 resourceVersion="0"( 이전의 호환성 이유로) 및 false인 경우 기본값은 true입니다.

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

MachineAutoscalerList schema

401 - 무단

HTTP 방법
POST
설명
MachineAutoscaler 생성
표 3.9. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineAutoscaler 스키마

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

200 - OK

MachineAutoscaler 스키마

201 - 생성됨

MachineAutoscaler 스키마

202 - 승인됨

MachineAutoscaler 스키마

401 - 무단

3.2.3. /apis/autoscaling.openshift.io/v1beta1/namespaces/{namespace}/machineautoscalers/{name}

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

name

string

MachineAutoscaler의 이름

네임스페이스

string

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

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

string

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

HTTP 방법
DELETE
설명
delete a MachineAutoscaler
표 3.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

MachineAutoscaler 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

force

boolean

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

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

body

패치 스키마

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

200 - OK

MachineAutoscaler 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 MachineAutoscaler 교체
표 3.22. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineAutoscaler 스키마

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

200 - OK

MachineAutoscaler 스키마

201 - 생성됨

MachineAutoscaler 스키마

401 - 무단

3.2.4. /apis/autoscaling.openshift.io/v1beta1/namespaces/{namespace}/machineautoscalers/{name}/status

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

name

string

MachineAutoscaler의 이름

네임스페이스

string

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

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

MachineAutoscaler 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

force

boolean

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

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

body

패치 스키마

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

200 - OK

MachineAutoscaler 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineAutoscaler 스키마

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

200 - OK

MachineAutoscaler 스키마

201 - 생성됨

MachineAutoscaler 스키마

401 - 무단

4장. HorizontalPodAutoscaler [autoscaling/v2]

설명
HorizontalPodAutoscaler는 지정된 메트릭을 기반으로 scale 하위 리소스를 구현하는 모든 리소스의 복제본 수를 자동으로 관리하는 수평 Pod 자동 스케일러의 구성입니다.
유형
object

4.1. 사양

속성유형설명

apiVersion

string

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

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

메타데이터는 표준 오브젝트 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

HorizontalPodAutoscalerSpec은 HorizontalPodAutoscaler의 원하는 기능을 설명합니다.

status

object

HorizontalPodAutoscalerStatus는 수평 Pod 자동 스케일러의 현재 상태를 설명합니다.

4.1.1. .spec

설명
HorizontalPodAutoscalerSpec은 HorizontalPodAutoscaler의 원하는 기능을 설명합니다.
유형
object
필수 항목
  • scaleTargetRef
  • maxReplicas
속성유형설명

동작

object

HorizontalPodAutoscalerBehavior는 각각 Up 및 Down 방향(scaleUp 및 scaleDown 필드)에서 대상의 스케일링 동작을 구성합니다.

maxReplicas

integer

maxReplicas는 자동 스케일러가 확장할 수 있는 복제본 수의 상한입니다. minReplicas보다 작을 수 없습니다.

메트릭

array

메트릭에는 원하는 복제본 수를 계산하는 데 사용할 사양이 포함되어 있습니다(모든 메트릭의 최대 복제본 수가 사용됩니다). 원하는 복제본 수는 대상 값과 현재 값 간의 비율을 현재 Pod 수를 곱한 값입니다. ergo, Pod 수가 증가하면 사용되는 메트릭이 감소해야 하며 그 반대의 경우도 마찬가지입니다. 각 메트릭 유형이 응답하는 방법에 대한 자세한 내용은 개별 메트릭 소스 유형을 참조하십시오. 설정되지 않은 경우 기본 메트릭은 평균 CPU 사용률의 80%로 설정됩니다.

metrics[]

object

MetricSpec은 단일 메트릭을 기반으로 스케일링하는 방법을 지정합니다( 유형 과 다른 일치하는 필드만 한 번에 설정되어야 함).

minReplicas

integer

minReplicas는 자동 스케일러가 축소할 수 있는 복제본 수의 더 낮은 제한입니다. 기본값은 1 pod입니다. 알파 기능 게이트 HPAScaleToZero가 활성화되고 하나 이상의 Object 또는 External 메트릭이 구성된 경우 minReplicas는 0이 될 수 있습니다. 하나 이상의 메트릭 값을 사용할 수 있는 경우 스케일링이 활성화됩니다.

scaleTargetRef

object

CrossVersionObjectReference에는 참조된 리소스를 식별할 수 있는 충분한 정보가 포함되어 있습니다.

4.1.2. .spec.behavior

설명
HorizontalPodAutoscalerBehavior는 각각 Up 및 Down 방향(scaleUp 및 scaleDown 필드)에서 대상의 스케일링 동작을 구성합니다.
유형
object
속성유형설명

scaleDown

object

HPAScalingRules는 한 방향에 대한 스케일링 동작을 구성합니다. 이러한 규칙은 HPA의 메트릭에서 DesiredReplicas를 계산한 후 적용됩니다. 스케일링 정책을 지정하여 스케일링 속도를 제한할 수 있습니다. 안정화 창을 지정하여 플러딩을 방지할 수 있으므로 복제본 수가 즉시 설정되지 않고 안정화 창에서 가장 안전한 값을 선택합니다.

scaleUp

object

HPAScalingRules는 한 방향에 대한 스케일링 동작을 구성합니다. 이러한 규칙은 HPA의 메트릭에서 DesiredReplicas를 계산한 후 적용됩니다. 스케일링 정책을 지정하여 스케일링 속도를 제한할 수 있습니다. 안정화 창을 지정하여 플러딩을 방지할 수 있으므로 복제본 수가 즉시 설정되지 않고 안정화 창에서 가장 안전한 값을 선택합니다.

4.1.3. .spec.behavior.scaleDown

설명
HPAScalingRules는 한 방향에 대한 스케일링 동작을 구성합니다. 이러한 규칙은 HPA의 메트릭에서 DesiredReplicas를 계산한 후 적용됩니다. 스케일링 정책을 지정하여 스케일링 속도를 제한할 수 있습니다. 안정화 창을 지정하여 플러딩을 방지할 수 있으므로 복제본 수가 즉시 설정되지 않고 안정화 창에서 가장 안전한 값을 선택합니다.
유형
object
속성유형설명

Policies

array

정책은 확장 중에 사용할 수 있는 잠재적인 확장 정책 목록입니다. 하나 이상의 정책을 지정해야 합니다. 그러지 않으면 HPAScalingRules가 유효하지 않은 것으로 삭제됩니다.

policies[]

object

HPAScalingPolicy는 지정된 이전 간격에 대해 true를 유지해야 하는 단일 정책입니다.

selectPolicy

string

selectPolicy는 사용할 정책을 지정하는 데 사용됩니다. 설정되지 않은 경우 기본값 Max가 사용됩니다.

stabilizationWindowSeconds

integer

stabilizationWindowSeconds는 확장 또는 축소하는 동안 이전 권장 사항을 고려해야 하는 시간(초)입니다. CryostatbilizationWindowSeconds는 0보다 크거나 같고 3600보다 작거나 같아야 합니다(한 시간). 설정되지 않은 경우 기본값을 사용합니다. - 확장의 경우 0(예: 안정화 작업이 수행되지 않음). - 스케일 다운의 경우 300(예: 안정화 창 길이는 300초)입니다.

4.1.4. .spec.behavior.scaleDown.policies

설명
정책은 확장 중에 사용할 수 있는 잠재적인 확장 정책 목록입니다. 하나 이상의 정책을 지정해야 합니다. 그러지 않으면 HPAScalingRules가 유효하지 않은 것으로 삭제됩니다.
유형
array

4.1.5. .spec.behavior.scaleDown.policies[]

설명
HPAScalingPolicy는 지정된 이전 간격에 대해 true를 유지해야 하는 단일 정책입니다.
유형
object
필수 항목
  • type
  • value
  • periodSeconds
속성유형설명

periodSeconds

integer

periodSeconds는 정책이 true를 유지해야 하는 시간 창을 지정합니다. periodSeconds는 0보다 크고 1800(10분)보다 작거나 같아야 합니다.

type

string

type은 스케일링 정책을 지정하는 데 사용됩니다.

value

integer

값에는 정책에서 허용하는 변경 횟수가 포함됩니다. 0보다 커야 합니다

4.1.6. .spec.behavior.scaleUp

설명
HPAScalingRules는 한 방향에 대한 스케일링 동작을 구성합니다. 이러한 규칙은 HPA의 메트릭에서 DesiredReplicas를 계산한 후 적용됩니다. 스케일링 정책을 지정하여 스케일링 속도를 제한할 수 있습니다. 안정화 창을 지정하여 플러딩을 방지할 수 있으므로 복제본 수가 즉시 설정되지 않고 안정화 창에서 가장 안전한 값을 선택합니다.
유형
object
속성유형설명

Policies

array

정책은 확장 중에 사용할 수 있는 잠재적인 확장 정책 목록입니다. 하나 이상의 정책을 지정해야 합니다. 그러지 않으면 HPAScalingRules가 유효하지 않은 것으로 삭제됩니다.

policies[]

object

HPAScalingPolicy는 지정된 이전 간격에 대해 true를 유지해야 하는 단일 정책입니다.

selectPolicy

string

selectPolicy는 사용할 정책을 지정하는 데 사용됩니다. 설정되지 않은 경우 기본값 Max가 사용됩니다.

stabilizationWindowSeconds

integer

stabilizationWindowSeconds는 확장 또는 축소하는 동안 이전 권장 사항을 고려해야 하는 시간(초)입니다. CryostatbilizationWindowSeconds는 0보다 크거나 같고 3600보다 작거나 같아야 합니다(한 시간). 설정되지 않은 경우 기본값을 사용합니다. - 확장의 경우 0(예: 안정화 작업이 수행되지 않음). - 스케일 다운의 경우 300(예: 안정화 창 길이는 300초)입니다.

4.1.7. .spec.behavior.scaleUp.policies

설명
정책은 확장 중에 사용할 수 있는 잠재적인 확장 정책 목록입니다. 하나 이상의 정책을 지정해야 합니다. 그러지 않으면 HPAScalingRules가 유효하지 않은 것으로 삭제됩니다.
유형
array

4.1.8. .spec.behavior.scaleUp.policies[]

설명
HPAScalingPolicy는 지정된 이전 간격에 대해 true를 유지해야 하는 단일 정책입니다.
유형
object
필수 항목
  • type
  • value
  • periodSeconds
속성유형설명

periodSeconds

integer

periodSeconds는 정책이 true를 유지해야 하는 시간 창을 지정합니다. periodSeconds는 0보다 크고 1800(10분)보다 작거나 같아야 합니다.

type

string

type은 스케일링 정책을 지정하는 데 사용됩니다.

value

integer

값에는 정책에서 허용하는 변경 횟수가 포함됩니다. 0보다 커야 합니다

4.1.9. .spec.metrics

설명
메트릭에는 원하는 복제본 수를 계산하는 데 사용할 사양이 포함되어 있습니다(모든 메트릭의 최대 복제본 수가 사용됩니다). 원하는 복제본 수는 대상 값과 현재 값 간의 비율을 현재 Pod 수를 곱한 값입니다. ergo, Pod 수가 증가하면 사용되는 메트릭이 감소해야 하며 그 반대의 경우도 마찬가지입니다. 각 메트릭 유형이 응답하는 방법에 대한 자세한 내용은 개별 메트릭 소스 유형을 참조하십시오. 설정되지 않은 경우 기본 메트릭은 평균 CPU 사용률의 80%로 설정됩니다.
유형
array

4.1.10. .spec.metrics[]

설명
MetricSpec은 단일 메트릭을 기반으로 스케일링하는 방법을 지정합니다( 유형 과 다른 일치하는 필드만 한 번에 설정되어야 함).
유형
object
필수 항목
  • type
속성유형설명

containerResource

object

ContainerResourceMetricSource는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 메트릭을 확장하여 현재 규모 대상(예: CPU 또는 메모리)의 각 Pod를 설명하는 방법을 나타냅니다. 값은 대상과 비교되기 전에 함께 평균화됩니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다. 하나의 "대상" 유형만 설정해야 합니다.

external

object

ExternalMetricSource는 Kubernetes 오브젝트와 연결되지 않은 메트릭(예: 클라우드 메시징 서비스의 큐 길이 또는 클러스터 외부에서 실행되는 로드 밸런서에서 QPS)을 스케일링하는 방법을 나타냅니다.

object

object

ObjectMetricSource는 kubernetes 오브젝트(예: Ingress 오브젝트의 hits-per-second)를 설명하는 메트릭을 스케일링하는 방법을 나타냅니다.

pods

object

PodsMetricSource는 현재 규모 대상(예: 트랜잭션 처리-초)의 각 Pod를 설명하는 메트릭을 스케일링하는 방법을 나타냅니다. 값은 대상 값과 비교되기 전에 함께 평균됩니다.

resource

object

ResourceMetricSource는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 메트릭을 스케일링하여 현재 스케일 대상(예: CPU 또는 메모리)의 각 Pod를 설명하는 방법을 나타냅니다. 값은 대상과 비교되기 전에 함께 평균화됩니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다. 하나의 "대상" 유형만 설정해야 합니다.

type

string

type은 지표 소스 유형입니다. "ContainerResource", "External", "Object", "Pods" 또는 "Resource" 중 하나여야 하며 각각 오브젝트의 일치하는 필드에 매핑해야 합니다. 참고: "ContainerResource" 유형은 기능-게이트 HPAContainerMetrics가 활성화된 경우에서 사용할 수 있습니다.

4.1.11. .spec.metrics[].containerResource

설명
ContainerResourceMetricSource는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 메트릭을 확장하여 현재 규모 대상(예: CPU 또는 메모리)의 각 Pod를 설명하는 방법을 나타냅니다. 값은 대상과 비교되기 전에 함께 평균화됩니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다. 하나의 "대상" 유형만 설정해야 합니다.
유형
object
필수 항목
  • name
  • 대상
  • container
속성유형설명

container

string

컨테이너는 스케일링 대상의 Pod에 있는 컨테이너의 이름입니다.

name

string

name은 해당 리소스의 이름입니다.

대상

object

MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.

4.1.12. .spec.metrics[].containerResource.target

설명
MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.
유형
object
필수 항목
  • type
속성유형설명

averageUtilization

integer

averageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 대상 값입니다. 현재 리소스 메트릭 소스 유형에만 유효합니다.

averageValue

수량

AverageValue는 모든 관련 Pod에서 지표 평균의 대상 값입니다(수량)

type

string

type은 메트릭 유형이 Utilization, Value 또는 AverageValue인지 여부를 나타냅니다.

value

수량

값은 메트릭의 대상 값입니다(량)입니다.

4.1.13. .spec.metrics[].external

설명
ExternalMetricSource는 Kubernetes 오브젝트와 연결되지 않은 메트릭(예: 클라우드 메시징 서비스의 큐 길이 또는 클러스터 외부에서 실행되는 로드 밸런서에서 QPS)을 스케일링하는 방법을 나타냅니다.
유형
object
필수 항목
  • 메트릭
  • 대상
속성유형설명

메트릭

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

대상

object

MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.

4.1.14. .spec.metrics[].external.metric

설명
MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

4.1.15. .spec.metrics[].external.target

설명
MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.
유형
object
필수 항목
  • type
속성유형설명

averageUtilization

integer

averageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 대상 값입니다. 현재 리소스 메트릭 소스 유형에만 유효합니다.

averageValue

수량

AverageValue는 모든 관련 Pod에서 지표 평균의 대상 값입니다(수량)

type

string

type은 메트릭 유형이 Utilization, Value 또는 AverageValue인지 여부를 나타냅니다.

value

수량

값은 메트릭의 대상 값입니다(량)입니다.

4.1.16. .spec.metrics[].object

설명
ObjectMetricSource는 kubernetes 오브젝트(예: Ingress 오브젝트의 hits-per-second)를 설명하는 메트릭을 스케일링하는 방법을 나타냅니다.
유형
object
필수 항목
  • describedObject
  • 대상
  • 메트릭
속성유형설명

describedObject

object

CrossVersionObjectReference에는 참조된 리소스를 식별할 수 있는 충분한 정보가 포함되어 있습니다.

메트릭

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

대상

object

MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.

4.1.17. .spec.metrics[].object.describedObject

설명
CrossVersionObjectReference에는 참조된 리소스를 식별할 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • kind
  • name
속성유형설명

apiVersion

string

apiVersion은 참조의 API 버전입니다.

kind

string

kind는 참조의 종류입니다. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

이름은 참조의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

4.1.18. .spec.metrics[].object.metric

설명
MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

4.1.19. .spec.metrics[].object.target

설명
MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.
유형
object
필수 항목
  • type
속성유형설명

averageUtilization

integer

averageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 대상 값입니다. 현재 리소스 메트릭 소스 유형에만 유효합니다.

averageValue

수량

AverageValue는 모든 관련 Pod에서 지표 평균의 대상 값입니다(수량)

type

string

type은 메트릭 유형이 Utilization, Value 또는 AverageValue인지 여부를 나타냅니다.

value

수량

값은 메트릭의 대상 값입니다(량)입니다.

4.1.20. .spec.metrics[].pods

설명
PodsMetricSource는 현재 규모 대상(예: 트랜잭션 처리-초)의 각 Pod를 설명하는 메트릭을 스케일링하는 방법을 나타냅니다. 값은 대상 값과 비교되기 전에 함께 평균됩니다.
유형
object
필수 항목
  • 메트릭
  • 대상
속성유형설명

메트릭

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

대상

object

MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.

4.1.21. .spec.metrics[].pods.metric

설명
MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

4.1.22. .spec.metrics[].pods.target

설명
MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.
유형
object
필수 항목
  • type
속성유형설명

averageUtilization

integer

averageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 대상 값입니다. 현재 리소스 메트릭 소스 유형에만 유효합니다.

averageValue

수량

AverageValue는 모든 관련 Pod에서 지표 평균의 대상 값입니다(수량)

type

string

type은 메트릭 유형이 Utilization, Value 또는 AverageValue인지 여부를 나타냅니다.

value

수량

값은 메트릭의 대상 값입니다(량)입니다.

4.1.23. .spec.metrics[].resource

설명
ResourceMetricSource는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 메트릭을 스케일링하여 현재 스케일 대상(예: CPU 또는 메모리)의 각 Pod를 설명하는 방법을 나타냅니다. 값은 대상과 비교되기 전에 함께 평균화됩니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다. 하나의 "대상" 유형만 설정해야 합니다.
유형
object
필수 항목
  • name
  • 대상
속성유형설명

name

string

name은 해당 리소스의 이름입니다.

대상

object

MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.

4.1.24. .spec.metrics[].resource.target

설명
MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.
유형
object
필수 항목
  • type
속성유형설명

averageUtilization

integer

averageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 대상 값입니다. 현재 리소스 메트릭 소스 유형에만 유효합니다.

averageValue

수량

AverageValue는 모든 관련 Pod에서 지표 평균의 대상 값입니다(수량)

type

string

type은 메트릭 유형이 Utilization, Value 또는 AverageValue인지 여부를 나타냅니다.

value

수량

값은 메트릭의 대상 값입니다(량)입니다.

4.1.25. .spec.scaleTargetRef

설명
CrossVersionObjectReference에는 참조된 리소스를 식별할 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • kind
  • name
속성유형설명

apiVersion

string

apiVersion은 참조의 API 버전입니다.

kind

string

kind는 참조의 종류입니다. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

이름은 참조의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

4.1.26. .status

설명
HorizontalPodAutoscalerStatus는 수평 Pod 자동 스케일러의 현재 상태를 설명합니다.
유형
object
필수 항목
  • desiredReplicas
속성유형설명

conditions

array

조건은 이 자동 스케일러가 대상을 확장하는 데 필요한 조건 세트이며 해당 조건이 충족되는지 여부를 나타냅니다.

conditions[]

object

HorizontalPodAutoscalerCondition은 특정 시점에서 HorizontalPodAutoscaler의 상태를 설명합니다.

currentMetrics

array

currentMetrics는 이 자동 스케일러에서 사용하는 메트릭의 마지막 읽기 상태입니다.

currentMetrics[]

object

MetricStatus는 단일 메트릭의 마지막 읽기 상태를 설명합니다.

currentReplicas

integer

currentReplicas는 자동 스케일러에서 마지막으로 표시된 대로 이 자동 스케일러에서 관리하는 Pod의 현재 복제본 수입니다.

desiredReplicas

integer

desiredReplicas는 자동 스케일러에서 마지막으로 계산한 대로 이 자동 스케일러에서 관리하는 Pod의 원하는 수입니다.

lastScaleTime

시간

lastScaleTime은 HorizontalPodAutoscaler가 Pod 수를 변경하는 빈도를 제어하기 위해 자동 스케일러에서 사용하는 Pod 수를 마지막으로 스케일링한 시간입니다.

observedGeneration

integer

observedGeneration은 이 자동 스케일러에서 관찰하는 가장 최근 생성입니다.

4.1.27. .status.conditions

설명
조건은 이 자동 스케일러가 대상을 확장하는 데 필요한 조건 세트이며 해당 조건이 충족되는지 여부를 나타냅니다.
유형
array

4.1.28. .status.conditions[]

설명
HorizontalPodAutoscalerCondition은 특정 시점에서 HorizontalPodAutoscaler의 상태를 설명합니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

lastTransitionTime

시간

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

message

string

message는 전환에 대한 세부 정보가 포함된 사람이 읽을 수 있는 설명입니다.

reason

string

이유는 조건의 마지막 전환의 이유입니다.

status

string

status는 조건의 상태(True, False, Unknown)입니다.

type

string

type은 현재 조건을 설명합니다.

4.1.29. .status.currentMetrics

설명
currentMetrics는 이 자동 스케일러에서 사용하는 메트릭의 마지막 읽기 상태입니다.
유형
array

4.1.30. .status.currentMetrics[]

설명
MetricStatus는 단일 메트릭의 마지막 읽기 상태를 설명합니다.
유형
object
필수 항목
  • type
속성유형설명

containerResource

object

ContainerResourceMetricStatus는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 지표의 현재 값을 나타내며, 현재 스케일 대상(예: CPU 또는 메모리)의 각 Pod에 단일 컨테이너를 설명합니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다.

external

object

ExternalMetricStatus는 Kubernetes 오브젝트와 연결되지 않은 글로벌 메트릭의 현재 값을 나타냅니다.

object

object

ObjectMetricStatus는 kubernetes 오브젝트(예: Ingress 오브젝트의 hits-per-second)를 설명하는 메트릭의 현재 값을 나타냅니다.

pods

object

PodsMetricStatus는 현재 스케일링 대상(예: transactions-processed-per-second)의 각 Pod를 설명하는 지표의 현재 값을 나타냅니다.

resource

object

ResourceMetricStatus는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 지표의 현재 값을 나타내며, 현재 스케일 대상(예: CPU 또는 메모리)의 각 Pod를 설명합니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다.

type

string

type은 지표 소스 유형입니다. "ContainerResource", "External", "Object", "Pods" 또는 "Resource" 중 하나일 것이며 각각 오브젝트의 일치하는 필드에 해당합니다. 참고: "ContainerResource" 유형은 기능-게이트 HPAContainerMetrics가 활성화된 경우에서 사용할 수 있습니다.

4.1.31. .status.currentMetrics[].containerResource

설명
ContainerResourceMetricStatus는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 지표의 현재 값을 나타내며, 현재 스케일 대상(예: CPU 또는 메모리)의 각 Pod에 단일 컨테이너를 설명합니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다.
유형
object
필수 항목
  • name
  • current
  • container
속성유형설명

container

string

컨테이너는 스케일링 대상의 Pod에 있는 컨테이너의 이름입니다.

current

object

MetricValueStatus에는 메트릭의 현재 값이 있습니다.

name

string

name은 해당 리소스의 이름입니다.

4.1.32. .status.currentMetrics[].containerResource.current

설명
MetricValueStatus에는 메트릭의 현재 값이 있습니다.
유형
object
속성유형설명

averageUtilization

integer

currentAverageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 현재 값입니다.

averageValue

수량

AverageValue는 모든 관련 Pod(수량)에서 지표 평균의 현재 값입니다.

value

수량

value는 메트릭의 현재 값(량)입니다.

4.1.33. .status.currentMetrics[].external

설명
ExternalMetricStatus는 Kubernetes 오브젝트와 연결되지 않은 글로벌 메트릭의 현재 값을 나타냅니다.
유형
object
필수 항목
  • 메트릭
  • current
속성유형설명

current

object

MetricValueStatus에는 메트릭의 현재 값이 있습니다.

메트릭

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

4.1.34. .status.currentMetrics[].external.current

설명
MetricValueStatus에는 메트릭의 현재 값이 있습니다.
유형
object
속성유형설명

averageUtilization

integer

currentAverageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 현재 값입니다.

averageValue

수량

AverageValue는 모든 관련 Pod(수량)에서 지표 평균의 현재 값입니다.

value

수량

value는 메트릭의 현재 값(량)입니다.

4.1.35. .status.currentMetrics[].external.metric

설명
MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

4.1.36. .status.currentMetrics[].object

설명
ObjectMetricStatus는 kubernetes 오브젝트(예: Ingress 오브젝트의 hits-per-second)를 설명하는 메트릭의 현재 값을 나타냅니다.
유형
object
필수 항목
  • 메트릭
  • current
  • describedObject
속성유형설명

current

object

MetricValueStatus에는 메트릭의 현재 값이 있습니다.

describedObject

object

CrossVersionObjectReference에는 참조된 리소스를 식별할 수 있는 충분한 정보가 포함되어 있습니다.

메트릭

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

4.1.37. .status.currentMetrics[].object.current

설명
MetricValueStatus에는 메트릭의 현재 값이 있습니다.
유형
object
속성유형설명

averageUtilization

integer

currentAverageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 현재 값입니다.

averageValue

수량

AverageValue는 모든 관련 Pod(수량)에서 지표 평균의 현재 값입니다.

value

수량

value는 메트릭의 현재 값(량)입니다.

4.1.38. .status.currentMetrics[].object.describedObject

설명
CrossVersionObjectReference에는 참조된 리소스를 식별할 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • kind
  • name
속성유형설명

apiVersion

string

apiVersion은 참조의 API 버전입니다.

kind

string

kind는 참조의 종류입니다. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

이름은 참조의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

4.1.39. .status.currentMetrics[].object.metric

설명
MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

4.1.40. .status.currentMetrics[].pods

설명
PodsMetricStatus는 현재 스케일링 대상(예: transactions-processed-per-second)의 각 Pod를 설명하는 지표의 현재 값을 나타냅니다.
유형
object
필수 항목
  • 메트릭
  • current
속성유형설명

current

object

MetricValueStatus에는 메트릭의 현재 값이 있습니다.

메트릭

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

4.1.41. .status.currentMetrics[].pods.current

설명
MetricValueStatus에는 메트릭의 현재 값이 있습니다.
유형
object
속성유형설명

averageUtilization

integer

currentAverageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 현재 값입니다.

averageValue

수량

AverageValue는 모든 관련 Pod(수량)에서 지표 평균의 현재 값입니다.

value

수량

value는 메트릭의 현재 값(량)입니다.

4.1.42. .status.currentMetrics[].pods.metric

설명
MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

4.1.43. .status.currentMetrics[].resource

설명
ResourceMetricStatus는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 지표의 현재 값을 나타내며, 현재 스케일 대상(예: CPU 또는 메모리)의 각 Pod를 설명합니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다.
유형
object
필수 항목
  • name
  • current
속성유형설명

current

object

MetricValueStatus에는 메트릭의 현재 값이 있습니다.

name

string

name은 해당 리소스의 이름입니다.

4.1.44. .status.currentMetrics[].resource.current

설명
MetricValueStatus에는 메트릭의 현재 값이 있습니다.
유형
object
속성유형설명

averageUtilization

integer

currentAverageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 현재 값입니다.

averageValue

수량

AverageValue는 모든 관련 Pod(수량)에서 지표 평균의 현재 값입니다.

value

수량

value는 메트릭의 현재 값(량)입니다.

4.2. API 끝점

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

  • /apis/autoscaling/v2/horizontalpodautoscalers

    • GET: HorizontalPodAutoscaler 유형의 오브젝트 나열 또는 감시
  • /apis/autoscaling/v2/watch/horizontalpodautoscalers

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

    • DELETE: HorizontalPodAutoscaler의 컬렉션 삭제
    • GET: HorizontalPodAutoscaler 유형의 오브젝트 나열 또는 감시
    • POST: HorizontalPodAutoscaler 생성
  • /apis/autoscaling/v2/watch/namespaces/{namespace}/horizontalpodautoscalers

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

    • DELETE: delete a HorizontalPodAutoscaler
    • GET: 지정된 HorizontalPodAutoscaler 읽기
    • PATCH: 지정된 HorizontalPodAutoscaler를 부분적으로 업데이트
    • PUT: 지정된 HorizontalPodAutoscaler로 교체
  • /apis/autoscaling/v2/watch/namespaces/{namespace}/horizontalpodautoscalers/{name}

    • GET: HorizontalPodAutoscaler 유형의 오브젝트를 감시합니다. 더 이상 사용되지 않는 오브젝트: 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링됩니다.
  • /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers/{name}/status

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

4.2.1. /apis/autoscaling/v2/horizontalpodautoscalers

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

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

기본값이 설정되지 않음

sendInitialEvents

boolean

sendInitialEvents=truewatch=true 와 함께 설정할 수 있습니다. 이 경우 감시 스트림은 합성 이벤트로 시작하여 컬렉션에 있는 개체의 현재 상태를 생성합니다. 이러한 모든 이벤트가 전송되면 합성 " emailmark" 이벤트가 전송됩니다. 북마크는 오브젝트 세트에 해당하는 ResourceVersion(RV)을 보고하고 "k8s.io/initial-events-end": "true" 주석으로 표시됩니다. 이후 감시 스트림은 정상적으로 진행되어 모니터링되는 오브젝트에 변경(RV에 제출)에 해당하는 감시 이벤트를 보냅니다.

sendInitialEvents 옵션을 설정할 때 resourceVersionMatch 옵션도 설정해야 합니다. 감시 요청의 의미 체계는 다음과 같습니다. - resourceVersionMatch = NotOlderThan은 "제공된 resourceVersion'만큼 새로운 데이터로 해석되며 북마크 이벤트는 상태가 'resourceVersion에 동기화될 때 적어도 ListOptions에서 제공하는 것과 같이 새로운 것으로 전송됩니다. resourceVersion 이 설정되지 않은 경우, 이는 "consistent read"로 해석되고, 요청이 처리되기 시작할 때 상태가 최소한 현재와 동기화될 때 북마크 이벤트는 전송됩니다. - resourceVersionMatch 가 다른 값으로 설정되거나 설정되지 않은 오류를 반환합니다.

resourceVersion="" 또는 resourceVersion="0"( 이전의 호환성 이유로) 및 false인 경우 기본값은 true입니다.

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

HorizontalPodAutoscalerList schema

401 - 무단

4.2.2. /apis/autoscaling/v2/watch/horizontalpodautoscalers

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

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

기본값이 설정되지 않음

sendInitialEvents

boolean

sendInitialEvents=truewatch=true 와 함께 설정할 수 있습니다. 이 경우 감시 스트림은 합성 이벤트로 시작하여 컬렉션에 있는 개체의 현재 상태를 생성합니다. 이러한 모든 이벤트가 전송되면 합성 " emailmark" 이벤트가 전송됩니다. 북마크는 오브젝트 세트에 해당하는 ResourceVersion(RV)을 보고하고 "k8s.io/initial-events-end": "true" 주석으로 표시됩니다. 이후 감시 스트림은 정상적으로 진행되어 모니터링되는 오브젝트에 변경(RV에 제출)에 해당하는 감시 이벤트를 보냅니다.

sendInitialEvents 옵션을 설정할 때 resourceVersionMatch 옵션도 설정해야 합니다. 감시 요청의 의미 체계는 다음과 같습니다. - resourceVersionMatch = NotOlderThan은 "제공된 resourceVersion'만큼 새로운 데이터로 해석되며 북마크 이벤트는 상태가 'resourceVersion에 동기화될 때 적어도 ListOptions에서 제공하는 것과 같이 새로운 것으로 전송됩니다. resourceVersion 이 설정되지 않은 경우, 이는 "consistent read"로 해석되고, 요청이 처리되기 시작할 때 상태가 최소한 현재와 동기화될 때 북마크 이벤트는 전송됩니다. - resourceVersionMatch 가 다른 값으로 설정되거나 설정되지 않은 오류를 반환합니다.

resourceVersion="" 또는 resourceVersion="0"( 이전의 호환성 이유로) 및 false인 경우 기본값은 true입니다.

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

WatchEvent 스키마

401 - 무단

4.2.3. /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers

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

네임스페이스

string

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

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

string

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

HTTP 방법
DELETE
설명
HorizontalPodAutoscaler 삭제
표 4.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

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

limit

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

기본값이 설정되지 않음

sendInitialEvents

boolean

sendInitialEvents=truewatch=true 와 함께 설정할 수 있습니다. 이 경우 감시 스트림은 합성 이벤트로 시작하여 컬렉션에 있는 개체의 현재 상태를 생성합니다. 이러한 모든 이벤트가 전송되면 합성 " emailmark" 이벤트가 전송됩니다. 북마크는 오브젝트 세트에 해당하는 ResourceVersion(RV)을 보고하고 "k8s.io/initial-events-end": "true" 주석으로 표시됩니다. 이후 감시 스트림은 정상적으로 진행되어 모니터링되는 오브젝트에 변경(RV에 제출)에 해당하는 감시 이벤트를 보냅니다.

sendInitialEvents 옵션을 설정할 때 resourceVersionMatch 옵션도 설정해야 합니다. 감시 요청의 의미 체계는 다음과 같습니다. - resourceVersionMatch = NotOlderThan은 "제공된 resourceVersion'만큼 새로운 데이터로 해석되며 북마크 이벤트는 상태가 'resourceVersion에 동기화될 때 적어도 ListOptions에서 제공하는 것과 같이 새로운 것으로 전송됩니다. resourceVersion 이 설정되지 않은 경우, 이는 "consistent read"로 해석되고, 요청이 처리되기 시작할 때 상태가 최소한 현재와 동기화될 때 북마크 이벤트는 전송됩니다. - resourceVersionMatch 가 다른 값으로 설정되거나 설정되지 않은 오류를 반환합니다.

resourceVersion="" 또는 resourceVersion="0"( 이전의 호환성 이유로) 및 false인 경우 기본값은 true입니다.

timeoutSeconds

integer

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
HorizontalPodAutoscaler 유형의 오브젝트 나열 또는 감시
표 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

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

limit

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

기본값이 설정되지 않음

sendInitialEvents

boolean

sendInitialEvents=truewatch=true 와 함께 설정할 수 있습니다. 이 경우 감시 스트림은 합성 이벤트로 시작하여 컬렉션에 있는 개체의 현재 상태를 생성합니다. 이러한 모든 이벤트가 전송되면 합성 " emailmark" 이벤트가 전송됩니다. 북마크는 오브젝트 세트에 해당하는 ResourceVersion(RV)을 보고하고 "k8s.io/initial-events-end": "true" 주석으로 표시됩니다. 이후 감시 스트림은 정상적으로 진행되어 모니터링되는 오브젝트에 변경(RV에 제출)에 해당하는 감시 이벤트를 보냅니다.

sendInitialEvents 옵션을 설정할 때 resourceVersionMatch 옵션도 설정해야 합니다. 감시 요청의 의미 체계는 다음과 같습니다. - resourceVersionMatch = NotOlderThan은 "제공된 resourceVersion'만큼 새로운 데이터로 해석되며 북마크 이벤트는 상태가 'resourceVersion에 동기화될 때 적어도 ListOptions에서 제공하는 것과 같이 새로운 것으로 전송됩니다. resourceVersion 이 설정되지 않은 경우, 이는 "consistent read"로 해석되고, 요청이 처리되기 시작할 때 상태가 최소한 현재와 동기화될 때 북마크 이벤트는 전송됩니다. - resourceVersionMatch 가 다른 값으로 설정되거나 설정되지 않은 오류를 반환합니다.

resourceVersion="" 또는 resourceVersion="0"( 이전의 호환성 이유로) 및 false인 경우 기본값은 true입니다.

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

HorizontalPodAutoscalerList schema

401 - 무단

HTTP 방법
POST
설명
HorizontalPodAutoscaler 생성
표 4.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

HorizontalPodAutoscaler schema

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

200 - OK

HorizontalPodAutoscaler schema

201 - 생성됨

HorizontalPodAutoscaler schema

202 - 승인됨

HorizontalPodAutoscaler schema

401 - 무단

4.2.4. /apis/autoscaling/v2/watch/namespaces/{namespace}/horizontalpodautoscalers

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

네임스페이스

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

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

기본값이 설정되지 않음

sendInitialEvents

boolean

sendInitialEvents=truewatch=true 와 함께 설정할 수 있습니다. 이 경우 감시 스트림은 합성 이벤트로 시작하여 컬렉션에 있는 개체의 현재 상태를 생성합니다. 이러한 모든 이벤트가 전송되면 합성 " emailmark" 이벤트가 전송됩니다. 북마크는 오브젝트 세트에 해당하는 ResourceVersion(RV)을 보고하고 "k8s.io/initial-events-end": "true" 주석으로 표시됩니다. 이후 감시 스트림은 정상적으로 진행되어 모니터링되는 오브젝트에 변경(RV에 제출)에 해당하는 감시 이벤트를 보냅니다.

sendInitialEvents 옵션을 설정할 때 resourceVersionMatch 옵션도 설정해야 합니다. 감시 요청의 의미 체계는 다음과 같습니다. - resourceVersionMatch = NotOlderThan은 "제공된 resourceVersion'만큼 새로운 데이터로 해석되며 북마크 이벤트는 상태가 'resourceVersion에 동기화될 때 적어도 ListOptions에서 제공하는 것과 같이 새로운 것으로 전송됩니다. resourceVersion 이 설정되지 않은 경우, 이는 "consistent read"로 해석되고, 요청이 처리되기 시작할 때 상태가 최소한 현재와 동기화될 때 북마크 이벤트는 전송됩니다. - resourceVersionMatch 가 다른 값으로 설정되거나 설정되지 않은 오류를 반환합니다.

resourceVersion="" 또는 resourceVersion="0"( 이전의 호환성 이유로) 및 false인 경우 기본값은 true입니다.

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

WatchEvent 스키마

401 - 무단

4.2.5. /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers/{name}

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

name

string

HorizontalPodAutoscaler의 이름

네임스페이스

string

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

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

string

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

HTTP 방법
DELETE
설명
delete a HorizontalPodAutoscaler
표 4.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

HorizontalPodAutoscaler schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

force

boolean

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

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

body

패치 스키마

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

200 - OK

HorizontalPodAutoscaler schema

201 - 생성됨

HorizontalPodAutoscaler schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

HorizontalPodAutoscaler schema

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

200 - OK

HorizontalPodAutoscaler schema

201 - 생성됨

HorizontalPodAutoscaler schema

401 - 무단

4.2.6. /apis/autoscaling/v2/watch/namespaces/{namespace}/horizontalpodautoscalers/{name}

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

name

string

HorizontalPodAutoscaler의 이름

네임스페이스

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

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

기본값이 설정되지 않음

sendInitialEvents

boolean

sendInitialEvents=truewatch=true 와 함께 설정할 수 있습니다. 이 경우 감시 스트림은 합성 이벤트로 시작하여 컬렉션에 있는 개체의 현재 상태를 생성합니다. 이러한 모든 이벤트가 전송되면 합성 " emailmark" 이벤트가 전송됩니다. 북마크는 오브젝트 세트에 해당하는 ResourceVersion(RV)을 보고하고 "k8s.io/initial-events-end": "true" 주석으로 표시됩니다. 이후 감시 스트림은 정상적으로 진행되어 모니터링되는 오브젝트에 변경(RV에 제출)에 해당하는 감시 이벤트를 보냅니다.

sendInitialEvents 옵션을 설정할 때 resourceVersionMatch 옵션도 설정해야 합니다. 감시 요청의 의미 체계는 다음과 같습니다. - resourceVersionMatch = NotOlderThan은 "제공된 resourceVersion'만큼 새로운 데이터로 해석되며 북마크 이벤트는 상태가 'resourceVersion에 동기화될 때 적어도 ListOptions에서 제공하는 것과 같이 새로운 것으로 전송됩니다. resourceVersion 이 설정되지 않은 경우, 이는 "consistent read"로 해석되고, 요청이 처리되기 시작할 때 상태가 최소한 현재와 동기화될 때 북마크 이벤트는 전송됩니다. - resourceVersionMatch 가 다른 값으로 설정되거나 설정되지 않은 오류를 반환합니다.

resourceVersion="" 또는 resourceVersion="0"( 이전의 호환성 이유로) 및 false인 경우 기본값은 true입니다.

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

WatchEvent 스키마

401 - 무단

4.2.7. /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers/{name}/status

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

name

string

HorizontalPodAutoscaler의 이름

네임스페이스

string

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

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

string

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

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

200 - OK

HorizontalPodAutoscaler schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

force

boolean

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

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

body

패치 스키마

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

200 - OK

HorizontalPodAutoscaler schema

201 - 생성됨

HorizontalPodAutoscaler schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

HorizontalPodAutoscaler schema

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

200 - OK

HorizontalPodAutoscaler schema

201 - 생성됨

HorizontalPodAutoscaler schema

401 - 무단

5장. 확장 [autoscaling/v1]

설명
scale은 리소스에 대한 확장 요청을 나타냅니다.
유형
object

5.1. 사양

속성유형설명

apiVersion

string

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

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트 메타데이터; 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata.

spec

object

scaleSpec은 scale 하위 리소스의 속성을 설명합니다.

status

object

scaleStatus는 scale 하위 리소스의 현재 상태를 나타냅니다.

5.1.1. .spec

설명
scaleSpec은 scale 하위 리소스의 속성을 설명합니다.
유형
object
속성유형설명

replicas

integer

replicas는 확장된 오브젝트에 필요한 인스턴스 수입니다.

5.1.2. .status

설명
scaleStatus는 scale 하위 리소스의 현재 상태를 나타냅니다.
유형
object
필수 항목
  • replicas
속성유형설명

replicas

integer

replicas는 확장된 오브젝트의 실제 관찰된 인스턴스 수입니다.

선택기

string

selector는 복제본 수와 일치해야 하는 Pod의 라벨 쿼리입니다. 이는 라벨 선택기와 동일하지만 클라이언트의 인트로스펙션을 방지하기 위해 문자열 형식입니다. 문자열은 query-param 구문과 동일한 형식이 됩니다. 라벨 선택기에 대한 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/

5.2. API 끝점

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

  • /apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale

    • GET: 지정된 배포의 크기 읽기
    • PATCH: 지정된 배포의 부분 업데이트 규모
    • PUT: 지정된 배포의 스케일링을 교체
  • /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/scale

    • GET: 지정된 ReplicaSet의 읽기 스케일링
    • PATCH: 지정된 ReplicaSet의 부분 업데이트 규모
    • PUT: 지정된 ReplicaSet의 스케일링을 교체
  • /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/scale

    • GET: 지정된 StatefulSet의 읽기 스케일링
    • PATCH: 지정된 StatefulSet의 부분적으로 업데이트 스케일링
    • PUT: 지정된 StatefulSet의 스케일링을 교체
  • /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

    • GET: 지정된 ReplicationController의 읽기 비율
    • PATCH: 지정된 ReplicationController의 부분 업데이트 규모
    • PUT: 지정된 ReplicationController의 스케일링을 교체

5.2.1. /apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale

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

name

string

스케일의 이름

네임스페이스

string

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

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

string

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

HTTP 방법
GET
설명
지정된 배포의 규모 읽기
표 5.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스케일링 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 배포의 부분 업데이트 스케일링
표 5.4. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

force

boolean

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

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

body

패치 스키마

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

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 배포의 스케일링 교체
표 5.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

스케일링 스키마

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

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

5.2.2. /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/scale

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

name

string

스케일의 이름

네임스페이스

string

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

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

string

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

HTTP 방법
GET
설명
지정된 ReplicaSet의 크기 읽기
표 5.12. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스케일링 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ReplicaSet의 부분 업데이트 스케일링
표 5.13. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

force

boolean

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

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

body

패치 스키마

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

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ReplicaSet의 스케일링을 교체
표 5.16. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

스케일링 스키마

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

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

5.2.3. /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/scale

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

name

string

스케일의 이름

네임스페이스

string

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

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

string

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

HTTP 방법
GET
설명
지정된 StatefulSet의 크기 조정
표 5.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스케일링 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 StatefulSet의 규모를 부분적으로 업데이트
표 5.22. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

force

boolean

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

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

body

패치 스키마

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

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 StatefulSet의 스케일링 교체
표 5.25. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

스케일링 스키마

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

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

5.2.4. /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

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

name

string

스케일의 이름

네임스페이스

string

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

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

string

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

HTTP 방법
GET
설명
지정된 ReplicationController의 크기 읽기
표 5.30. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스케일링 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ReplicationController의 규모를 부분적으로 업데이트
표 5.31. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

force

boolean

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

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

body

패치 스키마

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

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ReplicationController의 스케일링 교체
표 5.34. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

스케일링 스키마

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

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

Legal Notice

Copyright © 2024 Red Hat, Inc.

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

© 2024 Red Hat, Inc.