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

Hacer una lista de resultados

ADVERTENCIANote: This endpoint uses the legacy security findings data model and is planned for deprecation. Use the search security findings endpoint, which is based on the new security findings schema, to search security findings. If you have any feedback, contact Datadog support.
GEThttps://api.datadoghq.com/api/v2/posture_management/findingshttps://api.us3.datadoghq.com/api/v2/posture_management/findingshttps://api.us5.datadoghq.com/api/v2/posture_management/findingshttps://api.datadoghq.eu/api/v2/posture_management/findingshttps://api.ap1.datadoghq.com/api/v2/posture_management/findingshttps://api.ap2.datadoghq.com/api/v2/posture_management/findingshttps://api.uk1.datadoghq.com/api/v2/posture_management/findingshttps://api.ddog-gov.com/api/v2/posture_management/findingshttps://api.us2.ddog-gov.com/api/v2/posture_management/findings

Descripción general

Obtén una lista de hallazgos. Estos incluyen los errores de configuración y los riesgos de identidad.

Nota: Para filtrar y devolver solo riesgos de identidad, añade el siguiente parámetro de consultas: ?filter[tags]=dd_rule_type:ciem

Filtrado

Se pueden aplicar filtros al anexar parámetros de consulta a la URL.

  • Uso de un filtro único: ?filter[attribute_key]=attribute_value
  • Encadenar filtros: ?filter[attribute_key]=attribute_value&filter[attribute_key]=attribute_value...
  • Filtros en etiquetas: ?filter[tags]=tag_key:tag_value&filter[tags]=tag_key_2:tag_value_2

Aquí, attribute_key puede ser cualquiera de las claves de filtro descritas a continuación.

Parámetros de consulta de tipo integer admiten operadores de comparación (>, >=, <, <=). Esto es muy útil al filtrar por evaluation_changed_at o resource_discovery_timestamp. Por ejemplo: ?filter[evaluation_changed_at]=>20123123121.

Puedes también utilizar el operador de negación en cadenas. Por ejemplo, usa filter[resource_type]=-aws* para filtrar cualquier recurso que no sea de AWS.

El operador debe estar después de un signo igual. Por ejemplo, para filtrar con el operador >= añade el operador después del signo igual: filter[evaluation_changed_at]=>=1678809373257.

Los parámetros de consulta deben estar solo entre los parámetros registrados y con valores de tipos correctos. Los parámetros de consulta duplicados (por ejemplo, filter[status]=low&filter[status]=info) no están permitidos.

Campos de extensión adicionales

Los campos de extensión adicionales están disponibles para algunos hallazgos.

Los datos están disponibles cuando incluyes el parámetro de consulta ?detailed_findings=true en la solicitud.

Los siguientes campos están disponibles para los hallazgos:

  • external_id: el ID de recurso externo relacionado al hallazgo.
  • description: los pasos de descripción y corrección para el hallazgo.
  • datadog_link: el enlace de Datadog relacionado para el hallazgo.
    • ip_addresses: la lista de direcciones IP privadas para el recurso relacionado al hallazgo.

Respuesta

La respuesta incluye una matriz de objetos de hallazgo, metadatos de paginación y un recuento de elementos que coinciden con la consulta.

Cada objeto de hallazgo contiene lo siguiente:

  • El ID de hallazgo que se puede usar en una solicitud GetFinding para recuperar todos los detalles del hallazgo.
  • Atributos principales, incluido estado, evaluación, detalles de recurso muy claro, estado silenciado y detalles de reglas.
  • Marcas temporales evaluation_changed_at y resource_discovery_date.
  • Una matriz de etiquetas asociadas.

OAuth apps require the security_monitoring_findings_read authorization scope to access this endpoint.

Argumentos

Cadenas de consulta

Nombre
Type
Descripción
page[limit]
integer

Limit the number of findings returned. Must be <= 1000.

Default: 100
snapshot_timestamp
integer

Return findings for a given snapshot of time (Unix ms).

page[cursor]
string

Return the next page of findings pointed to by the cursor.

filter[tags]
string

Return findings that have these associated tags (repeatable).

filter[evaluation_changed_at]
string

Return findings that have changed from pass to fail or vice versa on a specified date (Unix ms) or date range (using comparison operators).

filter[muted]
boolean

Set to true to return findings that are muted. Set to false to return unmuted findings.

filter[rule_id]
string

Return findings for the specified rule ID.

filter[rule_name]
string

Return findings for the specified rule.

filter[resource_type]
string

Return only findings for the specified resource type.

filter[@resource_id]
string

Return only findings for the specified resource id.

filter[discovery_timestamp]
string

Return findings that were found on a specified date (Unix ms) or date range (using comparison operators).

filter[evaluation]
enum

Return only pass or fail findings.

Allowed enum values: pass, fail
filter[status]
enum

Return only findings with the specified status.

Allowed enum values: critical, high, medium, low, info
filter[vulnerability_type]
array

Return findings that match the selected vulnerability types (repeatable).

detailed_findings
boolean

Return additional fields for some findings.

Respuesta

OK

The expected response schema when listing findings.

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

Array of findings.

meta [required]
object

Metadata for pagination.

Ejemplo de código

Hacer una lista de resultados
# 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/posture_management/findings" \
-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/posture_management/findings" \
-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/posture_management/findings" \
-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/posture_management/findings" \
-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/posture_management/findings" \
-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/posture_management/findings" \
-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/posture_management/findings" \
-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/posture_management/findings" \
-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/posture_management/findings" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"