Azure Kubernetes Service (AKS) Güvenlik Açığı Veri API'sini kullanma

AKS Güvenlik Açığı Veri API'si, AKS tarafından yönetilen platform bileşenlerinde algılanan güvenlik açıklarına yönelik programlı, salt okunur görünürlük sağlar. Bu API, belirli bir küme çalışma zamanı durumundan bağımsız olarak AKS tarafından yönetilen yapıtları etkileyen güvenlik açıkları hakkında yetkili bilgilere ihtiyaç duyan güvenlik ekipleri, uyumluluk ekipleri ve platform sahiplerine yöneliktir.

Bu makalede AKS sürümleri, Kubernetes sürümleri, düğüm görüntüleri, kapsayıcı görüntüleri ve işletim sistemi paketleri gibi AKS tarafından yönetilen yapıtlar için CVE raporlarını program aracılığıyla almak için AKS Güvenlik Açığı Veri API'sini kullanmayı öğreneceksiniz. API isteklerine örnekler sağlar ve büyük ölçekli CVE analizini, otomasyonunu ve güvenlik tarayıcısı bulgularıyla bağıntıyı desteklemek için yanıtları yorumlamayı gösterir. API'nin arkasındaki kavramlara genel bir bakış için Azure Kubernetes Service (AKS) için Güvenlik Açığı Verileri API'sine genel bakış bölümüne bakın.

CVE raporlarını sorgulama

Aşağıdaki örneklerde AKS sürümleri, Kubernetes sürümleri, düğüm görüntüleri, kapsayıcı görüntüleri ve işletim sistemi paketleri için CVE raporlarını almak üzere AKS Güvenlik Açığı Veri API'sinin nasıl sorgulandığı gösterilmektedir.

AKS sürümü için CVE'leri sorgulama

# 1. List available AKS releases
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/_index | jq '.aks_release_versions'

# 2. Get CVE report for a specific release
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/v20260104/scan-reports | jq '.'

Kubernetes sürümü için CVE'leri sorgulama

# 1. List available Kubernetes versions
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/_index | jq '.k8s_versions'

# 2. Get CVE report for a specific Kubernetes version
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/1.32.9/scan-reports | jq '.'

Düğüm görüntüsü (VHD) için CVE'leri sorgulayın

# 1. List available VHD releases
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/_index | jq '.vhd_release_versions'

# 2. Get CVE report for a specific VHD
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/AKSUbuntu-gen2-2204containerd/202601.13.0/scan-reports | jq '.'

Belirli bir kapsayıcı görüntüsü için CVE'leri sorgulama

# Get CVE scan report for a specific tagged container image
curl -s https://cve-api.prod-aks.azure.com/api/v1/container-images/mcr.microsoft.com/oss/kubernetes/kube-proxy:v1.31.11/scan-reports | jq '.'

# Get CVE mitigation history for a container image repository
curl -s https://cve-api.prod-aks.azure.com/api/v1/container-images/mcr.microsoft.com/oss/kubernetes/kube-proxy/mitigation-reports | jq '.'

Belirli bir işletim sistemi paketi için CVE'leri sorgulama

# Get CVE scan report for a specific OS package version
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/3.0.2-0ubuntu1.20/scan-reports | jq '.'

# Get CVE mitigation history for an OS package
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/mitigation-reports | jq '.'

Bitiş noktası

AKS Güvenlik Açığı Veri API'si AKS sürümleri, Kubernetes sürümleri, düğüm görüntüleri, kapsayıcı görüntüleri ve işletim sistemi paketleri için CVE raporlarını almak için uç noktaları kullanıma sunar. Her uç nokta, kullanılabilir sürümlerin dizinine veya belirli bir sürüm veya yapıt için ayrıntılı tarama raporuna erişim sağlar. Aşağıdaki bölümlerde her uç nokta, kullanılabilir işlemler ve beklenen istek ve yanıt biçimleri açıklanmaktadır.

AKS sürümleri

AKS yayın dizinini alma

Aşağıdaki uç nokta, kullanılabilir CVE raporlarına sahip tüm AKS yayın sürümlerinin dizinini döndürür:

GET /api/v1/aks-releases/_index

Örnek talep:

curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/_index

Örnek yanıt:

{
  "aks_release_versions": [
    "v20250427",
    "v20250519",
    "v20250617",
    "v20250720",
    "v20250808",
    "v20250829",
    "v20250921",
    "v20251012",
    "v20260104"
  ],
  "report_time": "2026-01-27T16:19:36.181877605Z"
}

Yanıt alanları:

