Использование API данных об уязвимостях Azure Kubernetes Service (AKS)

API данных об уязвимостях AKS обеспечивает программное, доступное только для чтения представление об уязвимостях, обнаруженных в компонентах платформы, управляемых AKS. Этот API предназначен для команд безопасности, групп соответствия требованиям и владельцев платформ, которым требуются достоверные сведения об уязвимостях, влияющих на артефакты, управляемые AKS, независимо от любого конкретного состояния среды выполнения кластера.

В этой статье вы узнаете, как использовать API данных уязвимостей AKS для программного получения отчетов CVE для артефактов, управляемых AKS, включая выпуски AKS, версии Kubernetes, образы узлов, образы контейнеров и пакеты ОС. В нем приведены примеры запросов API и показано, как интерпретировать ответы для поддержки анализа, автоматизации и корреляции с результатами сканера безопасности. Общие сведения о концепциях API см. в разделе Вулируемость данных API Azure Kubernetes Service (AKS).

Запрос отчетов CVE

В следующих примерах показано, как запрашивать API данных уязвимостей AKS для получения отчетов CVE для выпусков AKS, версий Kubernetes, образов узлов, образов контейнеров и пакетов ОС.

Запросить сведения о CVE для версии AKS

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

Запрос CVEs для версии Kubernetes

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

Запрос CVEs для образа узла (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 '.'

Выполнить запрос о 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 '.'

Запросить CVEs для конкретного пакета ОС

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

Конечные точки

API данных об уязвимостях AKS предоставляет конечные точки для получения отчетов CVE для выпусков AKS, версий Kubernetes, образов узлов, образов контейнеров и пакетов ОС. Каждая конечная точка предоставляет доступ к индексу доступных версий или подробному отчету проверки для определенной версии или артефакта. В следующих разделах описываются каждая конечная точка, доступные операции и ожидаемые форматы запросов и ответов.

Релизы 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"
}

Поля ответа:

Поле	Тип	Description
`aks_release_versions`	string[]	Доступные версии выпуска AKS, отсортированные по хронологии
`report_time`	string (ISO 8601)	После последнего создания этого индекса

Получение отчета о выпуске AKS CVE

Следующая конечная точка возвращает подробный отчет CVE для определенной версии выпуска AKS, включая все образы контейнеров в системных пространствах имен, их активные CVEs и разность CVEs по сравнению с предыдущим выпуском:

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

Параметры пути:

Parameter	Тип	Description	Пример
`version`	string	Версия выпуска 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"
}

Поля ответа:

Поле	Тип	Description
`aks_release_version`	string	Текущая версия релиза AKS
`previous_aks_release_version`	string	Предыдущая версия выпуска (используется для вычислений разностных данных)
`container_targets`	AKSReleaseContainerTarget[]	Все компоненты контейнеров в этом выпуске
`report_time`	string (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"
}

Поля ответа:

Поле	Тип	Description
`k8s_versions`	string[]	Доступные версии Kubernetes, отсортированные по semver
`report_time`	string (ISO 8601)	После последнего создания этого индекса

Получить отчет CVE для версии Kubernetes

Следующая конечная точка возвращает отчет CVE для определенной версии Kubernetes, детализируя уязвимости в образах контейнеров, используемых основными компонентами Kubernetes и надстройками AKS для этой версии:

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

Параметры пути:

Parameter	Тип	Description	Пример
`version`	string	Версия 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"
}

Поля ответа:

Поле	Тип	Description
`k8s_version`	string	Версия Kubernetes (например, `"1.33.2"`)
`container_targets`	AKSK8SContainerTarget[]	Образы контейнеров для этой версии Kubernetess
`report_time`	string (ISO 8601)	Время формирования отчета

Выпуски VHD (образ узла)

Получение индекса выпусков VHD

Следующая конечная точка возвращает индекс всех выпусков VHD с доступными отчетами CVE:

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

Поля ответа:

