Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

1.12. 검색 사용자 정의 API

1.12.1. 개요
링크 복사

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

1.12.1.1. 버전 정보
링크 복사

버전 : 2.5.0

1.12.1.2. URI 스키마
링크 복사

BasePath : /kubernetes/apis
Schemes : HTTPS

1.12.1.3. 태그
링크 복사

  • search.open-cluster-management.io/v1 : 지속성 볼륨 생성 및 관리

1.12.2. 경로
링크 복사

1.12.2.1. 검색 사용자 정의 생성
링크 복사

POST /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
Copy to Clipboard Toggle word wrap
1.12.2.1.1. 설명
링크 복사

searchCustomization을 생성합니다.

1.12.2.1.2. 매개 변수
링크 복사
Expand
유형이름설명스키마

header

COOKIE
필요

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

string

경로

네임스페이스
필요

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

string

body

본문
필요

생성할 정책을 설명하는 매개변수입니다.

 
1.12.2.1.3. 응답
링크 복사
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.12.2.1.4. Use
링크 복사
  • searchCustomization/json
1.12.2.1.5. 태그
링크 복사
  • search.open-cluster-management.io
1.12.2.1.6. HTTP 요청의 예
링크 복사
1.12.2.1.6.1. 요청 본문
링크 복사
{
  "apiVersion": "search.open-cluster-management.io/v1",
  "kind": "SearchCustomization",
  "metadata": {
    "name": "test-search-swagger",
    "description": "Example body for SearchCustomization API Swagger docs"
  },
  "spec": {
    "remediationAction": "enforce",
    "namespaces": {
      "include": [
        "default"
      ],
      "exclude": [
        "kube*"
      ]
    },
    "policy-templates": {
    "kind": "ConfigurationPolicy",
    "apiVersion": "search.open-cluster-management.io/v1alpha1",
    "complianceType": "musthave",
    "metadata": {
      "namespace": null,
      "name": "test-role"
    },
    "selector": {
      "matchLabels": {
        "cloud": "IBM"
      }
    },
    "spec" : {
      "object-templates": {
        "complianceType": "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"
              ],
            },
          ],
        },
      },
    },
  },
Copy to Clipboard Toggle word wrap

1.12.2.2. query searchCustomization
링크 복사

GET /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
Copy to Clipboard Toggle word wrap
1.12.2.2.1. 설명
링크 복사

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

1.12.2.2.2. 매개 변수
링크 복사
Expand
유형이름설명스키마

header

COOKIE
필요

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

string

경로

네임스페이스
필요

정책을 적용하려는 네임스페이스(예: default)입니다.

string

1.12.2.2.3. 응답
링크 복사
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.12.2.2.4. Use
링크 복사
  • searchCustomization/json
1.12.2.2.5. 태그
링크 복사
  • search.open-cluster-management.io

1.12.2.3. 단일 정책 쿼리
링크 복사

GET /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
Copy to Clipboard Toggle word wrap
1.12.2.3.1. 설명
링크 복사

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

1.12.2.3.2. 매개 변수
링크 복사
Expand
유형이름설명스키마

header

COOKIE
필요

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

string

경로

policy_name
required

쿼리할 정책의 이름입니다.

string

경로

네임스페이스
필요

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

string

1.12.2.3.3. 응답
링크 복사
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.12.2.3.4. 태그
링크 복사
  • search.open-cluster-management.io

1.12.2.4. 검색 사용자 지정 삭제
링크 복사

DELETE /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
Copy to Clipboard Toggle word wrap
1.12.2.4.1. 매개 변수
링크 복사
Expand
유형이름설명스키마

header

COOKIE
필요

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

string

경로

policy_name
required

삭제할 정책의 이름입니다.

string

경로

네임스페이스
필요

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

string

1.12.2.4.2. 응답
링크 복사
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.12.2.4.3. 태그
링크 복사
  • search.open-cluster-management.io

1.12.3. 정의
링크 복사

1.12.3.1. SearchCustomization
링크 복사

Expand
이름설명스키마

apiVersion
필요

버전이 지정된 SearchCustomization 스키마입니다.

string

kind
필수

REST 리소스를 나타내는 문자열 값입니다.

string

메타데이터
필요

정책을 정의하는 규칙을 설명합니다.

object

spec

Expand
이름설명스키마

remediationAction
optional

리소스에 정의된 대로 위반을 처리하는 방법을 나타내는 값입니다.Values that represents how violations are handled as defined in the resource.

string

네임스페이스
필요

정책을 적용할 때 포함하거나 제외할 네임스페이스를 나타내는 값입니다.

string

policy-templates

Expand
이름설명스키마

apiVersion
필요

버전이 지정된 SearchCustomization 스키마입니다.

string

kind
선택 사항

REST 리소스를 나타내는 문자열 값입니다.

string

메타데이터
필요

정책을 정의하는 규칙을 설명합니다.

object

complianceType

관리 클러스터에 평가하거나 적용해야 하는 역할 및 기타 Kubernetes 오브젝트의 예상 동작을 나열하는 데 사용됩니다.

string

clusterConditions
optional

레이블을 정의하는 섹션입니다.

string

규칙
선택 사항

 

string

clusterConditions

Expand
이름설명스키마

matchLabels
optional

정책을 네임스페이스에 적용하는 데 필요한 레이블입니다.

object

Cloud
선택 사항

정책을 클라우드 공급자에 적용하는 데 필요한 레이블입니다.

string

규칙

Expand
이름설명스키마

apiGroups
필요

규칙이 적용되는 API 목록입니다.

string

리소스
필요

리소스 유형 목록입니다.

object


동사필수

동사 목록입니다.

string

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat