API

1.1. 클러스터 API

1.1.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes용 클러스터 리소스에 대한 것입니다. 클러스터 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다. ManagedCluster 는 관리 클러스터의 원하는 상태 및 현재 상태를 나타냅니다. ManagedCluster 는 클러스터 범위 리소스입니다.

1.1.1.1. 버전 정보

버전 : 2.10.0

1.1.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.1.1.3. 태그

cluster.open-cluster-management.io : 클러스터 생성 및 관리

1.1.2. 경로

1.1.2.1. 모든 클러스터 쿼리

GET /cluster.open-cluster-management.io/v1/managedclusters

1.1.2.1.1. 설명

자세한 내용은 클러스터를 쿼리합니다.

1.1.2.1.2. 매개 변수

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

1.1.2.1.3. 응답

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

1.1.2.1.4. 사용

cluster/yaml

1.1.2.1.5. 태그

cluster.open-cluster-management.io

1.1.2.2. 클러스터 생성

POST /cluster.open-cluster-management.io/v1/managedclusters

1.1.2.2.1. 설명

클러스터 생성

1.1.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
본문	본문 필요	생성할 클러스터를 설명하는 매개변수입니다.	Cluster

1.1.2.2.3. 응답

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

1.1.2.2.4. 사용

cluster/yaml

1.1.2.2.5. 태그

cluster.open-cluster-management.io

1.1.2.2.6. HTTP 요청의 예

1.1.2.2.6.1. 요청 본문

{
  "apiVersion" : "cluster.open-cluster-management.io/v1",
  "kind" : "ManagedCluster",
  "metadata" : {
    "labels" : {
      "vendor" : "OpenShift"
    },
    "name" : "cluster1"
  },
  "spec": {
    "hubAcceptsClient": true,
    "managedClusterClientConfigs": [
      {
        "caBundle": "test",
        "url": "https://test.com"
      }
    ]
  },
  "status" : { }
}

1.1.2.3. 단일 클러스터 쿼리

GET /cluster.open-cluster-management.io/v1/managedclusters/{cluster_name}

1.1.2.3.1. 설명

자세한 내용은 단일 클러스터를 쿼리합니다.

1.1.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	cluster_name required	쿼리할 클러스터의 이름입니다.	string

1.1.2.3.3. 응답

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

1.1.2.3.4. 태그

cluster.open-cluster-management.io

1.1.2.4. 클러스터 삭제

DELETE /cluster.open-cluster-management.io/v1/managedclusters/{cluster_name}

DELETE /hive.openshift.io/v1/{cluster_name}/clusterdeployments/{cluster_name}

1.1.2.4.1. 설명

단일 클러스터 삭제

1.1.2.4.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	cluster_name required	삭제할 클러스터의 이름입니다.	string

1.1.2.4.3. 응답

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

1.1.2.4.4. 태그

cluster.open-cluster-management.io

1.1.3. 정의

1.1.3.1. Cluster

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

spec

이름	설명	스키마
hubAcceptsClient required	허브가 관리 클러스터에서 klusterlet 에이전트와의 연결을 설정할 수 있는지 여부를 지정합니다. 기본값은 `false` 이며, `managedclusters/accept` 의 가상 하위 리소스를 업데이트할 수 있는 hub 클러스터에 구성된 RBAC 규칙이 있는 경우에만 `true` 로 변경할 수 있습니다.	bool
managedClusterClientConfigs optional	관리 클러스터의 apiserver 주소를 나열합니다.	managedClusterClientConfigs array
leaseDurationSeconds optional	관리 클러스터에서 klusterlet 에이전트의 리스 업데이트 시간 간격을 지정합니다. 기본적으로 klusterlet 에이전트는 60초마다 리스를 업데이트합니다.	정수(int32)
테인트 선택 사항	예약 중에 관리 클러스터가 하나 이상의 관리 클러스터 세트에 할당되지 않도록 합니다.	taint 배열

managedClusterClientConfigs

이름	설명	스키마
URL 필요		string
cabundle 선택 사항	패턴 : "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"	문자열(바이트)

이름

설명

스키마

URL
필요

string

cabundle
선택 사항

패턴 :

"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"

문자열(바이트)

taint

이름	설명	스키마
키 필요	클러스터에 적용되는 taint 키입니다.	string
값 선택 사항	taint 키에 해당하는 taint 값입니다.	string
effect 선택 사항	테인트를 허용하지 않는 배치에 테인트의 영향 유효한 값은 `NoSelect`,`PreferNoSelect` 및 `NoSelectIfNew` 입니다.	string

1.2. Clustersets API (v1beta2)

1.2.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes용 ClusterSet 리소스를 위한 것입니다. ClusterSet 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다. ManagedClusterSet은 ManagedClusters 그룹을 정의합니다. ManagedClusterSet을 참조하는 ManagedCluster의 cluster.open-cluster-management.io/clusterset 이라는 라벨을 추가하여 ManagedCluster를 특정 ManagedClusterSet에 할당할 수 있습니다. Managed clustersets/join 의 가상 하위 리소스에 대한 생성 권한을 허용하는 RBAC 규칙이 있는 경우에만 ManagedCluster에서 이 라벨을 추가하거나 제거할 수 있습니다. 이 레이블을 업데이트하려면 소스 및 대상 ManagedClusterSets 모두에 이 권한이 있어야 합니다.

1.2.1.1. 버전 정보

버전 : 2.10.0

1.2.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.2.1.3. 태그

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

1.2.2. 경로

1.2.2.1. 모든 clustersets 쿼리

GET /cluster.open-cluster-management.io/v1beta2/managedclustersets

1.2.2.1.1. 설명

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

1.2.2.1.2. 매개 변수

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

1.2.2.1.3. 응답

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

1.2.2.1.4. 사용

clusterset/yaml

1.2.2.1.5. 태그

cluster.open-cluster-management.io

1.2.2.2. clusterset 생성

POST /cluster.open-cluster-management.io/v1beta2/managedclustersets

1.2.2.2.1. 설명

클러스터 세트를 생성합니다.

1.2.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
본문	본문 필요	생성할 clusterset을 설명하는 매개변수입니다.	clusterset

1.2.2.2.3. 응답

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

1.2.2.2.4. 사용

clusterset/yaml

1.2.2.2.5. 태그

cluster.open-cluster-management.io

1.2.2.2.6. HTTP 요청의 예

1.2.2.2.6.1. 요청 본문

{
  "apiVersion": "cluster.open-cluster-management.io/v1beta2",
  "kind": "ManagedClusterSet",
  "metadata": {
    "name": "clusterset1"
  },
  "spec": {
    "clusterSelector": {
      "selectorType": "ExclusiveClusterSetLabel"
    }
  },
  "status": {}
}

1.2.2.3. 단일 클러스터 세트 쿼리

GET /cluster.open-cluster-management.io/v1beta2/managedclustersets/{clusterset_name}

1.2.2.3.1. 설명

자세한 내용은 단일 클러스터 세트를 쿼리합니다.

1.2.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	clusterset_name required	쿼리할 클러스터 세트의 이름입니다.	string

1.2.2.3.3. 응답

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

1.2.2.3.4. 태그

cluster.open-cluster-management.io

1.2.2.4. clusterset 삭제

DELETE /cluster.open-cluster-management.io/v1beta2/managedclustersets/{clusterset_name}

1.2.2.4.1. 설명

단일 클러스터 세트를 삭제합니다.

1.2.2.4.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	clusterset_name required	삭제할 클러스터 세트의 이름입니다.	string

1.2.2.4.3. 응답

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

1.2.2.4.4. 태그

cluster.open-cluster-management.io

1.2.3. 정의

1.2.3.1. clusterset

이름	스키마
apiVersion 필요	string
종류 필요	string
메타데이터 필요	object

1.3. Clustersetbindings API (v1beta2)

1.3.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes용 ClusterSetBinding 리소스를 위한 것입니다. ClusterSetBinding 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다. ManagedClusterSetBinding은 ManagedClusterSet을 특정 네임스페이스로 제한합니다. Managed clustersets/bind 의 가상 하위 리소스에서 생성할 수 있는 RBAC 규칙이 있는 경우 네임스페이스에 ManagedClusterSetBinding을 생성하고 ManagedClusterSet에 바인딩할 수 있습니다.

1.3.1.1. 버전 정보

버전 : 2.10.0

1.3.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.3.1.3. 태그

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

1.3.2. 경로

1.3.2.1. 모든 clustersetbindings 쿼리

GET /cluster.open-cluster-management.io/v1beta2/namespaces/{namespace}/managedclustersetbindings

1.3.2.1.1. 설명

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

1.3.2.1.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.3.2.1.3. 응답

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

1.3.2.1.4. 사용

clustersetbinding/yaml

1.3.2.1.5. 태그

cluster.open-cluster-management.io

1.3.2.2. clustersetbinding 생성

POST /cluster.open-cluster-management.io/v1beta2/namespaces/{namespace}/managedclustersetbindings

1.3.2.2.1. 설명

clustersetbinding을 생성합니다.

1.3.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: `기본 )입니다`.	string
본문	본문 필요	생성할 clustersetbinding을 설명하는 매개변수입니다.	Clustersetbinding

1.3.2.2.3. 응답

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

1.3.2.2.4. 사용

clustersetbinding/yaml

1.3.2.2.5. 태그

cluster.open-cluster-management.io

1.3.2.2.6. HTTP 요청의 예

1.3.2.2.6.1. 요청 본문

{
  "apiVersion" : "cluster.open-cluster-management.io/v1beta2",
  "kind" : "ManagedClusterSetBinding",
  "metadata" : {
    "name" : "clusterset1",
    "namespace" : "ns1"
  },
 "spec": {
    "clusterSet": "clusterset1"
  },
  "status" : { }
}

1.3.2.3. 단일 clustersetbinding 쿼리

GET /cluster.open-cluster-management.io/v1beta2/namespaces/{namespace}/managedclustersetbindings/{clustersetbinding_name}

1.3.2.3.1. 설명

자세한 내용은 단일 clustersetbinding을 쿼리합니다.

