This commit is contained in:
Ben Alfasi 2021-01-24 14:30:32 +02:00
parent ccef4b1c78
commit b7ac564fd7
8 changed files with 42 additions and 8 deletions

View File

@ -32,7 +32,7 @@ ms.topic: article
## API description ## API description
Find [Machines](machine.md) by [Tag](machine-tags.md). Find [Machines](machine.md) by [Tag](machine-tags.md).
<br>```startswith``` query is supported.
## Limitations ## Limitations
1. Rate limitations for this API are 100 calls per minute and 1500 calls per hour. 1. Rate limitations for this API are 100 calls per minute and 1500 calls per hour.
@ -56,7 +56,7 @@ Delegated (work or school account) | Machine.ReadWrite | 'Read and write machine
## HTTP request ## HTTP request
``` ```
GET /api/machines/findbytag(tag='{tag}') GET /api/machines/findbytag?tag={tag}&useStartsWithFilter={true/false}
``` ```
## Request headers ## Request headers
@ -65,6 +65,13 @@ Name | Type | Description
:---|:---|:--- :---|:---|:---
Authorization | String | Bearer {token}. **Required**. Authorization | String | Bearer {token}. **Required**.
## Request URI parameters
Name | Type | Description
:---|:---|:---
tag | String | The tag name. **Required**.
useStartsWithFilter | Boolean | When set to true, the search will find all devices with tag name that starts with the given tag in the query. Defaults to false. **Optional**.
## Request body ## Request body
Empty Empty
@ -78,5 +85,5 @@ If successful - 200 OK with list of the machines in the response body.
Here is an example of the request. Here is an example of the request.
``` ```
GET https://api.securitycenter.microsoft.com/api/machines/findbytag(tag='testTag') GET https://api.securitycenter.microsoft.com/api/machines/findbytag?tag=testTag&useStartsWithFilter=true
``` ```

View File

@ -30,8 +30,12 @@ ms.technology: mde
[!include[Improve request performance](../../includes/improve-request-performance.md)] [!include[Improve request performance](../../includes/improve-request-performance.md)]
## API description
Retrieves a collection of discovered vulnerabilities related to a given device ID. Retrieves a collection of discovered vulnerabilities related to a given device ID.
## Limitations
1. Rate limitations for this API are 50 calls per minute and 1500 calls per hour.
## Permissions ## Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Use Microsoft Defender for Endpoint APIs](apis-intro.md) One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Use Microsoft Defender for Endpoint APIs](apis-intro.md)

View File

@ -62,6 +62,11 @@ Header | Value
:---|:--- :---|:---
Authorization | Bearer {token}. **Required**. Authorization | Bearer {token}. **Required**.
## Request URI parameters
Name | Type | Description
:---|:---|:---
lookBackHours | Int32 | Defines the hours we search back to get the statistics. Defaults to 30 days. **Optional**.
## Request body ## Request body
Empty Empty
@ -77,7 +82,7 @@ If successful and domain exists - 200 OK, with statistics object in the response
Here is an example of the request. Here is an example of the request.
``` ```
GET https://api.securitycenter.microsoft.com/api/domains/example.com/stats GET https://api.securitycenter.microsoft.com/api/domains/example.com/stats?lookBackHours=48
``` ```
**Response** **Response**

View File

@ -62,6 +62,11 @@ Name | Type | Description
:---|:---|:--- :---|:---|:---
Authorization | String | Bearer {token}. **Required**. Authorization | String | Bearer {token}. **Required**.
## Request URI parameters
Name | Type | Description
:---|:---|:---
lookBackHours | Int32 | Defines the hours we search back to get the statistics. Defaults to 30 days. **Optional**.
## Request body ## Request body
Empty Empty
@ -77,7 +82,7 @@ If successful and file exists - 200 OK with statistical data in the body. If fil
Here is an example of the request. Here is an example of the request.
``` ```
GET https://api.securitycenter.microsoft.com/api/files/0991a395da64e1c5fbe8732ed11e6be064081d9f/stats GET https://api.securitycenter.microsoft.com/api/files/0991a395da64e1c5fbe8732ed11e6be064081d9f/stats?lookBackHours=48
``` ```
**Response** **Response**

View File

@ -63,6 +63,11 @@ Name | Type | Description
:---|:---|:--- :---|:---|:---
Authorization | String | Bearer {token}. **Required**. Authorization | String | Bearer {token}. **Required**.
## Request URI parameters
Name | Type | Description
:---|:---|:---
lookBackHours | Int32 | Defines the hours we search back to get the statistics. Defaults to 30 days. **Optional**.
## Request body ## Request body
Empty Empty
@ -78,7 +83,7 @@ If successful and ip exists - 200 OK with statistical data in the body. IP do no
Here is an example of the request. Here is an example of the request.
```http ```http
GET https://api.securitycenter.microsoft.com/api/ips/10.209.67.177/stats GET https://api.securitycenter.microsoft.com/api/ips/10.209.67.177/stats?lookBackHours=48
``` ```
**Response** **Response**

View File

@ -30,7 +30,11 @@ ms.technology: mde
[!include[Improve request performance](../../includes/improve-request-performance.md)] [!include[Improve request performance](../../includes/improve-request-performance.md)]
Retrieves missing KBs (security updates) by device ID ## API description
Retrieves missing KBs (security updates) by device ID.
## Limitations
1. Rate limitations for this API are 50 calls per minute and 1500 calls per hour.
## HTTP request ## HTTP request

View File

@ -31,8 +31,12 @@ ms.technology: mde
[!include[Prerelease information](../../includes/prerelease.md)] [!include[Prerelease information](../../includes/prerelease.md)]
## API description
Retrieves a collection of security recommendations related to a given device ID. Retrieves a collection of security recommendations related to a given device ID.
## Limitations
1. Rate limitations for this API are 50 calls per minute and 1500 calls per hour.
## Permissions ## Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Use Microsoft Defender for Endpoint APIs](apis-intro.md) One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Use Microsoft Defender for Endpoint APIs](apis-intro.md)

View File

@ -37,7 +37,7 @@ Submits or Updates batch of [Indicator](ti-indicator.md) entities.
## Limitations ## Limitations
1. Rate limitations for this API are 30 calls per minute. 1. Rate limitations for this API are 30 calls per minute.
2. There is a limit of 15,000 active [Indicators](ti-indicator.md) per tenant. 2. There is a limit of 15,000 active [Indicators](ti-indicator.md) per tenant.
3. Maximum batch size for one API call is 500.
## Permissions ## Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Get started](apis-intro.md) One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Get started](apis-intro.md)