使用 Azure Kubernetes Service (AKS) Vulnerability Data API

AKS 漏洞資料 API 可讓您以程式設計方式唯讀檢視由 AKS 管理的平台元件中偵測到的漏洞。 此 API 專為安全 團隊、合規團隊及平台擁有者 設計,讓他們能獲得影響 AKS 管理產物的漏洞權威資訊,且不受特定叢集執行狀態影響。

在本文中,您將學習如何使用 AKS 漏洞資料 API,程式化地取得 AKS 管理產物的 CVE 報告,包括 AKS 版本、Kubernetes 版本、節點映像檔、容器映像檔及作業系統套件。 它提供了 API 請求的範例,並示範如何解讀回應,以支援大規模的 CVE 分析、自動化,以及與安全掃描結果的關聯。 關於 API 背後概念的概述,請參見 Vulnerability Data API Azure Kubernetes Service (AKS) overview。

查詢 CVE 報告

以下範例示範如何查詢 AKS 漏洞資料 API,以取得 AKS 版本、Kubernetes 版本、節點映像檔、容器映像檔及作業系統套件的 CVE 報告。

查詢 AKS 版本的 CVE 資訊

# 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 版本的 CVE

# 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 '.'

查詢節點映像檔(VHD)的 CVE

# 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 '.'

查詢特定容器映像的 CVE 項目

# 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 '.'

查詢特定 OS 套件的 CVE

# 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 '.'

端點

AKS 漏洞資料 API 提供端點,用於檢索 AKS 版本、Kubernetes 版本、節點映像、容器映像及作業系統套件的 CVE 報告。 每個端點都能存取可用版本的索引,或是針對特定版本或產物的詳細掃描報告。 以下章節將說明每個端點、可用的操作,以及預期的請求與回應格式。

AKS 發行版本

取得 AKS 版本索引

以下端點回傳所有 AKS 版本及可用 CVE 報告的索引:

GET /api/v1/aks-releases/_index

範例請求:

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

範例回應:

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

回應欄位:

Field 類型 Description
aks_release_versions string[] 依時間順序排序的可用 AKS 發行版本
report_time 字串 (ISO 8601) 此索引最後一次產生的時間

取得 AKS 發行版本的 CVE 報告

以下端點會傳回特定 AKS 發行版本的詳細 CVE 報告,包括系統命名空間中的所有容器映像、其現行的 CVE,以及與前一個發行版本相比的 CVE 差異:

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

路徑參數:

參數 類型 Description 範例
version 字串 從索引取得的 AKS 發行版本 v20260104

範例請求:

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

範例回應(縮寫):

{
  "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"
}

回應欄位:

Field 類型 Description
aks_release_version 字串 目前的 AKS 發行版
previous_aks_release_version 字串 先前的發行版本 (用於差異計算)
container_targets AKSReleaseContainerTarget[] 此版本中的所有容器元件
report_time 字串 (ISO 8601) 報表產生時間戳記

Kubernetes 版本釋出

取得 Kubernetes 版本索引

以下端點會回傳所有 Kubernetes 版本及可用 CVE 報告的索引:

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

範例請求:

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

範例回應:

{
  "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"
}

回應欄位:

Field 類型 Description
k8s_versions string[] 可用 Kubernetes 版本,依 semver 排序
report_time 字串 (ISO 8601) 此索引最後一次產生的時間

取得 Kubernetes 版本的 CVE 報告

以下端點回傳特定 Kubernetes 版本的 CVE 報告,詳述該版本核心 Kubernetes 元件及 AKS 外掛所使用的容器映像中的漏洞:

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

路徑參數:

參數 類型 Description 範例
version 字串 來自索引的 Kubernetes 版本 1.33.2

範例請求:

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

範例回應(縮寫):

{
  "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"
}

回應欄位:

Field 類型 Description
k8s_version 字串 Kubernetes 版本(例如, "1.33.2")
container_targets AKSK8SContainerTarget[] 此 Kubernetes 版本的容器映像檔
report_time 字串 (ISO 8601) 報表產生時間戳記

VHD (節點映像) 發行

取得 VHD 發行索引

以下端點回傳所有包含可用 CVE 報告的 VHD 版本索引:

GET /api/v1/vhd-releases/_index

範例請求:

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

範例回應(縮寫):

{
  "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"
}

回應欄位:

Field 類型 Description
vhd_release_versions string[] 提供{distro}/{version}格式的 VHD 發行版本
report_time 字串 (ISO 8601) 此索引最後一次產生的時間

