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/get-sbom.md. A documentation index is available at /llms.txt.
homeHomedocs문서apiAPI
Language
Datadog site

SBOM 가져오기

GEThttps://api.datadoghq.com/api/v2/security/sboms/{asset_type}https://api.us3.datadoghq.com/api/v2/security/sboms/{asset_type}https://api.us5.datadoghq.com/api/v2/security/sboms/{asset_type}https://api.datadoghq.eu/api/v2/security/sboms/{asset_type}https://api.ap1.datadoghq.com/api/v2/security/sboms/{asset_type}https://api.ap2.datadoghq.com/api/v2/security/sboms/{asset_type}https://api.uk1.datadoghq.com/api/v2/security/sboms/{asset_type}https://api.ddog-gov.com/api/v2/security/sboms/{asset_type}https://api.us2.ddog-gov.com/api/v2/security/sboms/{asset_type}

개요

자산의 유형과 이름을 기준으로 해당 자산과 관련된 단일 SBOM을 가져옵니다.

This endpoint requires the appsec_vm_read permission.

인수

경로 파라미터

이름
유형
설명
asset_type [required]
enum

The type of the asset for the SBOM request.

Allowed enum values: Repository, Service, Host, HostImage, Image, ServerlessFunction

쿼리 문자열

이름
유형
설명
filter[asset_name] [required]
string

The name of the asset for the SBOM request.

filter[repo_digest]
string

The container image repo_digest for the SBOM request. When the requested asset type is 'Image', this filter is mandatory.

ext:format
enum

The standard of the SBOM.

Allowed enum values: CycloneDX, SPDX

응답

OK

The expected response schema when getting an SBOM.

항목
유형
설명
data [required]
object

A single SBOM

코드 예시

SBOM 가져오기
# Path parameters
export asset_type="Repository"
# Required query arguments
export filter_asset_name="github.com/datadog/datadog-agent"

# 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/sboms/${asset_type}?filter%5Basset_name%5D=${filter_asset_name}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export asset_type="Repository"
# Required query arguments
export filter_asset_name="github.com/datadog/datadog-agent"

# 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/sboms/${asset_type}?filter%5Basset_name%5D=${filter_asset_name}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export asset_type="Repository"
# Required query arguments
export filter_asset_name="github.com/datadog/datadog-agent"

# 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/sboms/${asset_type}?filter%5Basset_name%5D=${filter_asset_name}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export asset_type="Repository"
# Required query arguments
export filter_asset_name="github.com/datadog/datadog-agent"

# 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/sboms/${asset_type}?filter%5Basset_name%5D=${filter_asset_name}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export asset_type="Repository"
# Required query arguments
export filter_asset_name="github.com/datadog/datadog-agent"

# 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/sboms/${asset_type}?filter%5Basset_name%5D=${filter_asset_name}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export asset_type="Repository"
# Required query arguments
export filter_asset_name="github.com/datadog/datadog-agent"

# 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/sboms/${asset_type}?filter%5Basset_name%5D=${filter_asset_name}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export asset_type="Repository"
# Required query arguments
export filter_asset_name="github.com/datadog/datadog-agent"

# 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/sboms/${asset_type}?filter%5Basset_name%5D=${filter_asset_name}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export asset_type="Repository"
# Required query arguments
export filter_asset_name="github.com/datadog/datadog-agent"

# 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/sboms/${asset_type}?filter%5Basset_name%5D=${filter_asset_name}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export asset_type="Repository"
# Required query arguments
export filter_asset_name="github.com/datadog/datadog-agent"

# 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/sboms/${asset_type}?filter%5Basset_name%5D=${filter_asset_name}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"