Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Call the Allocation API to query cost insights data

Son Güncelleme:Oct 12, 2026

Finansal yönetişim ve muhasebe amacıyla kullanılmak üzere bir kümenin iş yükü boyutundaki maliyet tahsis verilerini sorgular.

Ön koşullar

Başlamadan önce, Maliyet verilerini sorgulamak için API çağırma genel bakışı bölümünde açıklanan ön koşulların karşılandığından emin olun.

İstek ve yanıt parametreleri

İstek sözdizimi

GET /v2/allocation

İstek parametreleri

Parametre Tür Gerekli Açıklama
window string Evet

Sorgulanacak zaman aralığı. Minimum aralık 24 saattir. Aşağıdaki biçimleri kabul eder:

Anahtar kelimeler:week, month, yesterday, lastweek, lastmonth

Süre:24h, 7d

RFC3339 tarih çifti (virgülle ayrılmış): 2024-03-26T00:00:00Z,2024-03-27T00:00:00Z

UNIX zaman damgası çifti (virgülle ayrılmış, saniye cinsinden): 1711382400,1711468800

Örnekler:

- window=yesterday — önceki gün

- window=lastweek — önceki hafta

- window=7d — önceki 7 gün

- window=2024-03-26T00:00:00Z,2024-03-27T00:00:00Z — belirli bir RFC3339 tarih aralığı

filter string Hayır

Sonuçları iş yüküne göre filtreler. Desteklenen filtre türleri:

- namespace

- controllerName (örneğin csi-plugin ve node-exporter)

- controllerKind (örneğin ReplicaSet, DaemonSet ve Job)

- pod

- label (örneğin [app]:"nginx")

Aynı türdeki birden fazla değere göre filtrelemek için değerleri virgülle ayırın: namespace:"default","kube-system"

Birden fazla filtre türünü birleştirmek için bunları artı işaretiyle (+) ayırın: namespace:"default"+label[app]:"nginx"

step string Hayır

Zaman aralığını maliyet kümelerine bölmek için kullanılan aralık. Bir maliyet kümesi, aralık içindeki bir pod gibi bir Kubernetes nesnesinin maliyet verilerini içerir. Varsayılan: window değeri (tüm pencere için tek bir maliyet kümesi döndürür).

Örnekler:

- step=1d — günlük maliyet kümeleri (window=lastweek veya window=month ile kullanıldığında yararlıdır)

- step=1w — haftalık maliyet kümeleri

aggregate string Hayır

Sonuçları belirtilen boyuta göre toplar. Desteklenen değerler:

- namespace — ad alanına göre toplar

- controller — tek tek denetleyicilere göre toplar

- controllerKind — denetleyici türüne göre toplar (DaemonSet, ReplicaSet, Job vb.)

- label:<name> — belirtilen etiket adına göre toplar

- node — hesaplama düğümüne göre toplar

idle boolean Hayır Boşta kalan maliyetlerin sonuçlara dahil edilip edilmeyeceğini belirtir. Varsayılan: true.
shareIdle boolean Hayır Boşta kalan maliyetlerin iş yükleri arasında dağıtılıp dağıtılmayacağını belirtir. Varsayılan: false.
shareSplit string Hayır

Boşta kalan maliyet dağıtım ilkesi. Desteklenen değerler:

- weighted (varsayılan) — boşta kalan maliyetleri her iş yükünün kaynak kullanımına orantılı olarak dağıtır

- even — boşta kalan maliyetleri tüm iş yüklerine eşit olarak dağıtır

idleByNode boolean Hayır Boşta kalan maliyetlerin küme düzeyi yerine düğüm düzeyinde toplanıp toplanmayacağını belirtir. Yalnızca aggregate=node ve shareIdle=false olduğunda etkilidir. Varsayılan: false.
targetType string Hayır

Maliyet tahsisinin kapsamı. Desteklenen değerler:

- cluster (varsayılan) — kümedeki tüm kaynakların maliyetlerini tahsis eder

- node — maliyetleri düğüm düzeyinde tahsis eder

format string Hayır

Çıktı biçimi. Desteklenen değerler:

- json (varsayılan)

- csv

idleByNode yalnızca hem aggregate=node hem de shareIdle=false olduğunda etkilidir. Eğer shareIdle=true ise, boşta kalan maliyetler zaten iş yükleri arasında dağıtılmıştır ve düğüme göre toplanamaz.

Yanıt parametreleri

Parametre Tür Açıklama
properties object İlişkili Kubernetes nesnesinin özellikleri.
pod string Pod'un adı.
node string Düğümün adı.
namespace string Ad alanı.
controllerKind string Denetleyici türü.
controller string Denetleyici adı.
providerID string Düğümün Elastic Compute Service (ECS) örnek kimliği.
labels map[string]string Pod'un etiketleri.
Not

Prometheus yalnızca etiket adlarında alt çizgi (_) karakterine izin verir. Bir etiket tire (-) veya nokta (.) içeriyorsa Prometheus bunları alt çizgiye dönüştürür.

start string Maliyet kümesinin başlangıç zamanı.
end string Maliyet kümesinin bitiş zamanı.
cpuCoreRequestAverage float İstenen ortalama sanal CPU sayısı.
cpuCoreUsageAverage float Kullanımda olan ortalama sanal CPU sayısı.
ramByteRequestAverage float İstenen ortalama bellek miktarı (bayt cinsinden).
ramByteUsageAverage float Kullanımda olan ortalama bellek miktarı (bayt cinsinden).
cost float Toplam küme maliyetinden hizmete tahsis edilen maliyet.
costRatio float Tahsis edilen maliyetin toplam küme maliyetine oranı.
customCost float Özel maliyet.

Maliyet içgörüsü verilerini sorgulama

Tüm örneklerde Kubernetes API'ye erişmek için curl kullanılır. Kurulum talimatları için bkz. Kubernetes API'yi kullanma.

Önceki günün küme maliyetinden bir DaemonSet'e tahsis edilen maliyeti sorgulama

Aşağıdaki komut, kube-system ad alanında bulunan ve terway-eniip DaemonSet'ine ait pod'lar için önceki günün maliyetini sorgular.

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/allocation" | jq .

Örnek yanıt:

{
  "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.039,
        "cost": 4.497,
        "costRatio": 0.016,
        "customCost": 0.972
      },
      "kube-system/terway-eniip-j8c87": {
        "name": "kube-system/terway-eniip-j8c87",
        "properties": {
          "controller": "terway-eniip",
          "controllerKind": "DaemonSet",
          "namespace": "kube-system",
          "pod": "terway-eniip-j8c87"
        },
        "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": 186293944.32,
        "cost": 6.504,
        "costRatio": 0.023,
        "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": 2.337,
        "costRatio": 0.008,
        "customCost": 0.505
      }
    }
  ]
}