11.6. placements API(v1alpha1)

PDF

11.6.1. 개요

이 문서는 Kubernetes용 다중 클러스터 엔진의 배치 리소스에 대한 것입니다. 배치 리소스에는 생성, 쿼리, 삭제 및 업데이트 등 네 가지 요청이 있습니다.

11.6.1.1. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

11.6.1.2. 태그

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

11.6.2. 경로

11.6.2.1. 모든 배치 쿼리

GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements

11.6.2.1.1. 설명

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

11.6.2.1.2. 매개 변수

유형	이름	설명	스키마
header	COOKIE 필요	권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string

11.6.2.1.3. 응답

HTTP 코드	설명	스키마
200	성공	콘텐츠 없음
403	액세스 금지	콘텐츠 없음
404	리소스를 찾을 수 없음	콘텐츠 없음
500	내부 서비스 오류	콘텐츠 없음
503	서비스를 사용할 수 없음	콘텐츠 없음

11.6.2.1.4. Use

placement/yaml

11.6.2.1.5. 태그

cluster.open-cluster-management.io

11.6.2.2. 배치 생성

POST /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements

11.6.2.2.1. 설명

배치 생성.

11.6.2.2.2. 매개 변수

유형	이름	설명	스키마
header	COOKIE 필요	권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
body	본문 필요	생성할 배치를 설명하는 매개변수입니다.	placement

11.6.2.2.3. 응답

HTTP 코드	설명	스키마
200	성공	콘텐츠 없음
403	액세스 금지	콘텐츠 없음
404	리소스를 찾을 수 없음	콘텐츠 없음
500	내부 서비스 오류	콘텐츠 없음
503	서비스를 사용할 수 없음	콘텐츠 없음

11.6.2.2.4. Use

placement/yaml

11.6.2.2.5. 태그

cluster.open-cluster-management.io

11.6.2.2.6. HTTP 요청의 예

11.6.2.2.6.1. 요청 본문

{
  "apiVersion" : "cluster.open-cluster-management.io/v1alpha1",
  "kind" : "Placement",
  "metadata" : {
    "name" : "placement1",
    "namespace": "ns1"
  },
  "spec": {
    "predicates": [
      {
        "requiredClusterSelector": {
          "labelSelector": {
            "matchLabels": {
              "vendor": "OpenShift"
            }
          }
        }
      }
    ]
  },
  "status" : { }
}

11.6.2.3. 단일 배치 쿼리

GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements/{placement_name}

11.6.2.3.1. 설명

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

11.6.2.3.2. 매개 변수

유형	이름	설명	스키마
header	COOKIE 필요	권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	placement_name required	쿼리할 배치의 이름입니다.	string

11.6.2.3.3. 응답

HTTP 코드	설명	스키마
200	성공	콘텐츠 없음
403	액세스 금지	콘텐츠 없음
404	리소스를 찾을 수 없음	콘텐츠 없음
500	내부 서비스 오류	콘텐츠 없음
503	서비스를 사용할 수 없음	콘텐츠 없음

11.6.2.3.4. 태그

cluster.open-cluster-management.io

11.6.2.4. 배치 삭제

DELETE /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements/{placement_name}

11.6.2.4.1. 설명

단일 배치 삭제.

11.6.2.4.2. 매개 변수

유형	이름	설명	스키마
header	COOKIE 필요	권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	placement_name required	삭제할 배치의 이름입니다.	string

11.6.2.4.3. 응답

HTTP 코드	설명	스키마
200	성공	콘텐츠 없음
403	액세스 금지	콘텐츠 없음
404	리소스를 찾을 수 없음	콘텐츠 없음
500	내부 서비스 오류	콘텐츠 없음
503	서비스를 사용할 수 없음	콘텐츠 없음

11.6.2.4.4. 태그

cluster.open-cluster-management.io

11.6.3. 정의

11.6.3.1. placement

이름	설명	스키마
apiVersion 필요	배치의 버전이 지정된 스키마입니다.	string
kind 필수	REST 리소스를 나타내는 문자열 값입니다.	string
메타데이터 필요	배치의 메타 데이터입니다.	object
spec 필수	배치 사양입니다.	spec

spec

이름	설명	스키마
ClusterSets 선택 사항	ManagedClusters가 선택된 ManagedClusterSets의 하위 집합입니다. 비어 있는 경우 배치 네임스페이스에 바인딩된 ManagedClusterSets에서 ManagedClusters가 선택됩니다. 그렇지 않으면 ManagedClusters가 이 하위 집합의 교집합에서 선택되고 ManagedClusterSets는 placement 네임스페이스에 바인딩됩니다.	문자열 배열
numberOfClusters optional	선택할 ManagedCluster의 수입니다.	정수(int32)
서술자 선택 사항	ManagedClusters를 선택할 클러스터 서술자의 하위 집합입니다. 조건부 논리는 OR 입니다.	clusterPredicate 배열

clusterPredicate

이름	설명	스키마
requiredClusterSelector optional	레이블 및 클러스터 클레임을 사용하여 ManagedClusters를 선택하는 클러스터 선택기입니다.	clusterSelector

clusterSelector

이름	설명	스키마
labelSelector optional	라벨별 ManagedClusters의 선택기입니다.	object
claimSelector optional	클레임별 ManagedClusters의 선택기입니다.	clusterClaimSelector

clusterClaimSelector

이름	설명	스키마
matchExpressions optional	클러스터 클레임 선택기 요구 사항의 하위 집합입니다. 조건부 논리는 AND 입니다.	< object > array