콘솔 API


OpenShift Container Platform 4.19

콘솔 API에 대한 참조 가이드

Red Hat OpenShift Documentation Team

초록

이 문서에서는 OpenShift Container Platform 콘솔 API 오브젝트 및 세부 사양에 대해 설명합니다.

1장. 콘솔 API

1.1. ConsoleCLIDownload [console.openshift.io/v1]

설명

ConsoleCLIDownload는 openshift 웹 콘솔 CLI(명령줄 인터페이스) 다운로드를 구성하기 위한 확장 프로그램입니다.

호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.

유형
object

1.4. ConsoleNotification [console.openshift.io/v1]

설명

ConsoleNotification은 openshift 웹 콘솔 알림을 구성하는 확장 프로그램입니다.

호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.

유형
object

1.5. ConsolePlugin [console.openshift.io/v1]

설명

ConsolePlugin은 클러스터에서 실행되는 다른 서비스에서 코드를 동적으로 로드하여 OpenShift 웹 콘솔을 사용자 정의하는 확장 프로그램입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.6. ConsoleQuickStart [console.openshift.io/v1]

설명

ConsoleQuickStart는 OpenShift 웹 콘솔의 다양한 워크플로우를 통해 사용자를 안내하는 확장 프로그램입니다.

호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.

유형
object

1.7. ConsoleSample [console.openshift.io/v1]

설명

ConsoleSample은 샘플을 추가하여 OpenShift 웹 콘솔을 사용자 정의하는 확장 프로그램입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.8. ConsoleYAMLSample [console.openshift.io/v1]

설명

ConsoleYAMLSample은 OpenShift 웹 콘솔 YAML 샘플을 사용자 정의하는 확장 프로그램입니다.

호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.

유형
object

2장. ConsoleCLIDownload [console.openshift.io/v1]

설명

ConsoleCLIDownload는 openshift 웹 콘솔 CLI(명령줄 인터페이스) 다운로드를 구성하기 위한 확장 프로그램입니다.

호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.

유형
object
필수 항목
  • spec

2.1. 사양

Expand
속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

ConsoleCLIDownloadSpec은 원하는 cli 다운로드 구성입니다.

2.1.1. .spec

설명
ConsoleCLIDownloadSpec은 원하는 cli 다운로드 구성입니다.
유형
object
필수 항목
  • description
  • displayName
  • links
Expand
속성유형설명

description

string

설명은 CLI 다운로드에 대한 설명입니다( 마크다운을 포함할 수 있음).

displayName

string

displayName은 CLI 다운로드의 표시 이름입니다.

links

array

링크는 CLI 다운로드 링크 세부 정보를 제공하는 오브젝트 목록입니다.

links[]

object

 

2.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/console.openshift.io/v1/consoleclidownloads

    • DELETE: ConsoleCLIDownload 컬렉션 삭제
    • GET: 종류의 ConsoleCLIDownload 오브젝트 나열
    • POST: ConsoleCLIDownload 생성
  • /apis/console.openshift.io/v1/consoleclidownloads/{name}

    • DELETE: ConsoleCLIDownload 삭제
    • GET: 지정된 ConsoleCLIDownload 읽기
    • PATCH: 지정된 ConsoleCLIDownload를 부분적으로 업데이트
    • PUT: 지정된 ConsoleCLIDownload를 교체합니다.
  • /apis/console.openshift.io/v1/consoleclidownloads/{name}/status

    • GET: 지정된 ConsoleCLIDownload의 읽기 상태
    • PATCH: 지정된 ConsoleCLIDownload의 부분 업데이트 상태
    • PUT: 지정된 ConsoleCLIDownload의 상태

2.2.1. /apis/console.openshift.io/v1/consoleclidownloads

HTTP 방법
DELETE
설명
ConsoleCLIDownload 컬렉션 삭제
Expand
표 2.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ConsoleCLIDownload 유형의 오브젝트 나열
Expand
표 2.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleCLIDownloadList 스키마

401 - 무단

HTTP 방법
POST
설명
ConsoleCLIDownload 생성
Expand
표 2.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 2.4. 본문 매개변수
매개변수유형설명

body

ConsoleCLIDownload 스키마

 
Expand
표 2.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleCLIDownload 스키마

201 - 생성됨

ConsoleCLIDownload 스키마

202 - 승인됨

ConsoleCLIDownload 스키마

401 - 무단

2.2.2. /apis/console.openshift.io/v1/consoleclidownloads/{name}

Expand
표 2.6. 글로벌 경로 매개변수
매개변수유형설명

name

string

ConsoleCLIDownload 이름

HTTP 방법
DELETE
설명
ConsoleCLIDownload 삭제
Expand
표 2.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

Expand
표 2.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ConsoleCLIDownload 읽기
Expand
표 2.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleCLIDownload 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ConsoleCLIDownload를 부분적으로 업데이트
Expand
표 2.10. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 2.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleCLIDownload 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ConsoleCLIDownload를 교체
Expand
표 2.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 2.13. 본문 매개변수
매개변수유형설명

body

ConsoleCLIDownload 스키마

 
Expand
표 2.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleCLIDownload 스키마

201 - 생성됨

ConsoleCLIDownload 스키마

401 - 무단

2.2.3. /apis/console.openshift.io/v1/consoleclidownloads/{name}/status

Expand
표 2.15. 글로벌 경로 매개변수
매개변수유형설명

name

string

ConsoleCLIDownload 이름

HTTP 방법
GET
설명
지정된 ConsoleCLIDownload의 읽기 상태
Expand
표 2.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleCLIDownload 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ConsoleCLIDownload의 부분적으로 업데이트 상태
Expand
표 2.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 2.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleCLIDownload 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ConsoleCLIDownload의 상태 교체
Expand
표 2.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 2.20. 본문 매개변수
매개변수유형설명

body

ConsoleCLIDownload 스키마

 
Expand
표 2.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleCLIDownload 스키마

201 - 생성됨

ConsoleCLIDownload 스키마

401 - 무단

5장. ConsoleNotification [console.openshift.io/v1]

설명

ConsoleNotification은 openshift 웹 콘솔 알림을 구성하는 확장 프로그램입니다.

호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.

유형
object
필수 항목
  • spec

5.1. 사양

Expand
속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

ConsoleNotificationSpec은 원하는 콘솔 알림 구성입니다.

5.1.1. .spec

설명
ConsoleNotificationSpec은 원하는 콘솔 알림 구성입니다.
유형
object
필수 항목
  • text
Expand
속성유형설명

backgroundColor

string

background Cryostat는 CSS 데이터 유형 색상으로 알림의 배경색입니다.

color

string