Alan	Türü	Description
`aks_release_versions`	string[]	Kullanılabilir AKS sürüm sürümleri, kronolojik olarak sıralanmış
`report_time`	metin (ISO 8601)	Bu dizinin en son ne zaman oluşturulduğu

AKS sürümü için CVE raporunu alın

Aşağıdaki uç nokta, sistem ad alanları içindeki tüm kapsayıcı görüntüleri, etkin CVE'leri ve önceki sürümle karşılaştırıldığında CVE'lerin deltası da dahil olmak üzere belirli bir AKS yayın sürümü için ayrıntılı bir CVE raporu döndürür:

GET /api/v1/aks-releases/{version}/scan-reports

Yol parametreleri:

Parametre	Türü	Description	Example
`version`	string	Dizinden AKS sürümü	`v20260104`

Örnek talep:

curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/v20260104/scan-reports

Örnek yanıt (kısaltılmış):

{
  "aks_release_version": "v20260104",
  "previous_aks_release_version": "v20251012",
  "container_targets": [
    {
      "pod_namespace": "kube-system",
      "container_name": "coredns",
      "active_container_images": {
        "image_repo_tags": [
          "mcr.microsoft.com/oss/v2/kubernetes/coredns:v1.9.4-9"
        ],
        "image_repo_digests": [
          "mcr.microsoft.com/oss/v2/kubernetes/coredns:v1.9.4-9@sha256:718de5d12a..."
        ]
      },
      "active_cves": [
        {"id": "CVE-2025-47914"},
        {"id": "CVE-2025-58181"},
        {"id": "CVE-2025-61727"},
        {"id": "CVE-2025-61729"}
      ],
      "removed_container_images_from_previous_release": {
        "image_repo_tags": [],
        "image_repo_digests": []
      },
      "mitigated_cves_from_previous_release": []
    },
    {
      "pod_namespace": "gatekeeper-system",
      "container_name": "azure-policy-audit",
      "active_container_images": {
        "image_repo_tags": [
          "mcr.microsoft.com/azure-policy/policy-kubernetes-audit:1.15.3"
        ],
        "image_repo_digests": [
          "mcr.microsoft.com/azure-policy/policy-kubernetes-audit:1.15.3@sha256:67745758..."
        ]
      },
      "active_cves": [
        {"id": "CVE-2025-61727"},
        {"id": "CVE-2025-61729"}
      ],
      "removed_container_images_from_previous_release": {
        "image_repo_tags": [
          "mcr.microsoft.com/azure-policy/policy-kubernetes-audit:1.14.2"
        ],
        "image_repo_digests": [
          "mcr.microsoft.com/azure-policy/policy-kubernetes-audit:1.14.2@sha256:33218f96..."
        ]
      },
      "mitigated_cves_from_previous_release": [
        {"id": "CVE-2025-47912"},
        {"id": "CVE-2025-47914"},
        {"id": "CVE-2025-58181"}
      ]
    }
  ],
  "report_time": "2026-01-27T16:19:36.181877605Z"
}

Yanıt alanları:

Alan	Türü	Description
`aks_release_version`	string	Geçerli AKS sürümü
`previous_aks_release_version`	string	Önceki sürüm (delta hesaplamaları için kullanılır)
`container_targets`	AKSReleaseContainerTarget[]	Bu sürümdeki tüm kapsayıcı bileşenleri
`report_time`	metin (ISO 8601)	Rapor oluşturma zaman damgası

Kubernetes sürüm yayınları

Kubernetes sürüm dizini alma

Aşağıdaki uç nokta, kullanılabilir CVE raporlarına sahip tüm Kubernetes sürümlerinin dizinini döndürür:

GET /api/v1/aks-k8s-releases/_index

Örnek talep:

curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/_index

Örnek yanıt:

{
  "k8s_versions": [
    "1.27.102",
    "1.27.103",
    "1.28.100",
    "1.29.14",
    "1.30.0",
    "1.30.14",
    "1.31.1",
    "1.32.0",
    "1.32.10",
    "1.33.0",
    "1.33.6",
    "1.34.0",
    "1.34.2"
  ],
  "report_time": "2026-01-27T16:14:37.928201259Z"
}

Yanıt alanları:

Alan	Türü	Description
`k8s_versions`	string[]	Kullanılabilir Kubernetes sürümleri, semver'e göre sıralanmış
`report_time`	metin (ISO 8601)	Bu dizinin en son ne zaman oluşturulduğu

Kubernetes sürüm CVE raporunu alma

Aşağıdaki uç nokta, belirli bir Kubernetes sürümü için CVE raporunu döndürür ve bu sürüm için çekirdek Kubernetes bileşenleri ve AKS eklentileri tarafından kullanılan kapsayıcı görüntülerindeki güvenlik açıklarını ayrıntılı olarak açıklar:

