client.browser_extension¶
Access browser extension inventory and permission metadata.
Property¶
client.browser_extension
Methods¶
get_all() -> BrowserExtensionResults: fetch the JSON-backed browser extension inventory.get_all_files() -> BrowserExtensionResults: fetch the via-files browser extension inventory.permissionsinfo(query: BrowserExtensionsPermissionsInfoQuery | None = None) -> BrowserExtensionsPermissionsInfoResults: fetch permission metadata for browser extensions.
Notes¶
get_all()andget_all_files()expose the same results-wrapper interface.get_all_files()delegates to the machine endpoint's export-backed implementation.- Use
permissionsinfo()when you need extension permission metadata rather than per-machine inventory rows.
API¶
Microsoft Defender for Endpoint browser-extension inventory endpoint.
This module defines:
- BrowserExtensionsPermissionsInfoQuery: OData query model for filtering
browser extension permission records.
- BrowserExtensionResults and BrowserExtensionsResults: lazy result
wrappers mapped to the browser-extension Arrow schemas.
- BrowserExtensionEndpoint: a thin shim that forwards requests to the
browser-extension paths on the Machines API and returns correctly-typed
result wrappers. Core HTTP and pagination logic is inherited from
MachinesEndpoint / BaseEndpoint.
Endpoint methods return lazy BaseResults subclasses and defer HTTP requests
until a terminal materialization method is called.
Docs: https://learn.microsoft.com/en-us/defender-endpoint/api/export-browser-extensions-assessment
BrowserExtensionsPermissionsInfoQuery
¶
OData query parameters for the api/browserExtensions/permissionsinfo endpoint.
BrowserExtensionResults
¶
BrowserExtensionResults(
endpoint: BaseEndpoint,
params: dict[str, str],
*,
path: str | None = None,
single: bool = False,
files: bool = False,
method: str = "GET",
request_kwargs: dict[str, Any] | None = None,
use_concurrent_skip_pagination: bool | None = None,
skip_page_size: int | None = None,
skip_max_concurrent: int | None = None,
)
Results from the /api/machines/BrowserExtensionsInventoryByMachine endpoint.
BrowserExtensionsPermissionsInfoResults
¶
BrowserExtensionsPermissionsInfoResults(
endpoint: BaseEndpoint,
params: dict[str, str],
*,
path: str | None = None,
single: bool = False,
files: bool = False,
method: str = "GET",
request_kwargs: dict[str, Any] | None = None,
use_concurrent_skip_pagination: bool | None = None,
skip_page_size: int | None = None,
skip_max_concurrent: int | None = None,
)
Results from the /api/browserExtensions/permissionsinfo endpoint.
BrowserExtensionEndpoint
¶
BrowserExtensionEndpoint(http: Client, auth: MSALAuth)
Client for browser extension inventory endpoints.
get_all
¶
get_all() -> BrowserExtensionResults
Get All Browser Extensions for a machine.
Docs: - https://learn.microsoft.com/en-us/defender-endpoint/api/get-assessment-browser-extensions - https://learn.microsoft.com/en-us/defender-endpoint/api/get-assessment-browser-extensions#1-export-browser-extensions-assessment-json-response
get_all_files
¶
get_all_files() -> BrowserExtensionResults
Get All Browser Extensions for a machine.
Same Results as get_all but exported as a file instead of in the response body.
Recommended for larger data sets, as it returns zipped files with the data instead of returning it in the response body.
Docs: - https://learn.microsoft.com/en-us/defender-endpoint/api/get-assessment-browser-extensions - https://learn.microsoft.com/en-us/defender-endpoint/api/get-assessment-browser-extensions#2-export-browser-extension-assessment-via-files
permissionsinfo
¶
permissionsinfo(
query: BrowserExtensionsPermissionsInfoQuery
| None = None,
) -> BrowserExtensionsPermissionsInfoResults
Get permissions info for browser extensions.
Docs: - https://learn.microsoft.com/en-us/defender-endpoint/api/get-browser-extensions-permission-info