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

발견 사항 나열하기

경고Note: 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

개요

결과 목록을 가져옵니다. 여기에는 잘못된 구성과 ID 위험이 모두 포함됩니다.

참고: ID 위험만 필터링하여 반환하려면 다음 쿼리 파라미터를 추가합니다. ?filter[tags]=dd_rule_type:ciem

필터링

필터는 URL에 쿼리 파라미터를 추가하여 적용할 수 있습니다.

  • 단일 필터 사용: ?filter[attribute_key]=attribute_value
  • 필터 체이닝: ?filter[attribute_key]=attribute_value&filter[attribute_key]=attribute_value...
  • 태그 필터링: ?filter[tags]=tag_key:tag_value&filter[tags]=tag_key_2:tag_value_2

여기서 attribute_key는 아래에서 설명하는 필터 키 중 하나일 수 있습니다.

integer 유형의 쿼리 파라미터는 비교 연산자(>, >=, <, <=)를 지원합니다. 이는 evaluation_changed_at 또는 resource_discovery_timestamp로 필터링할 때 특히 유용합니다. 예: ?filter[evaluation_changed_at]=>20123123121.

문자열에 부정 연산자를 사용할 수도 있습니다. 예를 들어, filter[resource_type]=-aws*를 사용하여 AWS가 아닌 리소스를 필터링할 수 있습니다.

연산자는 등호 뒤에 와야 합니다. 예를 들어, >= 연산자로 필터링하려면 다음과 같이 등호 뒤에 연산자를 추가합니다. filter[evaluation_changed_at]=>=1678809373257.

쿼리 파라미터는 문서화된 것 중에서만 사용해야 하며 올바른 유형의 값을 가져야 합니다. 중복된 쿼리 파라미터(예: filter[status]=low&filter[status]=info)는 허용되지 않습니다.

추가 확장 필드

일부 결과에는 추가 확장 필드를 사용할 수 있습니다.

이 데이터는 요청에 쿼리 파라미터 ?detailed_findings=true를 포함할 때 사용할 수 있습니다.

결과에는 다음 필드를 사용할 수 있습니다.

  • external_id: 결과와 관련된 리소스 외부 ID입니다.
  • description: 결과에 대한 설명 및 수정 단계입니다.
  • datadog_link: 결과에 대한 Datadog 상대 링크입니다.
  • ip_addresses: 결과와 관련된 리소스의 사설 IP 주소 목록입니다.

응답

응답에는 발견 사항 객체 배열, 페이지 매김 메타데이터, 쿼리와 일치하는 항목 수가 포함됩니다.

각 발견 사항 객체에는 다음이 포함됩니다.

  • GetFinding 요청에서 전체 발견 사항 세부 정보를 조회하는 데 사용할 수 있는 탐지 결과 ID
  • 핵심 속성(상태, 평가, 상위 수준 리소스 세부 정보, 음소거 상태 및 규칙 세부 정보 포함)
  • evaluation_changed_at 및 resource_discovery_date 타임스탬프
  • 연결된 태그 배열

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

인수

쿼리 문자열

이름
유형
설명
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.

응답

OK

The expected response schema when listing findings.

항목
유형
설명
data [required]
[object]

Array of findings.

meta [required]
object

Metadata for pagination.

코드 예시

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