GET /api/v1/aks-k8s-releases/{version}/scan-reports

Yol parametreleri:

Parametre	Türü	Description	Example
`version`	string	Dizinden Kubernetes sürümü	`1.33.2`

Örnek talep:

curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/1.33.2/scan-reports

Örnek yanıt (kısaltılmış):

{
  "k8s_version": "1.33.2",
  "container_targets": [
    {
      "container_image": "mcr.microsoft.com/oss/kubernetes/kube-apiserver",
      "active_container_images": {
        "image_repo_tags": [
          "mcr.microsoft.com/oss/kubernetes/kube-apiserver:v1.33.2"
        ],
        "image_repo_digests": [
          "mcr.microsoft.com/oss/kubernetes/kube-apiserver:v1.33.2@sha256:abc123..."
        ]
      },
      "active_cves": [
        {"id": "CVE-2025-47912"},
        {"id": "CVE-2025-58181"}
      ]
    },
    {
      "container_image": "mcr.microsoft.com/aks/aks-app-routing-operator",
      "active_container_images": {
        "image_repo_tags": [
          "mcr.microsoft.com/aks/aks-app-routing-operator:0.0.3"
        ],
        "image_repo_digests": [
          "mcr.microsoft.com/aks/aks-app-routing-operator:0.0.3@sha256:c1ff16ca..."
        ]
      },
      "active_cves": [
        {"id": "CVE-2023-39318"},
        {"id": "CVE-2023-39319"},
        {"id": "CVE-2023-39325"}
      ]
    }
  ],
  "report_time": "2026-01-27T16:14:37.928201259Z"
}

Yanıt alanları:

Alan	Türü	Description
`k8s_version`	string	Kubernetes sürümü (örneğin, `"1.33.2"`)
`container_targets`	AKSK8SContainerTarget[]	Bu Kubernetes sürümü için kapsayıcı görüntüleri
`report_time`	metin (ISO 8601)	Rapor oluşturma zaman damgası

VHD (düğüm görüntüsü) sürümleri

VHD yayınları dizinini alma

Aşağıdaki uç nokta, kullanılabilir CVE raporlarına sahip tüm VHD sürümlerinin dizinini döndürür:

GET /api/v1/vhd-releases/_index

Örnek talep:

curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/_index

Örnek yanıt (kısaltılmış):

{
  "vhd_release_versions": [
    "AKSAzureLinux-gen1/202507.02.0",
    "AKSAzureLinux-gen2/202512.06.0",
    "AKSAzureLinux-gen2fips/202510.03.0",
    "AKSAzureLinuxV3-gen2/202511.20.0",
    "AKSCBLMarinerV2-gen2/202508.20.0",
    "AKSUbuntu-gen1-2204containerd/202601.13.0",
    "AKSUbuntu-gen2-2404containerd/202601.13.0"
  ],
  "report_time": "2026-01-27T16:21:23.056129543Z"
}

Yanıt alanları:

Alan	Türü	Description
`vhd_release_versions`	string[]	`{distro}/{version}` biçiminde kullanılabilen VHD sürümleri
`report_time`	metin (ISO 8601)	Bu dizinin en son ne zaman oluşturulduğu

Kullanılabilir dağıtımlar:

