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

스캔된 자산 메타데이터 목록 표시

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

개요

조직에 대한 보안 스캔 자산 메타데이터 목록을 가져옵니다.

페이지 매김

"취약성 목록" 엔드포인트는 페이지 매김 섹션을 참조하세요.

필터링

'취약성 목록' 엔드포인트는 필터링 섹션을 참조하세요.

메타데이터

'취약성 목록' 엔드포인트는 메타데이터 섹션을 참조하세요.

관련 엔드포인트

이 엔드포인트는 표준 리소스 엔드포인트에서 사용할 수 없는 클라우드 리소스에 대한 추가 메타데이터를 반환합니다. 더 풍부한 데이터 세트에 액세스하려면 이 엔드포인트를 관련 리소스 엔드포인트와 함께 호출하고 리소스 식별자를 사용하여 결과를 병합(조인)합니다.

호스트

호스트 데이터를 보강하려면 호스트 엔드포인트의 응답과 scanned-assets-metadata 엔드포인트의 응답을 다음 키 필드에서 조인합니다.

ENDPOINT JOIN KEY TYPE
/api/v1/hosts host_list.host_name string
/api/v2/security/scanned-assets-metadata data.attributes.asset.name string

호스트 이미지

호스트 이미지 데이터를 보강하려면 호스트 엔드포인트의 응답과 scanned-assets-metadata 엔드포인트의 응답을 다음 키 필드에서 조인합니다.

ENDPOINT JOIN KEY 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

Container Images

컨테이너 이미지 데이터를 보강하려면 Container Images 엔드포인트의 응답과 scanned-assets-metadata 엔드포인트의 응답을 다음 키 필드에서 조인합니다.

ENDPOINT JOIN KEY 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.

인수

쿼리 문자열

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

응답

OK

The expected response schema when listing scanned assets metadata.

항목
유형
설명
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.

코드 예시

스캔된 자산 메타데이터 목록 표시
# 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}"