MSDATP: merge Note into find-machines-by-ip.md

Description:

As discussed in issue ticket #5400 (included page "Improve request
performance" title format & placement), I propose to merge the single
Note stub from the file 'improve-request-performance.md' into the file
'find-machines-by-ip.md' and remove the linked include file.

I have also added a few formatting improvements like MD quote indent
marker compatibility spacing as well as replacing tabs with 4 spaces in
the response code block and finally replacing tabs with single spaces
in the Permissions table.

Proposed changes:
- move the MD Note down to directly after the request code block
- replace the include link with the actual file content
- change the MD heading format from H1 title size to H2 section heading
- remove the include source file (redundant after including the Note)
- replace all tabs with 4 spaces, for Github source view compatibility
- reduce 4 spaces to single spaces in the Permissions table
- add MD quote indent marker compatibility spacing to another Note

issue ticket closure or reference:

Closes #5400
This commit is contained in:
illfated
2019-11-12 01:41:37 +01:00
parent 01e588d16a
commit 85b5baaf51
2 changed files with 30 additions and 50 deletions

View File

@ -36,10 +36,10 @@ Application | Machine.ReadWrite.All | 'Read and write all machine information'
Delegated (work or school account) | Machine.Read | 'Read machine information' Delegated (work or school account) | Machine.Read | 'Read machine information'
Delegated (work or school account) | Machine.ReadWrite | 'Read and write machine information' Delegated (work or school account) | Machine.ReadWrite | 'Read and write machine information'
>[!Note] > [!Note]
> When obtaining a token using user credentials: > When obtaining a token using user credentials:
>- The user needs to have at least the following role permission: 'View Data' (See [Create and manage roles](user-roles.md) for more information) > - The user needs to have at least the following role permission: 'View Data' (See [Create and manage roles](user-roles.md) for more information)
>- Response will include only machines,that the user have access to, based on machine group settings (See [Create and manage machine groups](machine-groups.md) for more information) > - Response will include only machines,that the user have access to, based on machine group settings (See [Create and manage machine groups](machine-groups.md) for more information)
## HTTP request ## HTTP request
``` ```
@ -66,12 +66,18 @@ If the timestamp is not in the past 30 days - 400 Bad Request.
Here is an example of the request. Here is an example of the request.
[!include[Improve request performance](improve-request-performance.md)]
``` ```
GET https://api.securitycenter.windows.com/api/machines/findbyip(ip='10.248.240.38',timestamp=2018-09-22T08:44:05Z) GET https://api.securitycenter.windows.com/api/machines/findbyip(ip='10.248.240.38',timestamp=2018-09-22T08:44:05Z)
``` ```
## Improve request performance
> [!NOTE]
> You can use a server closer to your geolocation for better performance :
> - api-us.securitycenter.windows.com
> - api-eu.securitycenter.windows.com
> - api-uk.securitycenter.windows.com
**Response** **Response**
Here is an example of the response. Here is an example of the response.

View File

@ -1,26 +0,0 @@
---
title: Improve request performance
description: Improve request performance
keywords: server, request, performance
search.product: eADQiWindows 10XVcnh
ms.prod: w10
ms.mktglfcycl: deploy
ms.sitesec: library
ms.pagetype: security
ms.author: macapara
author: mjcaparas
ms.localizationpriority: medium
manager: dansimp
audience: ITPro
ms.collection: M365-security-compliance
ms.topic: article
---
# Improve request performance
>[!NOTE]
>For better performance, you can use server closer to your geo location:
> - api-us.securitycenter.windows.com
> - api-eu.securitycenter.windows.com
> - api-uk.securitycenter.windows.com