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

annotations

object (string)

アノテーションは、任意のメタデータを保存し、取得するために外部ツールで設定できる、リソースとともに保存される構造化されていないキー値のマップです。これらはクエリーできないため、オブジェクトを変更する場合に維持する必要があります。詳細: http://kubernetes.io/docs/user-guide/annotations

creationTimestamp

Time

CreationTimestamp は、このオブジェクトが作成された時のサーバー時間を表すタイムスタンプです。別々の操作をまたいで、happens-before の順序が設定されることは保証されていません。クライアントはこの値を設定できません。これは RFC3339 形式で表されます。これは UTC です。

システムによって入力されます。read-onlyリストの場合は Null。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。

deletionGracePeriodSeconds

integer

このオブジェクトがシステムから削除される前に、正常に終了するのに許可された秒数。deletionTimestamp も設定されている場合にのみ設定されます。短縮のみ可能です。read-only

deletionTimestamp

Time

deletionTimestamp は、このリソースが削除される RFC 3339 の日時です。このフィールドは、ユーザーが適切な削除を要求したときにサーバーによって設定され、クライアントが直接設定することはできません。ファイナライザーリストが空になり、このフィールドの時間が経過すると、リソースは削除される (リソースリストからは表示されなくなり、名前で到達できなくなる) ことが想定されます。ファイナライザーリストにアイテムが含まれている限り、削除はブロックされます。deletionTimestamp が設定された後は、短縮したり、この時間の前にリソースを削除したりすることはできますが、この値を設定または設定解除することはできなくなります。たとえば、ユーザーは Pod を 30 秒で削除するように要求できます。Kubelet は、正常な終了シグナルを Pod のコンテナーに送信して反応します。その 30 秒後、Kubelet はハードターミネーションシグナル (SIGKILL) をコンテナーに送信し、クリーンアップ後、API から Pod を削除します。ネットワークパーティションが存在する場合、このオブジェクトは、管理者または自動化されたプロセスがリソースの完全終了を判断できるまで、このタイムスタンプの後も存在する可能性があります。設定されていない場合、オブジェクトの正常な削除は要求されていません。

正常な削除が要求されたときにシステムによって入力されます。read-only詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。

finalizers

array (string)

オブジェクトをレジストリーから削除する前に、空にする必要があります。各エントリーは、リストからエントリーを削除する責任のあるコンポーネントの識別子です。オブジェクトの deletionTimestamp が nil ではない場合、このリストのエントリーのみを削除できます。ファイナライザーは任意の順序で処理および削除できます。ファイナライザーのスタックに大きなリスクが発生するため、順序は強制されません。ファイナライザーは共有フィールドであり、パーミッションを持つすべてのアクターが並べ替えることができます。ファイナライザーリストが順番に処理されると、リストの最初のファイナライザーを担当するコンポーネントが、リストの後半にあるファイナライザーによるシグナル生成を待つという状況が引き起こされ、その結果としてデッドロックが発生します。強制的な順序付けが行われない場合、ファイナライザーはリスト内で自由に並べ替えることができ、並べ替えに対する脆弱性はありません。

generateName

string

generateName は、Name フィールドが指定されていない場合に限り一意の名前を生成するためにサーバーが使用するオプションの接頭辞です。このフィールドを使用する場合、クライアントに返される名前は渡された名前とは異なります。この値は、一意の接尾辞とも組み合わされます。提供された値には、名前フィールドと同じ検証ルールがあり、サーバー上で値を一意にするために必要な接尾辞の長さで切り捨てられる場合があります。

このフィールドが指定されており、生成された名前が存在する場合、サーバーは 409 を返します。

Name が指定されていない場合にのみ適用されます。詳細: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency

generation

integer

目的の状態の特定の生成を表すシーケンス番号。システムによって入力されます。read-only

labels

object (string)

オブジェクトの整理と分類 (スコープと選択) に使用できる文字列キーと値のマップ。レプリケーションコントローラーおよびサービスのセレクターと一致する場合があります。詳細: http://kubernetes.io/docs/user-guide/labels

managedFields

array (ManagedFieldsEntry)

managedFields は workflow-id および version を、そのワークフローが管理するフィールドセットにマッピングします。これは主に内部のハウスキーピング用であり、ユーザーは通常、このフィールドを設定または理解する必要はありません。ワークフローは、ユーザーの名前、コントローラーの名前、または "ci-cd" などの特定の適用パスの名前にすることができます。フィールドセットは、常にオブジェクトを変更するときにワークフローが使用したバージョンにあります。

name

string

name は namespace 内で一意である必要があります。リソースの作成時に必要ですが、リソースによっては、クライアントが適切な名前の生成を自動的に要求することを許可する場合があります。name は、主にべき等性と設定定義の作成を目的としています。更新はできません。詳細: http://kubernetes.io/docs/user-guide/identifiers#names

namespace

string

namespace は、各名前が一意である必要があるスペースを定義します。空の namespace は "default" の namespace と同じですが、"default" は正規表現です。すべてのオブジェクトを namespace のスコープに設定する必要はありません。それらのオブジェクトでは、このフィールドの値は空になります。

DNS_LABEL である必要があります。更新はできません。詳細: http://kubernetes.io/docs/user-guide/namespaces

ownerReferences

Array (OwnerReference)'

このオブジェクトが依存するオブジェクトのリスト。リスト内のすべてのオブジェクトが削除されている場合、このオブジェクトはガベージコレクションされます。このオブジェクトがコントローラーによって管理されている場合、このリストのエントリーは、コントローラーフィールドが true に設定されたこのコントローラーを指します。複数の管理コントローラーが存在することはできません。

resourceVersion

string

オブジェクトが変更されたタイミングを判別するためにクライアントが使用できる、このオブジェクトの内部バージョンを表す不透明な値です。楽観的な並行処理、変更検出、およびリソースまたはリソースのセットに対する監視操作に使用できます。クライアントはこれらの値を不透明として処理し、変更せずにサーバーに戻す必要があります。これらは、特定のリソースまたはリソースセットでのみ有効です。

システムによって入力されます。read-only値は、クライアントによって不透明として扱われる必要があります。詳細: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

selfLink

string

非推奨: selfLink は従来の読み取り専用フィールドであり、システムによって入力されなくなりました。

uid

string

UID は、このオブジェクトの時間およびスペースで一意の値です。これは通常、リソースの作成が成功したときにサーバーによって生成され、PUT 操作で変更することはできません。

システムによって入力されます。read-only詳細: http://kubernetes.io/docs/user-guide/identifiers#uids