네트워크 API


OpenShift Container Platform 4.15

네트워크 API에 대한 참조 가이드

Red Hat OpenShift Documentation Team

초록

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

1장. 네트워크 API

1.1. AdminPolicyBasedExternalRoute [k8s.ovn.org/v1]

설명
AdminPolicyBasedExternalRoute는 클러스터 관리자가 선택한 네임스페이스에 포함된 모든 Pod에 적용할 외부 게이트웨이 IP에 대한 정책을 구성할 수 있도록 하는 CRD입니다. 선택한 네임스페이스에 속하는 Pod의 송신 트래픽은 이러한 외부 게이트웨이 IP를 통해 라우팅됩니다.
유형
object

1.2. CloudPrivateIPConfig [cloud.network.openshift.io/v1]

설명
CloudPrivateIPConfig는 클라우드 VM과 연결된 기본 NIC에 대해 프라이빗 IP 주소 할당을 수행합니다. 이 작업은 IP를 할당해야 하는 IP 및 Kubernetes 노드를 지정하여 수행됩니다. 이 CRD는 클러스터 네트워크를 관리하는 네트워크 플러그인에서 사용하기 위한 것입니다. 사양 측은 네트워크 플러그인에서 요청한 원하는 상태를 나타내며 상태 측은 이 CRD의 컨트롤러가 실행된 현재 상태를 나타냅니다. 사용자가 수정할 수 있는 권한이 없으며, 어떤 이유로 cluster-admin에서 편집하도록 결정하는 경우 다음 네트워크 플러그인이 오브젝트를 조정할 때 해당 변경 사항을 덮어씁니다. 참고: CR 이름은 요청된 개인 IP 주소를 지정해야 합니다(IPv4 또는 IPv6)일 수 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

1.3. EgressFirewall [k8s.ovn.org/v1]

설명
EgressFirewall은 네임스페이스의 현재 송신 방화벽을 설명합니다. Pod에서 클러스터 외부의 IP 주소로의 트래픽은 Pod의 EgressFirewallRule의 각 EgressFirewallRule에 대해 순서대로 확인합니다. 일치하는 규칙이 없거나 EgressFirewall이 없으면 기본적으로 트래픽이 허용됩니다.
유형
object

1.4. EgressIP [k8s.ovn.org/v1]

설명
EgressIP는 사용자가 사양 정의에 따라 EgressIP 리소스와 일치하는 모든 Pod에서 발생하는 모든 송신 트래픽에 대해 고정 소스 IP를 정의할 수 있도록 하는 CRD입니다.
유형
object

1.5. EgressQoS [k8s.ovn.org/v1]

설명
EgressQoS는 사용자가 네임스페이스에서 지정된 CIDR로 송신 트래픽의 DSCP 값을 정의할 수 있는 CRD입니다. 이러한 Pod의 트래픽은 네임스페이스의 EgressQoSRule의 각 EgressQoSRule에 대해 확인되며 일치하는 항목이 있는 경우 트래픽이 관련 DSCP 값으로 표시됩니다.
유형
object

1.6. EgressService [k8s.ovn.org/v1]

설명
EgressService는 해당 LoadBalancer 서비스의 엔드포인트인 모든 Pod에서 발생하는 송신 패킷의 소스 IP가 수신 IP라고 요청할 수 있는 CRD입니다. 또한 사용자는 LoadBalancer 서비스의 엔드포인트인 모든 Pod에서 발생하는 송신 패킷을 기본 네트워크와 다른 네트워크를 사용하도록 요청할 수 있습니다.
유형
object

1.7. 끝점 [v1]

설명

끝점은 실제 서비스를 구현하는 끝점의 컬렉션입니다. 예제:

 Name: "mysvc",
 Subsets: [
   {
     Addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}],
     Ports: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}]
   },
   {
     Addresses: [{"ip": "10.10.3.3"}],
     Ports: [{"name": "a", "port": 93}, {"name": "b", "port": 76}]
   },
]
유형
object

1.8. EndpointSlice [discovery.k8s.io/v1]

설명
EndpointSlice는 서비스를 구현하는 끝점의 하위 집합을 나타냅니다. 지정된 서비스의 경우 레이블로 선택한 여러 EndpointSlice 오브젝트가 있을 수 있으며, 이 오브젝트는 전체 엔드포인트 세트를 생성하기 위해 결합되어야 합니다.
유형
object

1.9. EgressRouter [network.operator.openshift.io/v1]

설명
EgressRouter는 사용자가 pod와 외부 시스템 간의 브리지 역할을 하는 송신 라우터를 정의할 수 있는 기능입니다. 송신 라우터는 Pod 또는 Pod 그룹에서 구성별로 원격 외부 시스템 또는 여러 대상으로 발생하는 송신 트래픽을 리디렉션하는 서비스를 실행합니다. cluster-network-operator에서 사용합니다. 구체적으로는 <name>이 있는 EgressRouter CR을 통해 CNO는 생성 및 관리: - <name>이라는 송신 Pod - <name> - 호환성 수준 1: 호환성 수준 1: Stable이라는 송신 Pod는 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)에 대한 주요 릴리스 내에서 사용할 수 있습니다. EgressRouter는 단일 egressrouter Pod 구성 오브젝트입니다.
유형
object

1.10. Ingress [networking.k8s.io/v1]

설명
Ingress는 인바운드 연결이 백엔드에서 정의한 엔드포인트에 도달할 수 있도록 하는 규칙 컬렉션입니다. 외부에서 접근할 수 있는 URL, 로드 밸런싱 트래픽, SSL 종료, 이름 기반 가상 호스팅 등을 제공하도록 Ingress를 구성할 수 있습니다.
유형
object

1.11. IngressClass [networking.k8s.io/v1]

설명
IngressClass는 Ingress Spec에서 참조하는 Ingress의 클래스를 나타냅니다. ingressclass.kubernetes.io/is-default-class 주석을 사용하여 IngressClass를 기본값으로 간주해야 함을 나타낼 수 있습니다. 단일 IngressClass 리소스에 이 주석이 true로 설정되면 클래스가 지정되지 않은 새 Ingress 리소스에 이 기본 클래스가 할당됩니다.
유형
object

1.12. IPPool [whereabouts.cni.cncf.io/v1alpha1]

설명
IPPool은 ippools API의 스키마입니다.
유형
object

1.13. NetworkAttachmentDefinition [k8s.cni.cncf.io/v1]

설명
NetworkAttachmentDefinition은 하나 이상의 논리적 또는 물리적 네트워크에 Pod를 연결하기 위한 의도를 표현하기 위해 Network Plumbing Working Group에서 지정하는 CRD 스키마입니다. 자세한 내용은 https://github.com/k8snetworkplumbingwg/multi-net-spec에서 확인할 수 있습니다.
유형
object

1.14. NetworkPolicy [networking.k8s.io/v1]

설명
NetworkPolicy는 일련의 Pod에 허용되는 네트워크 트래픽을 설명합니다.
유형
object

1.15. OverlappingRangeIPReservation [whereabouts.cni.cncf.io/v1alpha1]

설명
OverlappingRangeIPReservation은 OverlappingRangeIPReservations API의 스키마입니다.
유형
object

1.16. PodNetworkConnectivityCheck [controlplane.operator.openshift.io/v1alpha1]

설명
PodNetworkConnectivityCheck 호환성 수준 4: 호환성이 제공되지 않으므로 언제든지 API를 변경할 수 있습니다. 이러한 기능은 장기 지원이 필요한 애플리케이션에서 사용해서는 안 됩니다.
유형
object

1.17. Route [route.openshift.io/v1]

설명

경로를 사용하면 개발자가 HTTP(S)에서 공용 DNS 항목을 통해 로드 밸런싱 및 프록시 계층을 인식하여 서비스를 노출할 수 있습니다. 경로는 TLS 옵션 및 인증서를 추가로 지정하거나 라우터에서 HTTP 및 HTTPS 트래픽에 대해 수락해야 하는 공용 CNAME을 지정할 수 있습니다. 관리자는 일반적으로 라우터가 클러스터 방화벽 외부에 표시되도록 구성하고 서비스 콘텐츠에 보안, 캐싱 또는 트래픽 제어를 추가할 수도 있습니다. 라우터는 일반적으로 서비스 엔드포인트와 직접 통신합니다.

경로가 생성되면 호스트 필드가 변경되지 않을 수 있습니다. 일반적으로 라우터는 충돌을 해결할 때 지정된 호스트에서 가장 오래된 경로를 사용합니다.

라우터는 추가 사용자 지정의 영향을 받으며 annotations 필드를 통해 추가 제어를 지원할 수 있습니다.

관리자는 여러 라우터를 구성할 수 있으므로 경로 상태 필드는 각 라우터의 경로 이름 및 상태에 대한 정보를 클라이언트에 반환하는 데 사용됩니다. 예를 들어 클라이언트가 중복 이름을 선택하는 경우 경로 상태 조건이 사용하여 경로를 선택할 수 없음을 나타냅니다.

경로에서 HTTP/2 ALPN을 활성화하려면 사용자 정의 (비위 카드) 인증서가 필요합니다. 이렇게 하면 클라이언트가 연결을 병합할 수 없으며 특히 웹 브라우저도 마찬가지입니다. 연결 재사용/커밋의 위험 때문에 기본 인증서를 사용하는 경로에서 HTTP/2 ALPN을 지원하지 않습니다. 자체 사용자 지정 인증서가 없는 경로는 프런트 엔드 또는 백엔드에서 HTTP/2 ALPN을 사용할 수 없습니다.

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

유형
object

1.18. 서비스 [v1]

설명
서비스는 프록시가 수신 대기하는 로컬 포트(예: 3306)와 프록시를 통해 전송되는 요청에 응답할 포드를 결정하는 선택기로 구성된 소프트웨어 서비스(예: mysql)의 이름이 지정된 추상화입니다.
유형
object

2장. AdminPolicyBasedExternalRoute [k8s.ovn.org/v1]

설명
AdminPolicyBasedExternalRoute는 클러스터 관리자가 선택한 네임스페이스에 포함된 모든 Pod에 적용할 외부 게이트웨이 IP에 대한 정책을 구성할 수 있도록 하는 CRD입니다. 선택한 네임스페이스에 속하는 Pod의 송신 트래픽은 이러한 외부 게이트웨이 IP를 통해 라우팅됩니다.
유형
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

AdminPolicyBasedExternalRouteSpec은 AdminPolicyBasedExternalRoute의 원하는 상태를 정의합니다.

status

object

AdminPolicyBasedRouteStatus에는 AdminPolicyBased 경로 유형의 관찰된 상태가 포함됩니다.

2.1.1. .spec

설명
AdminPolicyBasedExternalRouteSpec은 AdminPolicyBasedExternalRoute의 원하는 상태를 정의합니다.
유형
object
필수 항목
  • from
  • nextHops
속성유형설명

from

object

from은 대상 네임스페이스를 이 CR로 결정할 선택기를 정의합니다.

nextHops

object

NextHops는 정적 및 동적이라는 두 가지 유형의 홉을 정의합니다. 각 홉은 하나 이상의 외부 게이트웨이 IP를 정의합니다.

2.1.2. .spec.from

설명
from은 대상 네임스페이스를 이 CR로 결정할 선택기를 정의합니다.
유형
object
필수 항목
  • namespaceSelector
속성유형설명

namespaceSelector

object

namespaceSelector는 이 CR에서 대상으로 할 네임스페이스를 결정하는 데 사용할 선택기를 정의합니다.

2.1.3. .spec.from.namespaceSelector

설명
namespaceSelector는 이 CR에서 대상으로 할 네임스페이스를 결정하는 데 사용할 선택기를 정의합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

2.1.4. .spec.from.namespaceSelector.matchExpressions

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

2.1.5. .spec.from.namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

2.1.6. .spec.nextHops

설명
NextHops는 정적 및 동적이라는 두 가지 유형의 홉을 정의합니다. 각 홉은 하나 이상의 외부 게이트웨이 IP를 정의합니다.
유형
object
속성유형설명

dynamic

array

DynamicHops는 DynamicHop의 슬라이스를 정의합니다. 이 필드는 선택 사항입니다.

dynamic[]

object

DynamicHop은 동적 외부 게이트웨이 인터페이스에 대한 구성을 정의합니다. 이러한 인터페이스는 클러스터 내부에 있는 Pod 오브젝트로 래핑됩니다. NetworkAttachmentName 필드는 사용할 게이트웨이 IP를 검색할 때 사용할 multus 네트워크 이름의 이름을 캡처합니다. PodSelector 및 NamespaceSelector는 필수 필드입니다.

static

array

StaticHops는 StaticHop의 슬라이스를 정의합니다. 이 필드는 선택 사항입니다.

static[]

object

StaticHop은 외부 게이트웨이 인터페이스 역할을 하는 고정 IP의 구성을 정의합니다. IP 필드는 필수입니다.

2.1.7. .spec.nextHops.dynamic

설명
DynamicHops는 DynamicHop의 슬라이스를 정의합니다. 이 필드는 선택 사항입니다.
유형
array

2.1.8. .spec.nextHops.dynamic[]

설명
DynamicHop은 동적 외부 게이트웨이 인터페이스에 대한 구성을 정의합니다. 이러한 인터페이스는 클러스터 내부에 있는 Pod 오브젝트로 래핑됩니다. NetworkAttachmentName 필드는 사용할 게이트웨이 IP를 검색할 때 사용할 multus 네트워크 이름의 이름을 캡처합니다. PodSelector 및 NamespaceSelector는 필수 필드입니다.
유형
object
필수 항목
  • namespaceSelector
  • podSelector
속성유형설명

bfdEnabled

boolean

BFDEnabled는 인터페이스가 양방향 Forward Detection 프로토콜을 구현하는지 여부를 결정합니다. 기본값은 false입니다.

namespaceSelector

object

namespaceSelector는 Pod 게이트웨이가 있는 네임스페이스를 필터링하는 선택기를 정의합니다.

networkAttachmentName

string

NetworkAttachmentName은 게이트웨이 IP로 사용할 Pod IP를 검색할 때 사용할 multus 네트워크 이름을 결정합니다. 이 필드가 비어 있으면 논리는 포드가 HostNetwork로 구성되고 노드의 IP를 게이트웨이로 사용하고 있다고 가정합니다.

podSelector

object

podSelector는 외부 게이트웨이인 Pod를 필터링하는 선택기를 정의합니다.

2.1.9. .spec.nextHops.dynamic[].namespaceSelector

설명
namespaceSelector는 Pod 게이트웨이가 있는 네임스페이스를 필터링하는 선택기를 정의합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

2.1.10. .spec.nextHops.dynamic[].namespaceSelector.matchExpressions

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

2.1.11. .spec.nextHops.dynamic[].namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

2.1.12. .spec.nextHops.dynamic[].podSelector

설명
podSelector는 외부 게이트웨이인 Pod를 필터링하는 선택기를 정의합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

2.1.13. .spec.nextHops.dynamic[].podSelector.matchExpressions

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

2.1.14. .spec.nextHops.dynamic[].podSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

2.1.15. .spec.nextHops.static

설명
StaticHops는 StaticHop의 슬라이스를 정의합니다. 이 필드는 선택 사항입니다.
유형
array

2.1.16. .spec.nextHops.static[]

설명
StaticHop은 외부 게이트웨이 인터페이스 역할을 하는 고정 IP의 구성을 정의합니다. IP 필드는 필수입니다.
유형
object
필수 항목
  • ip
속성유형설명

bfdEnabled

boolean

BFDEnabled는 인터페이스가 양방향 Forward Detection 프로토콜을 구현하는지 여부를 결정합니다. 기본값은 false입니다.

ip

string

IP는 송신 트래픽에 사용할 고정 IP를 정의합니다. IP는 IPv4 또는 IPv6일 수 있습니다.

2.1.17. .status

설명
AdminPolicyBasedRouteStatus에는 AdminPolicyBased 경로 유형의 관찰된 상태가 포함됩니다.
유형
object
속성유형설명

lastTransitionTime

string

마지막 변경이 적용된 시간을 캡처합니다.

메시지

배열(문자열)

개체의 상태에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지 배열입니다.

status

string

AdminPolicyBasedRoute 리소스가 성공으로 적용되는지 여부를 나타내는 간결한 표시

2.2. API 끝점

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

  • /apis/k8s.ovn.org/v1/adminpolicybasedexternalroutes

    • DELETE: AdminPolicyBasedExternalRoute의 컬렉션 삭제
    • GET: AdminPolicyBasedExternalRoute 유형의 오브젝트 나열
    • POST: AdminPolicyBasedExternalRoute 생성
  • /apis/k8s.ovn.org/v1/adminpolicybasedexternalroutes/{name}

    • DELETE: delete an AdminPolicyBasedExternalRoute
    • GET: 지정된 AdminPolicyBasedExternalRoute 읽기
    • PATCH: 지정된 AdminPolicyBasedExternalRoute를 부분적으로 업데이트
    • PUT: 지정된 AdminPolicyBasedExternalRoute로 교체
  • /apis/k8s.ovn.org/v1/adminpolicybasedexternalroutes/{name}/status

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

2.2.1. /apis/k8s.ovn.org/v1/adminpolicybasedexternalroutes

HTTP 방법
DELETE
설명
AdminPolicyBasedExternalRoute 컬렉션 삭제
표 2.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

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

200 - OK

AdminPolicyBasedExternalRouteList schema

401 - 무단

HTTP 방법
POST
설명
create an AdminPolicyBasedExternalRoute
표 2.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

AdminPolicyBasedExternalRoute schema

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

200 - OK

AdminPolicyBasedExternalRoute schema

201 - 생성됨

AdminPolicyBasedExternalRoute schema

202 - 승인됨

AdminPolicyBasedExternalRoute schema

401 - 무단

2.2.2. /apis/k8s.ovn.org/v1/adminpolicybasedexternalroutes/{name}

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

name

string

AdminPolicyBasedExternalRoute의 이름

HTTP 방법
DELETE
설명
delete an AdminPolicyBasedExternalRoute
표 2.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

AdminPolicyBasedExternalRoute schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

AdminPolicyBasedExternalRoute schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

AdminPolicyBasedExternalRoute schema

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

200 - OK

AdminPolicyBasedExternalRoute schema

201 - 생성됨

AdminPolicyBasedExternalRoute schema

401 - 무단

2.2.3. /apis/k8s.ovn.org/v1/adminpolicybasedexternalroutes/{name}/status

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

name

string

AdminPolicyBasedExternalRoute의 이름

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

200 - OK

AdminPolicyBasedExternalRoute schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

AdminPolicyBasedExternalRoute schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

AdminPolicyBasedExternalRoute schema

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

200 - OK

AdminPolicyBasedExternalRoute schema

201 - 생성됨

AdminPolicyBasedExternalRoute schema

401 - 무단

3장. CloudPrivateIPConfig [cloud.network.openshift.io/v1]

설명
CloudPrivateIPConfig는 클라우드 VM과 연결된 기본 NIC에 대해 프라이빗 IP 주소 할당을 수행합니다. 이 작업은 IP를 할당해야 하는 IP 및 Kubernetes 노드를 지정하여 수행됩니다. 이 CRD는 클러스터 네트워크를 관리하는 네트워크 플러그인에서 사용하기 위한 것입니다. 사양 측은 네트워크 플러그인에서 요청한 원하는 상태를 나타내며 상태 측은 이 CRD의 컨트롤러가 실행된 현재 상태를 나타냅니다. 사용자가 수정할 수 있는 권한이 없으며, 어떤 이유로 cluster-admin에서 편집하도록 결정하는 경우 다음 네트워크 플러그인이 오브젝트를 조정할 때 해당 변경 사항을 덮어씁니다. 참고: CR 이름은 요청된 개인 IP 주소를 지정해야 합니다(IPv4 또는 IPv6)일 수 있습니다. 호환성 수준 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

spec은 원하는 개인 IP 요청의 정의입니다.

status

object

Status는 원하는 개인 IP 요청의 상태를 확인합니다. 읽기 전용입니다.

3.1.1. .spec

설명
spec은 원하는 개인 IP 요청의 정의입니다.
유형
object
속성유형설명

노드

string

노드는 Kubernetes 필드에 지정된 대로 노드 이름입니다. node.metadata.name

3.1.2. .status

설명
Status는 원하는 개인 IP 요청의 상태를 확인합니다. 읽기 전용입니다.
유형
object
필수 항목
  • conditions
속성유형설명

conditions

array

condition은 개인 IP 및 해당 상태의 할당 조건입니다.

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" // 기타 필드 }

노드

string

노드는 Kubernetes 필드에 지정된 대로 노드 이름입니다. node.metadata.name

3.1.3. .status.conditions

설명
condition은 개인 IP 및 해당 상태의 할당 조건입니다.
유형
array

3.1.4. .status.conditions[]

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

lastTransitionTime

string

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

message

string

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

observedGeneration

integer

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

reason

string

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

status

string

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

type

string

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

3.2. API 끝점

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

  • /apis/cloud.network.openshift.io/v1/cloudprivateipconfigs

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

    • DELETE: delete a CloudPrivateIPConfig
    • GET: 지정된 CloudPrivateIPConfig 읽기
    • PATCH: 지정된 CloudPrivateIPConfig를 부분적으로 업데이트
    • PUT: 지정된 CloudPrivateIPConfig를 교체
  • /apis/cloud.network.openshift.io/v1/cloudprivateipconfigs/{name}/status

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

3.2.1. /apis/cloud.network.openshift.io/v1/cloudprivateipconfigs

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

200 - OK

상태 스키마

401 - 무단

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

200 - OK

CloudPrivateIPConfigList schema

401 - 무단

HTTP 방법
POST
설명
create a CloudPrivateIPConfig
표 3.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

CloudPrivateIPConfig schema

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

200 - OK

CloudPrivateIPConfig schema

201 - 생성됨

CloudPrivateIPConfig schema

202 - 승인됨

CloudPrivateIPConfig schema

401 - 무단

3.2.2. /apis/cloud.network.openshift.io/v1/cloudprivateipconfigs/{name}

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

name

string

CloudPrivateIPConfig의 이름

HTTP 방법
DELETE
설명
delete a CloudPrivateIPConfig
표 3.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

CloudPrivateIPConfig schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

CloudPrivateIPConfig schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

CloudPrivateIPConfig schema

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

200 - OK

CloudPrivateIPConfig schema

201 - 생성됨

CloudPrivateIPConfig schema

401 - 무단

3.2.3. /apis/cloud.network.openshift.io/v1/cloudprivateipconfigs/{name}/status

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

name

string

CloudPrivateIPConfig의 이름

HTTP 방법
GET
설명
지정된 CloudPrivateIPConfig의 상태 확인
표 3.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

CloudPrivateIPConfig schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

CloudPrivateIPConfig schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

CloudPrivateIPConfig schema

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