색상은 CSS 데이터 유형 색상으로 알림에 대한 텍스트의 색상입니다.

link

object

Link는 알림 링크 세부 정보를 보유하는 오브젝트입니다.

위치

string

location은 콘솔에 있는 알림의 위치입니다. 유효한 값은 "BannerTop", "BannerBottom", "BannerTopBottom"입니다.

text

string

텍스트는 알림의 표시 텍스트입니다.

5.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/console.openshift.io/v1/consolenotifications

    • DELETE: ConsoleNotification의 컬렉션 삭제
    • GET: ConsoleNotification 유형의 오브젝트 나열
    • POST: ConsoleNotification 생성
  • /apis/console.openshift.io/v1/consolenotifications/{name}

    • DELETE: ConsoleNotification 삭제
    • GET: 지정된 ConsoleNotification 읽기
    • PATCH: 지정된 ConsoleNotification을 부분적으로 업데이트
    • PUT: 지정된 ConsoleNotification을 교체합니다.
  • /apis/console.openshift.io/v1/consolenotifications/{name}/status

    • GET: 지정된 ConsoleNotification의 읽기 상태
    • PATCH: 지정된 ConsoleNotification의 부분 업데이트 상태
    • PUT: 지정된 ConsoleNotification의 상태 교체

5.2.1. /apis/console.openshift.io/v1/consolenotifications

HTTP 방법
DELETE
설명
ConsoleNotification의 컬렉션 삭제
Expand
표 5.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ConsoleNotification 유형의 오브젝트 나열
Expand
표 5.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleNotificationList 스키마

401 - 무단

HTTP 방법
POST
설명
ConsoleNotification 생성
Expand
표 5.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 5.4. 본문 매개변수
매개변수유형설명

body

ConsoleNotification 스키마

 
Expand
표 5.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleNotification 스키마

201 - 생성됨

ConsoleNotification 스키마

202 - 승인됨

ConsoleNotification 스키마

401 - 무단

5.2.2. /apis/console.openshift.io/v1/consolenotifications/{name}

Expand
표 5.6. 글로벌 경로 매개변수
매개변수유형설명

name

string

ConsoleNotification의 이름

HTTP 방법
DELETE
설명
ConsoleNotification 삭제
Expand
표 5.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

Expand
표 5.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ConsoleNotification 읽기
Expand
표 5.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleNotification 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ConsoleNotification을 부분적으로 업데이트
Expand
표 5.10. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 5.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleNotification 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ConsoleNotification을 교체
Expand
표 5.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 5.13. 본문 매개변수
매개변수유형설명

body

ConsoleNotification 스키마

 
Expand
표 5.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleNotification 스키마

201 - 생성됨

ConsoleNotification 스키마

401 - 무단

5.2.3. /apis/console.openshift.io/v1/consolenotifications/{name}/status

Expand
표 5.15. 글로벌 경로 매개변수
매개변수유형설명

name

string

ConsoleNotification의 이름

HTTP 방법
GET
설명
지정된 ConsoleNotification의 상태 확인
Expand
표 5.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleNotification 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ConsoleNotification의 부분 업데이트 상태
Expand
표 5.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 5.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleNotification 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ConsoleNotification의 상태 교체
Expand
표 5.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 5.20. 본문 매개변수
매개변수유형설명

body

ConsoleNotification 스키마

 
Expand
표 5.21. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleNotification 스키마

201 - 생성됨

ConsoleNotification 스키마

401 - 무단

6장. ConsolePlugin [console.openshift.io/v1]

설명

ConsolePlugin은 클러스터에서 실행되는 다른 서비스에서 코드를 동적으로 로드하여 OpenShift 웹 콘솔을 사용자 정의하는 확장 프로그램입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • 메타데이터
  • spec

6.1. 사양

Expand
속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 콘솔 플러그인에 필요한 구성이 포함되어 있습니다.

6.1.1. .spec

설명
spec에는 콘솔 플러그인에 필요한 구성이 포함되어 있습니다.
유형
object
필수 항목
  • 백엔드
  • displayName
Expand
속성유형설명

백엔드

object

백엔드에는 콘솔의 플러그인을 제공하는 백엔드 구성이 있습니다.

contentSecurityPolicy

array

contentSecurityPolicy는 플러그인에 대한 CSP(Content-Security-Policy) 지침 목록입니다. 각 지시문은 해당 지시문 유형에 적합한 값 목록을 지정합니다. 예를 들어 ScriptSrc와 같은 페치 지시문의 경우 원격 엔드포인트 목록이 있습니다. 콘솔 웹 애플리케이션은 CSP를 사용하여 XSS(교차 사이트 스크립팅) 및 데이터 주입 공격과 같은 특정 유형의 공격을 탐지하고 완화합니다. 동적 플러그인은 클러스터 외부에서 자산을 로드해야 하거나 위반 보고서가 관찰되는 경우 이 필드를 지정해야 합니다. 동적 플러그인은 벤더링을 통해 또는 클러스터 서비스에서 가져와서 클러스터 내에서 자산을 로드하는 것을 항상 선호합니다. CSP 위반 보고서는 OpenShift 웹 콘솔에서 플러그인을 개발하고 테스트하는 동안 브라우저의 콘솔 로그에서 볼 수 있습니다. 사용 가능한 지시문 유형은 DefaultSrc, ScriptSrc, StyleSrc, ImgSrc, FontSrc 및 ConnectSrc입니다. 사용 가능한 각 지침은 목록에서 한 번만 정의될 수 있습니다. 값 'self'는 OpenShift 웹 콘솔 백엔드에서 모든 fetch 지시문에 자동으로 포함됩니다. CSP 지침에 대한 자세한 내용은 https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy를 참조하세요.

OpenShift 웹 콘솔 서버는 자체 기본값과 활성화된 모든 ConsolePlugin CR에 걸쳐 CSP 지침과 값을 집계하여 Content-Security-Policy HTTP 응답 헤더를 통해 브라우저로 전송되는 단일 정책 문자열로 병합합니다.

예: ConsolePlugin A 지시문: script-src: https://script1.com/ , https://script2.com/ font-src: https://font1.com/

ConsolePlugin B 지침: script-src: https://script2.com/ , https://script3.com/ font-src: https://font2.com/ img-src: https://img1.com/

OpenShift 웹 콘솔 서버로 전달되는 통합된 CSP 지침 세트: script-src: https://script1.com/ , https://script2.com/ , https://script3.com/ font-src: https://font1.com/ , https://font2.com/ img-src: https://img1.com/

OpenShift 웹 콘솔 서버 CSP 응답 헤더: Content-Security-Policy: default-src 'self'; base-uri 'self'; script-src 'self' https://script1.com/ https://script2.com/ https://script3.com/ ; font-src 'self' https://font1.com/ https://font2.com/ ; img-src 'self' https://img1.com/ ; style-src 'self'; frame-src 'none'; object-src 'none'

