Använda API:et för Azure Kubernetes Service (AKS) sårbarhetsdata

API:et för sårbarhetsdata i AKS ger dig programmatisk, skrivskyddad insyn i sårbarheter som identifierats i AKS-hanterade plattformskomponenter. Det här API:et är avsett för säkerhetsteam, efterlevnadsteam och plattformsägare som behöver auktoritativ information om sårbarheter som påverkar AKS-hanterade artefakter oberoende av ett specifikt klusterkörningstillstånd.

I den här artikeln får du lära dig hur du använder API:et för sårbarhetsdata i AKS för att programmatiskt hämta CVE-rapporter för AKS-hanterade artefakter, inklusive AKS-versioner, Kubernetes-versioner, nodavbildningar, containeravbildningar och OS-paket. Den innehåller exempel på API-begäranden och visar hur du tolkar svaren för att stödja storskalig CVE-analys, automatisering och korrelation med säkerhetsskannerresultat. En översikt över begreppen bakom API:et finns i Vulnerability Data API för Azure Kubernetes Service (AKS) översikt.

Fråga efter CVE-rapporter

Följande exempel visar hur du frågar AKS Sårbarhetsdata-API:et för att hämta CVE-rapporter för AKS-versioner, Kubernetes-versioner, nodavbildningar, containeravbildningar och OS-paket.

Visa CVE:er för en AKS-version

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

Fråga CVEs för en Kubernetes-version

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

Sök efter CVE:er för en nodavbildning (VHD)

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

Fråga CVE:er för en specifik containeravbildning

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

Fråga CVE:er för ett specifikt OS-paket

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

Slutpunkter

API:et för sårbarhetsdata i AKS exponerar slutpunkter för att hämta CVE-rapporter för AKS-versioner, Kubernetes-versioner, nodavbildningar, containeravbildningar och OS-paket. Varje slutpunkt ger åtkomst till antingen ett index över tillgängliga versioner eller en detaljerad genomsökningsrapport för en viss version eller artefakt. I följande avsnitt beskrivs varje slutpunkt, tillgängliga åtgärder och förväntade format för begäran och svar.

AKS-utgåvor

Hämta AKS-versionsindex

Följande slutpunkt returnerar ett index för alla AKS-versioner med tillgängliga CVE-rapporter:

GET /api/v1/aks-releases/_index

Exempelbegäran:

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

Exempelsvar:

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

Svarsfält:

Fält	Type	Description
`aks_release_versions`	string[]	Tillgängliga versionsutgåvor för AKS, sorterade kronologiskt
`report_time`	sträng (ISO 8601)	När det här indexet senast genererades

Hämta CVE-rapport för AKS-versionen

Följande slutpunkt returnerar en detaljerad CVE-rapport för en specifik AKS-version, inklusive alla containerbilder i systemnamnområden, deras aktiva CVE:er och skillnaden i CVE:er jämfört med föregående version:

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

Sökvägsparametrar:

Parameter	Type	Description	Example
`version`	string	AKS-releaseversion från indexet	`v20260104`

Exempelbegäran:

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

Exempelsvar (förkortat):

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

Svarsfält:

Fält	Type	Description
`aks_release_version`	string	Aktuell AKS-version
`previous_aks_release_version`	string	Tidigare version (används för deltaberäkningar)
`container_targets`	AKSReleaseContainerTarget[]	Alla containerkomponenter i den här versionen
`report_time`	sträng (ISO 8601)	Tidsstämpel för rapportgenerering

Versionslanseringar för Kubernetes

Hämta Kubernetes-versionsindex

Följande slutpunkt returnerar ett index för alla Kubernetes-versioner med tillgängliga CVE-rapporter:

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

Exempelbegäran:

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

Exempelsvar:

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

Svarsfält:

Fält	Type	Description
`k8s_versions`	string[]	Tillgängliga Kubernetes-versioner sorterade efter semver
`report_time`	sträng (ISO 8601)	När det här indexet senast genererades

Hämta Kubernetes-versionens CVE-rapport

Följande slutpunkt returnerar CVE-rapporten för en specifik Kubernetes-version med information om sårbarheter i containeravbildningar som används av kubernetes-kärnkomponenter och AKS-tillägg för den versionen:

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

Sökvägsparametrar:

Parameter	Type	Description	Example
`version`	string	Kubernetes-version från indexet	`1.33.2`

Exempelbegäran:

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

