1.119. io.k8s.apiextensions-apiserver.pkg.apis.apiextensions.v1.JSONSchemaProps schema

$ref

string

$schema

string

additionalItems

``

additionalProperties

``

allOf

배열(정의되지 않음)

anyOf

배열(정의되지 않음)

default

JSON

기본값은 정의되지 않은 오브젝트 필드의 기본값입니다. 기본값은 CustomResourceDefaulting 기능 게이트 아래의 베타 기능입니다. Defaulting을 사용하려면 spec.preserveUnknownFields가 false여야 합니다.

정의

개체(정의되지 않음)

종속 항목

개체(정의되지 않음)

description

string

enum

배열(JSON)

예

JSON

exclusiveMaximum

boolean

exclusiveMinimum

boolean

externalDocs

External설명서

형식

string

format은 OpenAPI v3 형식 문자열입니다. 알 수 없는 형식은 무시됩니다. 다음 형식을 검증합니다.

- bsonobjectid: a bson object ID, i.e. 24 characters hex string - uri: an URI as parsed by Golang net/url.ParseRequestURI - email: an email address as parsed by Golang net/mail.ParseAddress - hostname: a valid representation for an Internet host name, as defined by RFC 1034, 섹션 3.1 [RFC1034]. - ipv4: Golang net.ParseIP에서 구문 분석한 IPv4 IP - Golang net.ParseIP - cidr: Golang net.ParseIP - cidr: Golang net.ParseCIDR - mac: Golang net.ParseMAC -uuid에서 구문 분석한 MAC 주소: regex(?i)^[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-로 정의된 대문자를 허용하는 UUID입니다. [0-9a-f]{12} - uuid3: regex(?i)^[0-9a-f]{8}-?[0-9a-f]{4}-?3[0-9a-f]{3}-?[0-9a-f]{4}-로 정의된 대문자를 허용하는 UUID3입니다. [0-9a-f]{12} - uuid4: regex (?i)^[0-9a-f]{8}-?[0-9a-f]{4}-?4[0-9a-f]{3}-{3}-?[0-9a-f]{3} - [0-9a-f]{3}-로 정의된 대문자를 허용하는 UUID4 - uuid5: regex (?i)^[0-9a-f]{8}-?[0-9a-f]{4}-?5[0-9a-f]{3}-?[89ab][0-9a-f]{3} - [0-9a-f]{3}-로 정의된 대문자를 허용하는 UUID5 - ISBN10 또는 "0321751043" 또는 "978-0321751041"과 같은 ISBN13 번호 문자열 - isbn10: "0321751043"과 같은 ISBN10 번호 문자열 - isbn13: "978-0321751041"과 같은 ISBN13 번호 문자열 -GCMcard: regex ^(?:4[0-9]{12}(?:[0-9]{3})?|5[1-5][0-9]{14}|6(?:011|5[0-9][0-9])[0-9]{12}|3 [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9]] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9]] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9]] [0-9] [0-9] [0-9]] [0-9] [0-9]] [0-9] [0-9] [0-9] [0-9] [0-9] [0-9]] [0-9] [0-9]] [0-9]] [0-9]] [0-9 비 숫자 문자가 혼합되어 있는 경우 - ssn: regex ^{3}[- ]?\d{2}[- ]?\d{2}[- ]?\d{4}$\d{4}$ - 16진수 색상: regex ^ ^ (0-9a-fA-F]\3]{3]\f}\f}\f}\f} 뒤에 있는 16진수 색상 코드 -rgb color: "rgb(255)와 같은rgb 색상 코드 255,2559" - 바이트: base64로 인코딩된 바이너리 데이터 - 암호: 모든 종류의 문자열 - date: RFC3339에서 정의한 "2006-01-02"와 같은 날짜: Golang time.ParseDuration 또는 Scala 기간 형식과 호환되는 "22 ns"와 같은 기간 문자열 - datetime: "2014-12-15T:19:20"와 같은 날짜 문자열

id

string

items

``

maxItems

integer

maxLength

integer

maxProperties

integer

maximum

number

minItems

integer

minLength

integer

minProperties

integer

최소

number

multipleOf

number

해당 없음

``

Cryostat

boolean

oneof

배열(정의되지 않음)

패턴

string

patternProperties

개체(정의되지 않음)

속성

개체(정의되지 않음)

필수 항목

배열(문자열)

title

string

type

string

uniqueItems

boolean

x-kubernetes-embedded-resource

boolean

x-kubernetes-embedded-resource는 값이 TypeMeta 및 ObjectMeta를 사용하여 포함된 Kubernetes runtime.Object임을 정의합니다. 유형은 object여야 합니다. 포함된 오브젝트를 추가로 제한할 수 있습니다. kind, apiVersion 및 metadata는 자동으로 검증됩니다. x-kubernetes-preserve-unknown-fields는 true가 될 수 있지만 오브젝트가 완전히 지정되면 안 됩니다( kind, apiVersion, metadata).

x-kubernetes-int-or-string

boolean

x-kubernetes-int-or-string은 이 값이 정수 또는 문자열임을 지정합니다. 이 값이 true인 경우 빈 유형이 허용되며 다음 패턴 중 하나를 따르는 경우 anyOf의 자식으로 유형이 허용됩니다.

1) anyOf: - type: integer - type: string 2) allOf: - anyOf: - type: integer - type: string: …​0 이상

x-kubernetes-list-map-keys

배열(문자열)

x-kubernetes-list-map-keys는 맵의 인덱스로 사용되는 키를 지정하여 x-kubernetes-list-type 맵 으로 배열에 주석을 추가합니다.

이 태그는 "x-kubernetes-list-type" 확장이 "map"으로 설정된 목록에만 사용해야 합니다. 또한 이 속성에 지정된 값은 하위 구조의 스칼라 형식 필드여야 합니다(스케스트링이 지원되지 않음).

모든 목록 항목에 대해 해당 속성이 있는지 확인하려면 지정된 속성이 필수이거나 기본값이 있어야 합니다.

x-kubernetes-list-type

string

x-kubernetes-list-type은 토폴로지를 추가로 설명하기 위해 배열에 주석을 추가합니다. 이 확장은 목록에서만 사용해야 하며 3개의 가능한 값이 있을 수 있습니다.

1) Atomic: 목록은 스칼라와 같은 단일 엔티티로 취급됩니다. Atomic 목록은 업데이트 시 완전히 교체됩니다. 이 확장은 모든 유형의 목록(struct, scalar, …​)에서 사용할 수 있습니다. 2) set: Sets는 동일한 값을 가진 여러 항목이 없어야 하는 목록입니다. 각 값은 스칼라, x-kubernetes-map-type atomic 이 있는 오브젝트 또는 x-kubernetes-list-type atomic 이 있는 배열이어야 합니다. 3) 지도: 이 목록은 해당 요소를 식별하는 데 사용되는 인덱스 이외의 키가 있다는 점에서 맵과 같습니다. 병합 시 순서가 유지됩니다. map 태그는 type object 요소가 있는 목록에서만 사용해야 합니다. 기본값은 배열의 atomic입니다.

x-kubernetes-map-type

string

x-kubernetes-map-type은 토폴로지를 추가로 설명하기 위해 오브젝트에 주석을 추가합니다. 이 확장은 type이 object이고 두 가지 가능한 값을 가질 수 있는 경우에만 사용해야 합니다.

1) 세분화된: 이 맵은 실제 맵(키-값 쌍)이며 각 필드는 서로 독립적입니다(각각마다 별도의 행위자에 의해 조작될 수 있음). 이는 모든 맵의 기본 동작입니다. 2) Atomic: 목록은 스칼라와 같은 단일 엔티티로 처리됩니다. 업데이트 시 Atomic 맵이 완전히 교체됩니다.

x-kubernetes-preserve-unknown-fields

boolean

x-kubernetes-preserve-unknown-fields는 검증 스키마에 지정되지 않은 정리 필드에서 API 서버 디코딩 단계를 중지합니다. 이는 필드를 재귀적으로 영향을 주지만 스키마에 중첩된 속성 또는 추가 속성이 지정된 경우 일반 정리 동작으로 다시 전환합니다. 이는 true 또는 undefined일 수 있습니다. false는 허용되지 않습니다.

x-kubernetes-validations

배열(ValidationRule)

x-kubernetes-validations는 CEL 표현식 언어로 작성된 검증 규칙 목록을 설명합니다. 이 필드는 알파 수준입니다. 이 필드를 사용하려면 기능 게이트 CustomResourceValidationExpressions 를 활성화해야 합니다.