머신 API


OpenShift Container Platform 4.12

머신 API에 대한 참조 가이드

Red Hat OpenShift Documentation Team

초록

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

1장. 머신 API

1.1. ContainerRuntimeConfig [machineconfiguration.openshift.io/v1]

설명
ContainerRuntimeConfig는 사용자 지정 컨테이너 런타임 구성을 설명합니다.
유형
object

1.2. ControllerConfig [machineconfiguration.openshift.io/v1]

설명
ControllerConfig는 MachineConfigController의 구성을 설명합니다. 현재 이는 TemplateController에서 생성한 MachineConfig 오브젝트를 구동하는 데만 사용됩니다.
유형
object

1.3. ControlPlaneMachineSet [machine.openshift.io/v1]

설명
ControlPlaneMachineSet을 사용하면 지정된 수의 컨트롤 플레인 시스템 복제본이 언제든지 실행됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.4. KubeletConfig [machineconfiguration.openshift.io/v1]

설명
KubeletConfig는 사용자 지정 Kubelet 구성을 설명합니다.
유형
object

1.5. MachineConfigPool [machineconfiguration.openshift.io/v1]

설명
MachineConfigPool은 MachineConfigs 풀을 설명합니다.
유형
object

1.6. MachineConfig [machineconfiguration.openshift.io/v1]

설명
MachineConfig는 머신 구성을 정의합니다.
유형
object

1.7. MachineHealthCheck [machine.openshift.io/v1beta1]

설명
MachineHealthCheck는 machinehealthchecks API 호환성 수준 2의 스키마입니다. 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)에 대한 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.8. Machine [machine.openshift.io/v1beta1]

설명
머신은 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 시스템 API 호환성 수준 2의 스키마입니다.
유형
object

1.9. MachineSet [machine.openshift.io/v1beta1]

설명
MachineSet은 지정된 수의 머신 복제본이 지정된 시간에 실행되도록 합니다. 호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.
유형
object

2장. ContainerRuntimeConfig [machineconfiguration.openshift.io/v1]

설명
ContainerRuntimeConfig는 사용자 지정 컨테이너 런타임 구성을 설명합니다.
유형
object
필수 항목
  • spec

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

ContainerRuntimeConfigSpec은 원하는 ContainerRuntimeConfig의 상태를 정의합니다.

status

object

ContainerRuntimeConfigStatus는 ContainerRuntimeConfig의 관찰 상태를 정의합니다.

2.1.1. .spec

설명
ContainerRuntimeConfigSpec은 원하는 ContainerRuntimeConfig의 상태를 정의합니다.
유형
object
필수 항목
  • containerRuntimeConfig
속성유형설명

containerRuntimeConfig

object

ContainerRuntimeConfiguration은 컨테이너 런타임의 튜닝 가능 항목을 정의합니다. ContainerRuntimeConfiguration의 필드를 업스트림 kubernetes golang 클라이언트에서 직접 읽으므로 해당 값의 유효성 검사는 ContainerRuntimeConfiguration 컨트롤러 외부에 있는 golang 클라이언트에서 직접 처리됩니다. 잘못된 값이 클러스터 노드를 사용할 수 없게 될 수 있으므로 해당 필드에 유효한 값을 사용하는지 확인하십시오.

machineConfigPoolSelector

object

레이블 선택기는 리소스 집합에 대한 레이블 쿼리입니다. matchLabels 및 matchExpressions의 결과는 ANDed입니다. 빈 라벨 선택기는 모든 오브젝트와 일치합니다. null 라벨 선택기는 오브젝트와 일치하지 않습니다.

2.1.2. .spec.containerRuntimeConfig

설명
ContainerRuntimeConfiguration은 컨테이너 런타임의 튜닝 가능 항목을 정의합니다. ContainerRuntimeConfiguration의 필드를 업스트림 kubernetes golang 클라이언트에서 직접 읽으므로 해당 값의 유효성 검사는 ContainerRuntimeConfiguration 컨트롤러 외부에 있는 golang 클라이언트에서 직접 처리됩니다. 잘못된 값이 클러스터 노드를 사용할 수 없게 될 수 있으므로 해당 필드에 유효한 값을 사용하는지 확인하십시오.
유형
object
속성유형설명

defaultRuntime

string

defaultRuntime은 기본값으로 사용할 OCI 런타임의 이름입니다.

logLevel

string

loglevel은 설정된 수준에 따라 로그 세부 정보 표시를 지정합니다. 옵션은 fatal, panic, error, warn, info, debug입니다.

logSizeMax

string

logSizeMax는 컨테이너 로그 파일에 허용되는 최대 크기를 지정합니다. 음수 숫자는 크기 제한이 적용되지 않음을 나타냅니다. 이 값이 양수인 경우 conmon의 읽기 버퍼를 일치/exceed하려면 >= 8192여야 합니다.

overlaySize

string

overlaySize는 컨테이너 이미지의 최대 크기를 지정합니다. 이 플래그를 사용하여 컨테이너 이미지 크기에 할당량을 설정할 수 있습니다.

pidsLimit

integer

pidsLimit은 컨테이너에 허용되는 최대 프로세스 수를 지정합니다.

2.1.3. .spec.machineConfigPoolSelector

설명
레이블 선택기는 리소스 집합에 대한 레이블 쿼리입니다. matchLabels 및 matchExpressions의 결과는 ANDed입니다. 빈 라벨 선택기는 모든 오브젝트와 일치합니다. null 라벨 선택기는 오브젝트와 일치하지 않습니다.
유형
object
속성유형설명

matchExpressions

array

matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.

matchExpressions[]

object

레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchLabels

오브젝트(문자열)

matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다.

2.1.4. .spec.machineConfigPoolSelector.matchExpressions

설명
matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
유형
array

2.1.5. .spec.machineConfigPoolSelector.matchExpressions[]

설명
레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

key는 선택기가 적용되는 라벨 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.

배열(문자열)

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

2.1.6. .status

설명
ContainerRuntimeConfigStatus는 ContainerRuntimeConfig의 관찰 상태를 정의합니다.
유형
object
속성유형설명

conditions

array

조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

ContainerRuntimeConfigCondition은 ContainerRuntimeConfig의 상태를 정의합니다.

observedGeneration

integer

observedGeneration은 컨트롤러에서 관찰하는 생성을 나타냅니다.

2.1.7. .status.conditions

설명
조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형
array

2.1.8. .status.conditions[]

설명
ContainerRuntimeConfigCondition은 ContainerRuntimeConfig의 상태를 정의합니다.
유형
object
속성유형설명

lastTransitionTime

``

lastTransitionTime은 현재 상태 개체에 대한 마지막 업데이트 시간입니다.

message

string

message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다.

reason

string

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

status

string

조건의 상태, True, False, 알 수 없음.

type

string

type은 Operator 조정 기능의 상태를 지정합니다.

2.2. API 끝점

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

  • /apis/machineconfiguration.openshift.io/v1/containerruntimeconfigs

    • DELETE: ContainerRuntimeConfig의 컬렉션 삭제
    • GET: 종류의 ContainerRuntimeConfig의 오브젝트 나열
    • POST: ContainerRuntimeConfig 생성
  • /apis/machineconfiguration.openshift.io/v1/containerruntimeconfigs/{name}

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

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

2.2.1. /apis/machineconfiguration.openshift.io/v1/containerruntimeconfigs

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

string

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

HTTP 방법
DELETE
설명
ContainerRuntimeConfig 컬렉션 삭제
표 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

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류 ContainerRuntimeConfig의 오브젝트 나열
표 2.4. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

ContainerRuntimeConfigList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ContainerRuntimeConfig schema

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

200 - OK

ContainerRuntimeConfig schema

201 - 생성됨

ContainerRuntimeConfig schema

202 - 승인됨

ContainerRuntimeConfig schema

401 - 무단

2.2.2. /apis/machineconfiguration.openshift.io/v1/containerruntimeconfigs/{name}

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

name

string

ContainerRuntimeConfig의 이름

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

string

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

HTTP 방법
DELETE
설명
ContainerRuntimeConfig 삭제
표 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
설명
지정된 ContainerRuntimeConfig 읽기
표 2.14. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ContainerRuntimeConfig schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

ContainerRuntimeConfig schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ContainerRuntimeConfig schema

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

200 - OK

ContainerRuntimeConfig schema

201 - 생성됨

ContainerRuntimeConfig schema

401 - 무단

2.2.3. /apis/machineconfiguration.openshift.io/v1/containerruntimeconfigs/{name}/status

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

name

string

ContainerRuntimeConfig의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ContainerRuntimeConfig schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

ContainerRuntimeConfig schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ContainerRuntimeConfig schema

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

200 - OK

ContainerRuntimeConfig schema

201 - 생성됨

ContainerRuntimeConfig schema

401 - 무단

3장. ControllerConfig [machineconfiguration.openshift.io/v1]

설명
ControllerConfig는 MachineConfigController의 구성을 설명합니다. 현재 이는 TemplateController에서 생성한 MachineConfig 오브젝트를 구동하는 데만 사용됩니다.
유형
object
필수 항목
  • spec

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

ControllerConfigSpec은 ControllerConfig 리소스의 사양입니다.

status

object

ControllerConfigStatus는 ControllerConfig의 상태입니다.

3.1.1. .spec

설명
ControllerConfigSpec은 ControllerConfig 리소스의 사양입니다.
유형
object
필수 항목
  • cloudProviderConfig
  • clusterDNSIP
  • 이미지
  • ipFamilies
  • kubeAPIServerServingCAData
  • osImageURL
  • baseOSContainerImage
  • releaseImage
  • rootCAData
속성유형설명

additionalTrustBundle

``

additionalTrustBundle은 신뢰할 수 있는 노드 인증서 저장소에 추가할 인증서 번들입니다.

baseOSContainerImage

string

baseOSContainerImage는 새로운 형식의 운영 체제 업데이트 이미지입니다. https://github.com/openshift/enhancements/pull/1032에서 참조하십시오.

baseOSExtensionsContainerImage

string

baseOSExtensionsContainerImage는 새로운 형식 운영 체제 업데이트 이미지와 일치하는 확장 컨테이너입니다. https://github.com/openshift/enhancements/pull/1032에서 참조하십시오.

cloudProviderCAData

``

cloudprovider는 클라우드 공급자 CA 데이터를 지정합니다.

cloudProviderConfig

string

cloudProviderConfig는 지정된 클라우드 공급자의 구성입니다.

clusterDNSIP

string

clusterDNSIP는 클러스터 DNS IP 주소입니다.

dns

``

DNS에는 클러스터 dns 세부 정보가 있습니다.

etcdDiscoveryDomain

string

etcdDiscoveryDomain은 더 이상 사용되지 않으며 Infra.Status.EtcdDiscoveryDomain을 대신 사용하십시오.

이미지

오브젝트(문자열)

이미지는 컨트롤러에서 ./templates/ 아래의 템플릿을 렌더링하는 데 사용하는 이미지 맵입니다.

infra

``

인프라 세부 정보가 있는 인프라

ipFamilies

string

ipFamilies는 클러스터 네트워크에서 사용 중인 IP 제품군을 나타냅니다.

kubeAPIServerServingCAData

string

kubeAPIServerServingCAData managed Kubelet to API Server Cert…​ Rotated automatically

network

``

네트워크에 추가 네트워크 관련 정보가 포함되어 있습니다.

networkType

string

networkType은 클러스터에서 XXX를 사용하는 네트워크 유형을 보유하고 있습니다. 이는 일시적인 것이며 네트워크 관련 서비스를 적절한 방법으로 시작하는 데 더 나은 지원을 제공하기 위해 가능한 한 빨리 삭제됩니다. 클러스터가 가동되고 처음 실행되면 이 변경 사항도 변경하지 않으므로 이러한 변경 시 다시 생성을 허용하지 않습니다.

osImageURL

string

osImageURL은 OS 업데이트 페이로드가 포함된 컨테이너 이미지의 위치입니다. 해당 값은 machine-config-osimageurl ConfigMap의 data.osImageURL 필드에서 가져옵니다.

