Skip to content

Commit 760047c

Browse files
committed
acrolinx fixes
1 parent 724e837 commit 760047c

File tree

4 files changed

+48
-48
lines changed

4 files changed

+48
-48
lines changed

defender-endpoint/api/get-assessment-browser-extensions.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Different API calls get different types of data. Because the amount of data can
3939

4040
- [Export browser extensions assessment **JSON response**](#1-export-browser-extensions-assessment-json-response) The API pulls all data in your organization as Json responses. This method is best for _small organizations with less than 100-K devices_. The response is paginated, so you can use the \@odata.nextLink field from the response to fetch the next results.
4141

42-
- [Export browser extensions assessment **via files**](#2-export-browser-extension-assessment-via-files) This API solution enables pulling larger amounts of data faster and more reliably. So, it's recommended for large organizations, with more than 100-K devices. This API pulls all data in your organization as download files. The response contains URLs to download all the data from Azure Storage. This API enables you to download all your data from Azure Storage as follows:
42+
- [Export browser extensions assessment **via files**](#2-export-browser-extension-assessment-via-files) This API solution enables pulling larger amounts of data faster and more reliably. This is recommended for large organizations with more than 100-K devices. This API pulls all data in your organization as download files. The response contains URLs to download all the data from Azure Storage. This API enables you to download all your data from Azure Storage as follows:
4343
- Call the API to get a list of download URLs with all your organization data.
4444
- Download all the files using the download URLs and process the data as you like.
4545

@@ -57,7 +57,7 @@ This API response contains all the data for installed browser extensions per dev
5757
#### 1.1.1 Limitations
5858

5959
- Maximum page size is 200,000.
60-
- Rate limitations for this API are 30 calls per minute and 1000 calls per hour.
60+
- Rate limitations for this API are 30 calls per minute and 1,000 calls per hour.
6161

6262
### 1.2 Permissions
6363

@@ -83,11 +83,11 @@ GET /api/Machines/BrowserExtensionsInventoryByMachine
8383

8484
> [!NOTE]
8585
>
86-
> - Each record is approximately 0.5KB of data. You should take this into account when choosing the correct pageSize parameter for you.
87-
> - The properties defined in the following table are listed alphabetically, by property ID. When running this API, the resulting output will not necessarily be returned in the same order listed in this table.
88-
> - Some additional columns might be returned in the response. These columns are temporary and might be removed, please use only the documented columns.
86+
> - Each record is 0.5KB of data. You should take this size into account when choosing the correct pageSize parameter for you.
87+
> - The properties defined in the following table are listed alphabetically, by property ID. When running this API, the resulting output isn't necessarily returned in the same order listed in this table.
88+
> - Some other columns might be returned in the response. These columns are temporary and might be removed so use only the documented columns.
8989
90-
<br>
90+
</br>
9191

9292
****
9393

@@ -103,7 +103,7 @@ ExtensionRisk|string|The highest risk level generated by the browser extension.
103103
ExtensionVersion|string|Version number of a specific browser extension.
104104
IsActivated|Boolean|Indicates whether a browser extension is active.
105105
RbacGroupId|integer|The role-based access control (RBAC) group ID.
106-
RbacGroupName|string|The role-based access control (RBAC) group. If this device is not assigned to any RBAC group, the value will be "Unassigned." If the organization doesn't contain any RBAC groups, the value will be "None."
106+
RbacGroupName|string|The role-based access control (RBAC) group. If this device is not assigned to any RBAC group, the value is "Unassigned." If the organization doesn't contain any RBAC groups, the value is "None."
107107
InstallationTime|string|The time the browser extension was installed.
108108
Permissions|Array[string]|The set of permissions requested by a specific browser extension.
109109

@@ -188,7 +188,7 @@ GET /api/machines/browserextensionsinventoryExport
188188
>
189189
> - The files are gzip compressed & in multiline JSON format.
190190
> - The download URLs are only valid for 1 hour.
191-
> - For maximum download speed of your data, you can make sure you are downloading from the same Azure region that your data resides.
191+
> - For maximum download speed of your data, you can make sure you're downloading from the same Azure region that your data resides.
192192
193193
<br>
194194

defender-endpoint/api/get-assessment-non-cpe-software-inventory.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -31,16 +31,16 @@ ms.date: 01/08/2025
3131

3232
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
3333
34-
This API returns all the data for installed software that doesn't have a [Common Platform Enumeration(CPE)](https://nvd.nist.gov/products/cpe), on a per-device basis. The information returned by this API, along with the information returned by the [Export software inventory assessment](get-assessment-non-cpe-software-inventory.md) API, for software that does have a CPE, gives you full visibility into the software installed across your organization and the devices it's installed on.
34+
This API returns all the data for installed software that doesn't have a [Common Platform Enumeration(CPE)](https://nvd.nist.gov/products/cpe), on a per-device basis. The information returned by this API, along with the information returned by the [Export software inventory assessment](get-assessment-non-cpe-software-inventory.md) API, for software that does have a CPE gives you full visibility into the software installed across your organization and the devices it's installed on.
3535

3636
> [!NOTE]
37-
> Software products without a CPE are not supported by vulnerability management. They will be shown in the software inventory page, but because CPEs are used by vulnerability management to identify the software and any vulnerabilities, information like, exploits, number of exposed devices, and weaknesses won't be available for them. For more information, see [Software inventory](/defender-vulnerability-management/tvm-software-inventory).
37+
> Vulnerability management doesn't support software products without a CPE. While these products are shown in the software inventory page, but because CPEs are used by vulnerability management to identify the software and any vulnerabilities, information like exploits, number of exposed devices, and weaknesses aren't available. For more information, see [Software inventory](/defender-vulnerability-management/tvm-software-inventory).
3838
3939
Different API calls get different types of data. Because the amount of data can be large, there are two ways it can be retrieved:
4040

4141
- [Export non product code software inventory assessment **JSON response**](#1-export-non-product-code-software-inventory-assessment-json-response) The API pulls all data in your organization as Json responses. This method is best for _small organizations with less than 100-K devices_. The response is paginated, so you can use the \@odata.nextLink field from the response to fetch the next results.
4242

43-
- [Export non product code software inventory assessment **via files**](#2-export-non-product-code-software-inventory-assessment-via-files) This API solution enables pulling larger amounts of data faster and more reliably. So, it's recommended for large organizations, with more than 100-K devices. This API pulls all data in your organization as download files. The response contains URLs to download all the data from Azure Storage. This API enables you to download all your data from Azure Storage as follows:
43+
- [Export non product code software inventory assessment **via files**](#2-export-non-product-code-software-inventory-assessment-via-files) This API solution enables pulling larger amounts of data faster and more reliably and is recommended for large organizations with more than 100-K devices. This API pulls all data in your organization as download files. The response contains URLs to download all the data from Azure Storage. This API enables you to download all your data from Azure Storage as follows:
4444
- Call the API to get a list of download URLs with all your organization data.
4545
- Download all the files using the download URLs and process the data as you like.
4646

@@ -58,7 +58,7 @@ This API response contains all the data of installed software that does not have
5858
#### Limitations
5959

6060
- Maximum page size is 200,000.
61-
- Rate limitations for this API are 30 calls per minute and 1000 calls per hour.
61+
- Rate limitations for this API are 30 calls per minute and 1,000 calls per hour.
6262

6363
### 1.2 Permissions
6464

@@ -84,18 +84,18 @@ GET /api/machines/SoftwareInventoryNoProductCodeByMachine
8484

8585
> [!NOTE]
8686
>
87-
> - Each record is approximately 0.5KB of data. You should take this into account when choosing the correct pageSize parameter for you.
88-
> - The properties defined in the following table are listed alphabetically, by property ID. When running this API, the resulting output will not necessarily be returned in the same order listed in this table.
89-
> - Some additional columns might be returned in the response. These columns are temporary and might be removed, please use only the documented columns.
87+
> - Each record is 0.5KB of data. You should take this size into account when choosing the correct pageSize parameter for you.
88+
> - The properties defined in the following table are listed alphabetically, by property ID. When running this API, the resulting output isn't necessarily returned in the same order listed in this table.
89+
> - Some other columns might be returned in the response. These columns are temporary and might be removed so use only the documented columns.
9090
91-
<br>
91+
</br>
9292

9393
Property (ID)|Data type|Description
9494
:---|:---|:---
9595
DeviceId|string|Unique identifier for the device in the service.
9696
DeviceName|string|Fully qualified domain name (FQDN) of the device.
97-
OSPlatform|string|Platform of the operating system running on the device. These are specific operating systems with variations within the same family, such as Windows 10 and Windows 11. See [Supported operating systems, platforms and capabilities](/defender-vulnerability-management/tvm-supported-os) for details.
98-
RbacGroupName|string|The role-based access control (RBAC) group. If this device is not assigned to any RBAC group, the value will be "Unassigned." If the organization doesn't contain any RBAC groups, the value will be "None."
97+
OSPlatform|string|Platform of the operating system running on the device. These are specific operating systems with variations within the same family, such as Windows 10 and Windows 11. See [Supported operating systems, platforms, and capabilities](/defender-vulnerability-management/tvm-supported-os) for details.
98+
RbacGroupName|string|The role-based access control (RBAC) group. If this device isn't assigned to any RBAC group, the value is "Unassigned." If the organization doesn't contain any RBAC groups, the value is "None."
9999
RbacGroupId|string|The role-based access control (RBAC) group ID.
100100
SoftwareLastSeenTimestamp|string|The last time this software was seen on the device.
101101
SoftwareName|string|Name of the software product.
@@ -159,7 +159,7 @@ https://api.securitycenter.microsoft.com/api/machines/SoftwareInventoryNoProduct
159159

160160
### 2.1 API method description
161161

162-
This API response contains all the data of installed software that does not have a [Common Platform Enumeration(CPE)](https://nvd.nist.gov/products/cpe) per device. Returns a table with an entry for every unique combination of DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion.
162+
This API response contains all the data of installed software that doesn't have a [Common Platform Enumeration(CPE)](https://nvd.nist.gov/products/cpe) per device. Returns a table with an entry for every unique combination of DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion.
163163

164164
#### 2.1.1 Limitations
165165

@@ -186,7 +186,7 @@ GET /api/machines/SoftwareInventoryNonCpeExport
186186
>
187187
> - The files are gzip compressed & in multiline JSON format.
188188
> - The download URLs are only valid for 1 hour.
189-
> - For maximum download speed of your data, you can make sure you are downloading from the same Azure region that your data resides.
189+
> - For maximum download speed of your data, you can make sure you're downloading from the same Azure region that your data resides.
190190
191191
<br>
192192

defender-endpoint/api/get-assessment-software-inventory.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Different API calls get different types of data. Because the amount of data can
3737

3838
- [Export software inventory assessment **JSON response**](#1-export-software-inventory-assessment-json-response) The API pulls all data in your organization as Json responses. This method is best for _small organizations with less than 100-K devices_. The response is paginated, so you can use the \@odata.nextLink field from the response to fetch the next results.
3939

40-
- [Export software inventory assessment **via files**](#2-export-software-inventory-assessment-via-files) This API solution enables pulling larger amounts of data faster and more reliably. So, it's recommended for large organizations, with more than 100-K devices. This API pulls all data in your organization as download files. The response contains URLs to download all the data from Azure Storage. This API enables you to download all your data from Azure Storage as follows:
40+
- [Export software inventory assessment **via files**](#2-export-software-inventory-assessment-via-files) This API solution enables pulling larger amounts of data faster and more reliably, and is recommended for large organizations with more than 100-K devices. This API pulls all data in your organization as download files. The response contains URLs to download all the data from Azure Storage. This API enables you to download all your data from Azure Storage as follows:
4141
- Call the API to get a list of download URLs with all your organization data.
4242
- Download all the files using the download URLs and process the data as you like.
4343

@@ -55,7 +55,7 @@ This API response contains all the data of installed software that has a [Common
5555
#### 1.1.1 Limitations
5656

5757
- Maximum page size is 200,000.
58-
- Rate limitations for this API are 30 calls per minute and 1000 calls per hour.
58+
- Rate limitations for this API are 30 calls per minute and 1,000 calls per hour.
5959

6060
### 1.2 Permissions
6161

@@ -81,11 +81,11 @@ GET /api/machines/SoftwareInventoryByMachine
8181

8282
> [!NOTE]
8383
>
84-
> - Each record is approximately 0.5KB of data. You should take this into account when choosing the correct pageSize parameter for you.
85-
> - The properties defined in the following table are listed alphabetically, by property ID. When running this API, the resulting output will not necessarily be returned in the same order listed in this table.
86-
> - Some additional columns might be returned in the response. These columns are temporary and might be removed, please use only the documented columns.
84+
> - Each record is 0.5KB of data. You should take this size into account when choosing the correct pageSize parameter for you.
85+
> - The properties defined in the following table are listed alphabetically, by property ID. When running this API, the resulting output isn't necessarily returned in the same order listed in this table.
86+
> - Some other columns might be returned in the response. These columns are temporary and might be removed so use only the documented columns.
8787
88-
<br>
88+
</br>
8989

9090
****
9191

@@ -94,11 +94,11 @@ Property (ID)|Data type|Description|Example of a returned value
9494
DeviceId|string|Unique identifier for the device in the service.|9eaf3a8b5962e0e6b1af9ec756664a9b823df2d1
9595
DeviceName|string|Fully qualified domain name (FQDN) of the device.|johnlaptop.europe.contoso.com
9696
DiskPaths|Array[string]|Disk evidence that the product is installed on the device.|["C:\\Program Files (x86)\\Microsoft\\Silverlight\\Application\\silverlight.exe"]
97-
EndOfSupportDate|string|The date in which support for this software has or will end.|2020-12-30
97+
EndOfSupportDate|string|The date in which support for this software has or when support ends.|2020-12-30
9898
EndOfSupportStatus|string|End of support status. Can contain these possible values: None, EOS Version, Upcoming EOS Version, EOS Software, Upcoming EOS Software.|Upcoming EOS
9999
NumberOfWeaknesses|int|Number of weaknesses on this software on this device|3
100100
OSPlatform|string|Platform of the operating system running on the device. These are specific operating systems with variations within the same family, such as Windows 10 and Windows 11. See Microsoft Defender Vulnerability Management supported operating systems and platforms for details.|Windows10 and Windows 11
101-
RbacGroupName|string|The role-based access control (RBAC) group. If this device is not assigned to any RBAC group, the value will be "Unassigned." If the organization doesn't contain any RBAC groups, the value will be "None."|Servers
101+
RbacGroupName|string|The role-based access control (RBAC) group. If this device isn't assigned to any RBAC group, the value is "Unassigned." If the organization doesn't contain any RBAC groups, the value is "None."|Servers
102102
RegistryPaths|Array[string]|Registry evidence that the product is installed in the device.|["HKEY_LOCAL_MACHINE\\SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Microsoft Silverlight"]
103103
SoftwareFirstSeenTimestamp|string|The first time this software was seen on the device.|2019-04-07 02:06:47
104104
SoftwareName|string|Name of the software product.|Silverlight
@@ -209,7 +209,7 @@ GET https://api.securitycenter.microsoft.com/api/machines/SoftwareInventoryByMac
209209
```
210210

211211
> [!NOTE]
212-
> The information returned by this API, along with the information returned by the [Export non product code software inventory assessment](get-assessment-non-cpe-software-inventory.md) API, for software that doesn't have a CPE, gives you full visibility into the software installed across your organization and the devices it's installed on.
212+
> The information returned by this API, along with the information returned by the [Export non product code software inventory assessment](get-assessment-non-cpe-software-inventory.md) API for software that doesn't have a CPE, gives you full visibility into the software installed across your organization and the devices it's installed on.
213213
214214
## 2. Export software inventory assessment (via files)
215215

@@ -242,7 +242,7 @@ GET /api/machines/SoftwareInventoryExport
242242
>
243243
> - The files are gzip compressed & in multiline JSON format.
244244
> - The download URLs are only valid for 1 hour.
245-
> - For maximum download speed of your data, you can make sure you are downloading from the same Azure region that your data resides.
245+
> - For maximum download speed of your data, you can make sure you're downloading from the same Azure region that your data resides.
246246
247247
<br>
248248

0 commit comments

Comments
 (0)