200 - OK

CloudPrivateIPConfig schema

201 - 생성됨

CloudPrivateIPConfig schema

401 - 무단

4장. EgressFirewall [k8s.ovn.org/v1]

설명
EgressFirewall은 네임스페이스의 현재 송신 방화벽을 설명합니다. Pod에서 클러스터 외부의 IP 주소로의 트래픽은 Pod의 EgressFirewallRule의 각 EgressFirewallRule에 대해 순서대로 확인합니다. 일치하는 규칙이 없거나 EgressFirewall이 없으면 기본적으로 트래픽이 허용됩니다.
유형
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

EgressFirewall의 원하는 동작 사양입니다.

status

object

EgressFirewall의 상태

4.1.1. .spec

설명
EgressFirewall의 원하는 동작 사양입니다.
유형
object
필수 항목
  • egress
속성유형설명

egress

array

송신 방화벽 규칙 오브젝트 컬렉션

egress[]

object

EgressFirewallRule은 단일 egressfirewall 규칙 오브젝트입니다.

4.1.2. .spec.egress

설명
송신 방화벽 규칙 오브젝트 컬렉션
유형
array

4.1.3. .spec.egress[]

설명
EgressFirewallRule은 단일 egressfirewall 규칙 오브젝트입니다.
유형
object
필수 항목
  • 다음으로 변경
  • type
속성유형설명

포트

array

포트가 규칙이 적용되는 포트 및 프로토콜을 지정합니다.

ports[]

object

EgressFirewallPort는 트래픽을 허용하거나 거부할 포트를 지정합니다.

다음으로 변경

object

to는 트래픽이 허용/거부되는 대상입니다.

type

string

type은 이 값을 "Allow" 또는 "Deny" 규칙으로 표시합니다.

4.1.4. .spec.egress[].ports

설명
포트가 규칙이 적용되는 포트 및 프로토콜을 지정합니다.
유형
array

4.1.5. .spec.egress[].ports[]

설명
EgressFirewallPort는 트래픽을 허용하거나 거부할 포트를 지정합니다.
유형
object
필수 항목
  • port
  • protocol
속성유형설명

port

integer

트래픽이 일치해야 하는 포트

protocol

string

트래픽이 일치해야 하는 프로토콜(tcp, udp, sctp)입니다.

4.1.6. .spec.egress[].to

설명
to는 트래픽이 허용/거부되는 대상입니다.
유형
object
속성유형설명

cidrSelector

string

cidrSelector는 트래픽을 허용/거부할 CIDR 범위입니다. 이 값을 설정하는 경우 dnsName 및 nodeSelector를 설정하지 않아야 합니다.

dnsName

string

dnsName은 트래픽을 허용/거부할 도메인 이름입니다. 이 값을 설정하는 경우 cidrSelector 및 nodeSelector를 설정하지 않아야 합니다.

nodeSelector

object

nodeSelector는 선택한 노드의 Kubernetes 노드 IP에 대한 트래픽을 허용/거부합니다. 이 값을 설정하는 경우 cidrSelector 및 DNSName을 설정되지 않아야 합니다.

4.1.7. .spec.egress[].to.nodeSelector

설명
nodeSelector는 선택한 노드의 Kubernetes 노드 IP에 대한 트래픽을 허용/거부합니다. 이 값을 설정하는 경우 cidrSelector 및 DNSName을 설정되지 않아야 합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

4.1.8. .spec.egress[].to.nodeSelector.matchExpressions

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

4.1.9. .spec.egress[].to.nodeSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

4.1.10. .status

설명
EgressFirewall의 상태
유형
object
속성유형설명

메시지

배열(문자열)

 

status

string

 

4.2. API 끝점

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

  • /apis/k8s.ovn.org/v1/egressfirewalls

    • GET: EgressFirewall 유형의 오브젝트 나열
  • /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressfirewalls

    • DELETE: EgressFirewall 컬렉션 삭제
    • GET: EgressFirewall 유형의 오브젝트 나열
    • POST: EgressFirewall 생성
  • /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressfirewalls/{name}

    • DELETE: EgressFirewall 삭제
    • GET: 지정된 EgressFirewall 읽기
    • PATCH: 지정된 EgressFirewall을 부분적으로 업데이트
    • PUT: 지정된 EgressFirewall을 대체합니다.
  • /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressfirewalls/{name}/status

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

4.2.1. /apis/k8s.ovn.org/v1/egressfirewalls

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

200 - OK

EgressFirewallList 스키마

401 - 무단

4.2.2. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressfirewalls

HTTP 방법
DELETE
설명
EgressFirewall 컬렉션 삭제
표 4.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

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

200 - OK

EgressFirewallList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressFirewall 스키마

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

200 - OK

EgressFirewall 스키마

201 - 생성됨

EgressFirewall 스키마

202 - 승인됨

EgressFirewall 스키마

401 - 무단

4.2.3. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressfirewalls/{name}

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

name

string

EgressFirewall 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

EgressFirewall 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

EgressFirewall 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressFirewall 스키마

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

200 - OK

EgressFirewall 스키마

201 - 생성됨

EgressFirewall 스키마

401 - 무단

4.2.4. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressfirewalls/{name}/status

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

name

string

EgressFirewall 이름

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

200 - OK

EgressFirewall 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

EgressFirewall 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressFirewall 스키마

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

200 - OK

EgressFirewall 스키마

201 - 생성됨

EgressFirewall 스키마

401 - 무단

5장. EgressIP [k8s.ovn.org/v1]

설명
EgressIP는 사용자가 사양 정의에 따라 EgressIP 리소스와 일치하는 모든 Pod에서 발생하는 모든 송신 트래픽에 대해 고정 소스 IP를 정의할 수 있도록 하는 CRD입니다.
유형
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

EgressIP의 원하는 동작의 사양입니다.

status

object

EgressIP의 상태를 확인합니다. 읽기 전용입니다.

5.1.1. .spec

설명
EgressIP의 원하는 동작의 사양입니다.
유형
object
필수 항목
  • egressIPs
  • namespaceSelector
속성유형설명

egressIPs

배열(문자열)

egressIPs는 요청된 송신 IP 주소 목록입니다. IPv4 및/또는 IPv6일 수 있습니다. 이 필드는 필수입니다.

namespaceSelector

object

namespaceSelector는 이 정의와 일치하는 레이블이 있는 네임스페이스에만 송신 IP를 적용합니다. 이 필드는 필수입니다.

podSelector

object

podSelector는 송신 IP를 이 정의와 일치하는 Pod에만 적용합니다. 이 필드는 선택 사항이며 설정되지 않은 경우 송신 IP가 NamespaceSelector와 일치하는 네임스페이스의 모든 Pod에 적용됩니다. 설정된 경우 NamespaceSelector와 교차하므로 이 Pod 선택기와 일치하는 NamespaceSelector가 이미 일치하는 Pod(네임스페이스에서)에 송신 IP를 적용합니다.

5.1.2. .spec.namespaceSelector

설명
namespaceSelector는 이 정의와 일치하는 레이블이 있는 네임스페이스에만 송신 IP를 적용합니다. 이 필드는 필수입니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

5.1.3. .spec.namespaceSelector.matchExpressions

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

5.1.4. .spec.namespaceSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

5.1.5. .spec.podSelector

설명
podSelector는 송신 IP를 이 정의와 일치하는 Pod에만 적용합니다. 이 필드는 선택 사항이며 설정되지 않은 경우 송신 IP가 NamespaceSelector와 일치하는 네임스페이스의 모든 Pod에 적용됩니다. 설정된 경우 NamespaceSelector와 교차하므로 이 Pod 선택기와 일치하는 NamespaceSelector가 이미 일치하는 Pod(네임스페이스에서)에 송신 IP를 적용합니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

5.1.6. .spec.podSelector.matchExpressions

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

5.1.7. .spec.podSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

5.1.8. .status

설명
EgressIP의 상태를 확인합니다. 읽기 전용입니다.
유형
object
필수 항목
  • items
속성유형설명

items

array

할당된 송신 IP 목록과 해당 노드 할당입니다.

items[]

object

할당된 송신 IP의 노드당 상태입니다.

5.1.9. .status.items

설명
할당된 송신 IP 목록과 해당 노드 할당입니다.
유형
array

5.1.10. .status.items[]

설명
할당된 송신 IP의 노드당 상태입니다.
유형
object
필수 항목
  • egressIP
  • 노드
속성유형설명

egressIP

string

할당된 송신 IP

노드

string

할당된 노드 이름

5.2. API 끝점

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

  • /apis/k8s.ovn.org/v1/egressips

    • DELETE: EgressIP 컬렉션 삭제
    • GET: 종류의 EgressIP 오브젝트 나열
    • POST: EgressIP 생성
  • /apis/k8s.ovn.org/v1/egressips/{name}

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

5.2.1. /apis/k8s.ovn.org/v1/egressips

HTTP 방법
DELETE
설명
EgressIP 컬렉션 삭제
표 5.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

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

200 - OK

EgressIPList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressIP 스키마

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

200 - OK

EgressIP 스키마

201 - 생성됨

EgressIP 스키마

202 - 승인됨

EgressIP 스키마

401 - 무단

5.2.2. /apis/k8s.ovn.org/v1/egressips/{name}

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

name

string

EgressIP 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

EgressIP 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

EgressIP 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressIP 스키마

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

200 - OK

EgressIP 스키마

201 - 생성됨

EgressIP 스키마

401 - 무단

6장. EgressQoS [k8s.ovn.org/v1]

설명
EgressQoS는 사용자가 네임스페이스에서 지정된 CIDR로 송신 트래픽의 DSCP 값을 정의할 수 있는 CRD입니다. 이러한 Pod의 트래픽은 네임스페이스의 EgressQoSRule의 각 EgressQoSRule에 대해 확인되며 일치하는 항목이 있는 경우 트래픽이 관련 DSCP 값으로 표시됩니다.
유형
object

6.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

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

spec

object

EgressQoSSpec은 원하는 EgressQoS 상태를 정의합니다.

status

object

EgressQoSStatus는 EgressQoS의 관찰 상태를 정의합니다.

6.1.1. .spec

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

egress

array

Egress QoS 규칙 오브젝트 컬렉션

egress[]

object

 

6.1.2. .spec.egress

설명
Egress QoS 규칙 오브젝트 컬렉션
유형
array

6.1.3. .spec.egress[]

설명
유형
object
필수 항목
  • dscp
속성유형설명

dscp

integer

일치하는 Pod의 트래픽에 대한 DSCP 표시 값입니다.

dstCIDR

string

DstCIDR은 대상의 CIDR을 지정합니다. 이 CIDR로 향하는 트래픽만 DSCP 값으로 표시됩니다. 이 필드는 선택 사항이며, 대상에 관계없이 규칙이 모든 송신 트래픽에 적용되지 않는 경우 규칙이 설정됩니다.

podSelector

object

podSelector는 이 정의와 일치하는 네임스페이스의 Pod에만 QoS 규칙을 적용합니다. 이 필드는 선택 사항이며, 설정되지 않은 경우 네임스페이스의 모든 Pod에 규칙이 적용됩니다.

6.1.4. .spec.egress[].podSelector

설명
podSelector는 이 정의와 일치하는 네임스페이스의 Pod에만 QoS 규칙을 적용합니다. 이 필드는 선택 사항이며, 설정되지 않은 경우 네임스페이스의 모든 Pod에 규칙이 적용됩니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

6.1.5. .spec.egress[].podSelector.matchExpressions

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

6.1.6. .spec.egress[].podSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

6.1.7. .status

설명
EgressQoSStatus는 EgressQoS의 관찰 상태를 정의합니다.
유형
object

6.2. API 끝점

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

  • /apis/k8s.ovn.org/v1/egressqoses

    • GET: 종류의 EgressQoS 오브젝트 나열
  • /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressqoses

    • DELETE: EgressQoS 컬렉션 삭제
    • GET: 종류의 EgressQoS 오브젝트 나열
    • POST: EgressQoS 생성
  • /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressqoses/{name}

    • DELETE: EgressQoS 삭제
    • GET: 지정된 EgressQoS 읽기
    • PATCH: 지정된 EgressQoS를 부분적으로 업데이트
    • PUT: 지정된 EgressQoS를 교체합니다.
  • /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressqoses/{name}/status

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

6.2.1. /apis/k8s.ovn.org/v1/egressqoses

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

200 - OK

EgressQoSList 스키마

401 - 무단

6.2.2. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressqoses

HTTP 방법
DELETE
설명
EgressQoS 컬렉션 삭제
표 6.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

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

200 - OK

EgressQoSList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressQoS 스키마

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

200 - OK

EgressQoS 스키마

201 - 생성됨

EgressQoS 스키마

202 - 승인됨

EgressQoS 스키마

401 - 무단

6.2.3. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressqoses/{name}

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

name

string

EgressQoS 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

EgressQoS 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

EgressQoS 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressQoS 스키마

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

200 - OK

EgressQoS 스키마

201 - 생성됨

EgressQoS 스키마

401 - 무단

6.2.4. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressqoses/{name}/status

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

name

string

EgressQoS 이름

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

200 - OK

EgressQoS 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

EgressQoS 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressQoS 스키마

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

200 - OK

EgressQoS 스키마

201 - 생성됨

EgressQoS 스키마

401 - 무단

7장. EgressService [k8s.ovn.org/v1]

설명
EgressService는 해당 LoadBalancer 서비스의 엔드포인트인 모든 Pod에서 발생하는 송신 패킷의 소스 IP가 수신 IP라고 요청할 수 있는 CRD입니다. 또한 사용자는 LoadBalancer 서비스의 엔드포인트인 모든 Pod에서 발생하는 송신 패킷을 기본 네트워크와 다른 네트워크를 사용하도록 요청할 수 있습니다.
유형
object

7.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

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

spec

object

EgressServiceSpec은 원하는 EgressService 상태를 정의합니다.

status

object

EgressServiceStatus는 EgressService의 관찰 상태를 정의합니다.

7.1.1. .spec

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

network

string

이 서비스가 송신 및 해당 수신 응답을 보내야 하는 네트워크입니다. 일반적으로 생략 시 기본 호스트 라우팅을 사용하는 라우팅 테이블의 숫자 ID 또는 문자열 이름을 나타내는 VRF 매핑으로 구현됩니다.

nodeSelector

object

sourceIPBy=LoadBalancerIP를 통해 서비스의 트래픽을 처리하도록 선택할 수 있는 노드를 제한할 수 있습니다. 라벨이 지정된 선택기와 일치하는 노드만 있는 경우 서비스의 트래픽을 처리하기 위해 선택할 수 있습니다. 클러스터의 노드를 지정하지 않으면 서비스의 트래픽을 관리하기 위해 선택할 수 있습니다.

sourceIPBy

string

LoadBalancer 서비스를 지원하는 Pod에서 발생하는 송신 트래픽의 소스 IP를 결정합니다. LoadBalancerIP 인 경우 소스 IP는 LoadBalancer Ingress IP로 설정됩니다. Network the source IP is set according to the interface of the network, leveraging the masquerade rules that are already in place. 일반적으로 이러한 규칙은 발신 인터페이스의 IP에 SNAT를 지정합니다. 즉, 패킷은 일반적으로 노드의 IP와 함께 남겨집니다.

7.1.2. .spec.nodeSelector

설명
sourceIPBy=LoadBalancerIP를 통해 서비스의 트래픽을 처리하도록 선택할 수 있는 노드를 제한할 수 있습니다. 라벨이 지정된 선택기와 일치하는 노드만 있는 경우 서비스의 트래픽을 처리하기 위해 선택할 수 있습니다. 클러스터의 노드를 지정하지 않으면 서비스의 트래픽을 관리하기 위해 선택할 수 있습니다.
유형
object
속성유형설명

matchExpressions

array

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

matchExpressions[]

object

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

matchLabels

오브젝트(문자열)

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

7.1.3. .spec.nodeSelector.matchExpressions

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

7.1.4. .spec.nodeSelector.matchExpressions[]

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

key

string

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

operator

string

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

배열(문자열)

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

7.1.5. .status

설명
EgressServiceStatus는 EgressService의 관찰 상태를 정의합니다.
유형
object
필수 항목
  • host
속성유형설명

host

string

서비스의 트래픽을 처리하기 위해 선택한 노드의 이름입니다. sourceIPBy=Network의 경우 필드는 "ALL"으로 설정됩니다.

7.2. API 끝점

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

  • /apis/k8s.ovn.org/v1/egressservices

    • GET: 종류의 EgressService 오브젝트 나열
  • /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressservices

    • DELETE: EgressService의 컬렉션 삭제
    • GET: 종류의 EgressService 오브젝트 나열
    • POST: EgressService 생성
  • /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressservices/{name}

    • DELETE: EgressService 삭제
    • GET: 지정된 EgressService 읽기
    • PATCH: 지정된 EgressService를 부분적으로 업데이트
    • PUT: 지정된 EgressService를 교체
  • /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressservices/{name}/status

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

7.2.1. /apis/k8s.ovn.org/v1/egressservices

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

200 - OK

EgressServiceList 스키마

401 - 무단

7.2.2. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressservices

HTTP 방법
DELETE
설명
EgressService 컬렉션 삭제
표 7.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

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

200 - OK

EgressServiceList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressService 스키마

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

200 - OK

EgressService 스키마

201 - 생성됨

EgressService 스키마

202 - 승인됨

EgressService 스키마

401 - 무단

7.2.3. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressservices/{name}

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

name

string

EgressService의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

EgressService 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

EgressService 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressService 스키마

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

200 - OK

EgressService 스키마

201 - 생성됨

EgressService 스키마

401 - 무단

7.2.4. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressservices/{name}/status

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

name

string

EgressService의 이름

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

200 - OK

EgressService 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

EgressService 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressService 스키마

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

200 - OK

EgressService 스키마

201 - 생성됨

EgressService 스키마

401 - 무단

8장. 끝점 [v1]

설명

끝점은 실제 서비스를 구현하는 끝점의 컬렉션입니다. 예제:

 Name: "mysvc",
 Subsets: [
   {
     Addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}],
     Ports: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}]
   },
   {
     Addresses: [{"ip": "10.10.3.3"}],
     Ports: [{"name": "a", "port": 93}, {"name": "b", "port": 76}]
   },
]
유형
object

8.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

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

하위 집합

array

모든 끝점의 세트는 모든 하위 집합의 결합입니다. 주소는 공유하는 IP에 따라 하위 집합에 배치됩니다. 여러 포트가 있는 단일 주소이며, 그 중 일부는 준비되었으며 그 중 일부는 (다른 컨테이너에서 제공되기 때문에) 다른 포트의 다른 하위 집합에 주소가 표시됩니다. 동일한 하위 집합의 addresses 및 NotReadyAddresses에 주소가 표시되지 않습니다. 서비스를 구성하는 주소 및 포트 세트입니다.

subsets[]

object

EndpointSubset은 일반적인 포트 세트가 있는 주소 그룹입니다. 확장된 엔드 포인트 세트는 addresses x Ports의 카테시안 제품입니다. 예를 들면 다음과 같습니다.

{ addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}], Ports: [{"name": "a", "port": 8675}, {"name": "b", "b", "port": 309}] }

결과 끝점 세트는 다음과 같이 볼 수 있습니다.

A: [ 10.10.1.1:8675, 10.10.2.2:8675 ], b: [ 10.10.1.1:309, 10.10.2.2:309 ]

8.1.1. .subsets

설명
모든 끝점의 세트는 모든 하위 집합의 결합입니다. 주소는 공유하는 IP에 따라 하위 집합에 배치됩니다. 여러 포트가 있는 단일 주소이며, 그 중 일부는 준비되었으며 그 중 일부는 (다른 컨테이너에서 제공되기 때문에) 다른 포트의 다른 하위 집합에 주소가 표시됩니다. 동일한 하위 집합의 addresses 및 NotReadyAddresses에 주소가 표시되지 않습니다. 서비스를 구성하는 주소 및 포트 세트입니다.
유형
array

8.1.2. .subsets[]

설명

EndpointSubset은 일반적인 포트 세트가 있는 주소 그룹입니다. 확장된 엔드 포인트 세트는 addresses x Ports의 카테시안 제품입니다. 예를 들면 다음과 같습니다.

{
  Addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}],
  Ports:     [{"name": "a", "port": 8675}, {"name": "b", "port": 309}]
}

결과 끝점 세트는 다음과 같이 볼 수 있습니다.

a: [ 10.10.1.1:8675, 10.10.2.2:8675 ],
b: [ 10.10.1.1:309, 10.10.2.2:309 ]
유형
object
속성유형설명

주소

array

ready으로 표시된 관련 포트를 제공하는 IP 주소입니다. 이러한 끝점은 로드 밸런서 및 클라이언트가 사용할 수 있는 안전한 것으로 간주되어야 합니다.

addresses[]

object

EndpointAddress는 단일 IP 주소를 설명하는 튜플입니다.

notReadyAddresses

array

관련 포트를 제공하지만 아직 시작을 완료하지 않았거나 최근에 준비 상태 점검에 실패했거나 최근에 활성 검사에 실패했기 때문에 현재 준비 상태로 표시되지 않은 IP 주소입니다.

notReadyAddresses[]

object

EndpointAddress는 단일 IP 주소를 설명하는 튜플입니다.

포트

array

관련 IP 주소에서 사용할 수 있는 포트 번호입니다.

ports[]

object

EndpointPort는 단일 포트를 설명하는 튜플입니다.

8.1.3. .subsets[].addresses

설명
ready으로 표시된 관련 포트를 제공하는 IP 주소입니다. 이러한 끝점은 로드 밸런서 및 클라이언트가 사용할 수 있는 안전한 것으로 간주되어야 합니다.
유형
array

8.1.4. .subsets[].addresses[]

설명
EndpointAddress는 단일 IP 주소를 설명하는 튜플입니다.
유형
object
필수 항목
  • ip
속성유형설명

hostname

string

이 끝점의 호스트 이름

ip

string

이 끝점의 IP입니다. 루프백(127.0.0.0/8 또는 ::1), 링크-로컬(169.254.0.0/16 또는 fe80::/10) 또는 링크-로컬 멀티 캐스트(224.0.0.0/24 또는 ff02::/16)가 아닐 수 있습니다.

nodeName

string

선택 사항: 이 끝점을 호스팅하는 노드입니다. 노드에 로컬 끝점을 결정하는 데 사용할 수 있습니다.

targetRef

object

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

8.1.5. .subsets[].addresses[].targetRef

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

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

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

kind

string

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

name

string

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

네임스페이스

string

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

resourceVersion

string

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

uid

string

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

8.1.6. .subsets[].notReadyAddresses