Поле	Тип	Description
`vhd_release_versions`	string[]	Доступные выпуски VHD в `{distro}/{version}` формате
`report_time`	string (ISO 8601)	После последнего создания этого индекса

Доступные дистрибутивы:

Префикс дистрибутива	Description
`AKSAzureLinux-gen1`	Azure Linux версии 2, поколение 1
`AKSAzureLinux-gen2`	Azure Linux версии 2, поколение 2
`AKSAzureLinux-gen1fips`	Azure Linux версии 2, 1-го поколения, с поддержкой FIPS
`AKSAzureLinux-gen2fips`	Azure Linux версии 2, 2-го поколения, с поддержкой FIPS
`AKSAzureLinux-gen2kata`	Azure Linux V2, 2-го поколения, контейнеры Kata
`AKSAzureLinux-gen2tl`	Azure Linux V2, поколение 2, вариант TL
`AKSAzureLinuxV3-gen1`	Azure Linux версии 3, поколение 1
`AKSAzureLinuxV3-gen2`	Azure Linux версии 3, поколение 2
`AKSAzureLinuxV3-gen1fips`	Azure Linux версии 3, 1-го поколения, с поддержкой FIPS
`AKSAzureLinuxV3-gen2fips`	Azure Linux версии 3, 2-го поколения, с поддержкой FIPS
`AKSAzureLinuxV3-gen2tl`	Azure Linux 3, поколение 2, вариант TL
`AKSCBLMarinerV2-gen1`	CBL-Mariner версии 2, поколения 1
`AKSCBLMarinerV2-gen2`	CBL-Mariner V2, поколение 2
`AKSCBLMarinerV2-gen1fips`	CBL-Mariner версии 2, 1-го поколения, с поддержкой FIPS
`AKSCBLMarinerV2-gen2fips`	CBL-Mariner версии 2, 2-го поколения, с поддержкой FIPS
`AKSCBLMarinerV2-gen2kata`	CBL-Mariner V2, 2-го поколения, контейнеры Kata
`AKSCBLMarinerV2-gen2tl`	CBL-Mariner версии 2, 2-го поколения, вариант TL
`AKSUbuntu-gen1-2004fipscontainerd`	Ubuntu 20.04, 1-го поколения, FIPS
`AKSUbuntu-gen1-2204containerd`	Ubuntu 22.04, поколение 1
`AKSUbuntu-gen1-2404containerd`	Ubuntu 24.04, поколение 1
`AKSUbuntu-gen2-2004cvmcontainerd`	Ubuntu 20.04, 2-го поколения, конфиденциальная виртуальная машина
`AKSUbuntu-gen2-2004fipscontainerd`	Ubuntu 20.04, 2-го поколения, FIPS
`AKSUbuntu-gen2-2204containerd`	Ubuntu 22.04, поколение 2
`AKSUbuntu-gen2-2404containerd`	Ubuntu 24.04, поколение 2
`AKSUbuntu-gen2-2204tlcontainerd`	Ubuntu 22.04, 2-го поколения, вариант TL
`AKSUbuntu-gen2-2404tlcontainerd`	Ubuntu 24.04, 2-го поколения, вариант TL

Получить отчет CVE для выпуска VHD

Следующая конечная точка возвращает отчет CVE для определенного выпуска VHD, включая пакеты ОС и образы контейнеров, включенные в этот выпуск:

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

Параметры пути:

Parameter	Тип	Description	Пример
`distro`	string	Идентификатор дистрибутива Linux	`AKSUbuntu-gen2-2204containerd`
`version`	string	Релизная версия 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"
}

Поля ответа:

Поле	Тип	Description
`distro_name`	string	Имя дистрибутива Linux (например, `"AKSAzureLinux/gen2"`)
`vhd_release_version`	string	Текущая версия выпуска VHD
`previous_vhd_release_version`	string	Предыдущая версия выпуска VHD
`os_package_targets`	AKSVHDOSPackageTarget[]	Пакеты ОС в этом VHD
`container_targets`	AKSVHDContainerTarget[]	Образы контейнеров в составе этого VHD
`report_time`	string (ISO 8601)	Время формирования отчета

