1.131. io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta_v2 schema
- 설명
- ObjectMeta는 모든 지속된 리소스가 있어야 하는 메타데이터로, 모든 오브젝트 사용자가 생성해야 합니다.
- 유형
-
object
스키마
속성 | 유형 | 설명 |
---|---|---|
|
| 주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations |
| creationTimestamp는 이 개체가 생성된 서버 시간을 나타내는 타임스탬프입니다. 별도의 작업에 대해 수행 순서에 따라 설정되는 것은 보장되지 않습니다. 고객은 이 값을 설정할 수 없습니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다. 시스템에 의해 채워집니다. 읽기 전용입니다. 목록에 null입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| 이 오브젝트가 시스템에서 제거되기 전에 정상적으로 종료되는 데 허용되는 시간(초)입니다. deletionTimestamp도 설정된 경우에만 설정됩니다. 단축할 수 있습니다. 읽기 전용입니다. |
| DeletionTimestamp는 이 리소스가 삭제될 RFC 3339 날짜 및 시간입니다. 이 필드는 사용자가 정상 삭제를 요청할 때 서버에서 설정하며 클라이언트에서 직접 설정할 수 없습니다. 종료자 목록이 비어 있으면 이 필드의 시간 후에 리소스가 삭제되어야 합니다(리소스 목록에서 더 이상 표시되지 않고 이름으로 연결할 수 없음). 종료자 목록에 항목이 포함된 경우 삭제가 차단됩니다. deletionTimestamp가 설정되면 이 값은 설정되지 않거나 나중에 더 이상 설정되지 않을 수 있지만 이 값은 단축되거나 이 시간 이전에 리소스가 삭제될 수 있습니다. 예를 들어 사용자는 Pod를 30초 내에 삭제하도록 요청할 수 있습니다. Kubelet은 Pod의 컨테이너에 정상 종료 신호를 전송하여 반응합니다. 30초 후에 Kubelet은 하드 종료 신호(SIGKILL)를 컨테이너에 전송하고 정리 후 API에서 Pod를 제거합니다. 네트워크 파티션이 있는 경우 관리자 또는 자동화된 프로세스에서 리소스가 완전히 종료될 때까지 이 타임스탬프 후에도 이 오브젝트가 계속 존재할 수 있습니다. 설정되지 않은 경우 오브젝트 삭제가 요청되지 않았습니다. 정상적인 삭제가 요청되면 시스템에 의해 채워집니다. 읽기 전용입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| 레지스트리에서 오브젝트를 삭제하기 전에 비어 있어야 합니다. 각 항목은 목록에서 항목을 제거할 책임이 있는 구성 요소의 식별자입니다. 오브젝트의 deletionTimestamp가 nil이 아닌 경우 이 목록의 항목을 제거할 수 있습니다. 종료자는 순서에 따라 처리 및 제거할 수 있습니다. 종료자의 상당한 위험이 발생하므로 순서가 적용되지 않습니다. 종료자는 공유 필드이며 권한이 있는 모든 작업자는 순서를 다시 정렬할 수 있습니다. 종료자 목록이 순서대로 처리되면 목록의 첫 번째 종료자를 담당하는 구성 요소가 나중에 목록의 종료자를 담당하는 구성 요소에 의해 생성되는 신호(필드 값, 외부 시스템 또는 기타)를 기다리는 상황이 발생할 수 있습니다. 강제 주문 종료자가 없으면 자체에서 자유롭게 주문할 수 있으며 목록의 변경 사항을 정렬하는 데 취약하지 않습니다. |
|
| generateName은 서버에서 사용하는 선택적 접두사로, Name 필드가 제공되지 않은 고유한 이름만 생성하는 데 사용됩니다. 이 필드를 사용하면 클라이언트에 반환되는 이름이 전달된 이름과 다릅니다. 이 값은 고유한 접미사와 결합됩니다. 제공된 값은 Name 필드와 동일한 검증 규칙을 가지며 서버에서 고유 값을 만드는 데 필요한 접미사 길이로 잘릴 수 있습니다. 이 필드가 지정되고 생성된 이름이 있으면 서버는 409를 반환합니다. Name이 지정되지 않은 경우에만 적용됩니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency |
|
| 원하는 상태의 특정 생성을 나타내는 시퀀스 번호입니다. 시스템에 의해 채워집니다. 읽기 전용입니다. |
|
| 개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels |
|
| managedFields는 workflow-id 및 version을 해당 워크플로우에서 관리하는 필드 집합에 매핑합니다. 이는 주로 내부 하우스키핑을 위한 것이며, 사용자는 일반적으로 이 필드를 설정하거나 이해할 필요가 없습니다. 워크플로는 사용자 이름, 컨트롤러 이름 또는 "ci-cd"와 같은 특정 적용 경로의 이름일 수 있습니다. 필드 세트는 항상 오브젝트를 수정할 때 사용된 워크플로우 버전에 있습니다. |
|
| 이름은 네임스페이스 내에서 고유해야 합니다. 일부 리소스는 클라이언트가 적절한 이름의 생성을 자동으로 요청할 수 있지만 리소스를 생성할 때 필요합니다. 이름은 주로 생성 멱등 및 구성 정의를 위한 것입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names |
|
| namespace는 각 이름을 고유해야 하는 공간을 정의합니다. 빈 네임스페이스는 "default" 네임스페이스와 동일하지만 "default"는 표준 표현입니다. 모든 오브젝트의 범위를 네임스페이스로 지정해야 하는 것은 아닙니다. 해당 오브젝트에 대한 이 필드의 값은 비어 있습니다. DNS_LABEL이어야 합니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces |
|
| 이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다. |
|
| 클라이언트에서 오브젝트가 변경된 시기를 결정하는 데 사용할 수 있는 이 오브젝트의 내부 버전을 나타내는 opaque 값입니다. 리소스 또는 리소스 집합의 최적화 동시성, 변경 감지 및 감시 작업에 사용할 수 있습니다. 클라이언트는 이러한 값을 opaque로 처리하고 수정되지 않은 서버를 다시 전달해야합니다. 특정 리소스 또는 리소스 집합에만 유효할 수 있습니다. 시스템에 의해 채워집니다. 읽기 전용입니다. 값은 클라이언트 및 에 의해 불투명으로 취급되어야 합니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
| 더 이상 사용되지 않음: selfLink는 시스템에서 더 이상 채워지지 않는 레거시 읽기 전용 필드입니다. |
|
| UID는 이 오브젝트의 시간 및 공간 값에서 고유합니다. 일반적으로 서버에서 리소스를 성공적으로 생성할 때 생성되며 PUT 작업에서는 변경할 수 없습니다. 시스템에 의해 채워집니다. 읽기 전용입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids |