HorizontalPodAutoscaler

HorizontalPodAutoscaler 是水平 Pod 自動擴展器的組態,它根據指定的指標自動管理實作 scale 子資源之任何資源的副本計數。

apiVersion: autoscaling/v2

import "k8s.io/api/autoscaling/v2"

HorizontalPodAutoscaler

HorizontalPodAutoscaler 是水平 Pod 自動擴展器的組態,它根據指定的指標自動管理實作 scale 子資源之任何資源的副本計數。


HorizontalPodAutoscalerSpec

HorizontalPodAutoscalerSpec 描述 HorizontalPodAutoscaler 的期望功能。


  • maxReplicas (int32),必要

    maxReplicas 是自動擴展器可以擴展到的副本數上限。它不能小於 minReplicas。

  • scaleTargetRef (CrossVersionObjectReference),必要

    scaleTargetRef 指向要擴展的目標資源,並用於應收集指標的 Pod,以及實際變更副本計數。

    CrossVersionObjectReference 包含足夠的資訊,可讓您識別參照的資源。

  • minReplicas (int32)

    minReplicas 是自動擴展器可以縮減到的副本數下限。它預設為 1 個 Pod。如果啟用 alpha 功能閘道 HPAScaleToZero,且至少配置一個 Object 或 External 指標,則允許 minReplicas 為 0。只要至少有一個指標值可用,擴展就會處於活動狀態。

  • behavior (HorizontalPodAutoscalerBehavior)

    behavior 配置目標在向上和向下方向 (分別為 scaleUp 和 scaleDown 欄位) 的擴展行為。如果未設定,則會使用向上和向下擴展的預設 HPAScalingRules。

    HorizontalPodAutoscalerBehavior 配置目標在向上和向下方向 (分別為 scaleUp 和 scaleDown 欄位) 的擴展行為。

    • behavior.scaleDown (HPAScalingRules)

      scaleDown 是向下擴展的擴展策略。如果未設定,則預設值是允許向下擴展到 minReplicas 個 Pod,並具有 300 秒的穩定視窗 (即,使用過去 300 秒的最高建議)。

      HPAScalingRules 配置一個方向的擴展行為。這些規則是在從 HPA 的指標計算 DesiredReplicas 之後套用。它們可以透過指定擴展策略來限制擴展速度。它們可以透過指定穩定視窗來防止抖動,以便不會立即設定副本數,而是從穩定視窗中選擇最安全的值。

      • behavior.scaleDown.policies ([]HPAScalingPolicy)

        Atomic: 將在合併期間被取代

        policies 是可在擴展期間使用的潛在擴展策略清單。必須至少指定一個策略,否則 HPAScalingRules 將被視為無效而丟棄

        HPAScalingPolicy 是一個單一策略,必須在指定的過去時間間隔內保持為真。

        • behavior.scaleDown.policies.type (string),必要

          type 用於指定擴展策略。

        • behavior.scaleDown.policies.value (int32),必要

          value 包含策略允許的變更量。它必須大於零

        • behavior.scaleDown.policies.periodSeconds (int32), 必填

          periodSeconds 指定此策略應保持有效的時間範圍。PeriodSeconds 必須大於零且小於或等於 1800(30 分鐘)。

      • behavior.scaleDown.selectPolicy (string)

        selectPolicy 用於指定應使用哪個策略。如果未設定,則預設值為 Max。

      • behavior.scaleDown.stabilizationWindowSeconds (int32)

        stabilizationWindowSeconds 是在擴增或縮減時,應考量過去建議的秒數。StabilizationWindowSeconds 必須大於或等於零且小於或等於 3600(一小時)。如果未設定,則使用預設值:- 針對擴增:0(即不進行穩定)。- 針對縮減:300(即穩定視窗為 300 秒)。

    • behavior.scaleUp (HPAScalingRules)

      scaleUp 是用於擴增的擴增策略。如果未設定,則預設值為以下兩者中的較高者:

      • 每 60 秒增加不超過 4 個 Pod
      • 每 60 秒將 Pod 數量加倍。不使用穩定機制。

      HPAScalingRules 配置一個方向的擴展行為。這些規則是在從 HPA 的指標計算 DesiredReplicas 之後套用。它們可以透過指定擴展策略來限制擴展速度。它們可以透過指定穩定視窗來防止抖動,以便不會立即設定副本數,而是從穩定視窗中選擇最安全的值。

      • behavior.scaleUp.policies ([]HPAScalingPolicy)

        Atomic: 將在合併期間被取代

        policies 是可在擴展期間使用的潛在擴展策略清單。必須至少指定一個策略,否則 HPAScalingRules 將被視為無效而丟棄

        HPAScalingPolicy 是一個單一策略,必須在指定的過去時間間隔內保持為真。

        • behavior.scaleUp.policies.type (string), 必填

          type 用於指定擴展策略。

        • behavior.scaleUp.policies.value (int32), 必填

          value 包含策略允許的變更量。它必須大於零

        • behavior.scaleUp.policies.periodSeconds (int32), 必填

          periodSeconds 指定此策略應保持有效的時間範圍。PeriodSeconds 必須大於零且小於或等於 1800(30 分鐘)。

      • behavior.scaleUp.selectPolicy (string)

        selectPolicy 用於指定應使用哪個策略。如果未設定,則預設值為 Max。

      • behavior.scaleUp.stabilizationWindowSeconds (int32)

        stabilizationWindowSeconds 是在擴增或縮減時,應考量過去建議的秒數。StabilizationWindowSeconds 必須大於或等於零且小於或等於 3600(一小時)。如果未設定,則使用預設值:- 針對擴增:0(即不進行穩定)。- 針對縮減:300(即穩定視窗為 300 秒)。

  • metrics ([]MetricSpec)

    Atomic: 將在合併期間被取代

    metrics 包含用於計算所需副本數的規格(將使用所有指標中的最大副本數)。所需副本數的計算方式為:目標值與當前值之間的比率乘以當前 Pod 數量。因此,使用的指標必須隨著 Pod 數量的增加而減少,反之亦然。請參閱個別的指標來源類型,以取得關於每種指標類型應如何回應的更多資訊。如果未設定,預設指標將設定為 80% 的平均 CPU 使用率。

    MetricSpec 指定如何基於單一指標進行擴充(一次只能設定 type 和另一個相符的欄位)。

    • metrics.type (string), 必填

      type 是指標來源的類型。它應該是 "ContainerResource"、"External"、"Object"、"Pods" 或 "Resource" 其中之一,每個都對應到物件中的一個相符欄位。注意:"ContainerResource" 類型僅在啟用 feature-gate HPAContainerMetrics 時可用

    • metrics.containerResource (ContainerResourceMetricSource)

      containerResource 指的是 Kubernetes 已知的資源指標(例如在 requests 和 limits 中指定的指標),用於描述目前擴充目標中每個 Pod 的單一容器(例如 CPU 或記憶體)。此類指標已內建於 Kubernetes 中,並且除了使用 "pods" 來源的正常每個 Pod 指標之外,還具有特殊的擴充選項。這是一個 Alpha 功能,可以透過 HPAContainerMetrics 功能閘道啟用。

      ContainerResourceMetricSource 指出如何基於 Kubernetes 已知的資源指標進行擴充,如 requests 和 limits 中所指定,用於描述目前擴充目標中每個 Pod(例如 CPU 或記憶體)。這些值在與目標值比較之前將會被平均。此類指標已內建於 Kubernetes 中,並且除了使用 "pods" 來源的正常每個 Pod 指標之外,還具有特殊的擴充選項。應僅設定一種 "target" 類型。

      • metrics.containerResource.container (string), 必填

        container 是擴充目標 Pod 中容器的名稱

      • metrics.containerResource.name (string), 必填

        name 是相關資源的名稱。

      • metrics.containerResource.target (MetricTarget), 必填

        target 指定給定指標的目標值

        MetricTarget 定義特定指標的目標值、平均值或平均使用率

        • metrics.containerResource.target.type (string), 必填

          type 表示指標類型是 Utilization、Value 還是 AverageValue

        • metrics.containerResource.target.averageUtilization (int32)

          averageUtilization 是所有相關 Pod 中資源指標平均值的目標值,表示為 Pod 資源請求值的百分比。目前僅對 Resource 指標來源類型有效

        • metrics.containerResource.target.averageValue (Quantity)

          averageValue 是所有相關 Pod 中指標平均值的目標值(以數量表示)

        • metrics.containerResource.target.value (Quantity)

          value 是指標的目標值(以數量表示)。

    • metrics.external (ExternalMetricSource)

      external 指的是與任何 Kubernetes 物件無關的全域指標。它允許基於來自叢集外部運行的元件的資訊進行自動擴充(例如雲端訊息服務中的佇列長度,或來自叢集外部運行的負載平衡器的 QPS)。

      ExternalMetricSource 指出如何基於與任何 Kubernetes 物件無關的指標進行擴充(例如雲端訊息服務中的佇列長度,或來自叢集外部運行的負載平衡器的 QPS)。

      • metrics.external.metric (MetricIdentifier), 必填

        metric 透過名稱和選取器識別目標指標

        MetricIdentifier 定義指標的名稱和可選的選取器

        • metrics.external.metric.name (string), 必填

          name 是給定指標的名稱

        • metrics.external.metric.selector (LabelSelector)

          selector 是給定指標的標準 Kubernetes 標籤選取器的字串編碼形式。設定後,它會作為額外參數傳遞給指標伺服器,以實現更精確的指標範圍界定。未設定時,將僅使用 metricName 來收集指標。

      • metrics.external.target (MetricTarget), 必填

        target 指定給定指標的目標值

        MetricTarget 定義特定指標的目標值、平均值或平均使用率

        • metrics.external.target.type (string), 必填

          type 表示指標類型是 Utilization、Value 還是 AverageValue

        • metrics.external.target.averageUtilization (int32)

          averageUtilization 是所有相關 Pod 中資源指標平均值的目標值,表示為 Pod 資源請求值的百分比。目前僅對 Resource 指標來源類型有效

        • metrics.external.target.averageValue (Quantity)

          averageValue 是所有相關 Pod 中指標平均值的目標值(以數量表示)

        • metrics.external.target.value (Quantity)

          value 是指標的目標值(以數量表示)。

    • metrics.object (ObjectMetricSource)

      object 指的是描述單一 Kubernetes 物件的指標(例如,Ingress 物件上的每秒點擊次數)。

      ObjectMetricSource 指出如何基於描述 Kubernetes 物件的指標進行擴充(例如,Ingress 物件上的每秒點擊次數)。

      • metrics.object.describedObject (CrossVersionObjectReference), 必填

        describedObject 指定物件的描述,例如 kind、name、apiVersion

        CrossVersionObjectReference 包含足夠的資訊,可讓您識別參照的資源。

      • metrics.object.metric (MetricIdentifier), 必填

        metric 透過名稱和選取器識別目標指標

        MetricIdentifier 定義指標的名稱和可選的選取器

        • metrics.object.metric.name (string), 必填

          name 是給定指標的名稱

        • metrics.object.metric.selector (LabelSelector)

          selector 是給定指標的標準 Kubernetes 標籤選取器的字串編碼形式。設定後,它會作為額外參數傳遞給指標伺服器,以實現更精確的指標範圍界定。未設定時,將僅使用 metricName 來收集指標。

      • metrics.object.target (MetricTarget), 必填

        target 指定給定指標的目標值

        MetricTarget 定義特定指標的目標值、平均值或平均使用率

        • metrics.object.target.type (string), 必填

          type 表示指標類型是 Utilization、Value 還是 AverageValue

        • metrics.object.target.averageUtilization (int32)

          averageUtilization 是所有相關 Pod 中資源指標平均值的目標值,表示為 Pod 資源請求值的百分比。目前僅對 Resource 指標來源類型有效

        • metrics.object.target.averageValue (Quantity)

          averageValue 是所有相關 Pod 中指標平均值的目標值(以數量表示)

        • metrics.object.target.value (Quantity)

          value 是指標的目標值(以數量表示)。

    • metrics.pods (PodsMetricSource)

      pods 指的是描述目前擴充目標中每個 Pod 的指標(例如,每秒處理的交易次數)。這些值在與目標值比較之前將會被平均。

      PodsMetricSource 指出如何基於描述目前擴充目標中每個 Pod 的指標進行擴充(例如,每秒處理的交易次數)。這些值在與目標值比較之前將會被平均。

      • metrics.pods.metric (MetricIdentifier), 必填

        metric 透過名稱和選取器識別目標指標

        MetricIdentifier 定義指標的名稱和可選的選取器

        • metrics.pods.metric.name (string), 必填

          name 是給定指標的名稱

        • metrics.pods.metric.selector (LabelSelector)

          selector 是給定指標的標準 Kubernetes 標籤選取器的字串編碼形式。設定後,它會作為額外參數傳遞給指標伺服器,以實現更精確的指標範圍界定。未設定時,將僅使用 metricName 來收集指標。

      • metrics.pods.target (MetricTarget), 必填

        target 指定給定指標的目標值

        MetricTarget 定義特定指標的目標值、平均值或平均使用率

        • metrics.pods.target.type (string), 必填

          type 表示指標類型是 Utilization、Value 還是 AverageValue

        • metrics.pods.target.averageUtilization (int32)

          averageUtilization 是所有相關 Pod 中資源指標平均值的目標值,表示為 Pod 資源請求值的百分比。目前僅對 Resource 指標來源類型有效

        • metrics.pods.target.averageValue (Quantity)

          averageValue 是所有相關 Pod 中指標平均值的目標值(以數量表示)

        • metrics.pods.target.value (Quantity)

          value 是指標的目標值(以數量表示)。

    • metrics.resource (ResourceMetricSource)

      resource 指的是 Kubernetes 已知的資源指標(例如在 requests 和 limits 中指定的指標),用於描述目前擴充目標中每個 Pod(例如 CPU 或記憶體)。此類指標已內建於 Kubernetes 中,並且除了使用 "pods" 來源的正常每個 Pod 指標之外,還具有特殊的擴充選項。

      ResourceMetricSource 指出如何基於 Kubernetes 已知的資源指標進行擴充,如 requests 和 limits 中所指定,用於描述目前擴充目標中每個 Pod(例如 CPU 或記憶體)。這些值在與目標值比較之前將會被平均。此類指標已內建於 Kubernetes 中,並且除了使用 "pods" 來源的正常每個 Pod 指標之外,還具有特殊的擴充選項。應僅設定一種 "target" 類型。

      • metrics.resource.name (string), 必填

        name 是相關資源的名稱。

      • metrics.resource.target (MetricTarget), 必填

        target 指定給定指標的目標值

        MetricTarget 定義特定指標的目標值、平均值或平均使用率

        • metrics.resource.target.type (string), 必填

          type 表示指標類型是 Utilization、Value 還是 AverageValue

        • metrics.resource.target.averageUtilization (int32)

          averageUtilization 是所有相關 Pod 中資源指標平均值的目標值,表示為 Pod 資源請求值的百分比。目前僅對 Resource 指標來源類型有效

        • metrics.resource.target.averageValue (Quantity)

          averageValue 是所有相關 Pod 中指標平均值的目標值(以數量表示)

        • metrics.resource.target.value (Quantity)

          value 是指標的目標值(以數量表示)。