1.3.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: `기본 )입니다`.	string
경로	clustersetbinding_name required	쿼리할 clustersetbinding의 이름입니다.	string

1.3.2.3.3. 응답

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

1.3.2.3.4. 태그

cluster.open-cluster-management.io

1.3.2.4. clustersetbinding 삭제

DELETE /cluster.open-cluster-management.io/v1beta2/managedclustersetbindings/{clustersetbinding_name}

1.3.2.4.1. 설명

단일 clustersetbinding을 삭제합니다.

1.3.2.4.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: `기본 )입니다`.	string
경로	clustersetbinding_name required	삭제할 clustersetbinding의 이름입니다.	string

1.3.2.4.3. 응답

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

1.3.2.4.4. 태그

cluster.open-cluster-management.io

1.3.3. 정의

1.3.3.1. Clustersetbinding

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

spec

이름	설명	스키마
clusterSet 필요	바인딩할 `ManagedClusterSet` 의 이름입니다. `ManagedClusterSetBinding` 의 인스턴스 이름과 일치해야 하며 생성된 후에는 변경할 수 없습니다.	string

1.4. Clusterview API(v1alpha1)

1.4.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes의 clusterview 리소스에 대한 것입니다. clusterview 리소스는 액세스할 수 있는 관리 클러스터 및 관리 클러스터 세트 목록을 볼 수 있는 CLI 명령을 제공합니다. 가능한 세 가지 요청은 list, get, watch입니다.

1.4.1.1. 버전 정보

버전 : 2.10.0

1.4.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.4.1.3. 태그

clusterview.open-cluster-management.io : ID가 액세스할 수 있는 관리 클러스터 목록을 확인합니다.

1.4.2. 경로

1.4.2.1. 관리 클러스터 가져오기

GET /managedclusters.clusterview.open-cluster-management.io

1.4.2.1.1. 설명

액세스할 수 있는 관리 클러스터 목록을 확인합니다.

1.4.2.1.2. 매개 변수

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

1.4.2.1.3. 응답

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

1.4.2.1.4. 사용

managedcluster/yaml

1.4.2.1.5. 태그

clusterview.open-cluster-management.io

1.4.2.2. 관리 클러스터 나열

LIST /managedclusters.clusterview.open-cluster-management.io

1.4.2.2.1. 설명

액세스할 수 있는 관리 클러스터 목록을 확인합니다.

1.4.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
본문	본문 선택 사항	관리 클러스터를 나열할 사용자 ID의 이름입니다.	string

1.4.2.2.3. 응답

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

1.4.2.2.4. 사용

managedcluster/yaml

1.4.2.2.5. 태그

clusterview.open-cluster-management.io

1.4.2.2.6. HTTP 요청의 예

1.4.2.2.6.1. 요청 본문

{
  "apiVersion" : "clusterview.open-cluster-management.io/v1alpha1",
  "kind" : "ClusterView",
  "metadata" : {
    "name" : "<user_ID>"
  },
  "spec": { },
  "status" : { }
}

1.4.2.3. 관리 클러스터 세트 모니터링

WATCH /managedclusters.clusterview.open-cluster-management.io

1.4.2.3.1. 설명

액세스할 수 있는 관리형 클러스터를 확인합니다.

1.4.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	clusterview_name optional	조사할 사용자 ID의 이름입니다.	string

1.4.2.3.3. 응답

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

1.4.2.4. 관리되는 클러스터 세트를 나열합니다.

GET /managedclustersets.clusterview.open-cluster-management.io

1.4.2.4.1. 설명

액세스할 수 있는 관리 클러스터를 나열합니다.

1.4.2.4.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	clusterview_name optional	조사할 사용자 ID의 이름입니다.	string

1.4.2.4.3. 응답

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

1.4.2.5. 관리되는 클러스터 세트를 나열합니다.

LIST /managedclustersets.clusterview.open-cluster-management.io

1.4.2.5.1. 설명

액세스할 수 있는 관리 클러스터를 나열합니다.

1.4.2.5.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	clusterview_name optional	조사할 사용자 ID의 이름입니다.	string

1.4.2.5.3. 응답

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

1.4.2.6. 관리되는 클러스터 세트를 확인합니다.

WATCH /managedclustersets.clusterview.open-cluster-management.io

1.4.2.6.1. 설명

액세스할 수 있는 관리형 클러스터를 확인합니다.

1.4.2.6.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	clusterview_name optional	조사할 사용자 ID의 이름입니다.	string

1.4.2.6.3. 응답

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

1.5. 채널 API

1.5.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes용 채널 리소스에 대한 것입니다. 채널 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다.

1.5.1.1. 버전 정보

버전 : 2.10.0

1.5.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.5.1.3. 태그

channels.apps.open-cluster-management.io : deployables 생성 및 관리

1.5.2. 경로

1.5.2.1. 채널 생성

POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels

1.5.2.1.1. 설명

채널을 생성합니다.

1.5.2.1.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string
본문	본문 필요	생성할 배포를 설명하는 매개변수입니다.	채널

1.5.2.1.3. 응답

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

1.5.2.1.4. 사용

application/yaml

1.5.2.1.5. 태그

channels.apps.open-cluster-management.io

1.5.2.1.6. HTTP 요청의 예

1.5.2.1.6.1. 요청 본문

{
  "apiVersion": "apps.open-cluster-management.io/v1",
  "kind": "Channel",
  "metadata": {
    "name": "sample-channel",
    "namespace": "default"
  },
  "spec": {
    "configMapRef": {
      "kind": "configmap",
      "name": "info-resource-filter-configmap"
    },
    "pathname": "https://charts.helm.sh/stable",
    "type": "HelmRepo"
  }
}

1.5.2.2. 대상 네임스페이스의 모든 채널 쿼리

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels

1.5.2.2.1. 설명

자세한 내용은 채널을 쿼리합니다.

1.5.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.5.2.2.3. 응답

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

1.5.2.2.4. 사용

application/yaml

1.5.2.2.5. 태그

channels.apps.open-cluster-management.io

1.5.2.3. 네임스페이스의 단일 채널 쿼리

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels/{channel_name}

1.5.2.3.1. 설명

자세한 내용은 단일 채널을 쿼리합니다.

1.5.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	channel_name 필요	쿼리할 배포 가능의 이름입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.5.2.3.3. 응답

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

1.5.2.3.4. 태그

channels.apps.open-cluster-management.io

1.5.2.4. 채널 삭제

DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels/{channel_name}

1.5.2.4.1. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	channel_name 필요	삭제할 채널의 이름입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.5.2.4.2. 응답

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

1.5.2.4.3. 태그

channels.apps.open-cluster-management.io

1.5.3. 정의

1.5.3.1. 채널

이름	스키마
apiVersion 필요	string
종류 필요	string
메타데이터 필요	object
사양 필요	spec

spec

이름	설명	스키마
configMapRef optional	ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.	configMapRef
선택 사항	ChannelGate는 채널 승격 기준을 정의합니다.	Gates
경로 이름 필요		string
secretRef optional	ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.	secretRef
sourceNamespaces optional		enum (Namespace, HelmRepo, ObjectBucket, Git, namespace, helmrepo, objectbucket, github) 배열

configMapRef

이름	설명	스키마
apiVersion 선택 사항	참조의 API 버전입니다.	string
fieldPath optional	전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다.	string
종류 선택 사항	일종의 추천입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/kubernetes-objects/	이름 선택 사항
추천자의 이름입니다. 자세한 정보: 이름	string	네임스페이스 선택 사항
참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/	string	resourceVersion 선택 사항
이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency	string	UID 선택 사항

Gates

이름	설명	스키마
주석 선택 사항	k8s의 일반적인 주석	annotations
labelSelector 선택 사항	레이블 선택기는 리소스 집합에 대한 레이블 쿼리입니다. matchLabels 및 matchExpressions의 결과는 ANDed입니다. 빈 라벨 선택기는 모든 오브젝트와 일치합니다. null 라벨 선택기는 오브젝트와 일치하지 않습니다.	labelSelector
이름 선택 사항		string

annotations

이름	스키마
키 선택 사항	string
값 선택 사항	string

labelSelector

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

matchExpressions

이름	설명	스키마
키 필요	key는 선택기가 적용되는 라벨 키입니다.	string
Operator 필요	Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.	string
값선택 사항	값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.	문자열 배열

secretRef

이름	설명	스키마
apiVersion 선택 사항	참조의 API 버전입니다.	string
fieldPath optional	전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다.	string
종류 선택 사항	일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds	string
이름 선택 사항	추천자의 이름입니다. 자세한 정보: 이름	string
네임스페이스 선택 사항	참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/	string
resourceVersion 선택 사항	이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency	string
UID 선택 사항	참조의 UID입니다. 자세한 정보: UIID	string

1.6. 서브스크립션 API

1.6.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes 서브스크립션 리소스에 대한 것입니다. 서브스크립션 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다. 더 이상 사용되지 않음: PlacementRule

1.6.1.1. 버전 정보

버전 : 2.10.0

1.6.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.6.1.3. 태그

subscriptions.apps.open-cluster-management.io : 서브스크립션 생성 및 관리

1.6.2. 경로

1.6.2.1. 서브스크립션 생성

POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions

1.6.2.1.1. 설명

서브스크립션을 생성합니다.

1.6.2.1.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string
본문	본문 필요	생성할 서브스크립션을 설명하는 매개변수입니다.	서브스크립션

1.6.2.1.3. 응답

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

1.6.2.1.4. 사용

subscription/yaml

1.6.2.1.5. 태그

subscriptions.apps.open-cluster-management.io

1.6.2.1.6. HTTP 요청의 예

1.6.2.1.6.1. 요청 본문

{
  "apiVersion" : "apps.open-cluster-management.io/v1",
  "kind" : "Subscription",
  "metadata" : {
    "name" : "sample_subscription",
    "namespace" : "default",
    "labels" : {
      "app" : "sample_subscription-app"
    },
    "annotations" : {
      "apps.open-cluster-management.io/git-path" : "apps/sample/",
      "apps.open-cluster-management.io/git-branch" : "sample_branch"
    }
  },
  "spec" : {
    "channel" : "channel_namespace/sample_channel",
    "packageOverrides" : [ {
      "packageName" : "my-sample-application",
      "packageAlias" : "the-sample-app",
      "packageOverrides" : [ {
        "path" : "spec",
        "value" : {
          "persistence" : {
            "enabled" : false,
            "useDynamicProvisioning" : false
          },
          "license" : "accept",
          "tls" : {
            "hostname" : "my-mcm-cluster.icp"
          },
          "sso" : {
            "registrationImage" : {
              "pullSecret" : "hub-repo-docker-secret"
            }
          }
        }
      } ]
    } ],
    "placement" : {
      "placementRef" : {
        "kind" : "PlacementRule",
        "name" : "demo-clusters"
      }
    }
  }
}

1.6.2.2. 모든 서브스크립션 쿼리

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions

1.6.2.2.1. 설명

자세한 내용은 서브스크립션을 쿼리합니다.

1.6.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.6.2.2.3. 응답

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

1.6.2.2.4. 사용

subscription/yaml

1.6.2.2.5. 태그

subscriptions.apps.open-cluster-management.io

1.6.2.3. 단일 서브스크립션 쿼리

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions/{subscription_name}

1.6.2.3.1. 설명

자세한 내용은 단일 서브스크립션을 쿼리합니다.

1.6.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string
경로	subscription_name required	쿼리할 서브스크립션의 이름입니다.	string

1.6.2.3.3. 응답

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

1.6.2.3.4. 태그

subscriptions.apps.open-cluster-management.io

1.6.2.4. 서브스크립션 삭제

DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions/{subscription_name}

1.6.2.4.1. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string
경로	subscription_name required	삭제할 서브스크립션의 이름입니다.	string

1.6.2.4.2. 응답

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

1.6.2.4.3. 태그

subscriptions.apps.open-cluster-management.io

1.6.3. 정의

1.6.3.1. 서브스크립션

이름	스키마
apiVersion 필요	string
종류 필요	string
메타데이터 필요	메타데이터
사양 필요	spec
상태 선택 사항	status

메타데이터

이름	스키마
주석 선택 사항	object
레이블 선택 사항	object
이름 선택 사항	string
네임스페이스 선택 사항	string

spec

이름	스키마
채널 필요	string
이름 선택 사항	string
선택 사항 덮어쓰기	배열 덮어쓰기
packageFilter 선택 사항	packageFilter
packageOverrides optional	packageOverrides array
배치 선택 사항	배치
Timewindow 선택 사항	Timewindow

덮어쓰기

이름	스키마
클러스터 이름 필요	string
clusterOverrides 필수	오브젝트 배열

packageFilter

이름	설명	스키마
주석 선택 사항		문자열, 문자열 맵
filterRef optional		filterRef
labelSelector 선택 사항		labelSelector
버전 선택 사항	패턴 : `"(()(\\.[0-9])(\\.)\|(\\.[0-9])?(\.[xX])$"`	string

filterRef

이름	스키마
이름 선택 사항	string

labelSelector

이름	스키마
matchExpressions optional	matchExpressions 배열
matchLabels optional	문자열, 문자열 맵

matchExpressions

이름	스키마
키 필요	string
Operator 필요	string
값선택 사항	문자열 배열

packageOverrides

이름	스키마
packageAlias optional	string
PACKAGENAME 필요	string
packageOverrides optional	오브젝트 배열

배치

이름	스키마
clusterSelector 선택 사항	clusterSelector
클러스터 선택 사항	클러스터 배열
로컬 선택 사항	boolean
placementRef 선택 사항	placementRef

clusterSelector

이름	스키마
matchExpressions optional	matchExpressions 배열
matchLabels optional	문자열, 문자열 맵

matchExpressions

이름	스키마
키 필요	string
Operator 필요	string
값선택 사항	문자열 배열

클러스터

이름	스키마
이름 필요	string

placementRef

이름	스키마
apiVersion 선택 사항	string
fieldPath optional	string
종류 선택 사항	string
이름 선택 사항	string
네임스페이스 선택 사항	string
resourceVersion 선택 사항	string
UID 선택 사항	string

Timewindow

이름	스키마
daysof week 선택 사항	문자열 배열
시간 선택 사항	시간 배열
위치 선택 사항	string
windowtype optional	enum (active, blocked, Active, Blocked)

몇 시간

이름	스키마
종료옵션	string
선택 사항 시작	string

status

이름	스키마
lastUpdateTime optional	문자열 (date-time)
메시지 선택 사항	string
단계(선택 사항)	string
이유 선택 사항	string
상태 선택 사항	object

1.7. PlacementRules API (더 이상 사용되지 않음)

1.7.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes용 PlacementRule 리소스를 위한 것입니다. PlacementRule 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다.

1.7.1.1. 버전 정보

버전 : 2.10.0

1.7.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.7.1.3. 태그

placementrules.apps.open-cluster-management.io : 배치 규칙 생성 및 관리

1.7.2. 경로

1.7.2.1. 배치 규칙 생성

POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules

1.7.2.1.1. 설명

배치 규칙을 생성합니다.

1.7.2.1.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string
본문	본문 필요	생성할 배치 규칙을 설명하는 매개변수입니다.	PlacementRule

1.7.2.1.3. 응답

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

1.7.2.1.4. 사용

application/yaml

1.7.2.1.5. 태그

placementrules.apps.open-cluster-management.io

1.7.2.1.6. HTTP 요청의 예

1.7.2.1.6.1. 요청 본문

{
  "apiVersion" : "apps.open-cluster-management.io/v1",
  "kind" : "PlacementRule",
  "metadata" : {
    "name" : "towhichcluster",
    "namespace" : "ns-sub-1"
  },
  "spec" : {
    "clusterConditions" : [ {
      "type": "ManagedClusterConditionAvailable",
      "status": "True"
    } ],
    "clusterSelector" : { }
  }
}

1.7.2.2. 모든 배치 규칙 쿼리

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules

1.7.2.2.1. 설명

자세한 내용은 배치 규칙을 쿼리합니다.

1.7.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.7.2.2.3. 응답

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

1.7.2.2.4. 사용

application/yaml

1.7.2.2.5. 태그

placementrules.apps.open-cluster-management.io

1.7.2.3. 단일 placementrule 쿼리

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules/{placementrule_name}

1.7.2.3.1. 설명

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

1.7.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string
경로	placementrule_name 필요	쿼리할 placementrule의 이름입니다.	string

1.7.2.3.3. 응답

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

1.7.2.3.4. 태그

placementrules.apps.open-cluster-management.io

1.7.2.4. placementrule 삭제

DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules/{placementrule_name}

1.7.2.4.1. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string
경로	placementrule_name 필요	삭제할 placementrule의 이름입니다.	string

1.7.2.4.2. 응답

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

1.7.2.4.3. 태그

placementrules.apps.open-cluster-management.io

1.7.3. 정의

1.7.3.1. Placementrule

이름	스키마
apiVersion 필요	string
종류 필요	string
메타데이터 필요	object
사양 필요	spec

spec

이름	스키마
clusterConditions optional	clusterConditions 어레이
clusterReplicas optional	integer
clusterSelector 선택 사항	clusterSelector
클러스터 선택 사항	클러스터 배열
정책 선택 사항	정책 배열
resourceHint optional	resourceHint
schedulerName optional	string

clusterConditions

이름	스키마
상태 선택 사항	string
유형 선택 사항	string

clusterSelector

이름	스키마
matchExpressions optional	matchExpressions 배열
matchLabels optional	문자열, 문자열 맵

matchExpressions

이름	스키마
키 선택 사항	string
Operator 선택 사항	string
값선택 사항	문자열 배열

클러스터

이름	스키마
이름 선택 사항	string

Policies

이름	스키마
apiVersion 선택 사항	string
fieldPath optional	string
종류 선택 사항	string
이름 선택 사항	string
네임스페이스 선택 사항	string
resourceVersion 선택 사항	string
UID 선택 사항	string

resourceHint

이름	스키마
주문 선택 사항	string
유형 선택 사항	string

1.8. 애플리케이션 API

1.8.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes용 애플리케이션 리소스에 대한 것입니다. 애플리케이션 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다.

1.8.1.1. 버전 정보

버전 : 2.10.0

1.8.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.8.1.3. 태그

applications.app.k8s.io : 애플리케이션 생성 및 관리

1.8.2. 경로

1.8.2.1. 애플리케이션 생성

POST /app.k8s.io/v1beta1/namespaces/{namespace}/applications

1.8.2.1.1. 설명

애플리케이션을 생성합니다.

1.8.2.1.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string
본문	본문 필요	생성할 애플리케이션을 설명하는 매개변수입니다.	애플리케이션

1.8.2.1.3. 응답

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

1.8.2.1.4. 사용

application/yaml

1.8.2.1.5. 태그

applications.app.k8s.io

1.8.2.1.6. HTTP 요청의 예

1.8.2.1.6.1. 요청 본문

{
  "apiVersion" : "app.k8s.io/v1beta1",
  "kind" : "Application",
  "metadata" : {
    "labels" : {
      "app" : "nginx-app-details"
    },
    "name" : "nginx-app-3",
    "namespace" : "ns-sub-1"
  },
  "spec" : {
    "componentKinds" : [ {
      "group" : "apps.open-cluster-management.io",
      "kind" : "Subscription"
    } ]
  },
  "selector" : {
    "matchLabels" : {
      "app" : "nginx-app-details"
    }
  },
  "status" : { }
}

1.8.2.2. 모든 애플리케이션 쿼리

GET /app.k8s.io/v1beta1/namespaces/{namespace}/applications

1.8.2.2.1. 설명

자세한 내용은 애플리케이션을 쿼리합니다.

1.8.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.8.2.2.3. 응답

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

1.8.2.2.4. 사용

application/yaml

1.8.2.2.5. 태그

applications.app.k8s.io

1.8.2.3. 단일 애플리케이션 쿼리

GET /app.k8s.io/v1beta1/namespaces/{namespace}/applications/{application_name}

1.8.2.3.1. 설명

자세한 내용은 단일 애플리케이션을 쿼리합니다.

1.8.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	application_name required	쿼리할 애플리케이션의 이름입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.8.2.3.3. 응답

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

1.8.2.3.4. 태그

applications.app.k8s.io

1.8.2.4. 애플리케이션 삭제

DELETE /app.k8s.io/v1beta1/namespaces/{namespace}/applications/{application_name}

1.8.2.4.1. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	application_name required	삭제할 애플리케이션의 이름입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.8.2.4.2. 응답

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

1.8.2.4.3. 태그

applications.app.k8s.io

1.8.3. 정의

1.8.3.1. 애플리케이션

이름	스키마
apiVersion 필요	string
종류 필요	string
메타데이터 필요	object
사양 필요	spec

spec

이름	스키마
assemblyPhase optional	string
구성 요소 종류 선택 사항	오브젝트 배열
설명자 선택 사항	설명자
정보 선택 사항	정보 배열
선택기 선택 사항	object

설명자

이름	스키마
설명 선택 사항	string
아이콘 선택 사항	아이콘 배열
키워드 선택 사항	문자열 배열
링크 선택 사항	링크 배열
유지 관리자 선택 사항	유지 관리자 배열
참고 선택 사항	string
소유자 선택 사항	소유자 배열
유형 선택 사항	string
버전 선택 사항	string

아이콘

이름	스키마
크기 선택 사항	string
src 필수	string
유형 선택 사항	string

링크

이름	스키마
설명 선택 사항	string
URL 선택 사항	string

유지 관리자

이름	스키마
이메일 선택	string
이름 선택 사항	string
URL 선택 사항	string

소유자

이름	스키마
이메일 선택	string
이름 선택 사항	string
URL 선택 사항	string

info

이름	스키마
이름 선택 사항	string
유형 선택 사항	string
값 선택 사항	string
valueFrom optional	valueFrom

valueFrom

이름	스키마
configMapKeyRef optional	configMapKeyRef
ingressRef 선택 사항	ingressRef
secretKeyRef optional	secretKeyRef
serviceRef optional	serviceRef
유형 선택 사항	string

configMapKeyRef

이름	스키마
apiVersion 선택 사항	string
fieldPath optional	string
키 선택 사항	string
종류 선택 사항	string
이름 선택 사항	string
네임스페이스 선택 사항	string
resourceVersion 선택 사항	string
UID 선택 사항	string

ingressRef

이름	스키마
apiVersion 선택 사항	string
fieldPath optional	string
호스트 선택 사항	string
종류 선택 사항	string
이름 선택 사항	string
네임스페이스 선택 사항	string
경로 선택 사항	string
resourceVersion 선택 사항	string
UID 선택 사항	string

secretKeyRef

이름	스키마
apiVersion 선택 사항	string
fieldPath optional	string
키 선택 사항	string
종류 선택 사항	string
이름 선택 사항	string
네임스페이스 선택 사항	string
resourceVersion 선택 사항	string
UID 선택 사항	string

serviceRef

이름	스키마
apiVersion 선택 사항	string
fieldPath optional	string
종류 선택 사항	string
이름 선택 사항	string
네임스페이스 선택 사항	string
경로 선택 사항	string
포트 선택 사항	정수(int32)
resourceVersion 선택 사항	string
UID 선택 사항	string

1.9. Helm API

1.9.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes의 HelmRelease 리소스에 대한 것입니다. HelmRelease 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다.

1.9.1.1. 버전 정보

버전 : 2.10.0

1.9.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.9.1.3. 태그

helmreleases.apps.open-cluster-management.io : helmreleases 생성 및 관리

1.9.2. 경로

1.9.2.1. helmrelease 생성

POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases

1.9.2.1.1. 설명

helmrelease를 생성합니다.

1.9.2.1.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string
본문	본문 필요	생성할 helmrelease를 설명하는 매개변수입니다.	HelmRelease

1.9.2.1.3. 응답

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

1.9.2.1.4. 사용

application/yaml

1.9.2.1.5. 태그

helmreleases.apps.open-cluster-management.io

1.9.2.1.6. HTTP 요청의 예

1.9.2.1.6.1. 요청 본문

{
  "apiVersion" : "apps.open-cluster-management.io/v1",
  "kind" : "HelmRelease",
  "metadata" : {
    "name" : "nginx-ingress",
    "namespace" : "default"
  },
  "repo" : {
    "chartName" : "nginx-ingress",
    "source" : {
      "helmRepo" : {
        "urls" : [ "https://kubernetes-charts.storage.googleapis.com/nginx-ingress-1.26.0.tgz" ]
      },
      "type" : "helmrepo"
    },
    "version" : "1.26.0"
  },
  "spec" : {
    "defaultBackend" : {
      "replicaCount" : 3
    }
  }
}

1.9.2.2. 모든 helmrelease 쿼리

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases

1.9.2.2.1. 설명

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

1.9.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.9.2.2.3. 응답

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

1.9.2.2.4. 사용

application/yaml

1.9.2.2.5. 태그

helmreleases.apps.open-cluster-management.io

1.9.2.3. 단일 helmrelease 쿼리

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases/{helmrelease_name}

1.9.2.3.1. 설명

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

1.9.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	helmrelease_name 필요	쿼리하려는 helmrelease의 이름입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.9.2.3.3. 응답

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

1.9.2.3.4. 태그

helmreleases.apps.open-cluster-management.io

1.9.2.4. helmrelease 삭제

DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases/{helmrelease_name}

1.9.2.4.1. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	helmrelease_name 필요	삭제할 helmrelease의 이름입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.9.2.4.2. 응답

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

1.9.2.4.3. 태그

helmreleases.apps.open-cluster-management.io

1.9.3. 정의

1.9.3.1. HelmRelease

이름	스키마
apiVersion 필요	string
종류 필요	string
메타데이터 필요	object
리포지토리 필요	repo
사양 필요	object
상태 필요	status

repo

이름	스키마
chartName optional	string
configMapRef optional	configMapRef
secretRef optional	secretRef
소스 선택 사항	소스
버전 선택 사항	string

configMapRef

이름	스키마
apiVersion 선택 사항	string
fieldPath optional	string
종류 선택 사항	string
이름 선택 사항	string
네임스페이스 선택 사항	string
resourceVersion 선택 사항	string
UID 선택 사항	string

secretRef

이름	스키마
apiVersion 선택 사항	string
fieldPath optional	string
종류 선택 사항	string
이름 선택 사항	string
네임스페이스 선택 사항	string
resourceVersion 선택 사항	string
UID 선택 사항	string

소스

이름	스키마
GitHub 선택 사항	github
helmRepo 선택 사항	helmRepo
유형 선택 사항	string

github

이름	스키마
분기 선택 사항	string
chartPath optional	string
URL 선택 사항	문자열 배열

helmRepo

이름	스키마
URL 선택 사항	문자열 배열

status

이름	스키마
필수 조건	conditions 배열
deployedRelease optional	deployedRelease

conditions

이름	스키마
lastTransitionTime optional	문자열 (date-time)
메시지 선택 사항	string
이유 선택 사항	string
상태 필요	string
유형 필수	string

deployedRelease

이름	스키마
매니페스트 선택 사항	string
이름 선택 사항	string

1.10. 정책 API

1.10.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes의 정책 리소스에 대한 것입니다. Policy 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다.

1.10.1.1. 버전 정보

버전 : 2.10.0

1.10.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.10.1.3. 태그

policy.open-cluster-management.io/v1 : 정책 생성 및 관리

1.10.2. 경로

1.10.2.1. 정책 생성

POST /policy.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}

1.10.2.1.1. 설명

정책을 생성합니다.

1.10.2.1.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string
본문	본문 필요	생성할 정책을 설명하는 매개변수입니다.	정책

1.10.2.1.3. 응답

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

1.10.2.1.4. 사용

application/json

1.10.2.1.5. 태그

policy.open-cluster-management.io

1.10.2.1.6. HTTP 요청의 예

1.10.2.1.6.1. 요청 본문

