Operator API


OpenShift Container Platform 4.12

Operator API에 대한 참조 가이드

Red Hat OpenShift Documentation Team

초록

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

1장. Operator API

1.1. 인증 [operator.openshift.io/v1]

설명
인증은 인증을 관리하도록 운영자를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.2. CloudCredential [operator.openshift.io/v1]

설명
CloudCredential는 CredentialsRequests를 관리하도록 Operator를 구성하는 수단을 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.3. ClusterCSIDriver [operator.openshift.io/v1]

설명
ClusterCSIDriver 오브젝트를 사용하면 OpenShift에 기본적으로 설치된 CSI 드라이버 Operator를 관리하고 구성할 수 있습니다. 오브젝트 이름은 작동하는 CSI 드라이버의 이름이어야 합니다. 허용되는 값 목록은 CSIDriverName 유형을 참조하십시오. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.4. 콘솔 [operator.openshift.io/v1]

설명
콘솔은 콘솔을 관리하도록 운영자를 구성하는 수단을 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.5. config [operator.openshift.io/v1]

설명
config는 클러스터에서 다른 구성 요소의 초기 구성을 생성하는 config Operator의 동작을 지정합니다. Operator는 AWS 및 Azure 클라우드 기반 클러스터 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 클라우드 구성의 설치, 마이그레이션 또는 동기화를 처리합니다.
유형
object

1.6. Config [imageregistry.operator.openshift.io/v1]

설명
구성은 레지스트리 Operator 호환성 수준 1에서 관리하는 레지스트리 인스턴스의 구성 오브젝트입니다. 최소 12개월 또는 3개의 마이너 릴리스(더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.7. Config [samples.operator.openshift.io/v1]

설명
config에는 Samples Operator의 구성 및 세부 조건 상태가 포함됩니다.
유형
object

1.8. CSISnapshotController [operator.openshift.io/v1]

설명
CSISnapshotController는 CSI 스냅샷을 관리하도록 Operator를 구성하는 수단을 제공합니다. Cluster 는 정식 이름입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.9. DNS [operator.openshift.io/v1]

설명
DNS는 CoreDNS 구성 요소를 관리하여 클러스터의 pod 및 서비스에 대한 이름 확인 서비스를 제공합니다. 이는 DNS 기반 서비스 검색 사양을 지원합니다. https://github.com/kubernetes/dns/blob/master/docs/specification.md 자세한 내용은 https://kubernetes.io/docs/tasks/administer-cluster/coredns 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.10. DNSRecord [ingress.operator.openshift.io/v1]

설명
DNSRecord는 dns.config.openshift.io/cluster .spec.publicZone 및 .spec.privateZone에서 정의한 영역에서 관리되는 DNS 레코드입니다. 이 리소스의 클러스터 관리자 조작은 지원되지 않습니다. 이 리소스는 OpenShift Operator의 내부 통신 전용입니다. DNSManagementPolicy가 "관리되지 않음"인 경우 Operator는 클라우드 공급자의 DNS 레코드를 관리할 수 없습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.11. Etcd [operator.openshift.io/v1]

설명
etcd는 etcd를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.12. ImageContentSourcePolicy [operator.openshift.io/v1alpha1]

설명
ImageContentSourcePolicy에는 레지스트리 미러 규칙을 처리하는 방법에 대한 클러스터 전체 정보가 들어 있습니다. 여러 정책이 정의되면 동작 결과가 각 필드에 정의됩니다. 호환성 수준 4: 호환성이 제공되지 않으며, API는 어떠한 이유로든 변경될 수 있습니다. 이러한 기능은 장기 지원이 필요한 애플리케이션에서 사용해서는 안 됩니다.
유형
object

1.13. ImagePruner [imageregistry.operator.openshift.io/v1]

설명
ImagePruner는 레지스트리 운영자가 관리하는 이미지 레지스트리 정리기에 대한 구성 오브젝트입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.14. IngressController [operator.openshift.io/v1]

설명
IngressController는 클러스터의 관리형 Ingress 컨트롤러를 설명합니다. 컨트롤러는 OpenShift 경로 및 Kubernetes 인그레스 리소스를 제공할 수 있습니다. IngressController가 생성되면 외부 트래픽이 Ingress 또는 Route 리소스를 노출하는 서비스에 도달할 수 있도록 새 수신 컨트롤러 배포가 생성됩니다. 이 리소스를 업데이트하면 새 수신 컨트롤러 리버전이 롤아웃될 수 있으므로 공용으로 발생하는 네트워크 연결이 중단될 수 있습니다. https://kubernetes.io/docs/concepts/services-networking/ingress-controllers 가능한 경우 플랫폼의 합리적인 기본값이 사용됩니다. 자세한 내용은 각 필드를 참조하십시오. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.15. InsightsOperator [operator.openshift.io/v1]

설명
InsightsOperator에는 Insights Operator에 대한 클러스터 전체 정보가 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.16. KubeAPIServer [operator.openshift.io/v1]

설명
kubeapiserver는 kube-apiserver를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.17. KubeControllerManager [operator.openshift.io/v1]

설명
kubecontrollermanager는 kube-controller-manager를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.18. KubeScheduler [operator.openshift.io/v1]

설명
kubescheduler는 스케줄러를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.19. KubeStorageVersionMigrator [operator.openshift.io/v1]

설명
KubeStorageVersionMigrator는 kube-storage-version-migrator를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.20. Network [operator.openshift.io/v1]

설명
네트워크는 클러스터의 원하는 네트워크 구성을 설명합니다. cluster-network-operator에서 사용합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.21. OpenShiftAPIServer [operator.openshift.io/v1]

설명
openshiftapiserver는 openshift-apiserver를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.22. OpenShiftControllerManager [operator.openshift.io/v1]

설명
OpenShiftControllerManager는 openshift-controller-manager를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.23. OperatorPKI [network.operator.openshift.io/v1]

설명
OperatorPKI는 간단한 인증 기관입니다. 외부 사용을 위한 것이 아니라 네트워크 운영자의 내부입니다. CNO는 CA 및 해당 CA에서 서명한 인증서를 생성합니다. 인증서에는 ClientAuth 및 ServerAuth 확장 사용이 모두 활성화되어 있습니다. 특히, <name>이 있는 OperatorPKI - CNO는 두 개의 데이터 키가 있는 <name>-ca라는 시크릿을 관리합니다. - tls.key - 개인 키 - 개인 키 - TLS.crt - CA 인증서 - 단일 데이터 키가 있는 <name>-ca라는 ConfigMap - - cabundle.crt - the CA certificate(s) - <name>-cert라는 두 개의 키 - tls - tls - certificate - 인증서가 있습니다. CA에서 서명한 CA 인증서의 유효성은 10년 후 순환됩니다. 대상 인증서의 유효 기간은 6개월이며 3개월 후에 CA 인증서의 일반 이름 "<namespace>_<name>-ca@<timestamp>"를 사용합니다. 여기서 <timestamp>는 마지막 순환 시간입니다.
유형
object

1.24. ServiceCA [operator.openshift.io/v1]

설명
ServiceCA는 서비스 인증서 컨트롤러 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있도록 Operator를 구성하는 정보를 제공합니다.
유형
object

1.25. 스토리지 [operator.openshift.io/v1]

설명
스토리지는 클러스터 스토리지 Operator를 관리하도록 운영자를 구성하는 수단을 제공합니다. Cluster 는 정식 이름입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

2장. 인증 [operator.openshift.io/v1]

설명
인증은 인증을 관리하도록 운영자를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
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

 

status

object

 

2.1.1. .spec

설명
유형
object
속성유형설명

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

2.1.2. .status

설명
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

oauthAPIServer

object

OAuthAPIServer에는 oauth-apiserver에만 해당하는 상태가 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

2.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

2.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

2.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

2.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

2.1.7. .status.oauthAPIServer

설명
OAuthAPIServer에는 oauth-apiserver에만 해당하는 상태가 있습니다.
유형
object
속성유형설명

latestAvailableRevision

integer

LatestAvailableRevision은 encryption-config와 같은 개정된 보안 접미사로 사용되는 최신 버전입니다. 새 버전으로 인해 Pod가 새로 배포됩니다.

2.2. API 끝점

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

  • /apis/operator.openshift.io/v1/authentications

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

    • DELETE: 인증 삭제
    • GET: 지정된 인증 읽기
    • PATCH: 지정된 인증을 부분적으로 업데이트
    • PUT: 지정된 인증을 교체
  • /apis/operator.openshift.io/v1/authentications/{name}/status

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

2.2.1. /apis/operator.openshift.io/v1/authentications

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
인증 유형 오브젝트 나열
표 2.4. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

AuthenticationList 스키마

401 - 무단

HTTP 방법
POST
설명
인증 생성
표 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

인증 스키마

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

200 - OK

인증 스키마

201 - 생성됨

인증 스키마

202 - 승인됨

인증 스키마

401 - 무단

2.2.2. /apis/operator.openshift.io/v1/authentications/{name}

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

name

string

인증의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

인증 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 인증을 부분적으로 업데이트
표 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

인증 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 인증 교체
표 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

인증 스키마

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

200 - OK

인증 스키마

201 - 생성됨

인증 스키마

401 - 무단

2.2.3. /apis/operator.openshift.io/v1/authentications/{name}/status

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

name

string

인증의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

인증 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 인증의 부분적으로 업데이트
표 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

인증 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 인증의 상태 교체
표 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

인증 스키마

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

200 - OK

인증 스키마

201 - 생성됨

인증 스키마

401 - 무단

3장. CloudCredential [operator.openshift.io/v1]

설명
CloudCredential는 CredentialsRequests를 관리하도록 Operator를 구성하는 수단을 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
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

CloudCredentialSpec은 cloud-credential-operator의 원하는 동작의 사양입니다.

status

object

CloudCredentialStatus는 cloud-credential-operator의 관찰 상태를 정의합니다.

3.1.1. .spec

설명
CloudCredentialSpec은 cloud-credential-operator의 원하는 동작의 사양입니다.
유형
object
속성유형설명

credentialsMode

string

credentialsMode를 사용하면 CCO에 루트 클라우드 인증 정보 기능을 동적으로 확인할 수 없으며 지정된 모드에서만 실행해야 합니다. 또한 원하는 경우 연산자를 "수동" 모드에 배치할 수 있습니다. 기본 모드로 필드를 두면 클러스터의 클라우드 인증 정보가(지원되는 클라우드/플랫폼에서) 기능을 동적으로 프로브하도록 CCO를 실행합니다. 지원되는 모드: AWS/Azure/GCP: ""(기본값), "Mint", "Passthrough", "Manual" 기타: "Passthrough"에서만 실행되는 것을 지원하므로 값을 설정하지 마십시오.

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

3.1.2. .status

설명
CloudCredentialStatus는 cloud-credential-operator의 관찰 상태를 정의합니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

3.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

3.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

3.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

3.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

3.2. API 끝점

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

  • /apis/operator.openshift.io/v1/cloudcredentials

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

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

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

3.2.1. /apis/operator.openshift.io/v1/cloudcredentials

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

string

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

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

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

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

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

CloudCredentialList schema

401 - 무단

HTTP 방법
POST
설명
클라우드 인증 정보 생성
표 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

CloudCredential 스키마

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

200 - OK

CloudCredential 스키마

201 - 생성됨

CloudCredential 스키마

202 - 승인됨

CloudCredential 스키마

401 - 무단

3.2.2. /apis/operator.openshift.io/v1/cloudcredentials/{name}

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

name

string

CloudCredential의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

CloudCredential 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 CloudCredential를 부분적으로 업데이트
표 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

CloudCredential 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 CloudCredential 교체
표 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

CloudCredential 스키마

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

200 - OK

CloudCredential 스키마

201 - 생성됨

CloudCredential 스키마

401 - 무단

3.2.3. /apis/operator.openshift.io/v1/cloudcredentials/{name}/status

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

name

string

CloudCredential의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

CloudCredential 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 CloudCredential의 부분적으로 업데이트 상태
표 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

CloudCredential 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 CloudCredential의 상태 교체
표 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

CloudCredential 스키마

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

200 - OK

CloudCredential 스키마

201 - 생성됨

CloudCredential 스키마

401 - 무단

4장. ClusterCSIDriver [operator.openshift.io/v1]

설명
ClusterCSIDriver 오브젝트를 사용하면 OpenShift에 기본적으로 설치된 CSI 드라이버 Operator를 관리하고 구성할 수 있습니다. 오브젝트 이름은 작동하는 CSI 드라이버의 이름이어야 합니다. 허용되는 값 목록은 CSIDriverName 유형을 참조하십시오. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

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

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

4.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

driverConfig

object

driverConfig를 사용하여 플랫폼별 드라이버 구성을 지정할 수 있습니다. 생략하면 이는 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다.

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

storageClassState

string

StorageClassState는 CSI Operator가 스토리지 클래스를 생성하고 관리해야 하는지 결정합니다. 이 필드 값이 비어 있거나 Managed - CSI Operator가 스토리지 클래스를 지속적으로 조정하고 필요한 경우 생성합니다. 이 필드 값이 Unmanaged - CSI Operator가 이전에 생성된 스토리지 클래스를 조정하지 않습니다. 이 필드 값이 Removed - CSI Operator가 이전에 생성한 스토리지 클래스를 삭제합니다. 생략하면 사용자에게 의견이 없으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 적절한 기본값을 선택합니다. 현재 기본 동작은 Managed입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

4.1.2. .spec.driverConfig

설명
driverConfig를 사용하여 플랫폼별 드라이버 구성을 지정할 수 있습니다. 생략하면 이는 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다.
유형
object
필수 항목
  • driverType
속성유형설명

driverType

string

driverType은 driverConfig를 적용할 CSI 드라이버 유형을 나타냅니다. 유효한 값은 * vSphere에서 vsphere CSI 드라이버 토폴로지 구성을 허용합니다. --- Consumers는 알 수 없는 값을 NO-OP로 처리해야 합니다.

vSphere

object

vSphere는 vsphere CSI 드라이버를 구성하는 데 사용됩니다.

4.1.3. .spec.driverConfig.vSphere

설명
vSphere는 vsphere CSI 드라이버를 구성하는 데 사용됩니다.
유형
object
속성유형설명

topologyCategories

배열(문자열)

topologyCategories는 hostcluster 또는 datacenter와 같은 vcenter 리소스가 태그된 태그 범주를 나타냅니다. 클러스터 인프라 오브젝트에 토폴로지가 있는 경우 Infrastructure 오브젝트에 지정된 값이 사용되며 topologyCategories에 대한 수정 사항이 거부됩니다.

4.1.4. .status

설명
status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

4.1.5. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

4.1.6. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

4.1.7. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

4.1.8. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

4.2. API 끝점

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

  • /apis/operator.openshift.io/v1/clustercsidrivers

    • DELETE: ClusterCSIDriver의 컬렉션 삭제
    • GET: ClusterCSIDriver 유형의 오브젝트 나열
    • POST: ClusterCSIDriver 생성
  • /apis/operator.openshift.io/v1/clustercsidrivers/{name}

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

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

4.2.1. /apis/operator.openshift.io/v1/clustercsidrivers

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

ClusterCSIDriverList schema

401 - 무단

HTTP 방법
POST
설명
ClusterCSIDriver 생성
표 4.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

ClusterCSIDriver 스키마

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

200 - OK

ClusterCSIDriver 스키마

201 - 생성됨

ClusterCSIDriver 스키마

202 - 승인됨

ClusterCSIDriver 스키마

401 - 무단

4.2.2. /apis/operator.openshift.io/v1/clustercsidrivers/{name}

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

name

string

ClusterCSIDriver의 이름

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ClusterCSIDriver 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ClusterCSIDriver를 부분적으로 업데이트
표 4.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

ClusterCSIDriver 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ClusterCSIDriver로 교체
표 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

ClusterCSIDriver 스키마

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

200 - OK

ClusterCSIDriver 스키마

201 - 생성됨

ClusterCSIDriver 스키마

401 - 무단

4.2.3. /apis/operator.openshift.io/v1/clustercsidrivers/{name}/status

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

name

string

ClusterCSIDriver의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ClusterCSIDriver 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ClusterCSIDriver의 부분적으로 업데이트 상태
표 4.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

ClusterCSIDriver 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ClusterCSIDriver의 상태 교체
표 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

ClusterCSIDriver 스키마

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

200 - OK

ClusterCSIDriver 스키마

201 - 생성됨

ClusterCSIDriver 스키마

401 - 무단

5장. 콘솔 [operator.openshift.io/v1]

설명
콘솔은 콘솔을 관리하도록 운영자를 구성하는 수단을 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
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

ConsoleSpec은 원하는 콘솔 동작의 사양입니다.

status

object

ConsoleStatus는 콘솔의 관찰 상태를 정의합니다.

5.1.1. .spec

설명
ConsoleSpec은 원하는 콘솔 동작의 사양입니다.
유형
object
속성유형설명

사용자 정의

object

사용자 지정은 선택적으로 웹 콘솔에 작은 사용자 지정 옵션 세트를 제공하는 데 사용됩니다.

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

plugins

배열(문자열)

플러그인은 활성화된 콘솔 플러그인 이름 목록을 정의합니다.

공급자

object

공급자에는 특정 서비스 공급자를 사용하기 위한 구성이 포함되어 있습니다.

라우트

object

route에는 제공 인증서가 포함된 호스트 이름 및 시크릿 참조가 포함되어 있습니다. 사용자 정의 경로가 지정되면 콘솔을 사용할 수 있는 제공된 호스트 이름으로 새 경로가 생성됩니다. 사용자 정의 호스트 이름의 경우 클러스터의 기본 라우팅 접미사를 사용하는 경우 제공 인증서에 대한 Secret 사양이 필요하지 않습니다. 사용자 지정 호스트 이름이 임의의 도메인을 가리키는 경우 수동 DNS 구성 단계가 필요합니다. 사용자 정의 경로가 제거된 경우 콘솔의 기본 호스트 이름을 예약하도록 기본 콘솔 경로가 유지 관리됩니다. 지정하지 않으면 기본 경로가 사용됩니다. 더 이상 사용되지 않음

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

5.1.2. .spec.customization

설명
사용자 지정은 선택적으로 웹 콘솔에 작은 사용자 지정 옵션 세트를 제공하는 데 사용됩니다.
유형
object
속성유형설명

addPage

object

AddPage를 사용하면 개발자 화면의 추가 페이지에서 작업을 사용자 지정할 수 있습니다.

브랜드

string

브랜드는 브랜드 필드를 제공하여 재정의할 수 있는 웹 콘솔의 기본 브랜드입니다. 제한된 특정 브랜드 옵션 세트가 있습니다. 이 필드는 로고와 같은 콘솔의 요소를 제어합니다. 잘못된 값은 콘솔 롤아웃을 방지합니다.

customLogoFile

object

customLogoFile은 마스트 헤드 및 소개 대화 상자의 기본 OpenShift 로고를 대체합니다. openshift-config 네임스페이스의 ConfigMap에 대한 참조입니다. 이는 'oc create configmap custom-logo --from-file=/path/to/file -n openshift-config'와 같은 명령을 사용하여 생성할 수 있습니다. ConfigMap 크기의 제약 조건으로 인해 이미지 크기가 1MB 미만이어야 합니다. ConfigMap 키에는 콘솔이 올바른 MIME 유형으로 파일을 제공하도록 파일 확장자가 포함되어야 합니다. 권장 로고 사양: Cryostats: 68px의 최대 높이 및 최대 너비의 200px SVG 형식

customProductName

string

customProductName은 일반 OpenShift 제품 이름 대신 페이지 제목, 로고 대체 텍스트 및 관련 대화 상자에 표시되는 이름입니다.

developerCatalog

object

developerCatalog를 사용하면 표시된 개발자 카탈로그 카테고리(필터) 및 유형(sub-catalogs)을 구성할 수 있습니다.

documentationBaseURL

string

외부 문서에 대한 documentationBaseURL 링크는 웹 콘솔의 다양한 섹션에 표시됩니다. documentationBaseURL을 제공하면 기본 문서 URL이 재정의됩니다. 잘못된 값은 콘솔 롤아웃을 방지합니다.

perspectives

array

관점을 사용하면 Perspective Switcher 드롭다운에서 사용자가 볼 수 있는 관점을 활성화/비활성화할 수 있습니다.

perspectives[]

object

 

projectAccess

object

ProjectAccess를 사용하면 개발자 화면 프로젝트 액세스 페이지에서 사용 가능한 ClusterRole 목록을 사용자 지정할 수 있으며 프로젝트 관리자가 다른 사용자에게 역할을 지정하고 프로젝트 내 액세스를 제한할 수 있습니다. 설정된 경우 목록은 기본 ClusterRole 옵션을 대체합니다.

퀵스타트

object

빠른 시작을 사용하면 콘솔에서 사용 가능한 ConsoleQuickStart 리소스를 사용자 지정할 수 있습니다.

5.1.3. .spec.customization.addPage

설명
AddPage를 사용하면 개발자 화면의 추가 페이지에서 작업을 사용자 지정할 수 있습니다.
유형
object
속성유형설명

disabledActions

배열(문자열)

DisabledActions는 사용자에게 표시되지 않는 작업 목록입니다. 목록의 각 작업은 해당 ID로 표시됩니다.

5.1.4. .spec.customization.customLogoFile

설명
customLogoFile은 마스트 헤드 및 소개 대화 상자의 기본 OpenShift 로고를 대체합니다. openshift-config 네임스페이스의 ConfigMap에 대한 참조입니다. 이는 'oc create configmap custom-logo --from-file=/path/to/file -n openshift-config'와 같은 명령을 사용하여 생성할 수 있습니다. ConfigMap 크기의 제약 조건으로 인해 이미지 크기가 1MB 미만이어야 합니다. ConfigMap 키에는 콘솔이 올바른 MIME 유형으로 파일을 제공하도록 파일 확장자가 포함되어야 합니다. 권장 로고 사양: Cryostats: 68px의 최대 높이 및 최대 너비의 200px SVG 형식
유형
object
속성유형설명

key

string

key를 사용하면 configmap 내의 특정 키/값을 가리킬 수 있습니다. 이는 논리 파일 참조에 유용합니다.

name

string

 

5.1.5. .spec.customization.developerCatalog

설명
developerCatalog를 사용하면 표시된 개발자 카탈로그 카테고리(필터) 및 유형(sub-catalogs)을 구성할 수 있습니다.
유형
object
속성유형설명

카테고리

array

개발자 카탈로그에 표시되는 카테고리입니다.

categories[]

object

개발자 콘솔 카탈로그의 DeveloperConsoleCatalogCategory.

유형

object

유형을 사용하면 개발자 카탈로그에서 사용자가 볼 수 있는 하위 컬렉션 유형을 활성화하거나 비활성화할 수 있습니다. 생략하면 모든 하위 카탈로그 유형이 표시됩니다.

5.1.6. .spec.customization.developerCatalog.categories

설명
개발자 카탈로그에 표시되는 카테고리입니다.
유형
array

5.1.7. .spec.customization.developerCatalog.categories[]

설명
개발자 콘솔 카탈로그의 DeveloperConsoleCatalogCategory.
유형
object
필수 항목
  • id
  • label
속성유형설명

id

string

ID는 콘솔에서 깊은 연결을 활성화하기 위해 URL에 사용되는 식별자입니다. ID는 필수이며 1~3~2개의 URL 안전(A-Z, a-z, 0-9, - 및 _) 문자가 있어야 합니다.

label

string

레이블은 카테고리 표시 레이블을 정의합니다. 필수이며 1~64자여야 합니다.

하위 범주

array

하위 범주는 하위 카테고리 목록을 정의합니다.

subcategories[]

object

DeveloperConsoleCatalogCategoryMeta는 개발자 카탈로그 카테고리의 주요 식별자입니다.

tags

배열(문자열)

태그는 카테고리와 일치하는 문자열 목록입니다. 선택한 카테고리는 범주와 항목 간에 겹치는 태그가 하나 이상 있는 모든 항목을 표시합니다.

5.1.8. .spec.customization.developerCatalog.categories[].subcategories

설명
하위 범주는 하위 카테고리 목록을 정의합니다.
유형
array

5.1.9. .spec.customization.developerCatalog.categories[].subcategories[]

설명
DeveloperConsoleCatalogCategoryMeta는 개발자 카탈로그 카테고리의 주요 식별자입니다.
유형
object
필수 항목
  • id
  • label
속성유형설명

id

string

ID는 콘솔에서 깊은 연결을 활성화하기 위해 URL에 사용되는 식별자입니다. ID는 필수이며 1~3~2개의 URL 안전(A-Z, a-z, 0-9, - 및 _) 문자가 있어야 합니다.

label

string

레이블은 카테고리 표시 레이블을 정의합니다. 필수이며 1~64자여야 합니다.

tags

배열(문자열)

태그는 카테고리와 일치하는 문자열 목록입니다. 선택한 카테고리는 범주와 항목 간에 겹치는 태그가 하나 이상 있는 모든 항목을 표시합니다.

5.1.10. .spec.customization.developerCatalog.types

설명
유형을 사용하면 개발자 카탈로그에서 사용자가 볼 수 있는 하위 컬렉션 유형을 활성화하거나 비활성화할 수 있습니다. 생략하면 모든 하위 카탈로그 유형이 표시됩니다.
유형
object
필수 항목
  • 상태
속성유형설명

비활성화됨

배열(문자열)

disabled는 사용자에게 표시되지 않는 개발자 카탈로그 유형(하위 카탈로그 ID) 목록입니다. 유형(sub-catalog)은 콘솔 플러그인을 통해 추가되며, 사용 가능한 유형(하위 카탈로그 ID)은 클러스터 구성 페이지의 콘솔에서 또는 콘솔에서 YAML을 편집할 때 사용할 수 있습니다. 예: "Devfile", "HelmChart", "BuilderImage" 목록이 비어 있거나 사용 가능한 모든 하위 카탈로그가 추가되면 전체 개발자 카탈로그를 숨겨야 합니다.

enabled

배열(문자열)

enabled는 사용자에게 표시되는 개발자 카탈로그 유형(하위 카탈로그 ID) 목록입니다. 유형(sub-catalog)은 콘솔 플러그인을 통해 추가되며, 사용 가능한 유형(하위 카탈로그 ID)은 클러스터 구성 페이지의 콘솔에서 또는 콘솔에서 YAML을 편집할 때 사용할 수 있습니다. 예: "Devfile", "HelmChart", "BuilderImage" 목록이 비어 있지 않으면 목록에 추가할 때까지 새 유형이 사용자에게 표시되지 않습니다. 목록이 비어 있으면 전체 개발자 카탈로그가 표시됩니다.

상태

string

State는 카탈로그 유형 목록을 활성화하거나 비활성화해야 하는지를 정의합니다.

5.1.11. .spec.customization.perspectives

설명
관점을 사용하면 Perspective Switcher 드롭다운에서 사용자가 볼 수 있는 관점을 활성화/비활성화할 수 있습니다.
유형
array

5.1.12. .spec.customization.perspectives[]

설명
유형
object
필수 항목
  • id
  • 가시성
속성유형설명

id

string

ID는 관점의 ID를 정의합니다. 예: "dev", "admin". 사용 가능한 관점 ID는 yaml 편집기 옆에 있는 코드 스니펫 섹션에서 확인할 수 있습니다. 올바르지 않거나 알 수 없는 ID는 무시됩니다.

가시성

object

가시성은 해당 관점에 필요한 경우 액세스 검토 검사와 함께 관점 상태를 정의합니다.

5.1.13. .spec.customization.perspectives[].visibility

설명
가시성은 해당 관점에 필요한 경우 액세스 검토 검사와 함께 관점 상태를 정의합니다.
유형
object
필수 항목
  • 상태
속성유형설명

accessReview

object

accessReview는 필수 및 누락된 액세스 검토 검사를 정의합니다.

상태

string

State는 관점을 활성화 또는 비활성화하거나 액세스 검토 검사가 필요합니다.

5.1.14. .spec.customization.perspectives[].visibility.accessReview

설명
accessReview는 필수 및 누락된 액세스 검토 검사를 정의합니다.
유형
object
속성유형설명

누락됨

array

missing은 권한 검사 목록을 정의합니다. 하나 이상의 검사가 실패하는 경우에만 관점이 표시됩니다. 생략하면 액세스 검토가 건너뛰고 필요한 액세스 검토 목록 구성에 따라 필요한 경우가 아니면 관점이 표시되지 않습니다.

missing[]

object

ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.

필수 항목

array

필수는 권한 검사 목록을 정의합니다. 관점은 모든 검사가 성공할 때만 표시됩니다. 생략하면 액세스 검토가 건너뛰고 누락된 액세스 검토 목록의 구성에 따라 필요한 경우가 아니면 관점이 표시되지 않습니다.

required[]

object

ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.

5.1.15. .spec.customization.perspectives[].visibility.accessReview.missing

설명
missing은 권한 검사 목록을 정의합니다. 하나 이상의 검사가 실패하는 경우에만 관점이 표시됩니다. 생략하면 액세스 검토가 건너뛰고 필요한 액세스 검토 목록 구성에 따라 필요한 경우가 아니면 관점이 표시되지 않습니다.
유형
array

5.1.16. .spec.customization.perspectives[].visibility.accessReview.missing[]

설명
ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
유형
object
속성유형설명

group

string

group은 리소스의 API 그룹입니다. "*"는 모든 것을 의미합니다.

name

string

name은 "get"에 대해 요청되거나 "삭제"에 대해 요청된 리소스의 이름입니다. ""(비어 있음)는 모두 의미합니다.

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 LocalSubjectAccessReviews ""(비어 있음)에 대해 네임스페이스와 모든 네임스페이스 ""(빈)가 기본적으로 비어 있는 경우 클러스터 범위 리소스 ""(빈)는 SubjectAccessReview 또는 SelfSubjectAccessReview의 네임스페이스 범위 리소스에 대해 "all"을 의미합니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다. "*"는 모든 것을 의미합니다.

하위 리소스

string

하위 리소스는 기존 리소스 유형 중 하나입니다. ""는 none을 의미합니다.

verb

string

동사는 get, list, watch, create, update, delete, proxy와 같은 kubernetes 리소스 API 동사입니다. "*"는 모든 것을 의미합니다.

version

string

버전은 리소스의 API 버전입니다. "*"는 모든 것을 의미합니다.

5.1.17. .spec.customization.perspectives[].visibility.accessReview.required

설명
필수는 권한 검사 목록을 정의합니다. 관점은 모든 검사가 성공할 때만 표시됩니다. 생략하면 액세스 검토가 건너뛰고 누락된 액세스 검토 목록의 구성에 따라 필요한 경우가 아니면 관점이 표시되지 않습니다.
유형
array

5.1.18. .spec.customization.perspectives[].visibility.accessReview.required[]

설명
ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
유형
object
속성유형설명

group

string

group은 리소스의 API 그룹입니다. "*"는 모든 것을 의미합니다.

name

string

name은 "get"에 대해 요청되거나 "삭제"에 대해 요청된 리소스의 이름입니다. ""(비어 있음)는 모두 의미합니다.

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 LocalSubjectAccessReviews ""(비어 있음)에 대해 네임스페이스와 모든 네임스페이스 ""(빈)가 기본적으로 비어 있는 경우 클러스터 범위 리소스 ""(빈)는 SubjectAccessReview 또는 SelfSubjectAccessReview의 네임스페이스 범위 리소스에 대해 "all"을 의미합니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다. "*"는 모든 것을 의미합니다.

하위 리소스

string

하위 리소스는 기존 리소스 유형 중 하나입니다. ""는 none을 의미합니다.

verb

string

동사는 get, list, watch, create, update, delete, proxy와 같은 kubernetes 리소스 API 동사입니다. "*"는 모든 것을 의미합니다.

version

string

버전은 리소스의 API 버전입니다. "*"는 모든 것을 의미합니다.

5.1.19. .spec.customization.projectAccess

설명
ProjectAccess를 사용하면 개발자 화면 프로젝트 액세스 페이지에서 사용 가능한 ClusterRole 목록을 사용자 지정할 수 있으며 프로젝트 관리자가 다른 사용자에게 역할을 지정하고 프로젝트 내 액세스를 제한할 수 있습니다. 설정된 경우 목록은 기본 ClusterRole 옵션을 대체합니다.
유형
object
속성유형설명

availableClusterRoles

배열(문자열)

availableClusterRoles는 프로젝트 액세스 탭을 통해 사용자에게 할당할 수 있는 ClusterRole 이름 목록입니다.

5.1.20. .spec.customization.quickStarts

설명
빠른 시작을 사용하면 콘솔에서 사용 가능한 ConsoleQuickStart 리소스를 사용자 지정할 수 있습니다.
유형
object
속성유형설명

비활성화됨

배열(문자열)

disabled는 사용자에게 표시되지 않는 ConsoleQuickStart 리소스 이름 목록입니다.

5.1.21. .spec.providers

설명
공급자에는 특정 서비스 공급자를 사용하기 위한 구성이 포함되어 있습니다.
유형
object
속성유형설명

statuspage

object

Statuspage에는 status info about을 제공하는 statuspage.io 페이지의 ID가 포함되어 있습니다.

5.1.22. .spec.providers.statuspage

설명
Statuspage에는 status info about을 제공하는 statuspage.io 페이지의 ID가 포함되어 있습니다.
유형
object
속성유형설명

pageID

string

pageid는 페이지에 대한 Statuspage에서 할당한 고유한 ID입니다. 이는 공개 페이지여야 합니다.

5.1.23. .spec.route

설명
route에는 제공 인증서가 포함된 호스트 이름 및 시크릿 참조가 포함되어 있습니다. 사용자 정의 경로가 지정되면 콘솔을 사용할 수 있는 제공된 호스트 이름으로 새 경로가 생성됩니다. 사용자 정의 호스트 이름의 경우 클러스터의 기본 라우팅 접미사를 사용하는 경우 제공 인증서에 대한 Secret 사양이 필요하지 않습니다. 사용자 지정 호스트 이름이 임의의 도메인을 가리키는 경우 수동 DNS 구성 단계가 필요합니다. 사용자 정의 경로가 제거된 경우 콘솔의 기본 호스트 이름을 예약하도록 기본 콘솔 경로가 유지 관리됩니다. 지정하지 않으면 기본 경로가 사용됩니다. DEPRECATED
유형
object
속성유형설명

hostname

string

hostname은 콘솔을 사용할 수 있는 원하는 사용자 정의 도메인입니다.

Secret

object

시크릿은 사용자 정의 인증서 및 키가 포함된 openshift-config 네임스페이스의 시크릿을 가리키며 클러스터 관리자가 수동으로 생성해야 합니다. 참조된 시크릿은 다음 키 값 쌍을 포함해야 합니다. - "tls.crt" - 사용자 정의 인증서 - "tls.key" - 사용자 정의 인증서의 개인 키를 지정하는 데 사용자 정의 인증서의 개인 키를 지정하는 경우 사용자 정의 호스트 이름이 클러스터의 기본 라우팅 접미사를 사용하는 경우 제공 인증서에 대한 시크릿 사양이 필요하지 않습니다.

5.1.24. .spec.route.secret

설명
시크릿은 사용자 정의 인증서 및 키가 포함된 openshift-config 네임스페이스의 시크릿을 가리키며 클러스터 관리자가 수동으로 생성해야 합니다. 참조된 시크릿은 다음 키 값 쌍을 포함해야 합니다. - "tls.crt" - 사용자 정의 인증서 - "tls.key" - 사용자 정의 인증서의 개인 키를 지정하는 데 사용자 정의 인증서의 개인 키를 지정하는 경우 사용자 정의 호스트 이름이 클러스터의 기본 라우팅 접미사를 사용하는 경우 제공 인증서에 대한 시크릿 사양이 필요하지 않습니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

5.1.25. .status

설명
ConsoleStatus는 콘솔의 관찰 상태를 정의합니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

5.1.26. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

5.1.27. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

5.1.28. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

5.1.29. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

5.2. API 끝점

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

  • /apis/operator.openshift.io/v1/consoles

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

    • DELETE: 콘솔 삭제
    • GET: 지정된 콘솔 읽기
    • PATCH: 지정된 콘솔을 부분적으로 업데이트
    • PUT: 지정된 콘솔을 교체
  • /apis/operator.openshift.io/v1/consoles/{name}/status

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

5.2.1. /apis/operator.openshift.io/v1/consoles

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

string

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

HTTP 방법
DELETE
설명
콘솔 컬렉션 삭제
표 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
설명
콘솔 오브젝트 나열
표 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

ConsoleList 스키마

401 - 무단

HTTP 방법
POST
설명
콘솔 생성
표 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

콘솔 스키마

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

200 - OK

콘솔 스키마

201 - 생성됨

콘솔 스키마

202 - 승인됨

콘솔 스키마

401 - 무단

5.2.2. /apis/operator.openshift.io/v1/consoles/{name}

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

name

string

콘솔 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

콘솔 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 콘솔을 부분적으로 업데이트
표 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

콘솔 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 콘솔 교체
표 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

콘솔 스키마

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

200 - OK

콘솔 스키마

201 - 생성됨

콘솔 스키마

401 - 무단

5.2.3. /apis/operator.openshift.io/v1/consoles/{name}/status

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

name

string

콘솔 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

콘솔 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 콘솔의 부분적으로 업데이트
표 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

콘솔 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 콘솔의 상태 교체
표 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

콘솔 스키마

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

200 - OK

콘솔 스키마

201 - 생성됨

콘솔 스키마

401 - 무단

6장. Config [operator.openshift.io/v1]

설명
config는 클러스터에서 다른 구성 요소의 초기 구성을 생성하는 config Operator의 동작을 지정합니다. Operator는 AWS 및 Azure 클라우드 기반 클러스터 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 클라우드 구성의 설치, 마이그레이션 또는 동기화를 처리합니다.
유형
object
필수 항목
  • spec

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

spec은 Config Operator의 원하는 동작의 사양입니다.

status

object

Status는 Config Operator의 관찰 상태를 정의합니다.

6.1.1. .spec

설명
spec은 Config Operator의 원하는 동작의 사양입니다.
유형
object
속성유형설명

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

6.1.2. .status

설명
Status는 Config Operator의 관찰 상태를 정의합니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

6.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

6.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

6.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

6.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

6.2. API 끝점

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

  • /apis/operator.openshift.io/v1/configs

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

    • DELETE: Config 삭제
    • GET: 지정된 구성 읽기
    • PATCH: 지정된 Config를 부분적으로 업데이트
    • PUT: 지정된 구성의 교체
  • /apis/operator.openshift.io/v1/configs/{name}/status

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

6.2.1. /apis/operator.openshift.io/v1/configs

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

string

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

HTTP 방법
DELETE
설명
구성 컬렉션 삭제
표 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
설명
종류 Config의 오브젝트 나열
표 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

ConfigList schema

401 - 무단

HTTP 방법
POST
설명
구성 생성
표 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

구성 스키마

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

200 - OK

구성 스키마

201 - 생성됨

구성 스키마

202 - 승인됨

구성 스키마

401 - 무단

6.2.2. /apis/operator.openshift.io/v1/configs/{name}

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

name

string

구성의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

구성 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 구성 부분 업데이트
표 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

구성 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 구성 교체
표 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

구성 스키마

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

200 - OK

구성 스키마

201 - 생성됨

구성 스키마

401 - 무단

6.2.3. /apis/operator.openshift.io/v1/configs/{name}/status

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

name

string

구성의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

구성 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 구성의 부분적으로 업데이트
표 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

구성 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 구성의 상태 교체
표 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

구성 스키마

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

200 - OK

구성 스키마

201 - 생성됨

구성 스키마

401 - 무단

7장. Config [imageregistry.operator.openshift.io/v1]

설명
구성은 레지스트리 Operator 호환성 수준 1에서 관리하는 레지스트리 인스턴스의 구성 오브젝트입니다. 최소 12개월 또는 3개의 마이너 릴리스(더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • 메타데이터
  • spec

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

ImageRegistrySpec은 실행 중인 레지스트리에 대한 사양을 정의합니다.

status

object

ImageRegistryStatus에서 이미지 레지스트리 작동 상태를 보고합니다.

7.1.1. .spec

설명
ImageRegistrySpec은 실행 중인 레지스트리에 대한 사양을 정의합니다.
유형
object
필수 항목
  • replicas
속성유형설명

유사성

object

유사성은 이미지 레지스트리 Pod에 대한 노드 유사성 스케줄링 규칙 그룹입니다.

defaultRoute

boolean

DefaultRoute는 생성된 기본 호스트 이름을 사용하여 레지스트리의 외부 연결 경로를 생성해야 하는지 여부를 나타냅니다.

disableRedirect

boolean

disableRedirect는 백엔드로 리디렉션되는 대신 레지스트리를 통해 모든 데이터를 라우팅할지 여부를 제어합니다.

httpSecret

string

httpSecret은 기본적으로 생성된 업로드를 보호하기 위해 레지스트리에 필요한 값입니다.

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

logging

integer

로깅은 더 이상 사용되지 않으며 대신 logLevel을 사용합니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

nodeSelector

오브젝트(문자열)

nodeSelector는 레지스트리 Pod의 노드 선택 제약 조건을 정의합니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

proxy

object

proxy는 마스터 api, 업스트림 레지스트리 등을 호출할 때 사용할 프록시를 정의합니다.

readOnly

boolean

readonly는 레지스트리 인스턴스가 새 이미지를 푸시하거나 기존 이미지를 삭제하려는 시도를 거부해야 하는지 여부를 나타냅니다.

replicas

integer

복제본은 실행할 레지스트리 인스턴스 수를 결정합니다.

requests

object

요청은 추가 요청을 큐에 추가하기 전에 지정된 레지스트리 인스턴스가 처리할 병렬 요청 수를 제어합니다.

resources

object

resources는 레지스트리 Pod의 리소스 requests+limits를 정의합니다.

rolloutStrategy

string

rolloutStrategy는 이미지 레지스트리 배포에 대한 롤아웃 전략을 정의합니다.

routes

array

경로는 레지스트리에 대해 생성해야 하는 추가 외부 연결 경로를 정의합니다.

routes[]

object

ImageRegistryConfigRoute는 이미지 레지스트리에 대한 외부 경로 액세스에 대한 정보를 보유합니다.

storage

object

레지스트리 스토리지 구성을 위한 스토리지 세부 정보(예: S3 버킷 조정).

허용 오차

array

허용 오차는 레지스트리 Pod의 허용 오차를 정의합니다.

tolerations[]

object

이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.

topologySpreadConstraints

array

TopologySpreadConstraints는 지정된 토폴로지에 일치하는 Pod를 분배하는 방법을 지정합니다.

topologySpreadConstraints[]

object

TopologySpreadConstraint는 지정된 토폴로지에 일치하는 Pod를 분배하는 방법을 지정합니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

7.1.2. .spec.affinity

설명
유사성은 이미지 레지스트리 Pod에 대한 노드 유사성 스케줄링 규칙 그룹입니다.
유형
object
속성유형설명

nodeAffinity

object

Pod의 노드 유사성 스케줄링 규칙을 설명합니다.

podAffinity

object

Pod 유사성 예약 규칙에 대해 설명합니다(예: 다른 Pod와 동일한 노드, 영역 등에서 이 Pod를 공동 배치).

podAntiAffinity

object

Pod 유사성 방지 스케줄링 규칙을 설명합니다. 예를 들어 이 Pod를 다른 Pod와 동일한 노드, 영역에 배치하지 않도록 합니다.

7.1.3. .spec.affinity.nodeAffinity

설명
Pod의 노드 유사성 스케줄링 규칙을 설명합니다.
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 노드이며, 이 필드의 요소를 반복하고 노드가 해당 matchExpressions와 일치하는 경우 "weight"을 합계에 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

권장되는 빈 스케줄링 용어는 암시적 가중치가 0인 모든 오브젝트와 일치합니다(즉, no-op임). null 기본 스케줄링 용어는 오브젝트(즉, no-op)와 일치하지 않습니다.

requiredDuringSchedulingIgnoredDuringExecution

object

이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다.

7.1.4. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 노드이며, 이 필드의 요소를 반복하고 노드가 해당 matchExpressions와 일치하는 경우 "weight"을 합계에 추가하여 합계를 더 많이 계산합니다.
유형
array

7.1.5. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
권장되는 빈 스케줄링 용어는 암시적 가중치가 0인 모든 오브젝트와 일치합니다(즉, no-op임). null 기본 스케줄링 용어는 오브젝트(즉, no-op)와 일치하지 않습니다.
유형
object
필수 항목
  • preference
  • weight
속성유형설명

preference

object

해당 가중치와 연결된 노드 선택기 용어입니다.

weight

integer

1-100 범위의 해당 nodeSelectorTerm과 일치하는 가중치입니다.

7.1.6. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference

설명
해당 가중치와 연결된 노드 선택기 용어입니다.
유형
object
속성유형설명

matchExpressions

array

노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.

matchExpressions[]

object

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

matchFields

array

노드의 필드별 노드 선택기 요구 사항 목록입니다.

matchFields[]

object

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

7.1.7. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions

설명
노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
유형
array

7.1.8. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions[]

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

key

string

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

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

7.1.9. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields

설명
노드의 필드별 노드 선택기 요구 사항 목록입니다.
유형
array

7.1.10. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields[]

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

key

string

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

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

7.1.11. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다.
유형
object
필수 항목
  • nodeSelectorTerms
속성유형설명

nodeSelectorTerms

array

필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다.

nodeSelectorTerms[]

object

null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.

7.1.12. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms

설명
필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다.
유형
array

7.1.13. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[]

설명
null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.
유형
object
속성유형설명

matchExpressions

array

노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.

matchExpressions[]

object

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

matchFields

array

노드의 필드별 노드 선택기 요구 사항 목록입니다.

matchFields[]

object

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

7.1.14. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions

설명
노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
유형
array

7.1.15. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions[]

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

key

string

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

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

7.1.16. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields

설명
노드의 필드별 노드 선택기 요구 사항 목록입니다.
유형
array

7.1.17. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields[]

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

key

string

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

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

7.1.18. .spec.affinity.podAffinity

설명
Pod 유사성 예약 규칙에 대해 설명합니다(예: 다른 Pod와 동일한 노드, 영역 등에서 이 Pod를 공동 배치).
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 합계에 "weight"을 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.

requiredDuringSchedulingIgnoredDuringExecution

array

이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: Pod 레이블 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.

requiredDuringSchedulingIgnoredDuringExecution[]

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

7.1.19. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 합계에 "weight"을 추가하여 합계를 더 많이 계산합니다.
유형
array

7.1.20. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.
유형
object
필수 항목
  • podAffinityTerm
  • weight
속성유형설명

podAffinityTerm

object

필수 항목입니다. 해당 가중치와 연결된 Pod 유사성 용어입니다.

weight

integer

1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다.

7.1.21. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

설명
필수 항목입니다. 해당 가중치와 연결된 Pod 유사성 용어입니다.
유형
object
필수 항목
  • topologyKey
속성유형설명

labelSelector

object

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

object

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

topologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

7.1.22. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector

설명
리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

7.1.23. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions

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

7.1.24. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

7.1.25. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector

설명
용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

7.1.26. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions

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

7.1.27. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

7.1.28. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: Pod 레이블 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.
유형
array

7.1.29. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • TopologyKey
속성유형설명

labelSelector

object

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

object

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

TopologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

7.1.30. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector

설명
리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

7.1.31. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions

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

7.1.32. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

7.1.33. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector

설명
용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

7.1.34. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions

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

7.1.35. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

7.1.36. .spec.affinity.podAntiAffinity

설명
Pod 유사성 방지 스케줄링 규칙을 설명합니다. 예를 들어 이 Pod를 다른 Pod와 동일한 노드, 영역에 배치하지 않도록 합니다.
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 유사성 방지 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling anti-affinity expressions 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 "weight"을 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.

requiredDuringSchedulingIgnoredDuringExecution

array

이 필드에 지정된 유사성 방지 요구 사항이 스케줄링 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. 이 필드에 지정된 유사성 방지 요구 사항이 Pod 실행 중 일정 시점에 충족되지 않는 경우(예: Pod 라벨 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.

requiredDuringSchedulingIgnoredDuringExecution[]

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

7.1.37. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 유사성 방지 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling anti-affinity expressions 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 "weight"을 추가하여 합계를 더 많이 계산합니다.
유형
array

7.1.38. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.
유형
object
필수 항목
  • podAffinityTerm
  • weight
속성유형설명

podAffinityTerm

object

필수 항목입니다. 해당 가중치와 연결된 Pod 유사성 용어입니다.

weight

integer

1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다.

7.1.39. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

설명
필수 항목입니다. 해당 가중치와 연결된 Pod 유사성 용어입니다.
유형
object
필수 항목
  • topologyKey
속성유형설명

labelSelector

object

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

object

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

topologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

7.1.40. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector

설명
리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

7.1.41. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions

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

7.1.42. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

7.1.43. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector

설명
용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

7.1.44. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions

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

7.1.45. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

7.1.46. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
이 필드에 지정된 유사성 방지 요구 사항이 스케줄링 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. 이 필드에 지정된 유사성 방지 요구 사항이 Pod 실행 중 일정 시점에 충족되지 않는 경우(예: Pod 라벨 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.
유형
array

7.1.47. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • topologyKey
속성유형설명

labelSelector

object

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

object

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

topologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

7.1.48. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector

설명
리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

7.1.49. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions

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

7.1.50. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

7.1.51. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector

설명
용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

7.1.52. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions

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

7.1.53. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

7.1.54. .spec.proxy

설명
proxy는 마스터 api, 업스트림 레지스트리 등을 호출할 때 사용할 프록시를 정의합니다.
유형
object
속성유형설명

http

string

HTTP는 HTTP 끝점에 액세스할 때 이미지 레지스트리에서 사용할 프록시를 정의합니다.

https

string

HTTPS는 HTTPS 끝점에 액세스할 때 이미지 레지스트리에서 사용할 프록시를 정의합니다.

noProxy

string

noProxy는 프록시를 통과하지 않아야 하는 쉼표로 구분된 호스트 이름 목록을 정의합니다.

7.1.55. .spec.requests

설명
요청은 추가 요청을 큐에 추가하기 전에 지정된 레지스트리 인스턴스가 처리할 병렬 요청 수를 제어합니다.
유형
object
속성유형설명

읽기

object

read는 이미지 레지스트리의 읽기에 대한 제한을 정의합니다.

쓰기

object

write는 이미지 레지스트리의 쓰기에 대한 제한을 정의합니다.

7.1.56. .spec.requests.read

설명
read는 이미지 레지스트리의 읽기에 대한 제한을 정의합니다.
유형
object
속성유형설명

maxInQueue

integer

maxInQueue는 최대 대기열에 있는 API 요청을 레지스트리에 설정합니다.

maxRunning

integer

maxRunning은et api 요청의 최대 수를 레지스트리에 설정합니다.

maxWaitInQueue

string

maxWaitInQueue는 요청이 거부되기 전에 큐에서 대기할 수 있는 최대 시간을 설정합니다.

7.1.57. .spec.requests.write

설명
write는 이미지 레지스트리의 쓰기에 대한 제한을 정의합니다.
유형
object
속성유형설명

maxInQueue

integer

maxInQueue는 최대 대기열에 있는 API 요청을 레지스트리에 설정합니다.

maxRunning

integer

maxRunning은et api 요청의 최대 수를 레지스트리에 설정합니다.

maxWaitInQueue

string

maxWaitInQueue는 요청이 거부되기 전에 큐에서 대기할 수 있는 최대 시간을 설정합니다.

7.1.58. .spec.resources

설명
resources는 레지스트리 Pod의 리소스 requests+limits를 정의합니다.
유형
object
속성유형설명

limits

integer-or-string

제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

7.1.59. .spec.routes

설명
경로는 레지스트리에 대해 생성해야 하는 추가 외부 연결 경로를 정의합니다.
유형
array

7.1.60. .spec.routes[]

설명
ImageRegistryConfigRoute는 이미지 레지스트리에 대한 외부 경로 액세스에 대한 정보를 보유합니다.
유형
object
필수 항목
  • name
속성유형설명

hostname

string

경로의 호스트 이름입니다.

name

string

생성할 경로의 이름입니다.

secretName

string

secretName은 경로에서 사용할 인증서가 포함된 시크릿을 가리킵니다.

7.1.61. .spec.storage

설명
레지스트리 스토리지 구성을 위한 스토리지 세부 정보(예: S3 버킷 조정).
유형
object
속성유형설명

azure

object

Azure는 Azure Blob Storage를 사용하는 구성을 나타냅니다.

emptyDir

object

emptyDir은 Pod의 호스트 노드의 임시 스토리지를 나타냅니다. 경고: 이 스토리지는 1개 이상의 복제본과 함께 사용할 수 없으며 프로덕션 용도로는 적합하지 않습니다. 어떠한 이유로든 노드에서 Pod가 제거되면 emptyDir의 데이터가 영구적으로 삭제됩니다.

gcs

object

GCS는 Google Cloud Storage를 사용하는 설정을 나타냅니다.

ibmcos

object

IBM Cloud Object Storage를 사용하는 구성을 나타냅니다.

managementState

string

managementState는 운영자가 기본 스토리지 장치를 관리하는지 여부를 나타냅니다. Managed인 경우 Operator는 이 Operator가 제거될 때 스토리지를 제거합니다.

OSS

object

OSS는 Alibaba Cloud Object Storage 서비스를 사용하는 구성을 나타냅니다.

pvc

object

PVC는 PersistentVolumeClaim을 사용하는 구성을 나타냅니다.

s3

object

S3는 Amazon Simple Storage Service를 사용하는 구성을 나타냅니다.

swift

object

Swift는 OpenStack 오브젝트 스토리지를 사용하는 구성을 나타냅니다.

7.1.62. .spec.storage.azure

설명
Azure는 Azure Blob Storage를 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

accountName

string

AccountName은 레지스트리에서 사용할 계정을 정의합니다.

cloudName

string

cloudName은 레지스트리에서 사용할 Azure 클라우드 환경의 이름입니다. 비어 있는 경우 Operator는 인프라 오브젝트를 기반으로 설정합니다.

container

string

컨테이너는 레지스트리에서 사용할 Azure의 컨테이너를 정의합니다.

7.1.63. .spec.storage.emptyDir

설명
emptyDir은 Pod의 호스트 노드의 임시 스토리지를 나타냅니다. 경고: 이 스토리지는 1개 이상의 복제본과 함께 사용할 수 없으며 프로덕션 용도로는 적합하지 않습니다. 어떠한 이유로든 노드에서 Pod가 제거되면 emptyDir의 데이터가 영구적으로 삭제됩니다.
유형
object

7.1.64. .spec.storage.gcs

설명
GCS는 Google Cloud Storage를 사용하는 설정을 나타냅니다.
유형
object
속성유형설명

bucket

string

버킷은 레지스트리의 데이터를 저장할 버킷 이름입니다. 선택 사항이며 제공되지 않는 경우 생성됩니다.

keyID

string

keyID는 암호화에 사용할 KMS 키 ID입니다. 선택 사항, 버킷은 기본적으로 GCP에서 암호화됩니다. 이를 통해 사용자 지정 암호화 키를 사용할 수 있습니다.

projectID

string

projectID는 이 버킷을 연결해야 하는 GCP 프로젝트의 프로젝트 ID입니다.

region

string

리전은 버킷이 있는 GCS 위치입니다. 선택 사항이며 설치된 GCS 지역에 따라 설정됩니다.

7.1.65. .spec.storage.ibmcos

설명
IBM Cloud Object Storage를 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

bucket

string

버킷은 레지스트리의 데이터를 저장할 버킷 이름입니다. 선택 사항이며 제공되지 않는 경우 생성됩니다.

위치

string

위치는 버킷이 있는 IBM Cloud 위치입니다. 선택 사항: 설치된 IBM Cloud 위치에 따라 설정됩니다.

resourceGroupName

string

resourceGroupName은 이 버킷과 해당 서비스 인스턴스가 연결된 IBM Cloud 리소스 그룹의 이름입니다. 선택 사항이며 설치된 IBM Cloud 리소스 그룹에 따라 설정됩니다.

resourceKeyCRN

string

resourceKeyCRN은 서비스 인스턴스에 대해 생성된 IBM Cloud 리소스 키의 CRN입니다. 일반적으로 서비스 자격 증명이라고 하며 HMAC 유형 인증 정보를 포함해야 합니다. 선택 사항이며 제공되지 않는 경우 계산됩니다.

serviceInstanceCRN

string

ServiceInstanceCRN은 이 버킷이 연결된 IBM Cloud Object Storage 서비스 인스턴스의 CRN입니다. 선택 사항이며 제공되지 않는 경우 계산됩니다.

7.1.66. .spec.storage.oss

설명
OSS는 Alibaba Cloud Object Storage 서비스를 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

bucket

string

버킷은 레지스트리의 데이터를 저장할 버킷 이름입니다. 버킷 이름 지정에 대한 자세한 내용은 [공식 문서](https://www.alibabacloud.com/help/doc-detail/257087.htm) 빈 값을 볼 수 있다는 것은 의견이 없으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 기본값을 선택합니다. 현재 기본값은 <clusterid>-image-registry-<region>-<random 문자열 27 자> 형식으로 자동 생성됩니다.

Encryption

object

Encryption은 서버 측에서 데이터를 암호화할지 여부를 지정합니다. 자세한 내용은 [공식 문서](https://www.alibabacloud.com/help/doc-detail/117914.htm참조하십시오.

endpointAccessibility

string

EndpointAccessibility는 레지스트리가 OSS VPC 내부 엔드포인트 Empty 값을 사용하는지 여부를 나타내며 플랫폼은 시간이 지남에 따라 변경될 수 있는 기본값을 선택합니다. 현재 기본값은 Internal 입니다.

region

string

리전은 버킷이 있는 Alibaba Cloud 리전입니다. 리전 목록은 [공식 문서](https://www.alibabacloud.com/help/doc-detail/31837.html)를 참조하십시오. 빈 값은 의견이 없으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 기본값을 선택합니다. 현재 기본값은 설치된 Alibaba Cloud 리전을 기반으로 합니다.

7.1.67. .spec.storage.oss.encryption

설명
Encryption은 서버 측에서 데이터를 암호화할지 여부를 지정합니다. 자세한 내용은 [공식 문서](https://www.alibabacloud.com/help/doc-detail/117914.htm참조하십시오.
유형
object
속성유형설명

kms

object

KMS (키 관리 서비스)는 KMS KeyID의 구조를 보유하는 암호화 유형입니다.

method

string

메서드는 사용 가능한 다른 암호화 모드를 정의하므로 의견이 없으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 기본값을 선택합니다. 현재 기본값은 AES256 입니다.

7.1.68. .spec.storage.oss.encryption.kms

설명
KMS (키 관리 서비스)는 KMS KeyID의 구조를 보유하는 암호화 유형입니다.
유형
object
필수 항목
  • keyID
속성유형설명

keyID

string

KeyID에는 KMS 암호화 키 ID가 있습니다.

7.1.69. .spec.storage.pvc

설명
PVC는 PersistentVolumeClaim을 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

claim

string

클레임은 사용할 영구 볼륨 클레임의 이름을 정의합니다.

7.1.70. .spec.storage.s3

설명
S3는 Amazon Simple Storage Service를 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

bucket

string

버킷은 레지스트리의 데이터를 저장할 버킷 이름입니다. 선택 사항이며 제공되지 않는 경우 생성됩니다.

cloudFront

object

CloudFront는 Amazon Cloudfront를 레지스트리에서 스토리지 미들웨어로 설정합니다.

encrypt

boolean

encrypt는 레지스트리가 이미지를 암호화된 형식으로 저장할지 여부를 지정합니다. 선택 사항이며 기본값은 false입니다.

keyID

string

keyID는 암호화에 사용할 KMS 키 ID입니다. 선택 사항, Encrypt는 true여야 합니다. 그렇지 않으면 이 매개변수가 무시됩니다.

region

string

리전은 버킷이 있는 AWS 리전입니다. 선택 사항이며 설치된 AWS 리전을 기반으로 설정됩니다.

regionEndpoint

string

RegionEndpoint는 S3 호환 스토리지 서비스의 끝점입니다. 지정된 지역에 따라 선택적 기본값입니다.

trustedCA

object

trustedCA는 CA 번들이 포함된 구성 맵에 대한 참조입니다. 이미지 레지스트리와 해당 Operator는 이 번들의 인증서를 사용하여 S3 서버 인증서를 확인합니다. trustedCA에서 참조하는 구성 맵의 네임스페이스는 "openshift-config"입니다. 구성 맵의 번들 키는 "ca-bundle.crt"입니다.

virtualHostedStyle

boolean

virtualHostedStyle은 사용자 지정 RegionEndpoint Optional과 함께 S3 가상 호스팅 스타일 버킷 경로를 사용할 수 있으며 기본값은 false입니다.

7.1.71. .spec.storage.s3.cloudFront

설명
CloudFront는 Amazon Cloudfront를 레지스트리에서 스토리지 미들웨어로 설정합니다.
유형
object
필수 항목
  • baseURL
  • keypairID
  • privateKey
속성유형설명

baseURL

string

baseurl에는 Cloudfront가 제공되는 SCHEME://HOST[/PATH]가 포함되어 있습니다.

duration

string

기간은 Cloudfront 세션의 기간입니다.

keypairID

string

keypairID는 AWS에서 제공하는 키 쌍 ID입니다.

privateKey

object

privateKey는 AWS에서 제공하는 개인 키가 포함된 시크릿을 가리킵니다.

7.1.72. .spec.storage.s3.cloudFront.privateKey

설명
privateKey는 AWS에서 제공하는 개인 키가 포함된 시크릿을 가리킵니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

7.1.73. .spec.storage.s3.trustedCA

설명
trustedCA는 CA 번들이 포함된 구성 맵에 대한 참조입니다. 이미지 레지스트리와 해당 Operator는 이 번들의 인증서를 사용하여 S3 서버 인증서를 확인합니다. trustedCA에서 참조하는 구성 맵의 네임스페이스는 "openshift-config"입니다. 구성 맵의 번들 키는 "ca-bundle.crt"입니다.
유형
object
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다. 이 필드는 표준 구성 맵 이름 지정 제한을 준수해야 합니다. 이름은 영숫자, 하이픈(-) 및 마침표(..)로만 구성되어야 합니다. 최대 길이는 253자입니다. 이 필드를 지정하지 않거나 빈 문자열인 경우 기본 신뢰 번들이 사용됩니다.

7.1.74. .spec.storage.swift

설명
Swift는 OpenStack 오브젝트 스토리지를 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

authURL

string

authURL은 인증 토큰을 얻기 위한 URL을 정의합니다.

authVersion

string

authVersion은 OpenStack Auth 버전을 지정합니다.

container

string

컨테이너는 레지스트리의 데이터를 저장할 Swift 컨테이너의 이름을 정의합니다.

domain

string

domain은 Identity v3 API의 Openstack의 도메인 이름을 지정합니다.

domainID

string

domainID는 ID v3 API에 대한 Openstack의 도메인 ID를 지정합니다.

regionName

string

RegionName은 컨테이너가 존재하는 Openstack 영역을 정의합니다.

tenant

string

테넌트는 레지스트리에서 사용할 Openstack 테넌트 이름을 정의합니다.

tenantID

string

테넌트는 레지스트리에서 사용할 Openstack 테넌트 ID를 정의합니다.

7.1.75. .spec.tolerations

설명
허용 오차는 레지스트리 Pod의 허용 오차를 정의합니다.
유형
array

7.1.76. .spec.tolerations[]

설명
이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.
유형
object
속성유형설명

effect

string

effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

key

string

키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다.

operator

string

Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다.

tolerationSeconds

integer

tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다.

value

string

값은 허용 오차와 일치하는 taint 값입니다. 연산자가 Exists인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다.

7.1.77. .spec.topologySpreadConstraints

설명
TopologySpreadConstraints는 지정된 토폴로지에 일치하는 Pod를 분배하는 방법을 지정합니다.
유형
array

7.1.78. .spec.topologySpreadConstraints[]

설명
TopologySpreadConstraint는 지정된 토폴로지에 일치하는 Pod를 분배하는 방법을 지정합니다.
유형
object
필수 항목
  • maxSkew
  • TopologyKey
  • whenUnsatisfiable
속성유형설명

labelSelector

object

labelSelector는 일치하는 포드를 찾는 데 사용됩니다. 이 라벨 선택기와 일치하는 Pod는 해당 토폴로지 도메인의 Pod 수를 확인하기 위해 계산됩니다.

matchLabelKeys

배열(문자열)

MatchLabelKeys는 분배를 계산할 Pod를 선택하는 Pod 레이블 키 집합입니다. 키는 들어오는 Pod 라벨에서 값을 조회하는 데 사용되며, 해당 키-값 레이블은 labelSelector와 함께 사용되어 들어오는 포드에 대해 분산이 계산될 기존 포드 그룹을 선택합니다. 들어오는 Pod 라벨에 없는 키는 무시됩니다. null 또는 빈 목록은 labelSelector와만 일치함을 의미합니다.

maxSkew

integer

MaxSkew는 Pod를 균등하게 배포할 수 있는 정도를 설명합니다. whenUnsatisfiable=DoNotSchedule 에서는 대상 토폴로지에서 일치하는 Pod 수와 글로벌 최소값 간에 허용되는 최대 차이입니다. 글로벌 최소는 적격 도메인의 일치하는 최소 Pod 수 또는 적격 도메인 수가 MinDomains보다 작은 경우 0입니다. 예를 들어 3 영역 클러스터에서 MaxSkew는 1로 설정되고 labelSelector가 2/2/1과 동일한 Pod가 있습니다. 이 경우 글로벌 최소값은 1입니다. | zone1 | zone2 | zone2 | zone3 | | P | P | - MaxSkew가 1이면 들어오는 Pod를 2/2/2가 되도록 영역3으로 예약할 수 있습니다. zone1(zone2)에 예약하면 zone1(zone2)이 MaxSkew(1)를 위반하면 최대Skew(1)를 위반할 수 있습니다. - 최대Skew(1)를 위반하면 최대Skew(1)를 예약할 수 있습니다. whenUnsatisfiable=ScheduleAnyway 는 이를 충족하는 토폴로지에 더 높은 우선 순위를 부여하는 데 사용됩니다. 필수 필드입니다. 기본값은 1이고 0은 허용되지 않습니다.

minDomains

integer

MinDomains는 적격 도메인의 최소 수를 나타냅니다. 토폴로지 키가 일치하는 적격 도메인의 수가 minDomains보다 작으면 Pod Topology Spread가 "global minimum"을 0으로 처리한 다음 Skew 계산을 수행합니다. 그리고 토폴로지 키가 일치하는 적격 도메인의 수가 minDomains보다 크거나 같으면 이 값은 예약에 영향을 미치지 않습니다. 결과적으로 적격 도메인의 수가 minDomains보다 작으면 스케줄러는 해당 도메인에 maxSkew Pod 이상을 예약하지 않습니다. value가 nil인 경우 제약 조건은 MinDomains가 1인 것처럼 작동합니다. 유효한 값은 0보다 큰 정수입니다. 값이 nil이 아닌 경우 WhenUnsatisfiable은 DoNotSchedule이어야 합니다. 예를 들어 3 영역 클러스터에서 MaxSkew는 2/2/2: | zone1 | zone3 | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | 5(MinDomains)로 처리되므로 "global minimum"은 0으로 설정됩니다. 이 경우 새 Pod가 세 영역으로 예약되는 경우 계산된 skew는 3(3 - 0)인 새 Pod를 예약할 수 없으므로 MaxSkew가 위반됩니다. 베타 필드이며 MinDomainsInPodTopologySpread 기능 게이트를 활성화해야 합니다(기본적으로 활성화).

nodeAffinityPolicy

string

NodeAffinityPolicy는 Pod 토폴로지 분배 skew를 계산할 때 Pod의 nodeAffinity/nodeSelector를 처리하는 방법을 나타냅니다. 옵션은: - Cryostat: nodeAffinity/nodeSelector와 일치하는 노드만 계산에 포함됩니다. - Ignore: nodeAffinity/nodeSelector는 무시됩니다. 모든 노드는 계산에 포함됩니다. 이 값이 nil인 경우 동작은 policy와 동일합니다. 이는 NodeInclusionPolicyInPodTopologySpread 기능 플래그에서 활성화한 알파 수준 기능입니다.

nodeTaintsPolicy

string

NodeTaintsPolicy는 Pod 토폴로지 분배 스큐를 계산할 때 노드 테인트를 처리하는 방법을 나타냅니다. 옵션은 다음과 같습니다: 테인트가 없는 노드와 함께 들어오는 Pod에 톨러레이션이 포함된 테인트 노드가 포함됩니다. - Ignore: 노드 테인트는 무시됩니다. 모든 노드가 포함됩니다. 이 값이 nil인 경우 동작은 Ignore 정책과 동일합니다. 이는 NodeInclusionPolicyInPodTopologySpread 기능 플래그에서 활성화한 알파 수준 기능입니다.

TopologyKey

string

TopologyKey는 노드 라벨의 키입니다. 이 키와 동일한 값이 있는 라벨이 있는 노드는 동일한 토폴로지에 있는 것으로 간주됩니다. 각 <key, value>를 "bucket"으로 간주하고 각 버킷에 균형 있는 Pod 수를 배치하려고 합니다. 도메인을 토폴로지의 특정 인스턴스로 정의합니다. 또한 적격 도메인을 nodeAffinityPolicy 및 nodeTaintsPolicy의 요구 사항을 충족하는 도메인으로 정의합니다. 예를 들어 TopologyKey가 "kubernetes.io/hostname"인 경우 각 노드는 해당 토폴로지의 도메인입니다. 그리고 TopologyKey가 "topology.kubernetes.io/zone"인 경우 각 영역은 해당 토폴로지의 도메인입니다. 필수 필드입니다.

whenUnsatisfiable

string

whenUnsatisfiable은 spread 제약 조건을 충족하지 않는 경우 Pod를 처리하는 방법을 나타냅니다. - DoNotSchedule (default)은 스케줄러에 일정하지 않도록 지시합니다. - ScheduleAnyway는 모든 위치에서 Pod를 예약하도록 하지만 skew를 줄이는 데 도움이 되는 토폴로지에 더 높은 우선순위를 부여합니다. 제약 조건은 해당 Pod에 대한 가능한 모든 노드 할당이 일부 토폴로지에서 "MaxSkew"를 위반하는 경우에만 들어오는 Pod의 "Unsatisfiable"으로 간주됩니다. 예를 들어 3-zone 클러스터에서 MaxSkew는 1로 설정되고, 3/1/1: | zone1 | zone2 | zone3 | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | WhenUnsatisfiable이 설정된 경우, 들어오는 Pod는 zone2(zone3)로만 영역 2(zone3)로 설정되어 있고, 3/1/1: | zone1 | zone1 | zone3 | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | WhenUnsatisfiable이 DoNotSchedule으로 설정된 경우 들어오는 Pod는 zone2(zone3)로만 영역(zone3)으로 예약할 수 있습니다. 즉, 클러스터의 불균형을 여전히 조정할 수 있지만 스케줄러로 인해 더 많은 불균형이 발생하지 않습니다. 필수 필드입니다.

7.1.79. .spec.topologySpreadConstraints[].labelSelector

설명
labelSelector는 일치하는 포드를 찾는 데 사용됩니다. 이 라벨 선택기와 일치하는 Pod는 해당 토폴로지 도메인의 Pod 수를 확인하기 위해 계산됩니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

7.1.80. .spec.topologySpreadConstraints[].labelSelector.matchExpressions

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

7.1.81. .spec.topologySpreadConstraints[].labelSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

7.1.82. .status

설명
ImageRegistryStatus에서 이미지 레지스트리 작동 상태를 보고합니다.
유형
object
필수 항목
  • storage
  • storageManaged
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

storage

object

스토리지는 레지스트리의 현재 적용된 스토리지 구성을 나타냅니다.

storageManaged

boolean

StorageManaged는 더 이상 사용되지 않습니다. Storage.managementState를 참조하십시오.

version

string

버전이 이 가용성이 적용되는 수준입니다.

7.1.83. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

7.1.84. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

7.1.85. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

7.1.86. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

7.1.87. .status.storage

설명
스토리지는 레지스트리의 현재 적용된 스토리지 구성을 나타냅니다.
유형
object
속성유형설명

azure

object

Azure는 Azure Blob Storage를 사용하는 구성을 나타냅니다.

emptyDir

object

emptyDir은 Pod의 호스트 노드의 임시 스토리지를 나타냅니다. 경고: 이 스토리지는 1개 이상의 복제본과 함께 사용할 수 없으며 프로덕션 용도로는 적합하지 않습니다. 어떠한 이유로든 노드에서 Pod가 제거되면 emptyDir의 데이터가 영구적으로 삭제됩니다.

GCS

object

GCS는 Google Cloud Storage를 사용하는 설정을 나타냅니다.

IBMcos

object

IBM Cloud Object Storage를 사용하는 구성을 나타냅니다.

managementState

string

managementState는 운영자가 기본 스토리지 장치를 관리하는지 여부를 나타냅니다. Managed인 경우 Operator는 이 Operator가 제거될 때 스토리지를 제거합니다.

OSS

object

OSS는 Alibaba Cloud Object Storage 서비스를 사용하는 구성을 나타냅니다.

pvc

object

PVC는 PersistentVolumeClaim을 사용하는 구성을 나타냅니다.

s3

object

S3는 Amazon Simple Storage Service를 사용하는 구성을 나타냅니다.

swift

object

Swift는 OpenStack 오브젝트 스토리지를 사용하는 구성을 나타냅니다.

7.1.88. .status.storage.azure

설명
Azure는 Azure Blob Storage를 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

accountName

string

AccountName은 레지스트리에서 사용할 계정을 정의합니다.

cloudName

string

cloudName은 레지스트리에서 사용할 Azure 클라우드 환경의 이름입니다. 비어 있는 경우 Operator는 인프라 오브젝트를 기반으로 설정합니다.

container

string

컨테이너는 레지스트리에서 사용할 Azure의 컨테이너를 정의합니다.

7.1.89. .status.storage.emptyDir

설명
emptyDir은 Pod의 호스트 노드의 임시 스토리지를 나타냅니다. 경고: 이 스토리지는 1개 이상의 복제본과 함께 사용할 수 없으며 프로덕션 용도로는 적합하지 않습니다. 어떠한 이유로든 노드에서 Pod가 제거되면 emptyDir의 데이터가 영구적으로 삭제됩니다.
유형
object

7.1.90. .status.storage.gcs

설명
GCS는 Google Cloud Storage를 사용하는 설정을 나타냅니다.
유형
object
속성유형설명

bucket

string

버킷은 레지스트리의 데이터를 저장할 버킷 이름입니다. 선택 사항이며 제공되지 않는 경우 생성됩니다.

keyID

string

keyID는 암호화에 사용할 KMS 키 ID입니다. 선택 사항, 버킷은 기본적으로 GCP에서 암호화됩니다. 이를 통해 사용자 지정 암호화 키를 사용할 수 있습니다.

projectID

string

projectID는 이 버킷을 연결해야 하는 GCP 프로젝트의 프로젝트 ID입니다.

region

string

리전은 버킷이 있는 GCS 위치입니다. 선택 사항이며 설치된 GCS 지역에 따라 설정됩니다.

7.1.91. .status.storage.ibmcos

설명
IBM Cloud Object Storage를 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

bucket

string

버킷은 레지스트리의 데이터를 저장할 버킷 이름입니다. 선택 사항이며 제공되지 않는 경우 생성됩니다.

위치

string

위치는 버킷이 있는 IBM Cloud 위치입니다. 선택 사항: 설치된 IBM Cloud 위치에 따라 설정됩니다.

resourceGroupName

string

resourceGroupName은 이 버킷과 해당 서비스 인스턴스가 연결된 IBM Cloud 리소스 그룹의 이름입니다. 선택 사항이며 설치된 IBM Cloud 리소스 그룹에 따라 설정됩니다.

resourceKeyCRN

string

resourceKeyCRN은 서비스 인스턴스에 대해 생성된 IBM Cloud 리소스 키의 CRN입니다. 일반적으로 서비스 자격 증명이라고 하며 HMAC 유형 인증 정보를 포함해야 합니다. 선택 사항이며 제공되지 않는 경우 계산됩니다.

serviceInstanceCRN

string

ServiceInstanceCRN은 이 버킷이 연결된 IBM Cloud Object Storage 서비스 인스턴스의 CRN입니다. 선택 사항이며 제공되지 않는 경우 계산됩니다.

7.1.92. .status.storage.oss

설명
OSS는 Alibaba Cloud Object Storage 서비스를 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

bucket

string

버킷은 레지스트리의 데이터를 저장할 버킷 이름입니다. 버킷 이름 지정에 대한 자세한 내용은 [공식 문서](https://www.alibabacloud.com/help/doc-detail/257087.htm) 빈 값을 볼 수 있다는 것은 의견이 없으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 기본값을 선택합니다. 현재 기본값은 <clusterid>-image-registry-<region>-<random 문자열 27 자> 형식으로 자동 생성됩니다.

Encryption

object

Encryption은 서버 측에서 데이터를 암호화할지 여부를 지정합니다. 자세한 내용은 [공식 문서](https://www.alibabacloud.com/help/doc-detail/117914.htm참조하십시오.

endpointAccessibility

string

EndpointAccessibility는 레지스트리가 OSS VPC 내부 엔드포인트 Empty 값을 사용하는지 여부를 나타내며 플랫폼은 시간이 지남에 따라 변경될 수 있는 기본값을 선택합니다. 현재 기본값은 Internal 입니다.

region

string

리전은 버킷이 있는 Alibaba Cloud 리전입니다. 리전 목록은 [공식 문서](https://www.alibabacloud.com/help/doc-detail/31837.html)를 참조하십시오. 빈 값은 의견이 없으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 기본값을 선택합니다. 현재 기본값은 설치된 Alibaba Cloud 리전을 기반으로 합니다.

7.1.93. .status.storage.oss.encryption

설명
Encryption은 서버 측에서 데이터를 암호화할지 여부를 지정합니다. 자세한 내용은 [공식 문서](https://www.alibabacloud.com/help/doc-detail/117914.htm참조하십시오.
유형
object
속성유형설명

kms

object

KMS (키 관리 서비스)는 KMS KeyID의 구조를 보유하는 암호화 유형입니다.

method

string

메서드는 사용 가능한 다른 암호화 모드를 정의하므로 의견이 없으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 기본값을 선택합니다. 현재 기본값은 AES256 입니다.

7.1.94. .status.storage.oss.encryption.kms

설명
KMS (키 관리 서비스)는 KMS KeyID의 구조를 보유하는 암호화 유형입니다.
유형
object
필수 항목
  • keyID
속성유형설명

keyID

string

KeyID에는 KMS 암호화 키 ID가 있습니다.

7.1.95. .status.storage.pvc

설명
PVC는 PersistentVolumeClaim을 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

claim

string

클레임은 사용할 영구 볼륨 클레임의 이름을 정의합니다.

7.1.96. .status.storage.s3

설명
S3는 Amazon Simple Storage Service를 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

bucket

string

버킷은 레지스트리의 데이터를 저장할 버킷 이름입니다. 선택 사항이며 제공되지 않는 경우 생성됩니다.

cloudFront

object

CloudFront는 Amazon Cloudfront를 레지스트리에서 스토리지 미들웨어로 설정합니다.

encrypt

boolean

encrypt는 레지스트리가 이미지를 암호화된 형식으로 저장할지 여부를 지정합니다. 선택 사항이며 기본값은 false입니다.

keyID

string

keyID는 암호화에 사용할 KMS 키 ID입니다. 선택 사항, Encrypt는 true여야 합니다. 그렇지 않으면 이 매개변수가 무시됩니다.

region

string

리전은 버킷이 있는 AWS 리전입니다. 선택 사항이며 설치된 AWS 리전을 기반으로 설정됩니다.

regionEndpoint

string

RegionEndpoint는 S3 호환 스토리지 서비스의 끝점입니다. 지정된 지역에 따라 선택적 기본값입니다.

trustedCA

object

trustedCA는 CA 번들이 포함된 구성 맵에 대한 참조입니다. 이미지 레지스트리와 해당 Operator는 이 번들의 인증서를 사용하여 S3 서버 인증서를 확인합니다. trustedCA에서 참조하는 구성 맵의 네임스페이스는 "openshift-config"입니다. 구성 맵의 번들 키는 "ca-bundle.crt"입니다.

virtualHostedStyle

boolean

virtualHostedStyle은 사용자 지정 RegionEndpoint Optional과 함께 S3 가상 호스팅 스타일 버킷 경로를 사용할 수 있으며 기본값은 false입니다.

7.1.97. .status.storage.s3.cloudFront

설명
CloudFront는 Amazon Cloudfront를 레지스트리에서 스토리지 미들웨어로 설정합니다.
유형
object
필수 항목
  • baseURL
  • keypairID
  • privateKey
속성유형설명

baseURL

string

baseurl에는 Cloudfront가 제공되는 SCHEME://HOST[/PATH]가 포함되어 있습니다.

duration

string

기간은 Cloudfront 세션의 기간입니다.

keypairID

string

keypairID는 AWS에서 제공하는 키 쌍 ID입니다.

privateKey

object

privateKey는 AWS에서 제공하는 개인 키가 포함된 시크릿을 가리킵니다.

7.1.98. .status.storage.s3.cloudFront.privateKey

설명
privateKey는 AWS에서 제공하는 개인 키가 포함된 시크릿을 가리킵니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

7.1.99. .status.storage.s3.trustedCA

설명
trustedCA는 CA 번들이 포함된 구성 맵에 대한 참조입니다. 이미지 레지스트리와 해당 Operator는 이 번들의 인증서를 사용하여 S3 서버 인증서를 확인합니다. trustedCA에서 참조하는 구성 맵의 네임스페이스는 "openshift-config"입니다. 구성 맵의 번들 키는 "ca-bundle.crt"입니다.
유형
object
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다. 이 필드는 표준 구성 맵 이름 지정 제한을 준수해야 합니다. 이름은 영숫자, 하이픈(-) 및 마침표(..)로만 구성되어야 합니다. 최대 길이는 253자입니다. 이 필드를 지정하지 않거나 빈 문자열인 경우 기본 신뢰 번들이 사용됩니다.

7.1.100. .status.storage.swift

설명
Swift는 OpenStack 오브젝트 스토리지를 사용하는 구성을 나타냅니다.
유형
object
속성유형설명

authURL

string

authURL은 인증 토큰을 얻기 위한 URL을 정의합니다.

authVersion

string

authVersion은 OpenStack Auth 버전을 지정합니다.

container

string

컨테이너는 레지스트리의 데이터를 저장할 Swift 컨테이너의 이름을 정의합니다.

domain

string

domain은 Identity v3 API의 Openstack의 도메인 이름을 지정합니다.

domainID

string

domainID는 ID v3 API에 대한 Openstack의 도메인 ID를 지정합니다.

regionName

string

RegionName은 컨테이너가 존재하는 Openstack 영역을 정의합니다.

tenant

string

테넌트는 레지스트리에서 사용할 Openstack 테넌트 이름을 정의합니다.

tenantID

string

테넌트는 레지스트리에서 사용할 Openstack 테넌트 ID를 정의합니다.

7.2. API 끝점

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

  • /apis/imageregistry.operator.openshift.io/v1/configs

    • DELETE: Config 컬렉션 삭제
    • GET: 종류의 Config 오브젝트 나열
    • POST: 구성 생성
  • /apis/imageregistry.operator.openshift.io/v1/configs/{name}

    • DELETE: Config 삭제
    • GET: 지정된 구성 읽기
    • PATCH: 지정된 Config를 부분적으로 업데이트
    • PUT: 지정된 구성의 교체
  • /apis/imageregistry.operator.openshift.io/v1/configs/{name}/status

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

7.2.1. /apis/imageregistry.operator.openshift.io/v1/configs

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

string

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

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

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류 Config의 오브젝트 나열
표 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

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

ConfigList 스키마

401 - 무단

HTTP 방법
POST
설명
구성 생성
표 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

구성 스키마

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

200 - OK

구성 스키마

201 - 생성됨

구성 스키마

202 - 승인됨

구성 스키마

401 - 무단

7.2.2. /apis/imageregistry.operator.openshift.io/v1/configs/{name}

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

name

string

구성의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

구성 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 구성 부분 업데이트
표 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

구성 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 구성 교체
표 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

구성 스키마

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

200 - OK

구성 스키마

201 - 생성됨

구성 스키마

401 - 무단

7.2.3. /apis/imageregistry.operator.openshift.io/v1/configs/{name}/status

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

name

string

구성의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

구성 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 구성의 부분적으로 업데이트
표 7.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

구성 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 구성의 상태 교체
표 7.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

구성 스키마

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

200 - OK

구성 스키마

201 - 생성됨

구성 스키마

401 - 무단

8장. Config [samples.operator.openshift.io/v1]

설명
config에는 Samples Operator의 구성 및 세부 조건 상태가 포함됩니다.
유형
object
필수 항목
  • 메타데이터
  • spec

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

ConfigSpec에는 Samples Operator에 대해 원하는 구성 및 상태가 포함되어 있으며 openshift 네임스페이스에서 생성/업데이트하는 이미지 스트림 및 템플릿에 대한 다양한 동작을 제어합니다.

status

object

ConfigStatus에는 적용되는 실제 구성과 Samples Operator의 상태를 설명하는 다양한 세부 사항이 포함되어 있습니다.

8.1.1. .spec

설명
ConfigSpec에는 Samples Operator에 대해 원하는 구성 및 상태가 포함되어 있으며 openshift 네임스페이스에서 생성/업데이트하는 이미지 스트림 및 템플릿에 대한 다양한 동작을 제어합니다.
유형
object
속성유형설명

architectures

배열(문자열)

아키텍처는 설치할 하드웨어 아키텍처를 결정합니다. x86_64, ppc64le 및 s390x는 현재 지원되는 유일한 선택 사항입니다.

managementState

string

managementState는 모든 연산자에 대해 최상위 스위치 유형/오프 유형입니다. "Managed"인 경우 이 Operator는 구성을 처리하고 그에 따라 샘플을 조작합니다. "관리되지 않음"인 경우 이 Operator는 감시하는 리소스에 대한 업데이트를 무시합니다. "Removed"는 Config 오브젝트가 삭제되는 경우와 동일하게 반응합니다. 즉, 관리하는 ImageStreams 또는 템플릿(즉, 건너뛰기된 목록을 준수함) 및 레지스트리 보안이 삭제되고, 샘플 조작에 사용되는 마지막 구성을 나타내는 Operator의 네임스페이스의 ConfigMap과 함께 레지스트리 보안이 삭제됩니다.

samplesRegistry

string

samplesRegistry를 사용하면 이미지 콘텐츠에 대해 ImageStreams가 액세스하는 레지스트리의 사양을 허용합니다. 이 github 리포지토리로 가져오는 https://github.com/openshift/library 콘텐츠의 기본값은 ocp 콘텐츠만 가져오는 데 기반합니다. 일반적으로 registry.redhat.io입니다.

skippedImagestreams

배열(문자열)

skippedImagestreams는 생성/업데이트해서는 안 되는 이미지 스트림의 이름을 지정합니다. 관리자는 이를 사용하여 원하지 않는 콘텐츠를 삭제할 수 있습니다. 여전히 콘텐츠를 수동으로 삭제해야 하지만 Operator는 여기에 나열된 항목을 다시 생성(또는 업데이트)하지 않습니다.

skippedTemplates

배열(문자열)

skippedTemplates는 생성/업데이트해서는 안 되는 템플릿의 이름을 지정합니다. 관리자는 이를 사용하여 원하지 않는 콘텐츠를 삭제할 수 있습니다. 여전히 콘텐츠를 수동으로 삭제해야 하지만 Operator는 여기에 나열된 항목을 다시 생성(또는 업데이트)하지 않습니다.

8.1.2. .status

설명
ConfigStatus에는 적용되는 실제 구성과 Samples Operator의 상태를 설명하는 다양한 세부 사항이 포함되어 있습니다.
유형
object
속성유형설명

architectures

배열(문자열)

아키텍처는 설치할 하드웨어 아키텍처를 결정합니다. 여기서 x86_64 및 ppc64le이 지원되는 옵션입니다.

conditions

array

조건은 샘플 이미지 스트림 및 템플릿의 사용 가능한 유지 관리 상태를 나타냅니다.

conditions[]

object

항목이 처리될 때 ConfigCondition은 Config의 다양한 조건을 캡처합니다.

managementState

string

managementState는 Operator에 대한 온/오프 스위치의 현재 작동 상태를 반영합니다. 이 연산자는 ManagementState를 연산자를 다시 켜는 것을 결정하는 과정의 일부로 비교합니다(즉. 이전에 "관리되지 않음"인 경우 "관리되지 않음".

samplesRegistry

string

samplesRegistry를 사용하면 이미지 콘텐츠에 대해 ImageStreams가 액세스하는 레지스트리의 사양을 허용합니다. 이 github 리포지토리로 가져오는 https://github.com/openshift/library 콘텐츠의 기본값은 ocp 콘텐츠만 가져오는 데 기반합니다. 일반적으로 registry.redhat.io입니다.

skippedImagestreams

배열(문자열)

skippedImagestreams는 생성/업데이트해서는 안 되는 이미지 스트림의 이름을 지정합니다. 관리자는 이를 사용하여 원하지 않는 콘텐츠를 삭제할 수 있습니다. 여전히 콘텐츠를 수동으로 삭제해야 하지만 Operator는 여기에 나열된 항목을 다시 생성(또는 업데이트)하지 않습니다.

skippedTemplates

배열(문자열)

skippedTemplates는 생성/업데이트해서는 안 되는 템플릿의 이름을 지정합니다. 관리자는 이를 사용하여 원하지 않는 콘텐츠를 삭제할 수 있습니다. 여전히 콘텐츠를 수동으로 삭제해야 하지만 Operator는 여기에 나열된 항목을 다시 생성(또는 업데이트)하지 않습니다.

version

string

version은 마지막으로 성공적으로 처리되었을 때 Operator의 페이로드 기반 버전 지표의 값입니다.

8.1.3. .status.conditions

설명
조건은 샘플 이미지 스트림 및 템플릿의 사용 가능한 유지 관리 상태를 나타냅니다.
유형
array

8.1.4. .status.conditions[]

설명
항목이 처리될 때 ConfigCondition은 Config의 다양한 조건을 캡처합니다.
유형
object
필수 항목
  • status
  • type
속성유형설명

lastTransitionTime

string

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

lastUpdateTime

string

lastUpdateTime은 이 조건이 마지막으로 업데이트된 시간입니다.

message

string

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

reason

string

조건의 마지막 전환이 발생한 이유는 무엇입니까.

status

string

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

type

string

조건 유형입니다.

8.2. API 끝점

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

  • /apis/samples.operator.openshift.io/v1/configs

    • DELETE: Config 컬렉션 삭제
    • GET: 종류의 Config 오브젝트 나열
    • POST: 구성 생성
  • /apis/samples.operator.openshift.io/v1/configs/{name}

    • DELETE: Config 삭제
    • GET: 지정된 구성 읽기
    • PATCH: 지정된 Config를 부분적으로 업데이트
    • PUT: 지정된 구성의 교체
  • /apis/samples.operator.openshift.io/v1/configs/{name}/status

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

8.2.1. /apis/samples.operator.openshift.io/v1/configs

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

ConfigList schema

401 - 무단

HTTP 방법
POST
설명
구성 생성
표 8.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

구성 스키마

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

200 - OK

구성 스키마

201 - 생성됨

구성 스키마

202 - 승인됨

구성 스키마

401 - 무단

8.2.2. /apis/samples.operator.openshift.io/v1/configs/{name}

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

name

string

구성의 이름

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

구성 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 구성 부분 업데이트
표 8.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

구성 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 구성 교체
표 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

구성 스키마

201 - 생성됨

구성 스키마

401 - 무단

8.2.3. /apis/samples.operator.openshift.io/v1/configs/{name}/status

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

name

string

구성의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

구성 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 구성의 부분적으로 업데이트
표 8.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

구성 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 구성의 상태 교체
표 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

구성 스키마

201 - 생성됨

구성 스키마

401 - 무단

9장. CSISnapshotController [operator.openshift.io/v1]

설명
CSISnapshotController는 CSI 스냅샷을 관리하도록 Operator를 구성하는 수단을 제공합니다. Cluster 는 정식 이름입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

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

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

9.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

9.1.2. .status

설명
status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

9.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

9.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

9.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

9.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

9.2. API 끝점

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

  • /apis/operator.openshift.io/v1/csisnapshotcontrollers

    • DELETE: CSISnapshotController 컬렉션 삭제
    • GET: CSISnapshotController 유형의 오브젝트 나열
    • POST: CSISnapshotController 생성
  • /apis/operator.openshift.io/v1/csisnapshotcontrollers/{name}

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

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

9.2.1. /apis/operator.openshift.io/v1/csisnapshotcontrollers

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

string

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

HTTP 방법
DELETE
설명
CSISnapshotController 컬렉션 삭제
표 9.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을 지정합니다.

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

200 - OK

상태 스키마

401 - 무단

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

CSISnapshotControllerList schema

401 - 무단

HTTP 방법
POST
설명
CSISnapshotController 생성
표 9.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

CSISnapshotController 스키마

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

200 - OK

CSISnapshotController 스키마

201 - 생성됨

CSISnapshotController 스키마

202 - 승인됨

CSISnapshotController 스키마

401 - 무단

9.2.2. /apis/operator.openshift.io/v1/csisnapshotcontrollers/{name}

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

name

string

CSISnapshotController의 이름

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

CSISnapshotController 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 CSISnapshotController를 부분적으로 업데이트
표 9.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

CSISnapshotController 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 CSISnapshotController를 교체
표 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

CSISnapshotController 스키마

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

200 - OK

CSISnapshotController 스키마

201 - 생성됨

CSISnapshotController 스키마

401 - 무단

9.2.3. /apis/operator.openshift.io/v1/csisnapshotcontrollers/{name}/status

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

name

string

CSISnapshotController의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

CSISnapshotController 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 CSISnapshotController의 부분적으로 업데이트 상태
표 9.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

CSISnapshotController 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 CSISnapshotController의 상태 교체
표 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

CSISnapshotController 스키마

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

200 - OK

CSISnapshotController 스키마

201 - 생성됨

CSISnapshotController 스키마

401 - 무단

10장. DNS [operator.openshift.io/v1]

설명
DNS는 CoreDNS 구성 요소를 관리하여 클러스터의 pod 및 서비스에 대한 이름 확인 서비스를 제공합니다. 이는 DNS 기반 서비스 검색 사양을 지원합니다. https://github.com/kubernetes/dns/blob/master/docs/specification.md 자세한 내용은 https://kubernetes.io/docs/tasks/administer-cluster/coredns 호환성 수준 1: 최소 12 개월 또는 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

spec은 DNS의 원하는 동작의 사양입니다.

status

object

상태는 DNS의 가장 최근에 관찰된 상태입니다.

10.1.1. .spec

설명
spec은 DNS의 원하는 동작의 사양입니다.
유형
object
속성유형설명

캐시

object

캐시는 Corefile에 나열된 모든 서버 블록에 적용되는 캐싱 구성을 설명합니다. 이 필드를 사용하면 클러스터 관리자가 선택적으로 양의 응답을 캐시해야 하는 기간인 * positiveTTL을 구성할 수 있습니다. * 음수 응답을 캐시해야 하는 기간인 negativeTTL입니다. 이 설정이 구성되지 않은 경우 OpenShift는 변경될 수 있는 기본값을 사용하여 양수 및 음수 캐싱을 구성합니다. 작성 시 기본 positiveTTL은 900초이고 기본 negativeTTL은 30초 또는 OpenShift 버전에 대해 각 Corefile에 명시된 대로 설정됩니다.

logLevel

string

loglevel은 CoreDNS에 대해 원하는 로깅 세부 정보 표시를 설명합니다. 다음 값 중 하나를 지정할 수 있습니다. * 업스트림 확인자의 일반 로그 오류입니다. * 디버그 로그 오류, NXDOMAIN 응답 및 NODATA 응답. * 로그 오류 및 모든 응답을 추적합니다. logLevel 설정: 추적은 매우 자세한 로그를 생성합니다. 유효한 값은 "Normal", "Debug", "Trace"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 DNS 운영자가 클러스터 DNS를 관리해야 하는지 여부를 나타냅니다.

nodePlacement

object

nodePlacement는 DNS Pod의 스케줄링을 명시적으로 제어합니다. 일반적으로 네트워크를 다른 노드의 DNS pod로 이동하는 대신 로컬 DNS 포드에서 DNS 쿼리를 처리하도록 모든 노드에서 DNS Pod를 실행하는 것이 유용합니다. 그러나 보안 정책에 따라 DNS Pod의 배치를 특정 노드로 제한해야 할 수 있습니다. 예를 들어 보안 정책이 임의의 노드의 Pod가 API와 통신하지 못하도록 하는 경우 노드 선택기를 지정하여 API와 통신할 수 있는 노드로 DNS Pod를 제한할 수 있습니다. 반대로 특정 테인트를 사용하여 노드에서 DNS Pod를 실행하는 경우 해당 테인트에 대한 허용 오차를 지정할 수 있습니다. 설정되지 않은 경우 기본값이 사용됩니다. 자세한 내용은 nodePlacement를 참조하십시오.

operatorLogLevel

string

operatorLogLevel은 DNS Operator의 로깅 수준을 제어합니다. 유효한 값은 "Normal", "Debug", "Trace"입니다. 기본값은 "Normal"입니다. operatorLogLevel: Trace를 설정하면 매우 자세한 로그가 생성됩니다.

서버

array

서버는 클러스터 도메인 범위를 벗어나는 하나 이상의 하위 도메인에 대한 이름 쿼리 위임을 제공하는 DNS 확인자 목록입니다. 서버가 두 개 이상의 서버로 구성된 경우 서버를 결정하는 데 가장 긴 접미사 일치가 사용됩니다. 예를 들어 두 개의 서버가 있는 경우 "foo.com"과 다른 하나는 "a.foo.com"이고 다른 하나는 "www.a.foo.com"에 대한 이름 쿼리는 Zone "a.foo.com"을 사용하여 서버로 라우팅됩니다. 이 필드가 nil이면 서버가 생성되지 않습니다.

servers[]

object

server는 CoreDNS의 인스턴스별로 실행되는 서버의 스키마를 정의합니다.

upstreamResolvers

object

upstreamResolvers는 기본(".") 서버의 경우 DNS 메시지를 업스트림 해석기에 프록시하도록 CoreDNS를 구성하기 위한 스키마를 정의합니다. 이 필드가 지정되지 않은 경우 사용되는 업스트림은 정책 "sequential"을 사용하여 /etc/resolv.conf로 기본 설정됩니다.

10.1.2. .spec.cache

설명
캐시는 Corefile에 나열된 모든 서버 블록에 적용되는 캐싱 구성을 설명합니다. 이 필드를 사용하면 클러스터 관리자가 선택적으로 양의 응답을 캐시해야 하는 기간인 * positiveTTL을 구성할 수 있습니다. * 음수 응답을 캐시해야 하는 기간인 negativeTTL입니다. 이 설정이 구성되지 않은 경우 OpenShift는 변경될 수 있는 기본값을 사용하여 양수 및 음수 캐싱을 구성합니다. 작성 시 기본 positiveTTL은 900초이고 기본 negativeTTL은 30초 또는 OpenShift 버전에 대해 각 Corefile에 명시된 대로 설정됩니다.
유형
object
속성유형설명

negativeTTL

string

negativeTTL은 선택 사항이며 음수 응답을 캐시해야 하는 시간을 지정합니다. 구성된 경우 1s(1초)의 값이거나 이론적으로 최대 몇 년까지 커야 합니다. 이 필드에는 10진수의 부호 없는 기간 문자열, 각각 선택적 분수와 단위 접미사가 필요합니다. 예를 들면 다음과 같습니다. "100s", "1m30s", "12h30m10s". 초의 분수에 해당하는 값은 가장 가까운 초로 반올림됩니다. 구성된 값이 1s 미만이면 기본값이 사용됩니다. 구성되지 않은 경우 값은 0s이고 OpenShift는 OpenShift 버전에 대해 해당 Corefile에 달리 명시하지 않는 한 기본값 30초를 사용합니다. 기본값인 30초는 변경될 수 있습니다.

positiveTTL

string

positiveTTL은 선택 사항이며 양수 응답을 캐시해야 하는 시간을 지정합니다. 구성된 경우 1s(1초)의 값이거나 이론적으로 최대 몇 년까지 커야 합니다. 이 필드에는 10진수의 부호 없는 기간 문자열, 각각 선택적 분수와 단위 접미사가 필요합니다. 예를 들면 다음과 같습니다. "100s", "1m30s", "12h30m10s". 초의 분수에 해당하는 값은 가장 가까운 초로 반올림됩니다. 구성된 값이 1s 미만이면 기본값이 사용됩니다. 구성되지 않은 경우 값은 0s이고 OpenShift는 OpenShift 버전에 대해 해당 Corefile에 달리 명시하지 않는 한 기본값 900초를 사용합니다. 900초의 기본값은 변경될 수 있습니다.

10.1.3. .spec.nodePlacement

설명
nodePlacement는 DNS Pod의 스케줄링을 명시적으로 제어합니다. 일반적으로 네트워크를 다른 노드의 DNS pod로 이동하는 대신 로컬 DNS 포드에서 DNS 쿼리를 처리하도록 모든 노드에서 DNS Pod를 실행하는 것이 유용합니다. 그러나 보안 정책에 따라 DNS Pod의 배치를 특정 노드로 제한해야 할 수 있습니다. 예를 들어 보안 정책이 임의의 노드의 Pod가 API와 통신하지 못하도록 하는 경우 노드 선택기를 지정하여 API와 통신할 수 있는 노드로 DNS Pod를 제한할 수 있습니다. 반대로 특정 테인트를 사용하여 노드에서 DNS Pod를 실행하는 경우 해당 테인트에 대한 허용 오차를 지정할 수 있습니다. 설정되지 않은 경우 기본값이 사용됩니다. 자세한 내용은 nodePlacement를 참조하십시오.
유형
object
속성유형설명

nodeSelector

오브젝트(문자열)

nodeSelector는 DNS Pod에 적용되는 노드 선택기입니다. 비어 있는 경우 기본값은 현재 다음과 같습니다. kubernetes.io/os: linux 이 기본값은 변경될 수 있습니다. 설정된 경우 지정된 선택기가 사용되고 기본값을 대체합니다.

허용 오차

array

허용 오차는 DNS Pod에 적용되는 허용 오차 목록입니다. 비어 있는 경우 DNS Operator는 "node-role.kubernetes.io/master" 테인트에 대한 허용 오차를 설정합니다. 이 기본값은 변경될 수 있습니다. "node-role.kubernetes.io/master" 테인트에 대한 허용 오차를 포함하지 않고 허용 오차를 지정하면 모든 작업자 노드를 사용할 수 없게 되면 중단될 수 있으므로 위험할 수 있습니다. 데몬 컨트롤러는 일부 허용 오차도 추가합니다. https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/에서 참조하십시오.

tolerations[]

object

이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.

10.1.4. .spec.nodePlacement.tolerations

설명
허용 오차는 DNS Pod에 적용되는 허용 오차 목록입니다. 비어 있는 경우 DNS Operator는 "node-role.kubernetes.io/master" 테인트에 대한 허용 오차를 설정합니다. 이 기본값은 변경될 수 있습니다. "node-role.kubernetes.io/master" 테인트에 대한 허용 오차를 포함하지 않고 허용 오차를 지정하면 모든 작업자 노드를 사용할 수 없게 되면 중단될 수 있으므로 위험할 수 있습니다. 데몬 컨트롤러는 일부 허용 오차도 추가합니다. https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/에서 참조하십시오.
유형
array

10.1.5. .spec.nodePlacement.tolerations[]

설명
이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.
유형
object
속성유형설명

effect

string

effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

key

string

키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다.

operator

string

Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다.

tolerationSeconds

integer

tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다.

value

string

값은 허용 오차와 일치하는 taint 값입니다. 연산자가 Exists인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다.

10.1.6. .spec.servers

설명
서버는 클러스터 도메인 범위를 벗어나는 하나 이상의 하위 도메인에 대한 이름 쿼리 위임을 제공하는 DNS 확인자 목록입니다. 서버가 두 개 이상의 서버로 구성된 경우 서버를 결정하는 데 가장 긴 접미사 일치가 사용됩니다. 예를 들어 두 개의 서버가 있는 경우 "foo.com"과 다른 하나는 "a.foo.com"이고 다른 하나는 "www.a.foo.com"에 대한 이름 쿼리는 Zone "a.foo.com"을 사용하여 서버로 라우팅됩니다. 이 필드가 nil이면 서버가 생성되지 않습니다.
유형
array

10.1.7. .spec.servers[]

설명
server는 CoreDNS의 인스턴스별로 실행되는 서버의 스키마를 정의합니다.
유형
object
속성유형설명

forwardPlugin

object

forwardPlugin은 DNS 메시지를 업스트림 해석기로 프록시하도록 CoreDNS를 구성하기 위한 스키마를 정의합니다.

name

string

이름은 필수이며 서버의 고유 이름을 지정합니다. name은 rfc6335의 서비스 이름 구문을 준수해야 합니다.

영역

배열(문자열)

영역은 필수이며 Server가 권한이 있는 하위 도메인을 지정합니다. zones은 하위 도메인의 rfc1123 정의를 준수해야 합니다. 클러스터 도메인(예: "cluster.local")을 지정하는 것은 유효하지 않습니다.

10.1.8. .spec.servers[].forwardPlugin

설명
forwardPlugin은 DNS 메시지를 업스트림 해석기로 프록시하도록 CoreDNS를 구성하기 위한 스키마를 정의합니다.
유형
object
속성유형설명

policy

string

정책은 업스트림 서버가 쿼리용으로 선택한 순서를 결정하는 데 사용됩니다. 다음 값 중 하나를 지정할 수 있습니다. * "Random"은 각 쿼리에 대해 임의의 업스트림 서버를 선택합니다. * "roundrobin"은 라운드 로빈 순서로 업스트림 서버를 선택하여 새 쿼리마다 다음 서버로 이동합니다. * "sequential"은 새 쿼리마다 첫 번째 서버부터 시작하여 순차적 순서로 업스트림 서버를 쿼리합니다. 기본값은 "Random"입니다.

protocolStrategy

string

protocolStrategy는 업스트림 DNS 요청에 사용할 프로토콜을 지정합니다. protocolStrategy의 유효한 값은 "TCP"이고 생략되었습니다. 생략하면 이는 의견이 없으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 적절한 기본값을 선택할 수 있음을 의미합니다. 현재 기본값은 원래 클라이언트 요청의 프로토콜을 사용하는 것입니다. "TCP"는 클라이언트 요청이 UDP를 사용하는 경우에도 플랫폼에서 모든 업스트림 DNS 요청에 TCP를 사용하도록 지정합니다. "TCP"는 비호환 업스트림 확인자가 생성한 것과 같은 UDP 관련 문제에 유용하지만 더 많은 대역폭을 사용하거나 DNS 응답 시간을 늘릴 수 있습니다. protocolStrategy는 CoreDNS가 업스트림 해석기에 수행하는 DNS 요청 프로토콜에만 영향을 미칩니다. 클라이언트와 CoreDNS 간 DNS 요청 프로토콜에는 영향을 미치지 않습니다.

transportConfig

object

transportConfig는 DNS 요청을 업스트림 확인기로 전달할 때 사용할 전송 유형, 서버 이름 및 선택적 사용자 정의 CA 또는 CA 번들을 구성하는 데 사용됩니다. 기본값은 ""(비어 있음)이므로 DNS 요청을 업스트림 확인기로 전달할 때 표준 일반 텍스트 연결이 사용됩니다.

업스트림

배열(문자열)

업스트림은 영역의 하위 도메인에 대한 이름 쿼리를 전달하는 확인자 목록입니다. CoreDNS의 각 인스턴스는 Upstreams의 상태 점검을 수행합니다. 정상 업스트림에서 교환 중에 오류를 반환하면 Upstreams에서 다른 해결 프로그램이 시도됩니다. Upstreams는 정책에 지정된 순서로 선택됩니다. 업스트림이 53 이외의 포트에서 수신 대기하는 경우 각 업스트림은 IP 주소 또는 IP:port로 표시됩니다. ForwardPlugin당 최대 15개의 업스트림이 허용됩니다.

10.1.9. .spec.servers[].forwardPlugin.transportConfig

설명
transportConfig는 DNS 요청을 업스트림 확인기로 전달할 때 사용할 전송 유형, 서버 이름 및 선택적 사용자 정의 CA 또는 CA 번들을 구성하는 데 사용됩니다. 기본값은 ""(비어 있음)이므로 DNS 요청을 업스트림 확인기로 전달할 때 표준 일반 텍스트 연결이 사용됩니다.
유형
object
속성유형설명

tls

object

TLS에는 Transport가 "TLS"로 설정될 때 사용할 추가 구성 옵션이 포함되어 있습니다.

전송

string

클러스터 관리자는 전송을 통해 클러스터 DNS와 업스트림 확인자 간에 DNS-over-TLS 연결을 사용할 수 있습니다. CABundle을 구성하지 않고 이 수준에서 TLS를 전송으로 구성하면 시스템 인증서가 업스트림 확인자의 제공 인증서를 확인하는 데 사용됩니다. 가능한 값: ""(비어 있음) - 이는 명시적 선택이 이루어지지 않았으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 기본값을 선택합니다. 현재 기본값은 "text"입니다. "cleartext" - 클러스터 관리자가 일반 텍스트 옵션을 지정합니다. 이렇게 하면 빈 값과 동일한 기능이 생성되지만 클러스터 관리자가 전송에 대해 보다 명확하게 설명하거나 "TLS"에서 "text"로 명시적으로 전환하려는 경우 유용할 수 있습니다. "TLS" - DNS 쿼리를 TLS 연결을 통해 전송해야 함을 나타냅니다. Transport가 TLS로 설정된 경우 ServerName도 설정해야 합니다. 업스트림 IP에 포트가 포함되어 있지 않은 경우 기본적으로 RFC 7858 섹션 3.1; https://datatracker.ietf.org/doc/html/rfc7858#section-3.1.에 따라 포트 853을 시도합니다.

10.1.10. .spec.servers[].forwardPlugin.transportConfig.tls

설명
TLS에는 Transport가 "TLS"로 설정될 때 사용할 추가 구성 옵션이 포함되어 있습니다.
유형
object
필수 항목
  • serverName
속성유형설명

cabundle

object

cabundle은 단일 CA 인증서 또는 CA 번들을 포함해야 하는 ConfigMap을 참조합니다. 이를 통해 클러스터 관리자는 업스트림 리졸버의 인증서를 검증하기 위해 자체 CA 또는 CA 번들을 제공할 수 있습니다. 1. configmap에는 ca-bundle.crt 키가 포함되어야 합니다. 2. 값은 PEM 인코딩 CA 인증서 또는 CA 번들이어야 합니다. 3. 관리자는 openshift-config 네임스페이스에 이 configmap을 생성해야 합니다. 4. 업스트림 서버 인증서에는 ServerName과 일치하는 SAN(주체 대체 이름)이 포함되어야 합니다.

serverName

string

ServerName은 DNS 쿼리를 전달할 때 연결할 업스트림 서버입니다. 이는 Transport가 "TLS"로 설정된 경우 필요합니다. ServerName은 RFC 1123의 DNS 이름 지정 규칙에 대해 검증되며 업스트림 확인자에 설치된 TLS 인증서와 일치해야 합니다.

10.1.11. .spec.servers[].forwardPlugin.transportConfig.tls.caBundle

설명
cabundle은 단일 CA 인증서 또는 CA 번들을 포함해야 하는 ConfigMap을 참조합니다. 이를 통해 클러스터 관리자는 업스트림 리졸버의 인증서를 검증하기 위해 자체 CA 또는 CA 번들을 제공할 수 있습니다. 1. configmap에는 ca-bundle.crt 키가 포함되어야 합니다. 2. 값은 PEM 인코딩 CA 인증서 또는 CA 번들이어야 합니다. 3. 관리자는 openshift-config 네임스페이스에 이 configmap을 생성해야 합니다. 4. 업스트림 서버 인증서에는 ServerName과 일치하는 SAN(주체 대체 이름)이 포함되어야 합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

10.1.12. .spec.upstreamResolvers

설명
upstreamResolvers는 기본(".") 서버의 경우 DNS 메시지를 업스트림 해석기에 프록시하도록 CoreDNS를 구성하기 위한 스키마를 정의합니다. 이 필드가 지정되지 않은 경우 사용되는 업스트림은 정책 "sequential"을 사용하여 /etc/resolv.conf로 기본 설정됩니다.
유형
object
속성유형설명

policy

string

정책은 업스트림 서버가 쿼리용으로 선택한 순서를 결정하는 데 사용됩니다. 다음 값 중 하나를 지정할 수 있습니다. * "Random"은 각 쿼리에 대해 임의의 업스트림 서버를 선택합니다. * "roundrobin"은 라운드 로빈 순서로 업스트림 서버를 선택하여 새 쿼리마다 다음 서버로 이동합니다. * "sequential"은 새 쿼리마다 첫 번째 서버부터 시작하여 순차적 순서로 업스트림 서버를 쿼리합니다. 기본값은 "Sequential"입니다.

protocolStrategy

string

protocolStrategy는 업스트림 DNS 요청에 사용할 프로토콜을 지정합니다. protocolStrategy의 유효한 값은 "TCP"이고 생략되었습니다. 생략하면 이는 의견이 없으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 적절한 기본값을 선택할 수 있음을 의미합니다. 현재 기본값은 원래 클라이언트 요청의 프로토콜을 사용하는 것입니다. "TCP"는 클라이언트 요청이 UDP를 사용하는 경우에도 플랫폼에서 모든 업스트림 DNS 요청에 TCP를 사용하도록 지정합니다. "TCP"는 비호환 업스트림 확인자가 생성한 것과 같은 UDP 관련 문제에 유용하지만 더 많은 대역폭을 사용하거나 DNS 응답 시간을 늘릴 수 있습니다. protocolStrategy는 CoreDNS가 업스트림 해석기에 수행하는 DNS 요청 프로토콜에만 영향을 미칩니다. 클라이언트와 CoreDNS 간 DNS 요청 프로토콜에는 영향을 미치지 않습니다.

transportConfig

object

transportConfig는 DNS 요청을 업스트림 확인기로 전달할 때 사용할 전송 유형, 서버 이름 및 선택적 사용자 정의 CA 또는 CA 번들을 구성하는 데 사용됩니다. 기본값은 ""(비어 있음)이므로 DNS 요청을 업스트림 확인기로 전달할 때 표준 일반 텍스트 연결이 사용됩니다.

upstreams

array

업스트림은 "." 도메인에 대한 이름 쿼리를 전달하는 확인자 목록입니다. CoreDNS의 각 인스턴스는 Upstreams의 상태 점검을 수행합니다. 정상 업스트림에서 교환 중에 오류를 반환하면 Upstreams에서 다른 해결 프로그램이 시도됩니다. Upstreams는 정책에 지정된 순서로 선택됩니다. ForwardPlugin당 최대 15개의 업스트림이 허용됩니다. Upstreams를 지정하지 않으면 기본적으로 /etc/resolv.conf가 사용됩니다.

upstreams[]

object

업스트림 유형은 SystemResolvConf 유형 또는 Network 유형일 수 있습니다. * SystemResolvConf 유형의 Upstream의 경우 추가 필드가 필요하지 않습니다. /etc/resolv.conf를 사용하도록 업스트림이 구성됩니다. * Network 유형의 Upstream의 경우 업스트림에서 53 이외의 포트에서 수신 대기하는 경우 IP 주소 또는 IP:port를 사용하여 NetworkResolver 필드를 정의해야 합니다.

10.1.13. .spec.upstreamResolvers.transportConfig

설명
transportConfig는 DNS 요청을 업스트림 확인기로 전달할 때 사용할 전송 유형, 서버 이름 및 선택적 사용자 정의 CA 또는 CA 번들을 구성하는 데 사용됩니다. 기본값은 ""(비어 있음)이므로 DNS 요청을 업스트림 확인기로 전달할 때 표준 일반 텍스트 연결이 사용됩니다.
유형
object
속성유형설명

tls

object

TLS에는 Transport가 "TLS"로 설정될 때 사용할 추가 구성 옵션이 포함되어 있습니다.

transport

string

클러스터 관리자는 전송을 통해 클러스터 DNS와 업스트림 확인자 간에 DNS-over-TLS 연결을 사용할 수 있습니다. CABundle을 구성하지 않고 이 수준에서 TLS를 전송으로 구성하면 시스템 인증서가 업스트림 확인자의 제공 인증서를 확인하는 데 사용됩니다. 가능한 값: ""(비어 있음) - 이는 명시적 선택이 이루어지지 않았으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 기본값을 선택합니다. 현재 기본값은 "text"입니다. "cleartext" - 클러스터 관리자가 일반 텍스트 옵션을 지정합니다. 이렇게 하면 빈 값과 동일한 기능이 생성되지만 클러스터 관리자가 전송에 대해 보다 명확하게 설명하거나 "TLS"에서 "text"로 명시적으로 전환하려는 경우 유용할 수 있습니다. "TLS" - DNS 쿼리를 TLS 연결을 통해 전송해야 함을 나타냅니다. Transport가 TLS로 설정된 경우 ServerName도 설정해야 합니다. 업스트림 IP에 포트가 포함되어 있지 않은 경우 기본적으로 RFC 7858 섹션 3.1; https://datatracker.ietf.org/doc/html/rfc7858#section-3.1.에 따라 포트 853을 시도합니다.

10.1.14. .spec.upstreamResolvers.transportConfig.tls

설명
TLS에는 Transport가 "TLS"로 설정될 때 사용할 추가 구성 옵션이 포함되어 있습니다.
유형
object
필수 항목
  • serverName
속성유형설명

cabundle

object

cabundle은 단일 CA 인증서 또는 CA 번들을 포함해야 하는 ConfigMap을 참조합니다. 이를 통해 클러스터 관리자는 업스트림 리졸버의 인증서를 검증하기 위해 자체 CA 또는 CA 번들을 제공할 수 있습니다. 1. configmap에는 ca-bundle.crt 키가 포함되어야 합니다. 2. 값은 PEM 인코딩 CA 인증서 또는 CA 번들이어야 합니다. 3. 관리자는 openshift-config 네임스페이스에 이 configmap을 생성해야 합니다. 4. 업스트림 서버 인증서에는 ServerName과 일치하는 SAN(주체 대체 이름)이 포함되어야 합니다.

serverName

string

ServerName은 DNS 쿼리를 전달할 때 연결할 업스트림 서버입니다. 이는 Transport가 "TLS"로 설정된 경우 필요합니다. ServerName은 RFC 1123의 DNS 이름 지정 규칙에 대해 검증되며 업스트림 확인자에 설치된 TLS 인증서와 일치해야 합니다.

10.1.15. .spec.upstreamResolvers.transportConfig.tls.caBundle

설명
cabundle은 단일 CA 인증서 또는 CA 번들을 포함해야 하는 ConfigMap을 참조합니다. 이를 통해 클러스터 관리자는 업스트림 리졸버의 인증서를 검증하기 위해 자체 CA 또는 CA 번들을 제공할 수 있습니다. 1. configmap에는 ca-bundle.crt 키가 포함되어야 합니다. 2. 값은 PEM 인코딩 CA 인증서 또는 CA 번들이어야 합니다. 3. 관리자는 openshift-config 네임스페이스에 이 configmap을 생성해야 합니다. 4. 업스트림 서버 인증서에는 ServerName과 일치하는 SAN(주체 대체 이름)이 포함되어야 합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

10.1.16. .spec.upstreamResolvers.upstreams

설명
업스트림은 "." 도메인에 대한 이름 쿼리를 전달하는 확인자 목록입니다. CoreDNS의 각 인스턴스는 Upstreams의 상태 점검을 수행합니다. 정상 업스트림에서 교환 중에 오류를 반환하면 Upstreams에서 다른 해결 프로그램이 시도됩니다. Upstreams는 정책에 지정된 순서로 선택됩니다. ForwardPlugin당 최대 15개의 업스트림이 허용됩니다. Upstreams를 지정하지 않으면 기본적으로 /etc/resolv.conf가 사용됩니다.
유형
array

10.1.17. .spec.upstreamResolvers.upstreams[]

설명
업스트림 유형은 SystemResolvConf 유형 또는 Network 유형일 수 있습니다. * SystemResolvConf 유형의 Upstream의 경우 추가 필드가 필요하지 않습니다. /etc/resolv.conf를 사용하도록 업스트림이 구성됩니다. * Network 유형의 Upstream의 경우 업스트림에서 53 이외의 포트에서 수신 대기하는 경우 IP 주소 또는 IP:port를 사용하여 NetworkResolver 필드를 정의해야 합니다.
유형
object
필수 항목
  • type
속성유형설명

address

string

Type이 Network로 설정된 경우 주소를 정의해야 합니다. 그렇지 않으면 무시됩니다. 유효한 ipv4 또는 ipv6 주소여야 합니다.

port

integer

Type이 Network로 설정된 경우 포트를 정의할 수 있습니다. 그렇지 않으면 무시됩니다. 포트는 65535 사이여야 합니다.

type

string

type은 이 업스트림에 IP/IP:port 확인자 또는 로컬 /etc/resolv.conf가 포함되어 있는지 여부를 정의합니다. type은 SystemResolvConf 또는 Network의 두 가지 가능한 값을 허용합니다. * SystemResolvConf를 사용하는 경우 Upstream 구조에 추가 필드를 정의할 필요가 없습니다. /etc/resolv.conf를 사용할 때 네트워크 사용 시 Upstream 구조에 적어도 하나의 주소가 포함되어야 합니다.

10.1.18. .status

설명
상태는 DNS의 가장 최근에 관찰된 상태입니다.
유형
object
필수 항목
  • clusterDomain
  • clusterIP
속성유형설명

clusterDomain

string

clusterDomain은 DNS 서비스의 로컬 클러스터 DNS 도메인 접미사입니다. RFC 1034에 정의된 하위 도메인입니다. 3.5 섹션: https://tools.ietf.org/html/rfc1034#section-3.5 예: "cluster.local" 추가 정보: https://kubernetes.io/docs/concepts/services-networking/dns-pod-service

clusterIP

string

ClusterIP는 이 DNS를 사용할 수 있는 서비스 IP입니다. 기본 DNS의 경우 기본 ClusterFirst DNS 정책을 사용하는 Pod의 기본 이름 서버로 사용되는 잘 알려진 IP입니다. 일반적으로 이 IP는 Pod의 spec.dnsConfig.nameservers 목록에 지정하거나 클러스터 내에서 이름 확인을 수행할 때 명시적으로 사용할 수 있습니다. 예: dig foo.com @<service IP> 추가 정보: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies

conditions

array

조건은 클러스터의 DNS 상태에 대한 정보를 제공합니다. 지원되는 DNS 조건: * Available - True if the following conditions are met: * DNS 컨트롤러 데몬 세트를 사용할 수 있습니다. - 해당 조건 중 하나라도 만족스럽지 않은 경우 False입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

10.1.19. .status.conditions

설명
조건은 클러스터의 DNS 상태에 대한 정보를 제공합니다. 지원되는 DNS 조건: * Available - True if the following conditions are met: * DNS 컨트롤러 데몬 세트를 사용할 수 있습니다. - 해당 조건 중 하나라도 만족스럽지 않은 경우 False입니다.
유형
array

10.1.20. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

10.2. API 끝점

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

  • /apis/operator.openshift.io/v1/dnses

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

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

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

10.2.1. /apis/operator.openshift.io/v1/dnses

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

string

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

HTTP 방법
DELETE
설명
DNS 컬렉션 삭제
표 10.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을 지정합니다.

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류 DNS의 오브젝트 나열
표 10.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을 지정합니다.

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

200 - OK

DNSList 스키마

401 - 무단

HTTP 방법
POST
설명
DNS 만들기
표 10.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

DNS 스키마

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

200 - OK

DNS 스키마

201 - 생성됨

DNS 스키마

202 - 승인됨

DNS 스키마

401 - 무단

10.2.2. /apis/operator.openshift.io/v1/dnses/{name}

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

name

string

DNS 이름

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

DNS 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 DNS를 부분적으로 업데이트
표 10.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

DNS 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 DNS를 교체
표 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

DNS 스키마

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

200 - OK

DNS 스키마

201 - 생성됨

DNS 스키마

401 - 무단

10.2.3. /apis/operator.openshift.io/v1/dnses/{name}/status

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

name

string

DNS 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

DNS 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 DNS의 상태를 부분적으로 업데이트
표 10.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

DNS 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 DNS의 상태 교체
표 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

DNS 스키마

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

200 - OK

DNS 스키마

201 - 생성됨

DNS 스키마

401 - 무단

11장. DNSRecord [ingress.operator.openshift.io/v1]

설명
DNSRecord는 dns.config.openshift.io/cluster .spec.publicZone 및 .spec.privateZone에서 정의한 영역에서 관리되는 DNS 레코드입니다. 이 리소스의 클러스터 관리자 조작은 지원되지 않습니다. 이 리소스는 OpenShift Operator의 내부 통신 전용입니다. DNSManagementPolicy가 "관리되지 않음"인 경우 Operator는 클라우드 공급자의 DNS 레코드를 관리할 수 없습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

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

spec은 dnsRecord의 원하는 동작의 사양입니다.

status

object

상태는 dnsRecord의 가장 최근에 관찰된 상태입니다.

11.1.1. .spec

설명
spec은 dnsRecord의 원하는 동작의 사양입니다.
유형
object
필수 항목
  • dnsManagementPolicy
  • dnsName
  • recordTTL
  • recordType
  • 대상
속성유형설명

dnsManagementPolicy

string

dnsManagementPolicy는 DNS 레코드에 적용된 현재 정책을 나타냅니다. 정책이 "관리되지 않음"으로 설정된 레코드는 Ingress Operator에서 무시합니다. 즉, 클라우드 공급자의 DNS 레코드는 Operator에 의해 관리되지 않으며 "게시됨" 상태 조건이 외부적으로 관리되므로 "알려진" 상태로 업데이트됩니다. 클라우드 공급자의 기존 레코드는 클러스터 관리자의 재량에 따라 삭제할 수 있습니다. 이 필드의 기본값은 Managed입니다. 유효한 값은 "Managed" 및 "Unmanaged"입니다.

dnsName

string

dnsName은 DNS 레코드의 호스트 이름입니다.

recordTTL

integer

recordTTL은 초 단위의 레코드 TTL입니다. 0인 경우 기본값은 30입니다. RecordTTL은 AWS 리전 Alias 대상에서 사용되지 않지만 AWS API 계약에 따라 CNAME 대상에서 사용됩니다.

recordType

string

recordType은 DNS 레코드 유형입니다. 예를 들면 "A" 또는 "CNAME"입니다.

대상

배열(문자열)

대상은 레코드 대상입니다.

11.1.2. .status

설명
상태는 dnsRecord의 가장 최근에 관찰된 상태입니다.
유형
object
속성유형설명

observedGeneration

integer

observedGeneration은 가장 최근에 관찰된 DNSRecord 생성입니다. DNSRecord가 업데이트되면 컨트롤러는 각 관리 영역의 해당 레코드를 업데이트합니다. 특정 영역에 대한 업데이트가 실패하면 컨트롤러가 해당 특정 영역에 대한 업데이트를 재시도해야 하는지 확인할 수 있도록 해당 실패가 영역의 상태 조건에 기록됩니다.

영역

array

영역은 각 영역에 있는 레코드의 상태입니다.

zones[]

object

DNSZoneStatus는 특정 영역 내의 레코드 상태입니다.

11.1.3. .status.zones

설명
영역은 각 영역에 있는 레코드의 상태입니다.
유형
array

11.1.4. .status.zones[]

설명
DNSZoneStatus는 특정 영역 내의 레코드 상태입니다.
유형
object
속성유형설명

conditions

array

조건은 영역의 레코드와 연결된 모든 조건입니다. 레코드 게시가 성공하면 "Published" 조건이 "True" 상태로 설정되고 실패 시 실패 원인을 설명하는 이유 및 메시지와 함께 "False"로 설정됩니다.

conditions[]

object

DNSZoneCondition은 표준 조건 필드입니다.

dnsZone

object

dnsZone은 레코드가 게시되는 영역입니다.

11.1.5. .status.zones[].conditions

설명
조건은 영역의 레코드와 연결된 모든 조건입니다. 레코드 게시가 성공하면 "Published" 조건이 "True" 상태로 설정되고 실패 시 실패 원인을 설명하는 이유 및 메시지와 함께 "False"로 설정됩니다.
유형
array

11.1.6. .status.zones[].conditions[]

설명
DNSZoneCondition은 표준 조건 필드입니다.
유형
object
필수 항목
  • status
  • type
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

11.1.7. .status.zones[].dnsZone

설명
dnsZone은 레코드가 게시되는 영역입니다.
유형
object
속성유형설명

id

string

ID는 DNS 호스팅 영역을 찾는 데 사용할 수 있는 식별자입니다. AWS 영역에서 ID 를 id로 사용하여 가져올 수 있습니다. Azure 영역의 ID는 [2]에서 ID 를 사용하여 가져올 수 있습니다 [2], GCP 영역의 ID 는 [3]에서 사전 결정된 이름으로 ID를 사용하여 가져올 수 있습니다. [1]: https://docs.aws.amazon.com/cli/latest/reference/route53/get-hosted-zone.html#options [2]: https://docs.microsoft.com/en-us/cli/azure/network/dns/zone?view=azure-cli-latest#az-network-dns-zone-show: https://cloud.google.com/dns/docs/reference/v1/managedZones/get

tags

오브젝트(문자열)

태그는 DNS 호스팅 영역을 쿼리하는 데 사용할 수 있습니다. AWS의 resourcegroupstaggingapi [1]은 태그 필터로 태그 를 사용하여 영역을 가져오는 데 사용할 수 있습니다 [1]: https://docs.aws.amazon.com/cli/latest/reference/resourcegroupstaggingapi/get-resources.html#options

11.2. API 끝점

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

  • /apis/ingress.operator.openshift.io/v1/dnsrecords

    • GET: 종류의 DNSRecord 오브젝트 나열
  • /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords

    • DELETE: DNSRecord의 컬렉션 삭제
    • GET: 종류의 DNSRecord 오브젝트 나열
    • POST: DNSRecord 만들기
  • /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords/{name}

    • DELETE: DNSRecord 삭제
    • GET: 지정된 DNSRecord를 읽습니다.
    • PATCH: 지정된 DNSRecord를 부분적으로 업데이트
    • PUT: 지정된 DNSRecord를 교체
  • /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords/{name}/status

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

11.2.1. /apis/ingress.operator.openshift.io/v1/dnsrecords

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

string

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

DNSRecordList 스키마

401 - 무단

11.2.2. /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords

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

네임스페이스

string

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

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

DNSRecordList 스키마

401 - 무단

HTTP 방법
POST
설명
DNSRecord 만들기
표 11.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

DNSRecord 스키마

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

200 - OK

DNSRecord 스키마

201 - 생성됨

DNSRecord 스키마

202 - 승인됨

DNSRecord 스키마

401 - 무단

11.2.3. /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords/{name}

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

name

string

DNSRecord 이름

네임스페이스

string

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

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

DNSRecord 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 DNSRecord를 부분적으로 업데이트
표 11.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

DNSRecord 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 DNSRecord를 교체
표 11.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

DNSRecord 스키마

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

200 - OK

DNSRecord 스키마

201 - 생성됨

DNSRecord 스키마

401 - 무단

11.2.4. /apis/ingress.operator.openshift.io/v1/namespaces/{namespace}/dnsrecords/{name}/status

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

name

string

DNSRecord 이름

네임스페이스

string

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

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

DNSRecord 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 DNSRecord의 부분적으로 업데이트 상태
표 11.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

DNSRecord 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 DNSRecord의 상태 교체
표 11.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

DNSRecord 스키마

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

200 - OK

DNSRecord 스키마

201 - 생성됨

DNSRecord 스키마

401 - 무단

12장. Etcd [operator.openshift.io/v1]

설명
etcd는 etcd를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

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

 

12.1.1. .spec

설명
유형
object
속성유형설명

failedRevisionLimit

integer

failedRevisionLimit은 디스크를 유지하고 api -1 = 무제한, 0 또는 unset = 5(기본값)에서 유지하는 실패한 정적 Pod 설치 프로그램 버전 수입니다.

forceRedeploymentReason

string

forceRedeploymentReason을 사용하여 고유한 문자열을 제공하여 피연산자를 강제로 재배포할 수 있습니다. 이를 통해 이전에 실패한 배포를 시작하는 메커니즘을 제공하고 동일한 구성에서 다시 실패하지 않고 이번에는 작동한다고 생각하는 이유를 제공합니다.

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

succeededRevisionLimit

integer

succeededRevisionLimit은 디스크에 보관하고 api -1 = 무제한, 0 또는 설정되지 않은 = 5(기본값)에서 유지하는 정적 Pod 설치 프로그램 리버전의 수입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

12.1.2. .status

설명
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

latestAvailableRevision

integer

latestAvailableRevision은 최신 배포의 deploymentID입니다.

latestAvailableRevisionReason

string

latestAvailableRevisionReason은 최신 배포의 자세한 이유를 설명합니다.

nodeStatuses

array

nodeStatuses는 개별 노드에서 배포 값과 오류를 추적합니다.

nodeStatuses[]

object

NodeStatus는 이 Operator가 관리하는 특정 노드의 현재 상태에 대한 정보를 제공합니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

12.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

12.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

12.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

12.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

12.1.7. .status.nodeStatuses

설명
nodeStatuses는 개별 노드에서 배포 값과 오류를 추적합니다.
유형
array

12.1.8. .status.nodeStatuses[]

설명
NodeStatus는 이 Operator가 관리하는 특정 노드의 현재 상태에 대한 정보를 제공합니다.
유형
object
속성유형설명

currentRevision

integer

currentRevision은 가장 최근에 성공한 배포를 생성하는 것입니다.

lastFailedCount

integer

lastFailedCount는 마지막 실패한 리버전의 설치 프로그램 Pod가 실패한 빈도입니다.

lastFailedReason

string

lastFailedReason은 머신에서 읽을 수 있는 실패 이유 문자열입니다.

lastFailedRevision

integer

lastFailedRevision은 시도한 배포 생성이며 배포에 실패했습니다.

lastFailedRevisionErrors

배열(문자열)

lastFailedRevisionErrors는 lastFailedRevision에서 참조한 실패한 배포 중에 사람이 읽을 수 있는 오류 목록입니다.

lastFailedTime

string

lastFailedTime은 마지막으로 실패한 리버전이 마지막으로 실패한 시간입니다.

lastFallbackCount

integer

lastFallbackCount는 이전 수정으로 대체되는 빈도입니다.

nodeName

string

nodename은 노드의 이름입니다.

targetRevision

integer

targetRevision은 적용하려는 배포 생성입니다.

12.2. API 끝점

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

  • /apis/operator.openshift.io/v1/etcds

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

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

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

12.2.1. /apis/operator.openshift.io/v1/etcds

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
Etcd 유형의 오브젝트 나열
표 12.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을 지정합니다.

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

200 - OK

EtcdList schema

401 - 무단

HTTP 방법
POST
설명
Etcd 생성
표 12.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

etcd 스키마

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

200 - OK

etcd 스키마

201 - 생성됨

etcd 스키마

202 - 승인됨

etcd 스키마

401 - 무단

12.2.2. /apis/operator.openshift.io/v1/etcds/{name}

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

name

string

Etcd의 이름

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

etcd 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 Etcd를 부분적으로 업데이트
표 12.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

etcd 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 Etcd를 교체
표 12.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

etcd 스키마

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

200 - OK

etcd 스키마

201 - 생성됨

etcd 스키마

401 - 무단

12.2.3. /apis/operator.openshift.io/v1/etcds/{name}/status

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

name

string

Etcd의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

etcd 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 Etcd의 부분 업데이트 상태
표 12.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

etcd 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 Etcd의 상태 교체
표 12.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

etcd 스키마

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

200 - OK

etcd 스키마

201 - 생성됨

etcd 스키마

401 - 무단

13장. ImageContentSourcePolicy [operator.openshift.io/v1alpha1]

설명
ImageContentSourcePolicy에는 레지스트리 미러 규칙을 처리하는 방법에 대한 클러스터 전체 정보가 들어 있습니다. 여러 정책이 정의되면 동작 결과가 각 필드에 정의됩니다. 호환성 수준 4: 호환성이 제공되지 않으며, API는 어떠한 이유로든 변경될 수 있습니다. 이러한 기능은 장기 지원이 필요한 애플리케이션에서 사용해서는 안 됩니다.
유형
object
필수 항목
  • spec

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

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

13.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

repositoryDigestMirrors

array

repositoryDigestMirrors를 사용하면 Pod의 이미지 다이제스트에서 참조하는 이미지를 다른 미러링된 저장소 위치에서 가져올 수 있습니다. Pod에 제공된 이미지 가져오기 사양은 RepositoryDigestMirrors에 설명된 소스 위치와 비교되며, 이미지는 지정된 저장소 대신 목록의 미러에서 다운될 수 있으므로 관리자가 잠재적으로 더 빠른 미러를 선택할 수 있습니다. 이미지 다이제스트가 있는 이미지 가져오기 사양만 이 동작이 적용됩니다. - 태그는 가져오기 사양의 지정된 리포지토리에서 계속 가져옵니다. 각 "소스" 리포지토리는 개별적으로 처리됩니다. 다른 "소스" 리포지토리의 구성은 상호 작용하지 않습니다. 동일한 "소스" 저장소에 대해 여러 정책이 정의되면 정의된 미러 세트가 함께 병합되어 가능한 경우 미러의 상대 순서를 유지합니다. 예를 들어 정책 A에 미러 a, b, c 및 정책 B에 미러 c, d, e 가 있는 경우 미러는 a, b, c, d, e 순서로 사용됩니다. 미러 항목 순서가 충돌하는 경우(예: a, b vs). b) 구성이 거부되지 않지만 결과 순서가 지정되지 않습니다.

repositoryDigestMirrors[]

object

RepositoryDigestMirrors는 레지스트리 구성에서 mirros를 처리하는 방법에 대한 클러스터 전체 정보를 보유합니다. 참고: 미러는 다이제스트에서 참조하는 이미지를 가져올 때만 작동합니다.

13.1.2. .spec.repositoryDigestMirrors

설명
repositoryDigestMirrors를 사용하면 Pod의 이미지 다이제스트에서 참조하는 이미지를 다른 미러링된 저장소 위치에서 가져올 수 있습니다. Pod에 제공된 이미지 가져오기 사양은 RepositoryDigestMirrors에 설명된 소스 위치와 비교되며, 이미지는 지정된 저장소 대신 목록의 미러에서 다운될 수 있으므로 관리자가 잠재적으로 더 빠른 미러를 선택할 수 있습니다. 이미지 다이제스트가 있는 이미지 가져오기 사양만 이 동작이 적용됩니다. - 태그는 가져오기 사양의 지정된 리포지토리에서 계속 가져옵니다. 각 "소스" 리포지토리는 개별적으로 처리됩니다. 다른 "소스" 리포지토리의 구성은 상호 작용하지 않습니다. 동일한 "소스" 저장소에 대해 여러 정책이 정의되면 정의된 미러 세트가 함께 병합되어 가능한 경우 미러의 상대 순서를 유지합니다. 예를 들어 정책 A에 미러 a, b, c 및 정책 B에 미러 c, d, e 가 있는 경우 미러는 a, b, c, d, e 순서로 사용됩니다. 미러 항목 순서가 충돌하는 경우(예: a, b vs). b) 구성이 거부되지 않지만 결과 순서가 지정되지 않습니다.
유형
array

13.1.3. .spec.repositoryDigestMirrors[]

설명
RepositoryDigestMirrors는 레지스트리 구성에서 mirros를 처리하는 방법에 대한 클러스터 전체 정보를 보유합니다. 참고: 미러는 다이제스트에서 참조하는 이미지를 가져올 때만 작동합니다.
유형
object
필수 항목
  • 소스
속성유형설명

미러

배열(문자열)

미러는 동일한 이미지를 포함할 수도 있는 하나 이상의 리포지토리입니다. 이 목록의 미러 순서는 사용자의 원하는 우선 순위로 처리되지만 소스는 기본적으로 모든 미러보다 낮은 우선 순위로 간주됩니다. 다른 repositoryDigestMirrors 오브젝트를 포함한 기타 클러스터 구성은 다른 repositoryDigestMirrors 오브젝트에 영향을 미칠 수 있고, 정확한 순서 지정에 영향을 미치거나, 일부 미러는 병렬로 연락을 취할 수 있으므로 주문 보장 대신 기본 설정으로 간주해야 합니다.

소스

string

source는 사용자가 참조하는 리포지토리입니다(예: 이미지 가져오기 사양에서).

13.2. API 끝점

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

  • /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies

    • DELETE: ImageContentSourcePolicy의 컬렉션 삭제
    • GET: 종류의 ImageContentSourcePolicy 개체 나열
    • POST: ImageContentSourcePolicy 생성
  • /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies/{name}

    • DELETE: delete an ImageContentSourcePolicy
    • GET: 지정된 ImageContentSourcePolicy 읽기
    • PATCH: 지정된 ImageContentSourcePolicy를 부분적으로 업데이트
    • PUT: 지정된 ImageContentSourcePolicy를 교체합니다.
  • /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies/{name}/status

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

13.2.1. /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

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

fieldSelector

string

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

labelSelector

string

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

limit

integer

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

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

resourceVersion

string

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

기본값이 설정되지 않음

resourceVersionMatch

string

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

기본값이 설정되지 않음

timeoutSeconds

integer

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

watch

boolean

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

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
특정 ImageContentSourcePolicy 개체 나열
표 13.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을 지정합니다.

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

200 - OK

ImageContentSourcePolicyList schema

401 - 무단

HTTP 방법
POST
설명
ImageContentSourcePolicy 생성
표 13.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

ImageContentSourcePolicy schema

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

200 - OK

ImageContentSourcePolicy schema

201 - 생성됨

ImageContentSourcePolicy schema

202 - 승인됨

ImageContentSourcePolicy schema

401 - 무단

13.2.2. /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies/{name}

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

name

string

ImageContentSourcePolicy의 이름

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ImageContentSourcePolicy schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 ImageContentSourcePolicy를 부분적으로 업데이트
표 13.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

ImageContentSourcePolicy schema

401 - 무단

HTTP 방법
PUT
설명
지정된 ImageContentSourcePolicy를 교체
표 13.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

ImageContentSourcePolicy schema

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

200 - OK

ImageContentSourcePolicy schema

201 - 생성됨

ImageContentSourcePolicy schema

401 - 무단

13.2.3. /apis/operator.openshift.io/v1alpha1/imagecontentsourcepolicies/{name}/status

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

name

string

ImageContentSourcePolicy의 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ImageContentSourcePolicy schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 ImageContentSourcePolicy의 부분적으로 업데이트 상태
표 13.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

ImageContentSourcePolicy schema

401 - 무단

HTTP 방법
PUT
설명
지정된 ImageContentSourcePolicy의 상태 교체
표 13.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

ImageContentSourcePolicy schema

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

200 - OK

ImageContentSourcePolicy schema

201 - 생성됨

ImageContentSourcePolicy schema

401 - 무단

14장. ImagePruner [imageregistry.operator.openshift.io/v1]

설명
ImagePruner는 레지스트리 운영자가 관리하는 이미지 레지스트리 정리기에 대한 구성 오브젝트입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • 메타데이터
  • spec

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

ImagePrunerSpec은 실행 중인 이미지 정리기에 대한 사양을 정의합니다.

status

object

ImagePrunerStatus는 이미지 정리기 작동 상태를 보고합니다.

14.1.1. .spec

설명
ImagePrunerSpec은 실행 중인 이미지 정리기에 대한 사양을 정의합니다.
유형
object
속성유형설명

유사성

object

유사성은 이미지 정리기 Pod에 대한 노드 유사성 스케줄링 규칙 그룹입니다.

failedJobsHistoryLimit

integer

failedJobsHistoryLimit은 유지할 실패한 이미지 정리기 작업 수를 지정합니다. 설정되지 않은 경우 기본값은 3입니다.

ignoreInvalidImageReferences

boolean

ignoreInvalidImageReferences는 프루너가 이미지 참조를 구문 분석하는 동안 오류를 무시할 수 있는지 여부를 나타냅니다.

keepTagRevisions

integer

keepTagRevisions는 보존할 이미지 스트림에서 태그의 이미지 버전 수를 지정합니다. 기본값은 3입니다.

keepYoungerThan

integer

keepYoungerThan은 이미지의 최소 나이를 나노초 단위로 지정하고 정리 후보로 간주하기 위한 참조자를 지정합니다. DEPRECATED: 이 필드는 keepYoungerThanDuration을 대신하여 더 이상 사용되지 않습니다. 둘 다 설정된 경우 이 필드는 무시되고 keepYoungerThanDuration이 우선합니다.

keepYoungerThanDuration

string

keepYoungerThanDuration은 이미지의 최소 사용 기간과 해당 참조자가 정리 후보로 간주되도록 지정합니다. 기본값은 60m(60분)입니다.

logLevel

string

loglevel은 pruner 작업의 로그 출력 수준을 설정합니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

nodeSelector

오브젝트(문자열)

nodeSelector는 이미지 정리기 Pod에 대한 노드 선택 제약 조건을 정의합니다.

resources

object

리소스는 이미지 정리기 Pod에 대한 리소스 요청 및 제한을 정의합니다.

스케줄

string

schedule은 표준 cronjob 구문을 사용하여 작업을 실행할 시기를 지정합니다. https://wikipedia.org/wiki/Cron. 기본값은 0 0 * * 입니다.

successfulJobsHistoryLimit

integer

successfulJobsHistoryLimit은 보유할 이미지 정리기 작업 수를 지정합니다. 설정되지 않은 경우 기본값은 3입니다.

일시 중단

boolean

suspend는 이 cronjob의 후속 실행을 일시 중단할지 여부를 지정합니다. 기본값은 false입니다.

허용 오차

array

허용 오차는 이미지 정리기 Pod의 노드 허용 오차를 정의합니다.

tolerations[]

object

이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.

14.1.2. .spec.affinity

설명
유사성은 이미지 정리기 Pod에 대한 노드 유사성 스케줄링 규칙 그룹입니다.
유형
object
속성유형설명

nodeAffinity

object

Pod의 노드 유사성 스케줄링 규칙을 설명합니다.

podAffinity

object

Pod 유사성 예약 규칙에 대해 설명합니다(예: 다른 Pod와 동일한 노드, 영역 등에서 이 Pod를 공동 배치).

podAntiAffinity

object

Pod 유사성 방지 스케줄링 규칙을 설명합니다. 예를 들어 이 Pod를 다른 Pod와 동일한 노드, 영역에 배치하지 않도록 합니다.

14.1.3. .spec.affinity.nodeAffinity

설명
Pod의 노드 유사성 스케줄링 규칙을 설명합니다.
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 노드이며, 이 필드의 요소를 반복하고 노드가 해당 matchExpressions와 일치하는 경우 "weight"을 합계에 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

권장되는 빈 스케줄링 용어는 암시적 가중치가 0인 모든 오브젝트와 일치합니다(즉, no-op임). null 기본 스케줄링 용어는 오브젝트(즉, no-op)와 일치하지 않습니다.

requiredDuringSchedulingIgnoredDuringExecution

object

이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다.

14.1.4. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 노드이며, 이 필드의 요소를 반복하고 노드가 해당 matchExpressions와 일치하는 경우 "weight"을 합계에 추가하여 합계를 더 많이 계산합니다.
유형
array

14.1.5. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
권장되는 빈 스케줄링 용어는 암시적 가중치가 0인 모든 오브젝트와 일치합니다(즉, no-op임). null 기본 스케줄링 용어는 오브젝트(즉, no-op)와 일치하지 않습니다.
유형
object
필수 항목
  • preference
  • weight
속성유형설명

preference

object

해당 가중치와 연결된 노드 선택기 용어입니다.

weight

integer

1-100 범위의 해당 nodeSelectorTerm과 일치하는 가중치입니다.

14.1.6. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference

설명
해당 가중치와 연결된 노드 선택기 용어입니다.
유형
object
속성유형설명

matchExpressions

array

노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.

matchExpressions[]

object

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

matchFields

array

노드의 필드별 노드 선택기 요구 사항 목록입니다.

matchFields[]

object

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

14.1.7. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions

설명
노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
유형
array

14.1.8. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions[]

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

key

string

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

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

14.1.9. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields

설명
노드의 필드별 노드 선택기 요구 사항 목록입니다.
유형
array

14.1.10. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields[]

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

key

string

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

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

14.1.11. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다.
유형
object
필수 항목
  • nodeSelectorTerms
속성유형설명

nodeSelectorTerms

array

필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다.

nodeSelectorTerms[]

object

null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.

14.1.12. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms

설명
필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다.
유형
array

14.1.13. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[]

설명
null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.
유형
object
속성유형설명

matchExpressions

array

노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.

matchExpressions[]

object

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

matchFields

array

노드의 필드별 노드 선택기 요구 사항 목록입니다.

matchFields[]

object

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

14.1.14. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions

설명
노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
유형
array

14.1.15. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions[]

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

key

string

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

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

14.1.16. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields

설명
노드의 필드별 노드 선택기 요구 사항 목록입니다.
유형
array

14.1.17. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields[]

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

key

string

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

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

14.1.18. .spec.affinity.podAffinity

설명
Pod 유사성 예약 규칙에 대해 설명합니다(예: 다른 Pod와 동일한 노드, 영역 등에서 이 Pod를 공동 배치).
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 합계에 "weight"을 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.

requiredDuringSchedulingIgnoredDuringExecution

array

이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: Pod 레이블 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.

requiredDuringSchedulingIgnoredDuringExecution[]

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

14.1.19. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 합계에 "weight"을 추가하여 합계를 더 많이 계산합니다.
유형
array

14.1.20. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.
유형
object
필수 항목
  • podAffinityTerm
  • weight
속성유형설명

podAffinityTerm

object

필수 항목입니다. 해당 가중치와 연결된 Pod 유사성 용어입니다.

weight

integer

1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다.

14.1.21. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

설명
필수 항목입니다. 해당 가중치와 연결된 Pod 유사성 용어입니다.
유형
object
필수 항목
  • TopologyKey
속성유형설명

labelSelector

object

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

object

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

TopologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

14.1.22. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector

설명
리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

14.1.23. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions

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

14.1.24. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

14.1.25. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector

설명
용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

14.1.26. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions

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

14.1.27. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

14.1.28. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: Pod 레이블 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.
유형
array

14.1.29. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • TopologyKey
속성유형설명

labelSelector

object

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

object

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

TopologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

14.1.30. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector

설명
리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

14.1.31. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions

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

14.1.32. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

14.1.33. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector

설명
용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

14.1.34. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions

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

14.1.35. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

14.1.36. .spec.affinity.podAntiAffinity

설명
Pod 유사성 방지 스케줄링 규칙을 설명합니다. 예를 들어 이 Pod를 다른 Pod와 동일한 노드, 영역에 배치하지 않도록 합니다.
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 유사성 방지 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling anti-affinity expressions 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 "weight"을 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.

requiredDuringSchedulingIgnoredDuringExecution

array

이 필드에 지정된 유사성 방지 요구 사항이 스케줄링 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. 이 필드에 지정된 유사성 방지 요구 사항이 Pod 실행 중 일정 시점에 충족되지 않는 경우(예: Pod 라벨 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.

requiredDuringSchedulingIgnoredDuringExecution[]

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

14.1.37. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 유사성 방지 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling anti-affinity expressions 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 "weight"을 추가하여 합계를 더 많이 계산합니다.
유형
array

14.1.38. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.
유형
object
필수 항목
  • podAffinityTerm
  • weight
속성유형설명

podAffinityTerm

object

필수 항목입니다. 해당 가중치와 연결된 Pod 유사성 용어입니다.

weight

integer

1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다.

14.1.39. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

설명
필수 항목입니다. 해당 가중치와 연결된 Pod 유사성 용어입니다.
유형
object
필수 항목
  • topologyKey
속성유형설명

labelSelector

object

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

object

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

topologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

14.1.40. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector

설명
리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

14.1.41. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions

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

14.1.42. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

14.1.43. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector

설명
용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

14.1.44. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions

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

14.1.45. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

14.1.46. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
이 필드에 지정된 유사성 방지 요구 사항이 스케줄링 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. 이 필드에 지정된 유사성 방지 요구 사항이 Pod 실행 중 일정 시점에 충족되지 않는 경우(예: Pod 라벨 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.
유형
array

14.1.47. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • topologyKey
속성유형설명

labelSelector

object

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

object

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

topologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

14.1.48. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector

설명
리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

14.1.49. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions

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

14.1.50. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

14.1.51. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector

설명
용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

14.1.52. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions

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

14.1.53. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

14.1.54. .spec.resources

설명
리소스는 이미지 정리기 Pod에 대한 리소스 요청 및 제한을 정의합니다.
유형
object
속성유형설명

limits

integer-or-string

제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

14.1.55. .spec.tolerations

설명
허용 오차는 이미지 정리기 Pod의 노드 허용 오차를 정의합니다.
유형
array

14.1.56. .spec.tolerations[]

설명
이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.
유형
object
속성유형설명

effect

string

effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

key

string

키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다.

operator

string

Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다.

tolerationSeconds

integer

tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다.

value

string

값은 허용 오차와 일치하는 taint 값입니다. 연산자가 Exists인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다.

14.1.57. .status

설명
ImagePrunerStatus는 이미지 정리기 작동 상태를 보고합니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

observedGeneration

integer

observedGeneration은 적용된 마지막 생성 변경 사항입니다.

14.1.58. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

14.1.59. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

14.2. API 끝점

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

  • /apis/imageregistry.operator.openshift.io/v1/imagepruners

    • DELETE: ImagePruner의 컬렉션 삭제
    • GET: ImagePruner 유형의 오브젝트 나열
    • POST: ImagePruner 생성
  • /apis/imageregistry.operator.openshift.io/v1/imagepruners/{name}

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

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

14.2.1. /apis/imageregistry.operator.openshift.io/v1/imagepruners

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

string

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

HTTP 방법
DELETE
설명
ImagePruner 컬렉션 삭제
표 14.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을 지정합니다.

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ImagePruner 유형의 오브젝트 나열
표 14.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을 지정합니다.

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

200 - OK

ImagePrunerList schema

401 - 무단

HTTP 방법
POST
설명
ImagePruner 만들기
표 14.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

ImagePruner 스키마

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

200 - OK

ImagePruner 스키마

201 - 생성됨

ImagePruner 스키마

202 - 승인됨

ImagePruner 스키마

401 - 무단

14.2.2. /apis/imageregistry.operator.openshift.io/v1/imagepruners/{name}

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

name

string

ImagePruner 이름

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ImagePruner 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ImagePruner를 부분적으로 업데이트
표 14.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

ImagePruner 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ImagePruner를 교체
표 14.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

ImagePruner 스키마

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

200 - OK

ImagePruner 스키마

201 - 생성됨

ImagePruner 스키마

401 - 무단

14.2.3. /apis/imageregistry.operator.openshift.io/v1/imagepruners/{name}/status

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

name

string

ImagePruner 이름

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

ImagePruner 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ImagePruner의 부분적으로 업데이트 상태
표 14.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

ImagePruner 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ImagePruner의 상태 교체
표 14.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

ImagePruner 스키마

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

200 - OK

ImagePruner 스키마

201 - 생성됨

ImagePruner 스키마

401 - 무단

15장. IngressController [operator.openshift.io/v1]

설명
IngressController는 클러스터의 관리형 Ingress 컨트롤러를 설명합니다. 컨트롤러는 OpenShift 경로 및 Kubernetes 인그레스 리소스를 제공할 수 있습니다. IngressController가 생성되면 외부 트래픽이 Ingress 또는 Route 리소스를 노출하는 서비스에 도달할 수 있도록 새 수신 컨트롤러 배포가 생성됩니다. 이 리소스를 업데이트하면 새 수신 컨트롤러 리버전이 롤아웃될 수 있으므로 공용으로 발생하는 네트워크 연결이 중단될 수 있습니다. https://kubernetes.io/docs/concepts/services-networking/ingress-controllers 가능한 경우 플랫폼의 합리적인 기본값이 사용됩니다. 자세한 내용은 각 필드를 참조하십시오. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

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

spec은 IngressController의 원하는 동작의 사양입니다.

status

object

상태는 IngressController의 가장 최근에 관찰된 상태입니다.

15.1.1. .spec

설명
spec은 IngressController의 원하는 동작의 사양입니다.
유형
object
속성유형설명

clientTLS

object

clientTLS는 클라이언트 인증서를 요청 및 확인하는 설정을 지정합니다. 이 설정은 에지 종료 및 재암호화 경로에 대해 상호 TLS를 활성화하는 데 사용할 수 있습니다.

defaultCertificate

object

defaultCertificate는 Ingress 컨트롤러에서 제공하는 기본 인증서가 포함된 보안에 대한 참조입니다. 경로가 자체 인증서를 지정하지 않으면 defaultCertificate가 사용됩니다. 보안에는 tls.crt: certificate file contents tls.key: 키 파일 내용이 설정되지 않은 경우 와일드카드 인증서가 자동으로 생성되고 사용됩니다. 인증서는 Ingress 컨트롤러 도메인(및 하위 도메인)에 유효하며 생성된 인증서의 CA는 클러스터의 신뢰 저장소와 자동으로 통합됩니다. 와일드카드 인증서를 여러 HTTP/2 사용 경로( ALPN을 의미함)에서 사용하고 공유하는 경우 클라이언트(즉, 특히 브라우저)가 열려 있는 연결을 재사용하기 위해 자유로워집니다. 즉, 클라이언트가 다른 경로에 대한 연결을 재사용할 수 있으며 실패할 가능성이 큽니다. 이러한 동작을 일반적으로 연결 병합이라고 합니다. 사용 중인 인증서(생성 또는 사용자 지정)는 OpenShift의 내장 OAuth 서버와 자동으로 통합됩니다.

domain

string

domain은 Ingress 컨트롤러에서 제공하는 DNS 이름이며 여러 기능을 구성하는 데 사용됩니다. * LoadBalancerService 끝점 게시 전략의 경우 domain은 DNS 레코드를 구성하는 데 사용됩니다. endpointPublishingStrategy를 참조하십시오. 생성된 기본 인증서를 사용하는 경우 도메인 및 해당 하위 도메인에 인증서가 유효합니다. defaultCertificate를 참조하십시오. * 값은 개별 경로 상태에 게시되므로 최종 사용자가 외부 DNS 레코드를 대상으로 지정할 위치를 알고 있습니다. 도메인은 모든 IngressController 중에서 고유해야 하며 업데이트할 수 없습니다. 비어 있는 경우 기본값은 ingress.config.openshift.io/cluster .spec.domain입니다.

endpointPublishingStrategy

object

endpointPublishingStrategy는 Ingress 컨트롤러 끝점을 다른 네트워크에 게시하고 로드 밸런서 통합을 활성화하는 데 사용됩니다. 설정되지 않은 경우 기본값은 infrastructure.config.openshift.io/cluster .status.platform: AWS: LoadBalancerService (with External scope) GCP: LoadBalancerService (with External scope) GCP: LoadBalancerService(외부 범위 포함) IBMCloud: LoadBalancerService(외부 범위 포함) Libvirt: LoadBalancerService(외부 범위 포함) Libvirt: HostNetwork (including None) 기본 플랫폼 유형을 업데이트할 수 없습니다.

httpCompression

object

httpCompression은 HTTP 트래픽 압축 정책을 정의합니다. 기본적으로 HTTP 압축이 없습니다.

httpEmptyRequestsPolicy

string

HTTPEmptyRequestsPolicy는 요청을 수신하기 전에 연결 시간이 초과된 경우 HTTP 연결을 처리하는 방법을 설명합니다. 이 필드에 허용되는 값은 "Respond" 및 "Ignore"입니다. 필드가 "Respond"로 설정된 경우 Ingress 컨트롤러는 HTTP 400 또는 408 응답을 전송하고 연결을 기록하며(액세스 로깅이 활성화된 경우) 적절한 메트릭의 연결을 계산합니다. 필드가 "Ignore"로 설정된 경우 Ingress 컨트롤러는 응답을 보내거나 연결을 기록하거나 메트릭을 늘리지 않고 연결을 종료합니다. 기본값은 "Respond"입니다. 일반적으로 이러한 연결은 로드 밸런서의 상태 프로브 또는 웹 브라우저의 추측 연결("사전 연결")에서 제공되며 무시해도 됩니다. 그러나 이러한 요청은 네트워크 오류로 인해 발생할 수 있으므로 이 필드를 "Ignore"로 설정하면 문제를 탐지하고 진단할 수 있습니다. 또한 이러한 요청은 포트 검사로 인해 발생할 수 있으며, 이 경우 빈 요청을 로깅하면 침입 시도를 탐지하는 데 도움이 될 수 있습니다.

httpErrorCodePages

object

httpErrorCodePages는 사용자 정의 오류 페이지가 포함된 configmap을 지정합니다. 관리자는 openshift-config 네임스페이스에 이 configmap을 생성해야 합니다. 이 configmap에는 "error-page-<error code>.http 형식의 키가 있어야 합니다. 여기서 <error code>는 HTTP 오류 코드입니다. 예를 들어 "error-page-503.http"는 HTTP 503 응답에 대한 오류 페이지를 정의합니다. 현재 503 및 404 응답에 대한 오류 페이지만 사용자 지정할 수 있습니다. configmap의 각 값은 HTTP 헤더를 포함하여 전체 응답이어야 합니다. eg- https://raw.githubusercontent.com/openshift/router/fadab45747a9b30cc3f0a4b41ad2871f95827a93/images/router/haproxy/conf/error-page-503.http 이 필드가 비어 있으면 Ingress 컨트롤러에서 기본 오류 페이지를 사용합니다.

httpHeaders

object

httpHeaders는 HTTP 헤더에 대한 정책을 정의합니다. 이 필드가 비어 있으면 기본값이 사용됩니다.

logging

object

logging은 어디에서 기록해야 하는지에 대한 매개변수를 정의합니다. 이 필드가 비어 있으면 작동 로그는 활성화되지만 액세스 로그는 비활성화됩니다.

namespaceSelector

object

namespaceSelector는 Ingress 컨트롤러에서 서비스를 제공하는 네임스페이스 집합을 필터링하는 데 사용됩니다. 이는 분할을 구현하는 데 유용합니다. 설정되지 않은 경우 기본값은 필터링이 아닙니다.

nodePlacement

object

nodePlacement를 사용하면 Ingress 컨트롤러의 스케줄링을 명시적으로 제어할 수 있습니다. 설정되지 않은 경우 기본값이 사용됩니다. 자세한 내용은 NodePlacement를 참조하십시오.

replicas

integer

replicas는 원하는 개수의 수신 컨트롤러 복제본입니다. 설정되지 않은 경우 기본값은 클러스터 config.openshift.io/v1/ingresses 상태의 defaultPlacement 필드 값에 따라 다릅니다. replicas 값은 Infrastructure CR에서 선택한 필드의 값을 기반으로 설정됩니다. defaultPlacement가 ControlPlane로 설정된 경우 선택한 필드는 controlPlaneTopology가 됩니다. Workers로 설정된 경우 선택한 필드는 infrastructureTopology가 됩니다. 그런 다음 선택한 필드의 값이 SingleReplica 또는 HighlyAvailable인지 여부에 따라 복제본이 1 또는 2로 설정됩니다. 이러한 기본값은 변경될 수 있습니다.

routeAdmission

object

routeAdmission은 새 경로 클레임을 처리하기 위한 정책(예: 네임스페이스 간 클레임을 허용 또는 거부)을 정의합니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 routeAdmission 필드를 참조하십시오.

routeSelector

object

routeSelector는 Ingress 컨트롤러에서 서비스를 제공하는 경로 집합을 필터링하는 데 사용됩니다. 이는 분할을 구현하는 데 유용합니다. 설정되지 않은 경우 기본값은 필터링이 아닙니다.

tlsSecurityProfile

object

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

tuningOptions

object

tuningOptions는 수신 컨트롤러 Pod의 성능을 조정하기 위한 매개변수를 정의합니다. 모든 필드는 선택 사항이며 설정되지 않은 경우 해당 기본값을 사용합니다. 자세한 내용은 특정 tuningOptions 필드를 참조하십시오. 일반적으로 tuningOptions 내에서 필드를 설정하는 것은 권장되지 않습니다. 기본값은 대부분의 구성에 적합합니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides를 사용하면 지원되지 않는 구성 옵션을 지정할 수 있습니다. 해당 사용은 지원되지 않습니다.

15.1.2. .spec.clientTLS

설명
clientTLS는 클라이언트 인증서를 요청 및 확인하는 설정을 지정합니다. 이 설정은 에지 종료 및 재암호화 경로에 대해 상호 TLS를 활성화하는 데 사용할 수 있습니다.
유형
object
필수 항목
  • clientCA
  • clientCertificatePolicy
속성유형설명

allowedSubjectPatterns

배열(문자열)

AllowedSubjectPatterns는 요청을 필터링하기 위해 유효한 클라이언트 인증서의 고유 이름과 일치해야 하는 정규식 목록을 지정합니다. 정규 표현식은 PCRE 구문을 사용해야 합니다. 이 목록이 비어 있으면 필터링이 수행되지 않습니다. 목록이 비어 있지 않은 경우 하나 이상의 패턴이 클라이언트 인증서의 고유 이름과 일치해야 합니다. 그렇지 않으면 Ingress 컨트롤러에서 인증서를 거부하고 연결을 거부합니다.

clientCA

object

ClientCA는 클라이언트 인증서를 확인하는 데 사용해야 하는 PEM 인코딩 CA 인증서 번들이 포함된 configmap을 지정합니다. 관리자는 openshift-config 네임스페이스에 이 configmap을 생성해야 합니다.

clientCertificatePolicy

string

clientCertificatePolicy는 Ingress 컨트롤러에서 인증서를 제공하기 위해 클라이언트가 필요한지 여부를 지정합니다. 이 필드는 "필수" 또는 "선택 사항" 값을 허용합니다. 수신 컨트롤러는 클라이언트 인증서만 에지 종료 및 재암호화 TLS 경로에 대해 확인합니다. 일반 텍스트 HTTP 또는 패스스루 TLS 경로에 대한 인증서를 확인할 수 없습니다.

15.1.3. .spec.clientTLS.clientCA

설명
ClientCA는 클라이언트 인증서를 확인하는 데 사용해야 하는 PEM 인코딩 CA 인증서 번들이 포함된 configmap을 지정합니다. 관리자는 openshift-config 네임스페이스에 이 configmap을 생성해야 합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

15.1.4. .spec.defaultCertificate

설명
defaultCertificate는 Ingress 컨트롤러에서 제공하는 기본 인증서가 포함된 보안에 대한 참조입니다. 경로가 자체 인증서를 지정하지 않으면 defaultCertificate가 사용됩니다. 보안에는 tls.crt: certificate file contents tls.key: 키 파일 내용이 설정되지 않은 경우 와일드카드 인증서가 자동으로 생성되고 사용됩니다. 인증서는 Ingress 컨트롤러 도메인(및 하위 도메인)에 유효하며 생성된 인증서의 CA는 클러스터의 신뢰 저장소와 자동으로 통합됩니다. 와일드카드 인증서를 여러 HTTP/2 사용 경로( ALPN을 의미함)에서 사용하고 공유하는 경우 클라이언트(즉, 특히 브라우저)가 열려 있는 연결을 재사용하기 위해 자유로워집니다. 즉, 클라이언트가 다른 경로에 대한 연결을 재사용할 수 있으며 실패할 가능성이 큽니다. 이러한 동작을 일반적으로 연결 병합이라고 합니다. 사용 중인 인증서(생성 또는 사용자 지정)는 OpenShift의 내장 OAuth 서버와 자동으로 통합됩니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

15.1.5. .spec.endpointPublishingStrategy

설명
endpointPublishingStrategy는 Ingress 컨트롤러 끝점을 다른 네트워크에 게시하고 로드 밸런서 통합을 활성화하는 데 사용됩니다. 설정되지 않은 경우 기본값은 infrastructure.config.openshift.io/cluster .status.platform: AWS: LoadBalancerService (with External scope) GCP: LoadBalancerService (with External scope) GCP: LoadBalancerService(외부 범위 포함) IBMCloud: LoadBalancerService(외부 범위 포함) Libvirt: LoadBalancerService(외부 범위 포함) Libvirt: HostNetwork (including None) 기본 플랫폼 유형을 업데이트할 수 없습니다.
유형
object
필수 항목
  • type
속성유형설명

hostNetwork

object

HostNetwork에는 HostNetwork 끝점 게시 전략에 대한 매개 변수가 있습니다. type은 HostNetwork인 경우에만 존재합니다.

loadBalancer

object

LoadBalancer에는 로드 밸런서에 대한 매개변수가 있습니다. type이 LoadBalancerService인 경우에만 표시됩니다.

nodePort

object

NodePort에는 NodePortService 끝점 게시 전략에 대한 매개변수가 있습니다. type이 NodePortService인 경우에만 표시됩니다.

비공개

object

private에는 Private 엔드포인트 게시 전략에 대한 매개변수가 있습니다. type이 private인 경우에만 존재합니다.

type

string

type은 사용할 게시 전략입니다. 유효한 값은 다음과 같습니다. * LoadBalancerService는 Kubernetes LoadBalancer 서비스를 사용하여 수신 컨트롤러를 게시합니다. 이 구성에서 Ingress 컨트롤러 배포는 컨테이너 네트워킹을 사용합니다. 배포를 게시하기 위해 LoadBalancer 서비스가 생성됩니다. https://kubernetes.io/docs/concepts/services-networking/service/#loadbalancer domain이 설정된 경우 LoadBalancer 서비스의 외부 이름을 가리키도록 와일드카드 DNS 레코드가 관리됩니다. DNS 레코드는 dns.config.openshift.io/cluster .spec.publicZone 및 .spec.privateZone에서 정의한 DNS 영역에서만 관리됩니다. 와일드카드 DNS 관리는 현재 AWS, Azure 및 GCP 플랫폼에서만 지원됩니다. * HostNetwork는 Ingress 컨트롤러가 배포된 노드 포트에 Ingress 컨트롤러를 게시합니다. 이 구성에서 Ingress 컨트롤러 배포는 노드 포트 80 및 443에 바인딩된 호스트 네트워킹을 사용합니다. 사용자는 노드 포트를 통해 Ingress 컨트롤러를 게시하도록 외부 로드 밸런서를 구성해야 합니다. * private은 Ingress 컨트롤러를 게시하지 않습니다. 이 구성에서 Ingress 컨트롤러 배포는 컨테이너 네트워킹을 사용하며 명시적으로 게시되지 않습니다. 사용자가 Ingress 컨트롤러를 수동으로 게시해야 합니다. * NodePortService는 Kubernetes NodePort 서비스를 사용하여 수신 컨트롤러를 게시합니다. 이 구성에서 Ingress 컨트롤러 배포는 컨테이너 네트워킹을 사용합니다. 배포를 게시하기 위해 NodePort 서비스가 생성됩니다. 특정 노드 포트는 OpenShift에서 동적으로 할당하지만 정적 포트 할당을 지원하려면 관리형 NodePort 서비스의 노드 포트 필드에 대한 사용자 변경 사항이 유지됩니다.

15.1.6. .spec.endpointPublishingStrategy.hostNetwork

설명
HostNetwork에는 HostNetwork 끝점 게시 전략에 대한 매개 변수가 있습니다. type은 HostNetwork인 경우에만 존재합니다.
유형
object
속성유형설명

httpPort

integer

httpPort는 HTTP 요청을 수신 대기하는 데 사용해야 하는 호스트의 포트입니다. 포트 80을 이미 사용 중인 경우 이 필드를 설정해야 합니다. 이 값은 클러스터의 NodePort 범위와 일치해서는 안 됩니다. 값이 0이거나 지정하지 않으면 기본값은 80입니다.

httpsPort

integer

httpsPort는 HTTPS 요청을 수신 대기하는 데 사용해야 하는 호스트의 포트입니다. 443 포트를 이미 사용 중인 경우 이 필드를 설정해야 합니다. 이 값은 클러스터의 NodePort 범위와 일치해서는 안 됩니다. 값이 0이거나 지정하지 않으면 기본값은 443입니다.

protocol

string

protocol은 IngressController에서 들어오는 연결이 일반 TCP를 사용하도록 예상하는지 또는 IngressController에서 PROXY 프로토콜을 사용할지 여부를 지정합니다. PROXY 프로토콜은 IngressController로 해당 연결을 전달할 때 클라이언트 연결의 소스 주소를 전달하는 데 지원하는 로드 밸런서와 함께 사용할 수 있습니다. PROXY 프로토콜을 사용하면 IngressController에서 HTTP 헤더 및 로그에서 로드 밸런서의 주소를 보고하는 대신 해당 소스 주소를 보고할 수 있습니다. IngressController에서 PROXY 프로토콜을 활성화하면 IngressController에 연결을 전달하는 데 PROXY 프로토콜을 사용하는 로드 밸런서를 사용하지 않는 경우 연결이 실패합니다. PROXY 프로토콜에 대한 자세한 내용은 http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt 을 참조하십시오. 다음 값은 이 필드에 유효합니다. * 빈 문자열. * "TCP". * "PROXY". 빈 문자열은 PROXY 프로토콜이 없는 TCP인 기본값을 지정합니다. 기본값은 변경될 수 있습니다.

statsPort

integer

statsPort는 라우터의 통계가 게시되는 호스트의 포트입니다. 이 값은 클러스터의 NodePort 범위와 일치해서는 안 됩니다. 외부 로드 밸런서가 이 IngressController에 대한 연결을 전달하도록 구성된 경우 로드 밸런서에서 상태 점검에 이 포트를 사용해야 합니다. 로드 밸런서는 지정된 노드의 이 포트에 HTTP 프로브를 보낼 수 있으며 경로 /healthz/ready로 Ingress 컨트롤러가 노드에서 트래픽을 수신할 준비가 되었는지 확인할 수 있습니다. 적절한 작동의 경우 상태 점검이 준비되었다고 보고할 때까지 로드 밸런서에서 노드로 트래픽을 전달하지 않아야 합니다. 또한 로드 밸런서는 /healthz/ready 보고가 준비되지 않음을 시작한 후 최대 45초 이내에 요청 전달을 중지해야 합니다. 5초의 시간 초과로 5초에서 10초마다 프로빙하는 것은 각각 정상 또는 비정상 상태가 되는 두 개의 성공 또는 실패한 요청의 임계값을 각각 테스트한 값입니다. 값이 0이거나 지정하지 않으면 기본값은 1936입니다.

15.1.7. .spec.endpointPublishingStrategy.loadBalancer

설명
LoadBalancer에는 로드 밸런서에 대한 매개변수가 있습니다. type이 LoadBalancerService인 경우에만 표시됩니다.
유형
object
필수 항목
  • dnsManagementPolicy
  • scope
속성유형설명

allowedSourceRanges

``

allowedSourceRanges는 로드 밸런서에 대한 액세스를 제한해야 하는 IP 주소 범위의 허용 목록을 지정합니다. 각 범위는 CIDR 표기법을 사용하여 지정해야 합니다(예:). "10.0.0.0/8" or "fd00::/8"). 범위가 지정되지 않은 경우 IPv4의 경우 "0.0.0.0/0" 및 IPv6의 경우 "::/0"이 기본적으로 사용되어 모든 소스 주소를 허용합니다. allowedSourceRanges 필드가 없는 이전 버전의 OpenShift에서 원활하게 마이그레이션하기 위해 "openshift-ingress" 네임스페이스에서 "router-<ingresscontroller name>" 서비스에 service.beta.kubernetes.io/load-balancer-source-ranges 주석을 설정할 수 있으며, allowedSourceRanges가 OpenShift 4.12에 비어 있는 경우 이 주석이 적용됩니다.

dnsManagementPolicy

string

dnsManagementPolicy는 로드 밸런서 서비스와 연결된 와일드카드 DNS 레코드의 라이프사이클이 Ingress Operator에 의해 관리되는지를 나타냅니다. 기본값은 Managed입니다. 유효한 값은 Managed 및 Unmanaged입니다.

providerParameters

object

providerParameters에는 기본 인프라 공급자와 관련된 원하는 로드 밸런서 정보가 있습니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 providerParameters 필드를 참조하십시오.

scope

string

scope는 로드 밸런서가 노출되는 범위를 나타냅니다. 가능한 값은 "외부" 및 "내부"입니다.

15.1.8. .spec.endpointPublishingStrategy.loadBalancer.providerParameters

설명
providerParameters에는 기본 인프라 공급자와 관련된 원하는 로드 밸런서 정보가 있습니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 providerParameters 필드를 참조하십시오.
유형
object
필수 항목
  • type
속성유형설명

AWS

object

AWS는 AWS 로드 밸런서와 관련된 구성 설정을 제공합니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 aws 필드를 참조하십시오.

gcp

object

GCP는 GCP 로드 밸런서와 관련된 구성 설정을 제공합니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 gcp 필드를 참조하십시오.

type

string

type은 로드 밸런서의 기본 인프라 공급자입니다. 허용되는 값은 "AWS", "Azure", "BareMetal", "GCP", "Nutanix", "OpenStack" 및 "VSphere"입니다.

15.1.9. .spec.endpointPublishingStrategy.loadBalancer.providerParameters.aws

설명
AWS는 AWS 로드 밸런서와 관련된 구성 설정을 제공합니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 aws 필드를 참조하십시오.
유형
object
필수 항목
  • type
속성유형설명

classicLoadBalancer

object

ClassicLoadBalancerParameters에는 AWS 클래식 로드 밸런서에 대한 구성 매개변수가 있습니다. type이 Classic인 경우에만 표시됩니다.

networkLoadBalancer

object

NetworkLoadBalancerParameters에는 AWS 네트워크 로드 밸런서에 대한 구성 매개변수가 있습니다. type은 NLB인 경우에만 존재합니다.

type

string

type은 ingresscontroller를 인스턴스화할 AWS 로드 밸런서의 유형입니다. 유효한 값은 * "Classic": 전송 계층(TCP/SSL) 또는 애플리케이션 계층(HTTP/HTTPS)에서 라우팅을 결정하는 Classic Load Balancer입니다. 자세한 내용은 https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb * "NLB": 전송 계층(TCP/SSL)에서 라우팅을 결정하는 네트워크 로드 밸런서 장치입니다. 자세한 내용은 다음을 참조하십시오. https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb

15.1.10. .spec.endpointPublishingStrategy.loadBalancer.providerParameters.aws.classicLoadBalancer

설명
ClassicLoadBalancerParameters에는 AWS 클래식 로드 밸런서에 대한 구성 매개변수가 있습니다. type이 Classic인 경우에만 표시됩니다.
유형
object
속성유형설명

connectionIdleTimeout

string

connectionIdleTimeout은 로드 밸런서가 연결을 닫기 전에 연결이 유휴 상태일 수 있는 최대 기간을 지정합니다. 값은 시간 기간 값으로 구문 분석할 수 있어야 합니다. https://pkg.go.dev/time#ParseDuration 을 참조하십시오. nil 또는 0 값은 의견이 없으며, 이 경우 기본값이 사용됩니다. 이 필드의 기본값은 60s입니다. 이 기본값은 변경될 수 있습니다.

15.1.11. .spec.endpointPublishingStrategy.loadBalancer.providerParameters.aws.networkLoadBalancer

설명
NetworkLoadBalancerParameters에는 AWS 네트워크 로드 밸런서에 대한 구성 매개변수가 있습니다. type은 NLB인 경우에만 존재합니다.
유형
object

15.1.12. .spec.endpointPublishingStrategy.loadBalancer.providerParameters.gcp

설명
GCP는 GCP 로드 밸런서와 관련된 구성 설정을 제공합니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 gcp 필드를 참조하십시오.
유형
object
속성유형설명

clientAccess

string

clientAccess는 내부 로드 밸런서에 대해 클라이언트 액세스가 제한되는 방법을 설명합니다. 유효한 값은 * "Global": 글로벌 클라이언트 액세스를 사용하여 내부 로드 밸런서를 지정하면 VPC 내의 모든 리전의 클라이언트가 로드 밸런서와 통신할 수 있습니다. https://cloud.google.com/kubernetes-engine/docs/how-to/internal-load-balancing#global_access * "local": 로컬 클라이언트 액세스를 사용하여 내부 로드 밸런서를 지정하면 GCP 로드 밸런서가 로드 밸런서와 통신할 수 있는 것과 동일한 리전(및 VPC) 내의 클라이언트만 의미합니다. 이는 기본 동작입니다. https://cloud.google.com/load-balancing/docs/internal#client_access

15.1.13. .spec.endpointPublishingStrategy.nodePort

설명
NodePort에는 NodePortService 끝점 게시 전략에 대한 매개변수가 있습니다. type이 NodePortService인 경우에만 표시됩니다.
유형
object
속성유형설명

protocol

string

protocol은 IngressController에서 들어오는 연결이 일반 TCP를 사용하도록 예상하는지 또는 IngressController에서 PROXY 프로토콜을 사용할지 여부를 지정합니다. PROXY 프로토콜은 IngressController로 해당 연결을 전달할 때 클라이언트 연결의 소스 주소를 전달하는 데 지원하는 로드 밸런서와 함께 사용할 수 있습니다. PROXY 프로토콜을 사용하면 IngressController에서 HTTP 헤더 및 로그에서 로드 밸런서의 주소를 보고하는 대신 해당 소스 주소를 보고할 수 있습니다. IngressController에서 PROXY 프로토콜을 활성화하면 IngressController에 연결을 전달하는 데 PROXY 프로토콜을 사용하는 로드 밸런서를 사용하지 않는 경우 연결이 실패합니다. PROXY 프로토콜에 대한 자세한 내용은 http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt 을 참조하십시오. 다음 값은 이 필드에 유효합니다. * 빈 문자열. * "TCP". * "PROXY". 빈 문자열은 PROXY 프로토콜이 없는 TCP인 기본값을 지정합니다. 기본값은 변경될 수 있습니다.

15.1.14. .spec.endpointPublishingStrategy.private

설명
private에는 Private 엔드포인트 게시 전략에 대한 매개변수가 있습니다. type이 private인 경우에만 존재합니다.
유형
object
속성유형설명

protocol

string

protocol은 IngressController에서 들어오는 연결이 일반 TCP를 사용하도록 예상하는지 또는 IngressController에서 PROXY 프로토콜을 사용할지 여부를 지정합니다. PROXY 프로토콜은 IngressController로 해당 연결을 전달할 때 클라이언트 연결의 소스 주소를 전달하는 데 지원하는 로드 밸런서와 함께 사용할 수 있습니다. PROXY 프로토콜을 사용하면 IngressController에서 HTTP 헤더 및 로그에서 로드 밸런서의 주소를 보고하는 대신 해당 소스 주소를 보고할 수 있습니다. IngressController에서 PROXY 프로토콜을 활성화하면 IngressController에 연결을 전달하는 데 PROXY 프로토콜을 사용하는 로드 밸런서를 사용하지 않는 경우 연결이 실패합니다. PROXY 프로토콜에 대한 자세한 내용은 http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt 을 참조하십시오. 다음 값은 이 필드에 유효합니다. * 빈 문자열. * "TCP". * "PROXY". 빈 문자열은 PROXY 프로토콜이 없는 TCP인 기본값을 지정합니다. 기본값은 변경될 수 있습니다.

15.1.15. .spec.httpCompression

설명
httpCompression은 HTTP 트래픽 압축 정책을 정의합니다. 기본적으로 HTTP 압축이 없습니다.
유형
object
속성유형설명

mimeTypes

배열(문자열)

Mimetypes는 압축을 적용해야 하는 MIME 유형 목록입니다. 이 목록은 비어 있을 수 있습니다. 이 경우 Ingress 컨트롤러가 압축을 적용하지 않습니다. 참고: 모든 MIME 유형이 압축에서 이점을 얻는 것은 아니지만 HAProxy는 여전히 리소스를 사용하여 지시된 경우 압축합니다. 일반적으로 말하면, 텍스트 (html, csss, js 등) 형식은 압축의 이점이지만 이미 압축 된 형식 (이미지, 오디오, 비디오 등)은 다시 압축에 소요되는 시간과 cpu의 교환에 거의 도움이되지 않습니다. https://joehonton.medium.com/the-gzip-penalty-d31bd697f1a2에서 참조하십시오.

15.1.16. .spec.httpErrorCodePages

설명
httpErrorCodePages는 사용자 정의 오류 페이지가 포함된 configmap을 지정합니다. 관리자는 openshift-config 네임스페이스에 이 configmap을 생성해야 합니다. 이 configmap에는 "error-page-<error code>.http 형식의 키가 있어야 합니다. 여기서 <error code>는 HTTP 오류 코드입니다. 예를 들어 "error-page-503.http"는 HTTP 503 응답에 대한 오류 페이지를 정의합니다. 현재 503 및 404 응답에 대한 오류 페이지만 사용자 지정할 수 있습니다. configmap의 각 값은 HTTP 헤더를 포함하여 전체 응답이어야 합니다. eg- https://raw.githubusercontent.com/openshift/router/fadab45747a9b30cc3f0a4b41ad2871f95827a93/images/router/haproxy/conf/error-page-503.http 이 필드가 비어 있으면 Ingress 컨트롤러에서 기본 오류 페이지를 사용합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

15.1.17. .spec.httpHeaders

설명
httpHeaders는 HTTP 헤더에 대한 정책을 정의합니다. 이 필드가 비어 있으면 기본값이 사용됩니다.
유형
object
속성유형설명

forwardedHeaderPolicy

string

forwardedHeaderPolicy는 IngressController가 Forwarded, X-Forwarded-For, X-Forwarded-Host, X-Forwarded-Port, X-Forwarded-Proto, X-Forwarded-Proto-Version HTTP 헤더를 설정하는 시기와 방법을 지정합니다. 값은 IngressController에서 헤더를 추가하고 기존 헤더를 보존하도록 지정하는 * "Append" 중 하나일 수 있습니다. * IngressController가 헤더를 설정하고 기존 Forwarded 또는 X-Forwarded-* 헤더를 교체하도록 지정하는 "replace". * "IfNone"은 IngressController가 아직 설정되지 않은 경우 헤더를 설정하도록 지정합니다. * "never"는 IngressController가 헤더를 설정하지 않고 기존 헤더를 보존하도록 지정하는 "never"입니다. 기본적으로 정책은 "Append"입니다.

headerNameCaseAdjustments

``

headerNameCaseAdjustments는 HTTP 헤더 이름에 적용할 수 있는 대소문자 조정을 지정합니다. 각 조정은 원하는 대문자를 사용하여 HTTP 헤더 이름으로 지정됩니다. 예를 들어 "X-Forwarded-For"를 지정하면 지정된 대문자를 갖도록 "x-forwarded-for" HTTP 헤더를 조정해야 합니다. 이러한 조정은 HTTP/1을 사용하는 경우에만 일반 텍스트, 에지 종료 및 재암호화 경로에 적용됩니다. 요청 헤더의 경우 이러한 조정은 haproxy.router.openshift.io/h1-adjust-case=true 주석이 있는 경로에만 적용됩니다. 응답 헤더의 경우 이러한 조정이 모든 HTTP 응답에 적용됩니다. 이 필드가 비어 있으면 요청 헤더가 조정되지 않습니다.

uniqueId

object

uniqueid는 수신 컨트롤러가 들어오는 HTTP 요청에 삽입해야 하는 사용자 정의 HTTP 헤더의 구성을 설명합니다. 일반적으로 이 헤더는 HTTP 요청에 고유한 값을 갖도록 구성됩니다. 헤더는 애플리케이션에서 사용하거나 액세스 로그에 포함되어 개별 HTTP 요청을 쉽게 추적할 수 있습니다. 이 필드가 비어 있으면 이러한 헤더가 요청에 삽입되지 않습니다.

15.1.18. .spec.httpHeaders.uniqueId

설명
uniqueid는 수신 컨트롤러가 들어오는 HTTP 요청에 삽입해야 하는 사용자 정의 HTTP 헤더의 구성을 설명합니다. 일반적으로 이 헤더는 HTTP 요청에 고유한 값을 갖도록 구성됩니다. 헤더는 애플리케이션에서 사용하거나 액세스 로그에 포함되어 개별 HTTP 요청을 쉽게 추적할 수 있습니다. 이 필드가 비어 있으면 이러한 헤더가 요청에 삽입되지 않습니다.
유형
object
속성유형설명

형식

string

format은 삽입된 HTTP 헤더의 값을 지정합니다. 이 필드는 이름을 지정하지 않는 한 적용되지 않습니다. HAProxy 기반 수신 컨트롤러 구현의 경우 이 형식은 HTTP 로그 형식과 동일한 구문을 사용합니다. 필드가 비어 있는 경우 기본값은 "%{+X}o\\ %ci:%cp_%fi:%fp_%rt:%rt:%pid"; 해당 HAProxy 설명서를 참조하십시오. http://cbonte.github.io/haproxy-dconv/2.0/configuration.html#8.2.3

name

string

name은 Ingress 컨트롤러가 HTTP 요청에 삽입해야 하는 HTTP 헤더의 이름(예: "unique-id")을 지정합니다. 필드의 값은 RFC 2616 섹션 4.2에 정의된 대로 유효한 HTTP 헤더 이름이어야 합니다. 필드가 비어 있으면 헤더가 삽입되지 않습니다.

15.1.19. .spec.logging

설명
logging은 어디에서 기록해야 하는지에 대한 매개변수를 정의합니다. 이 필드가 비어 있으면 작동 로그는 활성화되지만 액세스 로그는 비활성화됩니다.
유형
object
속성유형설명

액세스

object

access는 클라이언트 요청을 로깅하는 방법을 설명합니다. 이 필드가 비어 있으면 액세스 로깅이 비활성화됩니다.

15.1.20. .spec.logging.access

설명
access는 클라이언트 요청을 로깅하는 방법을 설명합니다. 이 필드가 비어 있으면 액세스 로깅이 비활성화됩니다.
유형
object
필수 항목
  • 대상
속성유형설명

대상

object

destination은 액세스 로그가 이동하는 위치입니다.

httpCaptureCookies

``

httpCaptureCookies는 액세스 로그에 캡처해야 하는 HTTP 쿠키를 지정합니다. 이 필드가 비어 있으면 쿠키가 캡처되지 않습니다.

httpCaptureHeaders

object

httpCaptureHeaders는 액세스 로그에 캡처해야 하는 HTTP 헤더를 정의합니다. 이 필드가 비어 있으면 헤더가 캡처되지 않습니다. 이 옵션은 일반 텍스트 HTTP 연결에만 적용되고 Ingress 컨트롤러가 암호화를 종료하는 보안 HTTP 연결(즉, 에지 종료 또는 재암호화 연결)에만 적용됩니다. TLS 패스스루 연결에 대해 헤더를 캡처할 수 없습니다.

httpLogFormat

string

httpLogFormat은 HTTP 요청에 대한 로그 메시지의 형식을 지정합니다. 이 필드가 비어 있으면 로그 메시지는 구현의 기본 HTTP 로그 형식을 사용합니다. HAProxy의 기본 HTTP 로그 형식의 경우 HAProxy 문서를 참조하십시오. http://cbonte.github.io/haproxy-dconv/2.0/configuration.html#8.2.3 이 형식은 일반 텍스트 HTTP 연결에만 적용되고 수신 컨트롤러가 암호화를 종료하는 HTTP 연결(즉, 에지 종료 또는 재암호화 연결)에만 적용됩니다. TLS 패스스루 연결의 로그 형식에는 영향을 미치지 않습니다.

logEmptyRequests

string

logEmptyRequests는 요청이 수신되지 않은 연결을 로깅하는 방법을 지정합니다. 일반적으로 이러한 빈 요청은 로드 밸런서의 상태 프로브 또는 웹 브라우저의 추측 연결("사전 연결")에서 제공되며, 이 경우 이러한 요청을 기록하는 것은 바람직하지 않을 수 있습니다. 그러나 이러한 요청은 네트워크 오류로 인해 발생할 수 있으며 이 경우 빈 요청을 로깅하는 것이 오류를 진단하는 데 유용할 수 있습니다. 또한 이러한 요청은 포트 검사로 인해 발생할 수 있으며, 이 경우 빈 요청을 로깅하면 침입 시도를 탐지하는 데 도움이 될 수 있습니다. 이 필드에 허용되는 값은 "Log" 및 "Ignore"입니다. 기본값은 "Log"입니다.

15.1.21. .spec.logging.access.destination

설명
destination은 액세스 로그가 이동하는 위치입니다.
유형
object
필수 항목
  • type
속성유형설명

container

object

컨테이너에는 컨테이너 로깅 대상에 대한 매개변수가 있습니다. type이 Container인 경우에만 존재합니다.

syslog

object

syslog에는 syslog 끝점의 매개변수가 포함되어 있습니다. type이 Syslog인 경우에만 표시됩니다.

type

string

type은 로그의 대상 유형입니다. * Container Ingress Operator는 수신 컨트롤러 Pod에서 "logs"라는 사이드카 컨테이너를 구성하고 사이드카에 로그를 작성하도록 수신 컨트롤러를 구성합니다. 그런 다음 로그를 컨테이너 로그로 사용할 수 있습니다. 관리자는 이 사이드카에서 로그를 읽는 사용자 정의 로깅 솔루션을 구성해야 합니다. 컨테이너 로그를 사용하면 로그 비율이 컨테이너 런타임 또는 사용자 정의 로깅 솔루션의 용량을 초과하면 로그가 삭제될 수 있습니다. * syslog 로그는 syslog 끝점으로 전송됩니다. 관리자는 syslog 메시지를 수신할 수 있는 끝점을 지정해야 합니다. 관리자가 사용자 정의 syslog 인스턴스를 구성해야 합니다.

15.1.22. .spec.logging.access.destination.container

설명
컨테이너에는 컨테이너 로깅 대상에 대한 매개변수가 있습니다. type이 Container인 경우에만 존재합니다.
유형
object

15.1.23. .spec.logging.access.destination.syslog

설명
syslog에는 syslog 끝점의 매개변수가 포함되어 있습니다. type이 Syslog인 경우에만 표시됩니다.
유형
object
필수 항목
  • address
  • port
속성유형설명

address

string

address는 로그 메시지를 수신하는 syslog 끝점의 IP 주소입니다.

facility

string

facility는 로그 메시지의 syslog 기능을 지정합니다. 이 필드가 비어 있으면 기능은 "local1"입니다.

maxLength

integer

MaxLength는 syslog 메시지의 최대 길이입니다. 이 필드가 비어 있으면 maxLength가 "1024"로 설정됩니다.

port

integer

port는 로그 메시지를 수신하는 syslog 끝점의 UDP 포트 번호입니다.

15.1.24. .spec.logging.access.httpCaptureHeaders

설명
httpCaptureHeaders는 액세스 로그에 캡처해야 하는 HTTP 헤더를 정의합니다. 이 필드가 비어 있으면 헤더가 캡처되지 않습니다. 이 옵션은 일반 텍스트 HTTP 연결에만 적용되고 Ingress 컨트롤러가 암호화를 종료하는 보안 HTTP 연결(즉, 에지 종료 또는 재암호화 연결)에만 적용됩니다. TLS 패스스루 연결에 대해 헤더를 캡처할 수 없습니다.
유형
object
속성유형설명

요청

``

request는 캡처할 HTTP 요청 헤더를 지정합니다. 이 필드가 비어 있으면 요청 헤더가 캡처되지 않습니다.

응답

``

response는 캡처할 HTTP 응답 헤더를 지정합니다. 이 필드가 비어 있으면 응답 헤더가 캡처되지 않습니다.

15.1.25. .spec.namespaceSelector

설명
namespaceSelector는 Ingress 컨트롤러에서 서비스를 제공하는 네임스페이스 집합을 필터링하는 데 사용됩니다. 이는 분할을 구현하는 데 유용합니다. 설정되지 않은 경우 기본값은 필터링이 아닙니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

15.1.26. .spec.namespaceSelector.matchExpressions

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

15.1.27. .spec.namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

15.1.28. .spec.nodePlacement

설명
nodePlacement를 사용하면 Ingress 컨트롤러의 스케줄링을 명시적으로 제어할 수 있습니다. 설정되지 않은 경우 기본값이 사용됩니다. 자세한 내용은 NodePlacement를 참조하십시오.
유형
object
속성유형설명

nodeSelector

object

nodeSelector는 수신 컨트롤러 배포에 적용되는 노드 선택기입니다. 설정된 경우 지정된 선택기가 사용되고 기본값을 대체합니다. 설정되지 않은 경우 기본값은 클러스터 config.openshift.io/v1/ingresses 상태의 defaultPlacement 필드 값에 따라 다릅니다. defaultPlacement가 Workers인 경우 기본값은 kubernetes.io/os: linux node-role.kubernetes.io/worker: '' defaultPlacement가 ControlPlane인 경우 기본값은 kubernetes.io/os: linux node-role.kubernetes.io/master: '' 이 기본값은 변경될 수 있습니다.

허용 오차

array

허용 오차는 수신 컨트롤러 배포에 적용되는 허용 오차 목록입니다. 기본값은 빈 목록입니다. https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/에서 참조하십시오.

tolerations[]

object

이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.

15.1.29. .spec.nodePlacement.nodeSelector

설명
nodeSelector는 수신 컨트롤러 배포에 적용되는 노드 선택기입니다. 설정된 경우 지정된 선택기가 사용되고 기본값을 대체합니다. 설정되지 않은 경우 기본값은 클러스터 config.openshift.io/v1/ingresses 상태의 defaultPlacement 필드 값에 따라 다릅니다. defaultPlacement가 Workers인 경우 기본값은 kubernetes.io/os: linux node-role.kubernetes.io/worker: '' defaultPlacement가 ControlPlane인 경우 기본값은 kubernetes.io/os: linux node-role.kubernetes.io/master: '' 이 기본값은 변경될 수 있습니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

15.1.30. .spec.nodePlacement.nodeSelector.matchExpressions

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

15.1.31. .spec.nodePlacement.nodeSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

15.1.32. .spec.nodePlacement.tolerations

설명
허용 오차는 수신 컨트롤러 배포에 적용되는 허용 오차 목록입니다. 기본값은 빈 목록입니다. https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/에서 참조하십시오.
유형
array

15.1.33. .spec.nodePlacement.tolerations[]

설명
이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.
유형
object
속성유형설명

effect

string

effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

key

string

키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다.

operator

string

Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다.

tolerationSeconds

integer

tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다.

value

string

값은 허용 오차와 일치하는 taint 값입니다. 연산자가 Exists인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다.

15.1.34. .spec.routeAdmission

설명
routeAdmission은 새 경로 클레임을 처리하기 위한 정책(예: 네임스페이스 간 클레임을 허용 또는 거부)을 정의합니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 routeAdmission 필드를 참조하십시오.
유형
object
속성유형설명

namespaceOwnership

string

namespaceOwnership은 네임스페이스에서 호스트 이름 클레임을 처리하는 방법을 설명합니다. value must be one of: - Strict: 다른 네임스페이스의 경로가 동일한 호스트를 요청하는 것을 허용하지 마십시오. - InterNamespaceAllowed: 경로가 네임스페이스에서 동일한 호스트 이름의 다른 경로를 클레임할 수 있습니다. 비어 있는 경우 기본값은 Strict입니다.

wildcardPolicy

string

wildcardPolicy는 와일드카드 정책이 있는 경로를 Ingress 컨트롤러에 대해 처리하는 방법을 설명합니다. wildcardPolicy는 경로의 와일드카드 정책을 기반으로 Ingress 컨트롤러에서 공개한 경로 [1] 사용을 제어합니다. [1][1]: WildcardsAllowed에서 WildcardsAllowed로 WildcardPolicy를 업데이트하면 하위 도메인의 와일드카드 정책이 있는 허용된 경로가 하위 도메인의 작동을 중지합니다. https://github.com/openshift/api/blob/master/route/v1/types.go Ingress 컨트롤러에서 이러한 경로를 읽을 수 있도록 None의 와일드카드 정책으로 업데이트해야 합니다. wildcardPolicy는 WildcardsAllowed 및 WildcardsDisallowed 값을 지원합니다. 비어 있는 경우 기본값은 "wildcardsDisallowed"입니다.

15.1.35. .spec.routeSelector

설명
routeSelector는 Ingress 컨트롤러에서 서비스를 제공하는 경로 집합을 필터링하는 데 사용됩니다. 이는 분할을 구현하는 데 유용합니다. 설정되지 않은 경우 기본값은 필터링이 아닙니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

15.1.36. .spec.routeSelector.matchExpressions

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

15.1.37. .spec.routeSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

15.1.38. .spec.tlsSecurityProfile

설명
tlsSecurityProfile은 ingresscontrollers의 TLS 연결 설정을 지정합니다. 설정되지 않은 경우 기본값은 apiservers.config.openshift.io/cluster 리소스를 기반으로 합니다. Old, Intermediate 및 Modern 프로파일 유형을 사용하는 경우 유효한 프로파일 구성은 릴리스마다 변경될 수 있습니다. 예를 들어 릴리스 X.Y.Z에 배포된 Intermediate 프로파일을 사용하기 위한 사양이 있는 경우 릴리스 X.Y.Z+1로 업그레이드하면 새 프로필 구성이 Ingress 컨트롤러에 적용되어 롤아웃이 발생할 수 있습니다.
유형
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 (yaml): 암호화: - TLS_AES_128_GCM_SHA256 - TLS_AES_256_GCM_SHA384 - TLS_CHACHA20_GCM_SHA384 - TLS_CHACHA20_POLY1305_SHA256 - ECDHE-ECDSA-AES128-GCM-SHA256 - ECDHE-RSA-AES128-GCM-SHA256 - ECDHE-RSA-AES256-GCM-SHA384 - ECDHE-RSA-AES256-GCM-SHA384 - ECDHE-ECDSA-CHACHA20-POLY1305 - ECDHE-RSA-CHACHA20-POLY1305 - DHE-RSA-AES128-GCM-SHA256 - DHE-RSA-AES256-GCM-SHA384 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 (yaml): 암호화: - TLS_AES_128_GCM_SHA256 - TLS_AES_256_GCM_SHA384 - TLS_CHACHA20_GCM_SHA384 - TLS_CHACHA20_POLY1305_SHA256 - ECDHE-ECDSA-AES128-GCM-SHA256 - ECDHE-RSA-AES128-GCM-SHA256 - ECDHE-RSA-AES256-GCM-SHA384 - ECDHE-RSA-aes256-GCM-sha384 - ECDHE-ECDSA-chaCHA20-POLY1305 - ECDHE-RSA-chaCHA20-POLY1305 - DHE-RSA-aes128-GCM-sha256 - DHE-RSA-aes256-GCM-sha384 - DHE-RSA-chaCHA20-POLY1305 - ECDHE-ECDSA-aes128-sha256 - ECDHE-RSA-aes128-sha256 - ECDHE-ECDSA-SHA - ECDHE-RSA-aes128-aes128-aes128-aes256-sha384 - ECDHE-RSA-aes256-sha384 - ECDHE-ECDSA-aes256-ECDSA-aes256-RSA-aes-SHA-SHA - DHE-RSA-AES128-SHA256 - DHE-RSA-AES256-SHA256 - AES256-GCM-SHA256 - AES256-GCM-SHA384 - AES128-SHA256 - AES128-SHA - AES128-SHA - AES256-SHA - DES-CBC3-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 프로파일은 아직 공통 소프트웨어 라이브러리에서 잘 채택되지 않았기 때문에 현재 지원되지 않습니다.

15.1.39. .spec.tuningOptions

설명
tuningOptions는 수신 컨트롤러 Pod의 성능을 조정하기 위한 매개변수를 정의합니다. 모든 필드는 선택 사항이며 설정되지 않은 경우 해당 기본값을 사용합니다. 자세한 내용은 특정 tuningOptions 필드를 참조하십시오. 일반적으로 tuningOptions 내에서 필드를 설정하는 것은 권장되지 않습니다. 기본값은 대부분의 구성에 적합합니다.
유형
object
속성유형설명

clientFinTimeout

string

clientFinTimeout은 서버/backend 연결에 대한 클라이언트 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 설정되지 않은 경우 기본 제한 시간은 1s입니다.

clientTimeout

string

clientTimeout은 클라이언트 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 설정되지 않은 경우 기본 제한 시간은 30s입니다.

headerBufferBytes

integer

headerBufferBytes는 IngressController 연결 세션에 대해 예약해야 하는 메모리(바이트 단위)를 설명합니다. IngressController(https://tools.ietf.org/html/rfc7540)에 HTTP/2가 활성화된 경우 이 값은 16384 이상이어야 합니다. 이 필드가 비어 있으면 IngressController는 기본값 32768바이트를 사용합니다. 이 필드를 설정하는 것은 일반적으로 headerBufferBytes 값이 너무 작으면 IngressController 및 headerBufferBytes 값이 너무 크면 IngressController가 필요 이상으로 많은 메모리를 사용할 수 있으므로 권장되지 않습니다.

headerBufferMaxRewriteBytes

integer

headerBufferMaxRewriteBytes는 HTTP 헤더 재작성 및 IngressController 연결 세션에 대한 headerBufferBytes의 (바이트 단위)를 예약해야 하는 메모리 양을 설명합니다. 들어오는 HTTP 요청은 (headerBufferBytes - headerBufferMaxRewriteBytes) 바이트로 제한되므로 headerBufferBytes는 headerBufferMaxRewriteBytes보다 커야 합니다. 이 필드가 비어 있으면 IngressController는 기본값인 8192바이트를 사용합니다. 헤더BufferMaxRewriteBytes 값이 너무 작으면 IngressController 및 headerBufferMaxRewriteBytes 값이 너무 크면 IngressController가 필요한 것보다 더 많은 메모리를 사용할 수 있으므로 일반적으로 이 필드를 설정하지 않는 것이 좋습니다.

healthCheckInterval

string

healthCheckInterval은 구성된 백엔드의 두 연속 상태 점검 간에 라우터가 대기하는 시간을 정의합니다. 이 값은 모든 경로에 대해 전역적으로 적용되지만 경로 주석 "router.openshift.io/haproxy.health.check.interval"로 덮어쓸 수 있습니다. 10진수의 부호 없는 기간 문자열은 각각 선택적 분수와 단위 접미사인 "300ms", "1.5h" 또는 "2h45m"이 필요합니다. 유효한 시간 단위는 "ns", "us"(또는 " Cryostats" U+00B5 또는 ">&#s" U+03BC), "ms", "s", "h"입니다. 이 값을 5s 미만으로 설정하면 TCP 상태 점검이 너무 자주 발생하고 SYN 패킷 이림으로 인해 과도한 트래픽이 발생할 수 있습니다. 또는 이 값을 너무 높게 설정하면 더 이상 사용할 수 없지만 아직 탐지되지 않은 백엔드 서버로 인해 대기 시간이 증가할 수 있습니다. 빈 또는 제로 상태CheckInterval은 의견이 없으며 IngressController는 시간이 지남에 따라 변경될 수 있는 기본값을 선택합니다. 현재 기본 healthCheckInterval 값은 5s입니다. 현재 허용되는 최소 값은 1s이고 허용되는 최대 값은 2147483647ms(24.85일)입니다. 둘 다 시간에 따라 변경될 수 있습니다.

maxConnections

integer

maxConnections는 HAProxy 프로세스별로 설정할 수 있는 최대 동시 연결 수를 정의합니다. 이 값을 늘리면 각 Ingress 컨트롤러 Pod에서 더 많은 연결을 처리하지만 추가 시스템 리소스가 소비됩니다. 허용되는 값은 empty, 0, -1 및 범위 2000-2000000입니다. 이 필드가 비어 있거나 0인 경우 IngressController는 기본값인 50000을 사용하지만 기본값은 향후 릴리스에서 변경될 수 있습니다. 값이 -1이면 HAProxy는 실행 중인 컨테이너에서 사용 가능한 ulimits를 기반으로 값을 동적으로 계산합니다. -1(예: auto)을 선택하면 큰 값이 계산됩니다(OpenShift >=4.10 클러스터에서 ~520000). 따라서 각 HAProxy 프로세스는 현재 기본값 50000에 비해 상당한 메모리 사용량이 발생합니다. 현재 운영 체제 제한보다 큰 값을 설정하면 HAProxy 프로세스가 시작되지 않습니다. 개별 값(예: 750000)을 선택하고 라우터 포드가 새 노드로 마이그레이션되면 새 노드가 동일한 ulimits가 구성되어 있다는 보장은 없습니다. 이러한 시나리오에서는 pod가 시작되지 않습니다. 서로 다른 ulimits가 구성된 노드(예: 다른 tuned 프로필)가 있고 불연속 값을 선택하면 지침은 -1을 사용하고 런타임 시 값을 동적으로 계산하도록 하는 것입니다. 'container_memory_working_set_bytes{container="router",namespace="openshift-ingress"}' 메트릭을 사용하여 라우터 컨테이너의 메모리 사용량을 모니터링할 수 있습니다. 'container_memory_working_set_bytes{container="router",namespace="openshift-ingress"}/container_processes{container="router"}'를 사용하여 라우터 컨테이너에서 개별 HAProxy 프로세스의 메모리 사용량을 모니터링할 수 있습니다.

reloadInterval

string

reloadInterval은 라우터가 새 변경 사항을 수락하도록 다시 로드할 수 있는 최소 간격을 정의합니다. 이 값을 늘리면 시나리오에 따라 HAProxy 프로세스가 누적되지 않을 수 있습니다. 이 간격을 늘리면 roundrobin balancing 알고리즘을 사용할 때 백엔드 서버에서 부하 분산을 줄일 수 있습니다. 또는 HAProxy 구성에 대한 업데이트가 더 빨리 적용될 수 있으므로 이 값을 줄이면 대기 시간이 줄어들 수 있습니다. 값은 기간 값이어야 합니다. https://pkg.go.dev/time#ParseDuration 을 참조하십시오. 현재 허용되는 최소 값은 1s이고 허용되는 최대 값은 120입니다. 향후 OpenShift 버전에서 허용되는 최소 및 최대 값이 변경될 수 있습니다. 이러한 범위를 벗어나는 기간이 제공되면 reloadInterval 값이 제한되고 거부되지 않습니다(예: 120개 이상의 기간이 120으로 제한됨) IngressController는 이를 거부하고 이 허용하지 않은 값을 기본값으로 대체하지 않습니다. reloadInterval의 제로 값은 IngressController에서 기본값을 선택하도록 지시합니다. 현재 5s는 사전 통지 없이 변경될 수 있습니다. 이 필드에는 10진수의 부호 없는 기간 문자열, 각각 선택적 분수와 단위 접미사가 필요합니다. 예를 들면 다음과 같습니다. "300MS", "1.5h" 또는 "2h45m". 유효한 시간 단위는 "ns", "us"(또는 " Cryostats" U+00B5 또는 ">&#s" U+03BC), "ms", "s", "h"입니다. 참고: 기본값 5보다 큰 값을 설정하면 경로 및 엔드포인트에 대한 업데이트를 관찰하는 대기 시간이 발생할 수 있습니다. HAProxy의 구성은 덜 자주 다시 로드되고 새로 생성된 경로가 후속 다시 로드될 때까지 제공되지 않습니다.

serverFinTimeout

string

serverFinTimeout은 연결을 닫는 클라이언트에 대한 서버/backend 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 설정되지 않은 경우 기본 제한 시간은 1s입니다.

serverTimeout

string

serverTimeout은 서버/backend 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 설정되지 않은 경우 기본 제한 시간은 30s입니다.

threadCount

integer

threadCount는 HAProxy 프로세스별로 생성된 스레드 수를 정의합니다. 더 많은 스레드를 생성하면 각 Ingress 컨트롤러 Pod가 더 많은 시스템 리소스 비용으로 더 많은 연결을 처리할 수 있습니다. HAProxy는 현재 최대 64개의 스레드를 지원합니다. 이 필드가 비어 있으면 IngressController는 기본값을 사용합니다. 현재 기본값은 4개의 스레드이지만 향후 릴리스에서 변경될 수 있습니다. 이 필드를 설정하는 것은 일반적으로 권장되지 않습니다. HAProxy 스레드 수를 늘리면 Ingress 컨트롤러 Pod가 부하에서 더 많은 CPU 시간을 활용할 수 있으므로 너무 높은 경우 다른 Pod가 중단될 수 있습니다. 스레드 수를 줄이면 Ingress 컨트롤러가 제대로 작동하지 않을 수 있습니다.

tlsInspectDelay

string

tlsInspectDelay는 라우터에서 일치하는 경로를 찾기 위해 데이터를 보유할 수 있는 기간을 정의합니다. 이 값을 너무 짧게 설정하면 일치하는 인증서를 더 잘 사용할 수 있는 경우에도 라우터가 에지 종료 또는 재암호화 경로의 기본 인증서로 대체될 수 있습니다. 설정되지 않은 경우 기본 검사 지연은 5s입니다.

tunnelTimeout

string

tunnelTimeout은 터널이 유휴 상태인 동안 터널 연결이 열린 상태로 유지되는 시간을 정의합니다. 설정되지 않은 경우 기본 제한 시간은 1h입니다.

15.1.40. .status

설명
상태는 IngressController의 가장 최근에 관찰된 상태입니다.
유형
object
속성유형설명

availableReplicas

integer

availableReplicas는 Ingress 컨트롤러 배포에 따라 모니터링되는 사용 가능한 복제본 수입니다.

conditions

array

conditions는 조건 및 상태 목록입니다. 사용 가능한 경우 수신 컨트롤러 배포를 사용할 수 있고 서비스 경로 및 수신 리소스(예: .status.availableReplicas 등) 다른 Ingress 컨트롤러 기능 및 기능의 상태를 나타내는 추가 조건이 있습니다. * LoadBalancerManaged - 다음 조건이 충족되면 True: * 끝점 게시 전략에 서비스 로드 밸런서가 필요합니다. - 해당 조건 중 하나라도 만족스럽지 않은 경우 - False입니다. * LoadBalancerReady - 다음 조건이 충족되면 True: * 로드 밸런서가 관리됩니다. * 로드 밸런서가 준비되었습니다. - 해당 조건 중 하나라도 만족스럽지 않은 경우 False입니다. * DNSManaged - 다음 조건이 충족되면 True: * 끝점 게시 전략 및 플랫폼이 DNS를 지원합니다. * Ingress 컨트롤러 도메인이 설정됩니다. * DNS.config.openshift.io/cluster는 DNS 영역을 구성합니다. - 해당 조건 중 하나라도 만족스럽지 않은 경우 False입니다. * DNSReady - 다음 조건이 충족되면 True: * DNS가 관리됩니다. * DNS 레코드가 성공적으로 생성되었습니다. - 해당 조건 중 하나라도 만족스럽지 않으면 False입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

domain

string

domain은 사용 중인 실제 도메인입니다.

endpointPublishingStrategy

object

endpointPublishingStrategy는 사용 중인 실제 전략입니다.

namespaceSelector

object

namespaceSelector는 사용 중인 실제 namespaceSelector입니다.

observedGeneration

integer

observedGeneration은 가장 최근 관찰된 세대입니다.

routeSelector

object

routeSelector는 사용 중인 실제 routeSelector입니다.

선택기

string

selector는 IngressController에 해당하는 수신 컨트롤러 Pod의 경우 문자열 형식의 라벨 선택기입니다. 일치하는 Pod 수는 availableReplicas 값과 같아야 합니다.

tlsProfile

object

TLSProfile은 적용되는 TLS 연결 구성입니다.

15.1.41. .status.conditions

설명
conditions는 조건 및 상태 목록입니다. 사용 가능한 경우 수신 컨트롤러 배포를 사용할 수 있고 서비스 경로 및 수신 리소스(예: .status.availableReplicas 등) 다른 Ingress 컨트롤러 기능 및 기능의 상태를 나타내는 추가 조건이 있습니다. * LoadBalancerManaged - 다음 조건이 충족되면 True: * 끝점 게시 전략에 서비스 로드 밸런서가 필요합니다. - 해당 조건 중 하나라도 만족스럽지 않은 경우 - False입니다. * LoadBalancerReady - 다음 조건이 충족되면 True: * 로드 밸런서가 관리됩니다. * 로드 밸런서가 준비되었습니다. - 해당 조건 중 하나라도 만족스럽지 않은 경우 False입니다. * DNSManaged - 다음 조건이 충족되면 True: * 끝점 게시 전략 및 플랫폼이 DNS를 지원합니다. * Ingress 컨트롤러 도메인이 설정됩니다. * DNS.config.openshift.io/cluster는 DNS 영역을 구성합니다. - 해당 조건 중 하나라도 만족스럽지 않은 경우 False입니다. * DNSReady - 다음 조건이 충족되면 True: * DNS가 관리됩니다. * DNS 레코드가 성공적으로 생성되었습니다. - 해당 조건 중 하나라도 만족스럽지 않으면 False입니다.
유형
array

15.1.42. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

15.1.43. .status.endpointPublishingStrategy

설명
endpointPublishingStrategy는 사용 중인 실제 전략입니다.
유형
object
필수 항목
  • type
속성유형설명

hostNetwork

object

HostNetwork에는 HostNetwork 끝점 게시 전략에 대한 매개 변수가 있습니다. type은 HostNetwork인 경우에만 존재합니다.

loadBalancer

object

LoadBalancer에는 로드 밸런서에 대한 매개변수가 있습니다. type이 LoadBalancerService인 경우에만 표시됩니다.

nodePort

object

NodePort에는 NodePortService 끝점 게시 전략에 대한 매개변수가 있습니다. type이 NodePortService인 경우에만 표시됩니다.

비공개

object

private에는 Private 엔드포인트 게시 전략에 대한 매개변수가 있습니다. type이 private인 경우에만 존재합니다.

type

string

type은 사용할 게시 전략입니다. 유효한 값은 다음과 같습니다. * LoadBalancerService는 Kubernetes LoadBalancer 서비스를 사용하여 수신 컨트롤러를 게시합니다. 이 구성에서 Ingress 컨트롤러 배포는 컨테이너 네트워킹을 사용합니다. 배포를 게시하기 위해 LoadBalancer 서비스가 생성됩니다. https://kubernetes.io/docs/concepts/services-networking/service/#loadbalancer domain이 설정된 경우 LoadBalancer 서비스의 외부 이름을 가리키도록 와일드카드 DNS 레코드가 관리됩니다. DNS 레코드는 dns.config.openshift.io/cluster .spec.publicZone 및 .spec.privateZone에서 정의한 DNS 영역에서만 관리됩니다. 와일드카드 DNS 관리는 현재 AWS, Azure 및 GCP 플랫폼에서만 지원됩니다. * HostNetwork는 Ingress 컨트롤러가 배포된 노드 포트에 Ingress 컨트롤러를 게시합니다. 이 구성에서 Ingress 컨트롤러 배포는 노드 포트 80 및 443에 바인딩된 호스트 네트워킹을 사용합니다. 사용자는 노드 포트를 통해 Ingress 컨트롤러를 게시하도록 외부 로드 밸런서를 구성해야 합니다. * private은 Ingress 컨트롤러를 게시하지 않습니다. 이 구성에서 Ingress 컨트롤러 배포는 컨테이너 네트워킹을 사용하며 명시적으로 게시되지 않습니다. 사용자가 Ingress 컨트롤러를 수동으로 게시해야 합니다. * NodePortService는 Kubernetes NodePort 서비스를 사용하여 수신 컨트롤러를 게시합니다. 이 구성에서 Ingress 컨트롤러 배포는 컨테이너 네트워킹을 사용합니다. 배포를 게시하기 위해 NodePort 서비스가 생성됩니다. 특정 노드 포트는 OpenShift에서 동적으로 할당하지만 정적 포트 할당을 지원하려면 관리형 NodePort 서비스의 노드 포트 필드에 대한 사용자 변경 사항이 유지됩니다.

15.1.44. .status.endpointPublishingStrategy.hostNetwork

설명
HostNetwork에는 HostNetwork 끝점 게시 전략에 대한 매개 변수가 있습니다. type은 HostNetwork인 경우에만 존재합니다.
유형
object
속성유형설명

httpPort

integer

httpPort는 HTTP 요청을 수신 대기하는 데 사용해야 하는 호스트의 포트입니다. 포트 80을 이미 사용 중인 경우 이 필드를 설정해야 합니다. 이 값은 클러스터의 NodePort 범위와 일치해서는 안 됩니다. 값이 0이거나 지정하지 않으면 기본값은 80입니다.

httpsPort

integer

httpsPort는 HTTPS 요청을 수신 대기하는 데 사용해야 하는 호스트의 포트입니다. 443 포트를 이미 사용 중인 경우 이 필드를 설정해야 합니다. 이 값은 클러스터의 NodePort 범위와 일치해서는 안 됩니다. 값이 0이거나 지정하지 않으면 기본값은 443입니다.

프로토콜

string

protocol은 IngressController에서 들어오는 연결이 일반 TCP를 사용하도록 예상하는지 또는 IngressController에서 PROXY 프로토콜을 사용할지 여부를 지정합니다. PROXY 프로토콜은 IngressController로 해당 연결을 전달할 때 클라이언트 연결의 소스 주소를 전달하는 데 지원하는 로드 밸런서와 함께 사용할 수 있습니다. PROXY 프로토콜을 사용하면 IngressController에서 HTTP 헤더 및 로그에서 로드 밸런서의 주소를 보고하는 대신 해당 소스 주소를 보고할 수 있습니다. IngressController에서 PROXY 프로토콜을 활성화하면 IngressController에 연결을 전달하는 데 PROXY 프로토콜을 사용하는 로드 밸런서를 사용하지 않는 경우 연결이 실패합니다. PROXY 프로토콜에 대한 자세한 내용은 http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt 을 참조하십시오. 다음 값은 이 필드에 유효합니다. * 빈 문자열. * "TCP". * "PROXY". 빈 문자열은 PROXY 프로토콜이 없는 TCP인 기본값을 지정합니다. 기본값은 변경될 수 있습니다.

statsPort

integer

statsPort는 라우터의 통계가 게시되는 호스트의 포트입니다. 이 값은 클러스터의 NodePort 범위와 일치해서는 안 됩니다. 외부 로드 밸런서가 이 IngressController에 대한 연결을 전달하도록 구성된 경우 로드 밸런서에서 상태 점검에 이 포트를 사용해야 합니다. 로드 밸런서는 지정된 노드의 이 포트에 HTTP 프로브를 보낼 수 있으며 경로 /healthz/ready로 Ingress 컨트롤러가 노드에서 트래픽을 수신할 준비가 되었는지 확인할 수 있습니다. 적절한 작동의 경우 상태 점검이 준비되었다고 보고할 때까지 로드 밸런서에서 노드로 트래픽을 전달하지 않아야 합니다. 또한 로드 밸런서는 /healthz/ready 보고가 준비되지 않음을 시작한 후 최대 45초 이내에 요청 전달을 중지해야 합니다. 5초의 시간 초과로 5초에서 10초마다 프로빙하는 것은 각각 정상 또는 비정상 상태가 되는 두 개의 성공 또는 실패한 요청의 임계값을 각각 테스트한 값입니다. 값이 0이거나 지정하지 않으면 기본값은 1936입니다.

15.1.45. .status.endpointPublishingStrategy.loadBalancer

설명
LoadBalancer에는 로드 밸런서에 대한 매개변수가 있습니다. type이 LoadBalancerService인 경우에만 표시됩니다.
유형
object
필수 항목
  • dnsManagementPolicy
  • scope
속성유형설명

allowedSourceRanges

``

allowedSourceRanges는 로드 밸런서에 대한 액세스를 제한해야 하는 IP 주소 범위의 허용 목록을 지정합니다. 각 범위는 CIDR 표기법을 사용하여 지정해야 합니다(예:). "10.0.0.0/8" or "fd00::/8"). 범위가 지정되지 않은 경우 IPv4의 경우 "0.0.0.0/0" 및 IPv6의 경우 "::/0"이 기본적으로 사용되어 모든 소스 주소를 허용합니다. allowedSourceRanges 필드가 없는 이전 버전의 OpenShift에서 원활하게 마이그레이션하기 위해 "openshift-ingress" 네임스페이스에서 "router-<ingresscontroller name>" 서비스에 service.beta.kubernetes.io/load-balancer-source-ranges 주석을 설정할 수 있으며, allowedSourceRanges가 OpenShift 4.12에 비어 있는 경우 이 주석이 적용됩니다.

dnsManagementPolicy

string

dnsManagementPolicy는 로드 밸런서 서비스와 연결된 와일드카드 DNS 레코드의 라이프사이클이 Ingress Operator에 의해 관리되는지를 나타냅니다. 기본값은 Managed입니다. 유효한 값은 Managed 및 Unmanaged입니다.

providerParameters

object

providerParameters에는 기본 인프라 공급자와 관련된 원하는 로드 밸런서 정보가 있습니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 providerParameters 필드를 참조하십시오.

scope

string

scope는 로드 밸런서가 노출되는 범위를 나타냅니다. 가능한 값은 "외부" 및 "내부"입니다.

15.1.46. .status.endpointPublishingStrategy.loadBalancer.providerParameters

설명
providerParameters에는 기본 인프라 공급자와 관련된 원하는 로드 밸런서 정보가 있습니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 providerParameters 필드를 참조하십시오.
유형
object
필수 항목
  • type
속성유형설명

AWS

object

AWS는 AWS 로드 밸런서와 관련된 구성 설정을 제공합니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 aws 필드를 참조하십시오.

gcp

object

GCP는 GCP 로드 밸런서와 관련된 구성 설정을 제공합니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 gcp 필드를 참조하십시오.

type

string

type은 로드 밸런서의 기본 인프라 공급자입니다. 허용되는 값은 "AWS", "Azure", "BareMetal", "GCP", "Nutanix", "OpenStack" 및 "VSphere"입니다.

15.1.47. .status.endpointPublishingStrategy.loadBalancer.providerParameters.aws

설명
AWS는 AWS 로드 밸런서와 관련된 구성 설정을 제공합니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 aws 필드를 참조하십시오.
유형
object
필수 항목
  • type
속성유형설명

classicLoadBalancer

object

ClassicLoadBalancerParameters에는 AWS 클래식 로드 밸런서에 대한 구성 매개변수가 있습니다. type이 Classic인 경우에만 표시됩니다.

networkLoadBalancer

object

NetworkLoadBalancerParameters에는 AWS 네트워크 로드 밸런서에 대한 구성 매개변수가 있습니다. type은 NLB인 경우에만 존재합니다.

type

string

type은 ingresscontroller를 인스턴스화할 AWS 로드 밸런서의 유형입니다. 유효한 값은 * "Classic": 전송 계층(TCP/SSL) 또는 애플리케이션 계층(HTTP/HTTPS)에서 라우팅을 결정하는 Classic Load Balancer입니다. 자세한 내용은 https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb * "NLB": 전송 계층(TCP/SSL)에서 라우팅을 결정하는 네트워크 로드 밸런서 장치입니다. 자세한 내용은 다음을 참조하십시오. https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb

15.1.48. .status.endpointPublishingStrategy.loadBalancer.providerParameters.aws.classicLoadBalancer

설명
ClassicLoadBalancerParameters에는 AWS 클래식 로드 밸런서에 대한 구성 매개변수가 있습니다. type이 Classic인 경우에만 표시됩니다.
유형
object
속성유형설명

connectionIdleTimeout

string

connectionIdleTimeout은 로드 밸런서가 연결을 닫기 전에 연결이 유휴 상태일 수 있는 최대 기간을 지정합니다. 값은 시간 기간 값으로 구문 분석할 수 있어야 합니다. https://pkg.go.dev/time#ParseDuration 을 참조하십시오. nil 또는 0 값은 의견이 없으며, 이 경우 기본값이 사용됩니다. 이 필드의 기본값은 60s입니다. 이 기본값은 변경될 수 있습니다.

15.1.49. .status.endpointPublishingStrategy.loadBalancer.providerParameters.aws.networkLoadBalancer

설명
NetworkLoadBalancerParameters에는 AWS 네트워크 로드 밸런서에 대한 구성 매개변수가 있습니다. type은 NLB인 경우에만 존재합니다.
유형
object

15.1.50. .status.endpointPublishingStrategy.loadBalancer.providerParameters.gcp

설명
GCP는 GCP 로드 밸런서와 관련된 구성 설정을 제공합니다. 비어있는 경우 기본값이 적용됩니다. 기본값에 대한 자세한 내용은 특정 gcp 필드를 참조하십시오.
유형
object
속성유형설명

clientAccess

string

clientAccess는 내부 로드 밸런서에 대해 클라이언트 액세스가 제한되는 방법을 설명합니다. 유효한 값은 * "Global": 글로벌 클라이언트 액세스를 사용하여 내부 로드 밸런서를 지정하면 VPC 내의 모든 리전의 클라이언트가 로드 밸런서와 통신할 수 있습니다. https://cloud.google.com/kubernetes-engine/docs/how-to/internal-load-balancing#global_access * "local": 로컬 클라이언트 액세스를 사용하여 내부 로드 밸런서를 지정하면 GCP 로드 밸런서가 로드 밸런서와 통신할 수 있는 것과 동일한 리전(및 VPC) 내의 클라이언트만 의미합니다. 이는 기본 동작입니다. https://cloud.google.com/load-balancing/docs/internal#client_access

15.1.51. .status.endpointPublishingStrategy.nodePort

설명
NodePort에는 NodePortService 끝점 게시 전략에 대한 매개변수가 있습니다. type이 NodePortService인 경우에만 표시됩니다.
유형
object
속성유형설명

protocol

string

protocol은 IngressController에서 들어오는 연결이 일반 TCP를 사용하도록 예상하는지 또는 IngressController에서 PROXY 프로토콜을 사용할지 여부를 지정합니다. PROXY 프로토콜은 IngressController로 해당 연결을 전달할 때 클라이언트 연결의 소스 주소를 전달하는 데 지원하는 로드 밸런서와 함께 사용할 수 있습니다. PROXY 프로토콜을 사용하면 IngressController에서 HTTP 헤더 및 로그에서 로드 밸런서의 주소를 보고하는 대신 해당 소스 주소를 보고할 수 있습니다. IngressController에서 PROXY 프로토콜을 활성화하면 IngressController에 연결을 전달하는 데 PROXY 프로토콜을 사용하는 로드 밸런서를 사용하지 않는 경우 연결이 실패합니다. PROXY 프로토콜에 대한 자세한 내용은 http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt 을 참조하십시오. 다음 값은 이 필드에 유효합니다. * 빈 문자열. * "TCP". * "PROXY". 빈 문자열은 PROXY 프로토콜이 없는 TCP인 기본값을 지정합니다. 기본값은 변경될 수 있습니다.

15.1.52. .status.endpointPublishingStrategy.private

설명
private에는 Private 엔드포인트 게시 전략에 대한 매개변수가 있습니다. type이 private인 경우에만 존재합니다.
유형
object
속성유형설명

protocol

string

protocol은 IngressController에서 들어오는 연결이 일반 TCP를 사용하도록 예상하는지 또는 IngressController에서 PROXY 프로토콜을 사용할지 여부를 지정합니다. PROXY 프로토콜은 IngressController로 해당 연결을 전달할 때 클라이언트 연결의 소스 주소를 전달하는 데 지원하는 로드 밸런서와 함께 사용할 수 있습니다. PROXY 프로토콜을 사용하면 IngressController에서 HTTP 헤더 및 로그에서 로드 밸런서의 주소를 보고하는 대신 해당 소스 주소를 보고할 수 있습니다. IngressController에서 PROXY 프로토콜을 활성화하면 IngressController에 연결을 전달하는 데 PROXY 프로토콜을 사용하는 로드 밸런서를 사용하지 않는 경우 연결이 실패합니다. PROXY 프로토콜에 대한 자세한 내용은 http://www.haproxy.org/download/2.2/doc/proxy-protocol.txt 을 참조하십시오. 다음 값은 이 필드에 유효합니다. * 빈 문자열. * "TCP". * "PROXY". 빈 문자열은 PROXY 프로토콜이 없는 TCP인 기본값을 지정합니다. 기본값은 변경될 수 있습니다.

15.1.53. .status.namespaceSelector

설명
namespaceSelector는 사용 중인 실제 namespaceSelector입니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

15.1.54. .status.namespaceSelector.matchExpressions

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

15.1.55. .status.namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

15.1.56. .status.routeSelector

설명
routeSelector는 사용 중인 실제 routeSelector입니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

15.1.57. .status.routeSelector.matchExpressions

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

15.1.58. .status.routeSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

15.1.59. .status.tlsProfile

설명
TLSProfile은 적용되는 TLS 연결 구성입니다.
유형
object
속성유형설명

암호화

배열(문자열)

암호는 TLS 핸드셰이크 중에 협상되는 암호화 알고리즘을 지정하는 데 사용됩니다. Operator는 피연산자가 지원하지 않는 항목을 제거할 수 있습니다. 예를 들어 DES-CBC3-SHA(yaml): 암호: - DES-CBC3-SHA

minTLSVersion

string

minTLSVersion은 TLS 핸드셰이크 중에 협상되는 최소 버전의 TLS 프로토콜을 지정하는 데 사용됩니다. 예를 들어 TLS 버전 1.1, 1.2 및 1.3(yaml)을 사용하려면 minTLSVersion: TLSv1.1 참고: 현재 허용되는 가장 높은 minTLSVersion은 VersionTLS12입니다.

15.2. API 끝점

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

  • /apis/operator.openshift.io/v1/ingresscontrollers

    • GET: IngressController 유형의 오브젝트 나열
  • /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers

    • DELETE: IngressController 컬렉션 삭제
    • GET: IngressController 유형의 오브젝트 나열
    • POST: IngressController 생성
  • /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers/{name}

    • DELETE: IngressController 삭제
    • GET: 지정된 IngressController 읽기
    • PATCH: 지정된 IngressController를 부분적으로 업데이트
    • PUT: 지정된 IngressController를 교체
  • /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers/{name}/scale

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

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

15.2.1. /apis/operator.openshift.io/v1/ingresscontrollers

표 15.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
설명
IngressController 유형의 오브젝트 나열
표 15.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

IngressControllerList schema

401 - 무단

15.2.2. /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers

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

네임스페이스

string

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

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

string

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

HTTP 방법
DELETE
설명
IngressController 컬렉션 삭제
표 15.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을 지정합니다.

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
IngressController 유형의 오브젝트 나열
표 15.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을 지정합니다.

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

200 - OK

IngressControllerList schema

401 - 무단

HTTP 방법
POST
설명
IngressController 생성
표 15.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

IngressController schema

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

200 - OK

IngressController schema

201 - 생성됨

IngressController schema

202 - 승인됨

IngressController schema

401 - 무단

15.2.3. /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers/{name}

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

name

string

IngressController 이름

네임스페이스

string

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

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

string

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

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

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

body

DeleteOptions 스키마

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

IngressController schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 IngressController를 부분적으로 업데이트
표 15.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

IngressController schema

401 - 무단

HTTP 방법
PUT
설명
지정된 IngressController를 교체
표 15.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

IngressController schema

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

200 - OK

IngressController schema

201 - 생성됨

IngressController schema

401 - 무단

15.2.4. /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers/{name}/scale

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

name

string

IngressController 이름

네임스페이스

string

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

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

string

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

HTTP 방법
GET
설명
지정된 IngressController의 크기 읽기
표 15.27. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

스케일링 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 IngressController의 부분 업데이트 스케일링
표 15.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

스케일링 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 IngressController의 스케일링 교체
표 15.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

스케일링 스키마

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

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

15.2.5. /apis/operator.openshift.io/v1/namespaces/{namespace}/ingresscontrollers/{name}/status

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

name

string

IngressController 이름

네임스페이스

string

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

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

string

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

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

resourceVersion

string

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

기본값이 설정되지 않음

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

200 - OK

IngressController schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 IngressController의 부분적으로 업데이트 상태
표 15.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

패치 스키마

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

200 - OK

IngressController schema

401 - 무단

HTTP 방법
PUT
설명
지정된 IngressController의 상태 교체
표 15.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

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

body

IngressController 스키마

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

200 - OK

IngressController 스키마

201 - 생성됨

IngressController 스키마

401 - 무단

16장. InsightsOperator [operator.openshift.io/v1]

설명
InsightsOperator에는 Insights Operator에 대한 클러스터 전체 정보가 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

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

spec은 Insights의 원하는 동작의 사양입니다.

status

object

상태는 Insights Operator의 가장 최근에 관찰된 상태입니다.

16.1.1. .spec

설명
spec은 Insights의 원하는 동작의 사양입니다.
유형
object
속성유형설명

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

16.1.2. .status

설명
상태는 Insights Operator의 가장 최근에 관찰된 상태입니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

gatherStatus

object

gatherStatus는 마지막 Insights 데이터 수집에 대한 기본 정보를 제공합니다. 생략하면 아직 데이터 수집이 이루어지지 않았음을 의미합니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

insightsReport

object

InsightsReport는 일반적인 Insights 분석 결과를 제공합니다. 생략하면 아직 데이터 수집이 이루어지지 않았음을 의미합니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

16.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

16.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

16.1.5. .status.gatherStatus

설명
gatherStatus는 마지막 Insights 데이터 수집에 대한 기본 정보를 제공합니다. 생략하면 아직 데이터 수집이 이루어지지 않았음을 의미합니다.
유형
object
속성유형설명

수집자

array

수집자는 마지막 수집에서 활성 수집자(및 해당 상태) 목록입니다.

gatherers[]

object

gathererStatus는 특정 데이터 수집에 대한 정보를 나타냅니다.

lastGatherDuration

string

lastGatherDuration은 마지막 수집 이벤트 중에 모든 수집자를 처리하는 데 걸리는 총 시간입니다.

lastGatherTime

string

lastGatherTime은 Insights 데이터 수집이 마지막으로 완료된 시간입니다. 빈 값은 아직 데이터가 수집되지 않았음을 의미합니다.

16.1.6. .status.gatherStatus.gatherers

설명
수집자는 마지막 수집에서 활성 수집자(및 해당 상태) 목록입니다.
유형
array

16.1.7. .status.gatherStatus.gatherers[]

설명
gathererStatus는 특정 데이터 수집에 대한 정보를 나타냅니다.
유형
object
필수 항목
  • conditions
  • lastGatherDuration
  • name
속성유형설명

conditions

array

조건은 각 수집자의 상태에 대한 세부 정보를 제공합니다.

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" // 기타 필드 }

lastGatherDuration

string

lastGatherDuration은 수집 시간을 나타냅니다.

name

string

이름은 수집자의 이름입니다.

16.1.8. .status.gatherStatus.gatherers[].conditions

설명
조건은 각 수집자의 상태에 대한 세부 정보를 제공합니다.
유형
array

16.1.9. .status.gatherStatus.gatherers[].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)입니다.

16.1.10. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

16.1.11. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

16.1.12. .status.insightsReport

설명
InsightsReport는 일반적인 Insights 분석 결과를 제공합니다. 생략하면 아직 데이터 수집이 이루어지지 않았음을 의미합니다.
유형
object
속성유형설명

healthChecks

array

상태 점검은 클러스터의 활성 Insights 상태 점검에 대한 기본 정보를 제공합니다.

healthChecks[]

object

Healthcheck는 Insights 상태 점검 속성을 나타냅니다.

16.1.13. .status.insightsReport.healthChecks

설명
상태 점검은 클러스터의 활성 Insights 상태 점검에 대한 기본 정보를 제공합니다.
유형
array

16.1.14. .status.insightsReport.healthChecks[]

설명
Healthcheck는 Insights 상태 점검 속성을 나타냅니다.
유형
object
필수 항목
  • advisorURI
  • description
  • 상태
  • totalRisk
속성유형설명

advisorURI

string

AdvisorURI는 Insights Advisor에 대한 URL 링크를 제공합니다.

description

string

Description은 healtcheck에 대한 기본 설명을 제공합니다.

상태

string

상태는 상태 점검의 현재 상태를 결정합니다. 상태 점검은 기본적으로 활성화되어 있으며 Insights 어드바이저 사용자 인터페이스에서 사용자가 비활성화할 수 있습니다.

totalRisk

integer

TotalRisk of the healthcheck입니다. 감지된 문제에 의해 발생된 총 위험의 표시; 영향과 가능성의 조합 값은 1에서 4 사이일 수 있으며 숫자가 클수록 문제가 더 중요합니다.

16.2. API 끝점

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

  • /apis/operator.openshift.io/v1/insightsoperators

    • DELETE: InsightsOperator의 컬렉션 삭제
    • GET: InsightsOperator 유형의 오브젝트 나열
    • POST: InsightsOperator 생성
  • /apis/operator.openshift.io/v1/insightsoperators/{name}

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

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

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

16.2.1. /apis/operator.openshift.io/v1/insightsoperators

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

string

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

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

allowWatchBookmarks

boolean

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

계속

string

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

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 16.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
InsightsOperator 유형의 오브젝트 나열
표 16.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을 지정합니다.

표 16.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

InsightsOperatorList schema

401 - 무단

HTTP 방법
POST
설명
InsightsOperator 생성
표 16.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 16.7. 본문 매개변수
매개변수유형설명

body

InsightsOperator schema

 
표 16.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

InsightsOperator schema

201 - 생성됨

InsightsOperator schema

202 - 승인됨

InsightsOperator schema

401 - 무단

16.2.2. /apis/operator.openshift.io/v1/insightsoperators/{name}

표 16.9. 글로벌 경로 매개변수
매개변수유형설명

name

string

InsightsOperator의 이름

표 16.10. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
InsightsOperator 삭제
표 16.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 16.12. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 16.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 InsightsOperator 읽기
표 16.14. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 16.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

InsightsOperator 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 InsightsOperator를 부분적으로 업데이트
표 16.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 16.17. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 16.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

InsightsOperator 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 InsightsOperator를 교체
표 16.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 16.20. 본문 매개변수
매개변수유형설명

body

InsightsOperator 스키마

 
표 16.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

InsightsOperator 스키마

201 - 생성됨

InsightsOperator 스키마

401 - 무단

16.2.3. /apis/operator.openshift.io/v1/insightsoperators/{name}/scale

표 16.22. 글로벌 경로 매개변수
매개변수유형설명

name

string

InsightsOperator의 이름

표 16.23. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 InsightsOperator의 크기 읽기
표 16.24. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 16.25. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스케일링 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 InsightsOperator의 부분 업데이트 규모
표 16.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 16.27. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 16.28. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스케일링 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 InsightsOperator의 스케일링 교체
표 16.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 16.30. 본문 매개변수
매개변수유형설명

body

스케일링 스키마

 
표 16.31. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스케일링 스키마

201 - 생성됨

스케일링 스키마

401 - 무단

16.2.4. /apis/operator.openshift.io/v1/insightsoperators/{name}/status

표 16.32. 글로벌 경로 매개변수
매개변수유형설명

name

string

InsightsOperator의 이름

표 16.33. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 InsightsOperator의 읽기 상태
표 16.34. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 16.35. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

InsightsOperator 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 InsightsOperator의 부분적으로 업데이트
표 16.36. 쿼리 매개변수
매개변수유형설명

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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 16.37. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 16.38. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

InsightsOperator 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 InsightsOperator의 상태 교체
표 16.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 16.40. 본문 매개변수
매개변수유형설명

body

InsightsOperator schema

 
표 16.41. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

InsightsOperator schema

201 - 생성됨

InsightsOperator schema

401 - 무단

17장. KubeAPIServer [operator.openshift.io/v1]

설명
kubeapiserver는 kube-apiserver를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

17.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

spec은 Kubernetes API Server의 원하는 동작의 사양입니다.

status

object

상태는 쿠버네티스 API 서버의 가장 최근에 관찰된 상태입니다.

17.1.1. .spec

설명
spec은 Kubernetes API Server의 원하는 동작의 사양입니다.
유형
object
속성유형설명

failedRevisionLimit

integer

failedRevisionLimit은 디스크를 유지하고 api -1 = 무제한, 0 또는 unset = 5(기본값)에서 유지하는 실패한 정적 Pod 설치 프로그램 버전 수입니다.

forceRedeploymentReason

string

forceRedeploymentReason을 사용하여 고유한 문자열을 제공하여 피연산자를 강제로 재배포할 수 있습니다. 이를 통해 이전에 실패한 배포를 시작하는 메커니즘을 제공하고 동일한 구성에서 다시 실패하지 않고 이번에는 작동한다고 생각하는 이유를 제공합니다.

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

succeededRevisionLimit

integer

succeededRevisionLimit은 디스크에 보관하고 api -1 = 무제한, 0 또는 설정되지 않은 = 5(기본값)에서 유지하는 정적 Pod 설치 프로그램 리버전의 수입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

17.1.2. .status

설명
상태는 쿠버네티스 API 서버의 가장 최근에 관찰된 상태입니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

latestAvailableRevision

integer

latestAvailableRevision은 최신 배포의 deploymentID입니다.

latestAvailableRevisionReason

string

latestAvailableRevisionReason은 최신 배포의 자세한 이유를 설명합니다.

nodeStatuses

array

nodeStatuses는 개별 노드에서 배포 값과 오류를 추적합니다.

nodeStatuses[]

object

NodeStatus는 이 Operator가 관리하는 특정 노드의 현재 상태에 대한 정보를 제공합니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

serviceAccountIssuers

array

serviceAccountIssuers는 사용된 서비스 계정 발행자의 기록을 추적합니다. 만료 시간이 없는 항목은 현재 사용 중인 서비스 계정 발행자를 나타냅니다. 다른 항목은 이전에 사용되었으며 아직 신뢰할 수 있는 서비스 계정 발행자를 나타냅니다. 항목에 대한 기본 만료는 플랫폼에 의해 설정되며 기본값은 24h입니다. https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#service-account-token-volume-projection를 참조하십시오.

serviceAccountIssuers[]

object

 

version

string

버전이 이 가용성이 적용되는 수준입니다.

17.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

17.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

17.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

17.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

17.1.7. .status.nodeStatuses

설명
nodeStatuses는 개별 노드에서 배포 값과 오류를 추적합니다.
유형
array

17.1.8. .status.nodeStatuses[]

설명
NodeStatus는 이 Operator가 관리하는 특정 노드의 현재 상태에 대한 정보를 제공합니다.
유형
object
속성유형설명

currentRevision

integer

currentRevision은 가장 최근에 성공한 배포를 생성하는 것입니다.

lastFailedCount

integer

lastFailedCount는 마지막 실패한 리버전의 설치 프로그램 Pod가 실패한 빈도입니다.

lastFailedReason

string

lastFailedReason은 머신에서 읽을 수 있는 실패 이유 문자열입니다.

lastFailedRevision

integer

lastFailedRevision은 시도한 배포 생성이며 배포에 실패했습니다.

lastFailedRevisionErrors

배열(문자열)

lastFailedRevisionErrors는 lastFailedRevision에서 참조한 실패한 배포 중에 사람이 읽을 수 있는 오류 목록입니다.

lastFailedTime

string

lastFailedTime은 마지막으로 실패한 리버전이 마지막으로 실패한 시간입니다.

lastFallbackCount

integer

lastFallbackCount는 이전 수정으로 대체되는 빈도입니다.

nodeName

string

nodename은 노드의 이름입니다.

targetRevision

integer

targetRevision은 적용하려는 배포 생성입니다.

17.1.9. .status.serviceAccountIssuers

설명
serviceAccountIssuers는 사용된 서비스 계정 발행자의 기록을 추적합니다. 만료 시간이 없는 항목은 현재 사용 중인 서비스 계정 발행자를 나타냅니다. 다른 항목은 이전에 사용되었으며 아직 신뢰할 수 있는 서비스 계정 발행자를 나타냅니다. 항목에 대한 기본 만료는 플랫폼에 의해 설정되며 기본값은 24h입니다. https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#service-account-token-volume-projection를 참조하십시오.
유형
array

17.1.10. .status.serviceAccountIssuers[]

설명
유형
object
속성유형설명

expirationTime

string

expirationTime은 이 서비스 계정 발행자가 신뢰할 수 있는 서비스 계정 발행자 목록에서 정리 및 제거된 시간입니다.

name

string

name은 서비스 계정 발행자의 이름입니다 ---

17.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/operator.openshift.io/v1/kubeapiservers

    • DELETE: KubeAPIServer의 컬렉션 삭제
    • GET: KubeAPIServer 유형의 오브젝트 나열
    • POST: KubeAPIServer 생성
  • /apis/operator.openshift.io/v1/kubeapiservers/{name}

    • DELETE: KubeAPIServer 삭제
    • GET: 지정된 KubeAPIServer 읽기
    • PATCH: 지정된 KubeAPIServer를 부분적으로 업데이트
    • PUT: 지정된 KubeAPIServer를 교체
  • /apis/operator.openshift.io/v1/kubeapiservers/{name}/status

    • GET: 지정된 KubeAPIServer의 읽기 상태
    • PATCH: 지정된 KubeAPIServer의 부분적으로 업데이트 상태
    • PUT: 지정된 KubeAPIServer의 상태

17.2.1. /apis/operator.openshift.io/v1/kubeapiservers

표 17.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
KubeAPIServer의 컬렉션 삭제
표 17.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을 지정합니다.

표 17.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
KubeAPIServer 유형의 오브젝트 나열
표 17.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을 지정합니다.

표 17.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeAPIServerList schema

401 - 무단

HTTP 방법
POST
설명
KubeAPIServer 생성
표 17.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 17.7. 본문 매개변수
매개변수유형설명

body

kubeapiserver 스키마

 
표 17.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubeapiserver 스키마

201 - 생성됨

kubeapiserver 스키마

202 - 승인됨

kubeapiserver 스키마

401 - 무단

17.2.2. /apis/operator.openshift.io/v1/kubeapiservers/{name}

표 17.9. 글로벌 경로 매개변수
매개변수유형설명

name

string

KubeAPIServer의 이름

표 17.10. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
KubeAPIServer 삭제
표 17.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 17.12. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 17.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 KubeAPIServer 읽기
표 17.14. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 17.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubeapiserver 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 KubeAPIServer를 부분적으로 업데이트
표 17.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 17.17. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 17.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubeapiserver 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 KubeAPIServer를 교체
표 17.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 17.20. 본문 매개변수
매개변수유형설명

body

kubeapiserver 스키마

 
표 17.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubeapiserver 스키마

201 - 생성됨

kubeapiserver 스키마

401 - 무단

17.2.3. /apis/operator.openshift.io/v1/kubeapiservers/{name}/status

표 17.22. 글로벌 경로 매개변수
매개변수유형설명

name

string

KubeAPIServer의 이름

표 17.23. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 KubeAPIServer의 읽기 상태
표 17.24. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 17.25. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubeapiserver 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 KubeAPIServer의 부분적으로 업데이트 상태
표 17.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 17.27. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 17.28. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubeapiserver 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 KubeAPIServer의 상태 교체
표 17.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 17.30. 본문 매개변수
매개변수유형설명

body

kubeapiserver 스키마

 
표 17.31. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubeapiserver 스키마

201 - 생성됨

kubeapiserver 스키마

401 - 무단

18장. KubeControllerManager [operator.openshift.io/v1]

설명
kubecontrollermanager는 kube-controller-manager를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

18.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

spec은 Kubernetes 컨트롤러 관리자의 원하는 동작의 사양입니다.

status

object

상태는 Kubernetes 컨트롤러 관리자의 가장 최근에 관찰된 상태입니다.

18.1.1. .spec

설명
spec은 Kubernetes 컨트롤러 관리자의 원하는 동작의 사양입니다.
유형
object
속성유형설명

failedRevisionLimit

integer

failedRevisionLimit은 디스크를 유지하고 api -1 = 무제한, 0 또는 unset = 5(기본값)에서 유지하는 실패한 정적 Pod 설치 프로그램 버전 수입니다.

forceRedeploymentReason

string

forceRedeploymentReason을 사용하여 고유한 문자열을 제공하여 피연산자를 강제로 재배포할 수 있습니다. 이를 통해 이전에 실패한 배포를 시작하는 메커니즘을 제공하고 동일한 구성에서 다시 실패하지 않고 이번에는 작동한다고 생각하는 이유를 제공합니다.

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

succeededRevisionLimit

integer

succeededRevisionLimit은 디스크에 보관하고 api -1 = 무제한, 0 또는 설정되지 않은 = 5(기본값)에서 유지하는 정적 Pod 설치 프로그램 리버전의 수입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

useMoreSecureServiceCA

boolean

use CryostatSecureServiceCA는 SA 토큰 볼륨에 제공된 service-ca.crt가 서비스 제공 인증서의 유효성을 검사하는 데 충분한 인증서만 포함해야 함을 나타냅니다. true로 설정하면 false로 설정할 수 없습니다. 누군가가 다시 false로 설정하는 방법을 발견하더라도 이전에 존재했던 service-ca.crt 파일에는 더 안전한 콘텐츠만 있습니다.

18.1.2. .status

설명
상태는 Kubernetes 컨트롤러 관리자의 가장 최근에 관찰된 상태입니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

latestAvailableRevision

integer

latestAvailableRevision은 최신 배포의 deploymentID입니다.

latestAvailableRevisionReason

string

latestAvailableRevisionReason은 최신 배포의 자세한 이유를 설명합니다.

nodeStatuses

array

nodeStatuses는 개별 노드에서 배포 값과 오류를 추적합니다.

nodeStatuses[]

object

NodeStatus는 이 Operator가 관리하는 특정 노드의 현재 상태에 대한 정보를 제공합니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

18.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

18.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

18.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

18.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

18.1.7. .status.nodeStatuses

설명
nodeStatuses는 개별 노드에서 배포 값과 오류를 추적합니다.
유형
array

18.1.8. .status.nodeStatuses[]

설명
NodeStatus는 이 Operator가 관리하는 특정 노드의 현재 상태에 대한 정보를 제공합니다.
유형
object
속성유형설명

currentRevision

integer

currentRevision은 가장 최근에 성공한 배포를 생성하는 것입니다.

lastFailedCount

integer

lastFailedCount는 마지막 실패한 리버전의 설치 프로그램 Pod가 실패한 빈도입니다.

lastFailedReason

string

lastFailedReason은 머신에서 읽을 수 있는 실패 이유 문자열입니다.

lastFailedRevision

integer

lastFailedRevision은 시도한 배포 생성이며 배포에 실패했습니다.

lastFailedRevisionErrors

배열(문자열)

lastFailedRevisionErrors는 lastFailedRevision에서 참조한 실패한 배포 중에 사람이 읽을 수 있는 오류 목록입니다.

lastFailedTime

string

lastFailedTime은 마지막으로 실패한 리버전이 마지막으로 실패한 시간입니다.

lastFallbackCount

integer

lastFallbackCount는 이전 수정으로 대체되는 빈도입니다.

nodeName

string

nodename은 노드의 이름입니다.

targetRevision

integer

targetRevision은 적용하려는 배포 생성입니다.

18.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/operator.openshift.io/v1/kubecontrollermanagers

    • DELETE: KubeControllerManager의 컬렉션 삭제
    • GET: KubeControllerManager 유형의 오브젝트 나열
    • POST: KubeControllerManager 생성
  • /apis/operator.openshift.io/v1/kubecontrollermanagers/{name}

    • DELETE: delete a KubeControllerManager
    • GET: 지정된 KubeControllerManager 읽기
    • PATCH: 지정된 KubeControllerManager를 부분적으로 업데이트
    • PUT: 지정된 KubeControllerManager를 교체합니다.
  • /apis/operator.openshift.io/v1/kubecontrollermanagers/{name}/status

    • GET: 지정된 KubeControllerManager의 읽기 상태
    • PATCH: 지정된 KubeControllerManager의 부분적으로 업데이트 상태
    • PUT: 지정된 KubeControllerManager의 상태 교체

18.2.1. /apis/operator.openshift.io/v1/kubecontrollermanagers

표 18.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
KubeControllerManager 컬렉션 삭제
표 18.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을 지정합니다.

표 18.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
KubeControllerManager 유형의 오브젝트 나열
표 18.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을 지정합니다.

표 18.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeControllerManagerList schema

401 - 무단

HTTP 방법
POST
설명
KubeControllerManager 생성
표 18.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 18.7. 본문 매개변수
매개변수유형설명

body

KubeControllerManager schema

 
표 18.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeControllerManager schema

201 - 생성됨

KubeControllerManager schema

202 - 승인됨

KubeControllerManager schema

401 - 무단

18.2.2. /apis/operator.openshift.io/v1/kubecontrollermanagers/{name}

표 18.9. 글로벌 경로 매개변수
매개변수유형설명

name

string

KubeControllerManager의 이름

표 18.10. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
delete a KubeControllerManager
표 18.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 18.12. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 18.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 KubeControllerManager 읽기
표 18.14. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 18.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeControllerManager schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 KubeControllerManager를 부분적으로 업데이트
표 18.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 18.17. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 18.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeControllerManager schema

401 - 무단

HTTP 방법
PUT
설명
지정된 KubeControllerManager를 교체
표 18.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 18.20. 본문 매개변수
매개변수유형설명

body

KubeControllerManager schema

 
표 18.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeControllerManager schema

201 - 생성됨

KubeControllerManager schema

401 - 무단

18.2.3. /apis/operator.openshift.io/v1/kubecontrollermanagers/{name}/status

표 18.22. 글로벌 경로 매개변수
매개변수유형설명

name

string

KubeControllerManager의 이름

표 18.23. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 KubeControllerManager의 읽기 상태
표 18.24. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 18.25. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeControllerManager schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 KubeControllerManager의 부분적으로 업데이트 상태
표 18.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 18.27. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 18.28. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeControllerManager schema

401 - 무단

HTTP 방법
PUT
설명
지정된 KubeControllerManager의 상태 교체
표 18.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 18.30. 본문 매개변수
매개변수유형설명

body

KubeControllerManager schema

 
표 18.31. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeControllerManager schema

201 - 생성됨

KubeControllerManager schema

401 - 무단

19장. KubeScheduler [operator.openshift.io/v1]

설명
kubescheduler는 스케줄러를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

19.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

spec은 Kubernetes Scheduler의 원하는 동작의 사양입니다.

status

object

상태는 쿠버네티스 스케줄러의 가장 최근에 관찰된 상태입니다.

19.1.1. .spec

설명
spec은 Kubernetes Scheduler의 원하는 동작의 사양입니다.
유형
object
속성유형설명

failedRevisionLimit

integer

failedRevisionLimit은 디스크를 유지하고 api -1 = 무제한, 0 또는 unset = 5(기본값)에서 유지하는 실패한 정적 Pod 설치 프로그램 버전 수입니다.

forceRedeploymentReason

string

forceRedeploymentReason을 사용하여 고유한 문자열을 제공하여 피연산자를 강제로 재배포할 수 있습니다. 이를 통해 이전에 실패한 배포를 시작하는 메커니즘을 제공하고 동일한 구성에서 다시 실패하지 않고 이번에는 작동한다고 생각하는 이유를 제공합니다.

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

succeededRevisionLimit

integer

succeededRevisionLimit은 디스크에 보관하고 api -1 = 무제한, 0 또는 설정되지 않은 = 5(기본값)에서 유지하는 정적 Pod 설치 프로그램 리버전의 수입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

19.1.2. .status

설명
상태는 쿠버네티스 스케줄러의 가장 최근에 관찰된 상태입니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

latestAvailableRevision

integer

latestAvailableRevision은 최신 배포의 deploymentID입니다.

latestAvailableRevisionReason

string

latestAvailableRevisionReason은 최신 배포의 자세한 이유를 설명합니다.

nodeStatuses

array

nodeStatuses는 개별 노드에서 배포 값과 오류를 추적합니다.

nodeStatuses[]

object

NodeStatus는 이 Operator가 관리하는 특정 노드의 현재 상태에 대한 정보를 제공합니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

19.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

19.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

19.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

19.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

19.1.7. .status.nodeStatuses

설명
nodeStatuses는 개별 노드에서 배포 값과 오류를 추적합니다.
유형
array

19.1.8. .status.nodeStatuses[]

설명
NodeStatus는 이 Operator가 관리하는 특정 노드의 현재 상태에 대한 정보를 제공합니다.
유형
object
속성유형설명

currentRevision

integer

currentRevision은 가장 최근에 성공한 배포를 생성하는 것입니다.

lastFailedCount

integer

lastFailedCount는 마지막 실패한 리버전의 설치 프로그램 Pod가 실패한 빈도입니다.

lastFailedReason

string

lastFailedReason은 머신에서 읽을 수 있는 실패 이유 문자열입니다.

lastFailedRevision

integer

lastFailedRevision은 시도한 배포 생성이며 배포에 실패했습니다.

lastFailedRevisionErrors

배열(문자열)

lastFailedRevisionErrors는 lastFailedRevision에서 참조한 실패한 배포 중에 사람이 읽을 수 있는 오류 목록입니다.

lastFailedTime

string

lastFailedTime은 마지막으로 실패한 리버전이 마지막으로 실패한 시간입니다.

lastFallbackCount

integer

lastFallbackCount는 이전 수정으로 대체되는 빈도입니다.

nodeName

string

nodename은 노드의 이름입니다.

targetRevision

integer

targetRevision은 적용하려는 배포 생성입니다.

19.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/operator.openshift.io/v1/kubeschedulers

    • DELETE: KubeScheduler의 컬렉션 삭제
    • GET: KubeScheduler 유형의 오브젝트 나열
    • POST: KubeScheduler 생성
  • /apis/operator.openshift.io/v1/kubeschedulers/{name}

    • DELETE: KubeScheduler 삭제
    • GET: 지정된 KubeScheduler 읽기
    • PATCH: 지정된 KubeScheduler를 부분적으로 업데이트
    • PUT: 지정된 KubeScheduler로 교체
  • /apis/operator.openshift.io/v1/kubeschedulers/{name}/status

    • GET: 지정된 KubeScheduler의 읽기 상태
    • PATCH: 지정된 KubeScheduler의 부분적으로 업데이트 상태
    • PUT: 지정된 KubeScheduler의 상태 교체

19.2.1. /apis/operator.openshift.io/v1/kubeschedulers

표 19.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
KubeScheduler 컬렉션 삭제
표 19.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을 지정합니다.

표 19.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
kind KubeScheduler의 오브젝트 나열
표 19.4. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 19.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeSchedulerList 스키마

401 - 무단

HTTP 방법
POST
설명
KubeScheduler 생성
표 19.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 19.7. 본문 매개변수
매개변수유형설명

body

kubescheduler 스키마

 
표 19.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubescheduler 스키마

201 - 생성됨

kubescheduler 스키마

202 - 승인됨

kubescheduler 스키마

401 - 무단

19.2.2. /apis/operator.openshift.io/v1/kubeschedulers/{name}

표 19.9. 글로벌 경로 매개변수
매개변수유형설명

name

string

KubeScheduler 이름

표 19.10. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
KubeScheduler 삭제
표 19.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 19.12. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 19.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 KubeScheduler 읽기
표 19.14. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 19.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubescheduler 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 KubeScheduler 부분적으로 업데이트
표 19.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 19.17. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 19.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubescheduler 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 KubeScheduler 교체
표 19.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 19.20. 본문 매개변수
매개변수유형설명

body

kubescheduler 스키마

 
표 19.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubescheduler 스키마

201 - 생성됨

kubescheduler 스키마

401 - 무단

19.2.3. /apis/operator.openshift.io/v1/kubeschedulers/{name}/status

표 19.22. 글로벌 경로 매개변수
매개변수유형설명

name

string

KubeScheduler 이름

표 19.23. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 KubeScheduler의 읽기 상태
표 19.24. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 19.25. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubescheduler 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 KubeScheduler의 부분적으로 업데이트 상태
표 19.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 19.27. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 19.28. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubescheduler 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 KubeScheduler의 상태 교체
표 19.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 19.30. 본문 매개변수
매개변수유형설명

body

kubescheduler 스키마

 
표 19.31. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

kubescheduler 스키마

201 - 생성됨

kubescheduler 스키마

401 - 무단

20장. KubeStorageVersionMigrator [operator.openshift.io/v1]

설명
KubeStorageVersionMigrator는 kube-storage-version-migrator를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

20.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

 

20.1.1. .spec

설명
유형
object
속성유형설명

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

20.1.2. .status

설명
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

20.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

20.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

20.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

20.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

20.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/operator.openshift.io/v1/kubestorageversionmigrators

    • DELETE: KubeStorageVersionMigrator의 컬렉션 삭제
    • GET: KubeStorageVersionMigrator 유형의 오브젝트 나열
    • POST: KubeStorageVersionMigrator 생성
  • /apis/operator.openshift.io/v1/kubestorageversionmigrators/{name}

    • DELETE: KubeStorageVersionMigrator 삭제
    • GET: 지정된 KubeStorageVersionMigrator를 읽습니다.
    • PATCH: 지정된 KubeStorageVersionMigrator를 부분적으로 업데이트
    • PUT: 지정된 KubeStorageVersionMigrator로 교체
  • /apis/operator.openshift.io/v1/kubestorageversionmigrators/{name}/status

    • GET: 지정된 KubeStorageVersionMigrator의 읽기 상태
    • PATCH: 지정된 KubeStorageVersionMigrator의 부분적으로 업데이트 상태
    • PUT: 지정된 KubeStorageVersionMigrator의 상태 교체

20.2.1. /apis/operator.openshift.io/v1/kubestorageversionmigrators

표 20.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
KubeStorageVersionMigrator 컬렉션 삭제
표 20.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을 지정합니다.

표 20.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
KubeStorageVersionMigrator 유형의 오브젝트 나열
표 20.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을 지정합니다.

표 20.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeStorageVersionMigratorList schema

401 - 무단

HTTP 방법
POST
설명
create a KubeStorageVersionMigrator
표 20.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 20.7. 본문 매개변수
매개변수유형설명

body

KubeStorageVersionMigrator schema

 
표 20.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeStorageVersionMigrator schema

201 - 생성됨

KubeStorageVersionMigrator schema

202 - 승인됨

KubeStorageVersionMigrator schema

401 - 무단

20.2.2. /apis/operator.openshift.io/v1/kubestorageversionmigrators/{name}

표 20.9. 글로벌 경로 매개변수
매개변수유형설명

name

string

KubeStorageVersionMigrator 이름

표 20.10. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
delete a KubeStorageVersionMigrator
표 20.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 20.12. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 20.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 KubeStorageVersionMigrator 읽기
표 20.14. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 20.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeStorageVersionMigrator schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 KubeStorageVersionMigrator를 부분적으로 업데이트
표 20.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 20.17. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 20.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeStorageVersionMigrator schema

401 - 무단

HTTP 방법
PUT
설명
지정된 KubeStorageVersionMigrator 교체
표 20.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 20.20. 본문 매개변수
매개변수유형설명

body

KubeStorageVersionMigrator schema

 
표 20.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeStorageVersionMigrator schema

201 - 생성됨

KubeStorageVersionMigrator schema

401 - 무단

20.2.3. /apis/operator.openshift.io/v1/kubestorageversionmigrators/{name}/status

표 20.22. 글로벌 경로 매개변수
매개변수유형설명

name

string

KubeStorageVersionMigrator 이름

표 20.23. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 KubeStorageVersionMigrator의 읽기 상태
표 20.24. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 20.25. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeStorageVersionMigrator schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 KubeStorageVersionMigrator의 부분적으로 업데이트 상태
표 20.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 20.27. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 20.28. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeStorageVersionMigrator schema

401 - 무단

HTTP 방법
PUT
설명
지정된 KubeStorageVersionMigrator의 상태 교체
표 20.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 20.30. 본문 매개변수
매개변수유형설명

body

KubeStorageVersionMigrator schema

 
표 20.31. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

KubeStorageVersionMigrator schema

201 - 생성됨

KubeStorageVersionMigrator schema

401 - 무단

21장. Network [operator.openshift.io/v1]

설명
네트워크는 클러스터의 원하는 네트워크 구성을 설명합니다. cluster-network-operator에서 사용합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

21.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

NetworkSpec은 최상위 네트워크 구성 오브젝트입니다.

status

object

NetworkStatus는 네트워크 clusteroperator 개체까지 해체되는 자세한 Operator 상태입니다.

21.1.1. .spec

설명
NetworkSpec은 최상위 네트워크 구성 오브젝트입니다.
유형
object
속성유형설명

additionalNetworks

array

additionalNetworks는 여러 네트워크가 활성화된 경우 Pod에서 사용할 수 있도록 하는 추가 네트워크 목록입니다.

additionalNetworks[]

object

AdditionalNetworkDefinition은 사용할 수 있지만 기본적으로 생성되지 않은 추가 네트워크를 구성합니다. 대신 Pod는 이름으로 요청해야 합니다. 유형과 일치하는 정확히 하나의 "Config"와 함께 유형을 지정해야 합니다.

clusterNetwork

array

clusterNetwork는 Pod IP에 사용할 IP 주소 풀입니다. OpenShift SDN과 같은 일부 네트워크 공급자는 여러 ClusterNetworks를 지원합니다. 다른 하나는 하나만 지원합니다. 이는 cluster-cidr과 동일합니다.

clusterNetwork[]

object

ClusterNetworkEntry는 PodIP를 할당할 서브넷입니다. 노드가 클러스터에 참여할 때 크기 HostPrefix(CIDR 표기법) 네트워크가 할당됩니다. 플러그인에서 HostPrefix 필드를 사용하지 않는 경우 설정되지 않은 상태로 둘 수 있습니다. 모든 네트워크 공급자가 여러 ClusterNetworks를 지원하는 것은 아닙니다.

defaultNetwork

object

defaultNetwork는 모든 Pod가 수신할 "기본" 네트워크입니다.

deployKubeProxy

boolean

deployKubeProxy는 Operator에서 독립 실행형 kube-proxy를 배포해야 하는지 여부를 지정합니다. 일부 네트워크 공급자에는 kube-proxy 또는 유사한 기능이 포함되어 있습니다. 설정되지 않은 경우 플러그인은 올바른 값을 선택하려고 합니다. 이 값은 OpenShift SDN 및 ovn-kubernetes를 사용할 때 false이고, 그렇지 않으면 true입니다.

disableMultiNetwork

boolean

disableMultiNetwork는 여러 Pod 네트워크 지원을 비활성화해야 하는지 여부를 지정합니다. 설정되지 않은 경우 이 속성은 기본적으로 'false'로 설정되고 여러 네트워크 지원이 활성화됩니다.

disableNetworkDiagnostics

boolean

disableNetworkDiagnostics는 테스트 Pod에서 모든 노드로의 PodNetworkConnectivityCheck CR, apiserver 및 LB를 비활성화해야 하는지 여부를 지정합니다. 설정되지 않은 경우 이 속성은 기본적으로 'false'로 설정되고 네트워크 진단이 활성화됩니다. 이를 'true'로 설정하면 검사를 수행하는 Pod의 추가 로드가 줄어듭니다.

exportNetworkFlows

object

exportNetworkFlows는 NetFlow, SFlow 또는 IPFIX 프로토콜을 사용하여 Pod 네트워크에서 네트워크 흐름 메타데이터의 내보내기를 활성화하고 구성합니다. 현재 OVN-Kubernetes 플러그인에서만 지원됩니다. 설정되지 않은 경우 흐름은 수집기로 내보내지 않습니다.

kubeProxyConfig

object

kubeProxyConfig를 사용하면 원하는 프록시 구성을 구성할 수 있습니다. 지정하지 않으면 OpenShift에서 직접 합리적인 기본값을 선택합니다. 모든 네트워크 공급자가 사용하지 않는 경우 현재 openshift-sdn만 사용됩니다.

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

Migration

object

마이그레이션은 클러스터 네트워크 마이그레이션을 활성화하고 구성합니다. 마이그레이션 절차를 통해 네트워크 유형 및 MTU를 변경할 수 있습니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

serviceNetwork

배열(문자열)

serviceNetwork는 현재 서비스 IP에 사용할 IP 주소 풀이며, 기존의 모든 네트워크 공급자는 여기에서 단일 값만 지원하지만 이는 성장을 허용하는 배열입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

useMultiNetworkPolicy

boolean

useMultiNetworkPolicy를 사용하면 Multus CNI에서 생성한 대로 MultiNetworkPolicy 오브젝트를 추가 네트워크에서 사용할 수 있는 컨트롤러를 사용할 수 있습니다. MultiNetworkPolicy는 NetworkPolicy 오브젝트와 유사하지만 NetworkPolicy 오브젝트는 기본 인터페이스에만 적용됩니다. MultiNetworkPolicy를 사용하면 Pod가 보조 인터페이스를 통해 수신할 수 있는 트래픽을 제어할 수 있습니다. 설정되지 않은 경우 이 속성은 기본적으로 'false' 및 MultiNetworkPolicy 개체가 무시됩니다. 'disableMultiNetwork'가 'true'이면 이 필드의 값이 무시됩니다.

21.1.2. .spec.additionalNetworks

설명
additionalNetworks는 여러 네트워크가 활성화된 경우 Pod에서 사용할 수 있도록 하는 추가 네트워크 목록입니다.
유형
array

21.1.3. .spec.additionalNetworks[]

설명
AdditionalNetworkDefinition은 사용할 수 있지만 기본적으로 생성되지 않은 추가 네트워크를 구성합니다. 대신 Pod는 이름으로 요청해야 합니다. 유형과 일치하는 정확히 하나의 "Config"와 함께 유형을 지정해야 합니다.
유형
object
속성유형설명

name

string

name은 네트워크의 이름입니다. 결과 CRD에 채워집니다. 이는 고유해야 합니다.

네임스페이스

string

네임스페이스는 네트워크의 네임스페이스입니다. 이 작업은 결과 CRD에 채워집니다. 지정하지 않으면 기본 네임스페이스에서 네트워크가 생성됩니다.

rawCNIConfig

string

rawCNIConfig는 NetworkAttachmentDefinition CRD에서 생성하는 원시 CNI 구성 json입니다.

simpleMacvlanConfig

object

SimpleMacvlanConfig type:NetworkTypeSimpleMacvlan의 경우 macvlan 인터페이스를 구성합니다.

type

string

type은 네트워크 유형입니다. 지원되는 값은 NetworkTypeRaw, NetworkTypeSimpleMacvlan입니다.

21.1.4. .spec.additionalNetworks[].simpleMacvlanConfig

설명
SimpleMacvlanConfig type:NetworkTypeSimpleMacvlan의 경우 macvlan 인터페이스를 구성합니다.
유형
object
속성유형설명

ipamConfig

object

IPAMConfig 설정 IPAM 모듈은 IPAM(IP Address Management)에 사용됩니다.

master

string

master는 macvlan 인터페이스를 생성하는 호스트 인터페이스입니다. 지정하지 않으면 기본 경로 인터페이스가 됩니다.

mode

string

mode는 macvlan 모드: bridge, private, vepa, passthru입니다. 기본값은 bridge입니다.

mtu

integer

MTU는 macvlan 인터페이스에 사용할 mtu입니다. 설정되지 않으면 호스트의 커널이 값을 선택합니다.

21.1.5. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig

설명
IPAMConfig 설정 IPAM 모듈은 IPAM(IP Address Management)에 사용됩니다.
유형
object
속성유형설명

staticIPAMConfig

object

staticIPAMConfig type:IPAMTypeStatic의 경우 고정 IP 주소를 구성

type

string

type은 IP Address Management(IPAM)에 사용되는 IPAM 모듈의 유형입니다. 지원되는 값은 IPAMTypeDHCP, IPAMTypeStatic입니다.

21.1.6. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig

설명
staticIPAMConfig type:IPAMTypeStatic의 경우 고정 IP 주소를 구성
유형
object
속성유형설명

주소

array

address는 인터페이스의 IP 주소 구성

addresses[]

object

StaticIPAMAddresses는 고정 IPAM 주소에 대한 IP 주소 및 게이트웨이 제공

dns

object

DNS는 인터페이스에 대한 DNS 구성

routes

array

경로는 인터페이스의 IP 경로 구성

routes[]

object

StaticIPAMRoutes는 고정 IPAM 경로에 대한 대상/Gateway 쌍을 제공합니다.

21.1.7. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig.addresses

설명
address는 인터페이스의 IP 주소 구성
유형
array

21.1.8. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig.addresses[]

설명
StaticIPAMAddresses는 고정 IPAM 주소에 대한 IP 주소 및 게이트웨이 제공
유형
object
속성유형설명

address

string

CIDR 형식의 IP 주소입니다.

gateway

string

게이트웨이로 지정할 서브넷 내부의 IP입니다.

21.1.9. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig.dns

설명
DNS는 인터페이스에 대한 DNS 구성
유형
object
속성유형설명

domain

string

domain은 짧은 호스트 이름 조회에 사용되는 로컬 도메인 이름 구성

네임서버

배열(문자열)

네임서버는 IP 조회를 위한 DNS 서버를 가리키기

search

배열(문자열)

검색은 짧은 호스트 이름 조회를 위해 우선순위가 지정된 검색 도메인을 구성합니다.

21.1.10. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig.routes

설명
경로는 인터페이스의 IP 경로 구성
유형
array

21.1.11. .spec.additionalNetworks[].simpleMacvlanConfig.ipamConfig.staticIPAMConfig.routes[]

설명
StaticIPAMRoutes는 고정 IPAM 경로에 대한 대상/Gateway 쌍을 제공합니다.
유형
object
속성유형설명

대상

string

목적지는 IP 경로 목적지를 가리킵니다.

gateway

string

gateway는 경로의 next-hop IP 주소인 경우 기본 게이트웨이는 ( CNI 플러그인에 의해 결정됨)이라고 가정합니다.

21.1.12. .spec.clusterNetwork

설명
clusterNetwork는 Pod IP에 사용할 IP 주소 풀입니다. OpenShift SDN과 같은 일부 네트워크 공급자는 여러 ClusterNetworks를 지원합니다. 다른 하나는 하나만 지원합니다. 이는 cluster-cidr과 동일합니다.
유형
array

21.1.13. .spec.clusterNetwork[]

설명
ClusterNetworkEntry는 PodIP를 할당할 서브넷입니다. 노드가 클러스터에 참여할 때 크기 HostPrefix(CIDR 표기법) 네트워크가 할당됩니다. 플러그인에서 HostPrefix 필드를 사용하지 않는 경우 설정되지 않은 상태로 둘 수 있습니다. 모든 네트워크 공급자가 여러 ClusterNetworks를 지원하는 것은 아닙니다.
유형
object
속성유형설명

cidr

string

 

hostPrefix

integer

 

21.1.14. .spec.defaultNetwork

설명
defaultNetwork는 모든 Pod가 수신할 "기본" 네트워크입니다.
유형
object
속성유형설명

kuryrConfig

object

KuryrConfig에서 kuryr 플러그인을 구성

openshiftSDNConfig

object

openshiftSDNConfig에서 openshift-sdn 플러그인을 구성

ovnKubernetesConfig

object

ovnKubernetesConfig는 ovn-kubernetes 플러그인을 구성합니다.

type

string

Type은 NetworkTypeRaw를 제외하고 모든 NetworkTypes가 지원되는 네트워크 유형입니다.

21.1.15. .spec.defaultNetwork.kuryrConfig

설명
KuryrConfig에서 kuryr 플러그인을 구성
유형
object
속성유형설명

controllerProbesPort

integer

kuryr-controller 포트는 준비 및 활성 요청을 수신 대기합니다.

daemonProbesPort

integer

포트 kuryr-daemon은 준비 및 활성 요청을 수신 대기합니다.

enablePortPoolsPrepopulation

boolean

true인 경우 enablePortPoolsPrepopulation을 사용하면 Kuryr가 새로 생성된 각 포트 풀을 최소 포트 수로 미리 채웁니다. Kuryr는 Neutron 포트 풀링을 사용하여 하나를 생성하는 데 상당한 시간이 걸립니다. Pod 전용 네트워크를 사용하도록 구성된 첫 번째 Pod가 네임스페이스에서 생성되고 Pod에 연결할 준비가 된 경우 여러 포트를 생성합니다. 포트 사전 채우기는 기본적으로 비활성화되어 있습니다.

mtu

integer

MTU는 Neutron에서 Pod 네트워크를 생성할 때 Kuryr가 사용해야 하는 MTU입니다. 값은 노드 네트워크의 MTU보다 낮거나 같아야 하며 Neutron은 이러한 MTU를 사용하여 테넌트 네트워크를 생성할 수 있어야 합니다. 노드 네트워크와 동일한 MTU를 사용하여 설정되지 않은 Pod 네트워크가 생성됩니다.

openStackServiceNetwork

string

openStackServiceNetwork에는 OpenStack Octavia의 Amphora VM에 IP를 할당할 네트워크의 CIDR이 포함되어 있습니다. Amphora 드라이버 Octavia는 각 로드 밸런서에 대해 해당 네트워크의 두 개의 IP를 사용합니다. 즉 OpenShift에서 제공하는 IP와 VRRP 연결에 대해 두 번째 IP를 사용합니다. 첫 번째는 OpenShift에서 관리하며, 두 번째는 Neutron의 IPAM에 의해 관리되므로 다른 풀에서 가져와야 합니다. 따라서 openStackServiceNetworkserviceNetwork 의 크기가 적어도 두 배 이상이어야 하며, 전체 serviceNetworkopenStackServiceNetwork. cluster-network-operator와 겹치지 않아야 합니다. cluster-network-operator는 serviceNetwork 와 겹치지 않는 openStackServiceNetwork 내부의 범위에서 VRRP IP를 가져와서 충돌을 방지하도록 합니다. cluster-network-operator를 설정하지 않으면 접두사 크기를 1로 감소하여 확장된 serviceNetwork 를 사용합니다.

poolBatchPorts

integer

poolBatchPorts는 포트 풀을 확장하기 위해 단일 배치 요청에서 생성해야 하는 여러 포트를 설정합니다. 기본값은 3입니다. 포트 풀에 대한 자세한 내용은 enablePortPoolsPrepopulation 설정을 참조하십시오.

poolMaxPorts

integer

poolMaxPorts는 포트 풀에 보관 중인 사용 가능한 최대 포트 수를 설정합니다. 포트 수가 이 설정을 초과하면 사용 가능한 포트가 삭제됩니다. 0을 설정하면 이 상한이 비활성화되므로 풀이 축소되지 않으며 이는 기본값입니다. 포트 풀에 대한 자세한 내용은 enablePortPoolsPrepopulation 설정을 참조하십시오.

poolMinPorts

integer

poolMinPorts는 포트 풀에 보관해야 하는 사용 가능한 최소 포트 수를 설정합니다. 포트 수가 이 설정보다 작으면 새 포트가 생성되고 풀에 추가됩니다. 기본값은 1입니다. 포트 풀에 대한 자세한 내용은 enablePortPoolsPrepopulation 설정을 참조하십시오.

21.1.16. .spec.defaultNetwork.openshiftSDNConfig

설명
openshiftSDNConfig에서 openshift-sdn 플러그인을 구성
유형
object
속성유형설명

enableUnidling

boolean

enableUnidling은 서비스 프록시가 서비스 유휴 상태 지정 및 유휴 상태 해제를 지원하는지 여부를 제어합니다. 기본적으로 해제는 활성화되어 있습니다.

mode

string

모드는 "Multitenant", "Subnet" 또는 "NetworkPolicy" 중 하나입니다.

mtu

integer

MTU는 터널 인터페이스에 사용할 mtu입니다. 설정되지 않은 경우 기본값은 1450입니다. 머신의 uplink보다 50바이트 작아야 합니다.

useExternalOpenvswitch

boolean

Operator가 OVS DaemonSet 자체를 배포할지 아니면 다른 사용자가 OVS를 시작할 것으로 예상되는지 여부를 제어하는 데 사용되는ExternalOpenvswitch를 사용합니다. 4.6부터 OVS는 항상 시스템 서비스로 실행되며 이 플래그는 무시됩니다. DEPRECATED: 4.6에서 작동하지 않음

vxlanPort

integer

vxlanPort는 모든 vxlan 패킷에 사용할 포트입니다. 기본값은 4789입니다.

21.1.17. .spec.defaultNetwork.ovnKubernetesConfig

설명
ovnKubernetesConfig는 ovn-kubernetes 플러그인을 구성합니다.
유형
object
속성유형설명

egressIPConfig

object

egressIPConfig에는 EgressIP 옵션에 대한 구성이 있습니다.

gatewayConfig

object

gatewayConfig에는 노드 게이트웨이 옵션에 대한 구성이 있습니다.

genevePort

integer

Geneve 포트는genve 캡슐화에서 사용할 UDP 포트입니다. 기본값은 6081입니다.

hybridOverlayConfig

object

HybridOverlayConfig는 OVN을 사용하지 않는 피어에 대해 추가 오버레이 네트워크를 구성합니다.

ipsecConfig

object

ipsecConfig는 클러스터 내의 Pod 네트워크에서 Pod에 대해 IPsec을 활성화하고 구성합니다.

mtu

integer

MTU는 터널 인터페이스에 사용할 MTU입니다. 이는 uplink mtu보다 작은 100바이트여야 합니다. 기본값은 1400입니다.

policyAuditConfig

object

policyAuditConfig는 네트워크 정책 감사 이벤트의 구성입니다. 설정되지 않은 경우 보고된 기본값이 사용됩니다.

v4InternalSubnet

string

v4InternalSubnet은 기본 항목이 이미 다른 항목에서 이미 사용 중인 경우 ovn-kubernetes에서 내부적으로 사용하는 v4 서브넷입니다. OpenShift에서 사용하거나 노드 네트워크에서 사용하는 다른 서브넷과 겹치지 않아야 합니다. 서브넷의 크기는 노드 수보다 커야 합니다. 설치 후에는 값을 변경할 수 없습니다. 기본값은 100.64.0.0/16입니다.

v6InternalSubnet

string

v6InternalSubnet은 기본 항목이 이미 다른 항목에서 이미 사용 중인 경우 ovn-kubernetes에서 내부적으로 사용하는 v6 서브넷입니다. OpenShift에서 사용하거나 노드 네트워크에서 사용하는 다른 서브넷과 겹치지 않아야 합니다. 서브넷의 크기는 노드 수보다 커야 합니다. 설치 후에는 값을 변경할 수 없습니다. 기본값은 fd98::/48입니다.

21.1.18. .spec.defaultNetwork.ovnKubernetesConfig.egressIPConfig

설명
egressIPConfig에는 EgressIP 옵션에 대한 구성이 있습니다.
유형
object
속성유형설명

reachabilityTotalTimeoutSeconds

integer

reachabilityTotalTimeout은 EgressIP 노드 도달 가능성 점검 총 시간(초)을 구성합니다. 이 시간 초과 내에 EgressIP 노드에 도달할 수 없는 경우 노드가 다운됩니다. 큰 값을 설정하면 EgressIP 기능이 노드 변경에 천천히 반응할 수 있습니다. 특히 실제 문제가 있고 연결할 수 없는 EgressIP 노드에 대해 천천히 대응할 수 있습니다. 생략하면 사용자에게 의견이 없으며 플랫폼은 시간이 지남에 따라 변경될 수 있는 적절한 기본값을 선택할 수 있습니다. 현재 기본값은 1초입니다. 값이 0이면 EgressIP 노드의 연결 가능성 검사를 비활성화합니다.

21.1.19. .spec.defaultNetwork.ovnKubernetesConfig.gatewayConfig

설명
gatewayConfig에는 노드 게이트웨이 옵션에 대한 구성이 있습니다.
유형
object
속성유형설명

routingViaHost

boolean

routingViaHost를 사용하면 Pod 송신 트래픽이 ovn-k8s-mp0 관리 포트를 통해 호스트에 전송될 수 있습니다. 이 값을 설정하지 않으면 트래픽이 항상 OVN에서 호스트 스택을 건드리지 않고 외부로 직접 송신됩니다. true로 설정하면 하드웨어 오프로드가 지원되지 않습니다. GatewayConfig가 지정된 경우 기본값은 false입니다.

21.1.20. .spec.defaultNetwork.ovnKubernetesConfig.hybridOverlayConfig

설명
HybridOverlayConfig는 OVN을 사용하지 않는 피어에 대해 추가 오버레이 네트워크를 구성합니다.
유형
object
속성유형설명

hybridClusterNetwork

array

hybridClusterNetwork는 추가 오버레이 네트워크의 노드에 지정된 네트워크 공간을 정의합니다.

hybridClusterNetwork[]

object

ClusterNetworkEntry는 PodIP를 할당할 서브넷입니다. 노드가 클러스터에 참여할 때 크기 HostPrefix(CIDR 표기법) 네트워크가 할당됩니다. 플러그인에서 HostPrefix 필드를 사용하지 않는 경우 설정되지 않은 상태로 둘 수 있습니다. 모든 네트워크 공급자가 여러 ClusterNetworks를 지원하는 것은 아닙니다.

hybridOverlayVXLANPort

integer

hybridOverlayVXLANPort는 추가 오버레이 네트워크에서 사용할 VXLAN 포트 번호를 정의합니다. 기본값은 4789입니다.

21.1.21. .spec.defaultNetwork.ovnKubernetesConfig.hybridOverlayConfig.hybridClusterNetwork

설명
hybridClusterNetwork는 추가 오버레이 네트워크의 노드에 지정된 네트워크 공간을 정의합니다.
유형
array

21.1.22. .spec.defaultNetwork.ovnKubernetesConfig.hybridOverlayConfig.hybridClusterNetwork[]

설명
ClusterNetworkEntry는 PodIP를 할당할 서브넷입니다. 노드가 클러스터에 참여할 때 크기 HostPrefix(CIDR 표기법) 네트워크가 할당됩니다. 플러그인에서 HostPrefix 필드를 사용하지 않는 경우 설정되지 않은 상태로 둘 수 있습니다. 모든 네트워크 공급자가 여러 ClusterNetworks를 지원하는 것은 아닙니다.
유형
object
속성유형설명

cidr

string

 

hostPrefix

integer

 

21.1.23. .spec.defaultNetwork.ovnKubernetesConfig.ipsecConfig

설명
ipsecConfig는 클러스터 내의 Pod 네트워크에서 Pod에 대해 IPsec을 활성화하고 구성합니다.
유형
object

21.1.24. .spec.defaultNetwork.ovnKubernetesConfig.policyAuditConfig

설명
policyAuditConfig는 네트워크 정책 감사 이벤트의 구성입니다. 설정되지 않은 경우 보고된 기본값이 사용됩니다.
유형
object
속성유형설명

대상

string

destination은 정책 로그 메시지의 위치입니다. 이 구성과 관계없이 영구 로그는 항상 /var/log/ovn/의 호스트에 덤프되지만 추가 syslog 출력은 다음과 같이 구성할 수 있습니다. 유효한 값은 다음과 같습니다. - "libc" → 호스트 노드의 jourald 프로세스의 libc syslog() 함수를 사용하는 - "udp:host:port" → UDP를 통해 syslog를 전송하는 경우 - "unix:file" → 직접 UNIX 도메인 소켓을 사용하는 경우 - "null"은 syslog에 로그인한 모든 메시지를 "null"입니다.

maxFileSize

integer

maxFilesSize는 순환이 수행되기 전에 ACL_audit 로그 파일에 연결할 수 있는 최대 크기이며 기본값은 50MB입니다.

rateLimit

integer

rateLimit는 노드당 초당 생성할 대략적인 최대 메시지 수입니다. 설정되지 않은 경우 기본값은 20 msg/sec입니다.

syslogFacility

string

생성된 메시지에 대한 RFC5424 기능(예: "kern" 등)을 syslogFacility로 설정합니다. 기본값은 "local0"입니다.

21.1.25. .spec.exportNetworkFlows

설명
exportNetworkFlows는 NetFlow, SFlow 또는 IPFIX 프로토콜을 사용하여 Pod 네트워크에서 네트워크 흐름 메타데이터의 내보내기를 활성화하고 구성합니다. 현재 OVN-Kubernetes 플러그인에서만 지원됩니다. 설정되지 않은 경우 흐름은 수집기로 내보내지 않습니다.
유형
object
속성유형설명

ipfix

object

IPFIX는 IPFIX 구성을 정의합니다.

netFlow

object

NetFlow는 NetFlow 구성을 정의합니다.

sFlow

object

sFlow는 SFlow 구성을 정의합니다.

21.1.26. .spec.exportNetworkFlows.ipfix

설명
IPFIX는 IPFIX 구성을 정의합니다.
유형
object
속성유형설명

수집기

배열(문자열)

ipfixCollectors는 ip:port 최대 10개의 항목으로 포맷된 문자열 목록입니다.

21.1.27. .spec.exportNetworkFlows.netFlow

설명
NetFlow는 NetFlow 구성을 정의합니다.
유형
object
속성유형설명

수집기

배열(문자열)

NetFlow는 OVS에서 내보낸 흐름 데이터를 사용할 NetFlow 수집기를 정의합니다. 최대 10개의 항목이 있는 ip:port로 포맷된 문자열 목록입니다.

21.1.28. .spec.exportNetworkFlows.sFlow

설명
sFlow는 SFlow 구성을 정의합니다.
유형
object
속성유형설명

수집기

배열(문자열)

sFlowCollectors는 ip:port 최대 10개의 항목으로 포맷된 문자열 목록입니다.

21.1.29. .spec.kubeProxyConfig

설명
kubeProxyConfig를 사용하면 원하는 프록시 구성을 구성할 수 있습니다. 지정하지 않으면 OpenShift에서 직접 합리적인 기본값을 선택합니다. 모든 네트워크 공급자가 사용하지 않는 경우 현재 openshift-sdn만 사용됩니다.
유형
object
속성유형설명

bindAddress

string

Defaults to 0.0.0.0의 "바인딩" 주소입니다.

iptablesSyncPeriod

string

내부 kube-proxy 매개변수입니다. 이전 릴리스의 OCP에서는 성능상의 이유로 대규모 클러스터에서 조정해야 하지만 더 이상 필요하지 않으며 기본값에서 이 값을 변경할 이유가 없습니다. 기본값: 30s

proxyArguments

object

kubeproxy 프로세스에 전달할 추가 인수

proxyArguments{}

배열(문자열)

ProxyArgumentList는 kubeproxy 프로세스에 전달할 인수 목록입니다.

21.1.30. .spec.kubeProxyConfig.proxyArguments

설명
kubeproxy 프로세스에 전달할 추가 인수
유형
object

21.1.31. .spec.migration

설명
마이그레이션은 클러스터 네트워크 마이그레이션을 활성화하고 구성합니다. 마이그레이션 절차를 통해 네트워크 유형 및 MTU를 변경할 수 있습니다.
유형
object
속성유형설명

features

object

기능에는 기능 마이그레이션 구성이 포함되어 있습니다. 클러스터 기본 네트워크 공급자를 변경할 때 기능 구성을 마이그레이션하도록 설정합니다. 설정되지 않은 경우 기본 작업은 지원되는 기능의 모든 구성을 마이그레이션하는 것입니다.

mtu

object

MTU에는 MTU 마이그레이션 구성이 포함되어 있습니다. 기본 네트워크의 MTU 값을 변경할 수 있도록 이 설정을 설정합니다. 설정되지 않으면 기본 네트워크의 MTU 변경 작업이 거부됩니다.

networkType

string

networkType은 네트워크 마이그레이션의 대상 유형입니다. 기본 네트워크 변경을 허용하려면 대상 네트워크 유형으로 설정합니다. 설정되지 않은 경우 클러스터 기본 네트워크 플러그인 변경 작업이 거부됩니다. 지원되는 값은 OpenShiftSDN, OVNKubernetes입니다.

21.1.32. .spec.migration.features

설명
기능에는 기능 마이그레이션 구성이 포함되어 있습니다. 클러스터 기본 네트워크 공급자를 변경할 때 기능 구성을 마이그레이션하도록 설정합니다. 설정되지 않은 경우 기본 작업은 지원되는 기능의 모든 구성을 마이그레이션하는 것입니다.
유형
object
속성유형설명

egressFirewall

boolean

EgressFirewall은 클러스터 기본 네트워크 공급자를 변경할 때 Egress Firewall 구성이 자동으로 마이그레이션되는지 여부를 지정합니다. 설정되지 않은 경우 이 속성은 기본적으로 'true'로 설정되고 Egress Firewall configure가 마이그레이션됩니다.

egressIP

boolean

EgressIP는 클러스터 기본 네트워크 공급자를 변경할 때 Egress IP 구성이 자동으로 마이그레이션되는지 여부를 지정합니다. 설정되지 않은 경우 이 속성은 기본적으로 'true'로 설정되고 Egress IP 구성이 마이그레이션됩니다.

멀티 캐스트

boolean

멀티 캐스트는 클러스터 기본 네트워크 공급자를 변경할 때 멀티캐스트 구성이 자동으로 마이그레이션되는지 여부를 지정합니다. 설정되지 않은 경우 이 속성은 기본적으로 'true'로 설정되고 멀티캐스트 구성이 마이그레이션됩니다.

21.1.33. .spec.migration.mtu

설명
MTU에는 MTU 마이그레이션 구성이 포함되어 있습니다. 기본 네트워크의 MTU 값을 변경할 수 있도록 이 설정을 설정합니다. 설정되지 않으면 기본 네트워크의 MTU 변경 작업이 거부됩니다.
유형
object
속성유형설명

머신

object

머신에는 머신의 uplink에 대한 MTU 마이그레이션 구성이 포함되어 있습니다. 현재 uplink MTU가 기본 네트워크 MTU를 이미 수용하지 않는 한 기본 네트워크 MTU와 함께 마이그레이션해야 합니다.

network

object

네트워크에는 기본 네트워크의 MTU 마이그레이션에 대한 정보가 포함되어 있습니다. 마이그레이션은 최소 적절한 오프셋을 통해 머신의 uplink MTU보다 낮은 MTU 값으로만 허용됩니다.

21.1.34. .spec.migration.mtu.machine

설명
머신에는 머신의 uplink에 대한 MTU 마이그레이션 구성이 포함되어 있습니다. 현재 uplink MTU가 기본 네트워크 MTU를 이미 수용하지 않는 한 기본 네트워크 MTU와 함께 마이그레이션해야 합니다.
유형
object
속성유형설명

from

integer

에서 마이그레이션할 MTU입니다.

다음으로 변경

integer

마이그레이션할 MTU입니다.

21.1.35. .spec.migration.mtu.network

설명
네트워크에는 기본 네트워크의 MTU 마이그레이션에 대한 정보가 포함되어 있습니다. 마이그레이션은 최소 적절한 오프셋을 통해 머신의 uplink MTU보다 낮은 MTU 값으로만 허용됩니다.
유형
object
속성유형설명

from

integer

에서 마이그레이션할 MTU입니다.

다음으로 변경

integer

마이그레이션할 MTU입니다.

21.1.36. .status

설명
NetworkStatus는 네트워크 clusteroperator 개체까지 해체되는 자세한 Operator 상태입니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

21.1.37. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

21.1.38. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

21.1.39. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

21.1.40. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

21.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/operator.openshift.io/v1/networks

    • DELETE: Network 컬렉션 삭제
    • GET: 종류의 객체 목록 네트워크
    • POST: 네트워크를 생성
  • /apis/operator.openshift.io/v1/networks/{name}

    • DELETE: 네트워크 삭제
    • GET: 지정된 네트워크 읽기
    • PATCH: 지정된 네트워크를 부분적으로 업데이트
    • PUT: 지정된 네트워크를 교체

21.2.1. /apis/operator.openshift.io/v1/networks

표 21.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
네트워크 컬렉션 삭제
표 21.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을 지정합니다.

표 21.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
네트워크 유형의 오브젝트 나열
표 21.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을 지정합니다.

표 21.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

NetworkList 스키마

401 - 무단

HTTP 방법
POST
설명
네트워크 생성
표 21.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 21.7. 본문 매개변수
매개변수유형설명

body

네트워크 스키마

 
표 21.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

네트워크 스키마

201 - 생성됨

네트워크 스키마

202 - 승인됨

네트워크 스키마

401 - 무단

21.2.2. /apis/operator.openshift.io/v1/networks/{name}

표 21.9. 글로벌 경로 매개변수
매개변수유형설명

name

string

네트워크 이름

표 21.10. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
네트워크 삭제
표 21.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 21.12. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 21.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 네트워크 읽기
표 21.14. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 21.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

네트워크 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 네트워크를 부분적으로 업데이트
표 21.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 21.17. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 21.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

네트워크 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 네트워크를 교체
표 21.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 21.20. 본문 매개변수
매개변수유형설명

body

네트워크 스키마

 
표 21.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

네트워크 스키마

201 - 생성됨

네트워크 스키마

401 - 무단

22장. OpenShiftAPIServer [operator.openshift.io/v1]

설명
openshiftapiserver는 openshift-apiserver를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

22.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

spec은 OpenShift API Server의 원하는 동작의 사양입니다.

status

object

status는 OpenShift API Server의 관찰 상태를 정의합니다.

22.1.1. .spec

설명
spec은 OpenShift API Server의 원하는 동작의 사양입니다.
유형
object
속성유형설명

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

22.1.2. .status

설명
status는 OpenShift API Server의 관찰 상태를 정의합니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

latestAvailableRevision

integer

latestAvailableRevision은 encryption-config와 같은 버전이 지정된 보안의 접미사로 사용되는 최신 버전입니다. 새 버전으로 인해 Pod가 새로 배포됩니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

22.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

22.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

22.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

22.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

22.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/operator.openshift.io/v1/openshiftapiservers

    • DELETE: OpenShiftAPIServer의 컬렉션 삭제
    • GET: 종류의 OpenShiftAPIServer 오브젝트 나열
    • POST: OpenShiftAPIServer 생성
  • /apis/operator.openshift.io/v1/openshiftapiservers/{name}

    • DELETE: OpenShiftAPIServer 삭제
    • GET: 지정된 OpenShiftAPIServer 읽기
    • PATCH: 지정된 OpenShiftAPIServer를 부분적으로 업데이트
    • PUT: 지정된 OpenShiftAPIServer를 교체
  • /apis/operator.openshift.io/v1/openshiftapiservers/{name}/status

    • GET: 지정된 OpenShiftAPIServer의 읽기 상태
    • PATCH: 지정된 OpenShiftAPIServer의 부분적으로 업데이트 상태
    • PUT: 지정된 OpenShiftAPIServer의 상태 교체

22.2.1. /apis/operator.openshift.io/v1/openshiftapiservers

표 22.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
OpenShiftAPIServer의 컬렉션 삭제
표 22.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을 지정합니다.

표 22.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
OpenShiftAPIServer 유형의 오브젝트 나열
표 22.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을 지정합니다.

표 22.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OpenShiftAPIServerList schema

401 - 무단

HTTP 방법
POST
설명
OpenShiftAPIServer 생성
표 22.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 22.7. 본문 매개변수
매개변수유형설명

body

OpenShiftAPIServer schema

 
표 22.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OpenShiftAPIServer schema

201 - 생성됨

OpenShiftAPIServer schema

202 - 승인됨

OpenShiftAPIServer schema

401 - 무단

22.2.2. /apis/operator.openshift.io/v1/openshiftapiservers/{name}

표 22.9. 글로벌 경로 매개변수
매개변수유형설명

name

string

OpenShiftAPIServer의 이름

표 22.10. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
OpenShiftAPIServer 삭제
표 22.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 22.12. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 22.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 OpenShiftAPIServer 읽기
표 22.14. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 22.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

openshiftapiserver 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 OpenShiftAPIServer를 부분적으로 업데이트
표 22.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 22.17. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 22.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

openshiftapiserver 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 OpenShiftAPIServer를 교체
표 22.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 22.20. 본문 매개변수
매개변수유형설명

body

openshiftapiserver 스키마

 
표 22.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

openshiftapiserver 스키마

201 - 생성됨

openshiftapiserver 스키마

401 - 무단

22.2.3. /apis/operator.openshift.io/v1/openshiftapiservers/{name}/status

표 22.22. 글로벌 경로 매개변수
매개변수유형설명

name

string

OpenShiftAPIServer의 이름

표 22.23. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 OpenShiftAPIServer의 읽기 상태
표 22.24. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 22.25. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

openshiftapiserver 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 OpenShiftAPIServer의 부분적으로 업데이트 상태
표 22.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 22.27. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 22.28. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

openshiftapiserver 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 OpenShiftAPIServer의 상태 교체
표 22.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 22.30. 본문 매개변수
매개변수유형설명

body

openshiftapiserver 스키마

 
표 22.31. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

openshiftapiserver 스키마

201 - 생성됨

openshiftapiserver 스키마

401 - 무단

23장. OpenShiftControllerManager [operator.openshift.io/v1]

설명
OpenShiftControllerManager는 openshift-controller-manager를 관리하도록 Operator를 구성하는 정보를 제공합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

23.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

 

23.1.1. .spec

설명
유형
object
속성유형설명

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

23.1.2. .status

설명
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

23.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

23.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

23.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

23.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

23.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/operator.openshift.io/v1/openshiftcontrollermanagers

    • DELETE: OpenShiftControllerManager의 컬렉션 삭제
    • GET: 종류의 오브젝트 나열 OpenShiftControllerManager
    • POST: OpenShiftControllerManager 생성
  • /apis/operator.openshift.io/v1/openshiftcontrollermanagers/{name}

    • DELETE: delete an OpenShiftControllerManager
    • GET: 지정된 OpenShiftControllerManager 읽기
    • PATCH: 지정된 OpenShiftControllerManager를 부분적으로 업데이트
    • PUT: 지정된 OpenShiftControllerManager를 교체합니다.
  • /apis/operator.openshift.io/v1/openshiftcontrollermanagers/{name}/status

    • GET: 지정된 OpenShiftControllerManager의 읽기 상태
    • PATCH: 지정된 OpenShiftControllerManager의 부분적으로 업데이트 상태
    • PUT: 지정된 OpenShiftControllerManager의 상태 교체

23.2.1. /apis/operator.openshift.io/v1/openshiftcontrollermanagers

표 23.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
OpenShiftControllerManager의 컬렉션 삭제
표 23.2. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 23.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
OpenShiftControllerManager 유형의 오브젝트 나열
표 23.4. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 23.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OpenShiftControllerManagerList schema

401 - 무단

HTTP 방법
POST
설명
OpenShiftControllerManager 생성
표 23.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 23.7. 본문 매개변수
매개변수유형설명

body

OpenShiftControllerManager schema

 
표 23.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OpenShiftControllerManager schema

201 - 생성됨

OpenShiftControllerManager schema

202 - 승인됨

OpenShiftControllerManager schema

401 - 무단

23.2.2. /apis/operator.openshift.io/v1/openshiftcontrollermanagers/{name}

표 23.9. 글로벌 경로 매개변수
매개변수유형설명

name

string

OpenShiftControllerManager의 이름

표 23.10. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
delete an OpenShiftControllerManager
표 23.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 23.12. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 23.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 OpenShiftControllerManager 읽기
표 23.14. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 23.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OpenShiftControllerManager schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 OpenShiftControllerManager를 부분적으로 업데이트
표 23.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 23.17. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 23.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OpenShiftControllerManager schema

401 - 무단

HTTP 방법
PUT
설명
지정된 OpenShiftControllerManager를 교체
표 23.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 23.20. 본문 매개변수
매개변수유형설명

body

OpenShiftControllerManager schema

 
표 23.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OpenShiftControllerManager schema

201 - 생성됨

OpenShiftControllerManager schema

401 - 무단

23.2.3. /apis/operator.openshift.io/v1/openshiftcontrollermanagers/{name}/status

표 23.22. 글로벌 경로 매개변수
매개변수유형설명

name

string

OpenShiftControllerManager의 이름

표 23.23. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 OpenShiftControllerManager의 읽기 상태
표 23.24. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 23.25. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OpenShiftControllerManager schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 OpenShiftControllerManager의 부분적으로 업데이트 상태
표 23.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 23.27. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 23.28. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OpenShiftControllerManager schema

401 - 무단

HTTP 방법
PUT
설명
지정된 OpenShiftControllerManager의 상태 교체
표 23.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 23.30. 본문 매개변수
매개변수유형설명

body

OpenShiftControllerManager schema

 
표 23.31. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OpenShiftControllerManager schema

201 - 생성됨

OpenShiftControllerManager schema

401 - 무단

24장. OperatorPKI [network.operator.openshift.io/v1]

설명
OperatorPKI는 간단한 인증 기관입니다. 외부 사용을 위한 것이 아니라 네트워크 운영자의 내부입니다. CNO는 CA 및 해당 CA에서 서명한 인증서를 생성합니다. 인증서에는 ClientAuth 및 ServerAuth 확장 사용이 모두 활성화되어 있습니다. 특히, <name>이 있는 OperatorPKI - CNO는 두 개의 데이터 키가 있는 <name>-ca라는 시크릿을 관리합니다. - tls.key - 개인 키 - 개인 키 - TLS.crt - CA 인증서 - 단일 데이터 키가 있는 <name>-ca라는 ConfigMap - - cabundle.crt - the CA certificate(s) - <name>-cert라는 두 개의 키 - tls - tls - certificate - 인증서가 있습니다. CA에서 서명한 CA 인증서의 유효성은 10년 후 순환됩니다. 대상 인증서의 유효 기간은 6개월이며 3개월 후에 CA 인증서의 일반 이름 "<namespace>_<name>-ca@<timestamp>"를 사용합니다. 여기서 <timestamp>는 마지막 순환 시간입니다.
유형
object
필수 항목
  • spec

24.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

OperatorPKISpec은 PKI 구성입니다.

status

object

OperatorPKIStatus가 구현되지 않았습니다.

24.1.1. .spec

설명
OperatorPKISpec은 PKI 구성입니다.
유형
object
필수 항목
  • targetCert
속성유형설명

targetCert

object

targetCert는 CA에서 서명한 인증서를 구성합니다. ClientAuth 및 ServerAuth가 모두 활성화되어 있습니다.

24.1.2. .spec.targetCert

설명
targetCert는 CA에서 서명한 인증서를 구성합니다. ClientAuth 및 ServerAuth가 모두 활성화되어 있습니다.
유형
object
필수 항목
  • commonName
속성유형설명

commonName

string

CommonName은 인증서의 CN 값입니다.

24.1.3. .status

설명
OperatorPKIStatus가 구현되지 않았습니다.
유형
object

24.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/network.operator.openshift.io/v1/operatorpkis

    • GET: 종류의 OperatorPKI의 오브젝트 나열
  • /apis/network.operator.openshift.io/v1/namespaces/{namespace}/operatorpkis

    • DELETE: OperatorPKI의 컬렉션 삭제
    • GET: 종류의 OperatorPKI의 오브젝트 나열
    • POST: OperatorPKI 생성
  • /apis/network.operator.openshift.io/v1/namespaces/{namespace}/operatorpkis/{name}

    • DELETE: OperatorPKI 삭제
    • GET: 지정된 OperatorPKI 읽기
    • PATCH: 지정된 OperatorPKI를 부분적으로 업데이트
    • PUT: 지정된 OperatorPKI를 교체합니다.

24.2.1. /apis/network.operator.openshift.io/v1/operatorpkis

표 24.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
OperatorPKI 유형의 오브젝트 나열
표 24.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OperatorPKIList 스키마

401 - 무단

24.2.2. /apis/network.operator.openshift.io/v1/namespaces/{namespace}/operatorpkis

표 24.3. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 24.4. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
OperatorPKI 컬렉션 삭제
표 24.5. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 24.6. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
OperatorPKI 유형의 오브젝트 나열
표 24.7. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 24.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OperatorPKIList 스키마

401 - 무단

HTTP 방법
POST
설명
OperatorPKI 생성
표 24.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 24.10. 본문 매개변수
매개변수유형설명

body

OperatorPKI 스키마

 
표 24.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OperatorPKI 스키마

201 - 생성됨

OperatorPKI 스키마

202 - 승인됨

OperatorPKI 스키마

401 - 무단

24.2.3. /apis/network.operator.openshift.io/v1/namespaces/{namespace}/operatorpkis/{name}

표 24.12. 글로벌 경로 매개변수
매개변수유형설명

name

string

OperatorPKI 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 24.13. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
OperatorPKI 삭제
표 24.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 24.15. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 24.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 OperatorPKI 읽기
표 24.17. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 24.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OperatorPKI 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 OperatorPKI를 부분적으로 업데이트
표 24.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 24.20. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 24.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OperatorPKI 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 OperatorPKI를 교체
표 24.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 24.23. 본문 매개변수
매개변수유형설명

body

OperatorPKI 스키마

 
표 24.24. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OperatorPKI 스키마

201 - 생성됨

OperatorPKI 스키마

401 - 무단

25장. ServiceCA [operator.openshift.io/v1]

설명
ServiceCA는 서비스 인증서 컨트롤러 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있도록 Operator를 구성하는 정보를 제공합니다.
유형
object
필수 항목
  • spec

25.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

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

25.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

25.1.2. .status

설명
status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

25.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

25.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

25.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

25.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

25.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/operator.openshift.io/v1/servicecas

    • DELETE: ServiceCA의 컬렉션 삭제
    • GET: ServiceCA 유형의 오브젝트 나열
    • POST: ServiceCA 생성
  • /apis/operator.openshift.io/v1/servicecas/{name}

    • DELETE: ServiceCA 삭제
    • GET: 지정된 ServiceCA 읽기
    • PATCH: 지정된 ServiceCA를 부분적으로 업데이트
    • PUT: 지정된 ServiceCA를 교체
  • /apis/operator.openshift.io/v1/servicecas/{name}/status

    • GET: 지정된 ServiceCA의 읽기 상태
    • PATCH: 지정된 ServiceCA의 부분적으로 업데이트 상태
    • PUT: 지정된 ServiceCA의 상태

25.2.1. /apis/operator.openshift.io/v1/servicecas

표 25.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
ServiceCA 컬렉션 삭제
표 25.2. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 25.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ServiceCA 유형의 오브젝트 나열
표 25.4. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 25.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ServiceCAList 스키마

401 - 무단

HTTP 방법
POST
설명
ServiceCA 생성
표 25.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 25.7. 본문 매개변수
매개변수유형설명

body

ServiceCA 스키마

 
표 25.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ServiceCA 스키마

201 - 생성됨

ServiceCA 스키마

202 - 승인됨

ServiceCA 스키마

401 - 무단

25.2.2. /apis/operator.openshift.io/v1/servicecas/{name}

표 25.9. 글로벌 경로 매개변수
매개변수유형설명

name

string

ServiceCA 이름

표 25.10. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
delete a ServiceCA
표 25.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 25.12. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 25.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ServiceCA 읽기
표 25.14. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 25.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ServiceCA schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 ServiceCA를 부분적으로 업데이트
표 25.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 25.17. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 25.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ServiceCA schema

401 - 무단

HTTP 방법
PUT
설명
지정된 ServiceCA를 교체
표 25.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 25.20. 본문 매개변수
매개변수유형설명

body

ServiceCA schema

 
표 25.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ServiceCA schema

201 - 생성됨

ServiceCA schema

401 - 무단

25.2.3. /apis/operator.openshift.io/v1/servicecas/{name}/status

표 25.22. 글로벌 경로 매개변수
매개변수유형설명

name

string

ServiceCA 이름

표 25.23. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 ServiceCA의 읽기 상태
표 25.24. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 25.25. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ServiceCA schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 ServiceCA의 부분적으로 업데이트 상태
표 25.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 25.27. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 25.28. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ServiceCA schema

401 - 무단

HTTP 방법
PUT
설명
지정된 ServiceCA의 상태 교체
표 25.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 25.30. 본문 매개변수
매개변수유형설명

body

ServiceCA 스키마

 
표 25.31. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ServiceCA 스키마

201 - 생성됨

ServiceCA 스키마

401 - 무단

26장. 스토리지 [operator.openshift.io/v1]

설명
스토리지는 클러스터 스토리지 Operator를 관리하도록 운영자를 구성하는 수단을 제공합니다. Cluster 는 정식 이름입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

26.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

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

26.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

logLevel

string

로그 수준은 전체 구성 요소에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 Operator가 피연산자에 대해 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

managementState

string

managementState는 운영자가 구성 요소를 관리하는지 여부와 방법을 나타냅니다.

observedConfig

``

observedConfig에는 컨트롤러가 클러스터 상태에서 관찰한 스파스 구성이 있습니다. 이는 Operator의 수준에 대한 입력이기 때문에 spec에 존재합니다.

operatorLogLevel

string

operatorLogLevel은 Operator 자체에 대한 의도 기반 로깅입니다. 이는 세분화된 제어를 제공하지 않지만 운영자가 자체적으로 해석해야 하는 집계된 로깅 옵션을 관리하는 간단한 방법입니다. 유효한 값은 "Normal", "Debug", "Trace", "TraceAll"입니다. 기본값은 "Normal"입니다.

unsupportedConfigOverrides

``

unsupportedConfigOverrides에는 이전에 설정된 옵션을 덮어쓰는 스파스 구성이 있습니다. 덮어쓰는 필드만 있으면 됩니다. 오버레이가 다음과 같은 순서로 끝납니다. 1. 하드 코딩된 기본값 2. observedConfig 3. unsupportedConfigOverrides

26.1.2. .status

설명
status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

OperatorCondition은 표준 조건 필드입니다.

생성

array

세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.

generations[]

object

GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대의 변경 사항입니다.

readyReplicas

integer

readyReplicas는 준비된 복제본 수와 원하는 상태를 나타냅니다.

version

string

버전이 이 가용성이 적용되는 수준입니다.

26.1.3. .status.conditions

설명
conditions는 조건 및 상태 목록입니다.
유형
array

26.1.4. .status.conditions[]

설명
OperatorCondition은 표준 조건 필드입니다.
유형
object
속성유형설명

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

26.1.5. .status.generations

설명
세대는 항목이 조정되어야 하거나 반응이 필요한 방식으로 변경된 시기를 결정하는 데 사용됩니다.
유형
array

26.1.6. .status.generations[]

설명
GenerationStatus는 지정된 리소스의 생성을 추적하여 강제 업데이트에 대한 결정을 내릴 수 있습니다.
유형
object
속성유형설명

group

string

그룹은 추적 중인 항목의 그룹입니다.

hash

string

hash는 시크릿 및 configmaps와 같이 민감한 콘텐츠인 생성이 없는 리소스에 대해 설정된 선택적 필드입니다.

lastGeneration

integer

lastGeneration은 관련된 워크로드 컨트롤러의 마지막 생성입니다.

name

string

추적 중인 항목의 이름입니다.Is the name of the item you are tracking

네임스페이스

string

namespace is where you're tracking is where you're tracking is where you're tracking is where you're tracking

resource

string

리소스는 추적 중인 항목의 리소스 유형입니다.

26.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/operator.openshift.io/v1/storages

    • DELETE: 스토리지 컬렉션 삭제
    • GET: 종류의 스토리지 오브젝트 나열
    • POST: 스토리지 생성
  • /apis/operator.openshift.io/v1/storages/{name}

    • DELETE: 스토리지 삭제
    • GET: 지정된 스토리지 읽기
    • PATCH: 지정된 스토리지를 부분적으로 업데이트
    • PUT: 지정된 스토리지를 교체
  • /apis/operator.openshift.io/v1/storages/{name}/status

    • GET: 지정된 스토리지의 읽기 상태
    • PATCH: 지정된 스토리지의 부분적으로 업데이트 상태
    • PUT: 지정된 스토리지의 상태

26.2.1. /apis/operator.openshift.io/v1/storages

표 26.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
스토리지 컬렉션 삭제
표 26.2. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 26.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류의 스토리지 오브젝트 나열
표 26.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을 지정합니다.

표 26.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

StorageList 스키마

401 - 무단

HTTP 방법
POST
설명
스토리지 생성
표 26.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 26.7. 본문 매개변수
매개변수유형설명

body

스토리지 스키마

 
표 26.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스토리지 스키마

201 - 생성됨

스토리지 스키마

202 - 승인됨

스토리지 스키마

401 - 무단

26.2.2. /apis/operator.openshift.io/v1/storages/{name}

표 26.9. 글로벌 경로 매개변수
매개변수유형설명

name

string

스토리지의 이름

표 26.10. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
스토리지 삭제
표 26.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' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 26.12. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 26.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 스토리지 읽기
표 26.14. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 26.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스토리지 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 스토리지를 부분적으로 업데이트
표 26.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 26.17. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 26.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스토리지 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 스토리지 교체
표 26.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 26.20. 본문 매개변수
매개변수유형설명

body

스토리지 스키마

 
표 26.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스토리지 스키마

201 - 생성됨

스토리지 스키마

401 - 무단

26.2.3. /apis/operator.openshift.io/v1/storages/{name}/status

표 26.22. 글로벌 경로 매개변수
매개변수유형설명

name

string

스토리지의 이름

표 26.23. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 스토리지의 읽기 상태
표 26.24. 쿼리 매개변수
매개변수유형설명

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

표 26.25. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스토리지 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 스토리지의 부분적으로 업데이트 상태
표 26.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 26.27. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 26.28. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스토리지 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 스토리지의 상태 교체
표 26.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 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 26.30. 본문 매개변수
매개변수유형설명

body

스토리지 스키마

 
표 26.31. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스토리지 스키마

201 - 생성됨

스토리지 스키마

401 - 무단

Legal Notice

Copyright © 2024 Red Hat, Inc.

OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).

Modified versions must remove all Red Hat trademarks.

Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.

Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.