contentSecurityPolicy[]

object

ConsolePluginCSP는 특정 CSP 지시문에 대한 구성을 보관합니다.

displayName

string

displayName은 플러그인의 표시 이름입니다. dispalyName은 1~128자 사이여야 합니다.

i18n

object

i18n은 플러그인의 현지화 리소스의 구성입니다.

proxy

array

proxy는 플러그인이 연결해야 하는 다양한 서비스 유형을 설명하는 프록시 목록입니다.

proxy[]

object

ConsolePluginProxy는 콘솔의 백엔드가 플러그인의 요청을 프록시하는 다양한 서비스 유형에 대한 정보를 보유합니다.

6.1.2. .spec.backend

설명
백엔드에는 콘솔의 플러그인을 제공하는 백엔드 구성이 있습니다.
유형
object
필수 항목
  • type
Expand
속성유형설명

서비스

object

서비스는 HTTP 서버와의 배포를 사용하여 플러그인을 노출하는 Kubernetes 서비스입니다. 서비스는 HTTPS 및 서비스 제공 인증서를 사용해야 합니다. 콘솔 백엔드는 서비스 CA 번들을 사용하여 서비스에서 플러그인 자산을 프록시합니다.

type

string

type은 콘솔의 플러그인에 있는 서버의 백엔드 유형입니다. 현재 "서비스"만 지원됩니다.

6.1.3. .spec.backend.service

설명
서비스는 HTTP 서버와의 배포를 사용하여 플러그인을 노출하는 Kubernetes 서비스입니다. 서비스는 HTTPS 및 서비스 제공 인증서를 사용해야 합니다. 콘솔 백엔드는 서비스 CA 번들을 사용하여 서비스에서 플러그인 자산을 프록시합니다.
유형
object
필수 항목
  • name
  • 네임스페이스
  • port
Expand
속성유형설명

basePath

string

basePath는 플러그인 자산의 경로입니다. 주요 자산은 플러그인 및 확장에 대한 메타데이터가 포함된 JSON 문서인 plugin-manifest.json 이라는 매니페스트 파일입니다.

name

string

플러그인 자산을 제공하는 서비스 이름입니다.

네임스페이스

string

플러그인 자산을 제공하는 서비스의 네임스페이스입니다.

port

integer

플러그인을 제공하는 서비스가 수신 대기하는 포트입니다.

6.1.4. .spec.contentSecurityPolicy

설명

contentSecurityPolicy는 플러그인에 대한 CSP(Content-Security-Policy) 지침 목록입니다. 각 지시문은 해당 지시문 유형에 적합한 값 목록을 지정합니다. 예를 들어 ScriptSrc와 같은 페치 지시문의 경우 원격 엔드포인트 목록이 있습니다. 콘솔 웹 애플리케이션은 CSP를 사용하여 XSS(교차 사이트 스크립팅) 및 데이터 주입 공격과 같은 특정 유형의 공격을 탐지하고 완화합니다. 동적 플러그인은 클러스터 외부에서 자산을 로드해야 하거나 위반 보고서가 관찰되는 경우 이 필드를 지정해야 합니다. 동적 플러그인은 벤더링을 통해 또는 클러스터 서비스에서 가져와서 클러스터 내에서 자산을 로드하는 것을 항상 선호합니다. CSP 위반 보고서는 OpenShift 웹 콘솔에서 플러그인을 개발하고 테스트하는 동안 브라우저의 콘솔 로그에서 볼 수 있습니다. 사용 가능한 지시문 유형은 DefaultSrc, ScriptSrc, StyleSrc, ImgSrc, FontSrc 및 ConnectSrc입니다. 사용 가능한 각 지침은 목록에서 한 번만 정의될 수 있습니다. 값 'self'는 OpenShift 웹 콘솔 백엔드에서 모든 fetch 지시문에 자동으로 포함됩니다. CSP 지침에 대한 자세한 내용은 https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy를 참조하세요.

OpenShift 웹 콘솔 서버는 자체 기본값과 활성화된 모든 ConsolePlugin CR에 걸쳐 CSP 지침과 값을 집계하여 Content-Security-Policy HTTP 응답 헤더를 통해 브라우저로 전송되는 단일 정책 문자열로 병합합니다.

예: ConsolePlugin A 지시문: script-src: https://script1.com/ , https://script2.com/ font-src: https://font1.com/

ConsolePlugin B directives:
  script-src: https://script2.com/, https://script3.com/
  font-src: https://font2.com/
  img-src: https://img1.com/
Copy to Clipboard Toggle word wrap
Unified set of CSP directives, passed to the OpenShift web console server:
  script-src: https://script1.com/, https://script2.com/, https://script3.com/
  font-src: https://font1.com/, https://font2.com/
  img-src: https://img1.com/
Copy to Clipboard Toggle word wrap
OpenShift web console server CSP response header:
  Content-Security-Policy: default-src 'self'; base-uri 'self'; script-src 'self' https://script1.com/ https://script2.com/ https://script3.com/; font-src 'self' https://font1.com/ https://font2.com/; img-src 'self' https://img1.com/; style-src 'self'; frame-src 'none'; object-src 'none'
Copy to Clipboard Toggle word wrap
유형
array

6.1.5. .spec.contentSecurityPolicy[]

설명
ConsolePluginCSP는 특정 CSP 지시문에 대한 구성을 보관합니다.
유형
object
필수 항목
  • 지령
Expand
속성유형설명

지령

string

지시문은 구성할 Content-Security-Policy 지시문을 지정합니다. 사용 가능한 지시문 유형은 DefaultSrc, ScriptSrc, StyleSrc, ImgSrc, FontSrc 및 ConnectSrc입니다. DefaultSrc 지시문은 다른 CSP 페치 지시문에 대한 대체 수단으로 사용됩니다. DefaultSrc 지시문에 대한 자세한 내용은 https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/default-src를 참조하세요. ScriptSrc 지시문은 JavaScript에 대한 유효한 소스를 지정합니다. ScriptSrc 지시어에 대한 자세한 내용은 https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/script-src를 참조하세요. StyleSrc 지시어는 스타일시트에 대한 유효한 소스를 지정합니다. StyleSrc 지시어에 대한 자세한 내용은 https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/style-src를 참조하세요. ImgSrc 지시어는 유효한 이미지 및 파비콘 소스를 지정합니다. ImgSrc 지시어에 대한 자세한 내용은 https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/img-src를 참조하세요. FontSrc 지시어는 @font-face를 사용하여 로드된 글꼴에 대한 유효한 소스를 지정합니다. FontSrc 지시문에 대한 자세한 내용은 https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/font-src를 참조하세요. ConnectSrc 지시문은 스크립트 인터페이스를 사용하여 로드할 수 있는 URL을 제한합니다. ConnectSrc 지시문에 대한 자세한 내용은 https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/connect-src를 참조하세요.