{
  "apiVersion": "policy.open-cluster-management.io/v1",
  "kind": "Policy",
  "metadata": {
    "name": "test-policy-swagger",
    "description": "Example body for Policy API Swagger docs"
  },
  "spec": {
    "remediationAction": "enforce",
    "namespaces": {
      "include": [
        "default"
      ],
      "exclude": [
        "kube*"
      ]
    },
    "policy-templates": {
    "kind": "ConfigurationPolicy",
    "apiVersion": "policy.open-cluster-management.io/v1",
    "complianceType": "musthave",
    "metadataComplianceType": "musthave",
    "metadata": {
      "namespace": null,
      "name": "test-role"
    },
    "selector": {
      "matchLabels": {
        "cloud": "IBM"
      }
    },
    "spec" : {
      "object-templates": {
        "complianceType": "musthave",
        "metadataComplianceType": "musthave",
        "objectDefinition": {
          "apiVersion": "rbac.authorization.k8s.io/v1",
          "kind": "Role",
          "metadata": {
            "name": "role-policy",
          },
          "rules": [
            {
              "apiGroups": [
                "extensions",
                "apps"
              ],
              "resources": [
                "deployments"
              ],
              "verbs": [
                "get",
                "list",
                "watch",
                "delete"
              ]
            },
            {
              "apiGroups": [
                "core"
              ],
              "resources": [
                "pods"
              ],
              "verbs": [
                "create",
                "update",
                "patch"
              ]
            },
            {
              "apiGroups": [
                "core"
              ],
              "resources": [
                "secrets"
              ],
              "verbs": [
                "get",
                "watch",
                "list",
                "create",
                "delete",
                "update",
                "patch"
              ],
            },
          ],
        },
      },
    },
  },

1.10.2.2. 모든 정책 쿼리

GET /policy.open-cluster-management.io/v1/namespaces/{namespace}/policies/{policy_name}

1.10.2.2.1. 설명

자세한 내용은 정책을 쿼리합니다.

1.10.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	정책을 적용할 네임스페이스(예: default)입니다.	string

1.10.2.2.3. 응답

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

1.10.2.2.4. 사용

application/json

1.10.2.2.5. 태그

policy.open-cluster-management.io

1.10.2.3. 단일 정책 쿼리

GET /policy.open-cluster-management.io/v1/namespaces/{namespace}/policies/{policy_name}

1.10.2.3.1. 설명

자세한 내용은 단일 정책을 쿼리합니다.

1.10.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	policy_name required	쿼리할 정책의 이름입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.10.2.3.3. 응답

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

1.10.2.3.4. 태그

policy.open-cluster-management.io

1.10.2.4. 정책 삭제

DELETE /policy.open-cluster-management.io/v1/namespaces/{namespace}/policies/{policy_name}

1.10.2.4.1. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	policy_name required	삭제할 정책의 이름입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.10.2.4.2. 응답

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

1.10.2.4.3. 태그

policy.open-cluster-management.io

1.10.3. 정의

1.10.3.1. 정책

이름	설명	스키마
apiVersion 필요	버전이 지정된 정책 스키마입니다.	string
종류 필요	REST 리소스를 나타내는 문자열 값입니다.	string
메타데이터 필요	정책을 정의하는 규칙을 설명합니다.	object

spec

이름	설명	스키마
remediationAction optional	리소스에서 정의된 대로 위반을 처리하는 방법을 나타내는 값입니다.	string
namespaceSelector 필요	정책이 적용되는 네임스페이스를 나타내는 값입니다.	string

policy-templates

이름	설명	스키마
apiVersion 필요	버전이 지정된 정책 스키마입니다.	string
종류 선택 사항	REST 리소스를 나타내는 문자열 값입니다.	string
메타데이터 필요	정책을 정의하는 규칙을 설명합니다.	object
complianceType	관리 클러스터에 평가하거나 적용해야 하는 역할 및 기타 Kubernetes 오브젝트에 대한 예상 동작을 나열하는 데 사용됩니다.	string
metadataComplianceType optional	사용자가 다른 필드와 다른 오브젝트의 레이블 및 주석을 처리할 수 있는 방법을 제공합니다. 매개변수 값은 기본값은 `ComplianceType` 매개변수와 동일한 값입니다.	string
clusterConditions optional	레이블을 정의할 섹션입니다.	string
규칙 선택 사항		string

clusterConditions

이름	설명	스키마
matchLabels optional	정책을 네임스페이스에 적용하는 데 필요한 레이블입니다.	object
클라우드 선택 사항	정책을 클라우드 공급자에 적용하는 데 필요한 레이블입니다.	string

규칙

이름	설명	스키마
apiGroups required	규칙이 적용되는 API 목록입니다.	string
필요한 리소스	리소스 유형 목록입니다.	object
동사 필요	동사 목록입니다.	string

1.11. Observability API

1.11.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes용 MultiClusterObservability 리소스에 대한 것입니다. MultiClusterObservability 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다.

1.11.1.1. 버전 정보

버전 : 2.10.0

1.11.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.11.1.3. 태그

observability.open-cluster-management.io : multiclusterobservabilities 생성 및 관리

1.11.2. 경로

1.11.2.1. multiclusterobservability 리소스 생성

POST /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities

1.11.2.1.1. 설명

MultiClusterObservability 리소스를 생성합니다.

1.11.2.1.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
본문	본문 필요	생성할 MultiClusterObservability 리소스를 설명하는 매개변수입니다.	MultiClusterObservability

1.11.2.1.3. 응답

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

1.11.2.1.4. 사용

application/yaml

1.11.2.1.5. 태그

observability.apps.open-cluster-management.io

1.11.2.1.6. HTTP 요청의 예

1.11.2.1.6.1. 요청 본문

{
  "apiVersion": "observability.open-cluster-management.io/v1beta2",
  "kind": "MultiClusterObservability",
  "metadata": {
    "name": "example"
  },
  "spec": {
    "observabilityAddonSpec": {}
    "storageConfig": {
      "metricObjectStorage": {
        "name": "thanos-object-storage",
        "key": "thanos.yaml"
      "writeStorage": {
        - "key": " ",
          "name" : " "
        - "key": " ",
          "name" : " "
         }
       }
   }
}

1.11.2.2. 모든 multiclusterobservabilities 쿼리

GET /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities

1.11.2.2.1. 설명

자세한 내용은 MultiClusterObservability 리소스를 쿼리합니다.

1.11.2.2.2. 매개 변수

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

1.11.2.2.3. 응답

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

1.11.2.2.4. 사용

application/yaml

1.11.2.2.5. 태그

observability.apps.open-cluster-management.io

1.11.2.3. 단일 multiclusterobservability 쿼리

GET /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities/{multiclusterobservability_name}

1.11.2.3.1. 설명

자세한 내용은 단일 MultiClusterObservability 리소스를 쿼리합니다.

1.11.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	multiclusterobservability_name required	쿼리할 multiclusterobservability의 이름입니다.	string

1.11.2.3.3. 응답

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

1.11.2.3.4. 태그

observability.apps.open-cluster-management.io

1.11.2.4. multiclusterobservability 리소스 삭제

DELETE /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities/{multiclusterobservability_name}

1.11.2.4.1. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	multiclusterobservability_name required	삭제할 multiclusterobservability의 이름입니다.	string

1.11.2.4.2. 응답

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

1.11.2.4.3. 태그

observability.apps.open-cluster-management.io

1.11.3. 정의

1.11.3.1. MultiClusterObservability

이름	설명	스키마
apiVersion 필요	MultiClusterObservability의 버전이 지정된 스키마입니다.	string
종류 필요	REST 리소스 MultiClusterObservability를 나타내는 문자열 값입니다.	string
메타데이터 필요	정책을 정의하는 규칙을 설명합니다.	object

spec

이름	설명	스키마
enableDownsampling 선택 사항	downsample을 활성화하거나 비활성화합니다. 기본값은 `true` 입니다. Downsample 데이터가 없으면 쿼리를 사용할 수 없습니다.	boolean
imagePullPolicy optional	MultiClusterObservability 이미지의 가져오기 정책입니다. 기본값은 `Always`입니다.	corev1.PullPolicy
imagePullSecret optional	MultiClusterObservability 이미지의 시크릿을 가져옵니다. 기본값은 `multiclusterhub-operator-pull-secret`입니다.	string
nodeSelector 선택 사항	노드 선택기의 사양입니다.	map[string]string
observabilityAddonSpec required	관찰 기능 애드온이 설치된 모든 관리 클러스터에 대한 글로벌 설정입니다.	observabilityAddonSpec
storageConfig required	관찰 기능에서 사용할 스토리지 구성을 지정합니다.	StorageConfig
허용 오차 선택 사항	모든 구성 요소가 모든 테인트를 허용할 수 있는 기능이 제공됨.	[]corev1.Toleration
고급 선택 사항	관찰을 위한 고급 구성 설정입니다.	고급
리소스 선택 사항	MultiClusterObservability에 필요한 컴퓨팅 리소스	corev1.ResourceRequirements
복제본 선택 사항	MultiClusterObservability의 복제본입니다.	integer

storageConfig

이름	설명	스키마
alertmanagerStorageSize optional	alertmanager stateful 세트에 적용되는 스토리지 양입니다. 기본값은 `1Gi` 입니다.	string
compactStorageSize optional	thanos 컴팩트 상태 저장 세트에 적용되는 스토리지의 양입니다. 기본값은 `100Gi` 입니다.	string
metricObjectStorage required	메트릭에 대한 시크릿을 구성하는 오브젝트 저장소입니다.	metricObjectStorage
receiveStorageSize optional	thanos에 적용되는 스토리지 양은 상태 저장 세트를 수신합니다. 기본값은 `100Gi` 입니다.	string
ruleStorageSize optional	thanos 규칙 상태 저장 세트에 적용되는 스토리지의 양입니다. 기본값은 `1Gi` 입니다.	string
storageClass optional	`storageClass` stateful 세트를 지정합니다. 운영 체제가 스토리지를 생성하도록 `metricObjectStorage` 가 구성된 경우 이 스토리지는 오브젝트 스토리지에 사용됩니다. 기본값은 `gp2` 입니다.	string
storeStorageSize optional	thanos 저장소 상태 저장 세트에 적용되는 스토리지의 양입니다. 기본값은 `10Gi` 입니다.	string
writeStorage optional	엔드포인트 액세스 정보 목록입니다.	[ ]WriteStorage

writeStorage

이름	설명	스키마
이름 필요	엔드포인트 액세스 정보가 포함된 시크릿의 이름입니다.	string
키 필요	선택할 시크릿의 키입니다.	string

metricObjectStorage

이름	설명	스키마
키 필요	선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다. Thanos 설명서를 참조하십시오.	string
이름 필요	`metricObjectStorage` 의 이름입니다. 자세한 내용은 Kubernetes 이름을 참조하십시오.	string

observabilityAddonSpec

이름	설명	스키마
enableMetrics optional	관찰 기능 애드온이 허브 클러스터로 지표를 전송하는지 여부를 나타냅니다. 기본값은 `true` 입니다.	boolean
간격 선택 사항	관찰 기능 애드온에서 허브 클러스터로 메트릭을 전송하는 때의 간격입니다. 기본값은 300초(`300s`)입니다.	integer
리소스 선택 사항	지표 수집기 리소스 요구 사항에 대한 리소스입니다. 기본 CPU 요청은 `100m` 이고 메모리 요청은 `100Mi` 입니다.	corev1.ResourceRequirements

고급

이름	설명	스키마
retentionConfig optional	관찰 기능에서 사용할 데이터 보존 구성을 지정합니다.	`RetentionConfig`
rbacQueryProxy optional	rbac-query-proxy 배포의 복제본 및 리소스를 지정합니다.	CommonSpec
Grafana 선택 사항	grafana 배포의 복제본 및 리소스를 지정합니다.	CommonSpec
Alertmanager 선택 사항	alertmanager statefulset의 복제본 및 리소스를 지정합니다.	CommonSpec
observatoriumAPI optional	`observatorium-api` 배포에 대한 복제본 및 리소스를 지정합니다.	CommonSpec
queryFrontend 선택 사항	query-frontend 배포의 복제본 및 리소스를 지정합니다.	CommonSpec
쿼리선택 사항	쿼리 배포에 대한 복제본 및 리소스를 지정합니다.	CommonSpec
선택 사항 수신	수신 상태 저장 세트의 복제본 및 리소스를 지정합니다.	CommonSpec
규칙 선택 사항	규칙 상태 저장 세트의 복제본 및 리소스를 지정합니다.	CommonSpec
저장 선택 사항	저장소 상태 저장 세트의 복제본 및 리소스를 지정합니다.	CommonSpec
CompactSpec optional	컴팩트한 상태 저장 세트의 리소스를 지정합니다.	compact
StoreMemcached 선택 사항	store-memcached의 복제본, 리소스 등을 지정합니다.	storeMemcached
queryFrontendMemcached optional	query-frontend-memcached의 replicas, resources 등을 지정합니다.	CacheConfig

retentionConfig

이름	설명	스키마
블록 기간 선택 사항	시계열 데이터베이스(TSDB) 블록의 기간을 차단하는 시간입니다. 기본값은 `2h` 입니다.	string
cleanupInterval optional	부분적으로 업로드된 블록의 빈도와 `--wait` 가 활성화된 삭제 표시로 차단하는 빈도가 정리됩니다. 기본값은 `5m` 입니다.	string
deleteDelay optional	삭제로 표시된 블록이 버킷에서 삭제될 때까지의 시간입니다. 기본값은 `48h` 입니다.	string
retentionInLocal optional	로컬 스토리지의 원시 샘플을 유지하는 시간입니다. 기본값은 `24h` 입니다.	string
retentionResolutionRaw optional	버킷에서 원시 해상도 샘플을 유지하는 시간입니다. 기본값은 365일(`365`일)입니다.	string
retentionResolution5m optional	버킷에서 해상도 1(5분)의 샘플을 유지하는 시간입니다. 기본값은 365일(24`d`)입니다.	string
retentionResolution1h optional	버킷에서 해상도 2(1시간)의 샘플을 유지하는 시간입니다. 기본값은 365일(24`d`)입니다.	string

CompactSpec

이름	설명	스키마
리소스 선택 사항	thanos 컴팩트에 필요한 컴퓨팅 리소스.	corev1.ResourceRequirements
serviceAccountAnnotations optional	주석은 컴팩트 서비스 계정으로 저장된 구조화되지 않은 키 값 맵입니다.	map[string]string

storeMemcached

이름	설명	스키마
리소스 선택 사항	MultiCLusterObservability에 필요한 컴퓨팅 리소스	corev1.ResourceRequirements
복제본 선택 사항	MultiClusterObservability의 복제본입니다.	integer
memoryLimitMb optional	Memcached 메가바이트의 메모리 제한입니다.	integer
maxItemSize optional	Memcached의 최대 항목 크기입니다. 기본값은 `1m, min:1k, max:1024m` 입니다.	string
connectionLimit optional	Memcached의 최대 동시 연결입니다. 기본값은	integer

status

이름	설명	스키마
상태 선택 사항	상태에는 MultiClusterObservability의 다른 조건 상태가 포함됩니다.	metav1.Condition

CommonSpec

이름	설명	스키마
리소스 선택 사항	구성 요소에 필요한 컴퓨팅 리소스입니다.	corev1.ResourceRequirements
복제본 선택 사항	구성 요소의 복제본입니다.	integer

QuerySpec

이름	설명	스키마
CommonSpec optional	쿼리 배포에 대한 복제본 및 리소스를 지정합니다.	CommonSpec
serviceAccountAnnotations optional	주석은 쿼리 서비스 계정으로 저장된 구조화되지 않은 키 값 맵입니다.	map[string]string

ReceiveSpec

이름	설명	스키마
CommonSpec optional	쿼리 배포에 대한 복제본 및 리소스를 지정합니다.	CommonSpec
serviceAccountAnnotations optional	주석은 쿼리 서비스 계정으로 저장된 구조화되지 않은 키 값 맵입니다.	map[string]string

StoreSpec

이름	설명	스키마
CommonSpec optional	쿼리 배포에 대한 복제본 및 리소스를 지정합니다.	CommonSpec
serviceAccountAnnotations optional	주석은 쿼리 서비스 계정으로 저장된 구조화되지 않은 키 값 맵입니다.	map[string]string

RuleSpec

이름	설명	스키마
CommonSpec optional	쿼리 배포에 대한 복제본 및 리소스를 지정합니다.	CommonSpec
evalInterval optional	규칙의 평가 간격을 지정합니다.	string
serviceAccountAnnotations optional	주석은 쿼리 서비스 계정으로 저장된 구조화되지 않은 키 값 맵입니다.	map[string]string

1.12. 검색 쿼리 API

검색 쿼리 API는 Kubernetes API가 아니므로 Red Hat OpenShift Container Platform API Explorer를 통해 표시되지 않습니다. 검색 쿼리 API 기능을 이해하기 위해 계속 읽습니다.

1.12.1. 개요

경로와 함께 검색 쿼리 API를 노출하고 API를 사용하여 검색 쿼리를 해결할 수 있습니다. API는 GraphQL 끝점입니다. curl 또는 Postman과 같은 모든 클라이언트를 사용할 수 있습니다.

1.12.1.1. 버전 정보

버전 : 2.10.0

1.12.1.2. URI 스키마

BasePath : /searchapi/graphql
Schemes : HTTPS

1.12.1.3. API 액세스 구성

다음 명령을 사용하여 클러스터 외부에서 Search API에 액세스할 경로를 생성합니다.

oc create route passthrough search-api --service=search-search-api -n open-cluster-management

중요: 환경을 보호하려면 경로를 구성해야 합니다. 자세한 내용은 OpenShift Container Platform 설명서의 경로 구성 을 참조하십시오.

1.12.2. 스키마 설계

input SearchFilter {
  property: String!
  values: [String]!
}
input SearchInput {
  keywords: [String]
  filters: [SearchFilter]
  limit: Int
  relatedKinds: [String]
}
type SearchResult {
count: Int
items: [Map]
related: [SearchRelatedResult]
}
type SearchRelatedResult {
kind: String!
count: Int
items: [Map]
}

! 가 포함된 매개변수는 필드가 필요함을 나타냅니다.

1.12.2.1. 쿼리 입력 설명

유형	설명	속성
SearchFilter	결과를 필터링할 키와 값을 정의합니다. 속성에 많은 값을 제공할 때 API는 값을 "OR" 작업으로 해석합니다. 여러 필터를 제공하면 결과가 모든 필터와 일치하고 API는 "AND" 작업으로 해석됩니다.	string
SearchInput	리소스 목록을 받으려면 핵심 단어를 입력합니다. 많은 키워드를 제공하면 API는 이를 "AND" 작업으로 해석합니다.	문자열
limit	쿼리를 입력한 후 반환되는 최대 결과 수를 확인합니다. 기본값은 `10,000` 입니다. 값 `-1` 은 제한이 제거됨을 의미합니다.	정수

1.12.2.2. 스키마 예

{
  "query": "type SearchResult {count: Intitems: [Map]related: [SearchRelatedResult]} type SearchRelatedResult {kind: String!count: Intitems: [Map]}",
  "variables": {
    "input": [
      {
        "keywords": [],
        "filters": [
          {
            "property": "kind",
            "values": [
              "Deployment"
            ]
          }
        ],
        "limit": 10
      }
    ]
  }
}

1.12.3. 일반 스키마

type Query {
  search(input: [SearchInput]): [SearchResult]
  searchComplete(property: String!, query: SearchInput, limit: Int): [String]
  searchSchema: Map
  messages: [Message]
}

1.12.4. 지원되는 쿼리

JSON 형식으로 지원되는 쿼리 유형을 확인하려면 계속 읽습니다.

1.12.4.1. 배포 검색

쿼리:

query mySearch($input: [SearchInput]) {
    search(input: $input) {
    		items
        }
}

변수:

{"input":[
    {
        "keywords":[],
        "filters":[
            {"property":"kind","values":["Deployment"]}],
        "limit":10
    }
]}

1.12.4.2. Pod 검색

쿼리:

query mySearch($input: [SearchInput]) {
    search(input: $input) {
    		items
        }
}

변수:

{"input":[
    {
        "keywords":[],
        "filters":[
            {"property":"kind","values":["Pod"]}],
        "limit":10
    }
]}

1.13. MultiClusterHub API

1.13.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes용 MultiClusterHub 리소스에 대한 것입니다. MultiClusterHub 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 가능한 요청이 있습니다.

1.13.1.1. 버전 정보

버전 : 2.10.0

1.13.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.13.1.3. 태그

multiclusterhubs.operator.open-cluster-management.io : 다중 클러스터 허브 Operator 생성 및 관리

1.13.2. 경로

1.13.2.1. MultiClusterHub 리소스 생성

POST /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/mch

1.13.2.1.1. 설명

MultiClusterHub 리소스를 생성하여 다중 클러스터 허브 인스턴스의 구성을 정의합니다.

1.13.2.1.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string
본문	본문 필요	생성할 다중 클러스터 허브를 설명하는 매개변수입니다.	정의

1.13.2.1.3. 응답

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

1.13.2.1.4. 사용

multiclusterhubs/yaml

1.13.2.1.5. 태그

multiclusterhubs.operator.open-cluster-management.io

1.13.2.1.6. HTTP 요청의 예

1.13.2.1.6.1. 요청 본문

{
  "apiVersion": "apiextensions.k8s.io/v1",
  "kind": "CustomResourceDefinition",
  "metadata": {
    "name": "multiclusterhubs.operator.open-cluster-management.io"
    },
  "spec": {
    "group": "operator.open-cluster-management.io",
    "names": {
      "kind": "MultiClusterHub",
      "listKind": "MultiClusterHubList",
      "plural": "multiclusterhubs",
      "shortNames": [
          "mch"
	  ],
     "singular": "multiclusterhub"
     },
    "scope": "Namespaced",
    "versions": [
        {
	    "additionalPrinterColumns": [
                {
		   "description": "The overall status of the multicluster hub.",
                   "jsonPath": ".status.phase",
                   "name": "Status",
                   "type": "string"
		   },
               {
	           "jsonPath": ".metadata.creationTimestamp",
                   "name": "Age",
                   "type": "date"
		   }
            ],
            "name": "v1",
            "schema": {
                "openAPIV3Schema": {
                    "description": "MultiClusterHub defines the configuration for an instance of
          the multiCluster hub, a central point for managing multiple Kubernetes-based
          clusters. The deployment of multicluster hub components is determined based
          on the configuration that is defined in this resource.",
        "properties": {
            "apiVersion": {
                "description": "APIVersion defines the versioned schema of this representation
              of an object. Servers should convert recognized schemas to the latest
              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
                "type": "string"
            },
            "kind": {
                "description": "Kind is a string value representing the REST resource this
              object represents. Servers may infer this from the endpoint the client
              submits requests to. Cannot be updated. The value is in CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
                "type": "string"
            },
            "metadata": {
                "type": "object"
            },
            "spec": {
                "description": "MultiClusterHubSpec defines the desired state of MultiClusterHub.",
                "properties": {
                    "availabilityConfig": {
                        "description": "Specifies deployment replication for improved availability.
                  Options are: Basic and High (default).",
                        "type": "string"
                },
                "customCAConfigmap": {
                    "description": "Provide the customized OpenShift default ingress CA certificate
                  to {acm-short}.",
                  }
                    "type": "string"
                },
        "disableHubSelfManagement": {
                    "description": "Disable automatic import of the hub cluster as a managed
                  cluster.",
                    "type": "boolean"
                },
        "disableUpdateClusterImageSets": {
                    "description": "Disable automatic update of ClusterImageSets.",
                    "type": "boolean"
                },
                "hive": {
                    "description": "(Deprecated) Overrides for the default HiveConfig specification.",
                    "properties": {
        "additionalCertificateAuthorities": {
        "description": "(Deprecated) AdditionalCertificateAuthorities is
                      a list of references to secrets in the 'hive' namespace that
                      contain an additional Certificate Authority to use when communicating
                      with target clusters. These certificate authorities are
                      used in addition to any self-signed CA generated by each cluster
                      on installation.",
                           "items": {
                    "description": "LocalObjectReference contains the information
                        to let you locate the referenced object inside the same namespace.",
                    "properties": {
                    "name": {
                        "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
                        "type": "string"
                     }
		             },
                    "type": "object"
                      },
                           "type": "array"
                    },
                       "backup": {
                    "description": "(Deprecated) Backup specifies configuration for backup
                      integration. If absent, backup integration is disabled.",
                    "properties": {
                    "minBackupPeriodSeconds": {
                    "description": "(Deprecated) MinBackupPeriodSeconds specifies
                          that a minimum of MinBackupPeriodSeconds occurs in between
                          each backup. This is used to rate limit backups. This potentially
                          batches together multiple changes into one backup. No backups
                          are lost for changes that happen during the interval
                          that is queued up, and results in a backup once
                          the interval has been completed.",
                    "type": "integer"
                        },
                    "velero": {
                    "description": "(Deprecated) Velero specifies configuration for the Velero backup integration.",
		    "properties": {
			"enabled": {
			    "description": "(Deprecated) Enabled dictates if the Velero backup integration is enabled. If not specified, the default is disabled.",
			    "type": "boolean"
			}
		   },
		    "type": "object"
				        }
				  },
				        "type": "object"
				     },
		    "externalDNS": {
		    "description": "(Deprecated) ExternalDNS specifies configuration for external-dns if it is to be deployed by Hive. If absent, external-dns is not deployed.",
		    "properties": {
		    "aws": {
		    "description": "(Deprecated) AWS contains AWS-specific settings for external DNS.",
		    "properties": {
		        "credentials": {
			    "description": "(Deprecated) Credentials reference a secret that is used to authenticate with AWS Route53. It needs permission to manage entries in each of the managed domains for this cluster. Secret should have AWS keys named 'aws_access_key_id' and 'aws_secret_access_key'.",
			    "properties": {
				"name": {
																		            "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
																		                             "type": "string"
						    }
					},
			    "type": "object"
			}
		},
		   "type": "object"
					},
		   "gcp": {
		   "description": "(Deprecated) GCP contains Google Cloud Platform specific settings for external DNS.",
		   "properties": {
		       "credentials": {
			   "description": "(Deprecated) Credentials reference a secret that is used to authenticate with GCP DNS. It needs permission to manage entries in each of the managed domains for this cluster. Secret should have a key names 'osServiceAccount.json'. The credentials must specify the project to use.",
			   "properties": {
			       "name": {
		   "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
				   "type": "string"
							}
						},
			   "type": "object"
			}
		},
		"type": "object"
					}
				},
				      "type": "object"
					},
		"failedProvisionConfig": {
		"description": "(Deprecated) FailedProvisionConfig is used to configure settings related to handling provision failures.",
		"properties": {
		"skipGatherLogs": {
		"description": "(Deprecated) SkipGatherLogs disables functionality that attempts to gather full logs from the cluster if an installation fails for any reason. The logs are stored in a persistent volume for up to seven days.",
	        "type": "boolean"
				   }
				},
				  "type": "object"
				  },
		"globalPullSecret": {
		"description": "(Deprecated) GlobalPullSecret is used to specify a pull secret that is used globally by all of the cluster deployments. For each cluster deployment, the contents of GlobalPullSecret are merged with the specific pull secret for a cluster deployment(if specified), with precedence given to the contents of the pull secret for the cluster deployment.",
		"properties": {
		"name": {
		"description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
		"type": "string"
			                }
				},
				  "type": "object"
							},
		"maintenanceMode": {
	        "description": "(Deprecated) MaintenanceMode can be set to true to disable the Hive controllers in situations where you need to ensure nothing is running that adds or act upon finalizers on Hive types. This should rarely be needed. Sets replicas to zero for the 'hive-controllers' deployment to accomplish this.",
				  "type": "boolean"
							}
						},
			  "required": [
				         "failedProvisionConfig"
						     ],
			  "type": "object"
						 },
		"imagePullSecret": {
		    "description": "Override pull secret for accessing MultiClusterHub operand and endpoint images.",
		    "type": "string"
					},
		"ingress": {
		    "description": "Configuration options for ingress management.",
		    "properties": {
			"sslCiphers": {
	"description": "List of SSL ciphers enabled for management ingress. Defaults to full list of supported ciphers.",
			    "items": {
		    "type": "string"
					},
			    "type": "array"
						}
					},
			       "type": "object"
						},
			   "nodeSelector": {
		   "additionalProperties": {
				   "type": "string"
						},
			       "description": "Set the node selectors..",
			       "type": "object"
			},
			   "overrides": {
			       "description": "Developer overrides.",
			       "properties": {
		   "imagePullPolicy": {
		   "description": "Pull policy of the multicluster hub images.",
			               "type": "string"
							}
						},
			      "type": "object"
									},
		   "separateCertificateManagement": {
				     "description": "(Deprecated) Install cert-manager into its own namespace.",
				     "type": "boolean"
						    }
					   },
			   "type": "object"
		       },
		       "status": {
			 "description": "MulticlusterHubStatus defines the observed state of MultiClusterHub.",
			 "properties": {
			     "components": {
		      "additionalProperties": {
		      "description": "StatusCondition contains condition information.",
				      "properties": {
		      "lastTransitionTime": {
		      "description": "LastTransitionTime is the last time the condition changed from one status to another.",
		      "format": "date-time",
		      "type": "string"
					},
		      "message": {
		      "description": "Message is a human-readable message indicating\ndetails about the last status change.",
		      "type": "string"
						},
				          "reason": {
		      "description": "Reason is a (brief) reason for the last status change of the condition.",
		      "type": "string"
						},
					  "status": {
		      "description": "Status is the status of the condition. One of True, False, Unknown.",
		      "type": "string"
					},
					  "type": {
		      "description": "Type is the type of the cluster condition.",
		      "type": "string"
					}
				},
				     "type": "object"
						      },
				  "description": "Components []ComponentCondition `json:\"manifests,omitempty\"`",
				  "type": "object"
							},
			      "conditions": {
				  "description": "Conditions contain the different condition statuses for the MultiClusterHub.",
				  "items": {
		      "description": "StatusCondition contains condition information.",
				      "properties": {
		      "lastTransitionTime": {
		      "description": "LastTransitionTime is the last time the condition changed from one status to another.",
		      "format": "date-time",
		      "type": "string"
					},
		      "lastUpdateTime": {
		      "description": "The last time this condition was updated.",
		      "format": "date-time",
		      "type": "string"
					},
		      "message": {
		      "description": "Message is a human-readable message indicating details about the last status change.",
		      "type": "string"
						},
				          "reason": {
		      "description": "Reason is a (brief) reason for the last status change of the condition.",
		      "type": "string"
					},
					  "status": {
		      "description": "Status is the status of the condition. One of True, False, Unknown.",
		      "type": "string"
						},
					  "type": {
		      "description": "Type is the type of the cluster condition.",
		      "type": "string"
					}
				},
				     "type": "object"
						      },
				 "type": "array"
					},
			     "currentVersion": {
				 "description": "CurrentVersion indicates the current version..",
				 "type": "string"
						},
			     "desiredVersion": {
				 "description": "DesiredVersion indicates the desired version.",
				 "type": "string"
						 },
			     "phase": {
				 "description": "Represents the running phase of the MultiClusterHub",
				 "type": "string"
							}
						},
	                 "type": "object"
					   }
				   },
                "type": "object"
			        }
		         },
        "served": true,
        "storage": true,
        "subresources": {
	    "status": {}
	    }
	}
    ]
  }
}

1.13.2.2. 모든 MultiClusterHubs 쿼리

GET /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator

1.13.2.2.1. 설명

자세한 내용은 다중 클러스터 허브 Operator를 쿼리합니다.

1.13.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.13.2.2.3. 응답

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

1.13.2.2.4. 사용

operator/yaml

1.13.2.2.5. 태그

multiclusterhubs.operator.open-cluster-management.io

1.13.2.3. MultiClusterHub Operator 쿼리

GET /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator/{multiclusterhub_name}

1.13.2.3.1. 설명

자세한 내용은 단일 다중 클러스터 허브 Operator를 쿼리합니다.

1.13.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	application_name required	쿼리할 애플리케이션의 이름입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.13.2.3.3. 응답

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

1.13.2.3.4. 태그

multiclusterhubs.operator.open-cluster-management.io

1.13.2.4. MultiClusterHub Operator 삭제

DELETE /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator/{multiclusterhub_name}

1.13.2.4.1. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	application_name required	삭제할 다중 클러스터 허브 Operator의 이름입니다.	string
경로	네임스페이스 필요	사용할 네임스페이스(예: default)입니다.	string

1.13.2.4.2. 응답

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

1.13.2.4.3. 태그

multiclusterhubs.operator.open-cluster-management.io

1.13.3. 정의

1.13.3.1. 다중 클러스터 허브 Operator

이름	설명	스키마
apiVersion 필요	MultiClusterHub의 버전이 지정된 스키마입니다.	string
종류 필요	REST 리소스를 나타내는 문자열 값입니다.	string
메타데이터 필요	리소스를 정의하는 규칙을 설명합니다.	object
사양 필요	리소스 사양입니다.	spec

spec

availabilityConfig optional	가용성 향상을 위해 배포 복제를 지정합니다. 기본값은 `High` 입니다.	string
customCAConfigmap optional	Red Hat Advanced Cluster Management에 사용자 지정 OpenShift 기본 수신 CA 인증서를 제공합니다.	string
disableHubSelfManagement optional	허브 클러스터 자동 가져오기를 관리 클러스터로 비활성화합니다.	boolean
disableUpdateClusterImageSets optional	ClusterImageSets의 자동 업데이트를 비활성화합니다.	boolean
Hive 선택 사항	(더 이상 사용되지 않음) 기본 HiveConfig 사양에 대해 재정의하는 오브젝트입니다.	Hive
imagePullSecret optional	MultiClusterHub 피연산자 및 끝점 이미지에 액세스하기 위해 풀 시크릿을 덮어씁니다.	string
Ingress 선택 사항	수신 관리를 위한 구성 옵션입니다.	Ingress
nodeSelector 선택 사항	노드 선택기를 설정합니다.	string
separateCertificateManagement optional	(더 이상 사용되지 않음) `cert-manager` 를 자체 네임스페이스에 설치합니다.	boolean

Hive

additionalCertificateAuthorities optional	(더 이상 사용되지 않음) 대상 클러스터와 통신할 때 사용할 추가 인증 기관이 포함된 `hive` 네임스페이스의 보안에 대한 참조 목록입니다. 이러한 인증 기관은 설치 시 각 클러스터에서 생성한 자체 서명된 CA 외에도 사용됩니다.	object
백업 선택 사항	(더 이상 사용되지 않음) 백업 통합 구성을 지정합니다. 없는 경우 백업 통합이 비활성화됩니다.	Backup
externalDNS 선택 사항	(더 이상 사용되지 않음) Hive에서 배포해야 하는 경우 `external-dns` 에 대한 구성을 지정합니다. absent인 경우 `external-dns` 가 배포되지 않습니다.	object
failedProvisionConfig required	(더 이상 사용되지 않음) 프로비저닝 실패 처리와 관련된 설정을 구성하는 데 사용됩니다.	failedProvisionConfig
globalPullSecret optional	(더 이상 사용되지 않음) 모든 클러스터 배포에서 전역적으로 사용되는 풀 시크릿을 지정하는 데 사용됩니다. 각 클러스터 배포의 경우 `globalPullSecret` 의 콘텐츠가 클러스터 배포의 특정 풀 시크릿과 병합되며(지정된 경우) 클러스터 배포에 대한 풀 시크릿 콘텐츠에 우선순위가 지정됩니다.	object
maintenanceMode optional	(더 이상 사용되지 않음) Hive 유형의 종료자를 추가하거나 작동하는 아무 것도 실행하지 않는 경우 하이브 컨트롤러를 비활성화하도록 true로 설정할 수 있습니다. 이는 거의 필요하지 않습니다. `hive-controllers` 배포를 위해 replicas를 `0` 으로 설정합니다.	boolean

Ingress

sslCiphers optional	관리 수신에 활성화된 SSL 암호 목록입니다. 기본값은 지원되는 암호의 전체 목록입니다.	string

Backup

minBackupPeriodSeconds optional	(더 이상 사용되지 않음) 각 백업 간에 최소 `MinBackupPeriodSeconds` 가 발생하도록 지정합니다. 이는 제한 백업을 평가하는 데 사용됩니다. 이로 인해 여러 변경 사항을 하나의 백업에 배치될 수 있습니다. 이 간격 동안 변경 사항이 대기열에 추가되면 백업이 손실되지 않으며 간격이 완료되면 백업이 발생합니다.	integer
Velero 선택 사항	(더 이상 사용되지 않는) Velero는 Velero 백업 통합을 위한 구성을 지정합니다.	object

failedProvisionConfig

skipGatherLogs optional	(더 이상 사용되지 않음) 어떤 이유로든 설치 실패 시 클러스터에서 전체 로그를 수집하려고 하는 기능을 비활성화합니다. 로그는 최대 7일 동안 영구 볼륨에 저장됩니다.	boolean

status

구성 요소 선택 사항	상태 구성의 구성 요소입니다.	object
조건 선택 사항	다중 클러스터 허브에 대한 다양한 조건을 포함합니다.	conditions
desiredVersion optional	원하는 버전을 나타냅니다.	string
단계(선택 사항)	MultiClusterHub 리소스의 활성 단계를 나타냅니다. 이 매개변수에 사용되는 값은 `Pending`,`Running`,`Installing`,`Updating`,`Uninstalling`입니다.	string

conditions

lastTransitionTime optional	조건이 한 상태에서 다른 상태로 마지막으로 변경된 경우입니다.	string
lastUpdateTime optional	이 조건이 마지막으로 업데이트된 시간입니다.	string
메시지 필요	message는 마지막 상태 변경에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.	string
필수 이유	조건 상태가 변경된 이유에 대한 간략한 이유가 있습니다.	string
상태 필요	조건의 상태:	string
유형 필수	클러스터 조건 유형입니다.	string

StatusConditions

종류 필요	이 상태를 나타내는 리소스 `종류입니다`.	string
사용 가능한 필요	이 구성 요소가 올바르게 실행되고 있는지 여부를 나타냅니다.	boolean
lastTransitionTime optional	조건이 한 상태에서 다른 상태로 마지막으로 변경된 경우입니다.	metav1.time
lastUpdateTime optional	이 조건이 마지막으로 업데이트된 시간입니다.

API

1장. API

1.1. 클러스터 API

1.1.1. 개요

1.1.1.1. 버전 정보

1.1.1.2. URI 스키마

1.1.1.3. 태그

1.1.2. 경로

1.1.2.1. 모든 클러스터 쿼리

1.1.2.1.1. 설명

1.1.2.1.2. 매개 변수

1.1.2.1.3. 응답

1.1.2.1.4. 사용

1.1.2.1.5. 태그

1.1.2.2. 클러스터 생성

1.1.2.2.1. 설명

1.1.2.2.2. 매개 변수

1.1.2.2.3. 응답

1.1.2.2.4. 사용

1.1.2.2.5. 태그

1.1.2.2.6. HTTP 요청의 예

1.1.2.2.6.1. 요청 본문

1.1.2.3. 단일 클러스터 쿼리

1.1.2.3.1. 설명

1.1.2.3.2. 매개 변수

1.1.2.3.3. 응답

1.1.2.3.4. 태그

1.1.2.4. 클러스터 삭제

1.1.2.4.1. 설명

1.1.2.4.2. 매개 변수

1.1.2.4.3. 응답

1.1.2.4.4. 태그

1.1.3. 정의

1.1.3.1. Cluster

1.2. Clustersets API (v1beta2)

1.2.1. 개요

1.2.1.1. 버전 정보

1.2.1.2. URI 스키마

1.2.1.3. 태그

1.2.2. 경로

1.2.2.1. 모든 clustersets 쿼리

1.2.2.1.1. 설명

1.2.2.1.2. 매개 변수

1.2.2.1.3. 응답

1.2.2.1.4. 사용

1.2.2.1.5. 태그

1.2.2.2. clusterset 생성

1.2.2.2.1. 설명

1.2.2.2.2. 매개 변수

1.2.2.2.3. 응답

1.2.2.2.4. 사용

1.2.2.2.5. 태그

1.2.2.2.6. HTTP 요청의 예

1.2.2.2.6.1. 요청 본문

1.2.2.3. 단일 클러스터 세트 쿼리

1.2.2.3.1. 설명

1.2.2.3.2. 매개 변수

1.2.2.3.3. 응답

1.2.2.3.4. 태그

1.2.2.4. clusterset 삭제

1.2.2.4.1. 설명

1.2.2.4.2. 매개 변수

1.2.2.4.3. 응답

1.2.2.4.4. 태그

1.2.3. 정의

1.2.3.1. clusterset

1.3. Clustersetbindings API (v1beta2)

1.3.1. 개요

1.3.1.1. 버전 정보

1.3.1.2. URI 스키마

1.3.1.3. 태그

1.3.2. 경로

1.3.2.1. 모든 clustersetbindings 쿼리

1.3.2.1.1. 설명

1.3.2.1.2. 매개 변수

1.3.2.1.3. 응답

1.3.2.1.4. 사용

1.3.2.1.5. 태그

1.3.2.2. clustersetbinding 생성