Машина обновленияUpdate machine

Область применения:Applies to:

Хотите испытать Microsoft Defender для конечной точки?Want to experience Microsoft Defender for Endpoint? Зарегистрився для бесплатной пробной.Sign up for a free trial.

Примечание

Если вы клиент правительства США, используйте URL-адреса, указанные в Microsoft Defender для конечных точек для государственных клиентов США.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Совет

Для улучшения производительности можно использовать сервер ближе к географическому расположению:For better performance, you can use server closer to your geo location:

  • api-us.securitycenter.microsoft.comapi-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.comapi-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.comapi-uk.securitycenter.microsoft.com

Описание APIAPI description

Обновляет свойства существующей машины.Updates properties of existing Machine.
Updatable свойства: machineTags и deviceValue .Updatable properties are: machineTags and deviceValue.

ОграниченияLimitations

  1. Можно обновить машины, доступные в API.You can update machines that are available in the API.
  2. Машина обновления только привносят теги в коллекцию тегов.Update machine only appends tags to the tag collection. Если теги существуют, они должны быть включены в коллекцию тегов в теле.If tags exist, they must be included in the tags collection in the body.
  3. Ограничения скорости для этого API : 100 вызовов в минуту и 1500 вызовов в час.Rate limitations for this API are 100 calls per minute and 1500 calls per hour.

РазрешенияPermissions

Для вызова этого API требуется одно из следующих разрешений.One of the following permissions is required to call this API. Дополнительные дополнительные информации, в том числе о выборе разрешений, см. в этой ссылке: Использование API endpoint Defender для Microsoft DefenderTo learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs

Тип разрешенияPermission type РазрешениеPermission Имя отображения разрешенийPermission display name
Для приложенияApplication Machine.ReadWrite.AllMachine.ReadWrite.All 'Read and write machine information for all machines''Read and write machine information for all machines'
Делегированные (рабочая или учебная учетная запись)Delegated (work or school account) Machine.ReadWriteMachine.ReadWrite 'Read and write machine information''Read and write machine information'

Примечание

При получении маркера с помощью учетных данных пользователей:When obtaining a token using user credentials:

HTTP-запросHTTP request

PATCH /api/machines/{machineId}

Заголовки запросовRequest headers

ИмяName ТипType ОписаниеDescription
AuthorizationAuthorization StringString Bearer {token}.Bearer {token}. Обязательное поле.Required.
Content-TypeContent-Type StringString application/json.application/json. Обязательное поле.Required.

Текст запросаRequest body

В теле запроса укажи значения для соответствующих полей, которые должны быть обновлены.In the request body, supply the values for the relevant fields that should be updated.
Предыдущие значения существующих свойств, не включенных в текст запроса, будут сохранены или вычислены повторно с учетом изменений, внесенных в значения других свойств.Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values.
Для лучшей производительности не следует включать существующие значения, которые не изменились.For best performance, you shouldn't include existing values that haven't change.

СвойствоProperty ТипType ОписаниеDescription
machineTagsmachineTags Коллекция объектов stringString collection Набор тегов машин.Set of machine tags.
deviceValuedeviceValue Nullable EnumNullable Enum Значение устройства.The value of the device. Возможные значения: "Нормальный", "Низкий" и "Высокий".Possible values are: 'Normal', 'Low' and 'High'.

ОткликResponse

В случае успешной работы этот метод возвращает 200 ОК, а объект машины в теле ответа с обновленными свойствами.If successful, this method returns 200 OK, and the machine entity in the response body with the updated properties. Если коллекция тегов машин в теле не содержит существующие теги машин - 400 Недействительный вход и сообщение, информирующие о отсутствующих тегах/s.If machine tags collection in body doesn't contain existing machine tags - 400 Invalid Input and a message informing of the missing tag/s. Если машина с указанным ИД не найдена - 404 Не найдено.If machine with the specified ID was not found - 404 Not Found.

ПримерExample

ЗапросRequest

Вот пример запроса.Here's an example of the request.

PATCH https://api.securitycenter.microsoft.com/api/machines/{machineId}
{
    "deviceValue": "Normal",
    "machineTags": [
                     "Demo Device",
                     "Generic User Machine - Attack Source",
                     "Windows 10",
                     "Windows Insider - Fast"
    ]
}