Dağıtım ön eki	Description
`AKSAzureLinux-gen1`	Azure Linux V2, 1. Nesil
`AKSAzureLinux-gen2`	Azure Linux V2, 2. Nesil
`AKSAzureLinux-gen1fips`	Azure Linux V2, 1. Nesil, FIPS özellikli
`AKSAzureLinux-gen2fips`	Azure Linux V2, 2. Nesil, FIPS özellikli
`AKSAzureLinux-gen2kata`	Azure Linux V2, 2. Nesil, Kata kapsayıcıları
`AKSAzureLinux-gen2tl`	Azure Linux V2, 2. Nesil, TL varyantı
`AKSAzureLinuxV3-gen1`	Azure Linux V3, 1. Nesil
`AKSAzureLinuxV3-gen2`	Azure Linux V3, 2. Nesil
`AKSAzureLinuxV3-gen1fips`	Azure Linux V3, 1. Nesil, FIPS özellikli
`AKSAzureLinuxV3-gen2fips`	Azure Linux V3, 2. Nesil, FIPS özellikli
`AKSAzureLinuxV3-gen2tl`	Azure Linux V3, 2. Nesil, TL varyantı
`AKSCBLMarinerV2-gen1`	CBL-Mariner V2, 1. Nesil
`AKSCBLMarinerV2-gen2`	CBL-Mariner V2, 2. Nesil
`AKSCBLMarinerV2-gen1fips`	CBL-Mariner V2, 1. Nesil, FIPS özellikli
`AKSCBLMarinerV2-gen2fips`	CBL-Mariner V2, 2. Nesil, FIPS özellikli
`AKSCBLMarinerV2-gen2kata`	CBL-Mariner V2, 2. Nesil, Kata kapsayıcıları
`AKSCBLMarinerV2-gen2tl`	CBL-Mariner V2, 2. Nesil, TL varyant
`AKSUbuntu-gen1-2004fipscontainerd`	Ubuntu 20.04, 1. Nesil, FIPS
`AKSUbuntu-gen1-2204containerd`	Ubuntu 22.04, 1. Nesil
`AKSUbuntu-gen1-2404containerd`	Ubuntu 24.04, 1. Nesil
`AKSUbuntu-gen2-2004cvmcontainerd`	Ubuntu 20.04, 2. Nesil, Gizli VM
`AKSUbuntu-gen2-2004fipscontainerd`	Ubuntu 20.04, 2. Nesil, FIPS
`AKSUbuntu-gen2-2204containerd`	Ubuntu 22.04, 2. Nesil
`AKSUbuntu-gen2-2404containerd`	Ubuntu 24.04, 2. Nesil
`AKSUbuntu-gen2-2204tlcontainerd`	Ubuntu 22.04, 2. Nesil, TL varyant
`AKSUbuntu-gen2-2404tlcontainerd`	Ubuntu 24.04, 2. Nesil, TL varyantı

VHD sürümüne ait CVE raporunu alın

Aşağıdaki uç nokta, hem işletim sistemi paketleri hem de bu sürüme dahil edilen kapsayıcı görüntüleri de dahil olmak üzere belirli bir VHD sürümü için CVE raporunu döndürür:

GET /api/v1/vhd-releases/{distro}/{version}/scan-reports

Yol parametreleri:

Parametre	Türü	Description	Example
`distro`	string	Linux dağıtım tanımlayıcısı	`AKSUbuntu-gen2-2204containerd`
`version`	string	VHD sürüm sürümü	`202601.13.0`

Örnek talep:

curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/AKSUbuntu-gen2-2204containerd/202601.13.0/scan-reports

Örnek yanıt (kısaltılmış):

{
  "distro_name": "AKSUbuntu/gen2/2204containerd",
  "vhd_release_version": "202601.13.0",
  "previous_vhd_release_version": "202512.06.0",
  "os_package_targets": [
    {
      "name": "libtasn1-6",
      "version": "4.18.0-4ubuntu0.2",
      "active_cves": [],
      "previous_version": "4.18.0-4ubuntu0.1",
      "mitigated_cves_from_previous_release": [
        {"id": "CVE-2021-46848"},
        {"id": "CVE-2025-13151"}
      ]
    },
    {
      "name": "python3.10",
      "version": "3.10.12-1~22.04.13",
      "active_cves": [],
      "previous_version": "3.10.12-1~22.04.12",
      "mitigated_cves_from_previous_release": [
        {"id": "CVE-2025-13836"}
      ]
    }
  ],
  "container_targets": [
    {
      "container_image": "mcr.microsoft.com/azuremonitor/containerinsights/ciprod/prometheus-collector/images",
      "active_container_images": {
        "image_repo_tags": [
          "mcr.microsoft.com/azuremonitor/containerinsights/ciprod/prometheus-collector/images:6.24.1-main-11-14-2025-15146744-cfg"
        ],
        "image_repo_digests": [
          "mcr.microsoft.com/azuremonitor/containerinsights/ciprod/prometheus-collector/images:6.24.1-main-11-14-2025-15146744-cfg@sha256:6ce08d12..."
        ]
      },
      "active_cves": [],
      "removed_container_images_from_previous_release": {
        "image_repo_tags": [
          "mcr.microsoft.com/azuremonitor/containerinsights/ciprod/prometheus-collector/images:6.24.0-main-10-20-2025-fe8f6d51-targetallocator"
        ],
        "image_repo_digests": [
          "mcr.microsoft.com/azuremonitor/containerinsights/ciprod/prometheus-collector/images:6.24.0-main-10-20-2025-fe8f6d51-targetallocator@sha256:314e20ca..."
        ]
      },
      "mitigated_cves_from_previous_release": [
        {"id": "CVE-2025-47914"},
        {"id": "CVE-2025-4802"},
        {"id": "CVE-2025-58181"},
        {"id": "CVE-2025-61727"},
        {"id": "CVE-2025-61729"}
      ]
    }
  ],
  "report_time": "2026-01-27T16:21:23.056129543Z"
}

Yanıt alanları:

Alan	Türü	Description
`distro_name`	string	Linux dağıtım adı (örneğin, `"AKSAzureLinux/gen2"`)
`vhd_release_version`	string	Geçerli VHD sürüm sürümü
`previous_vhd_release_version`	string	Önceki VHD yayın sürümü
`os_package_targets`	AKSVHDOSPackageTarget[]	Bu VHD'deki işletim sistemi paketleri
`container_targets`	AKSVHDContainerTarget[]	Bu VHD'de paketlenmiş kapsayıcı görüntüleri
`report_time`	metin (ISO 8601)	Rapor oluşturma zaman damgası

Konteyner görüntüleri

Kapsayıcı görüntüleri uç noktaları, tek tek kapsayıcı görüntüleri için görüntü başına CVE tarama raporları ve yayınlar arası risk azaltma izlemesi sağlar. Bu uç noktalar için _index listesi yoktur; tam imaj yolunu kullanarak gezinirsiniz.

Kapsayıcı imajı CVE tarama raporunu al

Aşağıdaki uç nokta, tam görüntü yolu ve etiketiyle tanımlanan belirli bir kapsayıcı görüntüsü için bir CVE tarama raporu alır:

GET /api/v1/container-images/{image}:{tag}/scan-reports

Yol parametreleri:

Parametre	Türü	Description	Example
`image`	string	Kayıt deposu dâhil tam görüntü adı	`mcr.microsoft.com/oss/kubernetes/kube-proxy`
`tag`	string	Resim etiketi	`v1.31.11`

Örnek talep:

curl -s https://cve-api.prod-aks.azure.com/api/v1/container-images/mcr.microsoft.com/oss/kubernetes/kube-proxy:v1.31.11/scan-reports

Örnek yanıt (kısaltılmış):

{
  "image_repo_tags": [
    "mcr.microsoft.com/oss/kubernetes/kube-proxy:v1.31.11"
  ],
  "image_repo_digests": [
    "mcr.microsoft.com/oss/kubernetes/kube-proxy:v1.31.11@sha256:abc123..."
  ],
  "report_time": "2026-02-20T16:12:42.081442479Z",
  "active_cves": [
    {
      "scanner": {
        "name": "trivy",
        "version": "0.69.1"
      },
      "cves": [
        {"id": "CVE-2024-13176"},
        {"id": "CVE-2025-47914"}
      ]
    }
  ]
}

Yanıt alanları:

Alan	Türü	Description
`image_repo_tags`	string[]	Taranan görüntü için resim etiketleri
`image_repo_digests`	string[]	Desteklenen tüm platformlar için görüntü özetleri
`report_time`	metin (ISO 8601)	Rapor oluşturma zaman damgası
`active_cves`	CVEList[]	Tarayıcıya göre gruplandırılmış etkin CVE'ler

Kapsayıcı imajı CVE azaltma raporunu alın

Aşağıdaki uç nokta, belirli bir kapsayıcı imaj deposu için bir CVE giderim raporunu getirir ve hangi CVE'lerin hangi bileşen sürümleri ve yayımlarında görüldüğünü ve hangi sürüm ve yayımlarda giderildiklerini gösterir:

GET /api/v1/container-images/{image}/mitigation-reports

Yol parametreleri:

Parametre	Türü	Description	Example
`image`	string	Kayıt dahil tam imaj adı (etiket olmadan)	`mcr.microsoft.com/oss/kubernetes/kube-proxy`

Örnek talep:

curl -s https://cve-api.prod-aks.azure.com/api/v1/container-images/mcr.microsoft.com/oss/kubernetes/kube-proxy/mitigation-reports

Örnek yanıt (kısaltılmış):

{
  "container_image": "mcr.microsoft.com/oss/kubernetes/kube-proxy",
  "mitigations": [
    {
      "cve": {"id": "CVE-2023-2253"},
      "seen_in_component_versions": ["v1.27.102-akslts"],
      "seen_in_aks_release_versions": [],
      "seen_in_aks_k8s_release_versions": [],
      "seen_in_vhd_release_versions": ["AKSAzureLinux-gen1/202507.02.0"],
      "mitigated_in_component_versions": [],
      "mitigated_in_aks_release_versions": [],
      "mitigated_in_aks_k8s_release_versions": [],
      "mitigated_in_vhd_release_versions": []
    }
  ]
}

Yanıt alanları:

