목록 메타데이터
목록 메타데이터 (ListMeta)
이 페이지는 목록 및 다양한 상태 객체와 같은 인공(synthetic) 리소스가 반드시 가져야 하는 메타데이터를 담는 ListMeta 타입을 설명해요. 리소스 버전, 계속 토큰, 남은 항목 수 등을 나타내는 구조체랍니다.
본문
ListMeta는 목록과 다양한 상태 객체를 포함한 인공 리소스가 반드시 가져야 하는 메타데이터를 설명합니다. 리소스는 {ObjectMeta, ListMeta} 중 하나만 가질 수 있습니다.
apiVersion: meta/v1
import "k8s.io/apimachinery/pkg/apis/meta/v1"
ListMeta
ListMeta는 목록과 다양한 상태 객체를 포함한 인공 리소스가 반드시 가져야 하는 메타데이터를 설명합니다. 리소스는 {ObjectMeta, ListMeta} 중 하나만 가질 수 있습니다.
| Field | Description |
|---|---|
continue |
|
| string | continue는 사용자가 반환된 항목 수에 제한(limit)을 설정했고 서버에 더 많은 데이터가 있음을 나타내는 경우 설정될 수 있습니다. 값은 불투명하며, 이 목록을 제공한 엔드포인트에 다른 요청을 보내 다음 사용 가능한 객체 집합을 검색하는 데 사용될 수 있습니다. 서버 구성이 변경되었거나 몇 분 이상 경과한 경우 일관된 목록을 계속하는 것이 불가능할 수 있습니다. 이 continue 값을 사용할 때 반환되는 resourceVersion 필드는 첫 번째 응답의 값과 동일합니다. 단, 이 토큰을 오류 메시지에서 받은 경우는 예외입니다. |
remainingItemCount |
|
| integer | remainingItemCount는 이 목록 응답에 포함되지 않은 목록의 후속 항목 수입니다. 목록 요청에 라벨 또는 필드 셀렉터가 포함된 경우 남은 항목 수는 알 수 없으며 필드는 설정되지 않은 채 직렬화 중에 생략됩니다. 목록이 완전한 경우(청킹하지 않거나 마지막 청크이기 때문에) 남은 항목이 없으며 이 필드는 설정되지 않은 채 직렬화 중에 생략됩니다. v1.15 이전의 서버는 이 필드를 설정하지 않습니다. remainingItemCount의 의도된 용도는 컬렉션의 크기를 추정하는 것입니다. 클라이언트는 remainingItemCount가 설정되거나 정확하다고 의존해서는 안 됩니다. |
resourceVersion |
|
| string | 클라이언트가 객체가 언제 변경되었는지 확인하는 데 사용할 수 있는 이 객체의 서버 내부 버전을 식별하는 문자열입니다. 값은 클라이언트가 불투명하게 취급하고 수정하지 않은 채 서버에 다시 전달해야 합니다. 시스템이 채웁니다. 읽기 전용입니다. 자세한 내용: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
selfLink |
|
| string | 사용되지 않음: selfLink는 더 이상 시스템이 채우지 않는 레거시 읽기 전용 필드입니다. |
shardInfo |
|
| ShardInfo | shardInfo는 목록이 요청의 샤드 셀렉터에 의해 선택된 전체 컬렉션의 필터링된 부분 집합일 때 설정됩니다. 클라이언트가 받은 샤드를 확인하고 샤드된 응답을 병합할 수 있도록 셀렉터를 다시 전달합니다. 클라이언트는 샤드된 목록 응답을 컬렉션의 전체 표현으로 캐시해서는 안 됩니다. 이것은 알파 필드이며 ShardedListAndWatch 기능 게이트를 활성화해야 합니다. |