1.21. ManagedClusterAddOn API (v1alpha1)

1.21.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes용 ManagedClusterAddOn 리소스에 대한 것입니다. ManagedClusterAddOn 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다. ManagedClusterAddOn은 애드온의 현재 상태를 보유한 사용자 정의 리소스 오브젝트입니다. 이 리소스는 ManagedCluster 네임스페이스에서 생성해야 합니다.

1.21.1.1. 버전 정보

버전 : 2.12.0

1.21.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.21.1.3. 태그

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

1.21.2. 경로

1.21.2.1. 모든 ManagedClusterAddOns 쿼리

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

1.21.2.1.1. 설명

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

1.21.2.1.2. 매개 변수

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

1.21.2.1.3. 응답

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

1.21.2.1.4. 사용

managedclusteraddon/yaml

1.21.2.1.5. 태그

addon.open-cluster-management.io

1.21.2.2. ManagedClusterAddOn 생성

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

1.21.2.2.1. 설명

ManagedClusterAddOn을 생성합니다.

1.21.2.2.2. 매개 변수

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

1.21.2.2.3. 응답

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

1.21.2.2.4. 사용

managedclusteraddon/yaml

1.21.2.2.5. 태그

addon.open-cluster-management.io

1.21.2.2.6. HTTP 요청의 예

1.21.2.2.6.1. 요청 본문

{
  "apiVersion": "addon.open-cluster-management.io/v1alpha1",
  "kind": "ManagedClusterAddOn",
  "metadata": {
    "name": "helloworld",
    "namespace": "cluster1"
  },
  "spec": {
    "configs": [
      {
        "group": "addon.open-cluster-management.io",
        "name": "cluster-deploy-config",
        "namespace": "open-cluster-management-hub",
        "resource": "addondeploymentconfigs"
      }
    ],
    "installNamespace": "default"
  },
 "status" : { }
}

1.21.2.3. 단일 ManagedClusterAddOn 쿼리

GET /addon.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedclusteraddons/{managedclusteraddon_name}

1.21.2.3.1. 설명

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

1.21.2.3.2. 매개 변수

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

1.21.2.3.3. 응답

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

1.21.2.3.4. 태그

addon.open-cluster-management.io

1.21.2.4. Delete a ManagedClusterAddOn

DELETE /addon.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedclusteraddons/{managedclusteraddon_name}

1.21.2.4.1. 설명

단일 ManagedClusterAddOn을 삭제합니다.

1.21.2.4.2. 매개 변수

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

1.21.2.4.3. 응답

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

1.21.2.4.4. 태그

addon.open-cluster-management.io

1.21.3. 정의

1.21.3.1. ManagedClusterAddOn

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

spec

이름	설명	스키마
installNamespace optional	애드온 에이전트를 설치할 관리형 클러스터의 네임스페이스입니다. 설정되지 않은 경우 add-on 에이전트를 설치하는 데 open-cluster-management-agent-addon 네임스페이스가 사용됩니다.	string
구성 선택 사항	현재 애드온에 자체 구성이 있는 애드온 구성 목록입니다.	addOnConfig array

addOnConfig

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