Alan	Türü	Description
`container_image`	string	Etiketsiz resim adı
`mitigations`	CVEMitigation[]	Bu görüntü için CVE azaltma girdileri

VHD OS paketleri

VHD OS paketi uç noktaları, VHD düğümü görüntülerinde yüklü tek tek işletim sistemi paketleri için paket başına CVE tarama raporları ve yayınlar arası azaltma izlemesi sağlar. Bu uç noktaların bir _index listesi yoktur; paket adına göre gezinebilirsiniz.

VHD OS paketi CVE tarama raporunu alma

Aşağıdaki uç nokta, VHD düğümü görüntülerinde yüklü belirli bir işletim sistemi paketi sürümü için bir CVE tarama raporu alır:

GET /api/v1/vhd-packages/{name}/{version}/scan-reports

Yol parametreleri:

Parametre	Türü	Description	Example
`name`	string	İşletim sistemi paketi adı (küçük harf)	`openssl`
`version`	string	Paket sürümü	`3.0.2-0ubuntu1.20`

Örnek talep:

curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/3.0.2-0ubuntu1.20/scan-reports

Örnek yanıt:

{
  "name": "openssl",
  "version": "3.0.2-0ubuntu1.20",
  "active_cves": [
    {"id": "CVE-2025-15467"},
    {"id": "CVE-2025-68160"}
  ],
  "report_time": "2026-02-20T16:14:09.253455099Z"
}

Yanıt alanları:

Alan	Türü	Description
`name`	string	Paket adı
`version`	string	Paket sürümü
`active_cves`	CVE[]	Kullanılabilir düzeltmeleri olan etkin CVE'ler
`report_time`	metin (ISO 8601)	Rapor oluşturma zaman damgası

VHD işletim sistemi paketi CVE risk azaltma raporunu alma

Aşağıdaki uç nokta, belirli bir işletim sistemi paketi için bir CVE risk azaltma raporu alır ve hangi CVE'lerin hangi paket sürümlerinde ve VHD sürümlerinde görüldüğünü ve hangi sürümlerde azaltıldığını gösterir:

GET /api/v1/vhd-packages/{name}/mitigation-reports

Yol parametreleri:

Parametre	Türü	Description	Example
`name`	string	İşletim sistemi paketi adı (küçük harf)	`openssl`

Örnek talep:

curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/mitigation-reports

Örnek yanıt (kısaltılmış):

{
  "package_name": "openssl",
  "mitigations": [
    {
      "cve": {"id": "CVE-2025-15467"},
      "seen_in_component_versions": ["3.3.3-2.azl3", "3.3.3-3.azl3"],
      "seen_in_aks_release_versions": [],
      "seen_in_aks_k8s_release_versions": [],
      "seen_in_vhd_release_versions": ["AKSAzureLinuxV3-gen1/202507.02.0"],
      "mitigated_in_component_versions": [],
      "mitigated_in_aks_release_versions": [],
      "mitigated_in_aks_k8s_release_versions": [],
      "mitigated_in_vhd_release_versions": []
    }
  ]
}

Yanıt alanları:

Alan	Türü	Description
`package_name`	string	İşletim sistemi paketi adı
`mitigations`	CVEMitigation[]	Bu paket için CVE azaltma girdileri

Veri modelleri

Aşağıdaki bölümlerde CVE girişlerinin yapısı, kapsayıcı görüntüsü başvuruları, AKS yayın bileşenleri, VHD OS paketleri ve aralarındaki ilişkiler dahil olmak üzere AKS Güvenlik Açığı Veri API'si tarafından döndürülen veri modelleri açıklanmaktadır.

CVE

CVE veri modeli, Ortak Güvenlik Açıkları ve Etkilenmeler tanımlayıcısıdır.

Alan	Türü	Description
`id`	string	CVE tanımlayıcısı (örneğin, `"CVE-2024-13176"`, `"GHSA-2464-8j7c-4cjm"`)

ContainerImages

ContainerImages veri modeli, hem insan tarafından okunabilir etiketler hem de içerik adreslenebilir özetler de dahil olmak üzere bir dizi kapsayıcı görüntüsü başvurularını temsil eder.

Alan	Türü	Description
`image_repo_tags`	string[]	Görüntü etiketleri (örneğin, `"mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9"`)
`image_repo_digests`	string[]	Desteklenen tüm platformlar için görüntü özetleri (örneğin, `"mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9@sha256:abc..."`)

Note

Digest'ler, çok mimarili manifestlerden tüm Linux platformu varyantlarını (amd64, arm64) içerir. Bu, düğümünüzün hangi platforma özgü özet çektiğinden bağımsız olarak CVE verilerinin eşleştirilmesine olanak tanır.