可用發行版:

發行版前綴 Description
AKSAzureLinux-gen1 Azure Linux V2, Generation 1
AKSAzureLinux-gen2 Azure Linux V2, Generation 2
AKSAzureLinux-gen1fips Azure Linux V2,Gen 1,已啟用 FIPS
AKSAzureLinux-gen2fips Azure Linux V2,Gen 2,已啟用 FIPS
AKSAzureLinux-gen2kata Azure Linux V2, Gen 2, Kata containers
AKSAzureLinux-gen2tl Azure Linux V2, Gen 2, TL variant
AKSAzureLinuxV3-gen1 Azure Linux V3, Generation 1
AKSAzureLinuxV3-gen2 Azure Linux V3, Generation 2
AKSAzureLinuxV3-gen1fips Azure Linux V3,Gen 1,已啟用 FIPS
AKSAzureLinuxV3-gen2fips Azure Linux V3、Gen 2、已啟用 FIPS
AKSAzureLinuxV3-gen2tl Azure Linux V3, Gen 2, TL variant
AKSCBLMarinerV2-gen1 CBL-Mariner V2,第一世代
AKSCBLMarinerV2-gen2 CBL-Mariner V2,第二代
AKSCBLMarinerV2-gen1fips CBL-Mariner V2,第一代,支援 FIPS
AKSCBLMarinerV2-gen2fips CBL-Mariner V2,Gen 2,支援 FIPS
AKSCBLMarinerV2-gen2kata CBL-Mariner V2、Gen 2、Kata Containers
AKSCBLMarinerV2-gen2tl CBL-Mariner V2、Gen 2、TL 變體
AKSUbuntu-gen1-2004fipscontainerd Ubuntu 20.04,第一代,FIPS
AKSUbuntu-gen1-2204containerd Ubuntu 22.04,第一代
AKSUbuntu-gen1-2404containerd Ubuntu 24.04,第一代
AKSUbuntu-gen2-2004cvmcontainerd Ubuntu 20.04,Gen 2,機密虛擬機
AKSUbuntu-gen2-2004fipscontainerd Ubuntu 20.04、Gen 2、FIPS
AKSUbuntu-gen2-2204containerd Ubuntu 22.04,第二代
AKSUbuntu-gen2-2404containerd Ubuntu 24.04,第二代
AKSUbuntu-gen2-2204tlcontainerd Ubuntu 22.04,第二代,TL 版本
AKSUbuntu-gen2-2404tlcontainerd Ubuntu 24.04,第二代,TL 版本

取得 VHD 發行版本的 CVE 報告

以下端點回傳特定 VHD 版本的 CVE 報告,包含該版本中包含的作業系統套件與容器映像檔:

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

路徑參數:

參數 類型 Description 範例
distro 字串 Linux 發行版識別碼 AKSUbuntu-gen2-2204containerd
version 字串 VHD 發行版本 202601.13.0

範例請求:

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

範例回應(縮寫):

{
  "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"
}

回應欄位:

Field 類型 Description
distro_name 字串 Linux 發行版名稱(例如, "AKSAzureLinux/gen2")
vhd_release_version 字串 目前的 VHD 發行版本
previous_vhd_release_version 字串 先前的 VHD 發行版本
os_package_targets AKSVHDOSPackageTarget[] 此 VHD 中的作業系統套件
container_targets AKSVHDContainerTarget[] 容器映像檔收錄於此 VHD 中
report_time 字串 (ISO 8601) 報表產生時間戳記

容器映像

容器映像端點提供每張映像的 CVE 掃描報告,以及針對個別容器映像的跨發行版本緩解追蹤。 這些端點沒有 _index 清單;你需要透過完整的映像路徑存取。

取得容器映像 CVE 掃描報告

以下端點會取得特定容器映像的 CVE 掃描報告,該影像可透過完整影像路徑與標籤識別:

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

路徑參數:

參數 類型 Description 範例
image 字串 完整映像名稱(包含登錄位址) mcr.microsoft.com/oss/kubernetes/kube-proxy
tag 字串 影像標籤 v1.31.11

範例請求:

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

範例回應(縮寫):

{
  "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"}
      ]
    }
  ]
}

回應欄位:

Field 類型 Description
image_repo_tags string[] 已掃描映像的映像標籤
image_repo_digests string[] 所有支援平台的影像摘要
report_time 字串 (ISO 8601) 報表產生時間戳記
active_cves CVEList[] 依掃描器分組的現行 CVE