Образы контейнеров

Эндпоинты образов контейнеров предоставляют отчеты о сканировании на наличие CVE для каждого образа и отслеживание мер по устранению уязвимостей в разных выпусках для отдельных образов контейнеров. У этих конечных точек нет списка _index; нужно обращаться по полному пути к образу.

Получить отчёт о сканировании образа контейнера на наличие CVE

Следующая конечная точка извлекает отчет проверки CVE для определенного образа контейнера, определяемого его полным путем к изображению и тегом:

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

Параметры пути:

Parameter	Тип	Description	Пример
`image`	string	Полное имя образа с указанием реестра	`mcr.microsoft.com/oss/kubernetes/kube-proxy`
`tag`	string	Тег изображения	`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"}
      ]
    }
  ]
}

Поля ответа:

Поле	Тип	Description
`image_repo_tags`	string[]	Теги изображений для сканированного изображения
`image_repo_digests`	string[]	Дайджесты изображений для всех поддерживаемых платформ
`report_time`	string (ISO 8601)	Время формирования отчета
`active_cves`	CVEList[]	Активные CVE, сгруппированные по сканерам

Получить отчет о снижении рисков CVE образа контейнера

Следующий эндпоинт возвращает отчет об устранении CVE для определенного репозитория образов контейнеров и показывает, какие CVE были обнаружены в каких версиях компонентов и выпусках, а также в каких версиях и выпусках они были устранены:

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

Параметры пути:

Parameter	Тип	Description	Пример
`image`	string	Полное имя образа, включая реестр (без тега)	`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": []
    }
  ]
}

Поля ответа:

Поле	Тип	Description
`container_image`	string	Имя изображения без тега
`mitigations`	CVEMitigation[]	Записи о мерах по снижению рисков CVE для этого образа

Пакеты ОС VHD

Конечные точки пакета ОС VHD предоставляют отчеты проверки CVE для каждого пакета и отслеживание устранения рисков между выпусками для отдельных пакетов ОС, установленных на образах узлов VHD. Для этих конечных точек нет _index списка; навигация осуществляется по имени пакета.

Получить отчет о сканировании пакета ОС VHD на наличие CVE

Следующая конечная точка извлекает отчет проверки CVE для определенной версии пакета ОС, установленной на образах узлов VHD:

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

Параметры пути:

Parameter	Тип	Description	Пример
`name`	string	Имя пакета ОС (в нижнем регистре)	`openssl`
`version`	string	Версия пакета	`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"
}

Поля ответа:

Поле	Тип	Description
`name`	string	Имя пакета
`version`	string	Версия пакета
`active_cves`	CVE[]	Активные CVEs с доступными исправлениями
`report_time`	string (ISO 8601)	Время формирования отчета

Получить отчет о снижении рисков CVE для пакета ОС VHD

Следующая конечная точка извлекает отчет по устранению рисков CVE для определенного пакета ОС и показывает, какие CVEs были замечены в версиях пакетов и выпусках VHD и в которых они были устранены:

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

Параметры пути:

Parameter	Тип	Description	Пример
`name`	string	Имя пакета ОС (в нижнем регистре)	`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": []
    }
  ]
}

Поля ответа:

Поле	Тип	Description
`package_name`	string	Имя пакета ОС
`mitigations`	CVEMitigation[]	Записи о мерах по снижению риска CVE для этого пакета

Модели данных

В следующих разделах описываются модели данных, возвращаемые API данных об уязвимостях AKS, включая структуру записей CVE, ссылок на образы контейнеров, компонентов выпуска AKS, пакетов ОС VHD и связей между ними.

CVE

Модель данных CVE представляет собой идентификатор Common Vulnerabilities and Exposures.

Поле	Тип	Description
`id`	string	Идентификатор CVE (например, `"CVE-2024-13176"`, `"GHSA-2464-8j7c-4cjm"`)

ContainerImages

Модель данных ContainerImages представляет собой набор ссылок на образы контейнеров, включая как понятные человеку теги, так и дайджесты с адресацией по содержимому.

Поле	Тип	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.

Поле	Тип	Description
`pod_namespace`	string	Пространство имен Kubernetes (например, `"kube-system"`, `"calico-system"`)
`container_name`	string	Имя контейнера (например, `"coredns"`, `"calico-node"`)
`active_container_images`	ContainerImages	Образы контейнеров, работающие в настоящее время для этого компонента
`active_cves`	CVE[]	Уязвимости CVE с доступными исправлениями, в настоящее время затрагивающие этот компонент
`removed_container_images_from_previous_release`	ContainerImages	Образы, которые были представлены в предыдущем выпуске, но больше не работают
`mitigated_cves_from_previous_release`	CVE[]	Идентификаторы CVE, присутствовавшие в предыдущей версии, но исправленные в этой версии

AKSK8SContainerTarget

Модель данных AKSK8SContainerTarget представляет образ контейнера, связанный с определённой версией Kubernetes, в том числе ссылки на образ с тегами, дайджесты этого образа и уязвимости CVE, затрагивающие его.

Поле	Тип	Description
`container_image`	string	Имя изображения без тега (например, `"mcr.microsoft.com/oss/kubernetes/kube-apiserver"`)
`active_container_images`	ContainerImages	Ссылки на помеченные изображения и дайджесты
`active_cves`	CVE[]	Активные CVEs с доступными исправлениями

AKSVHDContainerTarget

Модель данных AKSVHDContainerTarget представляет образ контейнера, включённый в образ узла VHD, а также ссылки на образы с тегами, дайджесты и идентификаторы CVE, относящиеся к нему.

Поле	Тип	Description
`container_image`	string	Имя изображения без тега
`active_container_images`	ContainerImages	Ссылки на помеченные изображения и дайджесты
`active_cves`	CVE[]	Активные CVEs с доступными исправлениями
`removed_container_images_from_previous_release`	ContainerImages	Образы удалены после предыдущего выпуска VHD
`mitigated_cves_from_previous_release`	CVE[]	CVEs исправлены с момента предыдущего выпуска VHD

AKSVHDOSPackageTarget

Модель данных AKSVHDOSPackageTarget представляет пакет уровня ОС, установленный в образе узла VHD, а также сведения об установленной версии, CVE, затрагивающих этот пакет, и любых изменениях по сравнению с предыдущим выпуском VHD.

Поле	Тип	Description
`name`	string	Имя пакета (например, `"kernel"`, , `"containerd""systemd"`)
`version`	string	Версия пакета (например, `"6.1.109.2-1.cm2"`)
`active_cves`	CVE[]	Активные CVEs с доступными исправлениями
`previous_version`	string	Версия из предыдущего выпуска VHD (пустая, если не изменяется)
`mitigated_cves_from_previous_release`	CVE[]	CVEs исправлены с момента предыдущего выпуска VHD

CVEScanner

Модель данных CVEScanner представляет метаданные для сканера уязвимостей, который создает результаты сканирования CVE для образов контейнеров.

Поле	Тип	Description
`name`	string	Имя сканера (например, `"trivy"`)
`version`	string	Версия сканера (например, `"0.69.1"`)

CVEList

Модель данных CVEList представляет набор CVEs, обнаруженных определенным сканером уязвимостей для данного образа контейнера. Каждая запись связывает метаданные сканера со списком CVE, обнаруженных сканером.

Поле	Тип	Description
`scanner`	CVEScanner	Сканер, создающий эти результаты
`cves`	CVE[]	CVEs, обнаруженные этим сканером

CVEMitigation

Модель данных CVEMitigation отслеживает один CVE в версиях компонентов и типах выпусков, показывая, где она наблюдалась и где она была устранена.

