Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
A API de Dados de Vulnerabilidades do AKSoferece-lhe visibilidade programática e apenas leitura sobre vulnerabilidades detetadas em componentes de plataforma geridos pelo AKS. Esta API destina-se a equipas de segurança, equipas de conformidade e proprietários de plataformas que necessitam de informação autoritativa sobre vulnerabilidades que afetam artefactos geridos pelo AKS, independentemente de qualquer estado específico de execução do cluster.
Neste artigo, aprende como usar a API de Dados de Vulnerabilidades do AKS para recuperar programaticamente relatórios CVE para artefactos geridos pelo AKS, incluindo versões do AKS, versões do Kubernetes, imagens de nós, imagens de contentores e pacotes do sistema operativo. Fornece exemplos de pedidos de API e demonstra como interpretar as respostas para suportar análises CVE em grande escala, automação e correlação com os resultados dos scanners de segurança. Para obter uma descrição geral dos conceitos subjacentes à API, consulte Descrição geral da API de Dados de Vulnerabilidade para o Azure Kubernetes Service (AKS).
Consulta para relatórios CVE
Os exemplos seguintes demonstram como consultar a API de Dados de Vulnerabilidades do AKS para obter relatórios CVE para versões do AKS, versões do Kubernetes, imagens de nós, imagens de contentores e pacotes do sistema operativo.
Consultar CVEs para uma versão 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 '.'
Consultar CVEs para uma versão do 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 '.'
Consultar CVEs para uma imagem de nó (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 '.'
Pesquisar CVEs para uma imagem de contentor específica
# 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 '.'
Consultar CVEs para um pacote de SO específico
# 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 '.'
Pontos finais
A API de Dados de Vulnerabilidades do AKS expõe endpoints para obter relatórios CVE para versões do AKS, versões do Kubernetes, imagens de nós, imagens de contentores e pacotes do sistema operativo. Cada endpoint fornece acesso a um índice das versões disponíveis ou a um relatório de análise detalhado para uma versão ou artefacto específico. As secções seguintes descrevem cada endpoint, as operações disponíveis e os formatos esperados de pedido e resposta.
Lançamentos do AKS
Obtenha o índice de lançamentos do AKS
O seguinte endpoint retorna um índice de todas as versões de lançamento do AKS com relatórios CVE disponíveis:
GET /api/v1/aks-releases/_index
Exemplo de pedido:
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/_index
Exemplo de resposta:
{
"aks_release_versions": [
"v20250427",
"v20250519",
"v20250617",
"v20250720",
"v20250808",
"v20250829",
"v20250921",
"v20251012",
"v20260104"
],
"report_time": "2026-01-27T16:19:36.181877605Z"
}
Campos de resposta:
| Campo | Tipo | Description |
|---|---|---|
aks_release_versions |
string[] | Versões de lançamento disponíveis do AKS, ordenadas cronologicamente |
report_time |
cadeia de caracteres (ISO 8601) | Quando este índice foi gerado pela última vez |
Obtenha o relatório de CVE lançado pela AKS
O endpoint seguinte devolve um relatório detalhado de CVE para uma versão específica de lançamento do AKS, incluindo todas as imagens de contentores nos namespaces do sistema, os seus CVEs ativos e o delta dos CVEs em comparação com a versão anterior:
GET /api/v1/aks-releases/{version}/scan-reports
Parâmetros do caminho:
| Parameter | Tipo | Description | Exemplo |
|---|---|---|---|
version |
cadeia (de caracteres) | Versão de lançamento do AKS a partir do índice | v20260104 |
Exemplo de pedido:
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/v20260104/scan-reports
Exemplo de resposta (abreviada):
{
"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"
}
Campos de resposta:
| Campo | Tipo | Description |
|---|---|---|
aks_release_version |
cadeia (de caracteres) | Versão atual de lançamento do AKS |
previous_aks_release_version |
cadeia (de caracteres) | Versão anterior (usada para cálculos de delta) |
container_targets |
AKSReleaseContainerTarget[] | Todos os componentes do contentor nesta versão |
report_time |
cadeia de caracteres (ISO 8601) | Data e hora de geração do relatório |
Lançamentos de versões do Kubernetes
Obter o índice de versões do Kubernetes
O endpoint seguinte devolve um índice de todas as versões do Kubernetes com relatórios CVE disponíveis:
GET /api/v1/aks-k8s-releases/_index
Exemplo de pedido:
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/_index
Exemplo de resposta:
{
"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"
}
Campos de resposta:
| Campo | Tipo | Description |
|---|---|---|
k8s_versions |
string[] | Versões disponíveis do Kubernetes, ordenadas por semver |
report_time |
cadeia de caracteres (ISO 8601) | Quando este índice foi gerado pela última vez |
Obtenha o relatório CVE da versão Kubernetes
O seguinte endpoint devolve o relatório CVE para uma versão específica do Kubernetes, detalhando vulnerabilidades nas imagens do contentor usadas pelos componentes principais do Kubernetes e pelos add-ons AKS dessa versão:
GET /api/v1/aks-k8s-releases/{version}/scan-reports
Parâmetros do caminho:
| Parameter | Tipo | Description | Exemplo |
|---|---|---|---|
version |
cadeia (de caracteres) | Versão do Kubernetes no índice | 1.33.2 |
Exemplo de pedido:
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/1.33.2/scan-reports
Exemplo de resposta (abreviada):
{
"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"
}
Campos de resposta:
| Campo | Tipo | Description |
|---|---|---|
k8s_version |
cadeia (de caracteres) | Versão Kubernetes (por exemplo, "1.33.2") |
container_targets |
AKSK8SContainerTarget[] | Imagens de contentores para esta versão do Kubernetess |
report_time |
cadeia de caracteres (ISO 8601) | Data e hora de geração do relatório |
Lançamentos VHD (imagem de nó)
Obtenha o índice de lançamentos VHD
O endpoint seguinte devolve um índice de todas as versões VHD com relatórios CVE disponíveis:
GET /api/v1/vhd-releases/_index
Exemplo de pedido:
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/_index
Exemplo de resposta (abreviada):
{
"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"
}
Campos de resposta:
| Campo | Tipo | Description |
|---|---|---|
vhd_release_versions |
string[] | Lançamentos VHD disponíveis em {distro}/{version} formato |
report_time |
cadeia de caracteres (ISO 8601) | Quando este índice foi gerado pela última vez |
Distribuições disponíveis:
| Prefixo da distribuição | Description |
|---|---|
AKSAzureLinux-gen1 |
Azure Linux V2, Geração 1 |
AKSAzureLinux-gen2 |
Azure Linux V2, Geração 2 |
AKSAzureLinux-gen1fips |
Azure Linux V2, Gen 1, com FIPS ativado |
AKSAzureLinux-gen2fips |
Azure Linux V2, Gen 2, habilitado para FIPS |
AKSAzureLinux-gen2kata |
Azure Linux V2, Gen 2, Kata containers |
AKSAzureLinux-gen2tl |
Azure Linux V2, Gen 2, variante TL |
AKSAzureLinuxV3-gen1 |
Azure Linux V3, Geração 1 |
AKSAzureLinuxV3-gen2 |
Azure Linux V3, Geração 2 |
AKSAzureLinuxV3-gen1fips |
Azure Linux V3, Gen 1, compatível com FIPS |
AKSAzureLinuxV3-gen2fips |
Azure Linux V3, Gen 2, com FIPS ativado |
AKSAzureLinuxV3-gen2tl |
Azure Linux V3, Gen 2, variante TL |
AKSCBLMarinerV2-gen1 |
CBL-Mariner V2, Geração 1 |
AKSCBLMarinerV2-gen2 |
CBL-Mariner V2, Geração 2 |
AKSCBLMarinerV2-gen1fips |
CBL-Mariner V2, Gen 1, compatível com FIPS |
AKSCBLMarinerV2-gen2fips |
CBL-Mariner V2, Gen 2, habilitado para FIPS |
AKSCBLMarinerV2-gen2kata |
CBL-Mariner V2, Gen 2, recipientes Kata |
AKSCBLMarinerV2-gen2tl |
CBL-Mariner V2, Gen 2, variante TL |
AKSUbuntu-gen1-2004fipscontainerd |
Ubuntu 20.04, Gen 1, FIPS |
AKSUbuntu-gen1-2204containerd |
Ubuntu 22.04, Geração 1 |
AKSUbuntu-gen1-2404containerd |
Ubuntu 24.04, Geração 1 |
AKSUbuntu-gen2-2004cvmcontainerd |
Ubuntu 20.04, Gen 2, máquina virtual confidencial |
AKSUbuntu-gen2-2004fipscontainerd |
Ubuntu 20.04, Gen 2, FIPS |
AKSUbuntu-gen2-2204containerd |
Ubuntu 22.04, Geração 2 |
AKSUbuntu-gen2-2404containerd |
Ubuntu 24.04, Geração 2 |
AKSUbuntu-gen2-2204tlcontainerd |
Ubuntu 22.04, Gen 2, variante TL |
AKSUbuntu-gen2-2404tlcontainerd |
Ubuntu 24.04, Gen 2, variante TL |
Obter relatório de CVE da versão VHD
O seguinte endpoint devolve o relatório CVE para uma versão específica de VHD, incluindo tanto os pacotes do sistema operativo como as imagens do contentor incluídas nessa versão:
GET /api/v1/vhd-releases/{distro}/{version}/scan-reports
Parâmetros do caminho:
| Parameter | Tipo | Description | Exemplo |
|---|---|---|---|
distro |
cadeia (de caracteres) | Identificador de distribuição Linux | AKSUbuntu-gen2-2204containerd |
version |
cadeia (de caracteres) | Versão de lançamento em VHD | 202601.13.0 |
Exemplo de pedido:
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/AKSUbuntu-gen2-2204containerd/202601.13.0/scan-reports
Exemplo de resposta (abreviada):
{
"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"
}
Campos de resposta:
| Campo | Tipo | Description |
|---|---|---|
distro_name |
cadeia (de caracteres) | Nome da distribuição Linux (por exemplo, "AKSAzureLinux/gen2") |
vhd_release_version |
cadeia (de caracteres) | Versão atual do VHD |
previous_vhd_release_version |
cadeia (de caracteres) | Versão anterior do VHD |
os_package_targets |
AKSVHDOSPackageTarget[] | Pacotes do SO incluídos neste VHD |
container_targets |
AKSVHDContainerTarget[] | Imagens de contentores incluídas neste VHD |
report_time |
cadeia de caracteres (ISO 8601) | Data e hora de geração do relatório |
Imagens de contêiner
Os endpoints de imagens de contentores fornecem relatórios de análise de CVE por imagem e acompanhamento da mitigação entre versões para imagens de contentores individuais. Estes endpoints não têm uma listagem _index; a navegação é feita através do caminho completo da imagem.
Obter o relatório de análise CVE da imagem do contentor
O ponto terminal seguinte obtém um relatório de verificação de CVE para uma imagem de contentor específica identificada pelo caminho completo da imagem e pela respetiva etiqueta:
GET /api/v1/container-images/{image}:{tag}/scan-reports
Parâmetros do caminho:
| Parameter | Tipo | Description | Exemplo |
|---|---|---|---|
image |
cadeia (de caracteres) | Nome completo da imagem, incluindo o registo | mcr.microsoft.com/oss/kubernetes/kube-proxy |
tag |
cadeia (de caracteres) | Tag de imagem | v1.31.11 |
Exemplo de pedido:
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
Exemplo de resposta (abreviada):
{
"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"}
]
}
]
}
Campos de resposta:
| Campo | Tipo | Description |
|---|---|---|
image_repo_tags |
string[] | Etiquetas de imagem para a imagem digitalizada |
image_repo_digests |
string[] | Resumos de imagens para todas as plataformas suportadas |
report_time |
cadeia de caracteres (ISO 8601) | Data e hora de geração do relatório |
active_cves |
CVEList[] | CVEs ativos agrupados por scanner |
Obtenha o relatório de mitigação CVE da imagem do contentor
O endpoint seguinte recupera um relatório de mitigação de CVE para um repositório específico de imagens de contentores e mostra quais CVEs foram observados em que versões e lançamentos componentes, e em que versões e lançamentos foram mitigados:
GET /api/v1/container-images/{image}/mitigation-reports
Parâmetros do caminho:
| Parameter | Tipo | Description | Exemplo |
|---|---|---|---|
image |
cadeia (de caracteres) | Nome completo da imagem, incluindo o repositório (sem tag) | mcr.microsoft.com/oss/kubernetes/kube-proxy |
Exemplo de pedido:
curl -s https://cve-api.prod-aks.azure.com/api/v1/container-images/mcr.microsoft.com/oss/kubernetes/kube-proxy/mitigation-reports
Exemplo de resposta (abreviada):
{
"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": []
}
]
}
Campos de resposta:
| Campo | Tipo | Description |
|---|---|---|
container_image |
cadeia (de caracteres) | Nome da imagem sem etiqueta |
mitigations |
CVEMitigation[] | Entradas de mitigação CVE para esta imagem |
Pacotes do SO VHD
Os endpoints dos pacotes VHD OS fornecem relatórios de análise CVE por pacote e acompanhamento de mitigação entre lançamentos para pacotes individuais de SO instalados em imagens de nós VHD. Estes endpoints não têm listagem _index ; navega pelo nome do pacote.
Obtenha o relatório de análise CVE do pacote VHD OS
O endpoint seguinte recupera um relatório de análise CVE para uma versão específica do pacote do SO instalado em imagens de nós VHD:
GET /api/v1/vhd-packages/{name}/{version}/scan-reports
Parâmetros do caminho:
| Parameter | Tipo | Description | Exemplo |
|---|---|---|---|
name |
cadeia (de caracteres) | Nome do pacote OS (minúscula) | openssl |
version |
cadeia (de caracteres) | Versão do pacote | 3.0.2-0ubuntu1.20 |
Exemplo de pedido:
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/3.0.2-0ubuntu1.20/scan-reports
Exemplo de resposta:
{
"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"
}
Campos de resposta:
| Campo | Tipo | Description |
|---|---|---|
name |
cadeia (de caracteres) | Nome do pacote |
version |
cadeia (de caracteres) | Versão do pacote |
active_cves |
CVE[] | CVEs ativas com correções disponíveis |
report_time |
cadeia de caracteres (ISO 8601) | Data e hora de geração do relatório |
Obtenha o relatório de mitigação CVE do pacote VHD OS
O endpoint seguinte recupera um relatório de mitigação de CVE para um pacote de sistema operativo específico e mostra quais CVEs foram vistos em quais versões de pacotes e lançamentos VHD, e em quais versões foram mitigados:
GET /api/v1/vhd-packages/{name}/mitigation-reports
Parâmetros do caminho:
| Parameter | Tipo | Description | Exemplo |
|---|---|---|---|
name |
cadeia (de caracteres) | Nome do pacote OS (minúscula) | openssl |
Exemplo de pedido:
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/mitigation-reports
Exemplo de resposta (abreviada):
{
"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": []
}
]
}
Campos de resposta:
| Campo | Tipo | Description |
|---|---|---|
package_name |
cadeia (de caracteres) | Nome do pacote OS |
mitigations |
CVEMitigation[] | Entradas de mitigação CVE para este pacote |
Modelos de dados
As secções seguintes descrevem os modelos de dados devolvidos pela API de Dados de Vulnerabilidade do AKS, incluindo a estrutura das entradas CVE, referências de imagens de contentores, componentes de lançamento do AKS, pacotes do VHD OS e as relações entre eles.
CVE
O modelo de dados CVE é um identificador de Vulnerabilidades e Exposições Comuns.
| Campo | Tipo | Description |
|---|---|---|
id |
cadeia (de caracteres) | Identificador CVE (por exemplo, "CVE-2024-13176", "GHSA-2464-8j7c-4cjm") |
ContainerImages
O modelo de dados ContainerImages representa um conjunto de referências de imagens de contentores, incluindo tanto etiquetas legíveis por humanos como resumos endereçáveis por conteúdo.
| Campo | Tipo | Description |
|---|---|---|
image_repo_tags |
string[] | Etiquetas de imagem (por exemplo, "mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9") |
image_repo_digests |
string[] | Resumos de imagens para todas as plataformas suportadas (por exemplo, "mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9@sha256:abc...") |
Note
Os digests incluem todas as variantes da plataforma Linux (amd64, arm64) de manifestos multi-arch. Isto permite correlacionar dados de CVE independentemente do digest específico da plataforma que o seu nó transferiu.
AKSReleaseContainerTarget
O modelo de dados AKSReleaseContainerTarget representa um componente de contentor numa versão específica do AKS, identificado pelo espaço de nomes do pod e pelo nome do contentor em que é executado, bem como pelas imagens de contentor que utiliza e pelos CVEs que o afetam.
| Campo | Tipo | Description |
|---|---|---|
pod_namespace |
cadeia (de caracteres) | Espaço de nomes Kubernetes (por exemplo, "kube-system", "calico-system") |
container_name |
cadeia (de caracteres) | Nome do contentor (por exemplo, "coredns", "calico-node") |
active_container_images |
ContainerImages | Imagens do contentor atualmente a correr para este componente |
active_cves |
CVE[] | CVEs com correções disponíveis que afetam atualmente este componente |
removed_container_images_from_previous_release |
ContainerImages | Imagens que estavam presentes na versão anterior mas que já não estão a funcionar |
mitigated_cves_from_previous_release |
CVE[] | CVEs que existiam na versão anterior mas que foram corrigidos nesta versão |
AKSK8SContainerTarget
O modelo de dados AKSK8SContainerTarget representa uma imagem de contentor associada a uma versão específica do Kubernetes, incluindo as referências etiquetadas da imagem e os digests dessa imagem, bem como os CVEs que a afetam.
| Campo | Tipo | Description |
|---|---|---|
container_image |
cadeia (de caracteres) | Nome da imagem sem etiqueta (por exemplo, "mcr.microsoft.com/oss/kubernetes/kube-apiserver") |
active_container_images |
ContainerImages | Referências e resumos de imagens etiquetadas |
active_cves |
CVE[] | CVEs ativas com correções disponíveis |
AKSVHDContainerTarget
O modelo de dados AKSVHDContainerTarget representa uma imagem de contentor incluída numa imagem de nó VHD, juntamente com as referências de imagens etiquetadas, digests e CVEs que a afetam.
| Campo | Tipo | Description |
|---|---|---|
container_image |
cadeia (de caracteres) | Nome da imagem sem etiqueta |
active_container_images |
ContainerImages | Referências e resumos de imagens etiquetadas |
active_cves |
CVE[] | CVEs ativas com correções disponíveis |
removed_container_images_from_previous_release |
ContainerImages | Imagens removidas desde o lançamento anterior em VHD |
mitigated_cves_from_previous_release |
CVE[] | CVEs corrigidos desde a versão anterior do VHD |
AKSVHDOSPackageTarget
O modelo de dados AKSVHDOSPackageTarget representa um pacote do sistema operativo instalado numa imagem de nó VHD, juntamente com a versão instalada, os CVEs que o afetam e quaisquer alterações em relação à versão anterior do VHD.
| Campo | Tipo | Description |
|---|---|---|
name |
cadeia (de caracteres) | Nome do pacote (por exemplo, "kernel", "containerd", "systemd") |
version |
cadeia (de caracteres) | Versão do pacote (por exemplo, "6.1.109.2-1.cm2") |
active_cves |
CVE[] | CVEs ativas com correções disponíveis |
previous_version |
cadeia (de caracteres) | Versão da versão anterior do VHD (vazio se não tiver sido alterado) |
mitigated_cves_from_previous_release |
CVE[] | CVEs corrigidos desde a versão anterior do VHD |
CVEScanner
O modelo de dados CVEScanner representa os metadados de um scanner de vulnerabilidades que produz resultados de varredura CVE para imagens de contentores.
| Campo | Tipo | Description |
|---|---|---|
name |
cadeia (de caracteres) | Nome do scanner (por exemplo, "trivy") |
version |
cadeia (de caracteres) | Versão do scanner (por exemplo, "0.69.1") |
CVEList
O modelo de dados CVEList representa um conjunto de CVEs detetados por um scanner de vulnerabilidades particular para uma dada imagem de contentor. Cada entrada associa os metadados do scanner com a lista de CVEs que detetou.
| Campo | Tipo | Description |
|---|---|---|
scanner |
CVEScanner | O scanner que produziu estes resultados |
cves |
CVE[] | CVEs detetados por este scanner |
CVEMitigation
O modelo de dados CVEMitigation acompanha um único CVE através de versões de componentes e tipos de lançamento, mostrando onde foi observado e onde foi mitigado.
| Campo | Tipo | Description |
|---|---|---|
cve |
CVE | O CVE a ser monitorizado |
seen_in_component_versions |
string[] | Versões de componentes (etiquetas de imagem ou versões de pacotes) onde este CVE foi detetado |
seen_in_aks_release_versions |
string[] | Versões de lançamento do AKS onde este CVE foi detetado |
seen_in_aks_k8s_release_versions |
string[] | Versões de lançamento do Kubernetes onde este CVE foi detetado |
seen_in_vhd_release_versions |
string[] | Versões de lançamento VHD onde este CVE foi detetado |
mitigated_in_component_versions |
string[] | Versões componentes onde este CVE foi corrigido |
mitigated_in_aks_release_versions |
string[] | Versões de lançamento do AKS onde este CVE foi corrigido |
mitigated_in_aks_k8s_release_versions |
string[] | Versões do Kubernetes onde este CVE foi corrigido |
mitigated_in_vhd_release_versions |
string[] | versões de lançamento VHD onde este CVE foi corrigido |
Rastreamento delta
Relatórios de lançamento AKS e VHD incluem campos delta que comparam a versão atual com a anterior:
-
mitigated_cves_from_previous_release: CVEs que estavam presentes na versão anterior, mas que deixaram de ser detetadas. Isto significa que a vulnerabilidade foi corrigida (por exemplo, através de um aumento da versão do componente). -
removed_container_images_from_previous_release: Imagens de contentores que estavam a correr na versão anterior mas que estão ausentes na versão atual.
Note
Os relatórios de versão do Kubernetes não incluem campos delta.
Resumos multi-arquitetura
Cada imagem de contentor pode incluir múltiplas referências de digest para diferentes arquiteturas de CPU (amd64, arm64). A API inclui todos os digests da plataforma Linux dos manifestos multiarquitetura, para que possa correlacionar os dados de CVE independentemente do digest específico da plataforma que o seu nó obteve.
Formatos de versões de relatório
Os relatórios da API de Dados de Vulnerabilidades do AKS utilizam diferentes esquemas de versionamento dependendo do tipo de lançamento reportado. A tabela seguinte resume os formatos usados para lançamentos AKS, versões Kubernetes e lançamentos VHD:
| Tipo de versão | Formato | Exemplo |
|---|---|---|
| Lançamento do AKS | v{YYYYMMDD} |
v20260104 |
| Versão do Kubernetes | Semver | 1.33.2 |
| Lançamento em VHD | {distro}/{YYYYMM.DD.patch} |
AKSAzureLinux-gen2/202512.06.0 |
Conteúdo relacionado
Para mais informações sobre a AKS Vulnerability Data API, consulte Vulnerability Data API para Azure Kubernetes Service (AKS) visão geral.