取得容器映像 CVE 緩解報告

以下端點會取得特定容器映像儲存庫的 CVE 緩解報告,並顯示哪些 CVE 出現在哪些元件版本與版本中,以及在哪些版本與版本中被緩解:

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

路徑參數:

參數 類型 Description 範例
image 字串 包含登錄庫的完整映像名稱(不含標籤) mcr.microsoft.com/oss/kubernetes/kube-proxy

範例請求:

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

範例回應(縮寫):

{
  "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": []
    }
  ]
}

回應欄位:

Field 類型 Description
container_image 字串 圖片名稱無標籤
mitigations CVEMitigation[] 此映像的 CVE 緩解條目

VHD 作業系統套件

VHD OS 套件端點提供每個套件的 CVE 掃描報告及針對安裝於 VHD 節點映像中的個別 OS 套件的跨發行版本緩解追蹤。 這些端點沒有 _index 清單;你是透過套件名稱來導航。

取得 VHD 作業系統套件的 CVE 掃描報告

以下端點會取得安裝於 VHD 節點映像中的特定作業系統套件版本的 CVE 掃描報告:

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

路徑參數:

參數 類型 Description 範例
name 字串 作業系統套件名稱(小寫) openssl
version 字串 套件版本 3.0.2-0ubuntu1.20

範例請求:

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

範例回應:

{
  "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"
}

回應欄位:

Field 類型 Description
name 字串 封裝名稱
version 字串 套件版本
active_cves CVE[] 已有可用修正的現行 CVE
report_time 字串 (ISO 8601) 報表產生時間戳記

取得 VHD 作業系統套件的 CVE 緩解報告

以下端點會取得特定作業系統套件的 CVE 緩解報告,並顯示在哪些套件版本與 VHD 版本中出現了哪些 CVE,以及在哪些版本中被緩解:

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

路徑參數:

參數 類型 Description 範例
name 字串 作業系統套件名稱(小寫) openssl

範例請求:

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

範例回應(縮寫):

{
  "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": []
    }
  ]
}

回應欄位:

Field 類型 Description
package_name 字串 作業系統套件名稱
mitigations CVEMitigation[] 此套件的 CVE 緩解條目

資料模型

以下章節將描述 AKS 漏洞資料 API 回傳的資料模型,包括 CVE 條目結構、容器映像參考、AKS 發行元件、VHD 作業系統套件,以及它們之間的關係。

CVE

CVE 資料模型是一種常見漏洞與暴露識別碼。

Field 類型 Description
id 字串 CVE 識別碼(例如, "CVE-2024-13176", "GHSA-2464-8j7c-4cjm")

容器圖片

ContainerImages 資料模型代表一組容器影像參考,包括人類可讀的標籤與內容可尋址摘要。

Field 類型 Description
image_repo_tags string[] 圖片標籤(例如, "mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9")
image_repo_digests string[] 適用於所有支援平台的映像摘要(例如,"mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9@sha256:abc...")

Note

摘要包含所有來自多架構清單的 Linux 平台變體(amd64、arm64)。 無論節點提取的是哪個平台特定的摘要,這樣都會允許比對 CVE 資料。

AKSReleaseContainerTarget

AKSReleaseContainerTarget 資料模型代表特定 AKS 版本中的容器元件,透過 pod 命名空間與執行的容器名稱,以及所使用的容器映像檔及影響其 CVE 來識別。

Field 類型 Description
pod_namespace 字串 Kubernetes 命名空間(例如, "kube-system", "calico-system")
container_name 字串 容器名稱(例如, "coredns", "calico-node")
active_container_images 容器圖片 此元件目前正在執行的容器映像檔
active_cves CVE[] 目前影響此元件且已有可用修補程式的 CVE
removed_container_images_from_previous_release 容器圖片 存在於先前發行版本中但已不再執行的映像
mitigated_cves_from_previous_release CVE[] 這些 CVE 在前一個版本中存在,但在這個版本中已被修正

AKSK8SContainerTarget

AKSK8SContainerTarget 資料模型代表與特定 Kubernetes 版本相關的容器映像,包括該映像的標籤映像參考與摘要,以及影響它的 CVE。

Field 類型 Description
container_image 字串 圖片名稱但無標籤(例如, "mcr.microsoft.com/oss/kubernetes/kube-apiserver")
active_container_images 容器圖片 已加標籤的映像參照與摘要
active_cves CVE[] 已有可用修正的現行 CVE