Поле	Тип	Description
`cve`	CVE	Отслеживаемый CVE
`seen_in_component_versions`	string[]	Версии компонентов (теги изображений или версии пакета), в которых обнаружен этот CVE
`seen_in_aks_release_versions`	string[]	Версии выпуска AKS, в которых обнаружен этот CVE
`seen_in_aks_k8s_release_versions`	string[]	Версии выпуска Kubernetes, в которых обнаружен этот CVE
`seen_in_vhd_release_versions`	string[]	Версии выпуска VHD, в которых обнаружен этот CVE
`mitigated_in_component_versions`	string[]	Версии компонентов, в которых эта CVE была исправлена
`mitigated_in_aks_release_versions`	string[]	Версии выпуска AKS, в которых эта CVE была исправлена
`mitigated_in_aks_k8s_release_versions`	string[]	Версии релиза Kubernetes, в которых была исправлена эта уязвимость CVE
`mitigated_in_vhd_release_versions`	string[]	Версии выпуска VHD, в которых исправлен этот CVE

Разностное отслеживание

Отчеты о выпуске AKS и VHD включают разностные поля , которые сравнивают текущий выпуск с предыдущим:

mitigated_cves_from_previous_release: CVEs, которые присутствовали в предыдущей версии, но больше не обнаруживаются. Это означает, что уязвимость была исправлена (например, путем обновления версии компонента).
removed_container_images_from_previous_release: образы контейнеров, которые использовались в предыдущем выпуске, но отсутствуют в текущем выпуске.

Note

Отчеты о версиях Kubernetes не включают поля дельты.

Дайджесты с несколькими архитектурами

Каждый образ контейнера может содержать несколько ссылок на дайджест, охватывающие различные архитектуры ЦП (amd64, arm64). API включает все дайджесты Linux-платформ из мультиархитектурных манифестов, поэтому вы можете сопоставлять данные CVE независимо от того, какой именно дайджест платформы был загружен вашим узлом.

Форматы версий отчета

Отчеты API данных уязвимостей AKS используют различные схемы управления версиями в зависимости от типа сообщаемого выпуска. В следующей таблице приведены форматы, используемые в релизах AKS, версиях Kubernetes и релизах VHD:

Тип выпуска	Формат	Пример
Выпуск AKS	`v{YYYYMMDD}`	`v20260104`
Версия Kubernetes	Семвер	`1.33.2`
Выпуск VHD	`{distro}/{YYYYMM.DD.patch}`	`AKSAzureLinux-gen2/202512.06.0`

Дополнительные сведения об API данных об уязвимостях AKS см. в разделе Обзор API данных об уязвимостях для Azure Kubernetes Service (AKS).

Обратная связь

Были ли сведения на этой странице полезными?

Последнее обновление: 2026-05-19

Использование API данных об уязвимостях Azure Kubernetes Service (AKS)

Запрос отчетов CVE

Запросить сведения о CVE для версии AKS

Запрос CVEs для версии Kubernetes

Запрос CVEs для образа узла (VHD)

Выполнить запрос о CVE для конкретного образа контейнера

Запросить CVEs для конкретного пакета ОС

Конечные точки

Релизы AKS

Получить индекс выпусков AKS

Получение отчета о выпуске AKS CVE

Выпуски версий Kubernetes

Получение индекса версий Kubernetes

Получить отчет CVE для версии Kubernetes

Выпуски VHD (образ узла)

Получение индекса выпусков VHD

Получить отчет CVE для выпуска VHD

Образы контейнеров

Получить отчёт о сканировании образа контейнера на наличие CVE

Получить отчет о снижении рисков CVE образа контейнера

Пакеты ОС VHD

Получить отчет о сканировании пакета ОС VHD на наличие CVE

Получить отчет о снижении рисков CVE для пакета ОС VHD

Модели данных

CVE

ContainerImages

AKSReleaseContainerTarget

AKSK8SContainerTarget

AKSVHDContainerTarget

AKSVHDOSPackageTarget

CVEScanner

CVEList

CVEMitigation

Разностное отслеживание

Дайджесты с несколькими архитектурами

Форматы версий отчета

Связанный контент

Обратная связь

Дополнительные ресурсы