For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/security-monitoring/list-scanned-assets-metadata.md. A documentation index is available at /llms.txt.
Language
Datadog site

Énumérer les métadonnées des ressources analysées

WARNINGNote: 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

Présentation

Récupérer des métadonnées sur les ressources analysées par la sécurité pour une organisation.

Pagination

Pour l'endpoint « List Vulnerabilities », consultez la section Pagination.

Filtrage

Pour l'endpoint « List Vulnerabilities », consultez la section Filtrage.

Métadonnées

Pour l'endpoint « List Vulnerabilities », consultez la section Métadonnées.

Endpoints associés

Cet endpoint renvoie des métadonnées supplémentaires sur les ressources cloud qui ne sont pas disponibles via les endpoints de ressources standard. Pour accéder à un ensemble de données plus riche, appelez cet endpoint conjointement avec le ou les endpoints de ressources pertinents et fusionnez (joignez) leurs résultats à l'aide de l'identifiant de ressource.

Hosts

Pour enrichir les données de host, joignez la réponse de l'endpoint Hosts avec la réponse de l'endpoint scanned-assets-metadata sur les champs clés suivants :

ENDPOINT CLÉ DE JOINTURE TYPE
/api/v1/hosts host_list.host_name string
/api/v2/security/scanned-assets-metadata data.attributes.asset.name string

Images de host

Pour enrichir les données d'image de host, joignez la réponse de l'endpoint Hosts avec la réponse de l'endpoint scanned-assets-metadata sur les champs clés suivants :

ENDPOINT CLÉ DE JOINTURE TYPE
/api/v1/hosts host_list.tags_by_source["Amazon Web Services"]["image"] string
/api/v2/security/scanned-assets-metadata data.attributes.asset.name string

Images de conteneur

Pour enrichir les données d'image de conteneur, joignez la réponse de l'endpoint Container Images avec la réponse de l'endpoint scanned-assets-metadata sur les champs clés suivants :

ENDPOINT CLÉ DE JOINTURE TYPE
/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.

Arguments

Chaînes de requête

Name
Type
Description
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.

Réponse

OK

The expected response schema when listing scanned assets metadata.

Champ
Type
Description
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.

Exemple de code

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