Where to find documentation of all available options for the $expand api param of the assessments endpoint

Dima Rozinov 0

I'm trying to use this api: https://video2.skills-academy.com/en-us/rest/api/defenderforcloud/assessments/list?view=rest-defenderforcloud-2020-01-01&tabs=HTTP

Even though not documented in the linked page, the $expand param is supported (this is documented in the related Get request documentation: https://video2.skills-academy.com/en-us/rest/api/defenderforcloud/assessments/get?view=rest-defenderforcloud-2020-01-01&tabs=HTTP)

The Get documentation seems to indicate that only metadata and link are supported values to the expand param: https://video2.skills-academy.com/en-us/rest/api/defenderforcloud/assessments/get?view=rest-defenderforcloud-2020-01-01&tabs=HTTP#expandenum

However, I also found this answer which mentions statusEvaluationDates. Tested and it also works: https://video2.skills-academy.com/en-us/answers/questions/585183/how-to-filter-unhealthy-resources-through-assessme

My question is - is there a place where all available values to the $expand param are documented? I'm trying to get as much information as possible about assessments and related resources without having to execute too many queries.

Dima Rozinov 0 Reputation points

2024-04-10T00:57:13.2566667+00:00

Forgot link, edit doesn't seem to work?
https://video2.skills-academy.com/en-us/answers/questions/585183/how-to-filter-unhealthy-resources-through-assessme
Givary-MSFT 32,501 Reputation points Microsoft Employee

2024-04-15T10:43:03.7466667+00:00

@Dima Rozinov Thank you for reaching out to us, As I understand you are looking for documentation of all available options for the $expand api param of the assessments endpoint within defender for cloud.

Reviewed the above-mentioned links are the only official info which can be referred and to cover all possible scenarios/examples is not feasible to document, any specific use case which you want to achieve, let me know so that I can repro at my end or check with the team internally on your requirement.

Let me know if you have any further questions, feel free to post back.
Dima Rozinov 0 Reputation points

2024-04-16T17:20:30.2733333+00:00
Thanks for the reply @Givary-MSFT

I am looking for the following information to supplement the response of the assessment api:

filter for assessments with unhealthy status only

unhealthy assessment creation time

underlying resource's location

underlying resource's tags

underlying resource's location virtual network

Further:

I'd like to have a comprehensive list of all possible resource types

I was not able to find any documentation of the result set size of the assessment api. I've seen some other endpoint return 500 results per page, but not sure if the same is true for the assessment api

Any help with this would be greatly appreciated.

Share via

Where to find documentation of all available options for the $expand api param of the assessments endpoint

Your answer