HorizontalPodAutoscalerStatus

HorizontalPodAutoscalerStatus 描述水平 Pod 自動擴充程式的目前狀態。


  • desiredReplicas (int32), 必填

    desiredReplicas 是此自動擴充程式管理的 Pod 所需的副本數,為自動擴充程式上次計算的值。

  • conditions ([]HorizontalPodAutoscalerCondition)

    Patch 策略:在鍵 type 上合併

    Map:在合併期間,鍵 type 上的唯一值將被保留

    conditions 是此自動擴充程式擴充其目標所需的條件集合,並指示是否滿足這些條件。

    HorizontalPodAutoscalerCondition 描述 HorizontalPodAutoscaler 在特定時間點的狀態。

    • conditions.status (string), 必填

      status 是條件的狀態(True、False、Unknown)

    • conditions.type (string), 必填

      type 描述目前的條件

    • conditions.lastTransitionTime (Time)

      lastTransitionTime 是條件上次從一種狀態轉換到另一種狀態的時間

      Time 是 time.Time 的包裝器,支援正確地封送處理為 YAML 和 JSON。為 time 套件提供的許多 factory 方法提供了包裝器。

    • conditions.message (string)

      message 是人類可讀的解釋,其中包含關於轉換的詳細資訊

    • conditions.reason (string)

      reason 是條件上次轉換的原因。

  • currentMetrics ([]MetricStatus)

    Atomic: 將在合併期間被取代

    currentMetrics 是此自動擴充程式使用的指標的上次讀取狀態。

    MetricStatus 描述單一指標的上次讀取狀態。

    • currentMetrics.type (string), 必填

      type 是指標來源的類型。它將是 "ContainerResource"、"External"、"Object"、"Pods" 或 "Resource" 其中之一,每個都對應到物件中的一個相符欄位。注意:"ContainerResource" 類型僅在啟用 feature-gate HPAContainerMetrics 時可用

    • currentMetrics.containerResource (ContainerResourceMetricStatus)

      container resource 指的是 Kubernetes 已知的資源指標(例如在 requests 和 limits 中指定的指標),用於描述目前擴充目標中每個 Pod 的單一容器(例如 CPU 或記憶體)。此類指標已內建於 Kubernetes 中,並且除了使用 "pods" 來源的正常每個 Pod 指標之外,還具有特殊的擴充選項。

      ContainerResourceMetricStatus 指出 Kubernetes 已知的資源指標的目前值,如 requests 和 limits 中所指定,用於描述目前擴充目標中每個 Pod 的單一容器(例如 CPU 或記憶體)。此類指標已內建於 Kubernetes 中,並且除了使用 "pods" 來源的正常每個 Pod 指標之外,還具有特殊的擴充選項。

      • currentMetrics.containerResource.container (string), 必填

        container 是擴充目標 Pod 中容器的名稱

      • currentMetrics.containerResource.current (MetricValueStatus), 必填

        current 包含給定指標的目前值

        MetricValueStatus 保留指標的目前值

        • currentMetrics.containerResource.current.averageUtilization (int32)

          currentAverageUtilization 是所有相關 Pod 中資源指標平均值的目前值,表示為 Pod 資源請求值的百分比。

        • currentMetrics.containerResource.current.averageValue (Quantity)

          averageValue 是所有相關 Pod 中指標平均值的目前值(以數量表示)

        • currentMetrics.containerResource.current.value (Quantity)

          value 是指標的目前值(以數量表示)。

      • currentMetrics.containerResource.name (string), 必填

        name 是相關資源的名稱。

    • currentMetrics.external (ExternalMetricStatus)

      external 指的是與任何 Kubernetes 物件無關的全域指標。它允許基於來自叢集外部運行的元件的資訊進行自動擴充(例如雲端訊息服務中的佇列長度,或來自叢集外部運行的負載平衡器的 QPS)。

      ExternalMetricStatus 指出與任何 Kubernetes 物件無關的全域指標的目前值。

      • currentMetrics.external.current (MetricValueStatus), 必填

        current 包含給定指標的目前值

        MetricValueStatus 保留指標的目前值

        • currentMetrics.external.current.averageUtilization (int32)

          currentAverageUtilization 是所有相關 Pod 中資源指標平均值的目前值,表示為 Pod 資源請求值的百分比。

        • currentMetrics.external.current.averageValue (Quantity)

          averageValue 是所有相關 Pod 中指標平均值的目前值(以數量表示)

        • currentMetrics.external.current.value (Quantity)

          value 是指標的目前值(以數量表示)。

      • currentMetrics.external.metric (MetricIdentifier), 必填

        metric 透過名稱和選取器識別目標指標

        MetricIdentifier 定義指標的名稱和可選的選取器

        • currentMetrics.external.metric.name (string), 必填

          name 是給定指標的名稱

        • currentMetrics.external.metric.selector (LabelSelector)

          selector 是給定指標的標準 Kubernetes 標籤選取器的字串編碼形式。設定後,它會作為額外參數傳遞給指標伺服器,以實現更精確的指標範圍界定。未設定時,將僅使用 metricName 來收集指標。

    • currentMetrics.object (ObjectMetricStatus)

      object 指的是描述單一 Kubernetes 物件的指標(例如,Ingress 物件上的每秒點擊次數)。

      ObjectMetricStatus 指出描述 Kubernetes 物件的指標的目前值(例如,Ingress 物件上的每秒點擊次數)。

      • currentMetrics.object.current (MetricValueStatus), 必填

        current 包含給定指標的目前值

        MetricValueStatus 保留指標的目前值

        • currentMetrics.object.current.averageUtilization (int32)

          currentAverageUtilization 是所有相關 Pod 中資源指標平均值的目前值,表示為 Pod 資源請求值的百分比。

        • currentMetrics.object.current.averageValue (Quantity)

          averageValue 是所有相關 Pod 中指標平均值的目前值(以數量表示)

        • currentMetrics.object.current.value (Quantity)

          value 是指標的目前值(以數量表示)。

      • currentMetrics.object.describedObject (CrossVersionObjectReference), 必填

        DescribedObject 指定物件的描述,例如 kind、name、apiVersion

        CrossVersionObjectReference 包含足夠的資訊,可讓您識別參照的資源。

      • currentMetrics.object.metric (MetricIdentifier), 必填

        metric 透過名稱和選取器識別目標指標

        MetricIdentifier 定義指標的名稱和可選的選取器

        • currentMetrics.object.metric.name (string), 必填

          name 是給定指標的名稱

        • currentMetrics.object.metric.selector (LabelSelector)

          selector 是給定指標的標準 Kubernetes 標籤選取器的字串編碼形式。設定後,它會作為額外參數傳遞給指標伺服器,以實現更精確的指標範圍界定。未設定時,將僅使用 metricName 來收集指標。

    • currentMetrics.pods (PodsMetricStatus)

      pods 指的是描述目前擴充目標中每個 Pod 的指標(例如,每秒處理的交易次數)。這些值在與目標值比較之前將會被平均。

      PodsMetricStatus 指出描述目前擴充目標中每個 Pod 的指標的目前值(例如,每秒處理的交易次數)。

      • currentMetrics.pods.current (MetricValueStatus), 必填

        current 包含給定指標的目前值

        MetricValueStatus 保留指標的目前值

        • currentMetrics.pods.current.averageUtilization (int32)

          currentAverageUtilization 是所有相關 Pod 中資源指標平均值的目前值,表示為 Pod 資源請求值的百分比。

        • currentMetrics.pods.current.averageValue (Quantity)

          averageValue 是所有相關 Pod 中指標平均值的目前值(以數量表示)

        • currentMetrics.pods.current.value (Quantity)

          value 是指標的目前值(以數量表示)。

      • currentMetrics.pods.metric (MetricIdentifier), 必填

        metric 透過名稱和選取器識別目標指標

        MetricIdentifier 定義指標的名稱和可選的選取器

        • currentMetrics.pods.metric.name (string), 必填

          name 是給定指標的名稱

        • currentMetrics.pods.metric.selector (LabelSelector)

          selector 是給定指標的標準 Kubernetes 標籤選取器的字串編碼形式。設定後,它會作為額外參數傳遞給指標伺服器,以實現更精確的指標範圍界定。未設定時,將僅使用 metricName 來收集指標。

    • currentMetrics.resource (ResourceMetricStatus)

      resource 指的是 Kubernetes 已知的資源指標(例如在 requests 和 limits 中指定的指標),用於描述目前擴充目標中每個 Pod(例如 CPU 或記憶體)。此類指標已內建於 Kubernetes 中,並且除了使用 "pods" 來源的正常每個 Pod 指標之外,還具有特殊的擴充選項。

      ResourceMetricStatus 指出 Kubernetes 已知的資源指標的目前值,如 requests 和 limits 中所指定,用於描述目前擴充目標中每個 Pod(例如 CPU 或記憶體)。此類指標已內建於 Kubernetes 中,並且除了使用 "pods" 來源的正常每個 Pod 指標之外,還具有特殊的擴充選項。

      • currentMetrics.resource.current (MetricValueStatus), 必填

        current 包含給定指標的目前值

        MetricValueStatus 保留指標的目前值

        • currentMetrics.resource.current.averageUtilization (int32)

          currentAverageUtilization 是所有相關 Pod 中資源指標平均值的目前值,表示為 Pod 資源請求值的百分比。

        • currentMetrics.resource.current.averageValue (Quantity)

          averageValue 是所有相關 Pod 中指標平均值的目前值(以數量表示)

        • currentMetrics.resource.current.value (Quantity)

          value 是指標的目前值(以數量表示)。

      • currentMetrics.resource.name (string), 必填

        name 是相關資源的名稱。

  • currentReplicas (int32)

    currentReplicas 是此自動擴充程式管理的 Pod 的目前副本數,為自動擴充程式上次所見。

  • lastScaleTime (Time)

    lastScaleTime 是 HorizontalPodAutoscaler 上次擴充 Pod 數量的時間,自動擴充程式使用它來控制 Pod 數量變更的頻率。

    Time 是 time.Time 的包裝器,支援正確地封送處理為 YAML 和 JSON。為 time 套件提供的許多 factory 方法提供了包裝器。

  • observedGeneration (int64)

    observedGeneration 是此自動擴充程式觀察到的最新世代。