AKSVHDContainerTarget

AKSVHDContainerTarget 資料模型代表包含在 VHD 節點映像中的容器映像,以及帶有標記的映像參照、摘要和會影響該映像的 CVE。

Field 類型 Description
container_image 字串 圖片名稱無標籤
active_container_images 容器圖片 已加標籤的映像參照與摘要
active_cves CVE[] 已有可用修正的現行 CVE
removed_container_images_from_previous_release 容器圖片 自上次 VHD 發行以來已移除的影像
mitigated_cves_from_previous_release CVE[] 自上次 VHD 版本以來,CVE 已修正

AKSVHDOSPackageTarget

AKSVHDOSPackageTarget 資料模型代表安裝在 VHD 節點映像中的作業系統層級套件,連同已安裝的版本、影響它的 CVE,以及與前一版本的變更。

Field 類型 Description
name 字串 套件名稱(例如,"kernel", , "containerd") "systemd"
version 字串 套件版本(例如, "6.1.109.2-1.cm2")
active_cves CVE[] 已有可用修正的現行 CVE
previous_version 字串 上一個 VHD 發行版本中的版本(如果未變更則為空白)
mitigated_cves_from_previous_release CVE[] 自上次 VHD 版本以來,CVE 已修正

CVEScanner

CVEScanner 資料模型代表漏洞掃描器的元資料,該掃描器會產生容器映像的 CVE 掃描結果。

Field 類型 Description
name 字串 掃描器名稱(例如, "trivy")
version 字串 掃描器版本(例如, "0.69.1")

CVEList

CVEList 資料模型代表特定漏洞掃描器針對特定容器映像偵測到的一組 CVE。 每個項目都會將掃描器的元資料與它偵測到的 CVE 清單關聯起來。

Field 類型 Description
scanner CVEScanner 產生這些結果的掃描器
cves CVE[] 此掃描器偵測到的 CVE

CVEMitigation

CVEMitigation 資料模型會跨不同的元件版本與發行類型追蹤單一 CVE,顯示在哪些地方觀察到它,以及在哪些地方已獲得緩解。

Field 類型 Description
cve CVE 受到追蹤的 CVE
seen_in_component_versions string[] 偵測到此 CVE 的元件版本(映像標籤或套件版本)
seen_in_aks_release_versions string[] 偵測到此 CVE 的 AKS 發行版本
seen_in_aks_k8s_release_versions string[] 偵測到此 CVE 的 Kubernetes 發行版本
seen_in_vhd_release_versions string[] 偵測到此 CVE 的 VHD 發行版本
mitigated_in_component_versions string[] 已修正此 CVE 的元件版本
mitigated_in_aks_release_versions string[] 已修正此 CVE 的 AKS 發行版本
mitigated_in_aks_k8s_release_versions string[] 已修正此 CVE 的 Kubernetes 發行版本
mitigated_in_vhd_release_versions string[] 已修正此 CVE 的 VHD 發行版本

差異追蹤

AKS 版本與 VHD 版本報告包含 delta 欄位 ,將當前版本與先前版本比較:

  • mitigated_cves_from_previous_release: 在前一個版本中存在但現在已不再被偵測到的 CVE。 這表示漏洞已被修正(例如透過元件版本的提升)。
  • removed_container_images_from_previous_release:前一個發行版本中曾執行、但在目前發行版本中已不存在的容器映像。

Note

Kubernetes 版本報告 中沒有 包含 delta 欄位。

多架構摘要

每個容器映像檔可能包含多個對應不同 CPU 架構(如 amd64、arm64)的摘要參照。 API 包含所有來自多架構清單的 Linux 平台摘要 ,因此無論節點拉取哪個平台摘要,都能匹配 CVE 資料。

報表版本格式

AKS 漏洞資料 API 報告會根據報告的釋出類型,採用不同的版本控制方案。 下表總結了 AKS 版本、Kubernetes 版本及 VHD 版本所使用的格式:

發行類型 Format 範例
AKS 版本 v{YYYYMMDD} v20260104
Kubernetes 版本 Semver 1.33.2
VHD 版本 {distro}/{YYYYMM.DD.patch} AKSAzureLinux-gen2/202512.06.0

欲了解更多關於 AKS 漏洞資料 API 的資訊,請參閱 漏洞資料 API 的Azure Kubernetes Service (AKS)概述。