배열(문자열)

values는 이 지시어에 대한 콘솔 기본값에 추가할 값의 배열을 정의합니다. 각 ConsolePlugin은 해당 값으로 자체 지침을 정의할 수 있습니다. 이러한 설정은 OpenShift 웹 콘솔 백엔드의 Content-Security-Policy 헤더의 일부로 설정됩니다. 배열은 최대 16개의 값을 포함할 수 있습니다. 각 지시어 값은 최대 1024자여야 하며 공백, 쉼표(,), 세미콜론(;), 작은따옴표(')를 포함할 수 없습니다. 값 '*'는 허용되지 않습니다. 배열의 각 값은 고유해야 합니다.

6.1.6. .spec.i18n

설명
i18n은 플러그인의 현지화 리소스의 구성입니다.
유형
object
필수 항목
  • loadType
Expand
속성유형설명

loadType

string

loadType은 플러그인의 로컬라이제이션 리소스를 로드하는 방법을 나타냅니다. 유효한 값은 Preload, Lazy 및 빈 문자열입니다. Preload로 설정하면 플러그인이 로드될 때 모든 로컬라이제이션 리소스를 가져옵니다. Lazy로 설정하면 현지화 리소스가 콘솔에 필요한 대로 로드됩니다. 생략하거나 빈 문자열로 설정하면 동작은 Lazy 유형과 동일합니다.

6.1.7. .spec.proxy

설명
proxy는 플러그인이 연결해야 하는 다양한 서비스 유형을 설명하는 프록시 목록입니다.
유형
array

6.1.8. .spec.proxy[]

설명
ConsolePluginProxy는 콘솔의 백엔드가 플러그인의 요청을 프록시하는 다양한 서비스 유형에 대한 정보를 보유합니다.
유형
object
필수 항목
  • 별칭
  • endpoint
Expand
속성유형설명

별칭

string

alias는 플러그인의 프록시를 식별하는 프록시 이름입니다. 별칭 이름은 플러그인당 고유해야 합니다. 콘솔 백엔드는 다음 프록시 끝점을 노출합니다.

/api/proxy/plugin/<plugin-name>/<proxy-alias>/<request-path>?<optional-query-parameters>

요청 예 경로:

/api/proxy/plugin/acm/search/pods?namespace=openshift-apiserver

권한 부여

string

권한 부여는 프록시 요청이 포함되어야 하는 권한 부여 유형에 대한 정보를 제공합니다.

caCertificate

string

caCertificate는 프록시 서비스에서 사용자 정의 서비스 CA를 사용하는 경우 인증 기관 인증서 콘텐츠를 제공합니다. 기본적으로 service-ca Operator에서 제공하는 서비스 CA 번들이 사용됩니다.

endpoint

object

엔드포인트는 요청이 프록시되는 끝점에 대한 정보를 제공합니다.

6.1.9. .spec.proxy[].endpoint

설명
엔드포인트는 요청이 프록시되는 끝점에 대한 정보를 제공합니다.
유형
object
필수 항목
  • type
Expand
속성유형설명

서비스

object

서비스는 플러그인이 연결할 클러스터 내 서비스입니다. 서비스는 HTTPS를 사용해야 합니다. 콘솔 백엔드는 플러그인과 서비스 간의 통신을 프록시하기 위해 끝점을 노출합니다. 참고: 현재 "Service" 유형만 지원되므로 현재 service 필드가 필요합니다.

type

string

type은 콘솔 플러그인의 프록시 유형입니다. 현재 "서비스"만 지원됩니다.

6.1.10. .spec.proxy[].endpoint.service

설명
서비스는 플러그인이 연결할 클러스터 내 서비스입니다. 서비스는 HTTPS를 사용해야 합니다. 콘솔 백엔드는 플러그인과 서비스 간의 통신을 프록시하기 위해 끝점을 노출합니다. 참고: 현재 "Service" 유형만 지원되므로 현재 service 필드가 필요합니다.
유형
object
필수 항목
  • name
  • 네임스페이스
  • port
Expand
속성유형설명

name

string

플러그인에 연결해야 하는 서비스 이름입니다.

네임스페이스

string

플러그인이 연결해야 하는 서비스의 네임스페이스

port

integer

플러그인이 연결해야 하는 서비스가 수신 대기 중인 포트입니다.

6.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/console.openshift.io/v1/consoleplugins

    • DELETE: ConsolePlugin의 컬렉션 삭제
    • GET: 종류의 ConsolePlugin의 오브젝트 나열
    • POST: ConsolePlugin 생성
  • /apis/console.openshift.io/v1/consoleplugins/{name}

    • DELETE: ConsolePlugin 삭제
    • GET: 지정된 ConsolePlugin 읽기
    • PATCH: 지정된 ConsolePlugin을 부분적으로 업데이트
    • PUT: 지정된 ConsolePlugin을 바꿉니다.

6.2.1. /apis/console.openshift.io/v1/consoleplugins

HTTP 방법
DELETE
설명
ConsolePlugin 컬렉션 삭제
Expand
표 6.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ConsolePlugin 유형의 오브젝트 나열
Expand
표 6.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsolePluginList 스키마

401 - 무단

HTTP 방법
POST
설명
ConsolePlugin 생성
Expand
표 6.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 6.4. 본문 매개변수
매개변수유형설명

body

ConsolePlugin 스키마

 
Expand
표 6.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsolePlugin 스키마

201 - 생성됨

ConsolePlugin 스키마

202 - 승인됨

ConsolePlugin 스키마

401 - 무단

6.2.2. /apis/console.openshift.io/v1/consoleplugins/{name}

Expand
표 6.6. 글로벌 경로 매개변수
매개변수유형설명

name

string

ConsolePlugin의 이름

HTTP 방법
DELETE
설명
ConsolePlugin 삭제
Expand
표 6.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

Expand
표 6.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ConsolePlugin 읽기
Expand
표 6.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsolePlugin 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ConsolePlugin을 부분적으로 업데이트
Expand
표 6.10. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 6.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsolePlugin 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ConsolePlugin을 교체
Expand
표 6.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 6.13. 본문 매개변수
매개변수유형설명

body

ConsolePlugin 스키마

 
Expand
표 6.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsolePlugin 스키마

201 - 생성됨

ConsolePlugin 스키마

401 - 무단

7장. ConsoleQuickStart [console.openshift.io/v1]

설명

ConsoleQuickStart는 OpenShift 웹 콘솔의 다양한 워크플로우를 통해 사용자를 안내하는 확장 프로그램입니다.

호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.

유형
object
필수 항목
  • spec

7.1. 사양

Expand
속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

ConsoleQuickStartSpec은 원하는 퀵 스타트 구성입니다.

7.1.1. .spec

설명
ConsoleQuickStartSpec은 원하는 퀵 스타트 구성입니다.
유형
object
필수 항목
  • description
  • displayName
  • durationMinutes
  • Introduction
  • tasks
Expand
속성유형설명

accessReviewResources

array

accessReviewResources에는 사용자가 빠른 시작을 완료하기 위해 사용자 액세스 권한을 검토할 리소스 목록이 포함되어 있습니다. 액세스 검토가 실패하면 빠른 시작이 숨겨집니다.

accessReviewResources[]

object

ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.

conclusion

string

conclusion는 빠른 시작을 요약하고 가능한 다음 단계를 제안합니다. ( 마크다운 포함)

description

string

Description is the description of the Quick Start. (includes markdown)

displayName

string

displayName은 빠른 시작의 표시 이름입니다.

durationMinutes

integer

durationMinutes는 빠른 시작을 완료하는 데 걸리는 약 몇 분을 설명합니다.

icon

string

icon은 빠른 시작 표시 이름 옆에 표시되는 base64로 인코딩된 이미지입니다. 아이콘은 쉽게 스케일링할 수 있는 벡터 이미지여야 합니다. 아이콘 크기는 40x40이어야 합니다.

Introduction

string

소개 빠른 시작의 목적을 설명합니다. (표시 표시 포함)

nextQuickStart

배열(문자열)

nextQuickStart는 사용자가 시도할 수 있도록 제안된 다음 빠른 시작 목록입니다.

사전 요구 사항

배열(문자열)

사전 요구 사항은 빠른 시작을 시작하기 전에 충족해야 하는 모든 사전 요구 사항을 포함합니다. ( 마크다운 포함)

tags

배열(문자열)

태그는 빠른 시작을 설명하는 문자열 목록입니다.

tasks

array

tasks는 사용자가 빠른 시작을 완료하기 위해 수행해야 하는 단계 목록입니다.

tasks[]

object

ConsoleQuickStartTask는 빠른 시작의 단일 단계입니다.

7.1.2. .spec.accessReviewResources

설명
accessReviewResources에는 사용자가 빠른 시작을 완료하기 위해 사용자 액세스 권한을 검토할 리소스 목록이 포함되어 있습니다. 액세스 검토가 실패하면 빠른 시작이 숨겨집니다.
유형
array

7.1.3. .spec.accessReviewResources[]

설명
ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
유형
object
Expand
속성유형설명

fieldSelector

object

fieldSelector는 필드를 기반으로 하는 액세스 제한 사항을 설명합니다. 액세스 제한은 넓히지 않고 액세스를 제한할 수 있습니다.

이 필드는 알파 수준입니다. 이 필드를 사용하려면 AuthorizeWithSelectors 기능 게이트를 활성화해야 합니다(기본적으로 비활성화).

group

string

group은 리소스의 API 그룹입니다. "*"는 모든 것을 의미합니다.

labelSelector

object

labelSelector는 라벨을 기반으로 하는 액세스 제한 사항을 설명합니다. 액세스 제한은 넓히지 않고 액세스를 제한할 수 있습니다.

이 필드는 알파 수준입니다. 이 필드를 사용하려면 AuthorizeWithSelectors 기능 게이트를 활성화해야 합니다(기본적으로 비활성화).

name

string

name은 "get"에 대해 요청되거나 "삭제"에 대해 요청된 리소스의 이름입니다. ""(비어 있음)는 모두 의미합니다.

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 LocalSubjectAccessReviews ""(비어 있음)에 대해 네임스페이스와 모든 네임스페이스 ""(빈)가 기본적으로 비어 있는 경우 클러스터 범위 리소스 ""(빈)는 SubjectAccessReview 또는 SelfSubjectAccessReview의 네임스페이스 범위 리소스에 대해 "all"을 의미합니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다. "*"는 모든 것을 의미합니다.

하위 리소스

string

하위 리소스는 기존 리소스 유형 중 하나입니다. ""는 none을 의미합니다.

verb

string

동사는 get, list, watch, create, update, delete, proxy와 같은 kubernetes 리소스 API 동사입니다. "*"는 모든 것을 의미합니다.

version

string

버전은 리소스의 API 버전입니다. "*"는 모든 것을 의미합니다.

7.1.4. .spec.accessReviewResources[].fieldSelector

설명

fieldSelector는 필드를 기반으로 하는 액세스 제한 사항을 설명합니다. 액세스 제한은 넓히지 않고 액세스를 제한할 수 있습니다.

이 필드는 알파 수준입니다. 이 필드를 사용하려면 AuthorizeWithSelectors 기능 게이트를 활성화해야 합니다(기본적으로 비활성화).

유형
object
Expand
속성유형설명

rawSelector

string

rawSelector는 쿼리 매개변수에 포함될 필드 선택기의 직렬화입니다. Webhook 구현은 rawSelector를 무시하는 것이 좋습니다. kube-apiserver의 *SubjectAccessReview는 요구 사항이 없는 한 rawSelector를 구문 분석합니다.

요구사항

array

요구 사항은 필드 선택기를 구문 분석한 해석입니다. 리소스 인스턴스가 선택기와 일치하도록 모든 요구 사항을 충족해야 합니다. Webhook 구현은 요구 사항을 처리해야 하지만 이를 처리하는 방법은 Webhook에 따라 다릅니다. 요구 사항은 요청을 제한할 수 있기 때문에 요구 사항이 이해되지 않는 경우 무제한 요청으로 권한을 부여하는 것이 안전합니다.

requirements[]

object

FieldSelectorRequirement는 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

7.1.5. .spec.accessReviewResources[].fieldSelector.requirements

설명
요구 사항은 필드 선택기를 구문 분석한 해석입니다. 리소스 인스턴스가 선택기와 일치하도록 모든 요구 사항을 충족해야 합니다. Webhook 구현은 요구 사항을 처리해야 하지만 이를 처리하는 방법은 Webhook에 따라 다릅니다. 요구 사항은 요청을 제한할 수 있기 때문에 요구 사항이 이해되지 않는 경우 무제한 요청으로 권한을 부여하는 것이 안전합니다.
유형
array

7.1.6. .spec.accessReviewResources[].fieldSelector.requirements[]

설명
FieldSelectorRequirement는 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
Expand
속성유형설명

key

string

key는 요구 사항이 적용되는 필드 선택기 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. Operator 목록은 향후 증가할 수 있습니다.

배열(문자열)

값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다.

7.1.7. .spec.accessReviewResources[].labelSelector

설명

labelSelector는 라벨을 기반으로 하는 액세스 제한 사항을 설명합니다. 액세스 제한은 넓히지 않고 액세스를 제한할 수 있습니다.

이 필드는 알파 수준입니다. 이 필드를 사용하려면 AuthorizeWithSelectors 기능 게이트를 활성화해야 합니다(기본적으로 비활성화).

유형
object
Expand
속성유형설명

rawSelector

string

rawSelector는 쿼리 매개변수에 포함될 필드 선택기의 직렬화입니다. Webhook 구현은 rawSelector를 무시하는 것이 좋습니다. kube-apiserver의 *SubjectAccessReview는 요구 사항이 없는 한 rawSelector를 구문 분석합니다.

요구사항

array

요구 사항은 라벨 선택기를 구문 분석한 해석입니다. 리소스 인스턴스가 선택기와 일치하도록 모든 요구 사항을 충족해야 합니다. Webhook 구현은 요구 사항을 처리해야 하지만 이를 처리하는 방법은 Webhook에 따라 다릅니다. 요구 사항은 요청을 제한할 수 있기 때문에 요구 사항이 이해되지 않는 경우 무제한 요청으로 권한을 부여하는 것이 안전합니다.

requirements[]

object

레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

7.1.8. .spec.accessReviewResources[].labelSelector.requirements

설명
요구 사항은 라벨 선택기를 구문 분석한 해석입니다. 리소스 인스턴스가 선택기와 일치하도록 모든 요구 사항을 충족해야 합니다. Webhook 구현은 요구 사항을 처리해야 하지만 이를 처리하는 방법은 Webhook에 따라 다릅니다. 요구 사항은 요청을 제한할 수 있기 때문에 요구 사항이 이해되지 않는 경우 무제한 요청으로 권한을 부여하는 것이 안전합니다.
유형
array

7.1.9. .spec.accessReviewResources[].labelSelector.requirements[]

설명
레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
Expand
속성유형설명

key

string

key는 선택기가 적용되는 라벨 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.

배열(문자열)

값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

7.1.10. .spec.tasks

설명
tasks는 사용자가 빠른 시작을 완료하기 위해 수행해야 하는 단계 목록입니다.
유형
array

7.1.11. .spec.tasks[]

설명
ConsoleQuickStartTask는 빠른 시작의 단일 단계입니다.
유형
object
필수 항목
  • description
  • title
Expand
속성유형설명

description

string

Description은 작업을 완료하는 데 필요한 단계를 설명합니다. ( 마크다운 포함)

검토

object

검토에는 작업이 완료되었는지 확인하는 지침이 포함되어 있습니다. 사용자가 단계가 성공적으로 완료되었는지 여부를 나타내는 라디오 버튼을 사용하여 '예' 또는 '아니오'를 선택합니다.

summary

object

요약에는 전달된 단계에 대한 정보가 포함되어 있습니다.

title

string

title은 작업을 설명하고 단계 제목으로 표시됩니다.

7.1.12. .spec.tasks[].review

설명
검토에는 작업이 완료되었는지 확인하는 지침이 포함되어 있습니다. 사용자가 단계가 성공적으로 완료되었는지 여부를 나타내는 라디오 버튼을 사용하여 '예' 또는 '아니오'를 선택합니다.
유형
object
필수 항목
  • failedTaskHelp
  • 지침
Expand
속성유형설명

failedTaskHelp

string

failedTaskHelp에는 실패한 작업 검토에 대한 제안 사항이 포함되어 있으며 작업 끝에 표시됩니다.

지침

string

지침에는 작업을 수행한 후 작업의 유효성을 검사하기 위해 사용자가 수행해야 하는 단계가 포함되어 있습니다. ( 마크다운 포함)

7.1.13. .spec.tasks[].summary

설명
요약에는 전달된 단계에 대한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • failed
  • success
Expand
속성유형설명

failed

string

failed가 성공적으로 통과하지 못한 작업을 간략하게 설명합니다. ( markdown 포함)

success

string

success는 매우 통과된 작업을 설명합니다.

7.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/console.openshift.io/v1/consolequickstarts

    • DELETE: ConsoleQuickStart의 컬렉션 삭제
    • GET: 종류의 ConsoleQuickStart의 오브젝트 나열
    • POST: ConsoleQuickStart 생성
  • /apis/console.openshift.io/v1/consolequickstarts/{name}

    • DELETE: delete a ConsoleQuickStart
    • GET: 지정된 ConsoleQuickStart 읽기
    • PATCH: 지정된 ConsoleQuickStart를 부분적으로 업데이트
    • PUT: 지정된 ConsoleQuickStart를 교체합니다.

7.2.1. /apis/console.openshift.io/v1/consolequickstarts

HTTP 방법
DELETE
설명
ConsoleQuickStart의 컬렉션 삭제
Expand
표 7.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ConsoleQuickStart 유형의 오브젝트 나열
Expand
표 7.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleQuickStartList schema

401 - 무단

HTTP 방법
POST
설명
ConsoleQuickStart 생성
Expand
표 7.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 7.4. 본문 매개변수
매개변수유형설명

body

ConsoleQuickStart 스키마

 
Expand
표 7.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleQuickStart 스키마

201 - 생성됨

ConsoleQuickStart 스키마

202 - 승인됨

ConsoleQuickStart 스키마

401 - 무단

7.2.2. /apis/console.openshift.io/v1/consolequickstarts/{name}

Expand
표 7.6. 글로벌 경로 매개변수
매개변수유형설명

name

string

ConsoleQuickStart의 이름

HTTP 방법
DELETE
설명
delete a ConsoleQuickStart
Expand
표 7.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

Expand
표 7.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ConsoleQuickStart 읽기
Expand
표 7.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleQuickStart 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ConsoleQuickStart를 부분적으로 업데이트
Expand
표 7.10. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 7.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleQuickStart 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ConsoleQuickStart를 교체
Expand
표 7.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 7.13. 본문 매개변수
매개변수유형설명

body

ConsoleQuickStart 스키마

 
Expand
표 7.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleQuickStart 스키마

201 - 생성됨

ConsoleQuickStart 스키마

401 - 무단

8장. ConsoleSample [console.openshift.io/v1]

설명

ConsoleSample은 샘플을 추가하여 OpenShift 웹 콘솔을 사용자 정의하는 확장 프로그램입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • 메타데이터
  • spec

8.1. 사양

Expand
속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 콘솔 샘플에 대한 구성이 포함되어 있습니다.

8.1.1. .spec

설명
spec에는 콘솔 샘플에 대한 구성이 포함되어 있습니다.
유형
object
필수 항목
  • abstract
  • description
  • 소스
  • title
Expand
속성유형설명

abstract

string

추상은 샘플에 대한 간략한 소개입니다.

필수이며 길이가 100자를 초과할 수 없습니다.

요약은 제목 및 공급자 아래의 샘플 카드 타일에 표시되며 3 줄의 콘텐츠로 제한됩니다.

description

string

설명은 샘플에 대한 긴 설명입니다.

필수이며 최대 4096 자의 길이를 가질 수 있습니다.

추가 정보, 링크, 사전 조건 및 기타 지침은 README.md와 같은 내용입니다. 줄 바꿈, 링크 및 기타 간단한 형식을 포함할 수 있도록 마크다운으로 렌더링됩니다.

icon

string

icon은 base64로 인코딩된 이미지이며 샘플 제목 옆에 표시됩니다.

형식은 data: URL 형식을 따라야 하며 최대 크기가 10KB 일 수 있습니다.

data:[<mediatype>][;base64],<base64 encoded image>

예를 들면 다음과 같습니다.

data:image;base64 및 base64 인코딩 이미지.

벡터 이미지도 사용할 수 있습니다. SVG 아이콘은 다음으로 시작해야 합니다.

data:image/svg+xml;base64 및 base64로 인코딩된 SVG 이미지입니다.

모든 샘플 카탈로그 아이콘은 흰색 배경(크기 테마 사용 시)에 표시됩니다. 웹 콘솔을 사용하면 다양한 측면 비율이 올바르게 작동합니다. 현재 아이콘의 표면은 최대 40x100px입니다.

데이터 URL 형식에 대한 자세한 내용은 https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs 참조하십시오.

provider

string

provider는 샘플을 제공하는 사용자를 준수하기 위한 선택적 레이블입니다.

이는 선택 사항이며 길이가 50자를 넘지 않아야 합니다.

공급자는 "Red Hat"과 같은 회사이거나 "CNCF" 또는 "Knative"와 같은 조직일 수 있습니다.

현재 공급자는 "Provided by "" 접두사가 있는 제목 아래의 샘플 카드 타일에만 표시됩니다.

소스

object

source는 샘플 서비스를 배포할 위치를 정의합니다. 샘플은 외부 Git 리포지토리 또는 컨테이너 이미지에서 소싱할 수 있습니다.

tags

배열(문자열)

태그는 샘플 카탈로그에서 샘플을 찾는 데 사용할 수 있는 선택적 문자열 값입니다.

일반적인 태그의 예로는 "Java", "Quarkus" 등이 있을 수 있습니다.

샘플 세부 정보 페이지에 표시됩니다.

title

string

이름은 샘플의 표시 이름입니다.

필수이며 50자를 초과해서는 안 됩니다.

type

string

type은 여러 샘플을 그룹화하는 선택적 레이블입니다.

이는 선택 사항이며 20자 이상이어야 합니다.

권장 사항은 "Builder Image", "Devfile" 또는 "Serverless Function"와 같은 단일 용어입니다.

현재 유형에는 오른쪽 상단에 있는 샘플 카드 타일에 배지가 표시됩니다.

8.1.2. .spec.source

설명
source는 샘플 서비스를 배포할 위치를 정의합니다. 샘플은 외부 Git 리포지토리 또는 컨테이너 이미지에서 소싱할 수 있습니다.
유형
object
필수 항목
  • type
Expand
속성유형설명

containerImport

object

containerImport를 사용하면 컨테이너 이미지를 가져올 수 있습니다.

gitImport

object

gitImport를 사용하면 Git 리포지토리에서 코드를 가져올 수 있습니다.

type

string

현재 지원되는 샘플 유형: "GitImport";"ContainerImport"

8.1.3. .spec.source.containerImport

설명
containerImport를 사용하면 컨테이너 이미지를 가져올 수 있습니다.
유형
object
필수 항목
  • image
Expand
속성유형설명

image

string

HTTP 서비스를 제공하는 컨테이너 이미지에 대한 참조입니다. port 필드로 달리 구성하지 않는 한 기본 포트(8080)에 서비스를 노출해야 합니다.

지원되는 형식: - <repository-name>/<image-name> - docker.io/<repository-name>/<image-name> - quay.io/<repository-name>/<image-name>/<image-name>/<image-name>@sha256:<image hash> - quay.io/<repository-name>:<tag>:<tag>

서비스

object

서비스에는 이 샘플에 대해 생성된 서비스 리소스에 대한 구성이 포함되어 있습니다.

8.1.4. .spec.source.containerImport.service

설명
서비스에는 이 샘플에 대해 생성된 서비스 리소스에 대한 구성이 포함되어 있습니다.
유형
object
Expand
속성유형설명

targetPort

integer

targetPort는 서비스가 HTTP 요청을 수신 대기하는 포트입니다. 이 포트는 이 샘플에 대해 생성된 서비스 및 경로에 사용됩니다. 포트는 1~65535 범위에 있어야 합니다. 기본 포트는 8080입니다.

8.1.5. .spec.source.gitImport

설명
gitImport를 사용하면 Git 리포지토리에서 코드를 가져올 수 있습니다.
유형
object
필수 항목
  • 리포지토리
Expand
속성유형설명

리포지토리

object

리포지토리에는 실제 Git 리포지토리에 대한 참조가 포함되어 있습니다.

서비스

object

서비스에는 이 샘플에 대해 생성된 서비스 리소스에 대한 구성이 포함되어 있습니다.

8.1.6. .spec.source.gitImport.repository

설명
리포지토리에는 실제 Git 리포지토리에 대한 참조가 포함되어 있습니다.
유형
object
필수 항목
  • url
Expand
속성유형설명

contextDir

string

contextDir은 구성 요소를 빌드할 리포지토리 내에서 디렉터리를 지정하는 데 사용됩니다. / 로 시작해야 하며 최대 256자 길이를 가져야 합니다. 생략하면 기본값은 리포지토리의 루트에서 빌드하는 것입니다.

버전

string

개정 버전은 git 리포지토리를 복제할 Git 버전이며 특정 분기, 태그 또는 커밋 SHA를 복제하는 데 사용할 수 있습니다. 최대 256자 이상이어야 합니다. 리포지토리의 기본 분기를 생략하면 사용됩니다.

url

string

HTTP 서비스가 포함된 Git 리포지토리의 URL입니다. port 필드로 달리 구성하지 않는 한 HTTP 서비스는 기본 포트(8080)에 노출되어야 합니다.

현재 GitHub, GitLab 및 Bitbucket의 공용 리포지토리만 지원됩니다.

- https://github.com/<org>/<repository > - https://gitlab.com/<org>/<repository > - https://bitbucket.org/<org>/<repository>

URL의 길이는 최대 256자여야 합니다.

8.1.7. .spec.source.gitImport.service

설명
서비스에는 이 샘플에 대해 생성된 서비스 리소스에 대한 구성이 포함되어 있습니다.
유형
object
Expand
속성유형설명

targetPort

integer

targetPort는 서비스가 HTTP 요청을 수신 대기하는 포트입니다. 이 포트는 이 샘플에 대해 생성된 서비스에 사용됩니다. 포트는 1~65535 범위에 있어야 합니다. 기본 포트는 8080입니다.

8.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/console.openshift.io/v1/consolesamples

    • DELETE: ConsoleSample의 컬렉션 삭제
    • GET: 종류의 ConsoleSample 오브젝트 나열
    • POST: ConsoleSample 생성
  • /apis/console.openshift.io/v1/consolesamples/{name}

    • DELETE: ConsoleSample 삭제
    • GET: 지정된 ConsoleSample을 읽습니다.
    • PATCH: 지정된 ConsoleSample을 부분적으로 업데이트
    • PUT: 지정된 ConsoleSample을 교체합니다.

8.2.1. /apis/console.openshift.io/v1/consolesamples

HTTP 방법
DELETE
설명
ConsoleSample 컬렉션 삭제
Expand
표 8.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ConsoleSample 유형의 오브젝트 나열
Expand
표 8.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleSampleList 스키마

401 - 무단

HTTP 방법
POST
설명
ConsoleSample 생성
Expand
표 8.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 8.4. 본문 매개변수
매개변수유형설명

body

ConsoleSample 스키마

 
Expand
표 8.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleSample 스키마

201 - 생성됨

ConsoleSample 스키마

202 - 승인됨

ConsoleSample 스키마

401 - 무단

8.2.2. /apis/console.openshift.io/v1/consolesamples/{name}

Expand
표 8.6. 글로벌 경로 매개변수
매개변수유형설명

name

string

ConsoleSample의 이름

HTTP 방법
DELETE
설명
콘솔Sample 삭제
Expand
표 8.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

Expand
표 8.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ConsoleSample 읽기
Expand
표 8.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleSample 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ConsoleSample을 부분적으로 업데이트
Expand
표 8.10. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 8.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleSample 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ConsoleSample을 바꿉니다.
Expand
표 8.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 8.13. 본문 매개변수
매개변수유형설명

body

ConsoleSample 스키마

 
Expand
표 8.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleSample 스키마

201 - 생성됨

ConsoleSample 스키마

401 - 무단

9장. ConsoleYAMLSample [console.openshift.io/v1]

설명

ConsoleYAMLSample은 OpenShift 웹 콘솔 YAML 샘플을 사용자 정의하는 확장 프로그램입니다.

호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.

유형
object
필수 항목
  • 메타데이터
  • spec

9.1. 사양

Expand
속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

ConsoleYAMLSampleSpec은 원하는 YAML 샘플 구성입니다. 샘플은 웹 콘솔에서 리소스를 생성할 때 샘플 사이드바에 설명과 함께 표시됩니다.

9.1.1. .spec

설명
ConsoleYAMLSampleSpec은 원하는 YAML 샘플 구성입니다. 샘플은 웹 콘솔에서 리소스를 생성할 때 샘플 사이드바에 설명과 함께 표시됩니다.
유형
object
필수 항목
  • description
  • targetResource
  • title
  • yaml
Expand
속성유형설명

description

string

YAML 샘플에 대한 설명입니다.

스니펫

boolean

스니펫은 YAML 샘플이 전체 YAML 리소스 정의가 아니라 사용자 커서의 기존 YAML 문서에 삽입할 수 있는 조각을 나타냅니다.

targetResource

object

targetResource에는 apiVersion 및 kind of resource YAML 샘플이 포함되어 있습니다.

title

string

YAML 샘플의 이름입니다.

yaml

string

YAML은 표시할 YAML 샘플입니다.

9.1.2. .spec.targetResource

설명
targetResource에는 apiVersion 및 kind of resource YAML 샘플이 포함되어 있습니다.
유형
object
Expand
속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

9.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/console.openshift.io/v1/consoleyamlsamples

    • DELETE: ConsoleYAMLSample의 컬렉션 삭제
    • GET: ConsoleYAMLSample 유형의 오브젝트 나열
    • POST: ConsoleYAMLSample 생성
  • /apis/console.openshift.io/v1/consoleyamlsamples/{name}

    • DELETE: ConsoleYAMLSample 삭제
    • GET: 지정된 ConsoleYAMLSample을 읽습니다.
    • PATCH: 지정된 ConsoleYAMLSample을 부분적으로 업데이트합니다.
    • PUT: 지정된 ConsoleYAMLSample을 교체합니다.

9.2.1. /apis/console.openshift.io/v1/consoleyamlsamples

HTTP 방법
DELETE
설명
ConsoleYAMLSample 컬렉션 삭제
Expand
표 9.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ConsoleYAMLSample 유형의 오브젝트 나열
Expand
표 9.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleYAMLSampleList 스키마

401 - 무단

HTTP 방법
POST
설명
ConsoleYAMLSample 생성
Expand
표 9.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 9.4. 본문 매개변수
매개변수유형설명

body

ConsoleYAMLSample 스키마

 
Expand
표 9.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleYAMLSample 스키마

201 - 생성됨

ConsoleYAMLSample 스키마

202 - 승인됨

ConsoleYAMLSample 스키마

401 - 무단

9.2.2. /apis/console.openshift.io/v1/consoleyamlsamples/{name}

Expand
표 9.6. 글로벌 경로 매개변수
매개변수유형설명

name

string

ConsoleYAMLSample 이름

HTTP 방법
DELETE
설명
ConsoleYAMLSample 삭제
Expand
표 9.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

Expand
표 9.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ConsoleYAMLSample 읽기
Expand
표 9.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleYAMLSample 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ConsoleYAMLSample을 부분적으로 업데이트
Expand
표 9.10. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 9.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleYAMLSample 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ConsoleYAMLSample을 교체합니다.
Expand
표 9.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

Expand
표 9.13. 본문 매개변수
매개변수유형설명

body

ConsoleYAMLSample 스키마

 
Expand
표 9.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleYAMLSample 스키마

201 - 생성됨

ConsoleYAMLSample 스키마

401 - 무단

Legal Notice

Copyright © 2025 Red Hat

OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).

Modified versions must remove all Red Hat trademarks.

Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.

Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat