provider Security Monitoring GET /api/v2/security/scanned-assets-metadata
@utdk/datadog /api/v2/security/scanned-assets-metadata
List scanned assets metadata
Get a list of security scanned assets metadata for an organization. ### Pagination For the "List Vulnerabilities" endpoint, see the [Pagination section](#pagination). ### Filtering For the "List Vulnerabilities" endpoint, see the [Filtering section](#filtering). ### Metadata For the "List Vulnerabilities" endpoint, see the [Metadata section](#metadata). ### Related endpoints This endpoint returns additional metadata for cloud resources that is not available from the standard resource endpoints. To access a richer dataset, call this endpoint together with the relevant resource endpoint(s) and merge (join) their results using the resource identifier. **Hosts** To enrich host data, join the response from the [Hosts](https://docs.datadoghq.com/api/latest/hosts/) endpoint with the response from the scanned-assets-metadata endpoint on the following key fields: | ENDPOINT | JOIN KEY | TYPE | | --- | --- | --- | | [/api/v1/hosts](https://docs.datadoghq.com/api/latest/hosts/) | host_list.host_name | string | | /api/v2/security/scanned-assets-metadata | data.attributes.asset.name | string | **Host Images** To enrich host image data, join the response from the [Hosts](https://docs.datadoghq.com/api/latest/hosts/) endpoint with the response from the scanned-assets-metadata endpoint on the following key fields: | ENDPOINT | JOIN KEY | TYPE | | --- | --- | --- | | [/api/v1/hosts](https://docs.datadoghq.com/api/latest/hosts/) | host_list.tags_by_source["Amazon Web Services"]["image"] | string | | /api/v2/security/scanned-assets-metadata | data.attributes.asset.name | string | **Container Images** To enrich container image data, join the response from the [Container Images](https://docs.datadoghq.com/api/latest/container-images/) endpoint with the response from the scanned-assets-metadata endpoint on the following key fields: | ENDPOINT | JOIN KEY | TYPE | | --- | --- | --- | | [/api/v2/container_images](https://docs.datadoghq.com/api/latest/container-images/) | `data.attributes.name`@`data.attributes.repo_digest` | string | | /api/v2/security/scanned-assets-metadata | data.attributes.asset.name | string |
page[token] query
Its value must come from the `links` section of the response of the first request. Do not manually edit it.
string
page[number] query
The page number to be retrieved. It should be equal to or greater than 1.
integer
filter[asset.type] query
The type of the scanned asset.
enum: Host, HostImage, Image
filter[asset.name] query
The name of the scanned asset.
string
filter[last_success.origin] query
The origin of last success scan.
string
filter[last_success.env] query
The environment of last success scan.
string

Try it

Authentication
Configure credentials for Datadog API V2 Collection
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.

Saved automatically to browser storage.

listscannedassetsmetadata
GET/api/v2/security/scanned-assets-metadata
Get a list of security scanned assets metadata for an organization. ### Pagination For the "List Vulnerabilities" endpoint, see the [Pagination section](#pagination). ### Filtering For the "List Vulnerabilities" endpoint, see the [Filtering section](#filtering). ### Metadata For the "List Vulnerabilities" endpoint, see the [Metadata section](#metadata). ### Related endpoints This endpoint returns additional metadata for cloud resources that is not available from the standard resource endpoints. To access a richer dataset, call this endpoint together with the relevant resource endpoint(s) and merge (join) their results using the resource identifier. **Hosts** To enrich host data, join the response from the [Hosts](https://docs.datadoghq.com/api/latest/hosts/) endpoint with the response from the scanned-assets-metadata endpoint on the following key fields: | ENDPOINT | JOIN KEY | TYPE | | --- | --- | --- | | [/api/v1/hosts](https://docs.datadoghq.com/api/latest/hosts/) | host_list.host_name | string | | /api/v2/security/scanned-assets-metadata | data.attributes.asset.name | string | **Host Images** To enrich host image data, join the response from the [Hosts](https://docs.datadoghq.com/api/latest/hosts/) endpoint with the response from the scanned-assets-metadata endpoint on the following key fields: | ENDPOINT | JOIN KEY | TYPE | | --- | --- | --- | | [/api/v1/hosts](https://docs.datadoghq.com/api/latest/hosts/) | host_list.tags_by_source["Amazon Web Services"]["image"] | string | | /api/v2/security/scanned-assets-metadata | data.attributes.asset.name | string | **Container Images** To enrich container image data, join the response from the [Container Images](https://docs.datadoghq.com/api/latest/container-images/) endpoint with the response from the scanned-assets-metadata endpoint on the following key fields: | ENDPOINT | JOIN KEY | TYPE | | --- | --- | --- | | [/api/v2/container_images](https://docs.datadoghq.com/api/latest/container-images/) | `data.attributes.name`@`data.attributes.repo_digest` | string | | /api/v2/security/scanned-assets-metadata | data.attributes.asset.name | string |

Its value must come from the `links` section of the response of the first request. Do not manually edit it.

The page number to be retrieved. It should be equal to or greater than 1.

The type of the scanned asset.

The name of the scanned asset.

The origin of last success scan.

The environment of last success scan.

Enter a gateway URL above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import datadog from '@utdk/datadog';

await datadog.listscannedassetsmetadata()