platform

string

Platform은 더 이상 사용되지 않으며, 대신 Infra.Status.PlatformStatus.Type을 사용하십시오.

proxy

``

proxy에는 노드의 현재 프록시 구성이 있습니다.

pullSecret

object

pullSecret은 모든 머신에 설치해야 하는 기본 풀 시크릿입니다.

releaseImage

string

releaseImage는 클러스터를 설치할 때 사용되는 이미지입니다.

rootCAData

string

rootCAData는 루트 CA 데이터를 지정합니다.

3.1.2. .spec.pullSecret

설명
pullSecret은 모든 머신에 설치해야 하는 기본 풀 시크릿입니다.
유형
object
속성유형설명

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

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

네임스페이스

string

참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

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

3.1.3. .status

설명
ControllerConfigStatus는 ControllerConfig의 상태입니다.
유형
object
속성유형설명

conditions

array

조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

ControllerConfigStatusCondition에는 ControllerConfigStatus에 대한 조건 정보가 포함되어 있습니다.

observedGeneration

integer

observedGeneration은 컨트롤러에서 관찰하는 생성을 나타냅니다.

3.1.4. .status.conditions

설명
조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형
array

3.1.5. .status.conditions[]

설명
ControllerConfigStatusCondition에는 ControllerConfigStatus에 대한 조건 정보가 포함되어 있습니다.
유형
object
필수 항목
  • status
  • type
속성유형설명

lastTransitionTime

``

lastTransitionTime은 현재 상태 개체에 대한 마지막 업데이트 시간입니다.

message

string

message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다.

reason

string

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

status

string

조건의 상태, True, False, 알 수 없음.

type

string

type은 Operator 조정 기능의 상태를 지정합니다.

3.2. API 끝점

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

  • /apis/machineconfiguration.openshift.io/v1/controllerconfigs

    • DELETE: ControllerConfig의 컬렉션 삭제
    • GET: 종류의 ControllerConfig 오브젝트 나열
    • POST: ControllerConfig 생성
  • /apis/machineconfiguration.openshift.io/v1/controllerconfigs/{name}

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

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

3.2.1. /apis/machineconfiguration.openshift.io/v1/controllerconfigs

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

ControllerConfigList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ControllerConfig 스키마

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

200 - OK

ControllerConfig 스키마

201 - 생성됨

ControllerConfig 스키마

202 - 승인됨

ControllerConfig 스키마

401 - 무단

3.2.2. /apis/machineconfiguration.openshift.io/v1/controllerconfigs/{name}

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

name

string

ControllerConfig의 이름

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ControllerConfig 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

ControllerConfig 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ControllerConfig 스키마

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

200 - OK

ControllerConfig 스키마

201 - 생성됨

ControllerConfig 스키마

401 - 무단

3.2.3. /apis/machineconfiguration.openshift.io/v1/controllerconfigs/{name}/status

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

name

string

ControllerConfig의 이름

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

string

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

HTTP 방법
GET
설명
지정된 ControllerConfig의 상태 확인
표 3.24. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ControllerConfig 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

ControllerConfig 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ControllerConfig 스키마

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

200 - OK

ControllerConfig 스키마

201 - 생성됨

ControllerConfig 스키마

401 - 무단

4장. ControlPlaneMachineSet [machine.openshift.io/v1]

설명
ControlPlaneMachineSet을 사용하면 지정된 수의 컨트롤 플레인 시스템 복제본이 언제든지 실행됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
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

ControlPlaneMachineSet은 ControlPlaneMachineSet의 구성을 나타냅니다.

status

object

ControlPlaneMachineSetStatus는 ControlPlaneMachineSet CRD의 상태를 나타냅니다.

4.1.1. .spec

설명
ControlPlaneMachineSet은 ControlPlaneMachineSet의 구성을 나타냅니다.
유형
object
필수 항목
  • replicas
  • 선택기
  • 템플릿
속성유형설명

replicas

integer

복제본은 이 ControlPlaneMachineSet에서 생성해야 하는 컨트롤 플레인 머신 수를 정의합니다. 이 필드는 변경할 수 없으며 클러스터 설치 후에는 변경할 수 없습니다. ControlPlaneMachineSet은 3개 또는 5개의 노드 컨트롤 플레인, 3 및 5에서만 작동합니다.

선택기

object

머신의 라벨 선택기입니다. 이 선택기에서 선택한 기존 머신은 이 ControlPlaneMachineSet의 영향을 받는 머신이 됩니다. 템플릿의 레이블과 일치해야 합니다. 이 필드는 리소스를 생성한 후 변경할 수 없는 것으로 간주됩니다.

상태

string

state는 ControlPlaneMachineSet이 Active 또는 Inactive인지 여부를 정의합니다. Inactive인 경우 ControlPlaneMachineSet은 클러스터 내의 머신 상태에 대해 작업을 수행하지 않습니다. Active인 경우 ControlPlaneMachineSet은 머신을 조정하고 필요에 따라 머신을 업데이트합니다. 활성 후에는 ControlPlaneMachineSet을 Inactive로 만들 수 없습니다. 추가 작업을 방지하려면 ControlPlaneMachineSet을 제거하십시오.

전략

object

strategy는 ProviderSpec의 변경 사항을 감지하면 ControlPlaneMachineSet이 머신을 업데이트하는 방법을 정의합니다.

템플릿

object

템플릿은 이 ControlPlaneMachineSet에서 생성할 컨트롤 플레인 머신을 설명합니다.

4.1.2. .spec.selector

설명
머신의 라벨 선택기입니다. 이 선택기에서 선택한 기존 머신은 이 ControlPlaneMachineSet의 영향을 받는 머신이 됩니다. 템플릿의 레이블과 일치해야 합니다. 이 필드는 리소스를 생성한 후 변경할 수 없는 것으로 간주됩니다.
유형
object
속성유형설명

matchExpressions

array

matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.

matchExpressions[]

object

레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchLabels

오브젝트(문자열)

matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다.

4.1.3. .spec.selector.matchExpressions

설명
matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
유형
array

4.1.4. .spec.selector.matchExpressions[]

설명
레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

key는 선택기가 적용되는 라벨 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.

배열(문자열)

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

4.1.5. .spec.strategy

설명
strategy는 ProviderSpec의 변경 사항을 감지하면 ControlPlaneMachineSet이 머신을 업데이트하는 방법을 정의합니다.
유형
object
속성유형설명

type

string

type은 ControlPlaneMachineSet이 소유한 머신을 업데이트할 때 사용해야 하는 업데이트 전략 유형을 정의합니다. 유효한 값은 "RollingUpdate" 및 "OnDelete"입니다. 현재 기본값은 "RollingUpdate"입니다.

4.1.6. .spec.template

설명
템플릿은 이 ControlPlaneMachineSet에서 생성할 컨트롤 플레인 머신을 설명합니다.
유형
object
필수 항목
  • machineType
속성유형설명

machineType

string

MachineType은 ControlPlaneMachineSet에서 관리해야 하는 머신 유형을 결정합니다. 현재 유효한 값은 machine_v1beta1_machine_openshift_io입니다.

machines_v1beta1_machine_openshift_io

object

OpenShiftMachineV1Beta1Machine은 v1beta1.machine.openshift.io API 그룹에서 머신을 생성하기 위한 템플릿을 정의합니다.

4.1.7. .spec.template.machines_v1beta1_machine_openshift_io

설명
OpenShiftMachineV1Beta1Machine은 v1beta1.machine.openshift.io API 그룹에서 머신을 생성하기 위한 템플릿을 정의합니다.
유형
object
필수 항목
  • 메타데이터
  • spec
속성유형설명

failureDomains

object

FailureDomains는 ControlPlaneMachineSet이 컨트롤 플레인 머신의 균형을 유지해야 하는 실패 도메인 목록(때로 가용성 영역이라고 함)입니다. 이는 템플릿에 지정된 ProviderSpec에 병합됩니다. 이 필드는 배치 정보가 필요하지 않은 플랫폼에서 선택 사항입니다.

메타데이터

object

ObjectMeta는 표준 오브젝트 메타데이터입니다. https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 레이블은 ControlPlaneMachineSet 선택기와 일치해야 합니다.

spec

object

spec에는 원하는 컨트롤 플레인 머신 구성이 포함되어 있습니다. 내부 ProviderSpec에는 컨트롤 플레인 머신을 생성하기 위한 플랫폼별 세부 정보가 포함되어 있습니다. ProviderSe는 플랫폼별 실패 도메인 필드와는 별도로 완료되어야 합니다. FailureDomains 필드를 기반으로 머신이 생성될 때 재정의됩니다.

4.1.8. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains

설명
FailureDomains는 ControlPlaneMachineSet이 컨트롤 플레인 머신의 균형을 유지해야 하는 실패 도메인 목록(때로 가용성 영역이라고 함)입니다. 이는 템플릿에 지정된 ProviderSpec에 병합됩니다. 이 필드는 배치 정보가 필요하지 않은 플랫폼에서 선택 사항입니다.
유형
object
필수 항목
  • platform
속성유형설명

AWS

array

AWS는 AWS 플랫폼에 대한 장애 도메인 정보를 구성합니다.

aws[]

object

AWSFailureDomain은 AWS 플랫폼에 대한 장애 도메인 정보를 구성합니다.

azure

array

Azure는 Azure 플랫폼에 대한 장애 도메인 정보를 구성합니다.

azure[]

object

AzureFailureDomain은 Azure 플랫폼에 대한 장애 도메인 정보를 구성합니다.

gcp

array

GCP는 GCP 플랫폼에 대한 장애 도메인 정보를 구성합니다.

gcp[]

object

GCPFailureDomain에서 GCP 플랫폼에 대한 장애 도메인 정보 구성

platform

string

플랫폼은 FailureDomain이 나타내는 플랫폼을 식별합니다. 현재 지원되는 값은 AWS, Azure, GCP입니다.

4.1.9. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws

설명
AWS는 AWS 플랫폼에 대한 장애 도메인 정보를 구성합니다.
유형
array

4.1.10. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws[]

설명
AWSFailureDomain은 AWS 플랫폼에 대한 장애 도메인 정보를 구성합니다.
유형
object
속성유형설명

배치

object

배치는 이 인스턴스에 대한 배치 정보를 구성합니다.

서브넷

object

subnet은 이 인스턴스에 사용할 서브넷에 대한 참조입니다.

4.1.11. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws[].placement

설명
배치는 이 인스턴스에 대한 배치 정보를 구성합니다.
유형
object
필수 항목
  • availabilityZone
속성유형설명

availabilityZone

string

AvailabilityZone은 인스턴스의 가용성 영역입니다.

4.1.12. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws[].subnet

설명
subnet은 이 인스턴스에 사용할 서브넷에 대한 참조입니다.
유형
object
필수 항목
  • type
속성유형설명

ARN

string

리소스의 ARN입니다.

filters

array

필터는 리소스를 식별하는 데 사용되는 필터 세트입니다.

filters[]

object

AWSResourceFilter는 AWS 리소스를 식별하는 데 사용되는 필터입니다.

id

string

리소스의 ID입니다.

type

string

type은 참조가 AWS 리소스를 가져오는 방법을 결정합니다.

4.1.13. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws[].subnet.filters

설명
필터는 리소스를 식별하는 데 사용되는 필터 세트입니다.
유형
array

4.1.14. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws[].subnet.filters[]

설명
AWSResourceFilter는 AWS 리소스를 식별하는 데 사용되는 필터입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

필터의 이름입니다. 필터 이름은 대소문자를 구분합니다.

배열(문자열)

값에는 하나 이상의 필터 값이 포함됩니다. 필터 값은 대소문자를 구분합니다.

4.1.15. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.azure

설명
Azure는 Azure 플랫폼에 대한 장애 도메인 정보를 구성합니다.
유형
array

4.1.16. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.azure[]

설명
AzureFailureDomain은 Azure 플랫폼에 대한 장애 도메인 정보를 구성합니다.
유형
object
필수 항목
  • 영역
속성유형설명

영역

string

가상 머신의 가용성 영역입니다. nil인 경우 가상 시스템을 영역 없음에 배포해야 합니다.

4.1.17. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.gcp

설명
GCP는 GCP 플랫폼에 대한 장애 도메인 정보를 구성합니다.
유형
array

4.1.18. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.gcp[]

설명
GCPFailureDomain에서 GCP 플랫폼에 대한 장애 도메인 정보 구성
유형
object
필수 항목
  • 영역
속성유형설명

영역

string

zone은 GCP 머신 공급자가 VM을 생성할 영역입니다.

4.1.19. .spec.template.machines_v1beta1_machine_openshift_io.metadata

설명
ObjectMeta는 표준 오브젝트 메타데이터입니다. https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 레이블은 ControlPlaneMachineSet 선택기와 일치해야 합니다.
유형
object
필수 항목
  • labels
속성유형설명

annotations

오브젝트(문자열)

주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/annotations

labels

오브젝트(문자열)

개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/labels. 이 필드에는 값이 'master'인 'machine.openshift.io/cluster-api-machine-role' 레이블과 'machine.openshift.io/cluster-api-machine-type' 라벨이 모두 포함되어야 합니다. 'machine.openshift.io/cluster-api-cluster' 키가 있는 레이블도 포함해야 합니다.

4.1.20. .spec.template.machines_v1beta1_machine_openshift_io.spec

설명
spec에는 원하는 컨트롤 플레인 머신 구성이 포함되어 있습니다. 내부 ProviderSpec에는 컨트롤 플레인 머신을 생성하기 위한 플랫폼별 세부 정보가 포함되어 있습니다. ProviderSe는 플랫폼별 실패 도메인 필드와는 별도로 완료되어야 합니다. FailureDomains 필드를 기반으로 머신이 생성될 때 재정의됩니다.
유형
object
속성유형설명

lifecycleHooks

object

LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다.

메타데이터

object

ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다.

providerID

string

providerID는 공급자가 제공하는 머신의 ID입니다. 이 필드는 이 머신에 해당하는 노드 오브젝트에 표시된 공급자 ID와 일치해야 합니다. 이 필드는 cluster-api의 상위 수준 소비자에 필요합니다. 사용 사례는 cluster-api가 공급자인 클러스터 자동 스케일러입니다. 자동 스케일러의 정리 논리는 머신을 노드와 비교하여 Kubernetes 노드로 등록할 수 없는 공급자의 시스템을 찾습니다. 자동 스케일러의 일반 out-of-tree 공급자인 cluster-api를 사용하면 자동 스케일러에 시스템 목록의 공급자 보기를 사용할 수 있어야 합니다. k8s apiserver에서 다른 노드 목록을 쿼리한 다음, 등록되지 않은 시스템을 확인하기 위해 비교가 수행되며 삭제로 표시됩니다. 이 필드는 액추에이터에 의해 설정되며 일반 공급자로서 cluster-api와 상호 작용할 자동 스케일러와 같은 상위 수준 엔티티에서 사용합니다.

providerSpec

object

노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다.

테인트

array

추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다.

taints[]

object

이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다.

4.1.21. .spec.template.machines_v1beta1_machine_openshift_io.spec.lifecycleHooks

설명
LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다.
유형
object
속성유형설명

preDrain

array

PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다.

preDrain[]

object

LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.

preTerminate

array

사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다.

preTerminate[]

object

LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.

4.1.22. .spec.template.machines_v1beta1_machine_openshift_io.spec.lifecycleHooks.preDrain

설명
PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다.
유형
array

4.1.23. .spec.template.machines_v1beta1_machine_openshift_io.spec.lifecycleHooks.preDrain[]

설명
LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
유형
object
필수 항목
  • name
  • 소유자
속성유형설명

name

string

name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다.

소유자

string

owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다.

4.1.24. .spec.template.machines_v1beta1_machine_openshift_io.spec.lifecycleHooks.preTerminate

설명
사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다.
유형
array

4.1.25. .spec.template.machines_v1beta1_machine_openshift_io.spec.lifecycleHooks.preTerminate[]

설명
LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
유형
object
필수 항목
  • name
  • 소유자
속성유형설명

name

string

name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다.

소유자

string

owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다.

4.1.26. .spec.template.machines_v1beta1_machine_openshift_io.spec.metadata

설명
ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다.
유형
object
속성유형설명

annotations

오브젝트(문자열)

주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/annotations

generateName

string

generateName은 서버에서 사용하는 선택적 접두사로, Name 필드가 제공되지 않은 고유한 이름만 생성하는 데 사용됩니다. 이 필드를 사용하면 클라이언트에 반환되는 이름이 전달된 이름과 다릅니다. 이 값은 고유한 접미사와 결합됩니다. 제공된 값은 Name 필드와 동일한 검증 규칙을 가지며 서버에서 고유 값을 만드는 데 필요한 접미사 길이로 잘릴 수 있습니다. 이 필드가 지정되고 생성된 이름이 있는 경우 서버는 409를 반환하지 않습니다. 대신 201 Created 또는 500을 반환합니다. Reason ServerTimeout은 할당된 시간에 고유 이름을 찾을 수 없으며 클라이언트가 재시도해야 함을 나타냅니다(선택적으로 Retry-After 헤더에 표시된 시간 후). Name이 지정되지 않은 경우에만 적용됩니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency

labels

오브젝트(문자열)

개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/labels

name

string

이름은 네임스페이스 내에서 고유해야 합니다. 일부 리소스는 클라이언트가 적절한 이름의 생성을 자동으로 요청할 수 있지만 리소스를 생성할 때 필요합니다. 이름은 주로 생성 멱등 및 구성 정의를 위한 것입니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names

네임스페이스

string

namespace는 각 이름 내의 공간을 고유해야 합니다. 빈 네임스페이스는 "default" 네임스페이스와 동일하지만 "default"는 표준 표현입니다. 모든 오브젝트의 범위를 네임스페이스로 지정해야 하는 것은 아닙니다. 해당 오브젝트에 대한 이 필드의 값은 비어 있습니다. DNS_LABEL이어야 합니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/namespaces

ownerReferences

array

이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.

ownerReferences[]

object

OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.

4.1.27. .spec.template.machines_v1beta1_machine_openshift_io.spec.metadata.ownerReferences

설명
이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.
유형
array

4.1.28. .spec.template.machines_v1beta1_machine_openshift_io.spec.metadata.ownerReferences[]

설명
OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.
유형
object
필수 항목
  • apiVersion
  • kind
  • name
  • uid
속성유형설명

apiVersion

string

참조의 API 버전입니다.

blockOwnerDeletion

boolean

If true, and if the owner has the "foreworkspaceDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. 가비지 수집기가 이 필드와 상호 작용하고 전경 삭제를 적용하는 방법은 https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion 를 참조하십시오. 기본값은 false입니다. 이 필드를 설정하려면 사용자에게 소유자의 "삭제" 권한이 필요하며, 그렇지 않으면 422(프로세스할 수 없는 엔티티)가 반환됩니다.

컨트롤러

boolean

true인 경우 이 참조는 관리 컨트롤러를 가리킵니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

추천자의 이름입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names

uid

string

참조의 UID입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#uids

4.1.29. .spec.template.machines_v1beta1_machine_openshift_io.spec.providerSpec

설명
노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다.
유형
object
속성유형설명

value

``

value는 리소스 구성을 인라인으로 직렬화한 표현입니다. 공급자는 이 필드에서 직렬화/직렬화해야 하는 자체 버전이 지정된 API 유형을 구성 요소와 유사한 상태로 유지하는 것이 좋습니다.

4.1.30. .spec.template.machines_v1beta1_machine_openshift_io.spec.taints

설명
추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다.
유형
array

4.1.31. .spec.template.machines_v1beta1_machine_openshift_io.spec.taints[]

설명
이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다.
유형
object
필수 항목
  • effect
  • key
속성유형설명

effect

string

필수 항목입니다. 테인트를 허용하지 않는 pod에 테인트의 영향을 미칩니다. 유효한 영향은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

key

string

필수 항목입니다. 노드에 적용할 taint 키입니다.

timeAdded

string

TimeAdded는 테인트가 추가된 시간을 나타냅니다. NoExecute 테인트에만 작성됩니다.

value

string

taint 키에 해당하는 taint 값입니다.

4.1.32. .status

설명
ControlPlaneMachineSetStatus는 ControlPlaneMachineSet CRD의 상태를 나타냅니다.
유형
object
속성유형설명

conditions

array

조건은 ControlPlaneMachineSet의 현재 상태를 관찰합니다. 알려진 .status.conditions.type은 Available, Degraded, Progressing입니다.

conditions[]

object

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

observedGeneration

integer

observedGeneration은 이 ControlPlaneMachineSet에서 관찰되는 가장 최근 세대입니다. 이는 API 서버에서 변경 시 업데이트되는 ControlPlaneMachineSets의 생성에 해당합니다.

readyReplicas

integer

readyReplicas는 준비된 ControlPlaneMachineSet 컨트롤러에서 생성한 컨트롤 플레인 머신 수입니다. 롤링 업데이트가 진행 중인 상태에서 이 값은 원하는 복제본 수보다 클 수 있습니다.

replicas

integer

replicas는 ControlPlaneMachineSet 컨트롤러에서 생성한 컨트롤 플레인 머신 수입니다. 업데이트 작업 중에 이 값은 원하는 복제본 수와 다를 수 있습니다.

unavailableReplicas

integer

UnavailableReplicas는 ControlPlaneMachineSet이 원하는 용량에 도달하기 전에 여전히 필요한 컨트롤 플레인 머신의 수입니다. 이 값이 0이 아닌 경우 ReadyReplicas 수는 원하는 Replicas보다 적습니다.

updatedReplicas

integer

UpdatedReplicas는 원하는 공급자 사양이 있고 준비되는 ControlPlaneMachineSet 컨트롤러에서 생성한 종료되지 않은 컨트롤 플레인 머신의 수입니다. 이 값은 원하는 사양으로 변경 사항이 감지되면 0으로 설정됩니다. 업데이트 전략이 RollingUpdate인 경우 머신 업데이트 프로세스 시작과도 일치합니다. 업데이트 전략이 OnDelete이면 이 값은 사용자가 기존 복제본을 삭제하고 교체가 준비될 때까지 0으로 유지됩니다.

4.1.33. .status.conditions

설명
조건은 ControlPlaneMachineSet의 현재 상태를 관찰합니다. 알려진 .status.conditions.type은 Available, Degraded, Progressing입니다.
유형
array

4.1.34. .status.conditions[]

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

lastTransitionTime

string

lastTransitionTime은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.

message

string

message는 변환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.

observedGeneration

integer

observedGeneration은 조건에 따라 설정된 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 현재 인스턴스 상태와 관련된 조건이 최신 상태가 아닙니다.

reason

string

이유에는 조건의 마지막 전환 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 예상되는 값과 의미를 정의할 수 있으며 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있지 않을 수 있습니다.

status

string

조건의 상태, True, False, 알 수 없음.

type

string

CamelCase 또는 foo.example.com/CamelCase의 조건 유형. --- many .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다. 정규 표현식이 일치하는 정규 표현식은 (dns1123SubdomainFmt/)?(qualifiedNameFmt)입니다.

4.2. API 끝점

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

  • /apis/machine.openshift.io/v1/controlplanemachinesets

    • GET: 종류의 ControlPlaneMachineSet의 오브젝트 나열
  • /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets

    • DELETE: ControlPlaneMachineSet의 컬렉션 삭제
    • GET: 종류의 ControlPlaneMachineSet의 오브젝트 나열
    • POST: ControlPlaneMachineSet 생성
  • /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}

    • DELETE: ControlPlaneMachineSet 삭제
    • GET: 지정된 ControlPlaneMachineSet 읽기
    • PATCH: 지정된 ControlPlaneMachineSet을 부분적으로 업데이트
    • PUT: 지정된 ControlPlaneMachineSet을 교체합니다.
  • /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}/scale

    • GET: 지정된 ControlPlaneMachineSet의 읽기 스케일링
    • PATCH: 지정된 ControlPlaneMachineSet의 부분 업데이트 규모
    • PUT: 지정된 ControlPlaneMachineSet의 스케일링을 교체
  • /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}/status

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