AKSReleaseContainerTarget

AKSReleaseContainerTarget veri modeli, belirli bir AKS sürümü içindeki bir kapsayıcı bileşenini temsil eder; bu bileşen, çalıştığı pod ad alanı ve kapsayıcı adıyla tanımlanır ve ayrıca kullandığı kapsayıcı görüntüleri ile onu etkileyen CVE'leri de içerir.

Alan	Türü	Description
`pod_namespace`	string	Kubernetes ad alanı (örneğin, `"kube-system"`, `"calico-system"`)
`container_name`	string	Kapsayıcı adı (örneğin, `"coredns"`, `"calico-node"`)
`active_container_images`	ContainerImages	Bu bileşen için şu anda çalışan kapsayıcı görüntüleri
`active_cves`	CVE[]	Bu bileşeni şu anda etkileyen, mevcut düzeltmelere sahip CVE’ler
`removed_container_images_from_previous_release`	ContainerImages	Önceki sürümde bulunan ancak artık çalışmayan görüntüler
`mitigated_cves_from_previous_release`	CVE[]	Önceki sürümde mevcut olan ancak bu sürümde düzeltilen CV'ler

AKSK8SContainerTarget

AKSK8SContainerTarget veri modeli, belirli bir Kubernetes sürümüyle ilişkilendirilmiş bir kapsayıcı görüntüsünü temsil eder. Bu görüntü için etiketli görüntü başvuruları ve özetleri ve onu etkileyen CVE'ler de buna dahildir.

Alan	Türü	Description
`container_image`	string	Etiketsiz görüntü adı (örneğin, `"mcr.microsoft.com/oss/kubernetes/kube-apiserver"`)
`active_container_images`	ContainerImages	Etiketli görüntü referansları ve özet değerleri
`active_cves`	CVE[]	Kullanılabilir düzeltmeleri olan etkin CVE'ler

AKSVHDContainerTarget

AKSVHDContainerTarget veri modeli, VHD düğüm görüntüsünde yer alan bir kapsayıcı görüntüsünü ve onu etkileyen etiketli görüntü başvurularını, özet değerlerini ve CVE'leri temsil eder.

Alan	Türü	Description
`container_image`	string	Etiketsiz resim adı
`active_container_images`	ContainerImages	Etiketli görüntü referansları ve özet değerleri
`active_cves`	CVE[]	Kullanılabilir düzeltmeleri olan etkin CVE'ler
`removed_container_images_from_previous_release`	ContainerImages	Önceki VHD sürümünden bu yana kaldırılan görüntüler
`mitigated_cves_from_previous_release`	CVE[]	Önceki VHD sürümünden bu yana düzeltilen CVE'ler

AKSVHDOSPackageTarget

AKSVHDOSPackageTarget veri modeli, VHD düğüm görüntüsünde yüklü işletim sistemi düzeyinde bir paketi, yüklenen sürüm, onu etkileyen CVE'ler ve önceki VHD sürümündeki değişiklikleri temsil eder.

Alan	Türü	Description
`name`	string	Paket adı (örneğin, `"kernel"`, `"containerd"`, `"systemd"`)
`version`	string	Paket sürümü (örneğin, `"6.1.109.2-1.cm2"`)
`active_cves`	CVE[]	Kullanılabilir düzeltmeleri olan etkin CVE'ler
`previous_version`	string	Önceki VHD sürümünden sürüm (değişmediyse boş)
`mitigated_cves_from_previous_release`	CVE[]	Önceki VHD sürümünden bu yana düzeltilen CVE'ler

CVEScanner

CVEScanner veri modeli, kapsayıcı görüntüleri için CVE tarama sonuçları üreten bir güvenlik açığı tarayıcısının meta verilerini temsil eder.

Alan	Türü	Description
`name`	string	Tarayıcı adı (örneğin, `"trivy"`)
`version`	string	Tarayıcı sürümü (örneğin, `"0.69.1"`)

CVEList

CVEList veri modeli, belirli bir kapsayıcı görüntüsü için belirli bir güvenlik açığı tarayıcısı tarafından tespit edilen bir CVE kümesini temsil eder. Her girdi, tarayıcı meta verilerini algılanan CVE'lerin listesiyle ilişkilendirir.

Alan	Türü	Description
`scanner`	CVEScanner	Bu sonuçları üreten tarayıcı
`cves`	CVE[]	Bu tarayıcı tarafından algılanan CVE'ler

CVEMitigation

