For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/es/api/latest/security-monitoring/list-scanned-assets-metadata.md. A documentation index is available at /llms.txt.
Language
Datadog site

Enumerar metadatos de recursos analizados

ADVERTENCIANote: This endpoint is a private preview. If you are interested in accessing this API, fill out this form.
GEThttps://api.datadoghq.com/api/v2/security/scanned-assets-metadatahttps://api.us3.datadoghq.com/api/v2/security/scanned-assets-metadatahttps://api.us5.datadoghq.com/api/v2/security/scanned-assets-metadatahttps://api.datadoghq.eu/api/v2/security/scanned-assets-metadatahttps://api.ap1.datadoghq.com/api/v2/security/scanned-assets-metadatahttps://api.ap2.datadoghq.com/api/v2/security/scanned-assets-metadatahttps://api.uk1.datadoghq.com/api/v2/security/scanned-assets-metadatahttps://api.ddog-gov.com/api/v2/security/scanned-assets-metadatahttps://api.us2.ddog-gov.com/api/v2/security/scanned-assets-metadata

Descripción general

Obtén una lista de metadatos de seguridad de los recursos analizados de una organización.

Paginación

Para el endpoint "Lista de vulnerabilidades", consulta la sección Paginación.

Filtrado

Para el endpoint "Lista de vulnerabilidades", consulte la sección Filtrado.

Metadatos

Para el endpoint "Lista de vulnerabilidades", consulta la sección Metadatos.

Endpoints relacionados

Este endpoint devuelve metadatos adicionales de los recursos de la nube que no están disponibles en endpoints de recursos estándar. Para acceder a un conjunto de datos más completo, llama a este endpoint junto con los endpoints de recursos relevantes y combina (une) sus resultados utilizando el identificador de recursos.

Hosts

Para enriquecer los datos de host, une la respuesta del endpoint del host con la respuesta del endpoint de metadatos de recursos analizados en los siguientes campos clave:

ENDPOINT CLAVE DE UNIÓN TIPO
/api/v1/hosts host_list.host_name string
/api/v2/security/scanned-assets-metadata data.attributes.asset.name string

Imágenes de hosts

Para enriquecer los datos de imágenes de host, une la respuesta del endpoint del host con la respuesta del endpoint de metadatos de recursos analizados en los siguientes campos clave:

ENDPOINT CLAVE DE UNIÓN TIPO
/api/v1/hosts host_list.tags_by_source["Amazon Web Services"]["image"] string
/api/v2/security/scanned-assets-metadata data.attributes.asset.name string

Imágenes de contenedores

Para enriquecer los datos de imágenes de contenedor, una la respuesta del endpoint de las imágenes de contenedor con la respuesta del endpoint de metadatos de recursos analizados en los siguientes campos clave:

ENDPOINT CLAVE DE UNIÓN TIPO
/api/v2/container_images data.attributes.name@data.attributes.repo_digest string
/api/v2/security/scanned-assets-metadata data.attributes.asset.name string

This endpoint requires the appsec_vm_read permission.

Argumentos

Cadenas de consulta

Nombre
Type
Descripción
page[token]
string

Its value must come from the links section of the response of the first request. Do not manually edit it.

page[number]
integer

The page number to be retrieved. It should be equal to or greater than 1.

filter[asset.type]
enum

The type of the scanned asset.

Allowed enum values: Host, HostImage, Image
filter[asset.name]
string

The name of the scanned asset.

filter[last_success.origin]
string

The origin of last success scan.

filter[last_success.env]
string

The environment of last success scan.

Respuesta

OK

The expected response schema when listing scanned assets metadata.

Campo
Type
Descripción
data [required]
[object]

List of scanned assets metadata.

links
object

The JSON:API links related to pagination.

meta
object

The metadata related to this request.

Ejemplo de código

Enumerar metadatos de recursos analizados
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/security/scanned-assets-metadata" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/security/scanned-assets-metadata" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/security/scanned-assets-metadata" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/security/scanned-assets-metadata" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/security/scanned-assets-metadata" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/security/scanned-assets-metadata" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/security/scanned-assets-metadata" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/security/scanned-assets-metadata" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/security/scanned-assets-metadata" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"