네트워크 API
네트워크 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은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| AdminPolicyBasedExternalRouteSpec은 AdminPolicyBasedExternalRoute의 원하는 상태를 정의합니다. |
|
| AdminPolicyBasedRouteStatus에는 AdminPolicyBased 경로 유형의 관찰된 상태가 포함됩니다. |
2.1.1. .spec
- 설명
- AdminPolicyBasedExternalRouteSpec은 AdminPolicyBasedExternalRoute의 원하는 상태를 정의합니다.
- 유형
-
object
- 필수 항목
-
from
-
nextHops
-
속성 | 유형 | 설명 |
---|---|---|
|
| from은 대상 네임스페이스를 이 CR로 결정할 선택기를 정의합니다. |
|
| NextHops는 정적 및 동적이라는 두 가지 유형의 홉을 정의합니다. 각 홉은 하나 이상의 외부 게이트웨이 IP를 정의합니다. |
2.1.2. .spec.from
- 설명
- from은 대상 네임스페이스를 이 CR로 결정할 선택기를 정의합니다.
- 유형
-
object
- 필수 항목
-
namespaceSelector
-
속성 | 유형 | 설명 |
---|---|---|
|
| namespaceSelector는 이 CR에서 대상으로 할 네임스페이스를 결정하는 데 사용할 선택기를 정의합니다. |
2.1.3. .spec.from.namespaceSelector
- 설명
- namespaceSelector는 이 CR에서 대상으로 할 네임스페이스를 결정하는 데 사용할 선택기를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 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는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
2.1.6. .spec.nextHops
- 설명
- NextHops는 정적 및 동적이라는 두 가지 유형의 홉을 정의합니다. 각 홉은 하나 이상의 외부 게이트웨이 IP를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| DynamicHops는 DynamicHop의 슬라이스를 정의합니다. 이 필드는 선택 사항입니다. |
|
| DynamicHop은 동적 외부 게이트웨이 인터페이스에 대한 구성을 정의합니다. 이러한 인터페이스는 클러스터 내부에 있는 Pod 오브젝트로 래핑됩니다. NetworkAttachmentName 필드는 사용할 게이트웨이 IP를 검색할 때 사용할 multus 네트워크 이름의 이름을 캡처합니다. PodSelector 및 NamespaceSelector는 필수 필드입니다. |
|
| StaticHops는 StaticHop의 슬라이스를 정의합니다. 이 필드는 선택 사항입니다. |
|
| 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는 인터페이스가 양방향 Forward Detection 프로토콜을 구현하는지 여부를 결정합니다. 기본값은 false입니다. |
|
| namespaceSelector는 Pod 게이트웨이가 있는 네임스페이스를 필터링하는 선택기를 정의합니다. |
|
| NetworkAttachmentName은 게이트웨이 IP로 사용할 Pod IP를 검색할 때 사용할 multus 네트워크 이름을 결정합니다. 이 필드가 비어 있으면 논리는 포드가 HostNetwork로 구성되고 노드의 IP를 게이트웨이로 사용하고 있다고 가정합니다. |
|
| podSelector는 외부 게이트웨이인 Pod를 필터링하는 선택기를 정의합니다. |
2.1.9. .spec.nextHops.dynamic[].namespaceSelector
- 설명
- namespaceSelector는 Pod 게이트웨이가 있는 네임스페이스를 필터링하는 선택기를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 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는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
2.1.12. .spec.nextHops.dynamic[].podSelector
- 설명
- podSelector는 외부 게이트웨이인 Pod를 필터링하는 선택기를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 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는 선택기가 적용되는 라벨 키입니다. |
|
| 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는 인터페이스가 양방향 Forward Detection 프로토콜을 구현하는지 여부를 결정합니다. 기본값은 false입니다. |
|
| IP는 송신 트래픽에 사용할 고정 IP를 정의합니다. IP는 IPv4 또는 IPv6일 수 있습니다. |
2.1.17. .status
- 설명
- AdminPolicyBasedRouteStatus에는 AdminPolicyBased 경로 유형의 관찰된 상태가 포함됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 마지막 변경이 적용된 시간을 캡처합니다. |
|
| 개체의 상태에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지 배열입니다. |
|
| 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 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- AdminPolicyBasedExternalRoute 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- create an AdminPolicyBasedExternalRoute
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
2.2.2. /apis/k8s.ovn.org/v1/adminpolicybasedexternalroutes/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| AdminPolicyBasedExternalRoute의 이름 |
- HTTP 방법
-
DELETE
- 설명
- delete an AdminPolicyBasedExternalRoute
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 AdminPolicyBasedExternalRoute 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 AdminPolicyBasedExternalRoute를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 AdminPolicyBasedExternalRoute를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
2.2.3. /apis/k8s.ovn.org/v1/adminpolicybasedexternalroutes/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| AdminPolicyBasedExternalRoute의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 AdminPolicyBasedExternalRoute의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 AdminPolicyBasedExternalRoute의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 AdminPolicyBasedExternalRoute의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
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은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec은 원하는 개인 IP 요청의 정의입니다. |
|
| Status는 원하는 개인 IP 요청의 상태를 확인합니다. 읽기 전용입니다. |
3.1.1. .spec
- 설명
- spec은 원하는 개인 IP 요청의 정의입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 노드는 Kubernetes 필드에 지정된 대로 노드 이름입니다. node.metadata.name |
3.1.2. .status
- 설명
- Status는 원하는 개인 IP 요청의 상태를 확인합니다. 읽기 전용입니다.
- 유형
-
object
- 필수 항목
-
conditions
-
속성 | 유형 | 설명 |
---|---|---|
|
| condition은 개인 IP 및 해당 상태의 할당 조건입니다. |
|
|
condition에는 이 API 리소스의 현재 상태에 대한 세부 정보가 포함됩니다. --- 이 구조는 필드 경로 .status.conditions에서 배열로 직접 사용하기 위한 것입니다. 예를 들어 FooStatus struct{ // foo의 현재 상태의 관찰을 나타냅니다. // knownn .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchStrategy=merge // +listType=map // +listKey=type // +listKey=type [] |
|
| 노드는 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은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다. |
|
| message는 변환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다. |
|
| observedGeneration은 조건에 따라 설정된 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 현재 인스턴스 상태와 관련된 조건이 최신 상태가 아닙니다. |
|
| 이유에는 조건의 마지막 전환 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 예상되는 값과 의미를 정의할 수 있으며 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있지 않을 수 있습니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 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 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- CloudPrivateIPConfig 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- create a CloudPrivateIPConfig
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
3.2.2. /apis/cloud.network.openshift.io/v1/cloudprivateipconfigs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| CloudPrivateIPConfig의 이름 |
- HTTP 방법
-
DELETE
- 설명
- delete a CloudPrivateIPConfig
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 CloudPrivateIPConfig 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 CloudPrivateIPConfig를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 CloudPrivateIPConfig를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
3.2.3. /apis/cloud.network.openshift.io/v1/cloudprivateipconfigs/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| CloudPrivateIPConfig의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 CloudPrivateIPConfig의 상태 확인
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 CloudPrivateIPConfig의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 CloudPrivateIPConfig의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
4장. EgressFirewall [k8s.ovn.org/v1]
- 설명
- EgressFirewall은 네임스페이스의 현재 송신 방화벽을 설명합니다. Pod에서 클러스터 외부의 IP 주소로의 트래픽은 Pod의 EgressFirewallRule의 각 EgressFirewallRule에 대해 순서대로 확인합니다. 일치하는 규칙이 없거나 EgressFirewall이 없으면 기본적으로 트래픽이 허용됩니다.
- 유형
-
object
- 필수 항목
-
spec
-
4.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| EgressFirewall의 원하는 동작 사양입니다. |
|
| EgressFirewall의 상태 |
4.1.1. .spec
- 설명
- EgressFirewall의 원하는 동작 사양입니다.
- 유형
-
object
- 필수 항목
-
egress
-
속성 | 유형 | 설명 |
---|---|---|
|
| 송신 방화벽 규칙 오브젝트 컬렉션 |
|
| EgressFirewallRule은 단일 egressfirewall 규칙 오브젝트입니다. |
4.1.2. .spec.egress
- 설명
- 송신 방화벽 규칙 오브젝트 컬렉션
- 유형
-
array
4.1.3. .spec.egress[]
- 설명
- EgressFirewallRule은 단일 egressfirewall 규칙 오브젝트입니다.
- 유형
-
object
- 필수 항목
-
다음으로 변경
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| 포트가 규칙이 적용되는 포트 및 프로토콜을 지정합니다. |
|
| EgressFirewallPort는 트래픽을 허용하거나 거부할 포트를 지정합니다. |
|
| to는 트래픽이 허용/거부되는 대상입니다. |
|
| type은 이 값을 "Allow" 또는 "Deny" 규칙으로 표시합니다. |
4.1.4. .spec.egress[].ports
- 설명
- 포트가 규칙이 적용되는 포트 및 프로토콜을 지정합니다.
- 유형
-
array
4.1.5. .spec.egress[].ports[]
- 설명
- EgressFirewallPort는 트래픽을 허용하거나 거부할 포트를 지정합니다.
- 유형
-
object
- 필수 항목
-
port
-
protocol
-
속성 | 유형 | 설명 |
---|---|---|
|
| 트래픽이 일치해야 하는 포트 |
|
| 트래픽이 일치해야 하는 프로토콜(tcp, udp, sctp)입니다. |
4.1.6. .spec.egress[].to
- 설명
- to는 트래픽이 허용/거부되는 대상입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| cidrSelector는 트래픽을 허용/거부할 CIDR 범위입니다. 이 값을 설정하는 경우 dnsName 및 nodeSelector를 설정하지 않아야 합니다. |
|
| dnsName은 트래픽을 허용/거부할 도메인 이름입니다. 이 값을 설정하는 경우 cidrSelector 및 nodeSelector를 설정하지 않아야 합니다. |
|
| nodeSelector는 선택한 노드의 Kubernetes 노드 IP에 대한 트래픽을 허용/거부합니다. 이 값을 설정하는 경우 cidrSelector 및 DNSName을 설정되지 않아야 합니다. |
4.1.7. .spec.egress[].to.nodeSelector
- 설명
- nodeSelector는 선택한 노드의 Kubernetes 노드 IP에 대한 트래픽을 허용/거부합니다. 이 값을 설정하는 경우 cidrSelector 및 DNSName을 설정되지 않아야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 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는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
4.1.10. .status
- 설명
- EgressFirewall의 상태
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| |
|
|
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 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
4.2.2. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressfirewalls
- HTTP 방법
-
DELETE
- 설명
- EgressFirewall 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- EgressFirewall 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- EgressFirewall 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
4.2.3. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressfirewalls/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| EgressFirewall 이름 |
- HTTP 방법
-
DELETE
- 설명
- EgressFirewall 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 EgressFirewall 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 EgressFirewall을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 EgressFirewall을 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
4.2.4. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressfirewalls/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| EgressFirewall 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 EgressFirewall의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 EgressFirewall의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 EgressFirewall의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
5장. EgressIP [k8s.ovn.org/v1]
- 설명
- EgressIP는 사용자가 사양 정의에 따라 EgressIP 리소스와 일치하는 모든 Pod에서 발생하는 모든 송신 트래픽에 대해 고정 소스 IP를 정의할 수 있도록 하는 CRD입니다.
- 유형
-
object
- 필수 항목
-
spec
-
5.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| EgressIP의 원하는 동작의 사양입니다. |
|
| EgressIP의 상태를 확인합니다. 읽기 전용입니다. |
5.1.1. .spec
- 설명
- EgressIP의 원하는 동작의 사양입니다.
- 유형
-
object
- 필수 항목
-
egressIPs
-
namespaceSelector
-
속성 | 유형 | 설명 |
---|---|---|
|
| egressIPs는 요청된 송신 IP 주소 목록입니다. IPv4 및/또는 IPv6일 수 있습니다. 이 필드는 필수입니다. |
|
| namespaceSelector는 이 정의와 일치하는 레이블이 있는 네임스페이스에만 송신 IP를 적용합니다. 이 필드는 필수입니다. |
|
| podSelector는 송신 IP를 이 정의와 일치하는 Pod에만 적용합니다. 이 필드는 선택 사항이며 설정되지 않은 경우 송신 IP가 NamespaceSelector와 일치하는 네임스페이스의 모든 Pod에 적용됩니다. 설정된 경우 NamespaceSelector와 교차하므로 이 Pod 선택기와 일치하는 NamespaceSelector가 이미 일치하는 Pod(네임스페이스에서)에 송신 IP를 적용합니다. |
5.1.2. .spec.namespaceSelector
- 설명
- namespaceSelector는 이 정의와 일치하는 레이블이 있는 네임스페이스에만 송신 IP를 적용합니다. 이 필드는 필수입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 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는 선택기가 적용되는 라벨 키입니다. |
|
| 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는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 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는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
5.1.8. .status
- 설명
- EgressIP의 상태를 확인합니다. 읽기 전용입니다.
- 유형
-
object
- 필수 항목
-
items
-
속성 | 유형 | 설명 |
---|---|---|
|
| 할당된 송신 IP 목록과 해당 노드 할당입니다. |
|
| 할당된 송신 IP의 노드당 상태입니다. |
5.1.9. .status.items
- 설명
- 할당된 송신 IP 목록과 해당 노드 할당입니다.
- 유형
-
array
5.1.10. .status.items[]
- 설명
- 할당된 송신 IP의 노드당 상태입니다.
- 유형
-
object
- 필수 항목
-
egressIP
-
노드
-
속성 | 유형 | 설명 |
---|---|---|
|
| 할당된 송신 IP |
|
| 할당된 노드 이름 |
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 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 종류의 EgressIP 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- EgressIP 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
5.2.2. /apis/k8s.ovn.org/v1/egressips/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| EgressIP 이름 |
- HTTP 방법
-
DELETE
- 설명
- EgressIP 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 EgressIP 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 EgressIP를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 EgressIP를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
6장. EgressQoS [k8s.ovn.org/v1]
- 설명
- EgressQoS는 사용자가 네임스페이스에서 지정된 CIDR로 송신 트래픽의 DSCP 값을 정의할 수 있는 CRD입니다. 이러한 Pod의 트래픽은 네임스페이스의 EgressQoSRule의 각 EgressQoSRule에 대해 확인되며 일치하는 항목이 있는 경우 트래픽이 관련 DSCP 값으로 표시됩니다.
- 유형
-
object
6.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| EgressQoSSpec은 원하는 EgressQoS 상태를 정의합니다. |
|
| EgressQoSStatus는 EgressQoS의 관찰 상태를 정의합니다. |
6.1.1. .spec
- 설명
- EgressQoSSpec은 원하는 EgressQoS 상태를 정의합니다.
- 유형
-
object
- 필수 항목
-
egress
-
속성 | 유형 | 설명 |
---|---|---|
|
| Egress QoS 규칙 오브젝트 컬렉션 |
|
|
6.1.2. .spec.egress
- 설명
- Egress QoS 규칙 오브젝트 컬렉션
- 유형
-
array
6.1.3. .spec.egress[]
- 설명
- 유형
-
object
- 필수 항목
-
dscp
-
속성 | 유형 | 설명 |
---|---|---|
|
| 일치하는 Pod의 트래픽에 대한 DSCP 표시 값입니다. |
|
| DstCIDR은 대상의 CIDR을 지정합니다. 이 CIDR로 향하는 트래픽만 DSCP 값으로 표시됩니다. 이 필드는 선택 사항이며, 대상에 관계없이 규칙이 모든 송신 트래픽에 적용되지 않는 경우 규칙이 설정됩니다. |
|
| podSelector는 이 정의와 일치하는 네임스페이스의 Pod에만 QoS 규칙을 적용합니다. 이 필드는 선택 사항이며, 설정되지 않은 경우 네임스페이스의 모든 Pod에 규칙이 적용됩니다. |
6.1.4. .spec.egress[].podSelector
- 설명
- podSelector는 이 정의와 일치하는 네임스페이스의 Pod에만 QoS 규칙을 적용합니다. 이 필드는 선택 사항이며, 설정되지 않은 경우 네임스페이스의 모든 Pod에 규칙이 적용됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 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는 선택기가 적용되는 라벨 키입니다. |
|
| 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 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
6.2.2. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressqoses
- HTTP 방법
-
DELETE
- 설명
- EgressQoS 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- EgressQoS 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- EgressQoS 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
6.2.3. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressqoses/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| EgressQoS 이름 |
- HTTP 방법
-
DELETE
- 설명
- EgressQoS 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 EgressQoS 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 EgressQoS를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 EgressQoS를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
6.2.4. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressqoses/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| EgressQoS 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 EgressQoS의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 EgressQoS의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 EgressQoS의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
7장. EgressService [k8s.ovn.org/v1]
- 설명
- EgressService는 해당 LoadBalancer 서비스의 엔드포인트인 모든 Pod에서 발생하는 송신 패킷의 소스 IP가 수신 IP라고 요청할 수 있는 CRD입니다. 또한 사용자는 LoadBalancer 서비스의 엔드포인트인 모든 Pod에서 발생하는 송신 패킷을 기본 네트워크와 다른 네트워크를 사용하도록 요청할 수 있습니다.
- 유형
-
object
7.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| EgressServiceSpec은 원하는 EgressService 상태를 정의합니다. |
|
| EgressServiceStatus는 EgressService의 관찰 상태를 정의합니다. |
7.1.1. .spec
- 설명
- EgressServiceSpec은 원하는 EgressService 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이 서비스가 송신 및 해당 수신 응답을 보내야 하는 네트워크입니다. 일반적으로 생략 시 기본 호스트 라우팅을 사용하는 라우팅 테이블의 숫자 ID 또는 문자열 이름을 나타내는 VRF 매핑으로 구현됩니다. |
|
| sourceIPBy=LoadBalancerIP를 통해 서비스의 트래픽을 처리하도록 선택할 수 있는 노드를 제한할 수 있습니다. 라벨이 지정된 선택기와 일치하는 노드만 있는 경우 서비스의 트래픽을 처리하기 위해 선택할 수 있습니다. 클러스터의 노드를 지정하지 않으면 서비스의 트래픽을 관리하기 위해 선택할 수 있습니다. |
|
|
LoadBalancer 서비스를 지원하는 Pod에서 발생하는 송신 트래픽의 소스 IP를 결정합니다. |
7.1.2. .spec.nodeSelector
- 설명
- sourceIPBy=LoadBalancerIP를 통해 서비스의 트래픽을 처리하도록 선택할 수 있는 노드를 제한할 수 있습니다. 라벨이 지정된 선택기와 일치하는 노드만 있는 경우 서비스의 트래픽을 처리하기 위해 선택할 수 있습니다. 클러스터의 노드를 지정하지 않으면 서비스의 트래픽을 관리하기 위해 선택할 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 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는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
7.1.5. .status
- 설명
- EgressServiceStatus는 EgressService의 관찰 상태를 정의합니다.
- 유형
-
object
- 필수 항목
-
host
-
속성 | 유형 | 설명 |
---|---|---|
|
| 서비스의 트래픽을 처리하기 위해 선택한 노드의 이름입니다. 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 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
7.2.2. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressservices
- HTTP 방법
-
DELETE
- 설명
- EgressService 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- EgressService 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- EgressService 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
7.2.3. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressservices/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| EgressService의 이름 |
- HTTP 방법
-
DELETE
- 설명
- EgressService 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 EgressService 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 EgressService를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 EgressService를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
7.2.4. /apis/k8s.ovn.org/v1/namespaces/{namespace}/egressservices/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| EgressService의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 EgressService의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 EgressService의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 EgressService의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
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은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| 모든 끝점의 세트는 모든 하위 집합의 결합입니다. 주소는 공유하는 IP에 따라 하위 집합에 배치됩니다. 여러 포트가 있는 단일 주소이며, 그 중 일부는 준비되었으며 그 중 일부는 (다른 컨테이너에서 제공되기 때문에) 다른 포트의 다른 하위 집합에 주소가 표시됩니다. 동일한 하위 집합의 addresses 및 NotReadyAddresses에 주소가 표시되지 않습니다. 서비스를 구성하는 주소 및 포트 세트입니다. |
|
| 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
속성 | 유형 | 설명 |
---|---|---|
|
| ready으로 표시된 관련 포트를 제공하는 IP 주소입니다. 이러한 끝점은 로드 밸런서 및 클라이언트가 사용할 수 있는 안전한 것으로 간주되어야 합니다. |
|
| EndpointAddress는 단일 IP 주소를 설명하는 튜플입니다. |
|
| 관련 포트를 제공하지만 아직 시작을 완료하지 않았거나 최근에 준비 상태 점검에 실패했거나 최근에 활성 검사에 실패했기 때문에 현재 준비 상태로 표시되지 않은 IP 주소입니다. |
|
| EndpointAddress는 단일 IP 주소를 설명하는 튜플입니다. |
|
| 관련 IP 주소에서 사용할 수 있는 포트 번호입니다. |
|
| EndpointPort는 단일 포트를 설명하는 튜플입니다. |
8.1.3. .subsets[].addresses
- 설명
- ready으로 표시된 관련 포트를 제공하는 IP 주소입니다. 이러한 끝점은 로드 밸런서 및 클라이언트가 사용할 수 있는 안전한 것으로 간주되어야 합니다.
- 유형
-
array
8.1.4. .subsets[].addresses[]
- 설명
- EndpointAddress는 단일 IP 주소를 설명하는 튜플입니다.
- 유형
-
object
- 필수 항목
-
ip
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이 끝점의 호스트 이름 |
|
| 이 끝점의 IP입니다. 루프백(127.0.0.0/8 또는 ::1), 링크-로컬(169.254.0.0/16 또는 fe80::/10) 또는 링크-로컬 멀티 캐스트(224.0.0.0/24 또는 ff02::/16)가 아닐 수 있습니다. |
|
| 선택 사항: 이 끝점을 호스팅하는 노드입니다. 노드에 로컬 끝점을 결정하는 데 사용할 수 있습니다. |
|
| ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다. |
8.1.5. .subsets[].addresses[].targetRef
- 설명
- ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. |
|
| 일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
| 이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
| 참조의 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이 끝점의 호스트 이름 |
|
| 이 끝점의 IP입니다. 루프백(127.0.0.0/8 또는 ::1), 링크-로컬(169.254.0.0/16 또는 fe80::/10) 또는 링크-로컬 멀티 캐스트(224.0.0.0/24 또는 ff02::/16)가 아닐 수 있습니다. |
|
| 선택 사항: 이 끝점을 호스팅하는 노드입니다. 노드에 로컬 끝점을 결정하는 데 사용할 수 있습니다. |
|
| ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다. |
8.1.8. .subsets[].notReadyAddresses[].targetRef
- 설명
- ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. |
|
| 일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
| 이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
| 참조의 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이 포트의 애플리케이션 프로토콜입니다. 이는 구현이 이해할 수 있는 프로토콜에 대해 보다 풍부한 동작을 제공하기 위한 힌트로 사용됩니다. 이 필드는 표준 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과 같은 구현 정의 접두사 이름을 사용해야 합니다. |
|
| 이 포트의 이름입니다. 이는 해당 ServicePort의 'name' 필드와 일치해야 합니다. DNS_LABEL이어야 합니다. 하나의 포트가 정의된 경우에만 선택 사항입니다. |
|
| 끝점의 포트 번호입니다. |
|
| 이 포트의 IP 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 TCP입니다.
가능한 열거 값: - |
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
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
8.2.2. /api/v1/watch/endpoints
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 끝점 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
8.2.3. /api/v1/namespaces/{namespace}/endpoints
- HTTP 방법
-
DELETE
- 설명
- 끝점 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- List or watch objects of kind Endpoints
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 끝점 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
8.2.4. /api/v1/watch/namespaces/{namespace}/endpoints
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 끝점 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
8.2.5. /api/v1/namespaces/{namespace}/endpoints/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 끝점의 이름 |
- HTTP 방법
-
DELETE
- 설명
- 엔드포인트 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 끝점 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 끝점을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 끝점을 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
8.2.6. /api/v1/watch/namespaces/{namespace}/endpoints/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 끝점의 이름 |
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 유형의 개체를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
9장. EndpointSlice [discovery.k8s.io/v1]
- 설명
- EndpointSlice는 서비스를 구현하는 끝점의 하위 집합을 나타냅니다. 지정된 서비스의 경우 레이블로 선택한 여러 EndpointSlice 오브젝트가 있을 수 있으며, 이 오브젝트는 전체 엔드포인트 세트를 생성하기 위해 결합되어야 합니다.
- 유형
-
object
- 필수 항목
-
addressType
-
끝점
-
9.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| addressType은 이 EndpointSlice에서 전송하는 주소 유형을 지정합니다. 이 슬라이스의 모든 주소는 동일한 유형이어야 합니다. 생성 후에는 이 필드를 변경할 수 없습니다. 현재 지원되는 주소 유형은 * IPv4: IPv4 주소를 나타냅니다. * IPv6: IPv6 주소를 나타냅니다. * FQDN: 정규화된 도메인 이름을 나타냅니다.
가능한 열거 값: - |
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| 끝점은 이 슬라이스의 고유한 끝점 목록입니다. 각 슬라이스에는 최대 1000개의 끝점이 포함될 수 있습니다. |
|
| 엔드포인트는 서비스를 구현하는 단일 논리 "backend"를 나타냅니다. |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. | |
|
| ports는 이 슬라이스의 각 끝점에 의해 노출되는 네트워크 포트 목록을 지정합니다. 각 포트에는 고유한 이름이 있어야 합니다. 포트가 비어 있으면 정의된 포트가 없음을 나타냅니다. port가 nil 포트 값으로 정의되면 "모든 포트"를 나타냅니다. 각 슬라이스에는 최대 100개의 포트가 포함될 수 있습니다. |
|
| EndpointPort는 EndpointSlice에서 사용하는 포트를 나타냅니다. |
9.1.1. .endpoints
- 설명
- 끝점은 이 슬라이스의 고유한 끝점 목록입니다. 각 슬라이스에는 최대 1000개의 끝점이 포함될 수 있습니다.
- 유형
-
array
9.1.2. .endpoints[]
- 설명
- 엔드포인트는 서비스를 구현하는 단일 논리 "backend"를 나타냅니다.
- 유형
-
object
- 필수 항목
-
주소
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이 끝점의 주소입니다. 이 필드의 내용은 해당 EndpointSlice addressType 필드에 따라 해석됩니다. 소비자는 자체 기능 컨텍스트에서 다양한 유형의 주소를 처리해야 합니다. 여기에는 하나 이상의 주소가 포함되어야 하지만 100을 초과해서는 안 됩니다. 이러한 모든 것은 번거로 간주되며 클라이언트는 첫 번째 요소 만 사용하도록 선택할 수 있습니다. 참조: https://issue.k8s.io/106267 |
|
| EndpointConditions는 끝점의 현재 상태를 나타냅니다. |
|
| deprecatedTopology에는 v1beta1 API의 토폴로지 정보 부분이 포함되어 있습니다. 이 필드는 더 이상 사용되지 않으며 v1beta1 API가 제거될 때 ( kubernetes v1.24)보다 빨리 제거됩니다. 이 필드는 값을 보유할 수 있지만 v1 API를 통해 쓸 수 없으며 쓰기 시도는 자동으로 무시됩니다. 토폴로지 정보는 대신 zone 및 nodeName 필드에서 찾을 수 있습니다. |
|
| EndpointHints는 끝점을 사용하는 방법을 설명하는 힌트를 제공합니다. |
|
| 이 끝점의 호스트 이름입니다. 엔드포인트 소비자는 이 필드를 사용하여 끝점을 서로 구분할 수 있습니다(예: DNS 이름). 동일한 호스트 이름을 사용하는 끝점이 여러 개 있는 것으로 간주해야 합니다(예: DNS의 여러 A 값). 소문자여야 하며 DNS 라벨(RFC 1123) 검증을 통과해야 합니다. |
|
| nodename은 이 엔드포인트를 호스팅하는 노드의 이름을 나타냅니다. 노드에 로컬 끝점을 결정하는 데 사용할 수 있습니다. |
| targetRef는 이 엔드포인트를 나타내는 Kubernetes 오브젝트에 대한 참조입니다. | |
|
| zone은 이 엔드포인트가 존재하는 영역의 이름입니다. |
9.1.3. .endpoints[].conditions
- 설명
- EndpointConditions는 끝점의 현재 상태를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| Ready는 엔드포인트를 관리하는 시스템에 따라 이 엔드포인트가 트래픽을 수신할 준비가 되었음을 나타냅니다. nil 값은 알 수 없는 상태를 나타냅니다. 대부분의 경우 소비자는 이 unknown 상태를 ready로 해석해야 합니다. 호환성을 위해 일반 준비 동작이 명시적으로 재정의되는 경우(예: 연결된 서비스에서 publishNotReadyAddresses 플래그를 설정 하는 경우)를 제외하고 끝점 종료에 대한 "true"는 절대 없어야 합니다. |
|
| 서빙은 끝점의 종료 상태에 관계없이 설정되어 있다는 점을 제외하고는 준비와 동일합니다. 이 조건은 종료 중인 준비된 끝점에 대해 true로 설정해야 합니다. nil인 경우 소비자는 ready 상태로 지연해야 합니다. |
|
| 종료는 이 끝점이 종료되었음을 나타냅니다. nil 값은 알 수 없는 상태를 나타냅니다. 소비자는 이 알 수 없는 상태를 해석하여 끝점이 종료되지 않음을 의미합니다. |
9.1.4. .endpoints[].hints
- 설명
- EndpointHints는 끝점을 사용하는 방법을 설명하는 힌트를 제공합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| forZones는 토폴로지 인식 라우팅을 활성화하기 위해 이 끝점이 사용해야 하는 영역을 나타냅니다. |
|
| ForZone은 이 엔드포인트를 사용해야 하는 영역에 대한 정보를 제공합니다. |
9.1.5. .endpoints[].hints.forZones
- 설명
- forZones는 토폴로지 인식 라우팅을 활성화하기 위해 이 끝점이 사용해야 하는 영역을 나타냅니다.
- 유형
-
array
9.1.6. .endpoints[].hints.forZones[]
- 설명
- ForZone은 이 엔드포인트를 사용해야 하는 영역에 대한 정보를 제공합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 영역의 이름을 나타냅니다. |
9.1.7. .ports
- 설명
- ports는 이 슬라이스의 각 끝점에 의해 노출되는 네트워크 포트 목록을 지정합니다. 각 포트에는 고유한 이름이 있어야 합니다. 포트가 비어 있으면 정의된 포트가 없음을 나타냅니다. port가 nil 포트 값으로 정의되면 "모든 포트"를 나타냅니다. 각 슬라이스에는 최대 100개의 포트가 포함될 수 있습니다.
- 유형
-
array
9.1.8. .ports[]
- 설명
- EndpointPort는 EndpointSlice에서 사용하는 포트를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이 포트의 애플리케이션 프로토콜입니다. 이는 구현이 이해할 수 있는 프로토콜에 대해 보다 풍부한 동작을 제공하기 위한 힌트로 사용됩니다. 이 필드는 표준 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은 이 포트의 이름을 나타냅니다. EndpointSlice의 모든 포트에는 고유한 이름이 있어야 합니다. Kubernetes 서비스에서 EndpointSlice가 파생되면 Service.ports[].name에 해당합니다. name은 빈 문자열이거나 DNS_LABEL 유효성 검사를 전달해야 합니다. * 길이는 63자 이하여야 합니다. * 소문자 영숫자 또는 '-'로 구성되어야 합니다. * 영숫자 문자로 시작하고 끝나야 합니다. 기본값은 빈 문자열입니다. |
|
| port는 끝점의 포트 번호를 나타냅니다. 이 값을 지정하지 않으면 포트가 제한되지 않으며 특정 소비자의 컨텍스트에서 해석되어야 합니다. |
|
| protocol은 이 포트의 IP 프로토콜을 나타냅니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 TCP입니다.
가능한 열거 값: - |
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 유형의 오브젝트 목록 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
9.2.2. /apis/discovery.k8s.io/v1/watch/endpointslices
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 EndpointSlice 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하십시오.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
9.2.3. /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices
- HTTP 방법
-
DELETE
- 설명
- EndpointSlice 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- EndpointSlice 유형의 오브젝트 목록 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- EndpointSlice 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
9.2.4. /apis/discovery.k8s.io/v1/watch/namespaces/{namespace}/endpointslices
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 EndpointSlice 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하십시오.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
9.2.5. /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| EndpointSlice의 이름 |
- HTTP 방법
-
DELETE
- 설명
- EndpointSlice 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 EndpointSlice 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 EndpointSlice를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 EndpointSlice를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
9.2.6. /apis/discovery.k8s.io/v1/watch/namespaces/{namespace}/endpointslices/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| EndpointSlice의 이름 |
- HTTP 방법
-
GET
- 설명
- EndpointSlice의 오브젝트 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 'watch' 매개변수를 목록 작업과 함께 대신 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
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은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| 원하는 송신 라우터의 사양입니다. |
|
| EgressRouter의 상태를 확인합니다. |
10.1.1. .spec
- 설명
- 원하는 송신 라우터의 사양입니다.
- 유형
-
object
- 필수 항목
-
주소
-
mode
-
networkInterface
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod의 보조 인터페이스에서 구성할 IP 주소 목록입니다. |
|
| EgressRouterAddress에는 라우터 인터페이스에서 구성할 IP CIDR 및 게이트웨이 쌍이 포함되어 있습니다. |
|
| 모드는 송신 라우터에 사용되는 모드를 표시합니다. 기본 모드는 "Redirect"이며 현재 지원되는 유일한 모드입니다. |
|
| 생성/사용할 인터페이스의 사양입니다. 기본값은 macvlan입니다. 현재 macvlan만 지원됩니다. |
|
| redirect는 리디렉션 모드와 관련된 구성 매개 변수를 나타냅니다. |
10.1.2. .spec.addresses
- 설명
- Pod의 보조 인터페이스에서 구성할 IP 주소 목록입니다.
- 유형
-
array
10.1.3. .spec.addresses[]
- 설명
- EgressRouterAddress에는 라우터 인터페이스에서 구성할 IP CIDR 및 게이트웨이 쌍이 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
ip
-
속성 | 유형 | 설명 |
---|---|---|
|
| 자동으로 확인할 수 없는 경우 next-hop 게이트웨이의 IP 주소입니다. IPv4 또는 IPv6일 수 있습니다. |
|
| IP는 라우터 인터페이스에서 구성할 주소입니다. IPv4 또는 IPv6일 수 있습니다. |
10.1.4. .spec.networkInterface
- 설명
- 생성/사용할 인터페이스의 사양입니다. 기본값은 macvlan입니다. 현재 macvlan만 지원됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| interfaceType macvlan와 관련된 인수 |
10.1.5. .spec.networkInterface.macvlan
- 설명
- interfaceType macvlan와 관련된 인수
- 유형
-
object
- 필수 항목
-
mode
-
속성 | 유형 | 설명 |
---|---|---|
|
| 마스터 인터페이스의 이름입니다. IP 주소에서 유추할 수 있는 경우 지정할 필요가 없습니다. |
|
| 모드는 macvlan 인터페이스에 사용되는 모드를 표시합니다. 브리지|Private|VEPA|Passthru. 기본 모드는 "Bridge"입니다. |
10.1.6. .spec.redirect
- 설명
- redirect는 리디렉션 모드와 관련된 구성 매개 변수를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| fallbackIP는 원격 대상의 IP 주소를 지정합니다. IPv4 또는 IPv6일 수 있습니다. 리디렉션 규칙이 지정되지 않은 경우 라우터의 모든 트래픽이 이 IP로 리디렉션됩니다. 리디렉션 규칙이 지정되면 라우터의 다른 포트(규칙에 정의되지 않음)의 모든 연결이 이 IP로 리디렉션됩니다. 리디렉션 규칙이 지정되고 대체 IP가 제공되지 않으면 다른 포트의 연결이 간단히 거부됩니다. |
|
| Pod에서 리디렉션 모드에서 대상으로 DNAT 리디렉션을 정의하는 L4RedirectRules 목록입니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| IP는 원격 대상의 IP 주소를 지정합니다. IPv4 또는 IPv6일 수 있습니다. |
|
| port는 클라이언트가 리디렉션할 트래픽을 보내야 하는 포트 번호입니다. |
|
| 프로토콜은 TCP, SCTP 또는 UDP일 수 있습니다. |
|
| targetPort를 사용하면 트래픽이 리디렉션되는 원격 대상의 포트 번호를 지정할 수 있습니다. 지정되지 않은 경우 "Port"의 값이 사용됩니다. |
10.1.9. .status
- 설명
- EgressRouter의 상태를 확인합니다.
- 유형
-
object
- 필수 항목
-
conditions
-
속성 | 유형 | 설명 |
---|---|---|
|
| 송신 라우터의 상태 |
|
| EgressRouterStatusCondition은 송신 라우터의 관리 및 모니터링 구성 요소의 상태를 나타냅니다. |
10.1.10. .status.conditions
- 설명
- 송신 라우터의 상태
- 유형
-
array
10.1.11. .status.conditions[]
- 설명
- EgressRouterStatusCondition은 송신 라우터의 관리 및 모니터링 구성 요소의 상태를 나타냅니다.
- 유형
-
object
- 필수 항목
-
status
-
type
-
속성 | 유형 | 설명 |
---|---|---|
| `` | LastTransitionTime은 현재 상태 속성에 대한 마지막 업데이트 시간입니다. |
|
| message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다. 새 줄로 렌더링되어야 하는 줄 Feed 문자(U+000A)가 포함될 수 있습니다. |
|
| 이유는 조건의 현재 상태에 대한 CamelCase 이유입니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 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 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
10.2.2. /apis/network.operator.openshift.io/v1/namespaces/{namespace}/egressrouters
- HTTP 방법
-
DELETE
- 설명
- EgressRouter 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 종류의 EgressRouter 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- EgressRouter 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
10.2.3. /apis/network.operator.openshift.io/v1/namespaces/{namespace}/egressrouters/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| EgressRouter의 이름 |
- HTTP 방법
-
DELETE
- 설명
- EgressRouter 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 EgressRouter 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 EgressRouter를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 EgressRouter 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
10.2.4. /apis/network.operator.openshift.io/v1/namespaces/{namespace}/egressrouters/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| EgressRouter의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 EgressRouter의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 EgressRouter의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 EgressRouter의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
11장. Ingress [networking.k8s.io/v1]
- 설명
- Ingress는 인바운드 연결이 백엔드에서 정의한 엔드포인트에 도달할 수 있도록 하는 규칙 컬렉션입니다. 외부에서 접근할 수 있는 URL, 로드 밸런싱 트래픽, SSL 종료, 이름 기반 가상 호스팅 등을 제공하도록 Ingress를 구성할 수 있습니다.
- 유형
-
object
11.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| IngressSpec은 사용자가 원하는 Ingress를 설명합니다. |
|
| IngressStatus는 Ingress의 현재 상태를 설명합니다. |
11.1.1. .spec
- 설명
- IngressSpec은 사용자가 원하는 Ingress를 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| IngressBackend는 지정된 서비스 및 포트의 모든 끝점을 설명합니다. |
|
|
ingressClassName은 IngressClass 클러스터 리소스의 이름입니다. Ingress 컨트롤러 구현에서는 이 필드를 사용하여 전송 연결(controller → IngressClass → Ingress 리소스)을 통해 이 Ingress 리소스를 제공해야 하는지 여부를 확인합니다. |
|
| 규칙은 Ingress를 구성하는 데 사용되는 호스트 규칙 목록입니다. 지정되지 않았거나 규칙이 일치하지 않으면 모든 트래픽이 기본 백엔드로 전송됩니다. |
|
| IngressRule은 지정된 호스트의 경로를 관련 백엔드 서비스에 매핑하는 규칙을 나타냅니다. 들어오는 요청은 먼저 호스트 일치에 대해 평가된 다음 일치하는 IngressRuleValue와 연결된 백엔드로 라우팅됩니다. |
|
| TLS는 TLS 구성을 나타냅니다. 현재 Ingress는 단일 TLS 포트 443만 지원합니다. 이 목록의 여러 멤버가 다른 호스트를 지정하는 경우 수신 컨트롤러가 SNI를 지원하는 경우 SNI TLS 확장을 통해 지정된 호스트 이름에 따라 동일한 포트에서 멀티플렉싱됩니다. |
|
| IngressTLS는 수신과 관련된 전송 계층 보안을 설명합니다. |
11.1.2. .spec.defaultBackend
- 설명
- IngressBackend는 지정된 서비스 및 포트의 모든 끝점을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| resource는 Ingress 오브젝트의 네임스페이스에 있는 다른 Kubernetes 리소스에 대한 ObjectRef입니다. 리소스가 지정된 경우 service.Name 및 service.Port를 지정할 수 없습니다. 이는 "Service"와 함께 사용할 수 있는 설정입니다. | |
|
| IngressServiceBackend는 Kubernetes 서비스를 백엔드로 참조합니다. |
11.1.3. .spec.defaultBackend.service
- 설명
- IngressServiceBackend는 Kubernetes 서비스를 백엔드로 참조합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 서비스입니다. 서비스는 Ingress 오브젝트와 동일한 네임스페이스에 있어야 합니다. |
|
| ServiceBackendPort는 참조 중인 서비스 포트입니다. |
11.1.4. .spec.defaultBackend.service.port
- 설명
- ServiceBackendPort는 참조 중인 서비스 포트입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| name은 서비스에 있는 포트의 이름입니다. 이는 "Number"와 함께 상호 배타적인 설정입니다. |
|
| number는 서비스의 숫자 포트 번호(예: 80)입니다. 이는 "Name"과 함께 사용할 수 있는 설정입니다. |
11.1.5. .spec.rules
- 설명
- 규칙은 Ingress를 구성하는 데 사용되는 호스트 규칙 목록입니다. 지정되지 않았거나 규칙이 일치하지 않으면 모든 트래픽이 기본 백엔드로 전송됩니다.
- 유형
-
array
11.1.6. .spec.rules[]
- 설명
- IngressRule은 지정된 호스트의 경로를 관련 백엔드 서비스에 매핑하는 규칙을 나타냅니다. 들어오는 요청은 먼저 호스트 일치에 대해 평가된 다음 일치하는 IngressRuleValue와 연결된 백엔드로 라우팅됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
host는 RFC 3986에 정의된 네트워크 호스트의 정규화된 도메인 이름입니다. RFC 3986: 1에 정의된 URI의 "호스트" 부분에서의 다음 편차에 유의하십시오. IP는 허용되지 않습니다. 현재 IngressRuleValue는 상위 Ingress 사양의 IP에만 적용할 수 있습니다. 2. 포트가 허용되지 않기 때문에 구분 기호는 보장되지 않습니다. 호스트는 네트워크 호스트의 종료점(예: "foo.bar.com") 또는 "wildcard"(예: ".foo.foo.com")로 접두사가 지정된 도메인 이름 없이 도메인 이름인 "precise"일 수 있습니다. 와일드카드 문자 ''는 그 자체로 첫 번째 DNS 레이블로 표시되어야 하며 단일 레이블과 일치해야 합니다. 와일드카드 레이블 자체(예: Host == "*")를 포함할 수 없습니다. 요청은 다음과 같은 방식으로 Host 필드와 일치됩니다. 1. host가 정확하면 http 호스트 헤더가 Host와 같은 경우 요청이 이 규칙과 일치합니다. 2. host가 와일드카드인 경우 http 호스트 헤더가 와일드카드 규칙의 접미사(첫 번째 레이블 제거)와 같은 경우 요청은 이 규칙과 일치합니다. |
|
| 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
- 필수 항목
-
경로
-
속성 | 유형 | 설명 |
---|---|---|
|
| 경로는 요청을 백엔드에 매핑하는 경로 컬렉션입니다. |
|
| HTTPIngressPath는 경로를 백엔드와 연결합니다. 경로와 일치하는 들어오는 URL은 백엔드로 전달됩니다. |
11.1.8. .spec.rules[].http.paths
- 설명
- 경로는 요청을 백엔드에 매핑하는 경로 컬렉션입니다.
- 유형
-
array
11.1.9. .spec.rules[].http.paths[]
- 설명
- HTTPIngressPath는 경로를 백엔드와 연결합니다. 경로와 일치하는 들어오는 URL은 백엔드로 전달됩니다.
- 유형
-
object
- 필수 항목
-
pathType
-
백엔드
-
속성 | 유형 | 설명 |
---|---|---|
|
| IngressBackend는 지정된 서비스 및 포트의 모든 끝점을 설명합니다. |
|
| 경로는 들어오는 요청 경로와 일치합니다. 현재 RFC 3986에서 정의한 URL의 기존 "path" 부분에서 허용되지 않은 문자를 포함할 수 있습니다. 경로는 '/'로 시작해야 하며 값 "Exact" 또는 "Prefix"와 함께 PathType을 사용할 때 존재해야 합니다. |
|
| pathType은 일치하는 경로의 해석을 결정합니다. pathType은 다음 값 중 하나일 수 있습니다. * Exact: URL 경로가 정확히 일치합니다. * 접두사: '/'로 분할되는 URL 경로 접두사에 따라 일치합니다. 일치는 요소별로 경로 요소에 따라 수행됩니다. 경로 요소는 경로의 레이블 목록을 '/' 구분 기호로 나눈 값입니다. 요청은 모든 p가 요청 경로 p의 element-wise 접두사인 경우 경로 p에 대한 일치입니다. 경로의 마지막 요소가 요청 경로의 마지막 요소의 하위 요소인 경우 일치하는 항목이 아닙니다(예: /foo/bar/baz와 /foo/bar/baz와 일치하지만 /foo/barbaz와 일치하지 않음). * ImplementationSpecific: 경로 일치의 상호 운용성은 IngressClass에 따라 다릅니다. 구현은 이를 별도의 PathType으로 처리하거나 Prefix 또는 Exact 경로 유형과 동일하게 처리할 수 있습니다. 구현은 모든 경로 유형을 지원하는 데 필요합니다.
가능한 enum 값: - |
11.1.10. .spec.rules[].http.paths[].backend
- 설명
- IngressBackend는 지정된 서비스 및 포트의 모든 끝점을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| resource는 Ingress 오브젝트의 네임스페이스에 있는 다른 Kubernetes 리소스에 대한 ObjectRef입니다. 리소스가 지정된 경우 service.Name 및 service.Port를 지정할 수 없습니다. 이는 "Service"와 함께 사용할 수 있는 설정입니다. | |
|
| IngressServiceBackend는 Kubernetes 서비스를 백엔드로 참조합니다. |
11.1.11. .spec.rules[].http.paths[].backend.service
- 설명
- IngressServiceBackend는 Kubernetes 서비스를 백엔드로 참조합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 서비스입니다. 서비스는 Ingress 오브젝트와 동일한 네임스페이스에 있어야 합니다. |
|
| ServiceBackendPort는 참조 중인 서비스 포트입니다. |
11.1.12. .spec.rules[].http.paths[].backend.service.port
- 설명
- ServiceBackendPort는 참조 중인 서비스 포트입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| name은 서비스에 있는 포트의 이름입니다. 이는 "Number"와 함께 상호 배타적인 설정입니다. |
|
| 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은 포트 443에서 TLS 트래픽을 종료하는 데 사용되는 시크릿의 이름입니다. SNI 호스트 이름만으로 TLS 라우팅을 허용하는 필드는 선택 사항입니다. 리스너의 SNI 호스트가 IngressRule에서 사용하는 "Host" 헤더 필드와 충돌하는 경우 SNI 호스트는 종료에 사용되며 "Host" 헤더의 값이 라우팅에 사용됩니다. |
11.1.15. .status
- 설명
- IngressStatus는 Ingress의 현재 상태를 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| IngressLoadBalancerStatus는 로드 밸런서의 상태를 나타냅니다. |
11.1.16. .status.loadBalancer
- 설명
- IngressLoadBalancerStatus는 로드 밸런서의 상태를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| Ingress는 로드 밸런서에 대한 수신 지점을 포함하는 목록입니다. |
|
| IngressLoadBalancerIngress는 로드 밸런서 인그레스 지점의 상태를 나타냅니다. |
11.1.17. .status.loadBalancer.ingress
- 설명
- Ingress는 로드 밸런서에 대한 수신 지점을 포함하는 목록입니다.
- 유형
-
array
11.1.18. .status.loadBalancer.ingress[]
- 설명
- IngressLoadBalancerIngress는 로드 밸런서 인그레스 지점의 상태를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 호스트 이름은 DNS 기반 로드 밸런서 인그레스 지점에 대해 설정됩니다. |
|
| IP는 IP 기반 로드 밸런서 인그레스 지점에 대해 설정됩니다. |
|
| 포트는 이 LoadBalancer에서 노출하는 포트에 대한 정보를 제공합니다. |
|
| IngressPortStatus는 서비스 포트의 오류 조건을 나타냅니다. |
11.1.19. .status.loadBalancer.ingress[].ports
- 설명
- 포트는 이 LoadBalancer에서 노출하는 포트에 대한 정보를 제공합니다.
- 유형
-
array
11.1.20. .status.loadBalancer.ingress[].ports[]
- 설명
- IngressPortStatus는 서비스 포트의 오류 조건을 나타냅니다.
- 유형
-
object
- 필수 항목
-
port
-
protocol
-
속성 | 유형 | 설명 |
---|---|---|
|
| 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는 Ingress 포트의 포트 번호입니다. |
|
| protocol은 Ingress 포트의 프로토콜입니다. 지원되는 값은 "TCP", "UDP", "SCTP"입니다.
가능한 열거 값: - |
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 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
11.2.2. /apis/networking.k8s.io/v1/watch/ingresses
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 Ingress 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
11.2.3. /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses
- HTTP 방법
-
DELETE
- 설명
- Ingress 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- Ingress 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- Ingress 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
11.2.4. /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/ingresses
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 Ingress 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
11.2.5. /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| Ingress의 이름 |
- HTTP 방법
-
DELETE
- 설명
- Ingress 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 Ingress 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 Ingress를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 Ingress 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
11.2.6. /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/ingresses/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| Ingress의 이름 |
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 종류의 오브젝트를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
11.2.7. /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| Ingress의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 Ingress의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 Ingress의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 Ingress의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
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은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| IngressClassSpec은 Ingress의 클래스에 대한 정보를 제공합니다. |
12.1.1. .spec
- 설명
- IngressClassSpec은 Ingress의 클래스에 대한 정보를 제공합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 컨트롤러는 이 클래스를 처리해야 하는 컨트롤러의 이름을 나타냅니다. 이렇게 하면 동일한 컨트롤러에서 제어하는 다른 "flavors"가 허용됩니다. 예를 들어 동일한 구현 컨트롤러에 대한 매개변수가 다를 수 있습니다. 이는 "acme.io/ingress-controller"와 같이 250자를 초과할 수 없는 도메인 접두사 경로로 지정해야 합니다. 이 필드는 변경할 수 없습니다. |
|
| IngressClassParametersReference는 API 오브젝트를 식별합니다. 클러스터 또는 네임스페이스 범위 리소스를 지정하는 데 사용할 수 있습니다. |
12.1.2. .spec.parameters
- 설명
- IngressClassParametersReference는 API 오브젝트를 식별합니다. 클러스터 또는 네임스페이스 범위 리소스를 지정하는 데 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
kind
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| apiGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다. |
|
| kind는 참조되는 리소스 유형입니다. |
|
| name은 참조 중인 리소스의 이름입니다. |
|
| 네임스페이스는 참조 중인 리소스의 네임스페이스입니다. 이 필드는 범위가 "Namespace"로 설정될 때 필요하며 범위가 "Cluster"로 설정된 경우 설정되지 않아야 합니다. |
|
| 범위는 클러스터 또는 네임스페이스 범위 리소스를 참조하는지 여부를 나타냅니다. 이는 "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의 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- IngressClass 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- IngressClass 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
12.2.2. /apis/networking.k8s.io/v1/watch/ingressclasses
- HTTP 방법
-
GET
- 설명
- IngressClass. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
12.2.3. /apis/networking.k8s.io/v1/ingressclasses/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| IngressClass의 이름 |
- HTTP 방법
-
DELETE
- 설명
- IngressClass 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 IngressClass 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 IngressClass를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 IngressClass 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
12.2.4. /apis/networking.k8s.io/v1/watch/ingressclasses/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| IngressClass의 이름 |
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 종류의 오브젝트를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
13장. IPPool [whereabouts.cni.cncf.io/v1alpha1]
- 설명
- IPPool은 ippools API의 스키마입니다.
- 유형
-
object
13.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| IPPoolSpec은 원하는 IPPool 상태를 정의합니다. |
13.1.1. .spec
- 설명
- IPPoolSpec은 원하는 IPPool 상태를 정의합니다.
- 유형
-
object
- 필수 항목
-
할당
-
range
-
속성 | 유형 | 설명 |
---|---|---|
|
| 할당은 지정된 범위에 할당된 IP 세트입니다. 해당 인덱스의 인덱스는 풀 범위에 대해 동일한 index/offset를 사용하여 IP에 직접 매핑됩니다. |
|
| IPAllocation은 특정 IP의 pod/container 소유자에 대한 메타데이터를 나타냅니다. |
|
| 범위는 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| |
|
| |
|
|
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의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
13.2.2. /apis/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/ippools
- HTTP 방법
-
DELETE
- 설명
- IPPool 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 종류 IPPool의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- IPPool 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
13.2.3. /apis/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/ippools/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| IPPool의 이름 |
- HTTP 방법
-
DELETE
- 설명
- IPPool 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 IPPool 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 IPPool을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 IPPool을 바꿉니다.
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
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은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| NetworkAttachmentDefinition 사양은 네트워크 연결의 원하는 상태를 정의합니다. |
14.1.1. .spec
- 설명
- NetworkAttachmentDefinition 사양은 네트워크 연결의 원하는 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 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 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
14.2.2. /apis/k8s.cni.cncf.io/v1/namespaces/{namespace}/network-attachment-definitions
- HTTP 방법
-
DELETE
- 설명
- NetworkAttachmentDefinition 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- NetworkAttachmentDefinition 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- NetworkAttachmentDefinition 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
14.2.3. /apis/k8s.cni.cncf.io/v1/namespaces/{namespace}/network-attachment-definitions/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| NetworkAttachmentDefinition의 이름 |
- HTTP 방법
-
DELETE
- 설명
- delete a NetworkAttachmentDefinition
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 NetworkAttachmentDefinition 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 NetworkAttachmentDefinition을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 NetworkAttachmentDefinition을 대체합니다.
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
15장. NetworkPolicy [networking.k8s.io/v1]
- 설명
- NetworkPolicy는 일련의 Pod에 허용되는 네트워크 트래픽을 설명합니다.
- 유형
-
object
15.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| NetworkPolicySpec은 NetworkPolicy 사양을 제공합니다. |
15.1.1. .spec
- 설명
- NetworkPolicySpec은 NetworkPolicy 사양을 제공합니다.
- 유형
-
object
- 필수 항목
-
podSelector
-
속성 | 유형 | 설명 |
---|---|---|
|
| egress는 선택한 Pod에 적용할 송신 규칙 목록입니다. Pod(및 클러스터 정책)를 선택하는 NetworkPolicies가 없거나 트래픽이 Pod와 일치하는 모든 NetworkPolicy 오브젝트에서 하나 이상의 송신 규칙과 일치하는 경우 발신 트래픽이 허용됩니다. 이 필드가 비어 있으면 이 NetworkPolicy는 모든 발신 트래픽을 제한하고 선택한 Pod가 기본적으로 격리되도록만 사용됩니다. 이 필드는 1.8의 베타 수준입니다. |
|
| NetworkPolicyEgressRule은 NetworkPolicySpec의 podSelector와 일치하는 Pod가 없는 특정 트래픽 세트를 설명합니다. 트래픽은 포트 및 에 모두 일치해야 합니다. 이 유형은 1.8의 베타 수준입니다. |
|
| Ingress는 선택한 Pod에 적용할 수신 규칙 목록입니다. Pod(및 클러스터 정책)를 선택하는 NetworkPolicies가 없거나 트래픽 소스가 Pod의 로컬 노드인 경우 또는 podSelector가 Pod와 일치하는 모든 NetworkPolicy 오브젝트에서 하나 이상의 수신 규칙과 일치하는 경우 트래픽이 포드에 허용됩니다. 이 필드가 비어 있으면 이 NetworkPolicy는 트래픽을 허용하지 않습니다. 선택한 Pod가 기본적으로 격리되도록만 사용됩니다. |
|
| NetworkPolicyIngressRule은 NetworkPolicySpec의 podSelector와 일치하는 Pod에 허용되는 특정 트래픽 세트를 설명합니다. 트래픽은 포트 및 의 포트와 일치해야 합니다. |
| podSelector는 이 NetworkPolicy 오브젝트가 적용되는 Pod를 선택합니다. 수신 규칙 배열은 이 필드에서 선택한 모든 Pod에 적용됩니다. 여러 네트워크 정책에서 동일한 Pod 세트를 선택할 수 있습니다. 이 경우 각각에 대한 수신 규칙은 추가적으로 결합됩니다. 이 필드는 선택 사항이 아니며 표준 라벨 선택기 의미 체계를 따릅니다. 빈 podSelector는 이 네임스페이스의 모든 Pod와 일치합니다. | |
|
| 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
속성 | 유형 | 설명 |
---|---|---|
|
| 포트는 발신 트래픽의 대상 포트 목록입니다. 이 목록의 각 항목은 논리 OR를 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 포트와 일치합니다(포트로 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 목록의 하나 이상의 포트와 일치하는 경우에만 트래픽을 허용합니다. |
|
| NetworkPolicyPort는 트래픽을 허용하는 포트를 설명합니다. |
|
| to는 이 규칙에 대해 선택된 포드의 발신 트래픽의 대상 목록입니다. 이 목록의 항목은 논리 OR 작업을 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 대상과 일치합니다(대상에 의해 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 목록에서 하나 이상의 항목과 일치하는 경우에만 트래픽을 허용합니다. |
|
| NetworkPolicyPeer는 트래픽을/에서 허용할 피어를 설명합니다. 특정 필드 조합만 허용됩니다. |
15.1.4. .spec.egress[].ports
- 설명
- 포트는 발신 트래픽의 대상 포트 목록입니다. 이 목록의 각 항목은 논리 OR를 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 포트와 일치합니다(포트로 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 목록의 하나 이상의 포트와 일치하는 경우에만 트래픽을 허용합니다.
- 유형
-
array
15.1.5. .spec.egress[].ports[]
- 설명
- NetworkPolicyPort는 트래픽을 허용하는 포트를 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| endPort는 정책에 의해 설정된 경우 포트에서 endPort까지의 포트 범위가 허용됨을 나타냅니다. port 필드가 정의되지 않았거나 port 필드가 이름이 지정된 (문자열) 포트로 정의된 경우 이 필드를 정의할 수 없습니다. endPort는 포트보다 크거나 같아야 합니다. |
| port는 지정된 프로토콜의 포트를 나타냅니다. Pod에서 숫자 또는 이름이 지정된 포트일 수 있습니다. 이 필드를 제공하지 않으면 모든 포트 이름과 숫자와 일치합니다. 있는 경우 지정된 프로토콜 및 포트의 트래픽만 일치합니다. | |
|
| protocol은 트래픽이 일치해야 하는 프로토콜(TCP, UDP 또는 SCTP)을 나타냅니다. 지정하지 않으면 이 필드는 기본적으로 TCP로 설정됩니다.
가능한 열거 값: - |
15.1.6. .spec.egress[].to
- 설명
- to는 이 규칙에 대해 선택된 포드의 발신 트래픽의 대상 목록입니다. 이 목록의 항목은 논리 OR 작업을 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 대상과 일치합니다(대상에 의해 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 목록에서 하나 이상의 항목과 일치하는 경우에만 트래픽을 허용합니다.
- 유형
-
array
15.1.7. .spec.egress[].to[]
- 설명
- NetworkPolicyPeer는 트래픽을/에서 허용할 피어를 설명합니다. 특정 필드 조합만 허용됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| IPBlock은 특정 CIDR을 설명합니다(Ex. NetworkPolicySpec의 podSelector와 일치하는 Pod에 허용되는 "192.168.1.0/24","2001:db8::/64"). except 항목은 이 규칙에 포함되지 않아야 하는 CIDR을 설명합니다. |
| namespaceSelector는 클러스터 범위 레이블을 사용하여 네임스페이스를 선택합니다. 이 필드는 표준 라벨 선택기 의미 체계를 따릅니다. 존재하지만 비어 있으면 모든 네임스페이스를 선택합니다. podSelector도 설정된 경우 전체 NetworkPolicyPeer는 namespaceSelector에서 선택한 네임스페이스에서 podSelector와 일치하는 Pod를 선택합니다. 그러지 않으면 namespaceSelector에서 선택한 네임스페이스의 모든 Pod를 선택합니다. | |
| 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은 IPBlock Valid 예제를 나타내는 문자열입니다 "192.168.1.0/24" 또는 "2001:db8::/64" |
|
| 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
속성 | 유형 | 설명 |
---|---|---|
|
| 에서 이 규칙에 대해 선택한 포드에 액세스할 수 있어야 하는 소스 목록입니다. 이 목록의 항목은 논리 OR 작업을 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 소스와 일치합니다(소스로 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 from 목록의 하나 이상의 항목과 일치하는 경우에만 트래픽을 허용합니다. |
|
| NetworkPolicyPeer는 트래픽을/에서 허용할 피어를 설명합니다. 특정 필드 조합만 허용됩니다. |
|
| 포트는 이 규칙에 대해 선택한 Pod에서 액세스할 수 있어야 하는 포트 목록입니다. 이 목록의 각 항목은 논리 OR를 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 포트와 일치합니다(포트로 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 목록의 하나 이상의 포트와 일치하는 경우에만 트래픽을 허용합니다. |
|
| NetworkPolicyPort는 트래픽을 허용하는 포트를 설명합니다. |
15.1.11. .spec.ingress[].from
- 설명
- 에서 이 규칙에 대해 선택한 포드에 액세스할 수 있어야 하는 소스 목록입니다. 이 목록의 항목은 논리 OR 작업을 사용하여 결합됩니다. 이 필드가 비어 있거나 누락된 경우 이 규칙은 모든 소스와 일치합니다(소스로 제한되지 않은 트래픽). 이 필드가 있고 하나 이상의 항목이 포함된 경우 이 규칙은 트래픽이 from 목록의 하나 이상의 항목과 일치하는 경우에만 트래픽을 허용합니다.
- 유형
-
array
15.1.12. .spec.ingress[].from[]
- 설명
- NetworkPolicyPeer는 트래픽을/에서 허용할 피어를 설명합니다. 특정 필드 조합만 허용됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| IPBlock은 특정 CIDR을 설명합니다(Ex. NetworkPolicySpec의 podSelector와 일치하는 Pod에 허용되는 "192.168.1.0/24","2001:db8::/64"). except 항목은 이 규칙에 포함되지 않아야 하는 CIDR을 설명합니다. |
| namespaceSelector는 클러스터 범위 레이블을 사용하여 네임스페이스를 선택합니다. 이 필드는 표준 라벨 선택기 의미 체계를 따릅니다. 존재하지만 비어 있으면 모든 네임스페이스를 선택합니다. podSelector도 설정된 경우 전체 NetworkPolicyPeer는 namespaceSelector에서 선택한 네임스페이스에서 podSelector와 일치하는 Pod를 선택합니다. 그러지 않으면 namespaceSelector에서 선택한 네임스페이스의 모든 Pod를 선택합니다. | |
| 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은 IPBlock Valid 예제를 나타내는 문자열입니다 "192.168.1.0/24" 또는 "2001:db8::/64" |
|
| 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는 정책에 의해 설정된 경우 포트에서 endPort까지의 포트 범위가 허용됨을 나타냅니다. port 필드가 정의되지 않았거나 port 필드가 이름이 지정된 (문자열) 포트로 정의된 경우 이 필드를 정의할 수 없습니다. endPort는 포트보다 크거나 같아야 합니다. |
| port는 지정된 프로토콜의 포트를 나타냅니다. Pod에서 숫자 또는 이름이 지정된 포트일 수 있습니다. 이 필드를 제공하지 않으면 모든 포트 이름과 숫자와 일치합니다. 있는 경우 지정된 프로토콜 및 포트의 트래픽만 일치합니다. | |
|
| protocol은 트래픽이 일치해야 하는 프로토콜(TCP, UDP 또는 SCTP)을 나타냅니다. 지정하지 않으면 이 필드는 기본적으로 TCP로 설정됩니다.
가능한 열거 값: - |
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의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
15.2.2. /apis/networking.k8s.io/v1/watch/networkpolicies
- HTTP 방법
-
GET
- 설명
- NetworkPolicy 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
15.2.3. /apis/networking.k8s.io/v1/namespaces/{namespace}/networkpolicies
- HTTP 방법
-
DELETE
- 설명
- NetworkPolicy 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- kind NetworkPolicy의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- NetworkPolicy 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
15.2.4. /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/networkpolicies
- HTTP 방법
-
GET
- 설명
- NetworkPolicy 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
15.2.5. /apis/networking.k8s.io/v1/namespaces/{namespace}/networkpolicies/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| NetworkPolicy의 이름 |
- HTTP 방법
-
DELETE
- 설명
- NetworkPolicy 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 NetworkPolicy 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 NetworkPolicy를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 NetworkPolicy를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
15.2.6. /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/networkpolicies/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| NetworkPolicy의 이름 |
- HTTP 방법
-
GET
- 설명
- NetworkPolicy 유형의 오브젝트 변경 사항을 확인합니다. 더 이상 사용되지 않는 'watch' 매개변수를 대신 목록 작업과 함께 사용하여 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링됩니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
16장. OverlappingRangeIPReservation [whereabouts.cni.cncf.io/v1alpha1]
- 설명
- OverlappingRangeIPReservation은 OverlappingRangeIPReservations API의 스키마입니다.
- 유형
-
object
- 필수 항목
-
spec
-
16.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| OverlappingRangeIPReservationSpec은 원하는 상태 OverlappingRangeIPReservation을 정의합니다. |
16.1.1. .spec
- 설명
- OverlappingRangeIPReservationSpec은 원하는 상태 OverlappingRangeIPReservation을 정의합니다.
- 유형
-
object
- 필수 항목
-
podref
-
속성 | 유형 | 설명 |
---|---|---|
|
| |
|
| |
|
|
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 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
16.2.2. /apis/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/overlappingrangeipreservations
- HTTP 방법
-
DELETE
- 설명
- OverlappingRangeIPReservation 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- OverlappingRangeIPReservation 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- OverlappingRangeIPReservation 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
16.2.3. /apis/whereabouts.cni.cncf.io/v1alpha1/namespaces/{namespace}/overlappingrangeipreservations/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| OverlappingRangeIPReservation 이름 |
- HTTP 방법
-
DELETE
- 설명
- OverlappingRangeIPReservation 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 OverlappingRangeIPReservation 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 OverlappingRangeIPReservation을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 OverlappingRangeIPReservation 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
17장. PodNetworkConnectivityCheck [controlplane.operator.openshift.io/v1alpha1]
- 설명
- PodNetworkConnectivityCheck 호환성 수준 4: 호환성이 제공되지 않으므로 언제든지 API를 변경할 수 있습니다. 이러한 기능은 장기 지원이 필요한 애플리케이션에서 사용해서는 안 됩니다.
- 유형
-
object
- 필수 항목
-
spec
-
17.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec은 연결 검사의 소스 및 대상을 정의합니다. |
|
| status에는 연결 검사의 관찰된 상태가 포함되어 있습니다. |
17.1.1. .spec
- 설명
- spec은 연결 검사의 소스 및 대상을 정의합니다.
- 유형
-
object
- 필수 항목
-
sourcePod
-
targetEndpoint
-
속성 | 유형 | 설명 |
---|---|---|
|
| sourcePod는 조건을 확인할 Pod의 이름을 지정합니다. |
|
| 확인할 EndpointAddress입니다. host:port 형식의 TCP 주소입니다. host가 DNS 이름인 경우 DNS 이름을 확인할 수 없는 경우 검사가 실패합니다. DNS 이름 조회를 바이패스하려면 호스트의 IP 주소를 지정합니다. |
|
| 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은 참조된 보안의 metadata.name입니다. |
17.1.3. .status
- 설명
- status에는 연결 검사의 관찰된 상태가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 검사 상태 요약 |
|
| PodNetworkConnectivityCheckCondition은 Pod 네트워크 연결의 전체 상태를 나타냅니다. |
|
| 실패에 실패한 검사 작업의 로그가 포함됩니다. |
|
| LogEntry 레코드 이벤트 |
|
| 중단에 대한 로그가 포함됩니다. |
|
| OutageEntry는 중단의 기간을 기록합니다. |
|
| 성공 사례에는 성공적인 검사 작업 로그가 포함되어 있습니다. |
|
| LogEntry 레코드 이벤트 |
17.1.4. .status.conditions
- 설명
- 검사 상태 요약
- 유형
-
array
17.1.5. .status.conditions[]
- 설명
- PodNetworkConnectivityCheckCondition은 Pod 네트워크 연결의 전체 상태를 나타냅니다.
- 유형
-
object
- 필수 항목
-
status
-
type
-
속성 | 유형 | 설명 |
---|---|---|
| `` | 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. |
|
| 사람이 읽을 수 있는 형식으로 마지막 전환에 대한 세부 정보를 나타내는 메시지입니다. |
|
| 조건의 마지막 상태 전환이 머신에서 읽을 수 있는 형식으로 전환되기 때문입니다. |
|
| 조건의 상태 |
|
| 조건의 유형 |
17.1.6. .status.failures
- 설명
- 실패에 실패한 검사 작업의 로그가 포함됩니다.
- 유형
-
array
17.1.7. .status.failures[]
- 설명
- LogEntry 레코드 이벤트
- 유형
-
object
- 필수 항목
-
success
-
속성 | 유형 | 설명 |
---|---|---|
| `` | 대기 시간은 항목에 언급된 작업이 걸린 시간을 기록합니다. |
|
| 사람이 읽을 수 있는 형식으로 상태를 설명하는 메시지입니다. |
|
| 머신에서 읽을 수 있는 형식의 상태 때문입니다. |
|
| 성공은 로그 항목이 성공 또는 실패를 나타내는지 여부를 나타냅니다. |
| `` | 검사 작업의 시작 시간입니다. |
17.1.8. .status.outages
- 설명
- 중단에 대한 로그가 포함됩니다.
- 유형
-
array
17.1.9. .status.outages[]
- 설명
- OutageEntry는 중단의 기간을 기록합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| `` | 감지된 중단 종료 |
|
| endLogs에는 이 중단의 끝과 관련된 로그 항목이 포함되어 있습니다. 중단을 해결한 성공 항목과 일부 실패 로그 항목이 선행되어야 합니다. |
|
| LogEntry 레코드 이벤트 |
|
| 메시지에는 사람이 읽을 수 있는 형식으로 중단 세부 정보가 요약되어 있습니다. |
| `` | 감지된 중단 시작 |
|
| startLogs에는 이 중단 시작과 관련된 로그 항목이 포함되어 있습니다. 원래 실패, 실패 모드가 변경된 모든 항목이 포함되어야 합니다. |
|
| LogEntry 레코드 이벤트 |
17.1.10. .status.outages[].endLogs
- 설명
- endLogs에는 이 중단의 끝과 관련된 로그 항목이 포함되어 있습니다. 중단을 해결한 성공 항목과 일부 실패 로그 항목이 선행되어야 합니다.
- 유형
-
array
17.1.11. .status.outages[].endLogs[]
- 설명
- LogEntry 레코드 이벤트
- 유형
-
object
- 필수 항목
-
success
-
속성 | 유형 | 설명 |
---|---|---|
| `` | 대기 시간은 항목에 언급된 작업이 걸린 시간을 기록합니다. |
|
| 사람이 읽을 수 있는 형식으로 상태를 설명하는 메시지입니다. |
|
| 머신에서 읽을 수 있는 형식의 상태 때문입니다. |
|
| 성공은 로그 항목이 성공 또는 실패를 나타내는지 여부를 나타냅니다. |
| `` | 검사 작업의 시작 시간입니다. |
17.1.12. .status.outages[].startLogs
- 설명
- startLogs에는 이 중단 시작과 관련된 로그 항목이 포함되어 있습니다. 원래 실패, 실패 모드가 변경된 모든 항목이 포함되어야 합니다.
- 유형
-
array
17.1.13. .status.outages[].startLogs[]
- 설명
- LogEntry 레코드 이벤트
- 유형
-
object
- 필수 항목
-
success
-
속성 | 유형 | 설명 |
---|---|---|
| `` | 대기 시간은 항목에 언급된 작업이 걸린 시간을 기록합니다. |
|
| 사람이 읽을 수 있는 형식으로 상태를 설명하는 메시지입니다. |
|
| 머신에서 읽을 수 있는 형식의 상태 때문입니다. |
|
| 성공은 로그 항목이 성공 또는 실패를 나타내는지 여부를 나타냅니다. |
| `` | 검사 작업의 시작 시간입니다. |
17.1.14. .status.successes
- 설명
- 성공 사례에는 성공적인 검사 작업 로그가 포함되어 있습니다.
- 유형
-
array
17.1.15. .status.successes[]
- 설명
- LogEntry 레코드 이벤트
- 유형
-
object
- 필수 항목
-
success
-
속성 | 유형 | 설명 |
---|---|---|
| `` | 대기 시간은 항목에 언급된 작업이 걸린 시간을 기록합니다. |
|
| 사람이 읽을 수 있는 형식으로 상태를 설명하는 메시지입니다. |
|
| 머신에서 읽을 수 있는 형식의 상태 때문입니다. |
|
| 성공은 로그 항목이 성공 또는 실패를 나타내는지 여부를 나타냅니다. |
| `` | 검사 작업의 시작 시간입니다. |
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 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
17.2.2. /APIs/controlplane.operator.openshift.io/v1alpha1/namespaces/{namespace}/podnetworkconnectivitychecks
- HTTP 방법
-
DELETE
- 설명
- PodNetworkConnectivityCheck 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- PodNetworkConnectivityCheck 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- PodNetworkConnectivityCheck 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
17.2.3. /APIs/controlplane.operator.openshift.io/v1alpha1/namespaces/{namespace}/podnetworkconnectivitychecks/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| PodNetworkConnectivityCheck의 이름 |
- HTTP 방법
-
DELETE
- 설명
- delete a PodNetworkConnectivityCheck
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 PodNetworkConnectivityCheck 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 PodNetworkConnectivityCheck를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 PodNetworkConnectivityCheck로 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
17.2.4. /APIs/controlplane.operator.openshift.io/v1alpha1/namespaces/{namespace}/podnetworkconnectivitychecks/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| PodNetworkConnectivityCheck의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 PodNetworkConnectivityCheck의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 PodNetworkConnectivityCheck의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 PodNetworkConnectivityCheck의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
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은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| RouteSpec은 경로가 노출하는 호스트 이름 또는 경로, 보안 정보 및 경로가 가리키는 1~4개의 백엔드(서비스)를 설명합니다. 요청은 각 백엔드에 할당된 가중치에 따라 백엔드 간에 배포됩니다. 라운드 로빈 스케줄링을 사용하는 경우 각 백엔드로 이동하는 요청 부분은 백엔드 가중치를 모든 백엔드 가중치의 합계로 나눈 값입니다. 백엔드에 끝점이 두 개 이상 있는 경우 백엔드에서 종료되는 요청은 엔드포인트 간에 라운드 로빈 방식으로 배포됩니다. 가중치는 기본값 100을 사용하여 0에서 256 사이입니다. weight 0으로 인해 백엔드에 대한 요청이 발생하지 않습니다. 모든 가중치가 0이면 경로에 백엔드가 없는 것으로 간주되고 표준 503 응답을 반환합니다.
|
|
| RouteStatus는 이를 인정하는 라우터를 포함하여 경로 상태에 대한 관련 정보를 제공합니다. |
18.1.1. .spec
- 설명
RouteSpec은 경로가 노출하는 호스트 이름 또는 경로, 보안 정보 및 경로가 가리키는 1~4개의 백엔드(서비스)를 설명합니다. 요청은 각 백엔드에 할당된 가중치에 따라 백엔드 간에 배포됩니다. 라운드 로빈 스케줄링을 사용하는 경우 각 백엔드로 이동하는 요청 부분은 백엔드 가중치를 모든 백엔드 가중치의 합계로 나눈 값입니다. 백엔드에 끝점이 두 개 이상 있는 경우 백엔드에서 종료되는 요청은 엔드포인트 간에 라운드 로빈 방식으로 배포됩니다. 가중치는 기본값 100을 사용하여 0에서 256 사이입니다. weight 0으로 인해 백엔드에 대한 요청이 발생하지 않습니다. 모든 가중치가 0이면 경로에 백엔드가 없는 것으로 간주되고 표준 503 응답을 반환합니다.
tls
필드는 선택 사항이며 경로에 대한 특정 인증서 또는 동작을 허용합니다. 일반적으로 라우터는 명시적 인증서 없이 경로를 종료하도록 와일드카드 도메인에 기본 인증서를 구성하지만 사용자 지정 호스트 이름은 일반적으로 통과(TLS Server-Name- Indication 필드를 통해 백엔드에 직접 트래픽 전달)를 선택하거나 인증서를 제공해야 합니다.- 유형
-
object
- 필수 항목
-
다음으로 변경
-
속성 | 유형 | 설명 |
---|---|---|
|
| alternateBackends를 사용하면 경로에 최대 3개의 추가 백엔드를 할당할 수 있습니다. 서비스 유형만 허용되며 기본적으로 서비스합니다. RouteTargetReference 오브젝트의 weight 필드를 사용하여 상대 기본 설정을 지정합니다. |
|
| RouteTargetReference는 끝점으로 확인되는 대상을 지정합니다. '서비스' 유형만 허용됩니다. 'weight' 필드를 사용하여 다른 필드보다 강조하십시오. |
|
| host는 서비스를 가리키는 별칭/DNS입니다. 선택 사항입니다. 지정하지 않으면 일반적으로 경로 이름이 자동으로 선택됩니다. DNS952 하위 도메인 규칙을 따라야 합니다. |
|
| RouteHTTPHeaders는 HTTP 헤더에 대한 정책을 정의합니다. |
|
| 라우터가 감시하는 경로를 통해 서비스에 대한 트래픽을 라우팅합니다. 선택 사항 |
|
| RoutePort는 라우터에서 서비스 끝점의 엔드포인트로 포트 매핑을 정의합니다. |
|
| 하위 도메인은 Ingress 컨트롤러의 도메인(도메인) 내에서 요청된 DNS 하위 도메인입니다. host가 설정된 경우 이 필드는 무시됩니다. 수신 컨트롤러는 제안된 이름을 무시하도록 선택할 수 있습니다. 이 경우 컨트롤러는 status.ingress 배열에서 할당된 이름을 보고하거나 경로를 허용하지 않습니다. 이 값이 설정되고 서버가 이 필드 호스트를 지원하지 않으면 자동으로 채워집니다. 그렇지 않으면 호스트는 비어 있습니다. 이 필드에는 점으로 구분된 여러 부분이 있을 수 있지만 모든 Ingress 컨트롤러가 요청을 이행할 수 있는 것은 아닙니다. 이 필드는 업데이트 경로/사용자 정의 호스트 권한이 있는 사용자를 제외하고 생성 후 변경할 수 없습니다.
예: 하위 도메인 프런트 엔드는 전체 호스트 이름 |
|
| tlsConfig는 경로를 보호하고 종료를 제공하는 데 사용되는 구성을 정의합니다. |
|
| RouteTargetReference는 끝점으로 확인되는 대상을 지정합니다. '서비스' 유형만 허용됩니다. 'weight' 필드를 사용하여 다른 필드보다 강조하십시오. |
|
| 경로에 대한 와일드카드 정책(있는 경우). 현재 'Subdomain' 또는 '없음'만 허용됩니다. |
18.1.2. .spec.alternateBackends
- 설명
- alternateBackends를 사용하면 경로에 최대 3개의 추가 백엔드를 할당할 수 있습니다. 서비스 유형만 허용되며 기본적으로 서비스합니다. RouteTargetReference 오브젝트의 weight 필드를 사용하여 상대 기본 설정을 지정합니다.
- 유형
-
array
18.1.3. .spec.alternateBackends[]
- 설명
- RouteTargetReference는 끝점으로 확인되는 대상을 지정합니다. '서비스' 유형만 허용됩니다. 'weight' 필드를 사용하여 다른 필드보다 강조하십시오.
- 유형
-
object
- 필수 항목
-
kind
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 경로가 참조하는 대상의 유형입니다. 현재 '서비스'만 허용됩니다. |
|
| 참조되는 서비스/대상의 이름(예: 서비스 이름) |
|
| weight는 다른 대상 참조 오브젝트에 대한 대상의 상대적 가중치를 지정하는 0에서 256, default 100 사이의 정수입니다. 0은 이 백엔드에 대한 요청을 비활성화합니다. |
18.1.4. .spec.httpHeaders
- 설명
- RouteHTTPHeaders는 HTTP 헤더에 대한 정책을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| RouteHTTPHeaderActions는 HTTP 요청 및 응답 헤더에 대한 작업에 대한 구성을 정의합니다. |
18.1.5. .spec.httpHeaders.actions
- 설명
- RouteHTTPHeaderActions는 HTTP 요청 및 응답 헤더에 대한 작업에 대한 구성을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
request는 수정할 HTTP 요청 헤더 목록입니다. 현재는 작업이 헤더 값 |
|
| RouteHTTPHeader는 HTTP 헤더를 설정하거나 삭제하기 위한 구성을 지정합니다. |
|
|
response는 수정할 HTTP 응답 헤더 목록입니다. 현재는 작업이 헤더 값 |
|
| 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
-
작업
-
속성 | 유형 | 설명 |
---|---|---|
|
| RouteHTTPHeaderActionUnion은 HTTP 헤더에서 수행할 작업을 지정합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| RouteSetHTTPHeader는 HTTP 헤더에 설정해야 하는 값을 지정합니다. |
|
| type은 헤더에 적용할 작업의 유형을 정의합니다. 가능한 값은 설정 또는 삭제입니다. set을 사용하면 HTTP 요청 및 응답 헤더를 설정할 수 있습니다. delete를 사용하면 HTTP 요청 및 응답 헤더를 삭제할 수 있습니다. |
18.1.9. .spec.httpHeaders.actions.request[].action.set
- 설명
- RouteSetHTTPHeader는 HTTP 헤더에 설정해야 하는 값을 지정합니다.
- 유형
-
object
- 필수 항목
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| 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
-
작업
-
속성 | 유형 | 설명 |
---|---|---|
|
| RouteHTTPHeaderActionUnion은 HTTP 헤더에서 수행할 작업을 지정합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| RouteSetHTTPHeader는 HTTP 헤더에 설정해야 하는 값을 지정합니다. |
|
| type은 헤더에 적용할 작업의 유형을 정의합니다. 가능한 값은 설정 또는 삭제입니다. set을 사용하면 HTTP 요청 및 응답 헤더를 설정할 수 있습니다. delete를 사용하면 HTTP 요청 및 응답 헤더를 삭제할 수 있습니다. |
18.1.13. .spec.httpHeaders.actions.response[].action.set
- 설명
- RouteSetHTTPHeader는 HTTP 헤더에 설정해야 하는 값을 지정합니다.
- 유형
-
object
- 필수 항목
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
| 이 경로가 가리키는 서비스에서 선택한 Pod의 대상 포트입니다. 문자열이면 대상 끝점 포트 목록에서 이름이 지정된 포트로 조회됩니다. 필수 항목 |
18.1.15. .spec.tls
- 설명
- tlsConfig는 경로를 보호하고 종료를 제공하는 데 사용되는 구성을 정의합니다.
- 유형
-
object
- 필수 항목
-
종료
-
속성 | 유형 | 설명 |
---|---|---|
|
| caCertificate는 인증 기관 인증서 콘텐츠를 제공합니다. |
|
| 인증서는 인증서 콘텐츠를 제공합니다. 이는 인증서 체인이 아닌 단일 제공 인증서여야 합니다. CA 인증서를 포함하지 마십시오. |
|
| destinationCACertificate는 최종 대상의 ca 인증서 내용을 제공합니다. 재암호화 종료를 사용하는 경우 라우터에서 보안 연결의 상태 점검을 위해 이 파일을 제공해야 합니다. 이 필드를 지정하지 않으면 라우터에서 자체 대상 CA를 제공하고 짧은 서비스 이름(service.namespace.svc)을 사용하여 호스트 이름 검증을 수행할 수 있으므로 인프라 생성 인증서가 자동으로 확인할 수 있습니다. |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| insecureEdgeTerminationPolicy는 경로에 대한 비보안 연결에 필요한 동작을 나타냅니다. 각 라우터는 노출할 포트를 자체적으로 결정할 수 있지만 일반적으로 포트 80입니다. * allow - 트래픽이 비보안 포트(edge/reencrypt terminations만 해당)의 서버로 전송됩니다(기본값). * none - 비보안 포트에는 트래픽이 허용되지 않습니다. * 리디렉션 - 클라이언트가 보안 포트로 리디렉션됩니다. |
|
| key 파일 콘텐츠 제공 |
|
| 종료는 종료 유형을 나타냅니다. * 엣지 - TLS 종료는 라우터에서 수행되며 http는 백엔드(기본값) * 패스스루와 통신하는 데 사용됩니다. TLS 종료를 제공하지 않고 라우터(기본값) * 재암호화 기능을 제공하지 않고 트래픽이 바로 대상으로 전송됩니다. 라우터 및 https는 백엔드와 통신하는 데 사용됩니다. 참고: 패스스루 종료는 httpHeader 작업과 호환되지 않음 |
18.1.16. .spec.tls.externalCertificate
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
18.1.17. .spec.to
- 설명
- RouteTargetReference는 끝점으로 확인되는 대상을 지정합니다. '서비스' 유형만 허용됩니다. 'weight' 필드를 사용하여 다른 필드보다 강조하십시오.
- 유형
-
object
- 필수 항목
-
kind
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 경로가 참조하는 대상의 유형입니다. 현재 '서비스'만 허용됩니다. |
|
| 참조되는 서비스/대상의 이름(예: 서비스 이름) |
|
| weight는 다른 대상 참조 오브젝트에 대한 대상의 상대적 가중치를 지정하는 0에서 256, default 100 사이의 정수입니다. 0은 이 백엔드에 대한 요청을 비활성화합니다. |
18.1.18. .status
- 설명
- RouteStatus는 이를 인정하는 라우터를 포함하여 경로 상태에 대한 관련 정보를 제공합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
Ingress는 경로가 노출될 수 있는 위치를 설명합니다. 수신 지점 목록에 중복된 Host 또는 RouterName 값이 포함될 수 있습니다. 경로가 |
|
| RouteIngress는 경로가 노출되는 위치에 대한 정보를 보유합니다. |
18.1.19. .status.ingress
- 설명
-
Ingress는 경로가 노출될 수 있는 위치를 설명합니다. 수신 지점 목록에 중복된 Host 또는 RouterName 값이 포함될 수 있습니다. 경로가
준비
되면 실시간으로 간주됩니다. - 유형
-
array
18.1.20. .status.ingress[]
- 설명
- RouteIngress는 경로가 노출되는 위치에 대한 정보를 보유합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 조건은 경로의 상태이며 비어 있을 수 있습니다. |
|
| RouteIngressCondition에는 특정 라우터에서 이 경로의 현재 상태에 대한 세부 정보가 포함되어 있습니다. |
|
| host는 경로가 노출되는 호스트 문자열입니다. 이 값은 필수입니다. |
|
| CanonicalHostname은 이 경로에 요청된 호스트의 CNAME으로 사용할 수 있는 라우터의 외부 호스트 이름입니다. 이 값은 선택 사항이며 모든 경우에 설정되지 않을 수 있습니다. |
|
| 이름은 라우터에서 자체적으로 식별하기 위해 선택한 이름입니다. 이 값은 필수입니다. |
|
| 와일드카드 정책은 이 경로가 노출되는 데 허용되는 와일드카드 정책입니다. |
18.1.21. .status.ingress[].conditions
- 설명
- 조건은 경로의 상태이며 비어 있을 수 있습니다.
- 유형
-
array
18.1.22. .status.ingress[].conditions[]
- 설명
- RouteIngressCondition에는 특정 라우터에서 이 경로의 현재 상태에 대한 세부 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
status
-
속성 | 유형 | 설명 |
---|---|---|
| 이 조건이 마지막으로 전환된 RFC 3339 날짜 및 시간 | |
|
| 마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환 이유는 일반적으로 사람이 읽을 수 있는 머신입니다. |
|
| Status는 조건의 상태입니다. True, False, 알 수 없음 |
|
| 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
- 설명
- 경로 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
18.2.2. /apis/route.openshift.io/v1/watch/routes
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 경로 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
18.2.3. /apis/route.openshift.io/v1/namespaces/{namespace}/routes
- HTTP 방법
-
DELETE
- 설명
- 경로 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 경로 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 경로 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
18.2.4. /apis/route.openshift.io/v1/watch/namespaces/{namespace}/routes
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 경로 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
18.2.5. /apis/route.openshift.io/v1/namespaces/{namespace}/routes/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 경로 이름 |
- HTTP 방법
-
DELETE
- 설명
- 경로 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 경로 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 경로를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 경로 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
18.2.6. /apis/route.openshift.io/v1/watch/namespaces/{namespace}/routes/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 경로 이름 |
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 Route 오브젝트의 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
18.2.7. /apis/route.openshift.io/v1/namespaces/{namespace}/routes/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 경로 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 경로의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 경로의 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 경로의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
19장. 서비스 [v1]
- 설명
- 서비스는 프록시가 수신 대기하는 로컬 포트(예: 3306)와 프록시를 통해 전송되는 요청에 응답할 포드를 결정하는 선택기로 구성된 소프트웨어 서비스(예: mysql)의 이름이 지정된 추상화입니다.
- 유형
-
object
19.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| ServiceSpec은 사용자가 서비스에서 생성하는 속성을 설명합니다. |
|
| ServiceStatus는 서비스의 현재 상태를 나타냅니다. |
19.1.1. .spec
- 설명
- ServiceSpec은 사용자가 서비스에서 생성하는 속성을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| allocateLoadBalancerNodePorts는 LoadBalancer 유형의 서비스에 NodePorts가 자동으로 할당되는지 여부를 정의합니다. 기본값은 "true"입니다. 클러스터 로드 밸런서가 NodePort를 사용하지 않는 경우 "false"로 설정할 수 있습니다. 호출자가 값을 지정하여 특정 NodePort를 요청하면 이 필드에 관계없이 해당 요청이 유지됩니다. 이 필드는 LoadBalancer 유형의 서비스에 대해서만 설정할 수 있으며 유형이 다른 유형으로 변경된 경우 지워집니다. |
|
| 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 |
|
| 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는 클러스터의 노드에서 이 서비스에 대한 트래픽도 허용할 IP 주소 목록입니다. 이러한 IP는 Kubernetes에서 관리하지 않습니다. 사용자는 이 IP가 있는 노드에 트래픽이 도달하는지 확인해야 합니다. 일반적인 예는 Kubernetes 시스템의 일부가 아닌 외부 로드 밸런서입니다. |
|
|
ExternalName은 검색 메커니즘이 이 서비스의 별칭(예: DNS CNAME 레코드)으로 반환되는 외부 참조입니다. 프록시는 포함되지 않습니다. 소문자 RFC-1123 호스트 이름(https://tools.ietf.org/html/rfc1123)이어야 하며 |
|
| externalTrafficPolicy는 노드에서 서비스의 "외부 연결" 주소(NodePorts, ExternalIP, LoadBalancer IP) 중 하나에서 수신되는 서비스 트래픽을 배포하는 방법을 설명합니다. "Local"로 설정하면 프록시는 외부 로드 밸런서가 노드 간에 서비스 트래픽의 균형을 유지하는 방식으로 서비스를 구성하므로 각 노드는 클라이언트 소스 IP를 마스커레이드하지 않고 서비스의 노드 로컬 엔드포인트에만 트래픽을 전달합니다. (트래드가 없는 노드에 실수로 전송되는 트래픽은 삭제됩니다.) 기본값인 "Cluster"는 모든 끝점에 대한 표준 라우팅 동작을 균등하게 사용합니다( 토폴로지 및 기타 기능에 의해 수정될 수 있음). 클러스터 내에서 외부 IP 또는 LoadBalancer IP로 전송되는 트래픽에는 항상 "클러스터" 의미 체계가 표시되지만, 클러스터 내에서 NodePort로 전송되는 클라이언트는 노드를 선택할 때 트래픽 정책을 고려해야 할 수 있습니다.
가능한 enum 값: - |
|
| HealthCheckNodePort는 서비스의 healthcheck nodePort를 지정합니다. 이는 type이 LoadBalancer로 설정되고 externalTrafficPolicy가 Local으로 설정된 경우에만 적용됩니다. 값이 지정되고 범위 내이며 사용되지 않는 경우 사용됩니다. 지정하지 않으면 값이 자동으로 할당됩니다. 외부 시스템(예: 로드 밸런서)은 이 포트를 사용하여 지정된 노드가 이 서비스의 끝점을 보유하고 있는지 여부를 확인할 수 있습니다. 이 필드가 필요하지 않은 서비스를 생성할 때 지정된 경우 생성이 실패합니다. 이 필드는 더 이상 필요하지 않도록 서비스를 업데이트할 때 삭제됩니다(예: 유형 변경). 이 필드는 설정된 후에는 업데이트할 수 없습니다. |
|
| internalTrafficPolicy는 노드가 ClusterIP에서 수신하는 서비스 트래픽을 배포하는 방법을 설명합니다. "Local"로 설정하면 프록시는 Pod가 Pod와 동일한 노드의 서비스 끝점과만 통신하고 로컬 끝점이 없는 경우 트래픽을 삭제한다고 가정합니다. 기본값인 "Cluster"는 모든 끝점에 대한 표준 라우팅 동작을 균등하게 사용합니다( 토폴로지 및 기타 기능에 의해 수정될 수 있음).
가능한 enum 값: - |
|
| ipFamilies는 이 서비스에 할당된 IP 제품군 목록(예: IPv4, IPv6)입니다. 이 필드는 일반적으로 클러스터 구성 및 ipFamilyPolicy 필드를 기반으로 자동으로 할당됩니다. 이 필드가 수동으로 지정되면 클러스터에서 요청된 제품군을 사용할 수 있으며 ipFamilyPolicy에서 허용하는 경우 이 필드가 사용됩니다. 그렇지 않으면 서비스 생성이 실패합니다. 이 필드는 조건적으로 변경할 수 있습니다. 보조 IP 제품군을 추가하거나 제거할 수는 있지만 서비스의 기본 IP 제품군을 변경할 수는 없습니다. 유효한 값은 "IPv4" 및 "IPv6"입니다. 이 필드는 ClusterIP, NodePort 및 LoadBalancer 유형의 서비스에만 적용되며 "headless" 서비스에 적용됩니다. 이 필드는 ExternalName 유형으로 서비스를 업데이트할 때 삭제됩니다. 이 필드는 최대 두 개의 항목(일반적으로 스택 제품군)을 두 순서로 보유할 수 있습니다. 이러한 제품군은 지정된 경우 clusterIPs 필드 값과 일치해야 합니다. clusterIPs 및 ipFamilies 둘 다 ipFamilyPolicy 필드에 의해 관리됩니다. |
|
| ipFamilyPolicy는 이 서비스에서 요청하거나 요구하는 듀얼 스택 특성을 나타냅니다. 값을 제공하지 않으면 이 필드가 SingleStack으로 설정됩니다. 서비스는 "SingleStack"(단일 IP 제품군), "PreferDualStack"(다중 스택 구성된 클러스터의 두 개의 IP 제품군 또는 단일 스택 클러스터에서 단일 IP 제품군) 또는 "RequireDualStack"(반드 스택 구성된 클러스터의 2개의 IP 제품군)일 수 있습니다. ipFamilies 및 clusterIPs 필드는 이 필드의 값에 따라 다릅니다. 이 필드는 ExternalName 유형으로 서비스를 업데이트할 때 삭제됩니다.
가능한 enum 값: - |
|
| LoadBalancerClass는 이 서비스가 속하는 로드 밸런서 구현의 클래스입니다. 지정된 경우 이 필드의 값은 선택적 접두사가 있는 레이블 스타일 식별자여야 합니다(예: "internal-vip" 또는 "example.com/internal-vip"). 호출되지 않은 이름은 최종 사용자를 위해 예약되어 있습니다. 이 필드는 서비스 유형이 'LoadBalancer'인 경우에만 설정할 수 있습니다. 설정되지 않은 경우 기본 로드 밸런서 구현이 사용되며, 현재 일반적으로 클라우드 공급자 통합을 통해 수행되지만 모든 기본 구현에 적용해야 합니다. 설정된 경우 로드 밸런서 구현에서 일치하는 클래스가 있는 서비스를 조사한다고 가정합니다. 기본 로드 밸런서 구현(예: 클라우드 공급자)은 이 필드를 설정하는 서비스를 무시해야 합니다. 이 필드는 'LoadBalancer'를 입력하도록 서비스를 생성하거나 업데이트할 때만 설정할 수 있습니다. 설정한 후에는 변경할 수 없습니다. 서비스가 'LoadBalancer'이 아닌 유형으로 업데이트되면 이 필드가 지워집니다. |
|
| 서비스 유형: LoadBalancer에만 적용됩니다. 이 기능은 로드 밸런서가 생성될 때 기본 cloud-provider가 loadBalancerIP 지정을 지원하는지 여부에 따라 달라집니다. cloud-provider가 해당 기능을 지원하지 않는 경우 이 필드는 무시됩니다. 더 이상 사용되지 않음: 이 필드는 지정되지 않았으며 이는 구현마다 다릅니다. 이를 사용하는 것은 포트를 사용할 수 없으며 듀얼 스택을 지원하지 않을 수 있습니다. 사용자는 사용 가능한 경우 구현별 주석을 사용하는 것이 좋습니다. |
|
| 플랫폼에서 지정 및 지원하는 경우 cloud-provider 로드 밸런서를 통한 트래픽이 지정된 클라이언트 IP로 제한됩니다. cloud-provider가 이 기능을 지원하지 않는 경우 이 필드는 무시됩니다." 자세한 내용은 https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/ |
|
| 이 서비스에서 노출하는 포트 목록입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies |
|
| ServicePort에는 서비스 포트에 대한 정보가 포함되어 있습니다. |
|
| 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/ |
|
| "ClientIP" 및 "없음"을 지원합니다. 세션 선호도를 유지하는 데 사용됩니다. 클라이언트 IP 기반 세션 선호도를 활성화합니다. ClientIP 또는 None이어야 합니다. 기본값은 None입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
가능한 enum 값: - |
|
| SessionAffinityConfig는 세션 선호도의 구성을 나타냅니다. |
|
| 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 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이 포트의 애플리케이션 프로토콜입니다. 이는 구현이 이해할 수 있는 프로토콜에 대해 보다 풍부한 동작을 제공하기 위한 힌트로 사용됩니다. 이 필드는 표준 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과 같은 구현 정의 접두사 이름을 사용해야 합니다. |
|
| 서비스 내의 이 포트의 이름입니다. DNS_LABEL이어야 합니다. ServiceSpec 내의 모든 포트에는 고유한 이름이 있어야 합니다. 서비스의 끝점을 고려할 때 EndpointPort의 'name' 필드와 일치해야 합니다. 이 서비스에 하나의 ServicePort만 정의된 경우 선택 사항입니다. |
|
| 유형이 NodePort 또는 LoadBalancer인 경우 이 서비스가 노출되는 각 노드의 포트입니다. 일반적으로 시스템에서 할당한 것입니다. 값이 지정되고 사용하지 않는 값은 사용됩니다. 그렇지 않으면 작업이 실패합니다. 지정하지 않으면 이 서비스에 필요한 경우 포트가 할당됩니다. 이 필드가 필요하지 않은 서비스를 생성할 때 지정된 경우 생성이 실패합니다. 이 필드는 더 이상 필요하지 않도록 서비스를 업데이트할 때 삭제됩니다(예: type을 NodePort에서 ClusterIP로 변경). 자세한 내용은 https://kubernetes.io/docs/concepts/services-networking/service/#type-nodeport |
|
| 이 서비스에서 노출할 포트입니다. |
|
| 이 포트의 IP 프로토콜입니다. "TCP", "UDP" 및 "SCTP"를 지원합니다. 기본값은 TCP입니다.
가능한 열거 값: - |
| 서비스에서 대상으로 하는 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
속성 | 유형 | 설명 |
---|---|---|
|
| ClientIPConfig는 클라이언트 IP 기반 세션 선호도의 구성을 나타냅니다. |
19.1.5. .spec.sessionAffinityConfig.clientIP
- 설명
- ClientIPConfig는 클라이언트 IP 기반 세션 선호도의 구성을 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| timeoutSeconds는 ClientIP 유형 세션 고정 시간 초를 지정합니다. ServiceAffinity == "ClientIP"인 경우 값은 >0 && Cryostat86400(일의 경우)이어야 합니다. 기본값은 10800(3시간)입니다. |
19.1.6. .status
- 설명
- ServiceStatus는 서비스의 현재 상태를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 현재 서비스 상태 | |
|
| LoadBalancerStatus는 로드 밸런서의 상태를 나타냅니다. |
19.1.7. .status.loadBalancer
- 설명
- LoadBalancerStatus는 로드 밸런서의 상태를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| Ingress는 로드 밸런서에 대한 수신 지점을 포함하는 목록입니다. 서비스를 위한 트래픽은 이러한 수신 지점으로 전송되어야 합니다. |
|
| LoadBalancerIngress는 로드 밸런서 인그레스 지점의 상태: 서비스에 대해 의도된 트래픽을 수신 지점으로 보내야 합니다. |
19.1.8. .status.loadBalancer.ingress
- 설명
- Ingress는 로드 밸런서에 대한 수신 지점을 포함하는 목록입니다. 서비스를 위한 트래픽은 이러한 수신 지점으로 전송되어야 합니다.
- 유형
-
array
19.1.9. .status.loadBalancer.ingress[]
- 설명
- LoadBalancerIngress는 로드 밸런서 인그레스 지점의 상태: 서비스에 대해 의도된 트래픽을 수신 지점으로 보내야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 호스트 이름은 DNS 기반(일반적으로 AWS 로드 밸런서)인 로드 밸런서 인그레스 지점에 대해 설정됩니다. |
|
| IP는 IP 기반(일반적으로 GCE 또는 OpenStack 로드 밸런서)인 로드 밸런서 인그레스 지점에 대해 설정됩니다. |
|
| ports는 서비스 포트의 레코드 목록입니다. 사용 중인 경우 서비스에 정의된 모든 포트에 항목이 있어야 합니다. |
|
|
19.1.10. .status.loadBalancer.ingress[].ports
- 설명
- ports는 서비스 포트의 레코드 목록입니다. 사용 중인 경우 서비스에 정의된 모든 포트에 항목이 있어야 합니다.
- 유형
-
array
19.1.11. .status.loadBalancer.ingress[].ports[]
- 설명
- 유형
-
object
- 필수 항목
-
port
-
protocol
-
속성 | 유형 | 설명 |
---|---|---|
|
| 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는 상태가 기록되는 서비스 포트의 포트 번호입니다. |
|
| protocol is the protocol of the service port of which status is recorded here The supported values are: "TCP", "UDP", "SCTP"
가능한 열거 값: - |
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 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
19.2.2. /api/v1/watch/services
- HTTP 방법
-
GET
- 설명
- 서비스 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
19.2.3. /api/v1/namespaces/{namespace}/services
- HTTP 방법
-
DELETE
- 설명
- 서비스 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- Service 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 서비스 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
19.2.4. /api/v1/watch/namespaces/{namespace}/services
- HTTP 방법
-
GET
- 설명
- 서비스 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
19.2.5. /api/v1/namespaces/{namespace}/services/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서비스 이름 |
- HTTP 방법
-
DELETE
- 설명
- 서비스 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 서비스 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 서비스를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 서비스를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
19.2.6. /api/v1/watch/namespaces/{namespace}/services/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서비스 이름 |
- HTTP 방법
-
GET
- 설명
- Service 유형의 오브젝트 변경 사항을 확인합니다. 더 이상 사용되지 않는 'watch' 매개변수를 대신 목록 작업과 함께 사용하여 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링됩니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
19.2.7. /api/v1/namespaces/{namespace}/services/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서비스 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 서비스의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 서비스의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 서비스의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
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.