1.130. io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta schema


설명
ObjectMeta는 모든 지속된 리소스가 있어야 하는 메타데이터로, 모든 오브젝트 사용자가 생성해야 합니다.
유형
object

스키마

속성유형설명

annotations

오브젝트(문자열)

주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations

creationTimestamp

시간

creationTimestamp는 이 개체가 생성된 서버 시간을 나타내는 타임스탬프입니다. 별도의 작업에 대해 수행 순서에 따라 설정되는 것은 보장되지 않습니다. 고객은 이 값을 설정할 수 없습니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다.

시스템에 의해 채워집니다. 읽기 전용입니다. 목록에 null입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

deletionGracePeriodSeconds

integer

이 오브젝트가 시스템에서 제거되기 전에 정상적으로 종료되는 데 허용되는 시간(초)입니다. deletionTimestamp도 설정된 경우에만 설정됩니다. 단축할 수 있습니다. 읽기 전용입니다.

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

string

generateName은 서버에서 사용하는 선택적 접두사로, Name 필드가 제공되지 않은 고유한 이름만 생성하는 데 사용됩니다. 이 필드를 사용하면 클라이언트에 반환되는 이름이 전달된 이름과 다릅니다. 이 값은 고유한 접미사와 결합됩니다. 제공된 값은 Name 필드와 동일한 검증 규칙을 가지며 서버에서 고유 값을 만드는 데 필요한 접미사 길이로 잘릴 수 있습니다.

이 필드가 지정되고 생성된 이름이 있으면 서버는 409를 반환합니다.

Name이 지정되지 않은 경우에만 적용됩니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency

생성

integer

원하는 상태의 특정 생성을 나타내는 시퀀스 번호입니다. 시스템에 의해 채워집니다. 읽기 전용입니다.

labels

오브젝트(문자열)

개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels

managedFields

array (ManagedFieldsEntry)

managedFields는 workflow-id 및 version을 해당 워크플로우에서 관리하는 필드 집합에 매핑합니다. 이는 주로 내부 하우스키핑을 위한 것이며, 사용자는 일반적으로 이 필드를 설정하거나 이해할 필요가 없습니다. 워크플로는 사용자 이름, 컨트롤러 이름 또는 "ci-cd"와 같은 특정 적용 경로의 이름일 수 있습니다. 필드 세트는 항상 오브젝트를 수정할 때 사용된 워크플로우 버전에 있습니다.

name

string

이름은 네임스페이스 내에서 고유해야 합니다. 일부 리소스는 클라이언트가 적절한 이름의 생성을 자동으로 요청할 수 있지만 리소스를 생성할 때 필요합니다. 이름은 주로 생성 멱등 및 구성 정의를 위한 것입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names

네임스페이스

string

namespace는 각 이름을 고유해야 하는 공간을 정의합니다. 빈 네임스페이스는 "default" 네임스페이스와 동일하지만 "default"는 표준 표현입니다. 모든 오브젝트의 범위를 네임스페이스로 지정해야 하는 것은 아닙니다. 해당 오브젝트에 대한 이 필드의 값은 비어 있습니다.

DNS_LABEL이어야 합니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces

OwnerReferences

배열(OwnerReference)

이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.

resourceVersion

string

클라이언트에서 오브젝트가 변경된 시기를 결정하는 데 사용할 수 있는 이 오브젝트의 내부 버전을 나타내는 opaque 값입니다. 리소스 또는 리소스 집합의 최적화 동시성, 변경 감지 및 감시 작업에 사용할 수 있습니다. 클라이언트는 이러한 값을 opaque로 처리하고 수정되지 않은 서버를 다시 전달해야합니다. 특정 리소스 또는 리소스 집합에만 유효할 수 있습니다.

시스템에 의해 채워집니다. 읽기 전용입니다. 값은 클라이언트 및 에 의해 불투명으로 취급되어야 합니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

selfLink

string

더 이상 사용되지 않음: selfLink는 시스템에서 더 이상 채워지지 않는 레거시 읽기 전용 필드입니다.

uid

string

UID는 이 오브젝트의 시간 및 공간 값에서 고유합니다. 일반적으로 서버에서 리소스를 성공적으로 생성할 때 생성되며 PUT 작업에서는 변경할 수 없습니다.

시스템에 의해 채워집니다. 읽기 전용입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

© 2024 Red Hat, Inc.