HorizontalPodAutoscalerList

HorizontalPodAutoscalerList 是水平 Pod 自動擴充程式物件的列表。


  • apiVersion: autoscaling/v2

  • kind: HorizontalPodAutoscalerList

  • metadata (ListMeta)

    metadata 是標準列表 metadata。

  • items ([]HorizontalPodAutoscaler), 必填

    items 是水平 Pod 自動擴充程式物件的列表。

Operations


get 讀取指定的 HorizontalPodAutoscaler

HTTP Request

GET /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers/{name}

Parameters

  • name (in path): string, 必填

    HorizontalPodAutoscaler 的名稱

  • namespace (in path): string, 必填

    命名空間

  • pretty (in query): string

    pretty

Response

200 (HorizontalPodAutoscaler): 成功

401: 未經授權

get 讀取指定 HorizontalPodAutoscaler 的狀態

HTTP Request

GET /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers/{name}/status

Parameters

  • name (in path): string, 必填

    HorizontalPodAutoscaler 的名稱

  • namespace (in path): string, 必填

    命名空間

  • pretty (in query): string

    pretty

Response

200 (HorizontalPodAutoscaler): 成功

401: 未經授權

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

HTTP Request

GET /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers

Parameters

Response

200 (HorizontalPodAutoscalerList): 成功

