Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Query cost data via the Cost V2 API

Son Güncelleme:Oct 06, 2026

Cost V2 API aracılığıyla, gerçek zamanlı maliyet eğilimi analizi için esnek zaman aralıkları ve pod, ad alanı, etiket, denetleyici adı veya denetleyici türüne göre filtreler kullanarak küme iş yüklerinin gerçek zamanlı tahmini maliyetlerini sorgulayın.

Ön koşullar

API'ler kullanarak maliyet verilerine genel bakış konusundaki kurulum adımlarını tamamlayın.

API referansı

İstek sözdizimi

GET /v2/cost

İstek parametreleri

Parametre

Tür

Gerekli

Açıklama

window

string

Evet

Sorgulanacak zaman aralığı.

  • Desteklenen biçimler:

    • today — geçerli gün

    • yesterday — önceki gün

    • week — geçerli hafta

    • lastweek — önceki hafta

    • month — geçerli ay

    • lastmonth — önceki ay

  • Süre: 30m (son 30 dakika), 12h (son 12 saat), 7d (son 7 gün)

  • RFC3339 tarih aralığı: 2024-03-26T00:00:00Z,2024-03-27T00:00:00Z

  • Unix zaman damgası aralığı (saniye): 1711382400,1711468800

filter

string

Hayır

Kaynak kategorisine göre filtreleme yapar: namespace, controllerName (örneğin, csi-plugin), controllerKind (örneğin, DaemonSet, ReplicaSet, Job), pod, label (örneğin, [app]:"nginx").

Birden çok değeri virgülle ayırın: namespace:"default","kube-system".

Kategorileri + işaretiyle birleştirin: namespace:"default"+label[app]:"nginx".

step

string

Hayır

Sonuçları birden çok maliyet kümesine bölmek için kullanılacak zaman aralığı (örneğin, 1d veya 1w ). Belirtilmezse, tüm window tek bir maliyet kümesi olarak döndürülür.

Not