CVEMitigation veri modeli, bileşen sürümleri ve sürüm türleri arasında tek bir CVE izler ve nerede gözlemlendiği ve nerede azaltıldığını gösterir.

Alan	Türü	Description
`cve`	CVE	Takip edilen CVE
`seen_in_component_versions`	string[]	Bu CVE'nin algılandığı bileşen sürümleri (görüntü etiketleri veya paket sürümleri)
`seen_in_aks_release_versions`	string[]	Bu CVE'nin algılandığı AKS sürüm sürümleri
`seen_in_aks_k8s_release_versions`	string[]	Bu CVE'nin algılandığı Kubernetes sürüm sürümleri
`seen_in_vhd_release_versions`	string[]	Bu CVE'nin algılandığı VHD sürüm sürümleri
`mitigated_in_component_versions`	string[]	Bu CVE'nin düzeltildiği bileşen sürümleri
`mitigated_in_aks_release_versions`	string[]	Bu CVE'nin düzeltildiği AKS sürüm sürümleri
`mitigated_in_aks_k8s_release_versions`	string[]	Bu CVE'nin düzeltildiği Kubernetes sürüm sürümleri
`mitigated_in_vhd_release_versions`	string[]	Bu CVE'nin düzeltildiği VHD sürüm sürümleri

Delta izleme

AKS sürümü ve VHD yayın raporları, geçerli sürümü önceki sürümle karşılaştıran delta alanları içerir:

mitigated_cves_from_previous_release: Önceki sürümde mevcut olan ancak artık algılanmayan CVE'ler. Bu, güvenlik açığının düzeltildiği anlamına gelir (örneğin, bileşen sürümü çarpması yoluyla).
removed_container_images_from_previous_release: Önceki sürümde çalışan ancak geçerli sürümde bulunmayan kapsayıcı görüntüleri.

Note

Kubernetes sürüm raporları delta alanları içermez .

Çok mimarili özetler

Her kapsayıcı görüntüsü, farklı CPU mimarileri (amd64, arm64) için birden çok özet referansı içerebilir. API, çok mimarili bildirimlerden tüm Linux platform özetlerini içerir, böylece düğümünüzün hangi platform özetini çektiğinden bağımsız olarak CVE verilerini eşleştirebilirsiniz.

Rapor sürümü biçimleri

AKS Güvenlik Açığı Verileri API raporları, bildirilen sürümün türüne bağlı olarak farklı sürüm oluşturma düzenleri kullanır. Aşağıdaki tabloda AKS sürümleri, Kubernetes sürümleri ve VHD sürümleri için kullanılan biçimler özetlenmektedir:

Yayın türü	Format	Example
AKS sürümü	`v{YYYYMMDD}`	`v20260104`
Kubernetes sürümü	Semver	`1.33.2`
VHD sürümü	`{distro}/{YYYYMM.DD.patch}`	`AKSAzureLinux-gen2/202512.06.0`

AKS Güvenlik Açığı Verileri API’si hakkında daha fazla bilgi için bkz. Azure Kubernetes Service (AKS) için Güvenlik Açığı Verileri API’sine genel bakış.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Son güncelleştirme: 2026-05-19

Azure Kubernetes Service (AKS) Güvenlik Açığı Veri API'sini kullanma

CVE raporlarını sorgulama

AKS sürümü için CVE'leri sorgulama

Kubernetes sürümü için CVE'leri sorgulama

Düğüm görüntüsü (VHD) için CVE'leri sorgulayın

Belirli bir kapsayıcı görüntüsü için CVE'leri sorgulama

Belirli bir işletim sistemi paketi için CVE'leri sorgulama

Bitiş noktası

AKS sürümleri

AKS yayın dizinini alma

AKS sürümü için CVE raporunu alın

Kubernetes sürüm yayınları

Kubernetes sürüm dizini alma

Kubernetes sürüm CVE raporunu alma

VHD (düğüm görüntüsü) sürümleri

VHD yayınları dizinini alma

VHD sürümüne ait CVE raporunu alın

Konteyner görüntüleri

Kapsayıcı imajı CVE tarama raporunu al

Kapsayıcı imajı CVE azaltma raporunu alın

VHD OS paketleri

VHD OS paketi CVE tarama raporunu alma

VHD işletim sistemi paketi CVE risk azaltma raporunu alma

Veri modelleri

CVE

ContainerImages

AKSReleaseContainerTarget

AKSK8SContainerTarget

AKSVHDContainerTarget

AKSVHDOSPackageTarget

CVEScanner

CVEList

CVEMitigation

Delta izleme

Çok mimarili özetler

Rapor sürümü biçimleri

İlgili içerik

Geri Bildirim

Ek kaynaklar