4장. ConsoleLink [console.openshift.io/v1]
- 설명
ConsoleLink는 OpenShift 웹 콘솔 링크를 사용자 정의하는 확장 프로그램입니다.
호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.
- 유형
-
object - 필수 항목
-
spec
-
4.1. 사양 링크 복사링크가 클립보드에 복사되었습니다!
| 속성 | 유형 | 설명 |
|---|---|---|
|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| ConsoleLinkSpec은 원하는 콘솔 링크 구성입니다. |
4.1.1. .spec 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- ConsoleLinkSpec은 원하는 콘솔 링크 구성입니다.
- 유형
-
object - 필수 항목
-
href -
위치 -
text
-
| 속성 | 유형 | 설명 |
|---|---|---|
|
|
| ApplicationMenu는 애플리케이션 메뉴의 링크에 사용되는 섹션 및 아이콘에 대한 정보를 보유하고 있으며 위치가 ApplicationMenu로 설정된 경우에만 적용됩니다. |
|
|
| href는 링크의 절대 URL입니다. 웹 URL에는 https://를 사용하거나 이메일 링크에는 mailto를 사용해야 합니다. |
|
|
| location은 링크가 추가할 콘솔의 위치를 결정합니다(ApplicationMenu, HelpMenu, UserMenu, NamespaceDashboard). |
|
|
| NamespaceDashboard에는 대시보드 링크가 표시되어야 하는 네임스페이스에 대한 정보가 있으며, 위치가 NamespaceDashboard로 설정된 경우에만 적용할 수 있습니다. 지정하지 않으면 모든 네임스페이스에 링크가 표시됩니다. |
|
|
| 텍스트는 링크의 표시 텍스트입니다. |
4.1.3. .spec.namespaceDashboard 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- NamespaceDashboard에는 대시보드 링크가 표시되어야 하는 네임스페이스에 대한 정보가 있으며, 위치가 NamespaceDashboard로 설정된 경우에만 적용할 수 있습니다. 지정하지 않으면 모든 네임스페이스에 링크가 표시됩니다.
- 유형
-
object
| 속성 | 유형 | 설명 |
|---|---|---|
|
|
| namespaceSelector는 레이블별로 대시보드 링크를 포함해야 하는 네임스페이스를 선택하는 데 사용됩니다. 네임스페이스 라벨이 일치하면 네임스페이스에 대한 대시보드 링크가 표시됩니다. |
|
|
| 네임스페이스는 대시보드 링크가 표시되어야 하는 네임스페이스 이름 배열입니다. |
4.1.4. .spec.namespaceDashboard.namespaceSelector 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- namespaceSelector는 레이블별로 대시보드 링크를 포함해야 하는 네임스페이스를 선택하는 데 사용됩니다. 네임스페이스 라벨이 일치하면 네임스페이스에 대한 대시보드 링크가 표시됩니다.
- 유형
-
object
| 속성 | 유형 | 설명 |
|---|---|---|
|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
|
| matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다. |
4.1.5. .spec.namespaceDashboard.namespaceSelector.matchExpressions 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
- 유형
-
array
4.1.6. .spec.namespaceDashboard.namespaceSelector.matchExpressions[] 링크 복사링크가 클립보드에 복사되었습니다!
- 설명
- 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object - 필수 항목
-
key -
operator
-
| 속성 | 유형 | 설명 |
|---|---|---|
|
|
| key는 선택기가 적용되는 라벨 키입니다. |
|
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
4.2. API 끝점 링크 복사링크가 클립보드에 복사되었습니다!
다음 API 끝점을 사용할 수 있습니다.
/apis/console.openshift.io/v1/consolelinks-
DELETE: ConsoleLink의 컬렉션 삭제 -
GET: 종류의 ConsoleLink의 오브젝트 나열 -
POST: ConsoleLink 생성
-
/apis/console.openshift.io/v1/consolelinks/{name}-
DELETE: ConsoleLink 삭제 -
GET: 지정된 ConsoleLink 읽기 -
PATCH: 지정된 ConsoleLink를 부분적으로 업데이트 -
PUT: 지정된 ConsoleLink를 교체합니다.
-
/apis/console.openshift.io/v1/consolelinks/{name}/status-
GET: 지정된 ConsoleLink의 읽기 상태 -
PATCH: 지정된 ConsoleLink의 부분 업데이트 상태 -
PUT: 지정된 ConsoleLink의 상태
-
4.2.1. /apis/console.openshift.io/v1/consolelinks 링크 복사링크가 클립보드에 복사되었습니다!
- HTTP 방법
-
DELETE - 설명
- ConsoleLink 컬렉션 삭제
| HTTP 코드 | 리포지토리 본문 |
|---|---|
| 200 - OK |
|
| 401 - 무단 | Empty |
- HTTP 방법
-
GET - 설명
- ConsoleLink 유형의 오브젝트 나열
| HTTP 코드 | 리포지토리 본문 |
|---|---|
| 200 - OK |
|
| 401 - 무단 | Empty |
- HTTP 방법
-
POST - 설명
- 콘솔 링크 만들기
| 매개변수 | 유형 | 설명 |
|---|---|---|
|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다. |
|
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
| 매개변수 | 유형 | 설명 |
|---|---|---|
|
|
|
| HTTP 코드 | 리포지토리 본문 |
|---|---|
| 200 - OK |
|
| 201 - 생성됨 |
|
| 202 - 승인됨 |
|
| 401 - 무단 | Empty |
4.2.2. /apis/console.openshift.io/v1/consolelinks/{name} 링크 복사링크가 클립보드에 복사되었습니다!
| 매개변수 | 유형 | 설명 |
|---|---|---|
|
|
| ConsoleLink 이름 |
- HTTP 방법
-
DELETE - 설명
- 콘솔 링크 삭제
| 매개변수 | 유형 | 설명 |
|---|---|---|
|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다. |
- HTTP 방법
-
GET - 설명
- 지정된 ConsoleLink 읽기
| HTTP 코드 | 리포지토리 본문 |
|---|---|
| 200 - OK |
|
| 401 - 무단 | Empty |
- HTTP 방법
-
PATCH - 설명
- 지정된 ConsoleLink를 부분적으로 업데이트
| 매개변수 | 유형 | 설명 |
|---|---|---|
|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다. |
|
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
| HTTP 코드 | 리포지토리 본문 |
|---|---|
| 200 - OK |
|
| 401 - 무단 | Empty |
- HTTP 방법
-
PUT - 설명
- 지정된 ConsoleLink를 교체
| 매개변수 | 유형 | 설명 |
|---|---|---|
|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다. |
|
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
| 매개변수 | 유형 | 설명 |
|---|---|---|
|
|
|
| HTTP 코드 | 리포지토리 본문 |
|---|---|
| 200 - OK |
|
| 201 - 생성됨 |
|
| 401 - 무단 | Empty |
4.2.3. /apis/console.openshift.io/v1/consolelinks/{name}/status 링크 복사링크가 클립보드에 복사되었습니다!
| 매개변수 | 유형 | 설명 |
|---|---|---|
|
|
| ConsoleLink 이름 |
- HTTP 방법
-
GET - 설명
- 지정된 ConsoleLink의 상태 보기
| HTTP 코드 | 리포지토리 본문 |
|---|---|
| 200 - OK |
|
| 401 - 무단 | Empty |
- HTTP 방법
-
PATCH - 설명
- 지정된 ConsoleLink의 상태를 부분적으로 업데이트
| 매개변수 | 유형 | 설명 |
|---|---|---|
|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다. |
|
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
| HTTP 코드 | 리포지토리 본문 |
|---|---|
| 200 - OK |
|
| 401 - 무단 | Empty |
- HTTP 방법
-
PUT - 설명
- 지정된 ConsoleLink의 상태 교체
| 매개변수 | 유형 | 설명 |
|---|---|---|
|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다. |
|
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
| 매개변수 | 유형 | 설명 |
|---|---|---|
|
|
|
| HTTP 코드 | 리포지토리 본문 |
|---|---|
| 200 - OK |
|
| 201 - 생성됨 |
|
| 401 - 무단 | Empty |