설명
관련 포트를 제공하지만 아직 시작을 완료하지 않았거나 최근에 준비 상태 점검에 실패했거나 최근에 활성 검사에 실패했기 때문에 현재 준비 상태로 표시되지 않은 IP 주소입니다.
유형
array

8.1.7. .subsets[].notReadyAddresses[]

설명
EndpointAddress는 단일 IP 주소를 설명하는 튜플입니다.
유형
object
필수 항목
  • ip
속성유형설명

hostname

string

이 끝점의 호스트 이름

ip

string

이 끝점의 IP입니다. 루프백(127.0.0.0/8 또는 ::1), 링크-로컬(169.254.0.0/16 또는 fe80::/10) 또는 링크-로컬 멀티 캐스트(224.0.0.0/24 또는 ff02::/16)가 아닐 수 있습니다.

nodeName

string

선택 사항: 이 끝점을 호스팅하는 노드입니다. 노드에 로컬 끝점을 결정하는 데 사용할 수 있습니다.

targetRef

object

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

8.1.8. .subsets[].notReadyAddresses[].targetRef

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

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

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

kind

string

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

name

string

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

네임스페이스

string

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

resourceVersion

string

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

uid

string

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

8.1.9. .subsets[].ports

설명
관련 IP 주소에서 사용할 수 있는 포트 번호입니다.
유형
array

8.1.10. .subsets[].ports[]

설명
EndpointPort는 단일 포트를 설명하는 튜플입니다.
유형
object
필수 항목
  • port
속성유형설명

appProtocol

string

이 포트의 애플리케이션 프로토콜입니다. 이는 구현이 이해할 수 있는 프로토콜에 대해 보다 풍부한 동작을 제공하기 위한 힌트로 사용됩니다. 이 필드는 표준 Kubernetes 라벨 구문을 따릅니다. 유효한 값은 다음 중 하나입니다.

* UN-prefixed 프로토콜 이름 - IANA 표준 서비스 이름(RFC-6335 및 https://www.iana.org/assignments/service-names)용으로 예약되어 있습니다.

* Kubernetes 정의 접두사 이름: * 'kubernetes.io/h2c' - https://www.rfc-editor.org/rfc/rfc7540 * 'kubernetes.io/ws'에 설명된 대로 https://www.rfc-editor.org/rfc/rfc7540 * 'kubernetes.io/ws' - WebSocket over cleartext에 설명된 대로 https://www.rfc-editor.org/rfc/rfc6455 * 'kubernetes.io/wsss' - WebSocket over TLS에 설명된 대로 일반 텍스트보다 일반 텍스트보다 HTTP/2보다 일반 텍스트보다 HTTP/2입니다.

* 다른 프로토콜은 mycompany.com/my-custom-protocol과 같은 구현 정의 접두사 이름을 사용해야 합니다.

name

string

이 포트의 이름입니다. 이는 해당 ServicePort의 'name' 필드와 일치해야 합니다. DNS_LABEL이어야 합니다. 하나의 포트가 정의된 경우에만 선택 사항입니다.

port

integer

끝점의 포트 번호입니다.

protocol

string

이 포트의 IP 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 TCP입니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

8.2. API 끝점

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

  • /api/v1/endpoints

    • GET: 종류의 엔드 포인트의 오브젝트 나열 또는 감시
  • /api/v1/watch/endpoints

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

    • DELETE: Endpoints 컬렉션 삭제
    • GET: 종류의 엔드 포인트의 오브젝트 나열 또는 감시
    • POST: 끝점 생성
  • /api/v1/watch/namespaces/{namespace}/endpoints

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

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

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

8.2.1. /api/v1/endpoints

HTTP 방법
GET
설명
List or watch objects of kind Endpoints
표 8.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

EndpointsList 스키마

401 - 무단

8.2.2. /api/v1/watch/endpoints

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

dryRun

string

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

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
List or watch objects of kind Endpoints
표 8.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

EndpointsList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

엔드 포인트 스키마

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

200 - OK

엔드 포인트 스키마

201 - 생성됨

엔드 포인트 스키마

202 - 승인됨

엔드 포인트 스키마

401 - 무단

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

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

200 - OK

WatchEvent 스키마

401 - 무단

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

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

name

string

끝점의 이름

HTTP 방법
DELETE
설명
엔드포인트 삭제
표 8.11. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

엔드 포인트 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

엔드 포인트 스키마

201 - 생성됨

엔드 포인트 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

엔드 포인트 스키마

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

200 - OK

엔드 포인트 스키마

201 - 생성됨

엔드 포인트 스키마

401 - 무단

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

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

name

string

끝점의 이름

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

200 - OK

WatchEvent 스키마

401 - 무단

9장. EndpointSlice [discovery.k8s.io/v1]

설명
EndpointSlice는 서비스를 구현하는 끝점의 하위 집합을 나타냅니다. 지정된 서비스의 경우 레이블로 선택한 여러 EndpointSlice 오브젝트가 있을 수 있으며, 이 오브젝트는 전체 엔드포인트 세트를 생성하기 위해 결합되어야 합니다.
유형
object
필수 항목
  • addressType
  • 끝점

9.1. 사양

속성유형설명

addressType

string

addressType은 이 EndpointSlice에서 전송하는 주소 유형을 지정합니다. 이 슬라이스의 모든 주소는 동일한 유형이어야 합니다. 생성 후에는 이 필드를 변경할 수 없습니다. 현재 지원되는 주소 유형은 * IPv4: IPv4 주소를 나타냅니다. * IPv6: IPv6 주소를 나타냅니다. * FQDN: 정규화된 도메인 이름을 나타냅니다.

가능한 열거 값: - "FQDN" 은 FQDN을 나타냅니다. - "IPv4" 는 IPv4 주소를 나타냅니다. - "IPv6" 은 IPv6 주소를 나타냅니다.

apiVersion

string

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

끝점

array

끝점은 이 슬라이스의 고유한 끝점 목록입니다. 각 슬라이스에는 최대 1000개의 끝점이 포함될 수 있습니다.

endpoints[]

object

엔드포인트는 서비스를 구현하는 단일 논리 "backend"를 나타냅니다.

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다.

포트

array

ports는 이 슬라이스의 각 끝점에 의해 노출되는 네트워크 포트 목록을 지정합니다. 각 포트에는 고유한 이름이 있어야 합니다. 포트가 비어 있으면 정의된 포트가 없음을 나타냅니다. port가 nil 포트 값으로 정의되면 "모든 포트"를 나타냅니다. 각 슬라이스에는 최대 100개의 포트가 포함될 수 있습니다.

ports[]

object

EndpointPort는 EndpointSlice에서 사용하는 포트를 나타냅니다.

9.1.1. .endpoints

설명
끝점은 이 슬라이스의 고유한 끝점 목록입니다. 각 슬라이스에는 최대 1000개의 끝점이 포함될 수 있습니다.
유형
array

9.1.2. .endpoints[]

설명
엔드포인트는 서비스를 구현하는 단일 논리 "backend"를 나타냅니다.
유형
object
필수 항목
  • 주소
속성유형설명

주소

배열(문자열)

이 끝점의 주소입니다. 이 필드의 내용은 해당 EndpointSlice addressType 필드에 따라 해석됩니다. 소비자는 자체 기능 컨텍스트에서 다양한 유형의 주소를 처리해야 합니다. 여기에는 하나 이상의 주소가 포함되어야 하지만 100을 초과해서는 안 됩니다. 이러한 모든 것은 번거로 간주되며 클라이언트는 첫 번째 요소 만 사용하도록 선택할 수 있습니다. 참조: https://issue.k8s.io/106267

conditions

object

EndpointConditions는 끝점의 현재 상태를 나타냅니다.

deprecatedTopology

오브젝트(문자열)

deprecatedTopology에는 v1beta1 API의 토폴로지 정보 부분이 포함되어 있습니다. 이 필드는 더 이상 사용되지 않으며 v1beta1 API가 제거될 때 ( kubernetes v1.24)보다 빨리 제거됩니다. 이 필드는 값을 보유할 수 있지만 v1 API를 통해 쓸 수 없으며 쓰기 시도는 자동으로 무시됩니다. 토폴로지 정보는 대신 zone 및 nodeName 필드에서 찾을 수 있습니다.

object

EndpointHints는 끝점을 사용하는 방법을 설명하는 힌트를 제공합니다.

hostname

string

이 끝점의 호스트 이름입니다. 엔드포인트 소비자는 이 필드를 사용하여 끝점을 서로 구분할 수 있습니다(예: DNS 이름). 동일한 호스트 이름을 사용하는 끝점이 여러 개 있는 것으로 간주해야 합니다(예: DNS의 여러 A 값). 소문자여야 하며 DNS 라벨(RFC 1123) 검증을 통과해야 합니다.

nodeName

string

nodename은 이 엔드포인트를 호스팅하는 노드의 이름을 나타냅니다. 노드에 로컬 끝점을 결정하는 데 사용할 수 있습니다.

targetRef

ObjectReference

targetRef는 이 엔드포인트를 나타내는 Kubernetes 오브젝트에 대한 참조입니다.

영역

string

zone은 이 엔드포인트가 존재하는 영역의 이름입니다.

9.1.3. .endpoints[].conditions

설명
EndpointConditions는 끝점의 현재 상태를 나타냅니다.
유형
object
속성유형설명

Ready

boolean

Ready는 엔드포인트를 관리하는 시스템에 따라 이 엔드포인트가 트래픽을 수신할 준비가 되었음을 나타냅니다. nil 값은 알 수 없는 상태를 나타냅니다. 대부분의 경우 소비자는 이 unknown 상태를 ready로 해석해야 합니다. 호환성을 위해 일반 준비 동작이 명시적으로 재정의되는 경우(예: 연결된 서비스에서 publishNotReadyAddresses 플래그를 설정 하는 경우)를 제외하고 끝점 종료에 대한 "true"는 절대 없어야 합니다.

서빙

boolean

서빙은 끝점의 종료 상태에 관계없이 설정되어 있다는 점을 제외하고는 준비와 동일합니다. 이 조건은 종료 중인 준비된 끝점에 대해 true로 설정해야 합니다. nil인 경우 소비자는 ready 상태로 지연해야 합니다.

종료

boolean

종료는 이 끝점이 종료되었음을 나타냅니다. nil 값은 알 수 없는 상태를 나타냅니다. 소비자는 이 알 수 없는 상태를 해석하여 끝점이 종료되지 않음을 의미합니다.

9.1.4. .endpoints[].hints

설명
EndpointHints는 끝점을 사용하는 방법을 설명하는 힌트를 제공합니다.
유형
object
속성유형설명

forZones

array

forZones는 토폴로지 인식 라우팅을 활성화하기 위해 이 끝점이 사용해야 하는 영역을 나타냅니다.

forZones[]

object

ForZone은 이 엔드포인트를 사용해야 하는 영역에 대한 정보를 제공합니다.

9.1.5. .endpoints[].hints.forZones

설명
forZones는 토폴로지 인식 라우팅을 활성화하기 위해 이 끝점이 사용해야 하는 영역을 나타냅니다.
유형
array

9.1.6. .endpoints[].hints.forZones[]

설명
ForZone은 이 엔드포인트를 사용해야 하는 영역에 대한 정보를 제공합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 영역의 이름을 나타냅니다.

9.1.7. .ports

설명
ports는 이 슬라이스의 각 끝점에 의해 노출되는 네트워크 포트 목록을 지정합니다. 각 포트에는 고유한 이름이 있어야 합니다. 포트가 비어 있으면 정의된 포트가 없음을 나타냅니다. port가 nil 포트 값으로 정의되면 "모든 포트"를 나타냅니다. 각 슬라이스에는 최대 100개의 포트가 포함될 수 있습니다.
유형
array

9.1.8. .ports[]

설명
EndpointPort는 EndpointSlice에서 사용하는 포트를 나타냅니다.
유형
object
속성유형설명

appProtocol

string

이 포트의 애플리케이션 프로토콜입니다. 이는 구현이 이해할 수 있는 프로토콜에 대해 보다 풍부한 동작을 제공하기 위한 힌트로 사용됩니다. 이 필드는 표준 Kubernetes 라벨 구문을 따릅니다. 유효한 값은 다음 중 하나입니다.

* UN-prefixed 프로토콜 이름 - IANA 표준 서비스 이름(RFC-6335 및 https://www.iana.org/assignments/service-names)용으로 예약되어 있습니다.

* Kubernetes 정의 접두사 이름: * 'kubernetes.io/h2c' - https://www.rfc-editor.org/rfc/rfc7540 * 'kubernetes.io/ws'에 설명된 대로 https://www.rfc-editor.org/rfc/rfc7540 * 'kubernetes.io/ws' - WebSocket over cleartext에 설명된 대로 https://www.rfc-editor.org/rfc/rfc6455 * 'kubernetes.io/wsss' - WebSocket over TLS에 설명된 대로 일반 텍스트보다 일반 텍스트보다 HTTP/2보다 일반 텍스트보다 HTTP/2입니다.

* 다른 프로토콜은 mycompany.com/my-custom-protocol과 같은 구현 정의 접두사 이름을 사용해야 합니다.

name

string

name은 이 포트의 이름을 나타냅니다. EndpointSlice의 모든 포트에는 고유한 이름이 있어야 합니다. Kubernetes 서비스에서 EndpointSlice가 파생되면 Service.ports[].name에 해당합니다. name은 빈 문자열이거나 DNS_LABEL 유효성 검사를 전달해야 합니다. * 길이는 63자 이하여야 합니다. * 소문자 영숫자 또는 '-'로 구성되어야 합니다. * 영숫자 문자로 시작하고 끝나야 합니다. 기본값은 빈 문자열입니다.

port

integer

port는 끝점의 포트 번호를 나타냅니다. 이 값을 지정하지 않으면 포트가 제한되지 않으며 특정 소비자의 컨텍스트에서 해석되어야 합니다.

protocol

string

protocol은 이 포트의 IP 프로토콜을 나타냅니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 TCP입니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

9.2. API 끝점

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

  • /apis/discovery.k8s.io/v1/endpointslices

    • GET: EndpointSlice 유형의 오브젝트 목록 또는 감시
  • /apis/discovery.k8s.io/v1/watch/endpointslices

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

    • DELETE: EndpointSlice 컬렉션 삭제
    • GET: EndpointSlice 유형의 오브젝트 목록 또는 감시
    • POST: EndpointSlice 생성
  • /apis/discovery.k8s.io/v1/watch/namespaces/{namespace}/endpointslices

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

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

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

9.2.1. /apis/discovery.k8s.io/v1/endpointslices

HTTP 방법
GET
설명
EndpointSlice 유형의 오브젝트 목록 또는 감시
표 9.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

EndpointSliceList schema

401 - 무단

9.2.2. /apis/discovery.k8s.io/v1/watch/endpointslices

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

200 - OK

WatchEvent 스키마

401 - 무단

9.2.3. /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices

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

dryRun

string

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

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

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
EndpointSlice 유형의 오브젝트 목록 또는 감시
표 9.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

EndpointSliceList schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EndpointSlice 스키마

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

200 - OK

EndpointSlice 스키마

201 - 생성됨

EndpointSlice 스키마

202 - 승인됨

EndpointSlice 스키마

401 - 무단

9.2.4. /apis/discovery.k8s.io/v1/watch/namespaces/{namespace}/endpointslices

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

200 - OK

WatchEvent 스키마

401 - 무단

9.2.5. /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices/{name}

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

name

string

EndpointSlice의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

EndpointSlice 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

EndpointSlice 스키마

201 - 생성됨

EndpointSlice 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EndpointSlice 스키마

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

200 - OK

EndpointSlice 스키마

201 - 생성됨

EndpointSlice 스키마

401 - 무단

9.2.6. /apis/discovery.k8s.io/v1/watch/namespaces/{namespace}/endpointslices/{name}

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

name

string

EndpointSlice의 이름

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

200 - OK

WatchEvent 스키마

401 - 무단

10장. EgressRouter [network.operator.openshift.io/v1]

설명
EgressRouter는 사용자가 pod와 외부 시스템 간의 브리지 역할을 하는 송신 라우터를 정의할 수 있는 기능입니다. 송신 라우터는 Pod 또는 Pod 그룹에서 구성별로 원격 외부 시스템 또는 여러 대상으로 발생하는 송신 트래픽을 리디렉션하는 서비스를 실행합니다. cluster-network-operator에서 사용합니다. 구체적으로는 <name>이 있는 EgressRouter CR을 통해 CNO는 생성 및 관리: - <name>이라는 송신 Pod - <name> - 호환성 수준 1: 호환성 수준 1: Stable이라는 송신 Pod는 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)에 대한 주요 릴리스 내에서 사용할 수 있습니다. EgressRouter는 단일 egressrouter Pod 구성 오브젝트입니다.
유형
object
필수 항목
  • spec

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

원하는 송신 라우터의 사양입니다.

status

object

EgressRouter의 상태를 확인합니다.

10.1.1. .spec

설명
원하는 송신 라우터의 사양입니다.
유형
object
필수 항목
  • 주소
  • mode
  • networkInterface
속성유형설명

주소

array

Pod의 보조 인터페이스에서 구성할 IP 주소 목록입니다.

addresses[]

object

EgressRouterAddress에는 라우터 인터페이스에서 구성할 IP CIDR 및 게이트웨이 쌍이 포함되어 있습니다.

mode

string

모드는 송신 라우터에 사용되는 모드를 표시합니다. 기본 모드는 "Redirect"이며 현재 지원되는 유일한 모드입니다.

networkInterface

object

생성/사용할 인터페이스의 사양입니다. 기본값은 macvlan입니다. 현재 macvlan만 지원됩니다.

리디렉션

object

redirect는 리디렉션 모드와 관련된 구성 매개 변수를 나타냅니다.

10.1.2. .spec.addresses

설명
Pod의 보조 인터페이스에서 구성할 IP 주소 목록입니다.
유형
array

10.1.3. .spec.addresses[]

설명
EgressRouterAddress에는 라우터 인터페이스에서 구성할 IP CIDR 및 게이트웨이 쌍이 포함되어 있습니다.
유형
object
필수 항목
  • ip
속성유형설명

gateway

string

자동으로 확인할 수 없는 경우 next-hop 게이트웨이의 IP 주소입니다. IPv4 또는 IPv6일 수 있습니다.

ip

string

IP는 라우터 인터페이스에서 구성할 주소입니다. IPv4 또는 IPv6일 수 있습니다.

10.1.4. .spec.networkInterface

설명
생성/사용할 인터페이스의 사양입니다. 기본값은 macvlan입니다. 현재 macvlan만 지원됩니다.
유형
object
속성유형설명

macvlan

object

interfaceType macvlan와 관련된 인수

10.1.5. .spec.networkInterface.macvlan

설명
interfaceType macvlan와 관련된 인수
유형
object
필수 항목
  • mode
속성유형설명

master

string

마스터 인터페이스의 이름입니다. IP 주소에서 유추할 수 있는 경우 지정할 필요가 없습니다.

mode

string

모드는 macvlan 인터페이스에 사용되는 모드를 표시합니다. 브리지|Private|VEPA|Passthru. 기본 모드는 "Bridge"입니다.

10.1.6. .spec.redirect

설명
redirect는 리디렉션 모드와 관련된 구성 매개 변수를 나타냅니다.
유형
object
속성유형설명

fallbackIP

string

fallbackIP는 원격 대상의 IP 주소를 지정합니다. IPv4 또는 IPv6일 수 있습니다. 리디렉션 규칙이 지정되지 않은 경우 라우터의 모든 트래픽이 이 IP로 리디렉션됩니다. 리디렉션 규칙이 지정되면 라우터의 다른 포트(규칙에 정의되지 않음)의 모든 연결이 이 IP로 리디렉션됩니다. 리디렉션 규칙이 지정되고 대체 IP가 제공되지 않으면 다른 포트의 연결이 간단히 거부됩니다.

redirectRules

array

Pod에서 리디렉션 모드에서 대상으로 DNAT 리디렉션을 정의하는 L4RedirectRules 목록입니다.

redirectRules[]

object

L4RedirectRule은 지정된 포트에서 대상 IP 및 포트로의 DNAT 리디렉션을 정의합니다.

10.1.7. .spec.redirect.redirectRules

설명
Pod에서 리디렉션 모드에서 대상으로 DNAT 리디렉션을 정의하는 L4RedirectRules 목록입니다.
유형
array

10.1.8. .spec.redirect.redirectRules[]

설명
L4RedirectRule은 지정된 포트에서 대상 IP 및 포트로의 DNAT 리디렉션을 정의합니다.
유형
object
필수 항목
  • destinationIP
  • port
  • protocol
속성유형설명

destinationIP

string

IP는 원격 대상의 IP 주소를 지정합니다. IPv4 또는 IPv6일 수 있습니다.

port

integer

port는 클라이언트가 리디렉션할 트래픽을 보내야 하는 포트 번호입니다.

protocol

string

프로토콜은 TCP, SCTP 또는 UDP일 수 있습니다.

targetPort

integer

targetPort를 사용하면 트래픽이 리디렉션되는 원격 대상의 포트 번호를 지정할 수 있습니다. 지정되지 않은 경우 "Port"의 값이 사용됩니다.

10.1.9. .status

설명
EgressRouter의 상태를 확인합니다.
유형
object
필수 항목
  • conditions
속성유형설명

conditions

array

송신 라우터의 상태

conditions[]

object

EgressRouterStatusCondition은 송신 라우터의 관리 및 모니터링 구성 요소의 상태를 나타냅니다.

10.1.10. .status.conditions

설명
송신 라우터의 상태
유형
array

10.1.11. .status.conditions[]

설명
EgressRouterStatusCondition은 송신 라우터의 관리 및 모니터링 구성 요소의 상태를 나타냅니다.
유형
object
필수 항목
  • status
  • type
속성유형설명

lastTransitionTime

``

LastTransitionTime은 현재 상태 속성에 대한 마지막 업데이트 시간입니다.

message

string

message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다. 새 줄로 렌더링되어야 하는 줄 Feed 문자(U+000A)가 포함될 수 있습니다.

reason

string

이유는 조건의 현재 상태에 대한 CamelCase 이유입니다.

status

string

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

type

string

type은 이 조건에서 보고한 측면을 지정합니다. Available, Progressing, Degraded 중 하나

10.2. API 끝점

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

  • /apis/network.operator.openshift.io/v1/egressrouters

    • GET: 종류의 EgressRouter 오브젝트 나열
  • /apis/network.operator.openshift.io/v1/namespaces/{namespace}/egressrouters

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

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

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

10.2.1. /apis/network.operator.openshift.io/v1/egressrouters

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

200 - OK

EgressRouterList 스키마

401 - 무단

10.2.2. /apis/network.operator.openshift.io/v1/namespaces/{namespace}/egressrouters

HTTP 방법
DELETE
설명
EgressRouter 컬렉션 삭제
표 10.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

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

200 - OK

EgressRouterList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressRouter 스키마

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

200 - OK

EgressRouter 스키마

201 - 생성됨

EgressRouter 스키마

202 - 승인됨

EgressRouter 스키마

401 - 무단

10.2.3. /apis/network.operator.openshift.io/v1/namespaces/{namespace}/egressrouters/{name}

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

name

string

EgressRouter의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

EgressRouter 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

EgressRouter 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressRouter 스키마

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

200 - OK

EgressRouter 스키마

201 - 생성됨

EgressRouter 스키마

401 - 무단

10.2.4. /apis/network.operator.openshift.io/v1/namespaces/{namespace}/egressrouters/{name}/status

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

name

string

EgressRouter의 이름

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

200 - OK

EgressRouter 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

EgressRouter 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

EgressRouter 스키마

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

200 - OK

EgressRouter 스키마

201 - 생성됨

EgressRouter 스키마

401 - 무단

11장. Ingress [networking.k8s.io/v1]

설명
Ingress는 인바운드 연결이 백엔드에서 정의한 엔드포인트에 도달할 수 있도록 하는 규칙 컬렉션입니다. 외부에서 접근할 수 있는 URL, 로드 밸런싱 트래픽, SSL 종료, 이름 기반 가상 호스팅 등을 제공하도록 Ingress를 구성할 수 있습니다.
유형
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

IngressSpec은 사용자가 원하는 Ingress를 설명합니다.

status

object

IngressStatus는 Ingress의 현재 상태를 설명합니다.

11.1.1. .spec

설명
IngressSpec은 사용자가 원하는 Ingress를 설명합니다.
유형
object
속성유형설명

defaultBackend

object

IngressBackend는 지정된 서비스 및 포트의 모든 끝점을 설명합니다.

ingressClassName

string

ingressClassName은 IngressClass 클러스터 리소스의 이름입니다. Ingress 컨트롤러 구현에서는 이 필드를 사용하여 전송 연결(controller → IngressClass → Ingress 리소스)을 통해 이 Ingress 리소스를 제공해야 하는지 여부를 확인합니다. kubernetes.io/ingress.class 주석(간단한 상수 이름)은 공식적으로 정의되지 않았지만 Ingress 컨트롤러에서 Ingress 컨트롤러와 Ingress 리소스 간의 직접 바인딩을 생성하는 것이 널리 지원되었습니다. 새로 생성된 Ingress 리소스는 필드를 사용하는 것이 좋습니다. 그러나 이전 버전과의 호환성을 위해 주석이 공식적으로 더 이상 사용되지 않지만 Ingress 컨트롤러는 있는 경우 해당 주석을 계속 준수해야 합니다.

규칙

array

규칙은 Ingress를 구성하는 데 사용되는 호스트 규칙 목록입니다. 지정되지 않았거나 규칙이 일치하지 않으면 모든 트래픽이 기본 백엔드로 전송됩니다.

rules[]

object

IngressRule은 지정된 호스트의 경로를 관련 백엔드 서비스에 매핑하는 규칙을 나타냅니다. 들어오는 요청은 먼저 호스트 일치에 대해 평가된 다음 일치하는 IngressRuleValue와 연결된 백엔드로 라우팅됩니다.

tls

array

TLS는 TLS 구성을 나타냅니다. 현재 Ingress는 단일 TLS 포트 443만 지원합니다. 이 목록의 여러 멤버가 다른 호스트를 지정하는 경우 수신 컨트롤러가 SNI를 지원하는 경우 SNI TLS 확장을 통해 지정된 호스트 이름에 따라 동일한 포트에서 멀티플렉싱됩니다.

tls[]

object

IngressTLS는 수신과 관련된 전송 계층 보안을 설명합니다.

11.1.2. .spec.defaultBackend

설명
IngressBackend는 지정된 서비스 및 포트의 모든 끝점을 설명합니다.
유형
object
속성유형설명

resource

TypedLocalObjectReference

resource는 Ingress 오브젝트의 네임스페이스에 있는 다른 Kubernetes 리소스에 대한 ObjectRef입니다. 리소스가 지정된 경우 service.Name 및 service.Port를 지정할 수 없습니다. 이는 "Service"와 함께 사용할 수 있는 설정입니다.

서비스

object

IngressServiceBackend는 Kubernetes 서비스를 백엔드로 참조합니다.

11.1.3. .spec.defaultBackend.service

설명
IngressServiceBackend는 Kubernetes 서비스를 백엔드로 참조합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 서비스입니다. 서비스는 Ingress 오브젝트와 동일한 네임스페이스에 있어야 합니다.

port

object

ServiceBackendPort는 참조 중인 서비스 포트입니다.

11.1.4. .spec.defaultBackend.service.port

설명
ServiceBackendPort는 참조 중인 서비스 포트입니다.
유형
object
속성유형설명

name

string

name은 서비스에 있는 포트의 이름입니다. 이는 "Number"와 함께 상호 배타적인 설정입니다.

number

integer

number는 서비스의 숫자 포트 번호(예: 80)입니다. 이는 "Name"과 함께 사용할 수 있는 설정입니다.

11.1.5. .spec.rules

설명
규칙은 Ingress를 구성하는 데 사용되는 호스트 규칙 목록입니다. 지정되지 않았거나 규칙이 일치하지 않으면 모든 트래픽이 기본 백엔드로 전송됩니다.
유형
array

11.1.6. .spec.rules[]

설명
IngressRule은 지정된 호스트의 경로를 관련 백엔드 서비스에 매핑하는 규칙을 나타냅니다. 들어오는 요청은 먼저 호스트 일치에 대해 평가된 다음 일치하는 IngressRuleValue와 연결된 백엔드로 라우팅됩니다.
유형
object
속성유형설명

host

string

host는 RFC 3986에 정의된 네트워크 호스트의 정규화된 도메인 이름입니다. RFC 3986: 1에 정의된 URI의 "호스트" 부분에서의 다음 편차에 유의하십시오. IP는 허용되지 않습니다. 현재 IngressRuleValue는 상위 Ingress 사양의 IP에만 적용할 수 있습니다. 2. 포트가 허용되지 않기 때문에 구분 기호는 보장되지 않습니다. 현재 Ingress의 포트는 https의 경우 http 및 :443의 경우 암시적으로 :80입니다. 이 두 가지는 나중에 변경될 수 있습니다. IngressRuleValue 전에 들어오는 요청은 호스트와 일치됩니다. 호스트를 지정하지 않으면 Ingress는 지정된 IngressRuleValue를 기반으로 모든 트래픽을 라우팅합니다.

호스트는 네트워크 호스트의 종료점(예: "foo.bar.com") 또는 "wildcard"(예: ".foo.foo.com")로 접두사가 지정된 도메인 이름 없이 도메인 이름인 "precise"일 수 있습니다. 와일드카드 문자 ''는 그 자체로 첫 번째 DNS 레이블로 표시되어야 하며 단일 레이블과 일치해야 합니다. 와일드카드 레이블 자체(예: Host == "*")를 포함할 수 없습니다. 요청은 다음과 같은 방식으로 Host 필드와 일치됩니다. 1. host가 정확하면 http 호스트 헤더가 Host와 같은 경우 요청이 이 규칙과 일치합니다. 2. host가 와일드카드인 경우 http 호스트 헤더가 와일드카드 규칙의 접미사(첫 번째 레이블 제거)와 같은 경우 요청은 이 규칙과 일치합니다.

http

object

HTTPIngressRuleValue는 백엔드를 가리키는 http 선택기 목록입니다. 예제에서 http://<host>/<path>?<searchpart > → URL의 일부가 RFC 3986에 해당하는 백엔드에서 이 리소스는 마지막 '/' 이후의 모든 항목과 일치시키는 데 사용됩니다.

11.1.7. .spec.rules[].http

설명
HTTPIngressRuleValue는 백엔드를 가리키는 http 선택기 목록입니다. 예제에서 http://<host>/<path>?<searchpart > → URL의 일부가 RFC 3986에 해당하는 백엔드에서 이 리소스는 마지막 '/' 이후의 모든 항목과 일치시키는 데 사용됩니다.
유형
object
필수 항목
  • 경로
속성유형설명

경로

array

경로는 요청을 백엔드에 매핑하는 경로 컬렉션입니다.

paths[]

object

HTTPIngressPath는 경로를 백엔드와 연결합니다. 경로와 일치하는 들어오는 URL은 백엔드로 전달됩니다.

11.1.8. .spec.rules[].http.paths

설명
경로는 요청을 백엔드에 매핑하는 경로 컬렉션입니다.
유형
array

11.1.9. .spec.rules[].http.paths[]

설명
HTTPIngressPath는 경로를 백엔드와 연결합니다. 경로와 일치하는 들어오는 URL은 백엔드로 전달됩니다.
유형
object
필수 항목
  • pathType
  • 백엔드
속성유형설명

백엔드

object

IngressBackend는 지정된 서비스 및 포트의 모든 끝점을 설명합니다.

path

string

경로는 들어오는 요청 경로와 일치합니다. 현재 RFC 3986에서 정의한 URL의 기존 "path" 부분에서 허용되지 않은 문자를 포함할 수 있습니다. 경로는 '/'로 시작해야 하며 값 "Exact" 또는 "Prefix"와 함께 PathType을 사용할 때 존재해야 합니다.

pathType

string

pathType은 일치하는 경로의 해석을 결정합니다. pathType은 다음 값 중 하나일 수 있습니다. * Exact: URL 경로가 정확히 일치합니다. * 접두사: '/'로 분할되는 URL 경로 접두사에 따라 일치합니다. 일치는 요소별로 경로 요소에 따라 수행됩니다. 경로 요소는 경로의 레이블 목록을 '/' 구분 기호로 나눈 값입니다. 요청은 모든 p가 요청 경로 p의 element-wise 접두사인 경우 경로 p에 대한 일치입니다. 경로의 마지막 요소가 요청 경로의 마지막 요소의 하위 요소인 경우 일치하는 항목이 아닙니다(예: /foo/bar/baz와 /foo/bar/baz와 일치하지만 /foo/barbaz와 일치하지 않음). * ImplementationSpecific: 경로 일치의 상호 운용성은 IngressClass에 따라 다릅니다. 구현은 이를 별도의 PathType으로 처리하거나 Prefix 또는 Exact 경로 유형과 동일하게 처리할 수 있습니다. 구현은 모든 경로 유형을 지원하는 데 필요합니다.

가능한 enum 값: - "Exact" 는 URL 경로와 대소문자를 정확히 일치시킵니다. - "ImplementationSpecific" 일치는 IngressClass까지입니다. 구현은 이를 별도의 PathType으로 처리하거나 Prefix 또는 Exact 경로 유형과 동일하게 처리할 수 있습니다. - "Prefix" 는 '/'로 분할되는 URL 경로 접두사를 기반으로 일치합니다. 일치는 대소문자를 구분하고 요소별로 경로 요소에서 수행됩니다. path 요소는 경로의 레이블 목록을 '/' 구분 기호로 나눕니다. 요청은 모든 p가 요청 경로 p의 element-wise 접두사인 경우 경로 p에 대한 일치입니다. 경로의 마지막 요소가 요청 경로의 마지막 요소의 하위 요소인 경우 일치하는 항목이 아닙니다(예: /foo/bar/baz와 /foo/bar/baz와 일치하지만 /foo/barbaz와 일치하지 않음). Ingress 사양에 일치하는 경로가 여러 개 있는 경우 가장 긴 일치 경로가 우선순위가 부여됩니다. 예: - /foo/barbar does not match requests to /foo/baraz - /foo/bar /foo/bar matches request to /foo/bar/baz - /foo 및 /foo/ 두 항목 모두 /foo 및 /foo/에 대한 요청을 일치시킵니다. Ingress 사양에 두 경로가 모두 있는 경우 가장 긴 일치 경로(/foo/)가 우선 순위가 지정됩니다.

11.1.10. .spec.rules[].http.paths[].backend

설명
IngressBackend는 지정된 서비스 및 포트의 모든 끝점을 설명합니다.
유형
object
속성유형설명

resource

TypedLocalObjectReference

resource는 Ingress 오브젝트의 네임스페이스에 있는 다른 Kubernetes 리소스에 대한 ObjectRef입니다. 리소스가 지정된 경우 service.Name 및 service.Port를 지정할 수 없습니다. 이는 "Service"와 함께 사용할 수 있는 설정입니다.

서비스

object

IngressServiceBackend는 Kubernetes 서비스를 백엔드로 참조합니다.

11.1.11. .spec.rules[].http.paths[].backend.service

설명
IngressServiceBackend는 Kubernetes 서비스를 백엔드로 참조합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 서비스입니다. 서비스는 Ingress 오브젝트와 동일한 네임스페이스에 있어야 합니다.

port

object

ServiceBackendPort는 참조 중인 서비스 포트입니다.

11.1.12. .spec.rules[].http.paths[].backend.service.port

설명
ServiceBackendPort는 참조 중인 서비스 포트입니다.
유형
object
속성유형설명

name

string

name은 서비스에 있는 포트의 이름입니다. 이는 "Number"와 함께 상호 배타적인 설정입니다.

number

integer

number는 서비스의 숫자 포트 번호(예: 80)입니다. 이는 "Name"과 함께 사용할 수 있는 설정입니다.

11.1.13. .spec.tls

설명
TLS는 TLS 구성을 나타냅니다. 현재 Ingress는 단일 TLS 포트 443만 지원합니다. 이 목록의 여러 멤버가 다른 호스트를 지정하는 경우 수신 컨트롤러가 SNI를 지원하는 경우 SNI TLS 확장을 통해 지정된 호스트 이름에 따라 동일한 포트에서 멀티플렉싱됩니다.
유형
array

11.1.14. .spec.tls[]

설명
IngressTLS는 수신과 관련된 전송 계층 보안을 설명합니다.
유형
object
속성유형설명

호스트

배열(문자열)

호스트는 TLS 인증서에 포함된 호스트 목록입니다. 이 목록의 값은 tlsSecret에 사용된 name/s와 일치해야 합니다. 지정되지 않은 경우 기본값은 loadbalancer 컨트롤러의 와일드카드 호스트 설정을 통해 이 Ingress를 이행합니다.

secretName

string

secretName은 포트 443에서 TLS 트래픽을 종료하는 데 사용되는 시크릿의 이름입니다. SNI 호스트 이름만으로 TLS 라우팅을 허용하는 필드는 선택 사항입니다. 리스너의 SNI 호스트가 IngressRule에서 사용하는 "Host" 헤더 필드와 충돌하는 경우 SNI 호스트는 종료에 사용되며 "Host" 헤더의 값이 라우팅에 사용됩니다.

11.1.15. .status

설명
IngressStatus는 Ingress의 현재 상태를 설명합니다.
유형
object
속성유형설명

loadBalancer

object

IngressLoadBalancerStatus는 로드 밸런서의 상태를 나타냅니다.

11.1.16. .status.loadBalancer

설명
IngressLoadBalancerStatus는 로드 밸런서의 상태를 나타냅니다.
유형
object
속성유형설명

Ingress

array

Ingress는 로드 밸런서에 대한 수신 지점을 포함하는 목록입니다.

ingress[]

object

IngressLoadBalancerIngress는 로드 밸런서 인그레스 지점의 상태를 나타냅니다.

11.1.17. .status.loadBalancer.ingress

설명
Ingress는 로드 밸런서에 대한 수신 지점을 포함하는 목록입니다.
유형
array

11.1.18. .status.loadBalancer.ingress[]

설명
IngressLoadBalancerIngress는 로드 밸런서 인그레스 지점의 상태를 나타냅니다.
유형
object
속성유형설명

hostname

string

호스트 이름은 DNS 기반 로드 밸런서 인그레스 지점에 대해 설정됩니다.

ip

string

IP는 IP 기반 로드 밸런서 인그레스 지점에 대해 설정됩니다.

포트

array

포트는 이 LoadBalancer에서 노출하는 포트에 대한 정보를 제공합니다.

ports[]

object

IngressPortStatus는 서비스 포트의 오류 조건을 나타냅니다.

11.1.19. .status.loadBalancer.ingress[].ports

설명
포트는 이 LoadBalancer에서 노출하는 포트에 대한 정보를 제공합니다.
유형
array

11.1.20. .status.loadBalancer.ingress[].ports[]

설명
IngressPortStatus는 서비스 포트의 오류 조건을 나타냅니다.
유형
object
필수 항목
  • port
  • protocol
속성유형설명

error

string

Error is to record the problem with the service port The format of the error should comply with the following rules: - built-in error values should be specified in this file and those must use CamelCase name - cloud provider specific error values must have names that comply with the format foo.example.com/CamelCase.

port

integer

port는 Ingress 포트의 포트 번호입니다.

protocol

string

protocol은 Ingress 포트의 프로토콜입니다. 지원되는 값은 "TCP", "UDP", "SCTP"입니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

11.2. API 끝점

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

  • /apis/networking.k8s.io/v1/ingresses

    • GET: Ingress 유형의 오브젝트 목록 또는 감시
  • /apis/networking.k8s.io/v1/watch/ingresses

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

    • DELETE: Ingress의 컬렉션 삭제
    • GET: Ingress 유형의 오브젝트 목록 또는 감시
    • POST: Ingress 생성
  • /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/ingresses

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

    • DELETE: Ingress 삭제
    • GET: 지정된 Ingress 읽기
    • PATCH: 지정된 Ingress를 부분적으로 업데이트
    • PUT: 지정된 Ingress를 교체
  • /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/ingresses/{name}

    • GET: 더 이상 사용되지 않는 종류의 오브젝트를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}/status

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

11.2.1. /apis/networking.k8s.io/v1/ingresses

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

200 - OK

IngressList 스키마

401 - 무단

11.2.2. /apis/networking.k8s.io/v1/watch/ingresses

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

200 - OK

WatchEvent 스키마

401 - 무단

11.2.3. /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses

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

dryRun

string

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

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

200 - OK

상태 스키마

401 - 무단

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

200 - OK

IngressList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

Ingress 스키마

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

200 - OK

Ingress 스키마

201 - 생성됨

Ingress 스키마

202 - 승인됨

Ingress 스키마

401 - 무단

11.2.4. /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/ingresses

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

200 - OK

WatchEvent 스키마

401 - 무단

11.2.5. /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}

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

name

string

Ingress의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

Ingress 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

Ingress 스키마

201 - 생성됨

Ingress 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

Ingress 스키마

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

200 - OK

Ingress 스키마

201 - 생성됨

Ingress 스키마

401 - 무단

11.2.6. /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/ingresses/{name}

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

name

string

Ingress의 이름

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

200 - OK

WatchEvent 스키마

401 - 무단

11.2.7. /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}/status

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

name

string

Ingress의 이름

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

200 - OK

Ingress 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

Ingress 스키마

201 - 생성됨

Ingress 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

Ingress 스키마

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

200 - OK

Ingress 스키마

201 - 생성됨

Ingress 스키마

401 - 무단

12장. IngressClass [networking.k8s.io/v1]

설명
IngressClass는 Ingress Spec에서 참조하는 Ingress의 클래스를 나타냅니다. ingressclass.kubernetes.io/is-default-class 주석을 사용하여 IngressClass를 기본값으로 간주해야 함을 나타낼 수 있습니다. 단일 IngressClass 리소스에 이 주석이 true로 설정되면 클래스가 지정되지 않은 새 Ingress 리소스에 이 기본 클래스가 할당됩니다.
유형
object

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

IngressClassSpec은 Ingress의 클래스에 대한 정보를 제공합니다.

12.1.1. .spec

설명
IngressClassSpec은 Ingress의 클래스에 대한 정보를 제공합니다.
유형
object
속성유형설명

controller

string

컨트롤러는 이 클래스를 처리해야 하는 컨트롤러의 이름을 나타냅니다. 이렇게 하면 동일한 컨트롤러에서 제어하는 다른 "flavors"가 허용됩니다. 예를 들어 동일한 구현 컨트롤러에 대한 매개변수가 다를 수 있습니다. 이는 "acme.io/ingress-controller"와 같이 250자를 초과할 수 없는 도메인 접두사 경로로 지정해야 합니다. 이 필드는 변경할 수 없습니다.

parameters

object

IngressClassParametersReference는 API 오브젝트를 식별합니다. 클러스터 또는 네임스페이스 범위 리소스를 지정하는 데 사용할 수 있습니다.

12.1.2. .spec.parameters

설명
IngressClassParametersReference는 API 오브젝트를 식별합니다. 클러스터 또는 네임스페이스 범위 리소스를 지정하는 데 사용할 수 있습니다.
유형
object
필수 항목
  • kind
  • name
속성유형설명

apiGroup

string

apiGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다.

kind

string

kind는 참조되는 리소스 유형입니다.

name

string

name은 참조 중인 리소스의 이름입니다.

네임스페이스

string

네임스페이스는 참조 중인 리소스의 네임스페이스입니다. 이 필드는 범위가 "Namespace"로 설정될 때 필요하며 범위가 "Cluster"로 설정된 경우 설정되지 않아야 합니다.

scope

string

범위는 클러스터 또는 네임스페이스 범위 리소스를 참조하는지 여부를 나타냅니다. 이는 "Cluster"(기본값) 또는 "Namespace"로 설정할 수 있습니다.

12.2. API 끝점

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

  • /apis/networking.k8s.io/v1/ingressclasses

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

    • GET: individual changes to a list of IngressClass. deprecated: 대신 list 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/networking.k8s.io/v1/ingressclasses/{name}

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

    • GET: 더 이상 사용되지 않는 종류의 오브젝트를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.

12.2.1. /apis/networking.k8s.io/v1/ingressclasses

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

dryRun

string

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

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

200 - OK

상태 스키마

401 - 무단

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

200 - OK

IngressClassList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

IngressClass 스키마

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

200 - OK

IngressClass 스키마

201 - 생성됨

IngressClass 스키마

202 - 승인됨

IngressClass 스키마

401 - 무단

12.2.2. /apis/networking.k8s.io/v1/watch/ingressclasses

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

200 - OK

WatchEvent 스키마

401 - 무단

12.2.3. /apis/networking.k8s.io/v1/ingressclasses/{name}

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

name

string

IngressClass의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

IngressClass 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

IngressClass 스키마

201 - 생성됨

IngressClass 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

IngressClass 스키마

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

200 - OK

IngressClass 스키마

201 - 생성됨

IngressClass 스키마

401 - 무단

12.2.4. /apis/networking.k8s.io/v1/watch/ingressclasses/{name}

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

name

string

IngressClass의 이름

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

200 - OK

WatchEvent 스키마

401 - 무단

13장. IPPool [whereabouts.cni.cncf.io/v1alpha1]

설명
IPPool은 ippools API의 스키마입니다.
유형
object

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

IPPoolSpec은 원하는 IPPool 상태를 정의합니다.

13.1.1. .spec

설명
IPPoolSpec은 원하는 IPPool 상태를 정의합니다.
유형
object
필수 항목
  • 할당
  • range
속성유형설명

할당

object

할당은 지정된 범위에 할당된 IP 세트입니다. 해당 인덱스의 인덱스는 풀 범위에 대해 동일한 index/offset를 사용하여 IP에 직접 매핑됩니다.

할당{}

object

IPAllocation은 특정 IP의 pod/container 소유자에 대한 메타데이터를 나타냅니다.

range

string

범위는 CIDR 표기법의 IP 주소 및 접두사 길이를 나타내는 RFC 4632/4291-style 문자열입니다.

13.1.2. .spec.allocations

설명
할당은 지정된 범위에 할당된 IP 세트입니다. 해당 인덱스의 인덱스는 풀 범위에 대해 동일한 index/offset를 사용하여 IP에 직접 매핑됩니다.
유형
object

13.1.3. .spec.allocations{}

설명
IPAllocation은 특정 IP의 pod/container 소유자에 대한 메타데이터를 나타냅니다.
유형
object
필수 항목
  • id
  • podref
속성유형설명

id

string

 

ifname

string

 

podref

string

 

13.2. API 끝점

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

  • /apis/whereabouts.cni.cncf.io/v1alpha1/ippools

    • GET: 종류 IPPool의 오브젝트 나열
  • /apis/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/ippools

    • DELETE: IPPool의 컬렉션 삭제
    • GET: 종류 IPPool의 오브젝트 나열
    • POST: IPPool 생성
  • /apis/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/ippools/{name}

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

13.2.1. /apis/whereabouts.cni.cncf.io/v1alpha1/ippools

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

200 - OK

IPPoolList 스키마

401 - 무단

13.2.2. /apis/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/ippools

HTTP 방법
DELETE
설명
IPPool 컬렉션 삭제
표 13.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

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

200 - OK

IPPoolList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

IPPool 스키마

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

200 - OK

IPPool 스키마

201 - 생성됨

IPPool 스키마

202 - 승인됨

IPPool 스키마

401 - 무단

13.2.3. /apis/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/ippools/{name}

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

name

string

IPPool의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

IPPool 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

IPPool 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 IPPool을 바꿉니다.
표 13.13. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

IPPool 스키마

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

200 - OK

IPPool 스키마

201 - 생성됨

IPPool 스키마

401 - 무단

14장. NetworkAttachmentDefinition [k8s.cni.cncf.io/v1]

설명
NetworkAttachmentDefinition은 하나 이상의 논리적 또는 물리적 네트워크에 Pod를 연결하기 위한 의도를 표현하기 위해 Network Plumbing Working Group에서 지정하는 CRD 스키마입니다. 자세한 내용은 https://github.com/k8snetworkplumbingwg/multi-net-spec에서 확인할 수 있습니다.
유형
object

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

NetworkAttachmentDefinition 사양은 네트워크 연결의 원하는 상태를 정의합니다.

14.1.1. .spec

설명
NetworkAttachmentDefinition 사양은 네트워크 연결의 원하는 상태를 정의합니다.
유형
object
속성유형설명

config

string

NetworkAttachmentDefinition 구성은 JSON 형식의 CNI 구성입니다.

14.2. API 끝점

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

  • /apis/k8s.cni.cncf.io/v1/network-attachment-definitions

    • GET: 종류의 NetworkAttachmentDefinition 오브젝트 나열
  • /apis/k8s.cni.cncf.io/v1/namespaces/{namespace}/network-attachment-definitions

    • DELETE: NetworkAttachmentDefinition의 컬렉션 삭제
    • GET: 종류의 NetworkAttachmentDefinition 오브젝트 나열
    • POST: NetworkAttachmentDefinition 생성
  • /apis/k8s.cni.cncf.io/v1/namespaces/{namespace}/network-attachment-definitions/{name}

    • DELETE: NetworkAttachmentDefinition 삭제
    • GET: 지정된 NetworkAttachmentDefinition 읽기
    • PATCH: 지정된 NetworkAttachmentDefinition을 부분적으로 업데이트
    • PUT: 지정된 NetworkAttachmentDefinition을 대체합니다.

14.2.1. /apis/k8s.cni.cncf.io/v1/network-attachment-definitions

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

200 - OK

NetworkAttachmentDefinitionList 스키마

401 - 무단

14.2.2. /apis/k8s.cni.cncf.io/v1/namespaces/{namespace}/network-attachment-definitions

HTTP 방법
DELETE
설명
NetworkAttachmentDefinition 컬렉션 삭제
표 14.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

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

200 - OK

NetworkAttachmentDefinitionList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

NetworkAttachmentDefinition 스키마

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

200 - OK

NetworkAttachmentDefinition 스키마

201 - 생성됨

NetworkAttachmentDefinition 스키마

202 - 승인됨

NetworkAttachmentDefinition 스키마

401 - 무단

14.2.3. /apis/k8s.cni.cncf.io/v1/namespaces/{namespace}/network-attachment-definitions/{name}

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

name

string

NetworkAttachmentDefinition의 이름

HTTP 방법
DELETE
설명
delete a NetworkAttachmentDefinition
표 14.8. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

NetworkAttachmentDefinition 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

NetworkAttachmentDefinition 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 NetworkAttachmentDefinition을 대체합니다.
표 14.13. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

NetworkAttachmentDefinition 스키마

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

200 - OK

NetworkAttachmentDefinition 스키마

201 - 생성됨

NetworkAttachmentDefinition 스키마

401 - 무단

15장. NetworkPolicy [networking.k8s.io/v1]

설명
NetworkPolicy는 일련의 Pod에 허용되는 네트워크 트래픽을 설명합니다.
유형
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

NetworkPolicySpec은 NetworkPolicy 사양을 제공합니다.

15.1.1. .spec

설명
NetworkPolicySpec은 NetworkPolicy 사양을 제공합니다.
유형
object
필수 항목
  • podSelector
속성유형설명

egress

array

egress는 선택한 Pod에 적용할 송신 규칙 목록입니다. Pod(및 클러스터 정책)를 선택하는 NetworkPolicies가 없거나 트래픽이 Pod와 일치하는 모든 NetworkPolicy 오브젝트에서 하나 이상의 송신 규칙과 일치하는 경우 발신 트래픽이 허용됩니다. 이 필드가 비어 있으면 이 NetworkPolicy는 모든 발신 트래픽을 제한하고 선택한 Pod가 기본적으로 격리되도록만 사용됩니다. 이 필드는 1.8의 베타 수준입니다.

egress[]

object

NetworkPolicyEgressRule은 NetworkPolicySpec의 podSelector와 일치하는 Pod가 없는 특정 트래픽 세트를 설명합니다. 트래픽은 포트 및 에 모두 일치해야 합니다. 이 유형은 1.8의 베타 수준입니다.

Ingress

array

Ingress는 선택한 Pod에 적용할 수신 규칙 목록입니다. Pod(및 클러스터 정책)를 선택하는 NetworkPolicies가 없거나 트래픽 소스가 Pod의 로컬 노드인 경우 또는 podSelector가 Pod와 일치하는 모든 NetworkPolicy 오브젝트에서 하나 이상의 수신 규칙과 일치하는 경우 트래픽이 포드에 허용됩니다. 이 필드가 비어 있으면 이 NetworkPolicy는 트래픽을 허용하지 않습니다. 선택한 Pod가 기본적으로 격리되도록만 사용됩니다.

ingress[]

object

NetworkPolicyIngressRule은 NetworkPolicySpec의 podSelector와 일치하는 Pod에 허용되는 특정 트래픽 세트를 설명합니다. 트래픽은 포트 및 의 포트와 일치해야 합니다.

podSelector

LabelSelector

podSelector는 이 NetworkPolicy 오브젝트가 적용되는 Pod를 선택합니다. 수신 규칙 배열은 이 필드에서 선택한 모든 Pod에 적용됩니다. 여러 네트워크 정책에서 동일한 Pod 세트를 선택할 수 있습니다. 이 경우 각각에 대한 수신 규칙은 추가적으로 결합됩니다. 이 필드는 선택 사항이 아니며 표준 라벨 선택기 의미 체계를 따릅니다. 빈 podSelector는 이 네임스페이스의 모든 Pod와 일치합니다.

policyTypes

배열(문자열)

policyTypes는 NetworkPolicy와 관련된 규칙 유형 목록입니다. 유효한 옵션은 ["Ingress"], ["Egress"] 또는 ["Ingress", "Egress"]입니다. 이 필드를 지정하지 않으면 수신 또는 송신 규칙의 존재 여부에 따라 기본적으로 설정됩니다. 송신 섹션이 포함된 정책은 송신에 영향을 미치는 것으로 간주되며( ingress 섹션이 포함되어 있는지 여부) 모든 정책( ingress 섹션이 포함되어 있는지 여부)은 수신에 영향을 미치는 것으로 간주됩니다. 송신 전용 정책을 작성하려면 policyTypes [ "Egress" ]를 명시적으로 지정해야 합니다. 마찬가지로 송신이 허용되지 않도록 지정하는 정책을 작성하려는 경우 "Egress"를 포함하는 policyTypes 값을 지정해야 합니다(이러한 정책에 송신 섹션이 포함되지 않고 기본값인 경우 [Ingress"]로 기본 설정됨). 이 필드는 1.8의 베타 수준입니다.

15.1.2. .spec.egress

설명
egress는 선택한 Pod에 적용할 송신 규칙 목록입니다. Pod(및 클러스터 정책)를 선택하는 NetworkPolicies가 없거나 트래픽이 Pod와 일치하는 모든 NetworkPolicy 오브젝트에서 하나 이상의 송신 규칙과 일치하는 경우 발신 트래픽이 허용됩니다. 이 필드가 비어 있으면 이 NetworkPolicy는 모든 발신 트래픽을 제한하고 선택한 Pod가 기본적으로 격리되도록만 사용됩니다. 이 필드는 1.8의 베타 수준입니다.
유형
array

15.1.3. .spec.egress[]

설명
NetworkPolicyEgressRule은 NetworkPolicySpec의 podSelector와 일치하는 Pod가 없는 특정 트래픽 세트를 설명합니다. 트래픽은 포트 및 에 모두 일치해야 합니다. 이 유형은 1.8의 베타 수준입니다.
유형
object
속성유형설명

포트

array

포트는 발신 트래픽의 대상 포트 목록입니다. 이 목록의 각 항목은 논리 OR를 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 포트와 일치합니다(포트로 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 목록의 하나 이상의 포트와 일치하는 경우에만 트래픽을 허용합니다.

ports[]

object

NetworkPolicyPort는 트래픽을 허용하는 포트를 설명합니다.

다음으로 변경

array

to는 이 규칙에 대해 선택된 포드의 발신 트래픽의 대상 목록입니다. 이 목록의 항목은 논리 OR 작업을 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 대상과 일치합니다(대상에 의해 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 목록에서 하나 이상의 항목과 일치하는 경우에만 트래픽을 허용합니다.

to[]

object

NetworkPolicyPeer는 트래픽을/에서 허용할 피어를 설명합니다. 특정 필드 조합만 허용됩니다.

15.1.4. .spec.egress[].ports

설명
포트는 발신 트래픽의 대상 포트 목록입니다. 이 목록의 각 항목은 논리 OR를 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 포트와 일치합니다(포트로 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 목록의 하나 이상의 포트와 일치하는 경우에만 트래픽을 허용합니다.
유형
array

15.1.5. .spec.egress[].ports[]

설명
NetworkPolicyPort는 트래픽을 허용하는 포트를 설명합니다.
유형
object
속성유형설명

endPort

integer

endPort는 정책에 의해 설정된 경우 포트에서 endPort까지의 포트 범위가 허용됨을 나타냅니다. port 필드가 정의되지 않았거나 port 필드가 이름이 지정된 (문자열) 포트로 정의된 경우 이 필드를 정의할 수 없습니다. endPort는 포트보다 크거나 같아야 합니다.

port

IntOrString

port는 지정된 프로토콜의 포트를 나타냅니다. Pod에서 숫자 또는 이름이 지정된 포트일 수 있습니다. 이 필드를 제공하지 않으면 모든 포트 이름과 숫자와 일치합니다. 있는 경우 지정된 프로토콜 및 포트의 트래픽만 일치합니다.

protocol

string

protocol은 트래픽이 일치해야 하는 프로토콜(TCP, UDP 또는 SCTP)을 나타냅니다. 지정하지 않으면 이 필드는 기본적으로 TCP로 설정됩니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

15.1.6. .spec.egress[].to

설명
to는 이 규칙에 대해 선택된 포드의 발신 트래픽의 대상 목록입니다. 이 목록의 항목은 논리 OR 작업을 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 대상과 일치합니다(대상에 의해 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 목록에서 하나 이상의 항목과 일치하는 경우에만 트래픽을 허용합니다.
유형
array

15.1.7. .spec.egress[].to[]

설명
NetworkPolicyPeer는 트래픽을/에서 허용할 피어를 설명합니다. 특정 필드 조합만 허용됩니다.
유형
object
속성유형설명

ipBlock

object

IPBlock은 특정 CIDR을 설명합니다(Ex. NetworkPolicySpec의 podSelector와 일치하는 Pod에 허용되는 "192.168.1.0/24","2001:db8::/64"). except 항목은 이 규칙에 포함되지 않아야 하는 CIDR을 설명합니다.

namespaceSelector

LabelSelector

namespaceSelector는 클러스터 범위 레이블을 사용하여 네임스페이스를 선택합니다. 이 필드는 표준 라벨 선택기 의미 체계를 따릅니다. 존재하지만 비어 있으면 모든 네임스페이스를 선택합니다.

podSelector도 설정된 경우 전체 NetworkPolicyPeer는 namespaceSelector에서 선택한 네임스페이스에서 podSelector와 일치하는 Pod를 선택합니다. 그러지 않으면 namespaceSelector에서 선택한 네임스페이스의 모든 Pod를 선택합니다.

podSelector

LabelSelector

podSelector는 Pod를 선택하는 라벨 선택기입니다. 이 필드는 표준 라벨 선택기 의미 체계를 따릅니다. 존재하지만 비어 있으면 모든 Pod를 선택합니다.

namespaceSelector도 설정된 경우 전체 NetworkPolicyPeer는 NamespaceSelector에서 선택한 네임스페이스에서 podSelector와 일치하는 Pod를 선택합니다. 그러지 않으면 정책의 자체 네임스페이스에서 podSelector와 일치하는 Pod를 선택합니다.

15.1.8. .spec.egress[].to[].ipBlock

설명
IPBlock은 특정 CIDR을 설명합니다(Ex. NetworkPolicySpec의 podSelector와 일치하는 Pod에 허용되는 "192.168.1.0/24","2001:db8::/64"). except 항목은 이 규칙에 포함되지 않아야 하는 CIDR을 설명합니다.
유형
object
필수 항목
  • cidr
속성유형설명

cidr

string

CIDR은 IPBlock Valid 예제를 나타내는 문자열입니다 "192.168.1.0/24" 또는 "2001:db8::/64"

except

배열(문자열)

IPBlock Valid 예제에 포함되지 않아야 하는 CIDR 슬라이스를 제외하면 "192.168.1.0/24" 또는 "2001:db8::/64" Except 값이 cidr 범위 외부에 있는 경우 거부됩니다.

15.1.9. .spec.ingress

설명
Ingress는 선택한 Pod에 적용할 수신 규칙 목록입니다. Pod(및 클러스터 정책)를 선택하는 NetworkPolicies가 없거나 트래픽 소스가 Pod의 로컬 노드인 경우 또는 podSelector가 Pod와 일치하는 모든 NetworkPolicy 오브젝트에서 하나 이상의 수신 규칙과 일치하는 경우 트래픽이 포드에 허용됩니다. 이 필드가 비어 있으면 이 NetworkPolicy는 트래픽을 허용하지 않습니다. 선택한 Pod가 기본적으로 격리되도록만 사용됩니다.
유형
array

15.1.10. .spec.ingress[]

설명
NetworkPolicyIngressRule은 NetworkPolicySpec의 podSelector와 일치하는 Pod에 허용되는 특정 트래픽 세트를 설명합니다. 트래픽은 포트 및 의 포트와 일치해야 합니다.
유형
object
속성유형설명

from

array

에서 이 규칙에 대해 선택한 포드에 액세스할 수 있어야 하는 소스 목록입니다. 이 목록의 항목은 논리 OR 작업을 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 소스와 일치합니다(소스로 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 from 목록의 하나 이상의 항목과 일치하는 경우에만 트래픽을 허용합니다.

from[]

object

NetworkPolicyPeer는 트래픽을/에서 허용할 피어를 설명합니다. 특정 필드 조합만 허용됩니다.

포트

array

포트는 이 규칙에 대해 선택한 Pod에서 액세스할 수 있어야 하는 포트 목록입니다. 이 목록의 각 항목은 논리 OR를 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 포트와 일치합니다(포트로 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 목록의 하나 이상의 포트와 일치하는 경우에만 트래픽을 허용합니다.

ports[]

object

NetworkPolicyPort는 트래픽을 허용하는 포트를 설명합니다.

15.1.11. .spec.ingress[].from

설명
에서 이 규칙에 대해 선택한 포드에 액세스할 수 있어야 하는 소스 목록입니다. 이 목록의 항목은 논리 OR 작업을 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 소스와 일치합니다(소스로 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 from 목록의 하나 이상의 항목과 일치하는 경우에만 트래픽을 허용합니다.
유형
array

15.1.12. .spec.ingress[].from[]

설명
NetworkPolicyPeer는 트래픽을/에서 허용할 피어를 설명합니다. 특정 필드 조합만 허용됩니다.
유형
object
속성유형설명

ipBlock

object

IPBlock은 특정 CIDR을 설명합니다(Ex. NetworkPolicySpec의 podSelector와 일치하는 Pod에 허용되는 "192.168.1.0/24","2001:db8::/64"). except 항목은 이 규칙에 포함되지 않아야 하는 CIDR을 설명합니다.

namespaceSelector

LabelSelector

namespaceSelector는 클러스터 범위 레이블을 사용하여 네임스페이스를 선택합니다. 이 필드는 표준 라벨 선택기 의미 체계를 따릅니다. 존재하지만 비어 있으면 모든 네임스페이스를 선택합니다.

podSelector도 설정된 경우 전체 NetworkPolicyPeer는 namespaceSelector에서 선택한 네임스페이스에서 podSelector와 일치하는 Pod를 선택합니다. 그러지 않으면 namespaceSelector에서 선택한 네임스페이스의 모든 Pod를 선택합니다.

podSelector

LabelSelector

podSelector는 Pod를 선택하는 라벨 선택기입니다. 이 필드는 표준 라벨 선택기 의미 체계를 따릅니다. 존재하지만 비어 있으면 모든 Pod를 선택합니다.

namespaceSelector도 설정된 경우 전체 NetworkPolicyPeer는 NamespaceSelector에서 선택한 네임스페이스에서 podSelector와 일치하는 Pod를 선택합니다. 그러지 않으면 정책의 자체 네임스페이스에서 podSelector와 일치하는 Pod를 선택합니다.

15.1.13. .spec.ingress[].from[].ipBlock

설명
IPBlock은 특정 CIDR을 설명합니다(Ex. NetworkPolicySpec의 podSelector와 일치하는 Pod에 허용되는 "192.168.1.0/24","2001:db8::/64"). except 항목은 이 규칙에 포함되지 않아야 하는 CIDR을 설명합니다.
유형
object
필수 항목
  • cidr
속성유형설명

cidr

string

CIDR은 IPBlock Valid 예제를 나타내는 문자열입니다 "192.168.1.0/24" 또는 "2001:db8::/64"

except

배열(문자열)

IPBlock Valid 예제에 포함되지 않아야 하는 CIDR 슬라이스를 제외하면 "192.168.1.0/24" 또는 "2001:db8::/64" Except 값이 cidr 범위 외부에 있는 경우 거부됩니다.

15.1.14. .spec.ingress[].ports

설명
포트는 이 규칙에 대해 선택한 Pod에서 액세스할 수 있어야 하는 포트 목록입니다. 이 목록의 각 항목은 논리 OR를 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 포트와 일치합니다(포트로 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 목록의 하나 이상의 포트와 일치하는 경우에만 트래픽을 허용합니다.
유형
array

15.1.15. .spec.ingress[].ports[]

설명
NetworkPolicyPort는 트래픽을 허용하는 포트를 설명합니다.
유형
object
속성유형설명

endPort

integer

endPort는 정책에 의해 설정된 경우 포트에서 endPort까지의 포트 범위가 허용됨을 나타냅니다. port 필드가 정의되지 않았거나 port 필드가 이름이 지정된 (문자열) 포트로 정의된 경우 이 필드를 정의할 수 없습니다. endPort는 포트보다 크거나 같아야 합니다.

port

IntOrString

port는 지정된 프로토콜의 포트를 나타냅니다. Pod에서 숫자 또는 이름이 지정된 포트일 수 있습니다. 이 필드를 제공하지 않으면 모든 포트 이름과 숫자와 일치합니다. 있는 경우 지정된 프로토콜 및 포트의 트래픽만 일치합니다.

protocol

string

protocol은 트래픽이 일치해야 하는 프로토콜(TCP, UDP 또는 SCTP)을 나타냅니다. 지정하지 않으면 이 필드는 기본적으로 TCP로 설정됩니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

15.2. API 끝점

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

  • /apis/networking.k8s.io/v1/networkpolicies

    • GET: NetworkPolicy 유형의 오브젝트 나열 또는 감시
  • /apis/networking.k8s.io/v1/watch/networkpolicies

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

    • DELETE: NetworkPolicy의 컬렉션 삭제
    • GET: NetworkPolicy 유형의 오브젝트 나열 또는 감시
    • POST: NetworkPolicy 생성
  • /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/networkpolicies

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

    • DELETE: NetworkPolicy 삭제
    • GET: 지정된 NetworkPolicy 읽기
    • PATCH: 지정된 NetworkPolicy를 부분적으로 업데이트
    • PUT: 지정된 NetworkPolicy를 교체
  • /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/networkpolicies/{name}

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

15.2.1. /apis/networking.k8s.io/v1/networkpolicies

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

200 - OK

NetworkPolicyList 스키마

401 - 무단

15.2.2. /apis/networking.k8s.io/v1/watch/networkpolicies

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

200 - OK

WatchEvent 스키마

401 - 무단

15.2.3. /apis/networking.k8s.io/v1/namespaces/{namespace}/networkpolicies

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

dryRun

string

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

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

200 - OK

상태 스키마

401 - 무단

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

200 - OK

NetworkPolicyList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

NetworkPolicy 스키마

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

200 - OK

NetworkPolicy 스키마

201 - 생성됨

NetworkPolicy 스키마

202 - 승인됨

NetworkPolicy 스키마

401 - 무단

15.2.4. /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/networkpolicies

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

200 - OK

WatchEvent 스키마

401 - 무단

15.2.5. /apis/networking.k8s.io/v1/namespaces/{namespace}/networkpolicies/{name}

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

name

string

NetworkPolicy의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

NetworkPolicy 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

NetworkPolicy 스키마

201 - 생성됨

NetworkPolicy 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

NetworkPolicy 스키마

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

200 - OK

NetworkPolicy 스키마

201 - 생성됨

NetworkPolicy 스키마

401 - 무단

15.2.6. /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/networkpolicies/{name}

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

name

string

NetworkPolicy의 이름

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

200 - OK

WatchEvent 스키마

401 - 무단

16장. OverlappingRangeIPReservation [whereabouts.cni.cncf.io/v1alpha1]

설명
OverlappingRangeIPReservation은 OverlappingRangeIPReservations API의 스키마입니다.
유형
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

OverlappingRangeIPReservationSpec은 원하는 상태 OverlappingRangeIPReservation을 정의합니다.

16.1.1. .spec

설명
OverlappingRangeIPReservationSpec은 원하는 상태 OverlappingRangeIPReservation을 정의합니다.
유형
object
필수 항목
  • podref
속성유형설명

containerid

string

 

ifname

string

 

podref

string

 

16.2. API 끝점

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

  • /apis/whereabouts.cni.cncf.io/v1alpha1/overlappingrangeipreservations

    • GET: OverlappingRangeIPReservation 유형의 오브젝트 나열
  • /apis/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/overlappingrangeipreservations

    • DELETE: OverlappingRangeIPReservation의 컬렉션 삭제
    • GET: OverlappingRangeIPReservation 유형의 오브젝트 나열
    • POST: OverlappingRangeIPReservation 생성
  • /APIs/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/overlappingrangeipreservations/{name}

    • DELETE: OverlappingRangeIPReservation 삭제
    • GET: 지정된 OverlappingRangeIPReservation을 읽습니다.
    • PATCH: 지정된 OverlappingRangeIPReservation을 부분적으로 업데이트
    • PUT: 지정된 OverlappingRangeIPReservation을 교체

16.2.1. /apis/whereabouts.cni.cncf.io/v1alpha1/overlappingrangeipreservations

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

200 - OK

OverlappingRangeIPReservationList 스키마

401 - 무단

16.2.2. /apis/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/overlappingrangeipreservations

HTTP 방법
DELETE
설명
OverlappingRangeIPReservation 컬렉션 삭제
표 16.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

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

200 - OK

OverlappingRangeIPReservationList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

OverlappingRangeIPReservation 스키마

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

200 - OK

OverlappingRangeIPReservation 스키마

201 - 생성됨

OverlappingRangeIPReservation 스키마

202 - 승인됨

OverlappingRangeIPReservation 스키마

401 - 무단

16.2.3. /apis/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/overlappingrangeipreservations/{name}

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

name

string

OverlappingRangeIPReservation 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

OverlappingRangeIPReservation 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

OverlappingRangeIPReservation 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

OverlappingRangeIPReservation 스키마

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

200 - OK

OverlappingRangeIPReservation 스키마

201 - 생성됨

OverlappingRangeIPReservation 스키마

401 - 무단

17장. PodNetworkConnectivityCheck [controlplane.operator.openshift.io/v1alpha1]

설명
PodNetworkConnectivityCheck 호환성 수준 4: 호환성이 제공되지 않으므로 언제든지 API를 변경할 수 있습니다. 이러한 기능은 장기 지원이 필요한 애플리케이션에서 사용해서는 안 됩니다.
유형
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은 연결 검사의 소스 및 대상을 정의합니다.

status

object

status에는 연결 검사의 관찰된 상태가 포함되어 있습니다.

17.1.1. .spec

설명
spec은 연결 검사의 소스 및 대상을 정의합니다.
유형
object
필수 항목
  • sourcePod
  • targetEndpoint
속성유형설명

sourcePod

string

sourcePod는 조건을 확인할 Pod의 이름을 지정합니다.

targetEndpoint

string

확인할 EndpointAddress입니다. host:port 형식의 TCP 주소입니다. host가 DNS 이름인 경우 DNS 이름을 확인할 수 없는 경우 검사가 실패합니다. DNS 이름 조회를 바이패스하려면 호스트의 IP 주소를 지정합니다.

tlsClientCert

object

tlsClientCert를 지정하면 엔드포인트 프로세스에서 과도하게 로그인하지 않고 클라이언트 인증서가 필요한 엔드포인트를 확인할 때 사용할 선택적 TLS 클라이언트 인증서 및 키가 포함된 'tls.crt' 및 'tls.key' 항목이 있는 kubernetes.io/tls 유형 시크릿을 참조합니다. 보안은 이 리소스와 동일한 네임스페이스에 있어야 합니다.

17.1.2. .spec.tlsClientCert

설명
tlsClientCert를 지정하면 엔드포인트 프로세스에서 과도하게 로그인하지 않고 클라이언트 인증서가 필요한 엔드포인트를 확인할 때 사용할 선택적 TLS 클라이언트 인증서 및 키가 포함된 'tls.crt' 및 'tls.key' 항목이 있는 kubernetes.io/tls 유형 시크릿을 참조합니다. 보안은 이 리소스와 동일한 네임스페이스에 있어야 합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

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

17.1.3. .status

설명
status에는 연결 검사의 관찰된 상태가 포함되어 있습니다.
유형
object
속성유형설명

conditions

array

검사 상태 요약

conditions[]

object

PodNetworkConnectivityCheckCondition은 Pod 네트워크 연결의 전체 상태를 나타냅니다.

실패

array

실패에 실패한 검사 작업의 로그가 포함됩니다.

failures[]

object

LogEntry 레코드 이벤트

중단

array

중단에 대한 로그가 포함됩니다.

outages[]

object

OutageEntry는 중단의 기간을 기록합니다.

성공

array

성공 사례에는 성공적인 검사 작업 로그가 포함되어 있습니다.

successes[]

object

LogEntry 레코드 이벤트

17.1.4. .status.conditions

설명
검사 상태 요약
유형
array

17.1.5. .status.conditions[]

설명
PodNetworkConnectivityCheckCondition은 Pod 네트워크 연결의 전체 상태를 나타냅니다.
유형
object
필수 항목
  • status
  • type
속성유형설명

lastTransitionTime

``

조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다.

message

string

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

reason

string

조건의 마지막 상태 전환이 머신에서 읽을 수 있는 형식으로 전환되기 때문입니다.

status

string

조건의 상태

type

string

조건의 유형

17.1.6. .status.failures

설명
실패에 실패한 검사 작업의 로그가 포함됩니다.
유형
array

17.1.7. .status.failures[]

설명
LogEntry 레코드 이벤트
유형
object
필수 항목
  • success
속성유형설명

latency

``

대기 시간은 항목에 언급된 작업이 걸린 시간을 기록합니다.

message

string

사람이 읽을 수 있는 형식으로 상태를 설명하는 메시지입니다.

reason

string

머신에서 읽을 수 있는 형식의 상태 때문입니다.

success

boolean

성공은 로그 항목이 성공 또는 실패를 나타내는지 여부를 나타냅니다.

time

``

검사 작업의 시작 시간입니다.

17.1.8. .status.outages

설명
중단에 대한 로그가 포함됩니다.
유형
array

17.1.9. .status.outages[]

설명
OutageEntry는 중단의 기간을 기록합니다.
유형
object
속성유형설명

end

``

감지된 중단 종료

endLogs

array

endLogs에는 이 중단의 끝과 관련된 로그 항목이 포함되어 있습니다. 중단을 해결한 성공 항목과 일부 실패 로그 항목이 선행되어야 합니다.

endLogs[]

object

LogEntry 레코드 이벤트

message

string

메시지에는 사람이 읽을 수 있는 형식으로 중단 세부 정보가 요약되어 있습니다.

start

``

감지된 중단 시작

startLogs

array

startLogs에는 이 중단 시작과 관련된 로그 항목이 포함되어 있습니다. 원래 실패, 실패 모드가 변경된 모든 항목이 포함되어야 합니다.

startLogs[]

object

LogEntry 레코드 이벤트

17.1.10. .status.outages[].endLogs

설명
endLogs에는 이 중단의 끝과 관련된 로그 항목이 포함되어 있습니다. 중단을 해결한 성공 항목과 일부 실패 로그 항목이 선행되어야 합니다.
유형
array

17.1.11. .status.outages[].endLogs[]

설명
LogEntry 레코드 이벤트
유형
object
필수 항목
  • success
속성유형설명

latency

``

대기 시간은 항목에 언급된 작업이 걸린 시간을 기록합니다.

message

string

사람이 읽을 수 있는 형식으로 상태를 설명하는 메시지입니다.

reason

string

머신에서 읽을 수 있는 형식의 상태 때문입니다.

success

boolean

성공은 로그 항목이 성공 또는 실패를 나타내는지 여부를 나타냅니다.

time

``

검사 작업의 시작 시간입니다.

17.1.12. .status.outages[].startLogs

설명
startLogs에는 이 중단 시작과 관련된 로그 항목이 포함되어 있습니다. 원래 실패, 실패 모드가 변경된 모든 항목이 포함되어야 합니다.
유형
array

17.1.13. .status.outages[].startLogs[]

설명
LogEntry 레코드 이벤트
유형
object
필수 항목
  • success
속성유형설명

latency

``

대기 시간은 항목에 언급된 작업이 걸린 시간을 기록합니다.

message

string

사람이 읽을 수 있는 형식으로 상태를 설명하는 메시지입니다.

reason

string

머신에서 읽을 수 있는 형식의 상태 때문입니다.

success

boolean

성공은 로그 항목이 성공 또는 실패를 나타내는지 여부를 나타냅니다.

time

``

검사 작업의 시작 시간입니다.

17.1.14. .status.successes

설명
성공 사례에는 성공적인 검사 작업 로그가 포함되어 있습니다.
유형
array

17.1.15. .status.successes[]

설명
LogEntry 레코드 이벤트
유형
object
필수 항목
  • success
속성유형설명

latency

``

대기 시간은 항목에 언급된 작업이 걸린 시간을 기록합니다.

message

string

사람이 읽을 수 있는 형식으로 상태를 설명하는 메시지입니다.

reason

string

머신에서 읽을 수 있는 형식의 상태 때문입니다.

success

boolean

성공은 로그 항목이 성공 또는 실패를 나타내는지 여부를 나타냅니다.

time

``

검사 작업의 시작 시간입니다.

17.2. API 끝점

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

  • /apis/controlplane.operator.openshift.io/v1alpha1/podnetworkconnectivitychecks

    • GET: PodNetworkConnectivityCheck 유형의 오브젝트 나열
  • /APIs/controlplane.operator.openshift.io/v1alpha1/namespaces/{namespace}/podnetworkconnectivitychecks

    • DELETE: PodNetworkConnectivityCheck의 컬렉션 삭제
    • GET: PodNetworkConnectivityCheck 유형의 오브젝트 나열
    • POST: PodNetworkConnectivityCheck 생성
  • /APIs/controlplane.operator.openshift.io/v1alpha1/namespaces/{namespace}/podnetworkconnectivitychecks/{name}

    • DELETE: delete a PodNetworkConnectivityCheck
    • GET: 지정된 PodNetworkConnectivityCheck 읽기
    • PATCH: 지정된 PodNetworkConnectivityCheck를 부분적으로 업데이트
    • PUT: 지정된 PodNetworkConnectivityCheck로 교체
  • /APIs/controlplane.operator.openshift.io/v1alpha1/namespaces/{namespace}/podnetworkconnectivitychecks/{name}/status

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

17.2.1. /apis/controlplane.operator.openshift.io/v1alpha1/podnetworkconnectivitychecks

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

200 - OK

PodNetworkConnectivityCheckList schema

401 - 무단

17.2.2. /APIs/controlplane.operator.openshift.io/v1alpha1/namespaces/{namespace}/podnetworkconnectivitychecks

HTTP 방법
DELETE
설명
PodNetworkConnectivityCheck 컬렉션 삭제
표 17.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

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

200 - OK

PodNetworkConnectivityCheckList schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

PodNetworkConnectivityCheck schema

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

200 - OK

PodNetworkConnectivityCheck schema

201 - 생성됨

PodNetworkConnectivityCheck schema

202 - 승인됨

PodNetworkConnectivityCheck schema

401 - 무단

17.2.3. /APIs/controlplane.operator.openshift.io/v1alpha1/namespaces/{namespace}/podnetworkconnectivitychecks/{name}

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

name

string

PodNetworkConnectivityCheck의 이름

HTTP 방법
DELETE
설명
delete a PodNetworkConnectivityCheck
표 17.8. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

PodNetworkConnectivityCheck schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

PodNetworkConnectivityCheck schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

PodNetworkConnectivityCheck schema

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

200 - OK

PodNetworkConnectivityCheck schema

201 - 생성됨

PodNetworkConnectivityCheck schema

401 - 무단

17.2.4. /APIs/controlplane.operator.openshift.io/v1alpha1/namespaces/{namespace}/podnetworkconnectivitychecks/{name}/status

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

name

string

PodNetworkConnectivityCheck의 이름

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

200 - OK

PodNetworkConnectivityCheck schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

PodNetworkConnectivityCheck schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

PodNetworkConnectivityCheck schema

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

200 - OK

PodNetworkConnectivityCheck schema

201 - 생성됨

PodNetworkConnectivityCheck schema

401 - 무단

18장. Route [route.openshift.io/v1]

설명

경로를 사용하면 개발자가 HTTP(S)에서 공용 DNS 항목을 통해 로드 밸런싱 및 프록시 계층을 인식하여 서비스를 노출할 수 있습니다. 경로는 TLS 옵션 및 인증서를 추가로 지정하거나 라우터에서 HTTP 및 HTTPS 트래픽에 대해 수락해야 하는 공용 CNAME을 지정할 수 있습니다. 관리자는 일반적으로 라우터가 클러스터 방화벽 외부에 표시되도록 구성하고 서비스 콘텐츠에 보안, 캐싱 또는 트래픽 제어를 추가할 수도 있습니다. 라우터는 일반적으로 서비스 엔드포인트와 직접 통신합니다.

경로가 생성되면 호스트 필드가 변경되지 않을 수 있습니다. 일반적으로 라우터는 충돌을 해결할 때 지정된 호스트에서 가장 오래된 경로를 사용합니다.

라우터는 추가 사용자 지정의 영향을 받으며 annotations 필드를 통해 추가 제어를 지원할 수 있습니다.

관리자는 여러 라우터를 구성할 수 있으므로 경로 상태 필드는 각 라우터의 경로 이름 및 상태에 대한 정보를 클라이언트에 반환하는 데 사용됩니다. 예를 들어 클라이언트가 중복 이름을 선택하는 경우 경로 상태 조건이 사용하여 경로를 선택할 수 없음을 나타냅니다.

경로에서 HTTP/2 ALPN을 활성화하려면 사용자 정의 (비위 카드) 인증서가 필요합니다. 이렇게 하면 클라이언트가 연결을 병합할 수 없으며 특히 웹 브라우저도 마찬가지입니다. 연결 재사용/커밋의 위험 때문에 기본 인증서를 사용하는 경로에서 HTTP/2 ALPN을 지원하지 않습니다. 자체 사용자 지정 인증서가 없는 경로는 프런트 엔드 또는 백엔드에서 HTTP/2 ALPN을 사용할 수 없습니다.

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

RouteSpec은 경로가 노출하는 호스트 이름 또는 경로, 보안 정보 및 경로가 가리키는 1~4개의 백엔드(서비스)를 설명합니다. 요청은 각 백엔드에 할당된 가중치에 따라 백엔드 간에 배포됩니다. 라운드 로빈 스케줄링을 사용하는 경우 각 백엔드로 이동하는 요청 부분은 백엔드 가중치를 모든 백엔드 가중치의 합계로 나눈 값입니다. 백엔드에 끝점이 두 개 이상 있는 경우 백엔드에서 종료되는 요청은 엔드포인트 간에 라운드 로빈 방식으로 배포됩니다. 가중치는 기본값 100을 사용하여 0에서 256 사이입니다. weight 0으로 인해 백엔드에 대한 요청이 발생하지 않습니다. 모든 가중치가 0이면 경로에 백엔드가 없는 것으로 간주되고 표준 503 응답을 반환합니다.

tls 필드는 선택 사항이며 경로에 대한 특정 인증서 또는 동작을 허용합니다. 일반적으로 라우터는 명시적 인증서 없이 경로를 종료하도록 와일드카드 도메인에 기본 인증서를 구성하지만 사용자 지정 호스트 이름은 일반적으로 통과(TLS Server-Name- Indication 필드를 통해 백엔드에 직접 트래픽 전달)를 선택하거나 인증서를 제공해야 합니다.

status

object

RouteStatus는 이를 인정하는 라우터를 포함하여 경로 상태에 대한 관련 정보를 제공합니다.

18.1.1. .spec

설명

RouteSpec은 경로가 노출하는 호스트 이름 또는 경로, 보안 정보 및 경로가 가리키는 1~4개의 백엔드(서비스)를 설명합니다. 요청은 각 백엔드에 할당된 가중치에 따라 백엔드 간에 배포됩니다. 라운드 로빈 스케줄링을 사용하는 경우 각 백엔드로 이동하는 요청 부분은 백엔드 가중치를 모든 백엔드 가중치의 합계로 나눈 값입니다. 백엔드에 끝점이 두 개 이상 있는 경우 백엔드에서 종료되는 요청은 엔드포인트 간에 라운드 로빈 방식으로 배포됩니다. 가중치는 기본값 100을 사용하여 0에서 256 사이입니다. weight 0으로 인해 백엔드에 대한 요청이 발생하지 않습니다. 모든 가중치가 0이면 경로에 백엔드가 없는 것으로 간주되고 표준 503 응답을 반환합니다.

tls 필드는 선택 사항이며 경로에 대한 특정 인증서 또는 동작을 허용합니다. 일반적으로 라우터는 명시적 인증서 없이 경로를 종료하도록 와일드카드 도메인에 기본 인증서를 구성하지만 사용자 지정 호스트 이름은 일반적으로 통과(TLS Server-Name- Indication 필드를 통해 백엔드에 직접 트래픽 전달)를 선택하거나 인증서를 제공해야 합니다.

유형
object
필수 항목
  • 다음으로 변경
속성유형설명

alternateBackends

array

alternateBackends를 사용하면 경로에 최대 3개의 추가 백엔드를 할당할 수 있습니다. 서비스 유형만 허용되며 기본적으로 서비스합니다. RouteTargetReference 오브젝트의 weight 필드를 사용하여 상대 기본 설정을 지정합니다.

alternateBackends[]

object

RouteTargetReference는 끝점으로 확인되는 대상을 지정합니다. '서비스' 유형만 허용됩니다. 'weight' 필드를 사용하여 다른 필드보다 강조하십시오.

host

string

host는 서비스를 가리키는 별칭/DNS입니다. 선택 사항입니다. 지정하지 않으면 일반적으로 경로 이름이 자동으로 선택됩니다. DNS952 하위 도메인 규칙을 따라야 합니다.

httpHeaders

object

RouteHTTPHeaders는 HTTP 헤더에 대한 정책을 정의합니다.

path

string

라우터가 감시하는 경로를 통해 서비스에 대한 트래픽을 라우팅합니다. 선택 사항

port

object

RoutePort는 라우터에서 서비스 끝점의 엔드포인트로 포트 매핑을 정의합니다.

subdomain

string

하위 도메인은 Ingress 컨트롤러의 도메인(도메인) 내에서 요청된 DNS 하위 도메인입니다. host가 설정된 경우 이 필드는 무시됩니다. 수신 컨트롤러는 제안된 이름을 무시하도록 선택할 수 있습니다. 이 경우 컨트롤러는 status.ingress 배열에서 할당된 이름을 보고하거나 경로를 허용하지 않습니다. 이 값이 설정되고 서버가 이 필드 호스트를 지원하지 않으면 자동으로 채워집니다. 그렇지 않으면 호스트는 비어 있습니다. 이 필드에는 점으로 구분된 여러 부분이 있을 수 있지만 모든 Ingress 컨트롤러가 요청을 이행할 수 있는 것은 아닙니다. 이 필드는 업데이트 경로/사용자 정의 호스트 권한이 있는 사용자를 제외하고 생성 후 변경할 수 없습니다.

예: 하위 도메인 프런트 엔드는 전체 호스트 이름 frontend. apps.mycluster.com 을 갖도록 라우터 하위 도메인 apps.mycluster.com 을 자동으로 수신합니다.

tls

object

tlsConfig는 경로를 보호하고 종료를 제공하는 데 사용되는 구성을 정의합니다.

다음으로 변경

object

RouteTargetReference는 끝점으로 확인되는 대상을 지정합니다. '서비스' 유형만 허용됩니다. 'weight' 필드를 사용하여 다른 필드보다 강조하십시오.

wildcardPolicy

string

경로에 대한 와일드카드 정책(있는 경우). 현재 'Subdomain' 또는 '없음'만 허용됩니다.

18.1.2. .spec.alternateBackends

설명
alternateBackends를 사용하면 경로에 최대 3개의 추가 백엔드를 할당할 수 있습니다. 서비스 유형만 허용되며 기본적으로 서비스합니다. RouteTargetReference 오브젝트의 weight 필드를 사용하여 상대 기본 설정을 지정합니다.
유형
array

18.1.3. .spec.alternateBackends[]

설명
RouteTargetReference는 끝점으로 확인되는 대상을 지정합니다. '서비스' 유형만 허용됩니다. 'weight' 필드를 사용하여 다른 필드보다 강조하십시오.
유형
object
필수 항목
  • kind
  • name
속성유형설명

kind

string

경로가 참조하는 대상의 유형입니다. 현재 '서비스'만 허용됩니다.

name

string

참조되는 서비스/대상의 이름(예: 서비스 이름)

weight

integer

weight는 다른 대상 참조 오브젝트에 대한 대상의 상대적 가중치를 지정하는 0에서 256, default 100 사이의 정수입니다. 0은 이 백엔드에 대한 요청을 비활성화합니다.

18.1.4. .spec.httpHeaders

설명
RouteHTTPHeaders는 HTTP 헤더에 대한 정책을 정의합니다.
유형
object
속성유형설명

작업

object

RouteHTTPHeaderActions는 HTTP 요청 및 응답 헤더에 대한 작업에 대한 구성을 정의합니다.

18.1.5. .spec.httpHeaders.actions

설명
RouteHTTPHeaderActions는 HTTP 요청 및 응답 헤더에 대한 작업에 대한 구성을 정의합니다.
유형
object
속성유형설명

요청

array

request는 수정할 HTTP 요청 헤더 목록입니다. 현재는 작업이 헤더 값 설정 또는 삭제 로 정의할 수 있습니다. 여기에 정의된 작업은 경로를 통해 수행된 모든 요청의 요청 헤더를 수정합니다. 이러한 작업은 경로를 통해 이루어진 연결, 즉 클러스터 내에 정의된 특정 경로에 적용됩니다. 현재는 작업이 헤더 값 설정 또는 삭제 로 정의할 수 있습니다. 요청 헤더에 대한 IngressController 작업 후에 경로 작업이 실행됩니다. 작업은 이 목록에 정의된 대로 순서대로 적용됩니다. 최대 20개의 요청 헤더 작업이 구성될 수 있습니다. 이 필드를 사용하여 클라이언트에서 애플리케이션으로 연결을 전달할 때 설정하거나 삭제해야 하는 HTTP 요청 헤더를 지정할 수 있습니다. 허용되는 샘플 페너는 "req.hdr" 및 "ssl_c_der"입니다. 허용되는 변환기는 "낮은" 및 "base64"입니다. 헤더 값의 예: "%[req.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]". 이 API를 사용하여 경로 리소스를 통해 직접 적용되는 요청 헤더 구성은 IngressController 또는 경로 주석의 spec.httpHeaders.actions를 통해 적용된 동일한 이름의 헤더에 대한 헤더 구성을 재정의합니다. 참고: 이 필드는 라우팅에서 TLS 패스스루를 사용하는 경우 사용할 수 없습니다.

request[]

object

RouteHTTPHeader는 HTTP 헤더를 설정하거나 삭제하기 위한 구성을 지정합니다.

응답

array

response는 수정할 HTTP 응답 헤더 목록입니다. 현재는 작업이 헤더 값 설정 또는 삭제 로 정의할 수 있습니다. 여기에서 정의된 작업은 경로를 통해 수행된 모든 요청의 응답 헤더를 수정합니다. 이러한 작업은 경로를 통해 이루어진 연결, 즉 클러스터 내에 정의된 특정 경로에 적용됩니다. 응답 헤더에 대한 IngressController 작업 전에 경로 작업이 실행됩니다. 작업은 이 목록에 정의된 대로 순서대로 적용됩니다. 최대 20개의 응답 헤더 작업이 구성될 수 있습니다. 이 필드를 사용하여 애플리케이션에서 클라이언트로 응답을 전달할 때 설정하거나 삭제해야 하는 HTTP 응답 헤더를 지정할 수 있습니다. 허용되는 샘플 페너는 "res.hdr" 및 "ssl_c_der"입니다. 허용되는 변환기는 "낮은" 및 "base64"입니다. 헤더 값의 예: "%[res.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]". 참고: 이 필드는 라우팅에서 TLS 패스스루를 사용하는 경우 사용할 수 없습니다.

response[]

object

RouteHTTPHeader는 HTTP 헤더를 설정하거나 삭제하기 위한 구성을 지정합니다.

18.1.6. .spec.httpHeaders.actions.request

설명
request는 수정할 HTTP 요청 헤더 목록입니다. 현재는 작업이 헤더 값 설정 또는 삭제 로 정의할 수 있습니다. 여기에 정의된 작업은 경로를 통해 수행된 모든 요청의 요청 헤더를 수정합니다. 이러한 작업은 경로를 통해 이루어진 연결, 즉 클러스터 내에 정의된 특정 경로에 적용됩니다. 현재는 작업이 헤더 값 설정 또는 삭제 로 정의할 수 있습니다. 요청 헤더에 대한 IngressController 작업 후에 경로 작업이 실행됩니다. 작업은 이 목록에 정의된 대로 순서대로 적용됩니다. 최대 20개의 요청 헤더 작업이 구성될 수 있습니다. 이 필드를 사용하여 클라이언트에서 애플리케이션으로 연결을 전달할 때 설정하거나 삭제해야 하는 HTTP 요청 헤더를 지정할 수 있습니다. 허용되는 샘플 페너는 "req.hdr" 및 "ssl_c_der"입니다. 허용되는 변환기는 "낮은" 및 "base64"입니다. 헤더 값의 예: "%[req.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]". 이 API를 사용하여 경로 리소스를 통해 직접 적용되는 요청 헤더 구성은 IngressController 또는 경로 주석의 spec.httpHeaders.actions를 통해 적용된 동일한 이름의 헤더에 대한 헤더 구성을 재정의합니다. 참고: 이 필드는 라우팅에서 TLS 패스스루를 사용하는 경우 사용할 수 없습니다.
유형
array

18.1.7. .spec.httpHeaders.actions.request[]

설명
RouteHTTPHeader는 HTTP 헤더를 설정하거나 삭제하기 위한 구성을 지정합니다.
유형
object
필수 항목
  • name
  • 작업
속성유형설명

작업

object

RouteHTTPHeaderActionUnion은 HTTP 헤더에서 수행할 작업을 지정합니다.

name

string

name은 작업을 수행할 헤더의 이름을 지정합니다. 해당 값은 RFC 2616 섹션 4.2에 정의된 대로 유효한 HTTP 헤더 이름이어야 합니다. 이름은 영숫자 및 다음 특수 문자 "-!#$%&'*+.^_'"로만 구성되어야 합니다. 다음 헤더 이름은 예약되어 있으며 이 API를 통해 수정할 수 없습니다: Strict-Transport-Security, Proxy, Settings, Set-Cookie. 길이가 255자 이하여야 합니다. 헤더 이름은 고유해야 합니다.

18.1.8. .spec.httpHeaders.actions.request[].action

설명
RouteHTTPHeaderActionUnion은 HTTP 헤더에서 수행할 작업을 지정합니다.
유형
object
필수 항목
  • type
속성유형설명

set

object

RouteSetHTTPHeader는 HTTP 헤더에 설정해야 하는 값을 지정합니다.

type

string

type은 헤더에 적용할 작업의 유형을 정의합니다. 가능한 값은 설정 또는 삭제입니다. set을 사용하면 HTTP 요청 및 응답 헤더를 설정할 수 있습니다. delete를 사용하면 HTTP 요청 및 응답 헤더를 삭제할 수 있습니다.

18.1.9. .spec.httpHeaders.actions.request[].action.set

설명
RouteSetHTTPHeader는 HTTP 헤더에 설정해야 하는 값을 지정합니다.
유형
object
필수 항목
  • value
속성유형설명

value

string

value는 헤더 값을 지정합니다. 동적 값을 추가할 수 있습니다. 값은 http://cbonte.github.io/haproxy-dconv/2.6/configuration.html#8.2.6 에 정의된 HAProxy 형식 문자열로 해석되며 HAProxy의 %[] 구문을 사용할 수 있으며 그렇지 않으면 https://datatracker.ietf.org/doc/html/rfc7230#section-3.2 에 정의된 유효한 HTTP 헤더 값이어야 합니다. 이 필드의 값은 길이가 16384자 이하여야 합니다. 동적 값을 보간 모든 net add 헤더의 총 크기는 IngressController의 spec.tuningOptions.headerBufferMaxRewriteBytes 값을 초과해서는 안 됩니다.

18.1.10. .spec.httpHeaders.actions.response

설명
response는 수정할 HTTP 응답 헤더 목록입니다. 현재는 작업이 헤더 값 설정 또는 삭제 로 정의할 수 있습니다. 여기에서 정의된 작업은 경로를 통해 수행된 모든 요청의 응답 헤더를 수정합니다. 이러한 작업은 경로를 통해 이루어진 연결, 즉 클러스터 내에 정의된 특정 경로에 적용됩니다. 응답 헤더에 대한 IngressController 작업 전에 경로 작업이 실행됩니다. 작업은 이 목록에 정의된 대로 순서대로 적용됩니다. 최대 20개의 응답 헤더 작업이 구성될 수 있습니다. 이 필드를 사용하여 애플리케이션에서 클라이언트로 응답을 전달할 때 설정하거나 삭제해야 하는 HTTP 응답 헤더를 지정할 수 있습니다. 허용되는 샘플 페너는 "res.hdr" 및 "ssl_c_der"입니다. 허용되는 변환기는 "낮은" 및 "base64"입니다. 헤더 값의 예: "%[res.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]". 참고: 이 필드는 라우팅에서 TLS 패스스루를 사용하는 경우 사용할 수 없습니다.
유형
array

18.1.11. .spec.httpHeaders.actions.response[]

설명
RouteHTTPHeader는 HTTP 헤더를 설정하거나 삭제하기 위한 구성을 지정합니다.
유형
object
필수 항목
  • name
  • 작업
속성유형설명

작업

object

RouteHTTPHeaderActionUnion은 HTTP 헤더에서 수행할 작업을 지정합니다.

name

string

name은 작업을 수행할 헤더의 이름을 지정합니다. 해당 값은 RFC 2616 섹션 4.2에 정의된 대로 유효한 HTTP 헤더 이름이어야 합니다. 이름은 영숫자 및 다음 특수 문자 "-!#$%&'*+.^_'"로만 구성되어야 합니다. 다음 헤더 이름은 예약되어 있으며 이 API를 통해 수정할 수 없습니다: Strict-Transport-Security, Proxy, Settings, Set-Cookie. 길이가 255자 이하여야 합니다. 헤더 이름은 고유해야 합니다.

18.1.12. .spec.httpHeaders.actions.response[].action

설명
RouteHTTPHeaderActionUnion은 HTTP 헤더에서 수행할 작업을 지정합니다.
유형
object
필수 항목
  • type
속성유형설명

set

object

RouteSetHTTPHeader는 HTTP 헤더에 설정해야 하는 값을 지정합니다.

type

string

type은 헤더에 적용할 작업의 유형을 정의합니다. 가능한 값은 설정 또는 삭제입니다. set을 사용하면 HTTP 요청 및 응답 헤더를 설정할 수 있습니다. delete를 사용하면 HTTP 요청 및 응답 헤더를 삭제할 수 있습니다.

18.1.13. .spec.httpHeaders.actions.response[].action.set

설명
RouteSetHTTPHeader는 HTTP 헤더에 설정해야 하는 값을 지정합니다.
유형
object
필수 항목
  • value
속성유형설명

value

string

value는 헤더 값을 지정합니다. 동적 값을 추가할 수 있습니다. 값은 http://cbonte.github.io/haproxy-dconv/2.6/configuration.html#8.2.6 에 정의된 HAProxy 형식 문자열로 해석되며 HAProxy의 %[] 구문을 사용할 수 있으며 그렇지 않으면 https://datatracker.ietf.org/doc/html/rfc7230#section-3.2 에 정의된 유효한 HTTP 헤더 값이어야 합니다. 이 필드의 값은 길이가 16384자 이하여야 합니다. 동적 값을 보간 모든 net add 헤더의 총 크기는 IngressController의 spec.tuningOptions.headerBufferMaxRewriteBytes 값을 초과해서는 안 됩니다.

18.1.14. .spec.port

설명
RoutePort는 라우터에서 서비스 끝점의 엔드포인트로 포트 매핑을 정의합니다.
유형
object
필수 항목
  • targetPort
속성유형설명

targetPort

IntOrString

이 경로가 가리키는 서비스에서 선택한 Pod의 대상 포트입니다. 문자열이면 대상 끝점 포트 목록에서 이름이 지정된 포트로 조회됩니다. 필수 항목

18.1.15. .spec.tls

설명
tlsConfig는 경로를 보호하고 종료를 제공하는 데 사용되는 구성을 정의합니다.
유형
object
필수 항목
  • 종료
속성유형설명

caCertificate

string

caCertificate는 인증 기관 인증서 콘텐츠를 제공합니다.

certificate

string

인증서는 인증서 콘텐츠를 제공합니다. 이는 인증서 체인이 아닌 단일 제공 인증서여야 합니다. CA 인증서를 포함하지 마십시오.

destinationCACertificate

string

destinationCACertificate는 최종 대상의 ca 인증서 내용을 제공합니다. 재암호화 종료를 사용하는 경우 라우터에서 보안 연결의 상태 점검을 위해 이 파일을 제공해야 합니다. 이 필드를 지정하지 않으면 라우터에서 자체 대상 CA를 제공하고 짧은 서비스 이름(service.namespace.svc)을 사용하여 호스트 이름 검증을 수행할 수 있으므로 인프라 생성 인증서가 자동으로 확인할 수 있습니다.

externalCertificate

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

insecureEdgeTerminationPolicy

string

insecureEdgeTerminationPolicy는 경로에 대한 비보안 연결에 필요한 동작을 나타냅니다. 각 라우터는 노출할 포트를 자체적으로 결정할 수 있지만 일반적으로 포트 80입니다.

* allow - 트래픽이 비보안 포트(edge/reencrypt terminations만 해당)의 서버로 전송됩니다(기본값). * none - 비보안 포트에는 트래픽이 허용되지 않습니다. * 리디렉션 - 클라이언트가 보안 포트로 리디렉션됩니다.

key

string

key 파일 콘텐츠 제공

종료

string

종료는 종료 유형을 나타냅니다.

* 엣지 - TLS 종료는 라우터에서 수행되며 http는 백엔드(기본값) * 패스스루와 통신하는 데 사용됩니다. TLS 종료를 제공하지 않고 라우터(기본값) * 재암호화 기능을 제공하지 않고 트래픽이 바로 대상으로 전송됩니다. 라우터 및 https는 백엔드와 통신하는 데 사용됩니다.

참고: 패스스루 종료는 httpHeader 작업과 호환되지 않음

18.1.16. .spec.tls.externalCertificate

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

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

18.1.17. .spec.to

설명
RouteTargetReference는 끝점으로 확인되는 대상을 지정합니다. '서비스' 유형만 허용됩니다. 'weight' 필드를 사용하여 다른 필드보다 강조하십시오.
유형
object
필수 항목
  • kind
  • name
속성유형설명

kind

string

경로가 참조하는 대상의 유형입니다. 현재 '서비스'만 허용됩니다.

name

string

참조되는 서비스/대상의 이름(예: 서비스 이름)

weight

integer

weight는 다른 대상 참조 오브젝트에 대한 대상의 상대적 가중치를 지정하는 0에서 256, default 100 사이의 정수입니다. 0은 이 백엔드에 대한 요청을 비활성화합니다.

18.1.18. .status

설명
RouteStatus는 이를 인정하는 라우터를 포함하여 경로 상태에 대한 관련 정보를 제공합니다.
유형
object
속성유형설명

Ingress

array

Ingress는 경로가 노출될 수 있는 위치를 설명합니다. 수신 지점 목록에 중복된 Host 또는 RouterName 값이 포함될 수 있습니다. 경로가 준비되면 실시간으로 간주됩니다.

ingress[]

object

RouteIngress는 경로가 노출되는 위치에 대한 정보를 보유합니다.

18.1.19. .status.ingress

설명
Ingress는 경로가 노출될 수 있는 위치를 설명합니다. 수신 지점 목록에 중복된 Host 또는 RouterName 값이 포함될 수 있습니다. 경로가 준비되면 실시간으로 간주됩니다.
유형
array

18.1.20. .status.ingress[]

설명
RouteIngress는 경로가 노출되는 위치에 대한 정보를 보유합니다.
유형
object
속성유형설명

conditions

array

조건은 경로의 상태이며 비어 있을 수 있습니다.

conditions[]

object

RouteIngressCondition에는 특정 라우터에서 이 경로의 현재 상태에 대한 세부 정보가 포함되어 있습니다.

host

string

host는 경로가 노출되는 호스트 문자열입니다. 이 값은 필수입니다.

routerCanonicalHostname

string

CanonicalHostname은 이 경로에 요청된 호스트의 CNAME으로 사용할 수 있는 라우터의 외부 호스트 이름입니다. 이 값은 선택 사항이며 모든 경우에 설정되지 않을 수 있습니다.

routerName

string

이름은 라우터에서 자체적으로 식별하기 위해 선택한 이름입니다. 이 값은 필수입니다.

wildcardPolicy

string

와일드카드 정책은 이 경로가 노출되는 데 허용되는 와일드카드 정책입니다.

18.1.21. .status.ingress[].conditions

설명
조건은 경로의 상태이며 비어 있을 수 있습니다.
유형
array

18.1.22. .status.ingress[].conditions[]

설명
RouteIngressCondition에는 특정 라우터에서 이 경로의 현재 상태에 대한 세부 정보가 포함되어 있습니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

lastTransitionTime

시간

이 조건이 마지막으로 전환된 RFC 3339 날짜 및 시간

message

string

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

reason

string

조건의 마지막 전환 이유는 일반적으로 사람이 읽을 수 있는 머신입니다.

status

string

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

type

string

type은 조건의 유형입니다. 현재 Admitted 또는 UnservableInFutureVersions만 제공됩니다.

18.2. API 끝점

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

  • /apis/route.openshift.io/v1/routes

    • GET: 종류의 오브젝트를 나열하거나 감시합니다.
  • /apis/route.openshift.io/v1/watch/routes

    • GET: 별도의 경로 목록을 변경합니다. 더 이상 사용되지 않는 경로 목록을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/route.openshift.io/v1/namespaces/{namespace}/routes

    • DELETE: 경로의 컬렉션 삭제
    • GET: 종류의 오브젝트를 나열하거나 감시합니다.
    • POST: 경로 생성
  • /apis/route.openshift.io/v1/watch/namespaces/{namespace}/routes

    • GET: 별도의 경로 목록을 변경합니다. 더 이상 사용되지 않는 경로 목록을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/route.openshift.io/v1/namespaces/{namespace}/routes/{name}

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

    • GET: 더 이상 사용되지 않는 Route 오브젝트를 변경합니다. 더 이상 사용되지 않는 'watch' 매개변수를 목록 작업과 함께 대신 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
  • /apis/route.openshift.io/v1/namespaces/{namespace}/routes/{name}/status

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

18.2.1. /apis/route.openshift.io/v1/routes

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

200 - OK

RouteList 스키마

401 - 무단

18.2.2. /apis/route.openshift.io/v1/watch/routes

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

200 - OK

WatchEvent 스키마

401 - 무단

18.2.3. /apis/route.openshift.io/v1/namespaces/{namespace}/routes

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

dryRun

string

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

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

200 - OK

상태 스키마

401 - 무단

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

200 - OK

RouteList 스키마

401 - 무단

HTTP 방법
POST
설명
경로 생성
표 18.6. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

경로 스키마

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

200 - OK

경로 스키마

201 - 생성됨

경로 스키마

202 - 승인됨

경로 스키마

401 - 무단

18.2.4. /apis/route.openshift.io/v1/watch/namespaces/{namespace}/routes

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

200 - OK

WatchEvent 스키마

401 - 무단

18.2.5. /apis/route.openshift.io/v1/namespaces/{namespace}/routes/{name}

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

name

string

경로 이름

HTTP 방법
DELETE
설명
경로 삭제
표 18.11. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

경로 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

경로 스키마

201 - 생성됨

경로 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

경로 스키마

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

200 - OK

경로 스키마

201 - 생성됨

경로 스키마

401 - 무단

18.2.6. /apis/route.openshift.io/v1/watch/namespaces/{namespace}/routes/{name}

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

name

string

경로 이름

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

200 - OK

WatchEvent 스키마

401 - 무단

18.2.7. /apis/route.openshift.io/v1/namespaces/{namespace}/routes/{name}/status

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

name

string

경로 이름

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

200 - OK

경로 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

경로 스키마

201 - 생성됨

경로 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

경로 스키마

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

200 - OK

경로 스키마

201 - 생성됨

경로 스키마

401 - 무단

19장. 서비스 [v1]

설명
서비스는 프록시가 수신 대기하는 로컬 포트(예: 3306)와 프록시를 통해 전송되는 요청에 응답할 포드를 결정하는 선택기로 구성된 소프트웨어 서비스(예: mysql)의 이름이 지정된 추상화입니다.
유형
object

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

ServiceSpec은 사용자가 서비스에서 생성하는 속성을 설명합니다.

status

object

ServiceStatus는 서비스의 현재 상태를 나타냅니다.

19.1.1. .spec

설명
ServiceSpec은 사용자가 서비스에서 생성하는 속성을 설명합니다.
유형
object
속성유형설명

allocateLoadBalancerNodePorts

boolean

allocateLoadBalancerNodePorts는 LoadBalancer 유형의 서비스에 NodePorts가 자동으로 할당되는지 여부를 정의합니다. 기본값은 "true"입니다. 클러스터 로드 밸런서가 NodePort를 사용하지 않는 경우 "false"로 설정할 수 있습니다. 호출자가 값을 지정하여 특정 NodePort를 요청하면 이 필드에 관계없이 해당 요청이 유지됩니다. 이 필드는 LoadBalancer 유형의 서비스에 대해서만 설정할 수 있으며 유형이 다른 유형으로 변경된 경우 지워집니다.

clusterIP

string

ClusterIP는 서비스의 IP 주소이며 일반적으로 임의로 할당됩니다. 주소를 수동으로 지정하는 경우 는 (시스템 구성에 따라) 범위 내이며 사용하지 않는 경우 서비스에 할당됩니다. 그렇지 않으면 서비스 생성이 실패합니다. type 필드를 ExternalName(이 필드를 비워야 함)으로 변경하거나 유형 필드가 ExternalName에서 변경되는 경우를 제외하고 이 필드는 업데이트를 통해 변경할 수 없습니다(이 필드는 위에서 설명한 대로 선택적으로 지정될 수 있음). 유효한 값은 "None", 빈 문자열("") 또는 유효한 IP 주소입니다. 이를 "없음"으로 설정하면 "마이크리스 서비스"(가상 IP 없음)로 설정하면 직접 엔드포인트 연결이 선호되고 프록시가 필요하지 않을 때 유용합니다. ClusterIP, NodePort 및 LoadBalancer 유형에만 적용됩니다. ExternalName 유형의 서비스를 생성할 때 이 필드를 지정하면 생성이 실패합니다. 이 필드는 ExternalName 유형으로 서비스를 업데이트할 때 삭제됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies

clusterIPs

배열(문자열)

clusterIP는 이 서비스에 할당된 IP 주소 목록이며 일반적으로 임의로 할당됩니다. 주소를 수동으로 지정하는 경우 는 (시스템 구성에 따라) 범위 내이며 사용하지 않는 경우 서비스에 할당됩니다. 그렇지 않으면 서비스 생성이 실패합니다. type 필드가 ExternalName(이 필드가 비어 있어야 함)으로 변경되거나 유형 필드가 ExternalName에서 변경되는 경우를 제외하고 이 필드는 업데이트를 통해 변경할 수 없습니다(이 경우 위의 설명에 따라 이 필드가 선택적으로 지정될 수 있음). 유효한 값은 "None", 빈 문자열("") 또는 유효한 IP 주소입니다. 이를 "없음"으로 설정하면 "마이크리스 서비스"(가상 IP 없음)로 설정하면 직접 엔드포인트 연결이 선호되고 프록시가 필요하지 않을 때 유용합니다. ClusterIP, NodePort 및 LoadBalancer 유형에만 적용됩니다. ExternalName 유형의 서비스를 생성할 때 이 필드를 지정하면 생성이 실패합니다. 이 필드는 ExternalName 유형으로 서비스를 업데이트할 때 삭제됩니다. 이 필드를 지정하지 않으면 clusterIP 필드에서 초기화됩니다. 이 필드가 지정된 경우 클라이언트는 clusterIPs[0] 및 clusterIP의 값이 동일한지 확인해야 합니다.

이 필드에는 최대 두 개의 항목이 있을 수 있습니다(dual-stack IPs, 두 순서). 이러한 IP는 ipFamilies 필드의 값에 일치해야 합니다. clusterIPs 및 ipFamilies 둘 다 ipFamilyPolicy 필드에 의해 관리됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies

externalIPs

배열(문자열)

externalIPs는 클러스터의 노드에서 이 서비스에 대한 트래픽도 허용할 IP 주소 목록입니다. 이러한 IP는 Kubernetes에서 관리하지 않습니다. 사용자는 이 IP가 있는 노드에 트래픽이 도달하는지 확인해야 합니다. 일반적인 예는 Kubernetes 시스템의 일부가 아닌 외부 로드 밸런서입니다.

externalName

string

ExternalName은 검색 메커니즘이 이 서비스의 별칭(예: DNS CNAME 레코드)으로 반환되는 외부 참조입니다. 프록시는 포함되지 않습니다. 소문자 RFC-1123 호스트 이름(https://tools.ietf.org/html/rfc1123)이어야 하며 type 을 "ExternalName"이어야 합니다.

externalTrafficPolicy

string

externalTrafficPolicy는 노드에서 서비스의 "외부 연결" 주소(NodePorts, ExternalIP, LoadBalancer IP) 중 하나에서 수신되는 서비스 트래픽을 배포하는 방법을 설명합니다. "Local"로 설정하면 프록시는 외부 로드 밸런서가 노드 간에 서비스 트래픽의 균형을 유지하는 방식으로 서비스를 구성하므로 각 노드는 클라이언트 소스 IP를 마스커레이드하지 않고 서비스의 노드 로컬 엔드포인트에만 트래픽을 전달합니다. (트래드가 없는 노드에 실수로 전송되는 트래픽은 삭제됩니다.) 기본값인 "Cluster"는 모든 끝점에 대한 표준 라우팅 동작을 균등하게 사용합니다( 토폴로지 및 기타 기능에 의해 수정될 수 있음). 클러스터 내에서 외부 IP 또는 LoadBalancer IP로 전송되는 트래픽에는 항상 "클러스터" 의미 체계가 표시되지만, 클러스터 내에서 NodePort로 전송되는 클라이언트는 노드를 선택할 때 트래픽 정책을 고려해야 할 수 있습니다.

가능한 enum 값: - "클러스터" - "클러스터" 는 트래픽을 모든 끝점으로 라우팅합니다. - " 로컬" - "로컬"은 트래픽이 수신되는 것과 동일한 노드의 끝점으로만 라우팅하여 트래픽의 소스 IP를 유지합니다(로컬 끝점이 없는 경우 트래픽을 삭제).

healthCheckNodePort

integer

HealthCheckNodePort는 서비스의 healthcheck nodePort를 지정합니다. 이는 type이 LoadBalancer로 설정되고 externalTrafficPolicy가 Local으로 설정된 경우에만 적용됩니다. 값이 지정되고 범위 내이며 사용되지 않는 경우 사용됩니다. 지정하지 않으면 값이 자동으로 할당됩니다. 외부 시스템(예: 로드 밸런서)은 이 포트를 사용하여 지정된 노드가 이 서비스의 끝점을 보유하고 있는지 여부를 확인할 수 있습니다. 이 필드가 필요하지 않은 서비스를 생성할 때 지정된 경우 생성이 실패합니다. 이 필드는 더 이상 필요하지 않도록 서비스를 업데이트할 때 삭제됩니다(예: 유형 변경). 이 필드는 설정된 후에는 업데이트할 수 없습니다.

internalTrafficPolicy

string

internalTrafficPolicy는 노드가 ClusterIP에서 수신하는 서비스 트래픽을 배포하는 방법을 설명합니다. "Local"로 설정하면 프록시는 Pod가 Pod와 동일한 노드의 서비스 끝점과만 통신하고 로컬 끝점이 없는 경우 트래픽을 삭제한다고 가정합니다. 기본값인 "Cluster"는 모든 끝점에 대한 표준 라우팅 동작을 균등하게 사용합니다( 토폴로지 및 기타 기능에 의해 수정될 수 있음).

가능한 enum 값: - "클러스터" 는 트래픽을 모든 끝점으로 라우팅합니다. - "로컬" 는 클라이언트 Pod와 동일한 노드의 끝점으로만 트래픽을 라우팅합니다(로컬 끝점이 없는 경우 트래픽을 삭제).

ipFamilies

배열(문자열)

ipFamilies는 이 서비스에 할당된 IP 제품군 목록(예: IPv4, IPv6)입니다. 이 필드는 일반적으로 클러스터 구성 및 ipFamilyPolicy 필드를 기반으로 자동으로 할당됩니다. 이 필드가 수동으로 지정되면 클러스터에서 요청된 제품군을 사용할 수 있으며 ipFamilyPolicy에서 허용하는 경우 이 필드가 사용됩니다. 그렇지 않으면 서비스 생성이 실패합니다. 이 필드는 조건적으로 변경할 수 있습니다. 보조 IP 제품군을 추가하거나 제거할 수는 있지만 서비스의 기본 IP 제품군을 변경할 수는 없습니다. 유효한 값은 "IPv4" 및 "IPv6"입니다. 이 필드는 ClusterIP, NodePort 및 LoadBalancer 유형의 서비스에만 적용되며 "headless" 서비스에 적용됩니다. 이 필드는 ExternalName 유형으로 서비스를 업데이트할 때 삭제됩니다.

이 필드는 최대 두 개의 항목(일반적으로 스택 제품군)을 두 순서로 보유할 수 있습니다. 이러한 제품군은 지정된 경우 clusterIPs 필드 값과 일치해야 합니다. clusterIPs 및 ipFamilies 둘 다 ipFamilyPolicy 필드에 의해 관리됩니다.

ipFamilyPolicy

string

ipFamilyPolicy는 이 서비스에서 요청하거나 요구하는 듀얼 스택 특성을 나타냅니다. 값을 제공하지 않으면 이 필드가 SingleStack으로 설정됩니다. 서비스는 "SingleStack"(단일 IP 제품군), "PreferDualStack"(다중 스택 구성된 클러스터의 두 개의 IP 제품군 또는 단일 스택 클러스터에서 단일 IP 제품군) 또는 "RequireDualStack"(반드 스택 구성된 클러스터의 2개의 IP 제품군)일 수 있습니다. ipFamilies 및 clusterIPs 필드는 이 필드의 값에 따라 다릅니다. 이 필드는 ExternalName 유형으로 서비스를 업데이트할 때 삭제됩니다.

가능한 enum 값: - "PreferDualStack" 은 클러스터가 듀얼 스택에 대해 구성된 경우 이 서비스가 듀얼 스택을 선호함을 나타냅니다. 듀얼 스택에 대한 클러스터가 구성되지 않은 경우 서비스에는 단일 IPFamily가 할당됩니다. IPFamily가 service.spec.ipFamilies에 설정되어 있지 않으면 서비스에 기본 IPFamily configured on the cluster - "RequireDualStack" 은 이 서비스에 듀얼 스택이 필요함을 나타냅니다. 단일 스택 클러스터에서 IPFamilyPolicyRequireDualStack을 사용하면 유효성 검사 오류가 발생합니다. 이 서비스에 할당된 IPFamilies(및 주문)는 service.spec.ipFamilies를 기반으로 합니다. service.spec.ipFamilies를 제공하지 않은 경우 클러스터에서 구성 방법에 따라 할당됩니다. service.spec.ipFamilies에 하나의 항목만 있는 경우 대체 IPFamily가 apiserver에서 추가됩니다 - "SingleStack" 은 이 서비스에 단일 IPFamily가 필요하다는 것을 나타냅니다. 할당된 IPFamily는 클러스터에서 사용하거나 service.spec.ipFamilies 필드에 의해 식별된 기본 IPFamily를 기반으로 합니다.

loadBalancerClass

string

LoadBalancerClass는 이 서비스가 속하는 로드 밸런서 구현의 클래스입니다. 지정된 경우 이 필드의 값은 선택적 접두사가 있는 레이블 스타일 식별자여야 합니다(예: "internal-vip" 또는 "example.com/internal-vip"). 호출되지 않은 이름은 최종 사용자를 위해 예약되어 있습니다. 이 필드는 서비스 유형이 'LoadBalancer'인 경우에만 설정할 수 있습니다. 설정되지 않은 경우 기본 로드 밸런서 구현이 사용되며, 현재 일반적으로 클라우드 공급자 통합을 통해 수행되지만 모든 기본 구현에 적용해야 합니다. 설정된 경우 로드 밸런서 구현에서 일치하는 클래스가 있는 서비스를 조사한다고 가정합니다. 기본 로드 밸런서 구현(예: 클라우드 공급자)은 이 필드를 설정하는 서비스를 무시해야 합니다. 이 필드는 'LoadBalancer'를 입력하도록 서비스를 생성하거나 업데이트할 때만 설정할 수 있습니다. 설정한 후에는 변경할 수 없습니다. 서비스가 'LoadBalancer'이 아닌 유형으로 업데이트되면 이 필드가 지워집니다.

loadBalancerIP

string

서비스 유형: LoadBalancer에만 적용됩니다. 이 기능은 로드 밸런서가 생성될 때 기본 cloud-provider가 loadBalancerIP 지정을 지원하는지 여부에 따라 달라집니다. cloud-provider가 해당 기능을 지원하지 않는 경우 이 필드는 무시됩니다. 더 이상 사용되지 않음: 이 필드는 지정되지 않았으며 이는 구현마다 다릅니다. 이를 사용하는 것은 포트를 사용할 수 없으며 듀얼 스택을 지원하지 않을 수 있습니다. 사용자는 사용 가능한 경우 구현별 주석을 사용하는 것이 좋습니다.

loadBalancerSourceRanges

배열(문자열)

플랫폼에서 지정 및 지원하는 경우 cloud-provider 로드 밸런서를 통한 트래픽이 지정된 클라이언트 IP로 제한됩니다. cloud-provider가 이 기능을 지원하지 않는 경우 이 필드는 무시됩니다." 자세한 내용은 https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/

포트

array

이 서비스에서 노출하는 포트 목록입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies

ports[]

object

ServicePort에는 서비스 포트에 대한 정보가 포함되어 있습니다.

publishNotReadyAddresses

boolean

publishNotReadyAddresses는 이 서비스의 엔드포인트를 처리하는 모든 에이전트가 ready/not-ready의 표시를 무시해야 함을 나타냅니다. 이 필드를 설정하는 주요 사용 사례는 StatefulSet의 Headless Service가 피어 검색을 위해 Pod의 SRV DNS 레코드를 전파하는 것입니다. 서비스에 대한 Endpoints 및 EndpointSlice 리소스를 생성하는 Kubernetes 컨트롤러는 Pod 자체가 아닌 경우에도 모든 끝점이 "준비"로 간주되도록 해석합니다. Endpoints 또는 EndpointSlice 리소스를 통해 쿠버네티스 생성된 엔드포인트만 사용하는 에이전트는 이 동작을 안전하게 가정할 수 있습니다.

선택기

오브젝트(문자열)

이 선택기와 일치하는 레이블 키 및 값을 사용하여 서비스 트래픽을 Pod로 라우팅합니다. 비어 있거나 존재하지 않는 경우 서비스에는 Kubernetes가 수정하지 않는 끝점을 관리하는 외부 프로세스가 있는 것으로 간주됩니다. ClusterIP, NodePort 및 LoadBalancer 유형에만 적용됩니다. type이 ExternalName인 경우 무시됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/

sessionAffinity

string

"ClientIP" 및 "없음"을 지원합니다. 세션 선호도를 유지하는 데 사용됩니다. 클라이언트 IP 기반 세션 선호도를 활성화합니다. ClientIP 또는 None이어야 합니다. 기본값은 None입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies

가능한 enum 값: - "ClientIP" 는 클라이언트 IP 기반입니다. - "없음" - 세션 선호도가 없습니다.

sessionAffinityConfig

object

SessionAffinityConfig는 세션 선호도의 구성을 나타냅니다.

type

string

type은 서비스 노출 방식을 결정합니다. 기본값은 ClusterIP입니다. 유효한 옵션은 ExternalName, ClusterIP, NodePort, LoadBalancer입니다. "ClusterIP"는 끝점에 대한 로드 밸런싱을 위해 클러스터 내부 IP 주소를 할당합니다. 끝점은 선택기에 의해 결정되거나 끝점 개체 또는 EndpointSlice 개체의 수동 구성에 의해 지정되지 않은 경우입니다. clusterIP가 "없음"이면 가상 IP가 할당되지 않고 끝점이 가상 IP가 아닌 끝점 세트로 게시됩니다. "NodePort"는 ClusterIP를 기반으로 빌드되고 clusterIP와 동일한 엔드포인트로 라우팅하는 모든 노드에 포트를 할당합니다. "LoadBalancer"는 NodePort를 기반으로 빌드되고 clusterIP와 동일한 엔드포인트로 라우팅하는 외부 로드 밸런서(현재 클라우드에서 지원되는 경우)를 생성합니다. "ExternalName"은 이 서비스에 지정된 externalName에 별칭을 지정합니다. ExternalName 서비스에는 다른 여러 필드가 적용되지 않습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/#publishing-services-service-types

가능한 enum 값: - "ClusterIP" 는 클러스터 IP를 통해 클러스터 내에서만 서비스에 액세스할 수 있음을 의미합니다. - "ExternalName" 은 kubedns 또는 이와 동등한 이름의 참조만 서비스에서 CNAME 레코드로 구성되며 Pod를 노출하거나 프록시하지 않고 서비스가 외부 로드 밸런서를 통해 노출됨을 의미합니다. - "LoadBalancer" 는 외부 로드 밸런서를 통해 서비스가 노출되거나 프록시되지 않음을 의미합니다. 'NodePort' 유형 외에도 ' NodePort '는 'ClusterIP' 유형 외에도 모든 노드의 하나의 포트에 서비스가 노출됨을 의미합니다.

19.1.2. .spec.ports

설명
이 서비스에서 노출하는 포트 목록입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
유형
array

19.1.3. .spec.ports[]

설명
ServicePort에는 서비스 포트에 대한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • port
속성유형설명

appProtocol

string

이 포트의 애플리케이션 프로토콜입니다. 이는 구현이 이해할 수 있는 프로토콜에 대해 보다 풍부한 동작을 제공하기 위한 힌트로 사용됩니다. 이 필드는 표준 Kubernetes 라벨 구문을 따릅니다. 유효한 값은 다음 중 하나입니다.

* UN-prefixed 프로토콜 이름 - IANA 표준 서비스 이름(RFC-6335 및 https://www.iana.org/assignments/service-names)용으로 예약되어 있습니다.

* Kubernetes 정의 접두사 이름: * 'kubernetes.io/h2c' - https://www.rfc-editor.org/rfc/rfc7540 * 'kubernetes.io/ws'에 설명된 대로 https://www.rfc-editor.org/rfc/rfc7540 * 'kubernetes.io/ws' - WebSocket over cleartext에 설명된 대로 https://www.rfc-editor.org/rfc/rfc6455 * 'kubernetes.io/wsss' - WebSocket over TLS에 설명된 대로 일반 텍스트보다 일반 텍스트보다 HTTP/2보다 일반 텍스트보다 HTTP/2입니다.

* 다른 프로토콜은 mycompany.com/my-custom-protocol과 같은 구현 정의 접두사 이름을 사용해야 합니다.

name

string

서비스 내의 이 포트의 이름입니다. DNS_LABEL이어야 합니다. ServiceSpec 내의 모든 포트에는 고유한 이름이 있어야 합니다. 서비스의 끝점을 고려할 때 EndpointPort의 'name' 필드와 일치해야 합니다. 이 서비스에 하나의 ServicePort만 정의된 경우 선택 사항입니다.

nodePort

integer

유형이 NodePort 또는 LoadBalancer인 경우 이 서비스가 노출되는 각 노드의 포트입니다. 일반적으로 시스템에서 할당한 것입니다. 값이 지정되고 사용하지 않는 값은 사용됩니다. 그렇지 않으면 작업이 실패합니다. 지정하지 않으면 이 서비스에 필요한 경우 포트가 할당됩니다. 이 필드가 필요하지 않은 서비스를 생성할 때 지정된 경우 생성이 실패합니다. 이 필드는 더 이상 필요하지 않도록 서비스를 업데이트할 때 삭제됩니다(예: type을 NodePort에서 ClusterIP로 변경). 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/#type-nodeport

port

integer

이 서비스에서 노출할 포트입니다.

protocol

string

이 포트의 IP 프로토콜입니다. "TCP", "UDP" 및 "SCTP"를 지원합니다. 기본값은 TCP입니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

targetPort

IntOrString

서비스에서 대상으로 하는 Pod에서 액세스할 포트의 수 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. 문자열이면 대상 Pod의 컨테이너 포트에서 이름이 지정된 포트로 조회됩니다. 지정하지 않으면 'port' 필드의 값이 사용됩니다(ID 맵). 이 필드는 clusterIP=None이 있는 서비스에 대해 무시되며 'port' 필드와 동일하게 생략하거나 설정해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/#defining-a-service

19.1.4. .spec.sessionAffinityConfig

설명
SessionAffinityConfig는 세션 선호도의 구성을 나타냅니다.
유형
object
속성유형설명

clientIP

object

ClientIPConfig는 클라이언트 IP 기반 세션 선호도의 구성을 나타냅니다.

19.1.5. .spec.sessionAffinityConfig.clientIP

설명
ClientIPConfig는 클라이언트 IP 기반 세션 선호도의 구성을 나타냅니다.
유형
object
속성유형설명

timeoutSeconds

integer

timeoutSeconds는 ClientIP 유형 세션 고정 시간 초를 지정합니다. ServiceAffinity == "ClientIP"인 경우 값은 >0 && Cryostat86400(일의 경우)이어야 합니다. 기본값은 10800(3시간)입니다.

19.1.6. .status

설명
ServiceStatus는 서비스의 현재 상태를 나타냅니다.
유형
object
속성유형설명

conditions

배열(Condition)

현재 서비스 상태

loadBalancer

object

LoadBalancerStatus는 로드 밸런서의 상태를 나타냅니다.

19.1.7. .status.loadBalancer

설명
LoadBalancerStatus는 로드 밸런서의 상태를 나타냅니다.
유형
object
속성유형설명

Ingress

array

Ingress는 로드 밸런서에 대한 수신 지점을 포함하는 목록입니다. 서비스를 위한 트래픽은 이러한 수신 지점으로 전송되어야 합니다.

ingress[]

object

LoadBalancerIngress는 로드 밸런서 인그레스 지점의 상태: 서비스에 대해 의도된 트래픽을 수신 지점으로 보내야 합니다.

19.1.8. .status.loadBalancer.ingress

설명
Ingress는 로드 밸런서에 대한 수신 지점을 포함하는 목록입니다. 서비스를 위한 트래픽은 이러한 수신 지점으로 전송되어야 합니다.
유형
array

19.1.9. .status.loadBalancer.ingress[]

설명
LoadBalancerIngress는 로드 밸런서 인그레스 지점의 상태: 서비스에 대해 의도된 트래픽을 수신 지점으로 보내야 합니다.
유형
object
속성유형설명

hostname

string

호스트 이름은 DNS 기반(일반적으로 AWS 로드 밸런서)인 로드 밸런서 인그레스 지점에 대해 설정됩니다.

ip

string

IP는 IP 기반(일반적으로 GCE 또는 OpenStack 로드 밸런서)인 로드 밸런서 인그레스 지점에 대해 설정됩니다.

포트

array

ports는 서비스 포트의 레코드 목록입니다. 사용 중인 경우 서비스에 정의된 모든 포트에 항목이 있어야 합니다.

ports[]

object

 

19.1.10. .status.loadBalancer.ingress[].ports

설명
ports는 서비스 포트의 레코드 목록입니다. 사용 중인 경우 서비스에 정의된 모든 포트에 항목이 있어야 합니다.
유형
array

19.1.11. .status.loadBalancer.ingress[].ports[]

설명
유형
object
필수 항목
  • port
  • protocol
속성유형설명

error

string

Error is to record the problem with the service port The format of the error should comply with the following rules: - built-in error values should be specified in this file and those must use CamelCase name - cloud provider specific error values must have names that comply with the format foo.example.com/CamelCase.

port

integer

port는 상태가 기록되는 서비스 포트의 포트 번호입니다.

protocol

string

protocol is the protocol of the service port of which status is recorded here The supported values are: "TCP", "UDP", "SCTP"

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

19.2. API 끝점

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

  • /api/v1/services

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

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

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

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

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

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

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

19.2.1. /api/v1/services

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

200 - OK

ServiceList 스키마

401 - 무단

19.2.2. /api/v1/watch/services

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

200 - OK

WatchEvent 스키마

401 - 무단

19.2.3. /api/v1/namespaces/{namespace}/services

HTTP 방법
DELETE
설명
서비스 컬렉션 삭제
표 19.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

401 - 무단

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

200 - OK

ServiceList 스키마

401 - 무단

HTTP 방법
POST
설명
서비스 생성
표 19.6. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

서비스 스키마

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

200 - OK

서비스 스키마

201 - 생성됨

서비스 스키마

202 - 승인됨

서비스 스키마

401 - 무단

19.2.4. /api/v1/watch/namespaces/{namespace}/services

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

200 - OK

WatchEvent 스키마

401 - 무단

19.2.5. /api/v1/namespaces/{namespace}/services/{name}

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

name

string

서비스 이름

HTTP 방법
DELETE
설명
서비스 삭제
표 19.11. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

서비스 스키마

202 - 승인됨

서비스 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 서비스 읽기
표 19.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

서비스 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

서비스 스키마

201 - 생성됨

서비스 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 서비스를 교체
표 19.16. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

서비스 스키마

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

200 - OK

서비스 스키마

201 - 생성됨

서비스 스키마

401 - 무단

19.2.6. /api/v1/watch/namespaces/{namespace}/services/{name}

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

name

string

서비스 이름

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

200 - OK

WatchEvent 스키마

401 - 무단

19.2.7. /api/v1/namespaces/{namespace}/services/{name}/status

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

name

string

서비스 이름

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

200 - OK

서비스 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

서비스 스키마

201 - 생성됨

서비스 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

서비스 스키마

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