Bir maliyet kümesi, belirli bir zaman diliminde bir Kubernetes nesnesine (örneğin bir pod'a) ait maliyet verilerini içerir.

aggregate

string

Hayır

Toplama boyutu. Desteklenen değerler:

  • namespace — kümenin tüm ad alanları genelinde

  • controller — tek tek denetleyicilere göre

  • controllerKind — denetleyici türüne göre (örneğin, DaemonSet, ReplicaSet)

  • label:<name> — etiket anahtarına göre

  • node — hesaplama düğümüne göre

idle

boolean

Hayır

Boşta kalan maliyetlerin dahil edilip edilmeyeceğini belirtir. Varsayılan: true.

shareIdle

boolean

Hayır

Boşta kalan maliyetlerin boşta olmayan kaynaklara dağıtılıp dağıtılmayacağını belirtir. Varsayılan: false.

shareSplit

string

Hayır

Boşta kalan maliyetlerin tahsis edilmesi için kullanılan ilke. Geçerli değerler:

  • weighted (varsayılan)

  • even

idleByNode

boolean

Hayır

Dağıtımdan önce boşta kalan maliyetlerin düğüm düzeyinde toplanıp toplanmayacağını belirtir. Yalnızca aggregate=node ve shareIdle=false olduğunda uygulanır. Varsayılan: false.

format

string

Hayır

Çıktı biçimi. Geçerli değerler: json (varsayılan), csv.

Yanıt parametreleri

Parametre

Tür

Açıklama

properties

object

Kubernetes nesne özellikleri.

pod

string

Pod adı.

node

string

Düğüm adı.

namespace

string

Ad alanı.

controllerKind

string

Denetleyici türü (örneğin, DaemonSet, ReplicaSet).

controller

string

Denetleyici adı.

providerID

string

Düğümün ECS örnek kimliği.

labels

map[string]string

Pod etiketleri.

Not

Prometheus, etiket adlarında yalnızca alt çizgiyi (_) destekler. Tire (-) ve nokta (.) karakterleri alt çizgiye dönüştürülür.

start

string

Maliyet kümesinin başlangıç zamanı.

end

string

Maliyet kümesinin bitiş zamanı.

cpuCoreRequestAverage

float

İlgili süre boyunca talep edilen ortalama CPU çekirdek sayısı.

cpuCoreUsageAverage

float

İlgili süre boyunca kullanılan ortalama CPU çekirdek sayısı.

ramByteRequestAverage

float

İlgili süre boyunca bayt cinsinden talep edilen ortalama bellek miktarı.

ramByteUsageAverage

float

İlgili süre boyunca bayt cinsinden kullanılan ortalama bellek miktarı.

cost

float

İlgili dönem için tahmini maliyet. Varsayılan: %100 CPU ağırlığı. Özelleştirme için bkz. Maliyet tahmin ilkeleri.

costRatio

float

Toplam küme maliyetindeki payı (kaynak maliyeti / toplam küme maliyeti).

customCost

float

Özel bir tahmin ilkesinden gelen maliyet.

(İsteğe bağlı) Adım 1: Kaynak maliyeti ağırlıklarını özelleştirme

Cost V2 API varsayılan olarak %100 CPU ağırlığını kullanır ({"cpu": "1.0", "memory": "0.0"}). Karma CPU-bellek ağırlıklandırması için ack-alibaba-cloud-metrics-adapter Helm grafiğini güncelleyin.

  1. ACK konsolu üzerinde oturum açın. Sol gezinme bölmesinde Clusters öğesine tıklayın.

  2. Clusters sayfasında kümenizin adına tıklayın. Sol gezinme bölmesinde Applications > Helm seçeneğine tıklayın.

  3. Helm sayfasında ack-alibaba-cloud-metrics-adapter öğesini bulun ve Actions sütunundaki Update seçeneğine tıklayın.

  4. YAML dosyasında AlibabaCloudMetricsAdapter.costWeights parametresini güncelleyin ve ardından OK seçeneğine tıklayın.

    image

    Bkz. Maliyet tahmin ilkeleri.

Adım 2: Maliyet verilerini sorgulama

Tüm örnekler, istemci sertifikası kimlik doğrulaması ile curl kullanımını gösterir. Kurulum için bkz. Kubernetes API'sini kullanma.

Örnek 1: Dünkü DaemonSet maliyetlerini sorgulama

Ad alanı, denetleyici türü ve etikete göre filtreleme yaparak dün için pod başına maliyet verilerini döndürür.

İstek

curl -G -k --cert ./client-cert.pem --key ./client-key.pem \
  -d 'window=yesterday' \
  -d 'filter=namespace:"kube-system"+controllerKind:"DaemonSet"+label[app]:"terway-eniip"' \
  "$APISERVER/api/v1/namespaces/kube-system/services/ack-metrics-adapter-api-service:8080/proxy/v2/cost" | jq .

Örnek yanıt

Örnek yanıtı görüntüle

{
  "data": [
    {
      "kube-system/terway-eniip-88286": {
        "name": "kube-system/terway-eniip-88286",
        "properties": {
          "controller": "terway-eniip",
          "controllerKind": "DaemonSet",
          "namespace": "kube-system",
          "pod": "terway-eniip-88286"
        },
        "start": "2024-03-25T00:00:00+08:00",
        "end": "2024-03-26T00:00:00+08:00",
        "cpuCoreRequestAverage": 0.35,
        "cpuCoreUsageAverage": 0.001,
        "ramByteRequestAverage": 209715200,
        "ramByteUsageAverage": 65815511.04,
        "cost": 1.622,
        "costRatio": 0.016,
        "customCost": 0.972
      },
      "kube-system/terway-eniip-fqxk8": {
        "name": "kube-system/terway-eniip-fqxk8",
        "properties": {
          "controller": "terway-eniip",
          "controllerKind": "DaemonSet",
          "namespace": "kube-system",
          "pod": "terway-eniip-fqxk8"
        },
        "start": "2024-03-25T00:00:00+08:00",
        "end": "2024-03-26T00:00:00+08:00",
        "cpuCoreRequestAverage": 0.35,
        "cpuCoreUsageAverage": 0.001,
        "ramByteRequestAverage": 209715200,
        "ramByteUsageAverage": 72787722.24,
        "cost": 1.622,
        "costRatio": 0.016,
        "customCost": 0.972
      },
      "kube-system/terway-eniip-xjsr8": {
        "name": "kube-system/terway-eniip-xjsr8",
        "properties": {
          "controller": "terway-eniip",
          "controllerKind": "DaemonSet",
          "namespace": "kube-system",
          "pod": "terway-eniip-xjsr8"
        },
        "start": "2024-03-25T00:00:00+08:00",
        "end": "2024-03-26T00:00:00+08:00",
        "cpuCoreRequestAverage": 0.35,
        "cpuCoreUsageAverage": 0.001,
        "ramByteRequestAverage": 209715200,
        "ramByteUsageAverage": 53661380.923,
        "cost": 0.843,
        "costRatio": 0.008,
        "customCost": 0.505
      }
    }
  ]
}

Örnek 2: 3 saatlik pencerede saatlik pod maliyetlerini sorgulama

3 saatlik bir pencereyi üç saatlik maliyet kümesine bölmek için step=1h kullanır.

İstek

curl -G -k --cert ./client-cert.pem --key ./client-key.pem \
  -d 'window=2024-03-24T00:00:00Z,2024-03-24T03:00:00Z' \
  -d 'step=1h' \
  -d 'filter=namespace:"kube-system"+pod:"terway-eniip-kz68n"' \
  "$APISERVER/api/v1/namespaces/kube-system/services/ack-metrics-adapter-api-service:8080/proxy/v2/cost" | jq .

Örnek yanıt

Örnek yanıtı görüntüle

{
  "data": [
    {
      "kube-system/terway-eniip-kz68n": {
        "name": "kube-system/terway-eniip-kz68n",
        "properties": {
          "controller": "terway-eniip",
          "controllerKind": "DaemonSet",
          "namespace": "kube-system",
          "pod": "terway-eniip-kz68n"
        },
        "start": "2024-03-24T00:00:00Z",
        "end": "2024-03-24T01:00:00Z",
        "cpuCoreRequestAverage": 0.35,
        "cpuCoreUsageAverage": 0.001,
        "ramByteRequestAverage": 209715200,
        "ramByteUsageAverage": 63583378.285,
        "cost": 0.075,
        "costRatio": 0.025,
        "customCost": 0.045
      }
    },
    {
      "kube-system/terway-eniip-kz68n": {
        "name": "kube-system/terway-eniip-kz68n",
        "properties": {
          "controller": "terway-eniip",
          "controllerKind": "DaemonSet",
          "namespace": "kube-system",
          "pod": "terway-eniip-kz68n"
        },
        "start": "2024-03-24T01:00:00Z",
        "end": "2024-03-24T02:00:00Z",
        "cpuCoreRequestAverage": 0.35,
        "cpuCoreUsageAverage": 0.001,
        "ramByteRequestAverage": 209715200,
        "ramByteUsageAverage": 63111168,
        "cost": 0.075,
        "costRatio": 0.025,
        "customCost": 0.045
      }
    },
    {
      "kube-system/terway-eniip-kz68n": {
        "name": "kube-system/terway-eniip-kz68n",
        "properties": {
          "controller": "terway-eniip",
          "controllerKind": "DaemonSet",
          "namespace": "kube-system",
          "pod": "terway-eniip-kz68n"
        },
        "start": "2024-03-24T02:00:00Z",
        "end": "2024-03-24T03:00:00Z",
        "cpuCoreRequestAverage": 0.35,
        "cpuCoreUsageAverage": 0.001,
        "ramByteRequestAverage": 209715200,
        "ramByteUsageAverage": 63430656,
        "cost": 0.075,
        "costRatio": 0.025,
        "customCost": 0.045
      }
    }
  ]
}

Örnek 3: app etiketine göre toplanmış maliyetleri sorgulama

Maliyetleri app etiketine göre gruplandırmak için aggregate=label:app kullanır.

İstek

curl -G -k --cert ./client-cert.pem --key ./client-key.pem \
  -d 'window=2h' \
  -d 'aggregate=label:app' \
  "$APISERVER/api/v1/namespaces/kube-system/services/ack-metrics-adapter-api-service:8080/proxy/v2/cost" | jq .

Örnek yanıt

Örnek yanıtı görüntüle

{
  "data": [
    {
      "__idle__": {
        "name": "__idle__",
        "start": "2024-12-17T09:50:30+08:00",
        "end": "2024-12-17T11:50:30+08:00",
        "cpuCoreRequestAverage": 0,
        "cpuCoreUsageAverage": 0,
        "ramByteRequestAverage": 0,
        "ramByteUsageAverage": 0,
        "cost": 3.8230000000000004,
        "costRatio": 0.6371666666666664,
        "customCost": 0
      },
      "__unallocated__": {
        "name": "__unallocated__",
        "start": "2024-12-17T09:50:30+08:00",
        "end": "2024-12-17T11:50:30+08:00",
        "cpuCoreRequestAverage": 1.135,
        "cpuCoreUsageAverage": 0.024,
        "ramByteRequestAverage": 1901068288,
        "ramByteUsageAverage": 646283264,
        "cost": 0.6000000000000001,
        "costRatio": 0.09999999999999999,
        "customCost": 0
      },
      "ack-alibaba-cloud-metrics-adapter": {
        "name": "ack-alibaba-cloud-metrics-adapter",
        "start": "2024-12-17T09:50:30+08:00",
        "end": "2024-12-17T11:50:30+08:00",
        "cpuCoreRequestAverage": 0.24,
        "cpuCoreUsageAverage": 0.004,
        "ramByteRequestAverage": 482344960,
        "ramByteUsageAverage": 96964608,
        "cost": 0.064,
        "costRatio": 0.010666666666666666,
        "customCost": 0
      },
      "terway-eniip": {
        "name": "terway-eniip",
        "start": "2024-12-17T09:50:30+08:00",
        "end": "2024-12-17T11:50:30+08:00",
        "cpuCoreRequestAverage": 1.0499999999999998,
        "cpuCoreUsageAverage": 0.001,
        "ramByteRequestAverage": 629145600,
        "ramByteUsageAverage": 122054656,
        "cost": 0.5609999999999999,
        "costRatio": 0.0935,
        "customCost": 0
      }
    }
  ]
}

Sonraki adımlar

Allocation API, fatura ve küme maliyeti verilerini birleştirerek amortize edilmiş maliyet uzlaştırması sağlar. Bkz. Allocation API kullanarak veri alma.