Exempelsvar (förkortat):

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

Svarsfält:

Fält	Type	Description
`k8s_version`	string	Kubernetes-version (till exempel `"1.33.2"`)
`container_targets`	AKSK8SContainerTarget[]	Containeravbildningar för den här Kubernetess-versionen
`report_time`	sträng (ISO 8601)	Tidsstämpel för rapportgenerering

VHD-versioner (nodavbild)

Hämta index för VHD-utgåvor

Följande slutpunkt returnerar ett index över alla VHD-versioner med tillgängliga CVE-rapporter:

GET /api/v1/vhd-releases/_index

Exempelbegäran:

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

Exempelsvar (förkortat):

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

Svarsfält:

Fält	Type	Description
`vhd_release_versions`	string[]	Tillgängliga VHD-versioner i `{distro}/{version}` format
`report_time`	sträng (ISO 8601)	När det här indexet senast genererades

Tillgängliga distributioner:

Distro-prefix	Description
`AKSAzureLinux-gen1`	Azure Linux V2, generation 1
`AKSAzureLinux-gen2`	Azure Linux V2, generation 2
`AKSAzureLinux-gen1fips`	Azure Linux V2, Gen 1, FIPS-aktiverad
`AKSAzureLinux-gen2fips`	Azure Linux V2, Gen 2, FIPS-aktiverad
`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-aktiverad
`AKSAzureLinuxV3-gen2fips`	Azure Linux V3, Gen 2, FIPS-aktiverad
`AKSAzureLinuxV3-gen2tl`	Azure Linux V3, Gen 2, TL-variant
`AKSCBLMarinerV2-gen1`	CBL-Mariner V2, generation 1
`AKSCBLMarinerV2-gen2`	CBL-Mariner V2, generation 2
`AKSCBLMarinerV2-gen1fips`	CBL-Mariner V2, Gen 1, FIPS-aktiverad
`AKSCBLMarinerV2-gen2fips`	CBL-Mariner V2, Gen 2, FIPS-aktiverad
`AKSCBLMarinerV2-gen2kata`	CBL-Mariner V2, Gen 2, Kata-containrar
`AKSCBLMarinerV2-gen2tl`	CBL-Mariner V2, Gen 2, TL-variant
`AKSUbuntu-gen1-2004fipscontainerd`	Ubuntu 20.04, Gen 1, FIPS
`AKSUbuntu-gen1-2204containerd`	Ubuntu 22.04, generation 1
`AKSUbuntu-gen1-2404containerd`	Ubuntu 24.04, generation 1
`AKSUbuntu-gen2-2004cvmcontainerd`	Ubuntu 20.04, Gen 2, Konfidentiell virtuell dator
`AKSUbuntu-gen2-2004fipscontainerd`	Ubuntu 20.04, Gen 2, FIPS
`AKSUbuntu-gen2-2204containerd`	Ubuntu 22.04, generation 2
`AKSUbuntu-gen2-2404containerd`	Ubuntu 24.04, generation 2
`AKSUbuntu-gen2-2204tlcontainerd`	Ubuntu 22.04, Gen 2, TL-variant
`AKSUbuntu-gen2-2404tlcontainerd`	Ubuntu 24.04, Gen 2, TL-variant

Hämta CVE-rapport för VHD-version

Följande slutpunkt returnerar CVE-rapporten för en specifik VHD-version, inklusive både OS-paketen och containeravbildningarna som ingår i den versionen:

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

Sökvägsparametrar:

Parameter	Type	Description	Example
`distro`	string	Linux-distributionsidentifierare	`AKSUbuntu-gen2-2204containerd`
`version`	string	Version för VHD-utgåva	`202601.13.0`

Exempelbegäran:

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

Exempelsvar (förkortat):

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

Svarsfält:

Fält	Type	Description
`distro_name`	string	Linux-distributionsnamn (till exempel `"AKSAzureLinux/gen2"`)
`vhd_release_version`	string	Aktuell version av VHD
`previous_vhd_release_version`	string	Tidigare version av VHD
`os_package_targets`	AKSVHDOSPackageTarget[]	OS-paket i denna VHD
`container_targets`	AKSVHDContainerTarget[]	Containeravbildningar som ingår i den här VHD-filen
`report_time`	sträng (ISO 8601)	Tidsstämpel för rapportgenerering

Containeravbildningar

Ändpunkterna för containeravbilder tillhandahåller CVE-skanningsrapporter för varje avbild samt spårning av riskreducerande åtgärder över flera versioner för enskilda containeravbilder. Dessa slutpunkter har ingen _index-listning; du navigerar med hjälp av den fullständiga avbildssökvägen.

Hämta CVE-skanningsrapport för containeravbild

Följande slutpunkt hämtar en CVE-genomsökningsrapport för en specifik containeravbildning som identifieras av dess fullständiga bildsökväg och tagg:

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

Sökvägsparametrar:

Parameter	Type	Description	Example
`image`	string	Fullständigt avbildningsnamn inklusive register	`mcr.microsoft.com/oss/kubernetes/kube-proxy`
`tag`	string	Bildtagg	`v1.31.11`

Exempelbegäran:

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

Exempelsvar (förkortat):

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

Svarsfält:

Fält	Type	Description
`image_repo_tags`	string[]	Bildtaggar för den skannade bilden
`image_repo_digests`	string[]	Bildsammandrag för alla plattformar som stöds
`report_time`	sträng (ISO 8601)	Tidsstämpel för rapportgenerering
`active_cves`	CVEList[]	Aktiva CVE:er grupperade efter skanner

Hämta rapport om CVE-åtgärder för containeravbildning

Följande endpoint hämtar en CVE-åtgärdsrapport för en specifik lagringsplats för containeravbildningar och visar i vilka komponentversioner och utgåvor olika CVE:er har observerats, samt i vilka versioner och utgåvor de har åtgärdats:

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

Sökvägsparametrar:

Parameter	Type	Description	Example
`image`	string	Fullständigt avbildningsnamn inklusive register (utan tagg)	`mcr.microsoft.com/oss/kubernetes/kube-proxy`

Exempelbegäran:

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

Exempelsvar (förkortat):

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

Svarsfält:

Fält	Type	Description
`container_image`	string	Bildnamn utan tagg
`mitigations`	CVEMitigation[]	CVE-åtgärdsposter för den här bilden

VHD OS-paket

Ändpunkterna för VHD OS-paket tillhandahåller CVE-skanningsrapporter för varje paket och spårning av riskreducerande åtgärder mellan versioner för enskilda OS-paket som är installerade i nodavbilder i VHD-format. Dessa slutpunkter har ingen _index-lista; du navigerar via paketnamnet.

Hämta CVE-genomsökningsrapport för VHD OS-paket

Följande slutpunkt hämtar en CVE-genomsökningsrapport för en specifik os-paketversion installerad i VHD-nodavbildningar:

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

Sökvägsparametrar:

Parameter	Type	Description	Example
`name`	string	OS-paketnamn (gemener)	`openssl`
`version`	string	Paketversion	`3.0.2-0ubuntu1.20`

Exempelbegäran:

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

Exempelsvar:

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

Svarsfält:

Fält	Type	Description
`name`	string	Paketnamn
`version`	string	Paketversion
`active_cves`	CVE[]	Aktiva CVE:er med tillgängliga korrigeringar
`report_time`	sträng (ISO 8601)	Tidsstämpel för rapportgenerering

Hämta CVE-åtgärdsrapport för OS-paket för VHD

Följande slutpunkt hämtar en CVE-åtgärdsrapport för ett specifikt OS-paket och visar vilka CVE:er som har setts i vilka paketversioner och VHD-versioner och i vilka versioner de har åtgärdats:

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

Sökvägsparametrar:

Parameter	Type	Description	Example
`name`	string	OS-paketnamn (gemener)	`openssl`

Exempelbegäran:

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

Exempelsvar (förkortat):

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

Svarsfält:

Fält	Type	Description
`package_name`	string	Namn på OS-paket
`mitigations`	CVEMitigation[]	CVE-åtgärdsposter för det här paketet

Datamodeller

I följande avsnitt beskrivs de datamodeller som returneras av API:et för sårbarhetsdata i AKS, inklusive strukturen för CVE-poster, containeravbildningsreferenser, AKS-versionskomponenter, VHD OS-paket och relationerna mellan dem.

CVE

CVE-datamodellen är en Common Vulnerabilities and Exposures-identifierare.

Fält	Type	Description
`id`	string	CVE-identifierare (till exempel `"CVE-2024-13176"`, `"GHSA-2464-8j7c-4cjm"`)

ContainerImages

Datamodellen ContainerImages representerar en uppsättning referenser till containeravbildningar, inklusive både taggar som kan läsas av människor och innehållsadresserbara digestvärden.

Fält	Type	Description
`image_repo_tags`	string[]	Bildtaggar (till exempel `"mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9"`)
`image_repo_digests`	string[]	Bildsammandrag för alla plattformar som stöds (till exempel `"mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9@sha256:abc..."`)

Note

Sammanfattningar omfattar alla Linux-plattformsvarianter (amd64, arm64) från manifest med flera valv. Detta gör det möjligt att matcha CVE-data oavsett vilken plattformsspecifik digest din nod hämtade.

AKSReleaseContainerTarget

Datamodellen AKSReleaseContainerTarget representerar en containerkomponent i en specifik AKS-version som identifieras av poddnamnområdet och containernamnet där den körs, tillsammans med de containeravbildningar som används och de CVE:er som påverkar den.

Fält	Type	Description
`pod_namespace`	string	Kubernetes-namnrymd (till exempel `"kube-system"`, `"calico-system"`)
`container_name`	string	Containernamn (till exempel `"coredns"`, `"calico-node"`)
`active_container_images`	ContainerImages	Containerbilder som körs just nu för den här komponenten
`active_cves`	CVE[]	CVE:er med tillgängliga korrigeringar som för närvarande påverkar den här komponenten
`removed_container_images_from_previous_release`	ContainerImages	Avbildningar som fanns i den tidigare versionen men som inte längre körs
`mitigated_cves_from_previous_release`	CVE[]	CVE:er som fanns i den tidigare versionen men som har åtgärdats i den här versionen

AKSK8SContainerTarget

Datamodellen AKSK8SContainerTarget representerar en containerbild som är kopplad till en specifik Kubernetes-version, inklusive de taggade bildreferenserna och digestvärdena för den bilden samt de CVE:er som påverkar den.

Fält	Type	Description
`container_image`	string	Bildnamn utan tagg (till exempel `"mcr.microsoft.com/oss/kubernetes/kube-apiserver"`)
`active_container_images`	ContainerImages	Taggade bildreferenser och sammandrag
`active_cves`	CVE[]	Aktiva CVE:er med tillgängliga korrigeringar

AKSVHDContainerTarget

AKSVHDContainerTarget-datamodellen representerar en containeravbildning som ingår i en VHD-nodavbildning, tillsammans med taggade bildreferenser, sammandrag och CVE:er som påverkar den.

Fält	Type	Description
`container_image`	string	Bildnamn utan tagg
`active_container_images`	ContainerImages	Taggade bildreferenser och sammandrag
`active_cves`	CVE[]	Aktiva CVE:er med tillgängliga korrigeringar
`removed_container_images_from_previous_release`	ContainerImages	Avbildningar har tagits bort sedan den tidigare VHD-versionen
`mitigated_cves_from_previous_release`	CVE[]	CVE:er har åtgärdats sedan den tidigare VHD-versionen

AKSVHDOSPackageTarget

AKSVHDOSPackageTarget-datamodellen representerar ett paket på OS-nivå som installerats i en VHD-nodavbildning, tillsammans med den installerade versionen, cv:erna som påverkar den och eventuella ändringar från den tidigare VHD-versionen.

Fält	Type	Description
`name`	string	Paketnamn (till exempel `"kernel"`, `"containerd"`, `"systemd"`)
`version`	string	Paketversion (till exempel `"6.1.109.2-1.cm2"`)
`active_cves`	CVE[]	Aktiva CVE:er med tillgängliga korrigeringar
`previous_version`	string	Version från den tidigare VHD-versionen (tom om den är oförändrad)
`mitigated_cves_from_previous_release`	CVE[]	CVE:er har åtgärdats sedan den tidigare VHD-versionen

CVEScanner

CVEScanner-datamodellen representerar metadata för en sårbarhetsskanner som genererar CVE-genomsökningsresultat för containeravbildningar.

Fält	Type	Description
`name`	string	Skannernamn (till exempel `"trivy"`)
`version`	string	Skannerversion (till exempel `"0.69.1"`)

CVEList

CVEList-datamodellen representerar en uppsättning CVE:er som identifierats av en viss sårbarhetsskanner för en viss containeravbildning. Varje post associerar skannermetadata med listan över CVE:er som identifierades.

Fält	Type	Description
`scanner`	CVEScanner	Skannern som producerade dessa resultat
`cves`	CVE[]	CVE:er har identifierats av den här skannern

CVEMitigation

CVEMitigation-datamodellen spårar en enda CVE mellan komponentversioner och versionstyper, som visar var den observerades och var den minimerades.

Fält	Type	Description
`cve`	CVE	Den CVE som spåras
`seen_in_component_versions`	string[]	Komponentversioner (bildtaggar eller paketversioner) där denna CVE identifierades
`seen_in_aks_release_versions`	string[]	AKS-utgåveversioner där denna CVE identifierades
`seen_in_aks_k8s_release_versions`	string[]	Kubernetes-utgåveversioner i vilka denna CVE identifierades
`seen_in_vhd_release_versions`	string[]	VHD-versionsversioner där denna CVE identifierades
`mitigated_in_component_versions`	string[]	Komponentversioner där denna CVE har åtgärdats
`mitigated_in_aks_release_versions`	string[]	AKS-versionsversioner där denna CVE har åtgärdats
`mitigated_in_aks_k8s_release_versions`	string[]	Kubernetes-versionsversioner där denna CVE har åtgärdats
`mitigated_in_vhd_release_versions`	string[]	VHD-versionsversioner där denna CVE har åtgärdats

Deltaspårning

AKS-versions- och VHD-versionsrapporter innehåller deltafält som jämför den aktuella versionen med den tidigare:

mitigated_cves_from_previous_release: CVE:er som fanns i den tidigare utgåvan men som inte längre upptäcks. Det innebär att sårbarheten har åtgärdats (till exempel genom att komponentversionen höjs).
removed_container_images_from_previous_release: Containeravbildningar som kördes i den tidigare versionen men som saknas i den aktuella versionen.

Note

Kubernetes-versionsrapporter innehåller inte deltafält.

Sammandrag för flera arkitekturer

Varje containeravbildning kan innehålla flera sammanfattade referenser som täcker olika CPU-arkitekturer (amd64, arm64). API:et innehåller alla Linux-plattformssammandrag från manifest med flera arkitekturer, så att du kan matcha CVE-data oavsett vilken specifik plattform som sammanfattar noden som hämtats.

Format för rapportversioner

API-rapporterna för AKS Vulnerability Data använder olika versionsscheman beroende på vilken typ av version som rapporteras. I följande tabell sammanfattas de format som används för AKS-versioner, Kubernetes-versioner och VHD-versioner:

Versionstyp	Format	Example
AKS-släpp	`v{YYYYMMDD}`	`v20260104`
Kubernetes-version	Semver	`1.33.2`
VHD-version	`{distro}/{YYYYMM.DD.patch}`	`AKSAzureLinux-gen2/202512.06.0`

Mer information om API:et för sårbarhetsdata i AKS finns i Vulnerability Data API för Azure Kubernetes Service (AKS) översikt.

Feedback

Var den här sidan till hjälp?

Uppdaterades senast 2026-05-19

Använda API:et för Azure Kubernetes Service (AKS) sårbarhetsdata

Fråga efter CVE-rapporter

Visa CVE:er för en AKS-version

Fråga CVEs för en Kubernetes-version

Sök efter CVE:er för en nodavbildning (VHD)

Fråga CVE:er för en specifik containeravbildning

Fråga CVE:er för ett specifikt OS-paket

Slutpunkter

AKS-utgåvor

Hämta AKS-versionsindex

Hämta CVE-rapport för AKS-versionen

Versionslanseringar för Kubernetes

Hämta Kubernetes-versionsindex

Hämta Kubernetes-versionens CVE-rapport

VHD-versioner (nodavbild)

Hämta index för VHD-utgåvor

Hämta CVE-rapport för VHD-version

Containeravbildningar

Hämta CVE-skanningsrapport för containeravbild

Hämta rapport om CVE-åtgärder för containeravbildning

VHD OS-paket

Hämta CVE-genomsökningsrapport för VHD OS-paket

Hämta CVE-åtgärdsrapport för OS-paket för VHD

Datamodeller

CVE

ContainerImages

AKSReleaseContainerTarget

AKSK8SContainerTarget

AKSVHDContainerTarget

AKSVHDOSPackageTarget

CVEScanner

CVEList

CVEMitigation

Deltaspårning

Sammandrag för flera arkitekturer

Format för rapportversioner

Relaterat innehåll

Feedback

Ytterligare resurser