CSINode

CSINode 保留節點上所有已安裝 CSI 驅動程式的相關資訊。

apiVersion: storage.k8s.io/v1

import "k8s.io/api/storage/v1"

CSINode

CSINode 保留節點上所有已安裝 CSI 驅動程式的相關資訊。CSI 驅動程式不需要直接建立 CSINode 物件。只要它們使用 node-driver-registrar sidecar 容器，kubelet 就會自動為 CSI 驅動程式填入 CSINode 物件，作為 kubelet 外掛程式註冊的一部分。CSINode 的名稱與節點相同。如果物件遺失，表示節點上沒有可用的 CSI 驅動程式，或 Kubelet 版本太舊，以至於無法建立此物件。CSINode 具有指向對應節點物件的 OwnerReference。

  • apiVersion: storage.k8s.io/v1

  • kind: CSINode

  • metadata (ObjectMeta)

    標準物件的中繼資料。metadata.name 必須是 Kubernetes 節點名稱。

  • spec (CSINodeSpec), required

    spec 是 CSINode 的規格

CSINodeSpec

CSINodeSpec 保留節點上所有已安裝 CSI 驅動程式的規格相關資訊

  • drivers ([]CSINodeDriver), required

    Patch 策略：在鍵 name 上合併

    Map：在合併期間，將保留鍵名稱上的唯一值

    drivers 是節點上所有現有 CSI 驅動程式的資訊清單。如果清單中的所有驅動程式都已解除安裝，則可以為空。

    CSINodeDriver 保留節點上安裝的一個 CSI 驅動程式的規格相關資訊

    • drivers.name (string), required

      name 代表此物件參考的 CSI 驅動程式名稱。這必須是該驅動程式的 CSI GetPluginName() 呼叫所傳回的相同名稱。

    • drivers.nodeID (string), required

      從驅動程式的角度來看，節點的 nodeID。此欄位使 Kubernetes 能夠與節點命名法不同的儲存系統進行通訊。例如，Kubernetes 可能將給定節點稱為 "node1"，但儲存系統可能將同一個節點稱為 "nodeA"。當 Kubernetes 向儲存系統發出命令以將卷掛接到特定節點時，它可以使用此欄位使用儲存系統將理解的 ID 來參考節點名稱，例如 "nodeA" 而不是 "node1"。此欄位為必填。

    • drivers.allocatable (VolumeNodeResources)

      allocatable 代表節點上可供排程的磁碟區資源。此欄位為 Beta 版本。

      VolumeNodeResources 是一組用於排程磁碟區的資源限制。

      • drivers.allocatable.count (int32)

        count 指出 CSI 驅動程式管理的單一磁碟區可在節點上使用的最大數量。一個已連接且已掛載在節點上的磁碟區視為使用一次，而非兩次。相同的規則適用於在同一節點上多個 Pod 之間共享的單一磁碟區。如果未指定此欄位，則此節點上支援的磁碟區數量不受限制。

    • drivers.topologyKeys ([]string)

      Atomic: 將在合併期間被取代

      topologyKeys 是驅動程式支援的鍵列表。當驅動程式在叢集上初始化時，它會提供一組它能理解的拓撲鍵 (例如 "company.com/zone", "company.com/region")。當驅動程式在節點上初始化時，它會提供相同的拓撲鍵以及值。Kubelet 會將這些拓撲鍵作為標籤公開在其自身的節點物件上。當 Kubernetes 進行拓撲感知佈建時，它可以使用此列表來決定應該從節點物件檢索哪些標籤並傳遞回驅動程式。不同的節點可以使用不同的拓撲鍵。如果驅動程式不支援拓撲，則可以為空。

CSINodeList

CSINodeList 是 CSINode 物件的集合。

Operations

get 讀取指定的 CSINode

HTTP Request

GET /apis/storage.k8s.io/v1/csinodes/{name}

Parameters

  • name (在路徑中): string, 必填

    CSINode 的名稱

  • pretty (在查詢中): string

    pretty

Response

200 (CSINode): OK

401: Unauthorized

list 列出或監看 CSINode 類型的物件

HTTP Request

GET /apis/storage.k8s.io/v1/csinodes

Parameters

Response

200 (CSINodeList): OK

401: Unauthorized

create 建立 CSINode

HTTP Request

POST /apis/storage.k8s.io/v1/csinodes

Parameters

Response

200 (CSINode): OK

201 (CSINode): Created

202 (CSINode): Accepted

401: Unauthorized

update 取代指定的 CSINode

HTTP Request

PUT /apis/storage.k8s.io/v1/csinodes/{name}

Parameters

  • name (在路徑中): string, 必填

    CSINode 的名稱

  • body: CSINode, 必填

  • dryRun (在查詢中): string

    dryRun

  • fieldManager (在查詢中): string

    fieldManager

  • fieldValidation (在查詢中): string

    fieldValidation

  • pretty (在查詢中): string

    pretty

Response

200 (CSINode): OK

201 (CSINode): Created

401: Unauthorized

patch 部分更新指定的 CSINode

HTTP Request

PATCH /apis/storage.k8s.io/v1/csinodes/{name}

Parameters

  • name (在路徑中): string, 必填

    CSINode 的名稱

  • body: Patch, 必填

  • dryRun (在查詢中): string

    dryRun

  • fieldManager (在查詢中): string

    fieldManager

  • fieldValidation (在查詢中): string

    fieldValidation

  • force (在查詢中): boolean

    force

  • pretty (在查詢中): string

    pretty

Response

200 (CSINode): OK

201 (CSINode): Created

401: Unauthorized

delete 刪除 CSINode

HTTP Request

DELETE /apis/storage.k8s.io/v1/csinodes/{name}

Parameters

Response

200 (CSINode): OK

202 (CSINode): Accepted

401: Unauthorized

deletecollection 刪除 CSINode 集合

HTTP Request

DELETE /apis/storage.k8s.io/v1/csinodes

Parameters

Response

200 (Status): OK

401: Unauthorized

此頁面為自動產生。

如果您計劃回報此頁面的問題，請在您的問題描述中提及此頁面為自動產生。修復可能需要在 Kubernetes 專案的其他地方進行。

Last modified August 28, 2024 at 6:01 PM PST: Update generated API reference for v1.31 (8ba98c79c1)