1.6. 서브스크립션 API


1.6.1. 개요

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

1.6.1.1. 버전 정보

버전 : 2.5.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
Copy to Clipboard Toggle word wrap
1.6.2.1.1. 설명

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

1.6.2.1.2. 매개 변수
Expand
유형이름설명스키마

header

COOKIE
필요

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

string

경로

네임스페이스
필요

사용하려는 네임스페이스(예: default)입니다.

string

body

본문
필요

생성할 서브스크립션을 설명하는 매개변수입니다.

서브스크립션

1.6.2.1.3. 응답
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.6.2.1.4. Use
  • 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"
      }
    }
  }
}
Copy to Clipboard Toggle word wrap

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

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions
Copy to Clipboard Toggle word wrap
1.6.2.2.1. 설명

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

1.6.2.2.2. 매개 변수
Expand
유형이름설명스키마

header

COOKIE
필요

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

string

경로

네임스페이스
필요

사용하려는 네임스페이스(예: default)입니다.

string

1.6.2.2.3. 응답
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.6.2.2.4. Use
  • 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}
Copy to Clipboard Toggle word wrap
1.6.2.3.1. 설명

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

1.6.2.3.2. 매개 변수
Expand
유형이름설명스키마

header

COOKIE
필요

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

string

경로

네임스페이스
필요

사용하려는 네임스페이스(예: default)입니다.

string

경로

subscription_name
required

쿼리할 서브스크립션의 이름입니다.

string

1.6.2.3.3. 응답
Expand
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}
Copy to Clipboard Toggle word wrap
1.6.2.4.1. 매개 변수
Expand
유형이름설명스키마

header

COOKIE
필요

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

string

경로

네임스페이스
필요

사용하려는 네임스페이스(예: default)입니다.

string

경로

subscription_name
required

삭제할 서브스크립션의 이름입니다.

string

1.6.2.4.2. 응답
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.6.2.4.3. 태그
  • subscriptions.apps.open-cluster-management.io

1.6.3. 정의

1.6.3.1. 서브스크립션

Expand
이름스키마

apiVersion
필요

string

kind
필수

string

메타데이터
필요

metadata

spec
필수

spec

상태
선택 사항

status

metadata

Expand
이름스키마

선택 사항
주석

object

레이블
선택 사항

object

이름
선택 사항

string

네임스페이스
선택 사항

string

spec

Expand
이름스키마

채널
필요

string

이름
선택 사항

string


를 덮어쓰는 경우선택 사항

배열 덮어쓰기

packageFilter
optional

packageFilter

packageOverrides
optional

packageOverrides 배열

배치
선택 사항

placement

Timewindow
선택 사항

timewindow

덮어쓰기

Expand
이름스키마

clusterName
required

string

clusterOverrides
required

오브젝트 배열

packageFilter

Expand
이름설명스키마

선택 사항
주석

 

문자열, 문자열 맵

filterRef
optional

 

filterRef

labelSelector
optional

 

labelSelector

버전
선택 사항

Pattern : "()((\\.[0-9])(\\.)|(\\.[0-9])?(\\.[xX]))$"

string

filterRef

Expand
이름스키마

이름
선택 사항

string

labelSelector

Expand
이름스키마

matchExpressions
optional

matchExpressions 배열

matchLabels
optional

문자열, 문자열 맵

matchExpressions

Expand
이름스키마


필요

string

Operator
필요

string


값은선택 사항입니다.

문자열 배열

packageOverrides

Expand
이름스키마

packageAlias
optional

string

packageName
required

string

packageOverrides
optional

오브젝트 배열

placement

Expand
이름스키마

clusterSelector
optional

clusterSelector

클러스터
선택 사항

클러스터 배열

로컬
선택 사항

boolean

placementRef
optional

placementRef

clusterSelector

Expand
이름스키마

matchExpressions
optional

matchExpressions 배열

matchLabels
optional

문자열, 문자열 맵

matchExpressions

Expand
이름스키마


필요

string

Operator
필요

string


값은선택 사항입니다.

문자열 배열

클러스터

Expand
이름스키마

이름
필요

string

placementRef

Expand
이름스키마

apiVersion
선택 사항

string

fieldPath
optional

string

kind
선택 사항

string

이름
선택 사항

string

네임스페이스
선택 사항

string

resourceVersion
optional

string

UID
선택 사항

string

timewindow

Expand
이름스키마

daysofweek
optional

문자열 배열


선택 시간

시간 배열


위치선택 사항

string

창 유형
선택 사항

(active, blocked, Active, Blocked)

몇 시간

Expand
이름스키마


종료일:선택 사항

string


시작옵션

string

status

Expand
이름스키마

lastUpdateTime
optional

문자열(date-time)

메시지
선택 사항

string

단계
선택 사항

string

reason
optional

string


상태
선택 사항

object

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat