Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

1.14. placements API (v1beta1)

1.14.1. 개요
링크 복사

이 문서는 Red Hat Advanced Cluster Management for Kubernetes의 배치 리소스를 위한 것입니다. 배치 리소스에는 생성, 쿼리, 삭제, 업데이트 등 네 가지 요청이 있습니다. placement는 placement 네임스페이스에 바인딩된 ManagedClusterSets에서 ManagedClusters 세트를 선택하는 규칙을 정의합니다. cluster.open-cluster-management.io/placement={placement name} 레이블이 있는 PlacementDecisions 슬라이스가 생성되어 이 배치에서 선택한 ManagedClusters를 나타냅니다.

1.14.1.1. 버전 정보
링크 복사

버전 : 2.7.0

1.14.1.2. URI 스키마
링크 복사

BasePath : /kubernetes/apis
Schemes : HTTPS

1.14.1.3. 태그
링크 복사

  • cluster.open-cluster-management.io : 배치 생성 및 관리

1.14.2. 경로
링크 복사

1.14.2.1. 모든 배치 쿼리
링크 복사

GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placements
Copy to Clipboard Toggle word wrap
1.14.2.1.1. 설명
링크 복사

자세한 내용은 배치를 쿼리합니다.

1.14.2.1.2. 매개 변수
링크 복사
Expand
유형이름설명스키마

header

COOKIE
필요

권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.

string

1.14.2.1.3. 응답
링크 복사
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.14.2.1.4. Use
링크 복사
  • placement/yaml
1.14.2.1.5. 태그
링크 복사
  • cluster.open-cluster-management.io

1.14.2.2. 배치 생성
링크 복사

POST /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placements
Copy to Clipboard Toggle word wrap
1.14.2.2.1. 설명
링크 복사

배치 생성.

1.14.2.2.2. 매개 변수
링크 복사
Expand
유형이름설명스키마

header

COOKIE
필요

권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.

string

body

본문
필요

생성할 배치를 설명하는 매개변수입니다.

placement

1.14.2.2.3. 응답
링크 복사
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.14.2.2.4. Use
링크 복사
  • placement/yaml
1.14.2.2.5. 태그
링크 복사
  • cluster.open-cluster-management.io
1.14.2.2.6. HTTP 요청의 예
링크 복사
1.14.2.2.6.1. 요청 본문
링크 복사
{
  "apiVersion" : "cluster.open-cluster-management.io/v1beta1",
  "kind" : "Placement",
  "metadata" : {
    "name" : "placement1",
    "namespace": "ns1"
  },
  "spec": {
    "predicates": [
      {
        "requiredClusterSelector": {
          "labelSelector": {
            "matchLabels": {
              "vendor": "OpenShift"
            }
          }
        }
      }
    ]
  },
  "status" : { }
}
Copy to Clipboard Toggle word wrap

1.14.2.3. 단일 배치 쿼리
링크 복사

GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placements/{placement_name}
Copy to Clipboard Toggle word wrap
1.14.2.3.1. 설명
링크 복사

자세한 내용은 단일 배치를 쿼리합니다.

1.14.2.3.2. 매개 변수
링크 복사
Expand
유형이름설명스키마

header

COOKIE
필요

권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.

string

경로

placement_name
required

쿼리할 배치의 이름입니다.

string

1.14.2.3.3. 응답
링크 복사
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.14.2.3.4. 태그
링크 복사
  • cluster.open-cluster-management.io

1.14.2.4. 배치 삭제
링크 복사

DELETE /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placements/{placement_name}
Copy to Clipboard Toggle word wrap
1.14.2.4.1. 설명
링크 복사

단일 배치 삭제.

1.14.2.4.2. 매개 변수
링크 복사
Expand
유형이름설명스키마

header

COOKIE
필요

권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.

string

경로

placement_name
required

삭제할 배치의 이름입니다.

string

1.14.2.4.3. 응답
링크 복사
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.14.2.4.4. 태그
링크 복사
  • cluster.open-cluster-management.io

1.14.3. 정의
링크 복사

1.14.3.1. placement
링크 복사

Expand
이름설명스키마

apiVersion
required

배치 버전 스키마입니다.

string

kind
필수

REST 리소스를 나타내는 문자열 값입니다.

string

메타데이터
필요

배치 메타데이터입니다.

object

spec
required

배치 사양.

spec

spec

Expand
이름설명스키마

clusterSets
optional

ManagedClusters 가 선택된 ManagedClusterSets 의 하위 집합입니다. ManagedClusterSet 이 비어 있으면 배치 네임스페이스에 바인딩된 ManagedCluster Set에서 ManagedClusters 가 선택됩니다. ManagedClusterSet 에 ManagedClusters 가 포함된 경우 이 하위 집합의 교집합에서ManagedClusters 가 선택됩니다. 선택한 ManagedClusterSets 는 placement 네임스페이스에 바인딩됩니다.

문자열 배열

numberOfClusters
optional

선택하려는 ManagedClusters 수입니다.

정수(int32)

서술자
선택 사항

ManagedClusters 를 선택하는 클러스터 서술자의 하위 집합입니다. 조건부 논리는 OR 입니다.

clusterPredicate 배열

prioritizerPolicy
optional

우선순위에 대한 정책

prioritizerPolicy

허용 오차
선택 사항

허용하지만 필요하지 않은 값은 일치하는 톨러레이션이 있는 배치에 의해 특정 테인트가 있는 관리 클러스터를 선택할 수 있습니다.

허용 오차 배열

clusterPredicate

Expand
이름설명스키마

requiredClusterSelector
optional

레이블 및 클러스터 클레임을 사용하여 ManagedClusters 를 선택하는 클러스터 선택기입니다.

clusterSelector

clusterSelector

Expand
이름설명스키마

labelSelector
optional

라벨별 ManagedClusters 의 선택기입니다.

object

claimSelector
optional

클레임별 ManagedClusters 선택기입니다.

clusterClaimSelector

clusterClaimSelector

Expand
이름설명스키마

matchExpressions
optional

클러스터 클레임 선택기 요구 사항의 하위 집합입니다. 조건부 논리는 AND 입니다.

< object > array

prioritizerPolicy

Expand
이름설명스키마

모드
선택 사항

Exact,Additive, ""입니다. ""의 기본값은 Additive 입니다.

string

구성
선택 사항

우선순위 설정입니다.

priorityrConfig 배열

prioritizerConfig

Expand
이름설명스키마

scoreCoordinate
required

우선순위 및 점수 소스의 구성입니다.

scoreCoordinate

가중치
선택 사항

우선순위 점수의 가중치입니다. 값은 [-10,10] 범위 내에 있어야 합니다.

int32

scoreCoordinate

Expand
이름설명스키마


필수항목 입력

우선순위 점수의 유형입니다. 유효한 값은 "BuiltIn" 또는 "Addon"입니다.

string

builtIn
optional

다음 옵션 중에서 BuiltIn 우선순위 지정: 1) Balance: Balance: 클러스터 간 결정의 균형을 유지합니다. 2) 정상: 기존 결정을 안정 상태로 유지합니다. 3) ResourceAllocatableCPU 및 ResourceAllocatableMemory: 할당 가능한 리소스를 기반으로 클러스터를 정렬합니다. 4) 분산: 워크로드를 균등하게 분배합니다.

string

addOn
optional

type이 AddOn 인 경우AddOn 은 리소스 이름과 점수 이름을 정의합니다.

object

허용 오차

Expand
이름설명스키마

key
optional

톨러레이션이 적용되는 테인트 키입니다. 빈은 모든 테인트 키와 일치함을 의미합니다.

string

Operator
선택 사항

값에 대한 키의 관계입니다. 유효한 연산자는 Exists 및 Equal 입니다. 기본값은 Equal 입니다.

string

value
optional

톨러레이션과 일치하는 taint 값입니다.

string

effect
선택 사항

일치하는 테인트 효과입니다. 빈은 모든 테인트 효과와 일치함을 의미합니다. 지정하면 허용되는 값은 NoSelect,PreferNoSelect 및 NoSelectIfNew 입니다.

string

tolerationSeconds
optional

테인트가 허용되는 시간, 그 후 테인트가 허용되지 않습니다. 기본값은 nil로, 테인트가 허용되는 기간에 대한 시간 제한이 없음을 나타냅니다.

int64

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

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

Theme

© 2025 Red Hat