401: 未經授權

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

HTTP Request

GET /apis/autoscaling/v2/horizontalpodautoscalers

Parameters

Response

200 (HorizontalPodAutoscalerList): 成功

401: 未經授權

create 建立 HorizontalPodAutoscaler

HTTP Request

POST /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers

Parameters

Response

200 (HorizontalPodAutoscaler): 成功

201 (HorizontalPodAutoscaler): 已建立

202 (HorizontalPodAutoscaler): 已接受

401: 未經授權

update 取代指定的 HorizontalPodAutoscaler

HTTP Request

PUT /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers/{name}

Parameters

Response

200 (HorizontalPodAutoscaler): 成功

201 (HorizontalPodAutoscaler): 已建立

401: 未經授權

update 取代指定 HorizontalPodAutoscaler 的狀態

HTTP Request

PUT /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers/{name}/status

Parameters

Response

200 (HorizontalPodAutoscaler): 成功

201 (HorizontalPodAutoscaler): 已建立

401: 未經授權

patch 部分更新指定的 HorizontalPodAutoscaler

HTTP Request

PATCH /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers/{name}

Parameters

  • name (in path): string, 必填

    HorizontalPodAutoscaler 的名稱

  • namespace (in path): string, 必填

    命名空間

  • body: Patch, 必填

  • dryRun (in query): string

    dryRun

  • fieldManager (in query): string

    fieldManager

  • fieldValidation (in query): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (in query): string

    pretty