4.2.1. /apis/machine.openshift.io/v1/controlplanemachinesets

표 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

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

제한

integer

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

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

string

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

HTTP 방법
GET
설명
종류의 ControlPlaneMachineSet의 오브젝트 나열
표 4.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ControlPlaneMachineSetList schema

401 - 무단

4.2.2. /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets

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

네임스페이스

string

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

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류의 ControlPlaneMachineSet의 오브젝트 나열
표 4.7. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

ControlPlaneMachineSetList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ControlPlaneMachineSet schema

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

200 - OK

ControlPlaneMachineSet schema

201 - 생성됨

ControlPlaneMachineSet schema

202 - 승인됨

ControlPlaneMachineSet schema

401 - 무단

4.2.3. /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}

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

name

string

ControlPlaneMachineSet의 이름

네임스페이스

string

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

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

string

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

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

dryRun

string

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

gracePeriodSeconds

integer

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

orphanDependents

boolean

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

propagationPolicy

string

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ControlPlaneMachineSet schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

ControlPlaneMachineSet schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ControlPlaneMachineSet schema

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

200 - OK

ControlPlaneMachineSet schema

201 - 생성됨

ControlPlaneMachineSet schema

401 - 무단

4.2.4. /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}/scale

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

name

string

ControlPlaneMachineSet의 이름

네임스페이스

string

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

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

string

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

HTTP 방법
GET
설명
지정된 ControlPlaneMachineSet의 스케일링
표 4.27. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

스케일링 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

스케일링 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

스케일링 스키마

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

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

4.2.5. /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}/status

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

name

string

ControlPlaneMachineSet의 이름

네임스페이스

string

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

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ControlPlaneMachineSet schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

ControlPlaneMachineSet schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

ControlPlaneMachineSet schema

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

200 - OK

ControlPlaneMachineSet schema

201 - 생성됨

ControlPlaneMachineSet schema

401 - 무단

5장. KubeletConfig [machineconfiguration.openshift.io/v1]

설명
KubeletConfig는 사용자 지정 Kubelet 구성을 설명합니다.
유형
object
필수 항목
  • spec

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

KubeletConfigSpec은 원하는 KubeletConfig 상태를 정의합니다.

status

object

KubeletConfigStatus는 KubeletConfig의 관찰 상태를 정의합니다.

5.1.1. .spec

설명
KubeletConfigSpec은 원하는 KubeletConfig 상태를 정의합니다.
유형
object
속성유형설명

autoSizingReserved

boolean

최적의 시스템 예약

kubeletConfig

``

kubelet 구성 필드는 kubernetes 업스트림에 정의되어 있습니다. 업스트림 kubernetes의 OpenShift에서 사용하는 버전/커밋에 정의된 유형을 참조하십시오. kubelet 구성 필드는 업스트림에서 직접 가져온 것이므로 해당 값의 검증은 kubelet에 의해 직접 처리됩니다. 이러한 필드의 유효한 값은 relavent kubernetes의 업스트림 버전을 참조하십시오. kubelet 구성 필드의 잘못된 값은 클러스터 노드를 사용할 수 없게 될 수 있습니다.

logLevel

integer

loglevel은 Kubelet의 로그 수준을 정의합니다.

machineConfigPoolSelector

object

레이블 선택기는 리소스 집합에 대한 레이블 쿼리입니다. matchLabels 및 matchExpressions의 결과는 ANDed입니다. 빈 라벨 선택기는 모든 오브젝트와 일치합니다. null 라벨 선택기는 오브젝트와 일치하지 않습니다.

tlsSecurityProfile

object

tlsSecurityProfile은 ingresscontrollers의 TLS 연결 설정을 지정합니다. 설정되지 않은 경우 기본값은 apiservers.config.openshift.io/cluster 리소스를 기반으로 합니다. Old, Intermediate 및 Modern 프로파일 유형을 사용하는 경우 유효한 프로파일 구성은 릴리스마다 변경될 수 있습니다. 예를 들어 릴리스 X.Y.Z에 배포된 Intermediate 프로파일을 사용하기 위한 사양이 있는 경우 릴리스 X.Y.Z+1로 업그레이드하면 새 프로필 구성이 Ingress 컨트롤러에 적용되어 롤아웃이 발생할 수 있습니다. Ingress 컨트롤러의 최소 TLS 버전은 1.1이며 최대 TLS 버전은 1.2입니다. 이 제한 사항은 TLS 1.3이 필요하므로 Modern TLS 프로필 유형을 사용할 수 없다는 것입니다.

5.1.2. .spec.machineConfigPoolSelector

설명
레이블 선택기는 리소스 집합에 대한 레이블 쿼리입니다. matchLabels 및 matchExpressions의 결과는 ANDed입니다. 빈 라벨 선택기는 모든 오브젝트와 일치합니다. null 라벨 선택기는 오브젝트와 일치하지 않습니다.
유형
object
속성유형설명

matchExpressions

array

matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.

matchExpressions[]

object

레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchLabels

오브젝트(문자열)

matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다.

5.1.3. .spec.machineConfigPoolSelector.matchExpressions

설명
matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
유형
array

5.1.4. .spec.machineConfigPoolSelector.matchExpressions[]

설명
레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

key는 선택기가 적용되는 라벨 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.

배열(문자열)

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

5.1.5. .spec.tlsSecurityProfile

설명
tlsSecurityProfile은 ingresscontrollers의 TLS 연결 설정을 지정합니다. 설정되지 않은 경우 기본값은 apiservers.config.openshift.io/cluster 리소스를 기반으로 합니다. Old, Intermediate 및 Modern 프로파일 유형을 사용하는 경우 유효한 프로파일 구성은 릴리스마다 변경될 수 있습니다. 예를 들어 릴리스 X.Y.Z에 배포된 Intermediate 프로파일을 사용하기 위한 사양이 있는 경우 릴리스 X.Y.Z+1로 업그레이드하면 새 프로필 구성이 Ingress 컨트롤러에 적용되어 롤아웃이 발생할 수 있습니다. Ingress 컨트롤러의 최소 TLS 버전은 1.1이며 최대 TLS 버전은 1.2입니다. 이 제한 사항은 TLS 1.3이 필요하므로 Modern TLS 프로필 유형을 사용할 수 없다는 것입니다.
유형
object
속성유형설명

Custom

``

Custom은 사용자 정의 TLS 보안 프로필입니다. 잘못된 구성으로 사용자 지정 프로필을 사용하는 것은 치명적일 수 있습니다. 사용자 정의 프로파일의 예는 다음과 같습니다: - ECDHE-ECDSA-CHACHA20-POLY1305 - ECDHE-RSA-CHACHA20-POLY1305 - ECDHE-RSA-AES128-GCM-SHA256 - ECDHE-ECDSA-AES128-GCM-SHA256 minTLSVersion: TLSv1.1

Intermediate

``

Intermediate는 다음을 기반으로 하는 TLS 보안 프로필입니다. https://wiki.mozilla.org/Security/Server_Side_TLS#Intermediate_compatibility_.28recommended.29 및 looks like this (yaml): 암호화: - TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 - TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 - TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 - TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 - TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 - TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 minTLSVersion: TLSv1.2

Modern

``

modern는 https://wiki.mozilla.org/Security/Server_Side_TLS#Modern_compatibility 기반 TLS 보안 프로필입니다. (yaml): 암호화: - TLS_AES_128_GCM_SHA256 - TLS_AES_256_GCM_SHA384 - TLS_CHACHA20_POLY1305_POLY1305_SHA256 minTLSVersion: TLSv1.3 참고: 현재 지원되지 않습니다.

Old

``

Old는 다음을 기반으로 하는 TLS 보안 프로필입니다. https://wiki.mozilla.org/Security/Server_Side_TLS#Old_backward_compatibility 및 looks like this (yaml): 암호화: - TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 - TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 - TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 - TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 - TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 - tls_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 - TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256_WITH_AES_128_CBC_WITH_AES_128_CBC_SHA256_WITH_AES_128_CBC_ECDSA_WITH_AES_128_CBC_SHA256_WITH_AES_128_SHA256_WITH - TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA - TLS_ECDHE_ECDSA_WITH_AES_256_SHA - TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA - TLS_RSA_WITH_AES_128_GCM_SHA256 - TLS_RSA_WITH_RSA_WITH_AES_256_GCM_SHA384 - TLS_RSA_WITH_AES_128_CBC_SHA - TLS_RSA_WITH_AES_128_CBC_SHA - TLS_RSA_WITH_AES_256_CBC_SHA - TLS_RSA_WITH_3DES_EDE_CBC_SHA minTLSVersion: TLSv1.0

type

string

type은 Old, Intermediate, Modern 또는 Custom 중 하나입니다. Custom은 개별 TLS 보안 프로파일 매개변수를 지정하는 기능을 제공합니다. 이전, Intermediate 및 Modern는 다음을 기반으로 하는 TLS 보안 프로필입니다. https://wiki.mozilla.org/Security/Server_Side_TLS#Recommended_configurations 프로필은 의도 기반이므로 새 암호가 개발되고 기존 암호가 안전하지 않은 것으로 확인되면 시간이 지남에 따라 변경될 수 있습니다. 프로세스에서 사용할 수 있는 암호에 따라 목록이 줄어들 수 있습니다. Modern 프로파일은 아직 공통 소프트웨어 라이브러리에서 잘 채택되지 않았기 때문에 현재 지원되지 않습니다.

5.1.6. .status

설명
KubeletConfigStatus는 KubeletConfig의 관찰 상태를 정의합니다.
유형
object
속성유형설명

conditions

array

조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

KubeletConfigCondition은 KubeletConfig의 상태를 정의합니다.

observedGeneration

integer

observedGeneration은 컨트롤러에서 관찰하는 생성을 나타냅니다.

5.1.7. .status.conditions

설명
조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형
array

5.1.8. .status.conditions[]

설명
KubeletConfigCondition은 KubeletConfig의 상태를 정의합니다.
유형
object
속성유형설명

lastTransitionTime

``

lastTransitionTime은 현재 상태 개체에 대한 마지막 업데이트 시간입니다.

message

string

message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다.

reason

string

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

status

string

조건의 상태, True, False, 알 수 없음.

type

string

type은 Operator 조정 기능의 상태를 지정합니다.

5.2. API 끝점

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

  • /apis/machineconfiguration.openshift.io/v1/kubeletconfigs

    • DELETE: KubeletConfig의 컬렉션 삭제
    • GET: kind KubeletConfig의 오브젝트 나열
    • POST: KubeletConfig 생성
  • /apis/machineconfiguration.openshift.io/v1/kubeletconfigs/{name}

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

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

5.2.1. /apis/machineconfiguration.openshift.io/v1/kubeletconfigs

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

KubeletConfigList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

KubeletConfig schema

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

200 - OK

KubeletConfig schema

201 - 생성됨

KubeletConfig schema

202 - 승인됨

KubeletConfig schema

401 - 무단

5.2.2. /apis/machineconfiguration.openshift.io/v1/kubeletconfigs/{name}

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

name

string

KubeletConfig의 이름

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

KubeletConfig schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

KubeletConfig schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

KubeletConfig schema

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

200 - OK

KubeletConfig schema

201 - 생성됨

KubeletConfig schema

401 - 무단

5.2.3. /apis/machineconfiguration.openshift.io/v1/kubeletconfigs/{name}/status

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

name

string

KubeletConfig의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

KubeletConfig schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

KubeletConfig schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

KubeletConfig schema

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

200 - OK

KubeletConfig schema

201 - 생성됨

KubeletConfig schema

401 - 무단

6장. MachineConfigPool [machineconfiguration.openshift.io/v1]

설명
MachineConfigPool은 MachineConfigs 풀을 설명합니다.
유형
object

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

MachineConfigPoolSpec은 MachineConfigPool 리소스의 사양입니다.

status

object

MachineConfigPoolStatus는 MachineConfigPool 리소스의 상태입니다.

6.1.1. .spec

설명
MachineConfigPoolSpec은 MachineConfigPool 리소스의 사양입니다.
유형
object
속성유형설명

configuration

object

머신 구성 풀의 대상 MachineConfig 오브젝트입니다.

machineConfigSelector

object

machineConfigSelector는 MachineConfig에 대한 라벨 선택기를 지정합니다. 레이블 및 선택기 작동 방법에 대한 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/ 를 참조하십시오.

maxUnavailable

integer-or-string

maxUnavailable은 해당 풀에서 정수 수 또는 백분율로, 업데이트 중에 사용할 수 없음으로 이동할 수 있는 노드를 정의합니다. 여기에는 사용자 시작 코드, 실패한 노드 등을 포함하여 어떠한 이유로든 사용할 수 없는 노드가 포함됩니다. 기본값은 1입니다. 1보다 큰 값은 업데이트 중에 사용할 수 없는 여러 노드를 의미하며, 이는 나머지 노드에서 워크로드 부하에 영향을 미칠 수 있습니다. 업데이트를 중지하려면 이 값을 0으로 설정할 수 없습니다(기본값은 1); 업데이트를 중지하려면 대신 '중지됨' 속성을 사용합니다. drain은 maxUnavailable이 하나 이상인 경우에도 etcd 쿼럼 가드와 같은 PDB (Pod Disruption Budgets)를 준수합니다.

nodeSelector

object

nodeSelector는 머신의 라벨 선택기를 지정합니다.

일시 중지됨

boolean

paused는 이 머신 구성 풀의 변경 사항을 중지해야 하는지 여부를 지정합니다. 여기에는 새로운 원하는MachineConfig 생성 및 머신 업데이트가 포함됩니다.

6.1.2. .spec.configuration

설명
머신 구성 풀의 대상 MachineConfig 오브젝트입니다.
유형
object
속성유형설명

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

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

네임스페이스

string

참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

소스

array

source는 콘텐츠에 지정된 단일 MachineConfig 오브젝트를 생성하는 데 사용된 MachineConfig 오브젝트 목록입니다.

source[]

object

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

uid

string

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

6.1.3. .spec.configuration.source

설명
source는 콘텐츠에 지정된 단일 MachineConfig 오브젝트를 생성하는 데 사용된 MachineConfig 오브젝트 목록입니다.
유형
array

6.1.4. .spec.configuration.source[]

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

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

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

네임스페이스

string

참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

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

6.1.5. .spec.machineConfigSelector

설명
machineConfigSelector는 MachineConfig에 대한 라벨 선택기를 지정합니다. 레이블 및 선택기 작동 방법에 대한 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/ 를 참조하십시오.
유형
object
속성유형설명

matchExpressions

array

matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.

matchExpressions[]

object

레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchLabels

오브젝트(문자열)

matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다.

6.1.6. .spec.machineConfigSelector.matchExpressions

설명
matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
유형
array

6.1.7. .spec.machineConfigSelector.matchExpressions[]

설명
레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

key는 선택기가 적용되는 라벨 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.

배열(문자열)

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

6.1.8. .spec.nodeSelector

설명
nodeSelector는 머신의 라벨 선택기를 지정합니다.
유형
object
속성유형설명

matchExpressions

array

matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.

matchExpressions[]

object

레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchLabels

오브젝트(문자열)

matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다.

6.1.9. .spec.nodeSelector.matchExpressions

설명
matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
유형
array

6.1.10. .spec.nodeSelector.matchExpressions[]

설명
레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

key는 선택기가 적용되는 라벨 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.

배열(문자열)

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

6.1.11. .status

설명
MachineConfigPoolStatus는 MachineConfigPool 리소스의 상태입니다.
유형
object
속성유형설명

conditions

array

조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

MachineConfigPoolCondition에는 MachineConfigPool에 대한 조건 정보가 포함되어 있습니다.

configuration

object

구성은 머신 구성 풀의 현재 MachineConfig 오브젝트를 나타냅니다.

degradedMachineCount

integer

degradedMachineCount는 성능이 저하된 머신의 총 수를 나타냅니다(또는 호환되지 않음). 구성을 적용하는 데 실패한 경우 노드가 성능이 저하된 것으로 표시됩니다.

machineCount

integer

MACHINECOUNT는 머신 구성 풀의 총 머신 수를 나타냅니다.

observedGeneration

integer

observedGeneration은 컨트롤러에서 관찰하는 생성을 나타냅니다.

readyMachineCount

integer

readyMachineCount는 풀을 대상으로 하는 준비된 총 머신 수를 나타냅니다.

unavailableMachineCount

integer

unavailableMachineCount는 풀에서 대상으로 하는 사용 불가능한 (준비되지 않은) 머신의 총 수를 나타냅니다. 상태가 업데이트되었거나 NodeReady 조건이 false인 경우 노드를 사용할 수 없음으로 표시됩니다.

updatedMachineCount

integer

UPDATEDMACHINECOUNT는 Pool에서 대상으로 하는 총 머신 수를 나타내는 CurrentMachineConfig를 해당 구성으로 설정합니다.

6.1.12. .status.conditions

설명
조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형
array

6.1.13. .status.conditions[]

설명
MachineConfigPoolCondition에는 MachineConfigPool에 대한 조건 정보가 포함되어 있습니다.
유형
object
속성유형설명

lastTransitionTime

``

lastTransitionTime은 이 조건의 마지막 상태 변경에 해당하는 타임스탬프입니다.

message

string

message는 마지막 전환에 대한 세부 정보에 대해 사람이 읽을 수 있는 설명으로, 이유를 보완합니다.

reason

string

이유는 조건의 마지막 전환에 대한 간단한 머신에서 읽을 수 있는 설명입니다.

status

string

조건의 상태, ('True', 'False', '알 수 없음') 중 하나입니다.

type

string

조건의 유형 (''Done', 'Updating', 'Failed')

6.1.14. .status.configuration

설명
구성은 머신 구성 풀의 현재 MachineConfig 오브젝트를 나타냅니다.
유형
object
속성유형설명

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

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

네임스페이스

string

참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

소스

array

source는 콘텐츠에 지정된 단일 MachineConfig 오브젝트를 생성하는 데 사용된 MachineConfig 오브젝트 목록입니다.

source[]

object

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

uid

string

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

6.1.15. .status.configuration.source

설명
source는 콘텐츠에 지정된 단일 MachineConfig 오브젝트를 생성하는 데 사용된 MachineConfig 오브젝트 목록입니다.
유형
array

6.1.16. .status.configuration.source[]

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

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

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

네임스페이스

string

참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

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

6.2. API 끝점

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

  • /apis/machineconfiguration.openshift.io/v1/machineconfigpools

    • DELETE: MachineConfigPool의 컬렉션 삭제
    • GET: 종류 MachineConfigPool의 오브젝트 나열
    • POST: MachineConfigPool 생성
  • /apis/machineconfiguration.openshift.io/v1/machineconfigpools/{name}

    • DELETE: MachineConfigPool 삭제
    • GET: 지정된 MachineConfigPool 읽기
    • PATCH: 지정된 MachineConfigPool을 부분적으로 업데이트
    • PUT: 지정된 MachineConfigPool을 교체합니다.
  • /apis/machineconfiguration.openshift.io/v1/machineconfigpools/{name}/status

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

6.2.1. /apis/machineconfiguration.openshift.io/v1/machineconfigpools

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류 MachineConfigPool의 오브젝트 나열
표 6.4. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

MachineConfigPoolList schema

401 - 무단

HTTP 방법
POST
설명
MachineConfigPool을 생성
표 6.6. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineConfigPool schema

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

200 - OK

MachineConfigPool schema

201 - 생성됨

MachineConfigPool schema

202 - 승인됨

MachineConfigPool schema

401 - 무단

6.2.2. /apis/machineconfiguration.openshift.io/v1/machineconfigpools/{name}

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

name

string

MachineConfigPool의 이름

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

MachineConfigPool schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

MachineConfigPool schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineConfigPool schema

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

200 - OK

MachineConfigPool schema

201 - 생성됨

MachineConfigPool schema

401 - 무단

6.2.3. /apis/machineconfiguration.openshift.io/v1/machineconfigpools/{name}/status

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

name

string

MachineConfigPool의 이름

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

string

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

HTTP 방법
GET
설명
지정된 MachineConfigPool의 상태
표 6.24. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

MachineConfigPool schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

MachineConfigPool schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineConfigPool schema

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

200 - OK

MachineConfigPool schema

201 - 생성됨

MachineConfigPool schema

401 - 무단

7장. MachineConfig [machineconfiguration.openshift.io/v1]

설명
MachineConfig는 머신 구성을 정의합니다.
유형
object

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

MachineConfigSpec은 MachineConfig의 사양입니다.

7.1.1. .spec

설명
MachineConfigSpec은 MachineConfig의 사양입니다.
유형
object
속성유형설명

baseOSExtensionsContainerImage

string

baseOSExtensionsContainerImage는 new-format OS 이미지와 일치하는 extensions 컨테이너를 가져오는 데 사용할 원격 위치를 지정합니다.

config

``

config는 Ignition Config 오브젝트입니다.

확장

``

호스트에서 활성화할 수 있는 추가 기능 목록

fips

boolean

FIPS에서 FIPS 모드를 제어

kernelArguments

``

KernelArguments에는 추가할 커널 인수 목록이 포함되어 있습니다.

kernelType

string

기본(기존), 실시간처럼 실행하려는 커널을 포함합니다.

osImageURL

string

OSImageURL은 OS를 가져오는 데 사용할 원격 위치를 지정합니다.

7.2. API 끝점

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

  • /apis/machineconfiguration.openshift.io/v1/machineconfigs

    • DELETE: MachineConfig의 컬렉션 삭제
    • GET: 종류 MachineConfig의 오브젝트 나열
    • POST: MachineConfig 생성
  • /apis/machineconfiguration.openshift.io/v1/machineconfigs/{name}

    • DELETE: MachineConfig 삭제
    • GET: 지정된 MachineConfig 읽기
    • PATCH: 지정된 MachineConfig를 부분적으로 업데이트
    • PUT: 지정된 MachineConfig를 교체

7.2.1. /apis/machineconfiguration.openshift.io/v1/machineconfigs

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류 MachineConfig의 오브젝트 나열
표 7.4. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

MachineConfigList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineConfig schema

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

200 - OK

MachineConfig schema

201 - 생성됨

MachineConfig schema

202 - 승인됨

MachineConfig schema

401 - 무단

7.2.2. /apis/machineconfiguration.openshift.io/v1/machineconfigs/{name}

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

name

string

MachineConfig의 이름

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

MachineConfig schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

MachineConfig schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineConfig schema

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

200 - OK

MachineConfig schema

201 - 생성됨

MachineConfig schema

401 - 무단

8장. MachineHealthCheck [machine.openshift.io/v1beta1]

설명
MachineHealthCheck는 machinehealthchecks API 호환성 수준 2의 스키마입니다. 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)에 대한 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

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

최근 MachineHealthCheck 리소스의 상태

8.1.1. .spec

설명
머신 상태 점검 정책 사양
유형
object
속성유형설명

maxUnhealthy

integer-or-string

"selector"에서 선택한 대부분의 "MaxUnhealthy" 머신이 정상이 아닌 경우에만 훨씬 더 많은 업데이트가 허용됩니다. postive 정수 값 또는 백분율 값이 필요합니다. 백분율 값은 양의 정수여야 하며 100%로 제한되어야 합니다. 0과 0%는 모두 유효하며 모든 수정을 차단합니다.

nodeStartupTimeout

string

노드가 없는 이 기간보다 오래된 머신은 실패한 것으로 간주되며 수정됩니다. 노드가 없는 머신이 제거되지 않도록 하려면 이 값을 명시적으로 "0"으로 설정하여 시작 검사를 비활성화합니다. 각각 선택적 분수와 단위 접미사(예: "300ms", "1.5h" 또는 "2h45m"가 있는 10진수의 부호 없는 기간 문자열이 필요합니다. 유효한 시간 단위는 "ns", "us"(또는 "us"), "ms", "s", "m", "h"입니다.

remediationTemplate

object

RemediationTemplate은 인프라 공급자가 제공하는 수정 템플릿에 대한 참조입니다. 이 필드는 완전히 선택 사항으로 채워지면 MachineHealthCheck 컨트롤러는 참조된 템플릿에서 새 오브젝트를 생성하고 머신 API Operator 외부에 있는 컨트롤러로 머신 수정을 종료합니다.

선택기

object

상태를 실행할 시스템과 일치하는 라벨 선택기입니다. 참고: 빈 선택기는 모든 시스템과 일치합니다.

unhealthyConditions

array

UnhealthyConditions에는 노드가 비정상으로 간주되는지 여부를 결정하는 조건 목록이 포함되어 있습니다. 조건은 논리 OR로 결합됩니다. 즉, 조건이 충족되면 노드가 비정상입니다.

unhealthyConditions[]

object

UnhealthyCondition은 기간으로 지정된 타임아웃이 있는 노드 조건 유형 및 값을 나타냅니다. named 조건이 적어도 타임아웃 값에 대해 지정된 상태에 있는 경우 노드는 비정상으로 간주됩니다.

8.1.2. .spec.remediationTemplate

설명
RemediationTemplate은 인프라 공급자가 제공하는 수정 템플릿에 대한 참조입니다. 이 필드는 완전히 선택 사항으로 채워지면 MachineHealthCheck 컨트롤러는 참조된 템플릿에서 새 오브젝트를 생성하고 머신 API Operator 외부에 있는 컨트롤러로 머신 수정을 종료합니다.
유형
object
속성유형설명

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

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

네임스페이스

string

참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

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

8.1.3. .spec.selector

설명
상태를 실행할 시스템과 일치하는 라벨 선택기입니다. 참고: 빈 선택기는 모든 시스템과 일치합니다.
유형
object
속성유형설명

matchExpressions

array

matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.

matchExpressions[]

object

레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchLabels

오브젝트(문자열)

matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다.

8.1.4. .spec.selector.matchExpressions

설명
matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
유형
array

8.1.5. .spec.selector.matchExpressions[]

설명
레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

key는 선택기가 적용되는 라벨 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.

배열(문자열)

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

8.1.6. .spec.unhealthyConditions

설명
UnhealthyConditions에는 노드가 비정상으로 간주되는지 여부를 결정하는 조건 목록이 포함되어 있습니다. 조건은 논리 OR로 결합됩니다. 즉, 조건이 충족되면 노드가 비정상입니다.
유형
array

8.1.7. .spec.unhealthyConditions[]

설명
UnhealthyCondition은 기간으로 지정된 타임아웃이 있는 노드 조건 유형 및 값을 나타냅니다. named 조건이 적어도 타임아웃 값에 대해 지정된 상태에 있는 경우 노드는 비정상으로 간주됩니다.
유형
object
속성유형설명

status

string

 

timeout

string

각각 선택적 분수와 단위 접미사(예: "300ms", "1.5h" 또는 "2h45m"가 있는 10진수의 부호 없는 기간 문자열이 필요합니다. 유효한 시간 단위는 "ns", "us"(또는 "us"), "ms", "s", "m", "h"입니다.

type

string

 

8.1.8. .status

설명
최근 MachineHealthCheck 리소스의 상태
유형
object
속성유형설명

conditions

array

conditions는 MachineHealthCheck의 현재 상태를 정의합니다.

conditions[]

object

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

currentHealthy

integer

이 머신 상태 점검에서 계산한 총 머신 수

expectedMachines

integer

이 머신 상태 점검에서 계산한 총 머신 수

remediationsAllowed

integer

RemediationsAllowed는 maxUnhealthy 단축 회로를 적용하기 전에 이 머신 상태 점검에서 허용하는 추가 수정 횟수입니다.

8.1.9. .status.conditions

설명
conditions는 MachineHealthCheck의 현재 상태를 정의합니다.
유형
array

8.1.10. .status.conditions[]

설명
Condition은 Machine API 리소스 작동 상태를 관찰합니다.
유형
object
속성유형설명

lastTransitionTime

string

조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.

message

string

전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 이 필드는 비어 있을 수 있습니다.

reason

string

CamelCase에서 조건의 마지막 전환 이유는 다음과 같습니다. 특정 API는 이 필드가 보장된 API로 간주되는지 여부를 선택할 수 있습니다. 이 필드는 비어 있지 않을 수 있습니다.

심각도

string

심각도는 이유 코드에 대한 명시적 분류를 제공하므로 사용자 또는 머신이 현재 상황을 즉시 이해하고 그에 따라 조치를 취할 수 있습니다. 심각도 필드는 Status=False인 경우에만 설정해야 합니다.

status

string

조건의 상태, True, False, 알 수 없음.

type

string

CamelCase 또는 foo.example.com/CamelCase의 조건 유형입니다. 많은 .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다.

8.2. API 끝점

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

  • /apis/machine.openshift.io/v1beta1/machinehealthchecks

    • GET: MachineHealthCheck 유형의 오브젝트 나열
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinehealthchecks

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

    • DELETE: MachineHealthCheck 삭제
    • GET: 지정된 MachineHealthCheck 읽기
    • PATCH: 지정된 MachineHealthCheck를 부분적으로 업데이트
    • PUT: 지정된 MachineHealthCheck를 교체
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinehealthchecks/{name}/status

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

8.2.1. /apis/machine.openshift.io/v1beta1/machinehealthchecks

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

string

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

MachineHealthCheckList schema

401 - 무단

8.2.2. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinehealthchecks

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

네임스페이스

string

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

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

MachineHealthCheckList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineHealthCheck schema

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

200 - OK

MachineHealthCheck schema

201 - 생성됨

MachineHealthCheck schema

202 - 승인됨

MachineHealthCheck schema

401 - 무단

8.2.3. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinehealthchecks/{name}

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

name

string

MachineHealthCheck의 이름

네임스페이스

string

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

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

MachineHealthCheck schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

MachineHealthCheck schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineHealthCheck schema

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

200 - OK

MachineHealthCheck schema

201 - 생성됨

MachineHealthCheck schema

401 - 무단

8.2.4. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinehealthchecks/{name}/status

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

name

string

MachineHealthCheck의 이름

네임스페이스

string

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

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

MachineHealthCheck schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

MachineHealthCheck schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineHealthCheck schema

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

200 - OK

MachineHealthCheck schema

201 - 생성됨

MachineHealthCheck schema

401 - 무단

9장. Machine [machine.openshift.io/v1beta1]

설명
머신은 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 시스템 API 호환성 수준 2의 스키마입니다.
유형
object

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

MachineSpec은 원하는 머신 상태를 정의합니다.

status

object

MachineStatus는 머신의 관찰 상태를 정의합니다.

9.1.1. .spec

설명
MachineSpec은 원하는 머신 상태를 정의합니다.
유형
object
속성유형설명

lifecycleHooks

object

LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다.

메타데이터

object

ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다.

providerID

string

providerID는 공급자가 제공하는 머신의 ID입니다. 이 필드는 이 머신에 해당하는 노드 오브젝트에 표시된 공급자 ID와 일치해야 합니다. 이 필드는 cluster-api의 상위 수준 소비자에 필요합니다. 사용 사례는 cluster-api가 공급자인 클러스터 자동 스케일러입니다. 자동 스케일러의 정리 논리는 머신을 노드와 비교하여 Kubernetes 노드로 등록할 수 없는 공급자의 시스템을 찾습니다. 자동 스케일러의 일반 out-of-tree 공급자인 cluster-api를 사용하면 자동 스케일러에 시스템 목록의 공급자 보기를 사용할 수 있어야 합니다. k8s apiserver에서 다른 노드 목록을 쿼리한 다음, 등록되지 않은 시스템을 확인하기 위해 비교가 수행되며 삭제로 표시됩니다. 이 필드는 액추에이터에 의해 설정되며 일반 공급자로서 cluster-api와 상호 작용할 자동 스케일러와 같은 상위 수준 엔티티에서 사용합니다.

providerSpec

object

노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다.

테인트

array

추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다.

taints[]

object

이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다.

9.1.2. .spec.lifecycleHooks

설명
LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다.
유형
object
속성유형설명

preDrain

array

PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다.

preDrain[]

object

LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.

preTerminate

array

사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다.

preTerminate[]

object

LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.

9.1.3. .spec.lifecycleHooks.preDrain

설명
PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다.
유형
array

9.1.4. .spec.lifecycleHooks.preDrain[]

설명
LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
유형
object
필수 항목
  • name
  • 소유자
속성유형설명

name

string

name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다.

소유자

string

owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다.

9.1.5. .spec.lifecycleHooks.preTerminate

설명
사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다.
유형
array

9.1.6. .spec.lifecycleHooks.preTerminate[]

설명
LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
유형
object
필수 항목
  • name
  • 소유자
속성유형설명

name

string

name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다.

소유자

string

owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다.

9.1.7. .spec.metadata

설명
ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다.
유형
object
속성유형설명

annotations

오브젝트(문자열)

주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/annotations

generateName

string

generateName은 서버에서 사용하는 선택적 접두사로, Name 필드가 제공되지 않은 고유한 이름만 생성하는 데 사용됩니다. 이 필드를 사용하면 클라이언트에 반환되는 이름이 전달된 이름과 다릅니다. 이 값은 고유한 접미사와 결합됩니다. 제공된 값은 Name 필드와 동일한 검증 규칙을 가지며 서버에서 고유 값을 만드는 데 필요한 접미사 길이로 잘릴 수 있습니다. 이 필드가 지정되고 생성된 이름이 있는 경우 서버는 409를 반환하지 않습니다. 대신 201 Created 또는 500을 반환합니다. Reason ServerTimeout은 할당된 시간에 고유 이름을 찾을 수 없으며 클라이언트가 재시도해야 함을 나타냅니다(선택적으로 Retry-After 헤더에 표시된 시간 후). Name이 지정되지 않은 경우에만 적용됩니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency

labels

오브젝트(문자열)

개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/labels

name

string

이름은 네임스페이스 내에서 고유해야 합니다. 일부 리소스는 클라이언트가 적절한 이름의 생성을 자동으로 요청할 수 있지만 리소스를 생성할 때 필요합니다. 이름은 주로 생성 멱등 및 구성 정의를 위한 것입니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names

네임스페이스

string

namespace는 각 이름 내의 공간을 고유해야 합니다. 빈 네임스페이스는 "default" 네임스페이스와 동일하지만 "default"는 표준 표현입니다. 모든 오브젝트의 범위를 네임스페이스로 지정해야 하는 것은 아닙니다. 해당 오브젝트에 대한 이 필드의 값은 비어 있습니다. DNS_LABEL이어야 합니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/namespaces

ownerReferences

array

이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.

ownerReferences[]

object

OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.

9.1.8. .spec.metadata.ownerReferences

설명
이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.
유형
array

9.1.9. .spec.metadata.ownerReferences[]

설명
OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.
유형
object
필수 항목
  • apiVersion
  • kind
  • name
  • uid
속성유형설명

apiVersion

string

참조의 API 버전입니다.

blockOwnerDeletion

boolean

If true, and if the owner has the "foreworkspaceDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. 가비지 수집기가 이 필드와 상호 작용하고 전경 삭제를 적용하는 방법은 https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion 를 참조하십시오. 기본값은 false입니다. 이 필드를 설정하려면 사용자에게 소유자의 "삭제" 권한이 필요하며, 그렇지 않으면 422(프로세스할 수 없는 엔티티)가 반환됩니다.

컨트롤러

boolean

true인 경우 이 참조는 관리 컨트롤러를 가리킵니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

추천자의 이름입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names

uid

string

참조의 UID입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#uids

9.1.10. .spec.providerSpec

설명
노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다.
유형
object
속성유형설명

value

``

value는 리소스 구성을 인라인으로 직렬화한 표현입니다. 공급자는 이 필드에서 직렬화/직렬화해야 하는 자체 버전이 지정된 API 유형을 구성 요소와 유사한 상태로 유지하는 것이 좋습니다.

9.1.11. .spec.taints

설명
추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다.
유형
array

9.1.12. .spec.taints[]

설명
이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다.
유형
object
필수 항목
  • effect
  • key
속성유형설명

effect

string

필수 항목입니다. 테인트를 허용하지 않는 pod에 테인트의 영향을 미칩니다. 유효한 영향은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

key

string

필수 항목입니다. 노드에 적용할 taint 키입니다.

timeAdded

string

TimeAdded는 테인트가 추가된 시간을 나타냅니다. NoExecute 테인트에만 작성됩니다.

value

string

taint 키에 해당하는 taint 값입니다.

9.1.13. .status

설명
MachineStatus는 머신의 관찰 상태를 정의합니다.
유형
object
속성유형설명

addresses

array

address는 시스템에 할당된 주소 목록입니다. 사용 가능한 경우 클라우드 공급자에서 쿼리합니다.

addresses[]

object

NodeAddress에는 노드 주소에 대한 정보가 포함되어 있습니다.

conditions

array

조건은 머신의 현재 상태를 정의합니다.

conditions[]

object

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

errorMessage

string

시스템 조정 터미널 문제가 있는 경우 errorMessage가 설정되며 로깅 및 사용자 소비에 적합한 더 자세한 문자열이 포함됩니다. 이 필드는 시간이 지남에 따라 컨트롤러가 자동으로 수정될 것으로 예상되는 전송 오류(예: 서비스 중단)에 대해 설정하지 않아야 하지만 대신 머신 사양 또는 컨트롤러 구성에 근본적으로 문제가 있음을 나타내며 수동 개입이 필요하다는 것을 나타냅니다. 터미널 오류의 예로는 사양의 설정이 유효하지 않거나, 컨트롤러에서 지원하지 않는 값 또는 담당 컨트롤러 자체가 매우 잘못 구성되어 있습니다. 머신 조정 중에 발생하는 일시적인 오류는 머신 오브젝트에 이벤트로 추가 및/또는 컨트롤러의 출력에 로그인할 수 있습니다.

errorReason

string

ErrorReason은 머신을 조정하는데 터미널 문제가 있는 경우 설정되며, 머신 해석에 적합한 succinct 값을 포함합니다. 이 필드는 시간이 지남에 따라 컨트롤러가 자동으로 수정될 것으로 예상되는 전송 오류(예: 서비스 중단)에 대해 설정하지 않아야 하지만 대신 머신 사양 또는 컨트롤러 구성에 근본적으로 문제가 있음을 나타내며 수동 개입이 필요하다는 것을 나타냅니다. 터미널 오류의 예로는 사양의 설정이 유효하지 않거나, 컨트롤러에서 지원하지 않는 값 또는 담당 컨트롤러 자체가 매우 잘못 구성되어 있습니다. 머신 조정 중에 발생하는 일시적인 오류는 머신 오브젝트에 이벤트로 추가 및/또는 컨트롤러의 출력에 로그인할 수 있습니다.

lastOperation

object

LastOperation은 machine-controller에서 수행한 마지막 작동을 설명합니다. 이 API는 특정 머신에서 수행되는 최신 작업의 관점에서 기록으로 유용할 수 있습니다. 또한 최신 작동 상태를 전달해야 합니다. 예를 들어 계속 진행 중이거나 실패하거나 성공적으로 완료된 경우입니다.

lastUpdated

string

LastUpdated는 이 상태가 마지막으로 관찰된 시기를 식별합니다.

nodeRef

object

NodeRef는 해당 노드가 있는 경우 해당 노드를 가리킵니다.

phase

string

단계(Step)는 머신 작동의 현재 단계를 나타냅니다. 다음 중 하나: Failed, Provisioning, Provisioned, Running, Deleting

providerStatus

``

providerStatus는 공급자별 상태를 자세히 설명합니다. 공급자는 이 필드에서 직렬화/직렬화해야 하는 자체 버전의 API 유형을 유지 관리하는 것이 좋습니다.

9.1.14. .status.addresses

설명
address는 시스템에 할당된 주소 목록입니다. 사용 가능한 경우 클라우드 공급자에서 쿼리합니다.
유형
array

9.1.15. .status.addresses[]

설명
NodeAddress에는 노드 주소에 대한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • address
  • type
속성유형설명

address

string

노드 주소입니다.

type

string

노드 주소 유형, 호스트 이름, ExternalIP 또는 InternalIP 중 하나

9.1.16. .status.conditions

설명
조건은 머신의 현재 상태를 정의합니다.
유형
array

9.1.17. .status.conditions[]

설명
Condition은 Machine API 리소스 작동 상태를 관찰합니다.
유형
object
속성유형설명

lastTransitionTime

string

조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.

message

string

전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 이 필드는 비어 있을 수 있습니다.

reason

string

CamelCase에서 조건의 마지막 전환 이유는 다음과 같습니다. 특정 API는 이 필드가 보장된 API로 간주되는지 여부를 선택할 수 있습니다. 이 필드는 비어 있지 않을 수 있습니다.

심각도

string

심각도는 이유 코드에 대한 명시적 분류를 제공하므로 사용자 또는 머신이 현재 상황을 즉시 이해하고 그에 따라 조치를 취할 수 있습니다. 심각도 필드는 Status=False인 경우에만 설정해야 합니다.

status

string

조건의 상태, True, False, 알 수 없음.

type

string

CamelCase 또는 foo.example.com/CamelCase의 조건 유형입니다. 많은 .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다.

9.1.18. .status.lastOperation

설명
LastOperation은 machine-controller에서 수행한 마지막 작동을 설명합니다. 이 API는 특정 머신에서 수행되는 최신 작업의 관점에서 기록으로 유용할 수 있습니다. 또한 최신 작동 상태를 전달해야 합니다. 예를 들어 계속 진행 중이거나 실패하거나 성공적으로 완료된 경우입니다.
유형
object
속성유형설명

description

string

설명은 마지막 작업에 대해 사람이 읽을 수 있는 설명입니다.

lastUpdated

string

LastUpdated는 LastOperation API가 마지막으로 업데이트된 타임스탬프입니다.

상태

string

state는 마지막으로 수행된 작업의 현재 상태입니다. 예: 처리, 실패, 성공 등

type

string

type은 마지막으로 수행된 작업 유형입니다. 예: 생성, 삭제, 업데이트 등

9.1.19. .status.nodeRef

설명
NodeRef는 해당 노드가 있는 경우 해당 노드를 가리킵니다.
유형
object
속성유형설명

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

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

네임스페이스

string

참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

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

9.2. API 끝점

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

  • /apis/machine.openshift.io/v1beta1/machines

    • GET: 종류의 개체를 나열합니다.
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines

    • DELETE: 머신 컬렉션 삭제
    • GET: 종류의 개체를 나열합니다.
    • POST: 머신 생성
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines/{name}

    • DELETE: 머신 삭제
    • GET: 지정된 머신 읽기
    • PATCH: 지정된 머신을 부분적으로 업데이트
    • PUT: 지정된 머신 교체
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines/{name}/status

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

9.2.1. /apis/machine.openshift.io/v1beta1/machines

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

string

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

MachineList schema

401 - 무단

9.2.2. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines

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

네임스페이스

string

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

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

string

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

HTTP 방법
DELETE
설명
머신 컬렉션 삭제
표 9.5. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

MachineList schema

401 - 무단

HTTP 방법
POST
설명
머신 생성
표 9.9. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

머신 스키마

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

200 - OK

머신 스키마

201 - 생성됨

머신 스키마

202 - 승인됨

머신 스키마

401 - 무단

9.2.3. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines/{name}

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

name

string

머신의 이름

네임스페이스

string

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

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

머신 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

머신 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

머신 스키마

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

200 - OK

머신 스키마

201 - 생성됨

머신 스키마

401 - 무단

9.2.4. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines/{name}/status

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

name

string

머신의 이름

네임스페이스

string

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

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

머신 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

머신 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

머신 스키마

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

200 - OK

머신 스키마

201 - 생성됨

머신 스키마

401 - 무단

10장. MachineSet [machine.openshift.io/v1beta1]

설명
MachineSet은 지정된 수의 머신 복제본이 지정된 시간에 실행되도록 합니다. 호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.
유형
object

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

MachineSetSpec은 원하는 MachineSet 상태를 정의합니다.

status

object

MachineSetStatus는 MachineSet의 관찰 상태를 정의합니다.

10.1.1. .spec

설명
MachineSetSpec은 원하는 MachineSet 상태를 정의합니다.
유형
object
속성유형설명

deletePolicy

string

DeletePolicy는 축소 시 삭제할 노드를 식별하는 데 사용되는 정책을 정의합니다. 기본값은 "Random"입니다. 유효한 값은 "Random, "Newest", "Oldest"입니다.

minReadySeconds

integer

minReadySeconds는 새로 생성된 시스템을 준비해야 하는 최소 시간(초)입니다. 기본값은 0입니다 (기계는 준비되는 즉시 사용 가능한 것으로 간주됨)

replicas

integer

replicas는 원하는 복제본 수입니다. 이는 명시적 0과 지정되지 않음을 구분하기 위한 포인터입니다. 기본값은 1입니다.

선택기

object

selector는 복제본 수와 일치해야 하는 시스템의 레이블 쿼리입니다. 이 MachineSet에서 제어하려면 일치해야 하는 레이블 키와 값입니다. 머신 템플릿의 레이블과 일치해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

템플릿

object

템플릿은 충분하지 않은 복제본이 감지되면 생성되는 머신을 설명하는 오브젝트입니다.

10.1.2. .spec.selector

설명
selector는 복제본 수와 일치해야 하는 시스템의 레이블 쿼리입니다. 이 MachineSet에서 제어하려면 일치해야 하는 레이블 키와 값입니다. 머신 템플릿의 레이블과 일치해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
유형
object
속성유형설명

matchExpressions

array

matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.

matchExpressions[]

object

레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchLabels

오브젝트(문자열)

matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다.

10.1.3. .spec.selector.matchExpressions

설명
matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
유형
array

10.1.4. .spec.selector.matchExpressions[]

설명
레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

key는 선택기가 적용되는 라벨 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.

배열(문자열)

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

10.1.5. .spec.template

설명
템플릿은 충분하지 않은 복제본이 감지되면 생성되는 머신을 설명하는 오브젝트입니다.
유형
object
속성유형설명

메타데이터

object

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

spec

object

머신의 원하는 동작에 대한 사양입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

10.1.6. .spec.template.metadata

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

annotations

오브젝트(문자열)

주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/annotations

generateName

string

generateName은 서버에서 사용하는 선택적 접두사로, Name 필드가 제공되지 않은 고유한 이름만 생성하는 데 사용됩니다. 이 필드를 사용하면 클라이언트에 반환되는 이름이 전달된 이름과 다릅니다. 이 값은 고유한 접미사와 결합됩니다. 제공된 값은 Name 필드와 동일한 검증 규칙을 가지며 서버에서 고유 값을 만드는 데 필요한 접미사 길이로 잘릴 수 있습니다. 이 필드가 지정되고 생성된 이름이 있는 경우 서버는 409를 반환하지 않습니다. 대신 201 Created 또는 500을 반환합니다. Reason ServerTimeout은 할당된 시간에 고유 이름을 찾을 수 없으며 클라이언트가 재시도해야 함을 나타냅니다(선택적으로 Retry-After 헤더에 표시된 시간 후). Name이 지정되지 않은 경우에만 적용됩니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency

labels

오브젝트(문자열)

개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/labels

name

string

이름은 네임스페이스 내에서 고유해야 합니다. 일부 리소스는 클라이언트가 적절한 이름의 생성을 자동으로 요청할 수 있지만 리소스를 생성할 때 필요합니다. 이름은 주로 생성 멱등 및 구성 정의를 위한 것입니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names

네임스페이스

string

namespace는 각 이름 내의 공간을 고유해야 합니다. 빈 네임스페이스는 "default" 네임스페이스와 동일하지만 "default"는 표준 표현입니다. 모든 오브젝트의 범위를 네임스페이스로 지정해야 하는 것은 아닙니다. 해당 오브젝트에 대한 이 필드의 값은 비어 있습니다. DNS_LABEL이어야 합니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/namespaces

ownerReferences

array

이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.

ownerReferences[]

object

OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.

10.1.7. .spec.template.metadata.ownerReferences

설명
이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.
유형
array

10.1.8. .spec.template.metadata.ownerReferences[]

설명
OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.
유형
object
필수 항목
  • apiVersion
  • kind
  • name
  • uid
속성유형설명

apiVersion

string

참조의 API 버전입니다.

blockOwnerDeletion

boolean

If true, and if the owner has the "foreworkspaceDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. 가비지 수집기가 이 필드와 상호 작용하고 전경 삭제를 적용하는 방법은 https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion 를 참조하십시오. 기본값은 false입니다. 이 필드를 설정하려면 사용자에게 소유자의 "삭제" 권한이 필요하며, 그렇지 않으면 422(프로세스할 수 없는 엔티티)가 반환됩니다.

컨트롤러

boolean

true인 경우 이 참조는 관리 컨트롤러를 가리킵니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

추천자의 이름입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names

uid

string

참조의 UID입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#uids

10.1.9. .spec.template.spec

설명
머신의 원하는 동작에 대한 사양입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
유형
object
속성유형설명

lifecycleHooks

object

LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다.

메타데이터

object

ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다.

providerID

string

providerID는 공급자가 제공하는 머신의 ID입니다. 이 필드는 이 머신에 해당하는 노드 오브젝트에 표시된 공급자 ID와 일치해야 합니다. 이 필드는 cluster-api의 상위 수준 소비자에 필요합니다. 사용 사례는 cluster-api가 공급자인 클러스터 자동 스케일러입니다. 자동 스케일러의 정리 논리는 머신을 노드와 비교하여 Kubernetes 노드로 등록할 수 없는 공급자의 시스템을 찾습니다. 자동 스케일러의 일반 out-of-tree 공급자인 cluster-api를 사용하면 자동 스케일러에 시스템 목록의 공급자 보기를 사용할 수 있어야 합니다. k8s apiserver에서 다른 노드 목록을 쿼리한 다음, 등록되지 않은 시스템을 확인하기 위해 비교가 수행되며 삭제로 표시됩니다. 이 필드는 액추에이터에 의해 설정되며 일반 공급자로서 cluster-api와 상호 작용할 자동 스케일러와 같은 상위 수준 엔티티에서 사용합니다.

providerSpec

object

노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다.

테인트

array

추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다.

taints[]

object

이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다.

10.1.10. .spec.template.spec.lifecycleHooks

설명
LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다.
유형
object
속성유형설명

preDrain

array

PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다.

preDrain[]

object

LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.

preTerminate

array

사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다.

preTerminate[]

object

LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.

10.1.11. .spec.template.spec.lifecycleHooks.preDrain

설명
PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다.
유형
array

10.1.12. .spec.template.spec.lifecycleHooks.preDrain[]

설명
LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
유형
object
필수 항목
  • name
  • 소유자
속성유형설명

name

string

name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다.

소유자

string

owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다.

10.1.13. .spec.template.spec.lifecycleHooks.preTerminate

설명
사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다.
유형
array

10.1.14. .spec.template.spec.lifecycleHooks.preTerminate[]

설명
LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
유형
object
필수 항목
  • name
  • 소유자
속성유형설명

name

string

name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다.

소유자

string

owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다.

10.1.15. .spec.template.spec.metadata

설명
ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다.
유형
object
속성유형설명

annotations

오브젝트(문자열)

주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/annotations

generateName

string

generateName은 서버에서 사용하는 선택적 접두사로, Name 필드가 제공되지 않은 고유한 이름만 생성하는 데 사용됩니다. 이 필드를 사용하면 클라이언트에 반환되는 이름이 전달된 이름과 다릅니다. 이 값은 고유한 접미사와 결합됩니다. 제공된 값은 Name 필드와 동일한 검증 규칙을 가지며 서버에서 고유 값을 만드는 데 필요한 접미사 길이로 잘릴 수 있습니다. 이 필드가 지정되고 생성된 이름이 있는 경우 서버는 409를 반환하지 않습니다. 대신 201 Created 또는 500을 반환합니다. Reason ServerTimeout은 할당된 시간에 고유 이름을 찾을 수 없으며 클라이언트가 재시도해야 함을 나타냅니다(선택적으로 Retry-After 헤더에 표시된 시간 후). Name이 지정되지 않은 경우에만 적용됩니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency

labels

오브젝트(문자열)

개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/labels

name

string

이름은 네임스페이스 내에서 고유해야 합니다. 일부 리소스는 클라이언트가 적절한 이름의 생성을 자동으로 요청할 수 있지만 리소스를 생성할 때 필요합니다. 이름은 주로 생성 멱등 및 구성 정의를 위한 것입니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names

네임스페이스

string

namespace는 각 이름 내의 공간을 고유해야 합니다. 빈 네임스페이스는 "default" 네임스페이스와 동일하지만 "default"는 표준 표현입니다. 모든 오브젝트의 범위를 네임스페이스로 지정해야 하는 것은 아닙니다. 해당 오브젝트에 대한 이 필드의 값은 비어 있습니다. DNS_LABEL이어야 합니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/namespaces

ownerReferences

array

이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.

ownerReferences[]

object

OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.

10.1.16. .spec.template.spec.metadata.ownerReferences

설명
이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.
유형
array

10.1.17. .spec.template.spec.metadata.ownerReferences[]

설명
OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.
유형
object
필수 항목
  • apiVersion
  • kind
  • name
  • uid
속성유형설명

apiVersion

string

참조의 API 버전입니다.

blockOwnerDeletion

boolean

If true, and if the owner has the "foreworkspaceDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. 가비지 수집기가 이 필드와 상호 작용하고 전경 삭제를 적용하는 방법은 https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion 를 참조하십시오. 기본값은 false입니다. 이 필드를 설정하려면 사용자에게 소유자의 "삭제" 권한이 필요하며, 그렇지 않으면 422(프로세스할 수 없는 엔티티)가 반환됩니다.

컨트롤러

boolean

true인 경우 이 참조는 관리 컨트롤러를 가리킵니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

추천자의 이름입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names

uid

string

참조의 UID입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#uids

10.1.18. .spec.template.spec.providerSpec

설명
노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다.
유형
object
속성유형설명

value

``

value는 리소스 구성을 인라인으로 직렬화한 표현입니다. 공급자는 이 필드에서 직렬화/직렬화해야 하는 자체 버전이 지정된 API 유형을 구성 요소와 유사한 상태로 유지하는 것이 좋습니다.

10.1.19. .spec.template.spec.taints

설명
추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다.
유형
array

10.1.20. .spec.template.spec.taints[]

설명
이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다.
유형
object
필수 항목
  • effect
  • key
속성유형설명

effect

string

필수 항목입니다. 테인트를 허용하지 않는 pod에 테인트의 영향을 미칩니다. 유효한 영향은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

key

string

필수 항목입니다. 노드에 적용할 taint 키입니다.

timeAdded

string

TimeAdded는 테인트가 추가된 시간을 나타냅니다. NoExecute 테인트에만 작성됩니다.

value

string

taint 키에 해당하는 taint 값입니다.

10.1.21. .status

설명
MachineSetStatus는 MachineSet의 관찰 상태를 정의합니다.
유형
object
속성유형설명

availableReplicas

integer

이 MachineSet에 대해 사용 가능한 복제본 수 (최소 minReadySeconds) 수입니다.

errorMessage

string

 

errorReason

string

복제본을 조정하는 터미널 문제가 있는 경우 ErrorReason 및 ErrorMessage가 모두 설정됩니다. ErrorReason은 머신 해석에 적합한 succinct 값으로 채워지지만 ErrorMessage에는 로깅 및 인적 소비에 적합한 더 자세한 문자열이 포함됩니다. 이러한 필드는 시간이 지남에 따라 컨트롤러가 자동으로 수정될 것으로 예상되는 전송 오류(예: 서비스 중단)에 대해 설정되지 않아야 하지만 대신 MachineTemplate의 사양 또는 머신 컨트롤러 구성에 근본적으로 문제가 있음을 나타내며 수동 개입이 필요하다는 것을 나타냅니다. 터미널 오류의 예로는 사양의 설정이 유효하지 않거나, 머신 컨트롤러에서 지원하지 않는 값 또는 담당 머신 컨트롤러 자체가 매우 잘못 구성되어 있습니다. 머신 조정 중에 발생하는 일시적인 오류는 MachineSet 오브젝트에 이벤트로 추가 및/또는 컨트롤러의 출력에 로그인할 수 있습니다.

fullyLabeledReplicas

integer

MachineSet의 머신 템플릿의 레이블과 일치하는 레이블이 있는 복제본 수입니다.

observedGeneration

integer

observedGeneration은 가장 최근에 관찰된 MachineSet의 생성을 반영합니다.

readyReplicas

integer

이 MachineSet의 준비된 복제본 수입니다. 노드가 생성되고 "Ready"인 경우 시스템이 준비된 것으로 간주됩니다.

replicas

integer

복제본은 가장 최근에 관찰된 복제본 수입니다.

10.2. API 끝점

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

  • /apis/machine.openshift.io/v1beta1/machinesets

    • GET: 종류의 MachineSet의 오브젝트 나열
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets

    • DELETE: MachineSet의 컬렉션 삭제
    • GET: 종류의 MachineSet의 오브젝트 나열
    • POST: MachineSet 생성
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}

    • DELETE: MachineSet 삭제
    • GET: 지정된 MachineSet 읽기
    • PATCH: 지정된 MachineSet을 부분적으로 업데이트
    • PUT: 지정된 MachineSet을 교체
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}/scale

    • GET: 지정된 MachineSet의 읽기 크기
    • PATCH: 지정된 MachineSet의 부분 업데이트 규모
    • PUT: 지정된 MachineSet의 스케일링을 교체
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}/status

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

10.2.1. /apis/machine.openshift.io/v1beta1/machinesets

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

string

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

MachineSetList schema

401 - 무단

10.2.2. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets

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

네임스페이스

string

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

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

제한

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

MachineSetList schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineSet schema

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

200 - OK

MachineSet schema

201 - 생성됨

MachineSet schema

202 - 승인됨

MachineSet schema

401 - 무단

10.2.3. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}

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

name

string

MachineSet의 이름

네임스페이스

string

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

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

MachineSet schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

MachineSet schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineSet schema

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

200 - OK

MachineSet schema

201 - 생성됨

MachineSet schema

401 - 무단

10.2.4. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}/scale

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

name

string

MachineSet의 이름

네임스페이스

string

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

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

string

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

HTTP 방법
GET
설명
지정된 MachineSet의 읽기 크기
표 10.27. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

스케일링 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

스케일링 스키마

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

스케일링 스키마

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

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

10.2.5. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}/status

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

name

string

MachineSet의 이름

네임스페이스

string

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

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

MachineSet schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

패치 스키마

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

200 - OK

MachineSet schema

401 - 무단

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

dryRun

string

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

fieldManager

string

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

fieldValidation

string

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

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

body

MachineSet schema

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

200 - OK

MachineSet schema

201 - 생성됨

MachineSet schema

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.