1.19. ClusterManagementAddOn API (v1alpha1)

1.19.1. 개요

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

ClusterManagementAddOn은 클러스터 관리자에게 애드온 등록을 나타냅니다. 이 리소스를 사용하면 클러스터 관리자가 사용할 수 있는 애드온을 검색하고 애드온에 대한 메타데이터 정보도 제공할 수 있습니다. 이 리소스는 네임스페이스 범위 ManagedClusterAddOn 리소스에 사용되는 ClusterManagementAddOn 리소스의 이름인 ManagedClusterAddOn에 대한 참조도 제공합니다. ClusterManagementAddOn은 클러스터 범위 리소스입니다.

1.19.1.1. 버전 정보

버전 : 2.10.0

1.19.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.19.1.3. 태그

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

1.19.2. 경로

1.19.2.1. 모든 ClusterManagementAddOns 쿼리

GET /addon.open-cluster-management.io/v1alpha1/clustermanagementaddons

1.19.2.1.1. 설명

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

1.19.2.1.2. 매개 변수

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

1.19.2.1.3. 응답

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

1.19.2.1.4. 사용

clustermanagementaddon/yaml

1.19.2.1.5. 태그

addon.open-cluster-management.io

1.19.2.2. ClusterManagementAddOn 생성

POST /addon.open-cluster-management.io/v1alpha1/clustermanagementaddons

1.19.2.2.1. 설명

ClusterManagementAddOn을 생성합니다.

1.19.2.2.2. 매개 변수

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

1.19.2.2.3. 응답

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

1.19.2.2.4. 사용

clustermanagementaddon/yaml

1.19.2.2.5. 태그

addon.open-cluster-management.io

1.19.2.2.6. HTTP 요청의 예

1.19.2.2.6.1. 요청 본문

{
  "apiVersion": "addon.open-cluster-management.io/v1alpha1",
  "kind": "ClusterManagementAddOn",
  "metadata": {
    "name": "helloworld"
  },
  "spec": {
    "supportedConfigs": [
      {
        "defaultConfig": {
          "name": "deploy-config",
          "namespace": "open-cluster-management-hub"
        },
        "group": "addon.open-cluster-management.io",
        "resource": "addondeploymentconfigs"
      }
    ]
  },
  "status" : { }
}

1.19.2.3. 단일 ClusterManagementAddOn 쿼리

GET /addon.open-cluster-management.io/v1alpha1/clustermanagementaddons/{clustermanagementaddon_name}

1.19.2.3.1. 설명

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

1.19.2.3.2. 매개 변수

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

1.19.2.3.3. 응답

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

1.19.2.3.4. 태그

addon.open-cluster-management.io

1.19.2.4. ClusterManagementAddOn 삭제

DELETE /addon.open-cluster-management.io/v1alpha1/clustermanagementaddons/{clustermanagementaddon_name}

1.19.2.4.1. 설명

단일 ClusterManagementAddOn을 삭제합니다.

1.19.2.4.2. 매개 변수

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

1.19.2.4.3. 응답

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

1.19.2.4.4. 태그

addon.open-cluster-management.io

1.19.3. 정의

1.19.3.1. ClusterManagementAddOn

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

spec

이름	설명	스키마
addOnMeta optional	AddOnMeta는 애드온의 메타데이터 정보에 대한 참조입니다.	addOnMeta
supportedConfigs optional	SupportedConfigs는 애드온에서 지원하는 구성 유형 목록입니다.	configMeta 배열

addOnMeta

이름	설명	스키마
displayName optional	표시되는 애드온의 이름을 나타냅니다.	string
설명 선택 사항	애드온에 대한 자세한 설명을 나타냅니다.	string

configMeta

이름	설명	스키마
그룹 선택 사항	애드온 구성 그룹입니다.	string
리소스 필요	애드온 구성의 리소스입니다.	string
defaultConfig 필요	기본 애드온 구성의 네임스페이스와 이름을 나타냅니다. 여기에서 모든 애드온에 동일한 구성이 있습니다.	configReferent

configReferent

이름	설명	스키마
네임스페이스 선택 사항	애드온 구성의 네임스페이스입니다. 이 필드가 설정되지 않은 경우 구성은 클러스터 범위입니다.	string
이름 필요	애드온 구성의 이름입니다.	string