Response

200 (HorizontalPodAutoscaler): 成功

201 (HorizontalPodAutoscaler): 已建立

401: 未經授權

patch 部分更新指定 HorizontalPodAutoscaler 的狀態

HTTP Request

PATCH /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers/{name}/status

Parameters

  • name (in path): string, 必填

    HorizontalPodAutoscaler 的名稱

  • namespace (in path): string, 必填

    命名空間

  • body: Patch, 必填

  • dryRun (in query): string

    dryRun

  • fieldManager (in query): string

    fieldManager

  • fieldValidation (in query): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (in query): string

    pretty

Response

200 (HorizontalPodAutoscaler): 成功

201 (HorizontalPodAutoscaler): 已建立

401: 未經授權

delete 刪除 HorizontalPodAutoscaler

HTTP Request

DELETE /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers/{name}

Parameters

Response

200 (Status): 成功

202 (Status): 已接受

401: 未經授權

deletecollection 刪除 HorizontalPodAutoscaler 的集合

HTTP Request

DELETE /apis/autoscaling/v2/namespaces/{namespace}/horizontalpodautoscalers

Parameters

Response

200 (Status): 成功

401: 未經授權

此頁面為自動產生。

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

上次修改時間為 2024 年 8 月 28 日下午 6:01 PST:更新 v1.31 的自動產生 API 參考文件 (8ba98c79c1)