mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-05-15 14:57:23 +00:00
1
This commit is contained in:
parent
ccef4b1c78
commit
b7ac564fd7
@ -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
|
||||||
```
|
```
|
@ -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)
|
||||||
|
@ -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**
|
||||||
|
@ -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**
|
||||||
|
@ -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**
|
||||||
|
@ -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
|
||||||
|
|
||||||
|
@ -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)
|
||||||
|
|
||||||
|
@ -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)
|
||||||
|
Loading…
x
Reference in New Issue
Block a user