Поделиться через


Automations - Update

Обновляет автоматизацию безопасности

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/automations/{automationName}?api-version=2023-12-01-preview

Параметры URI

Имя В Обязательно Тип Описание
automationName
path True

string

Имя службы автоматизации безопасности.

resourceGroupName
path True

string

Имя группы ресурсов в подписке пользователя. Имя не учитывает регистр.

Шаблон регулярного выражения: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Идентификатор подписки Azure

Шаблон регулярного выражения: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

Версия API для операции

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

Имя Тип Описание
properties.actions AutomationAction[]:

Коллекция действий, которые активируются, если все настроенные оценки правил в пределах по крайней мере одного набора правил имеют значение true.

properties.description

string

Описание службы автоматизации безопасности.

properties.isEnabled

boolean

Указывает, включена ли автоматизация безопасности.

properties.scopes

AutomationScope[]

Коллекция областей, к которым применяется логика автоматизации безопасности. Поддерживаемые области — это сама подписка или группа ресурсов в этой подписке. Автоматизация будет применяться только к определенным областям.

properties.sources

AutomationSource[]

Коллекция типов исходных событий, которые оценивают набор правил автоматизации безопасности.

tags

object

Список пар значений ключей, описывающих ресурс.

Ответы

Имя Тип Описание
200 OK

Automation

ХОРОШО

Other Status Codes

CloudError

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

Update a security automation

Образец запроса

PATCH https://management.azure.com/subscriptions/a5caac9c-5c04-49af-b3d0-e204f40345d5/resourceGroups/exampleResourceGroup/providers/Microsoft.Security/automations/exampleAutomation?api-version=2023-12-01-preview

{
  "tags": {
    "Example": "exampleTag"
  },
  "properties": {
    "description": "An example of a security automation that triggers one LogicApp resource (myTest1) on any security assessment",
    "scopes": [
      {
        "description": "A description that helps to identify this scope - for example: security assessments that relate to the resource group myResourceGroup within the subscription a5caac9c-5c04-49af-b3d0-e204f40345d5",
        "scopePath": "/subscriptions/a5caac9c-5c04-49af-b3d0-e204f40345d5/resourceGroups/myResourceGroup"
      }
    ],
    "sources": [
      {
        "eventSource": "Assessments"
      }
    ],
    "actions": [
      {
        "logicAppResourceId": "/subscriptions/e54a4a18-5b94-4f90-9471-bd3decad8a2e/resourceGroups/sample/providers/Microsoft.Logic/workflows/MyTest1",
        "actionType": "LogicApp",
        "uri": "https://exampleTriggerUri1.com"
      }
    ]
  }
}

Пример ответа

{
  "id": "/subscriptions/a5caac9c-5c04-49af-b3d0-e204f40345d5/resourceGroups/exampleResourceGroup/providers/Microsoft.Security/automations/exampleAutomation",
  "name": "exampleAutomation",
  "type": "Microsoft.Security/automations",
  "location": "Central US",
  "etag": "new etag value",
  "tags": {},
  "properties": {
    "description": "An example of a security automation that triggers one LogicApp resource (myTest1) on any security assessment",
    "isEnabled": true,
    "scopes": [
      {
        "description": "A description that helps to identify this scope - for example: security assessments that relate to the resource group myResourceGroup within the subscription a5caac9c-5c04-49af-b3d0-e204f40345d5",
        "scopePath": "/subscriptions/a5caac9c-5c04-49af-b3d0-e204f40345d5/resourceGroups/myResourceGroup"
      }
    ],
    "sources": [
      {
        "eventSource": "Assessments",
        "ruleSets": []
      }
    ],
    "actions": [
      {
        "logicAppResourceId": "/subscriptions/e54a4a18-5b94-4f90-9471-bd3decad8a2e/resourceGroups/sample/providers/Microsoft.Logic/workflows/MyTest1",
        "actionType": "LogicApp"
      }
    ]
  }
}

Определения

Имя Описание
Automation

Ресурс автоматизации безопасности.

AutomationActionEventHub

Целевой концентратор событий, в который будут экспортированы данные события. Дополнительные сведения о возможностях непрерывного экспорта в Microsoft Defender для облака см. в https://aka.ms/ASCExportLearnMore

AutomationActionLogicApp

Действие приложения логики, которое должно быть активировано. Дополнительные сведения о возможностях автоматизации рабочих процессов Microsoft Defender для Облака см. в https://aka.ms/ASCWorkflowAutomationLearnMore

AutomationActionWorkspace

Рабочая область Log Analytics, в которую будут экспортироваться данные события. Данные оповещений системы безопасности будут находиться в таблице SecurityAlert, а данные оценки будут находиться в таблице SecurityRecommendation (в соответствии с решениями Security/SecurityCenterFree). Обратите внимание, что для просмотра данных в рабочей области необходимо включить бесплатное или стандартное решение Центра безопасности Log Analytics. Дополнительные сведения о возможностях непрерывного экспорта в Microsoft Defender для облака см. в https://aka.ms/ASCExportLearnMore

AutomationRuleSet

Набор правил, который оценивает все его правила при перехвате событий. Только если все включенные правила в наборе правил будут оцениваться как true, событие активирует определенные действия.

AutomationScope

Одна область автоматизации.

AutomationSource

Исходные типы событий, которые оценивают набор правил автоматизации безопасности. Например, оповещения системы безопасности и оценки безопасности. Дополнительные сведения о поддерживаемых схемах моделей данных о событиях безопасности см. в https://aka.ms/ASCAutomationSchemas.

AutomationTriggeringRule

Правило, которое вычисляется при перехвате событий. Правило настраивается путем сравнения определенного значения из модели событий с ожидаемым значением. Это сравнение выполняется с помощью одного из поддерживаемых наборов операторов.

AutomationUpdateModel

Модель обновления ресурса автоматизации безопасности.

CloudError

Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).

CloudErrorBody

Сведения об ошибке.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

EventSource

Допустимый тип источника события.

Operator

Допустимый оператор сравнения для использования. Для String PropertyType будет применено сравнение без учета регистра.

PropertyType

Тип данных сравниваемых операндов (строка, целое число, число с плавающей запятой или логическое значение [true/false]]

Automation

Ресурс автоматизации безопасности.

Имя Тип Описание
etag

string

Тег сущности используется для сравнения двух или нескольких сущностей из одного запрошенного ресурса.

id

string

Идентификатор ресурса

kind

string

Тип ресурса

location

string

Расположение, в котором хранится ресурс

name

string

Имя ресурса

properties.actions AutomationAction[]:

Коллекция действий, которые активируются, если все настроенные оценки правил в пределах по крайней мере одного набора правил имеют значение true.

properties.description

string

Описание службы автоматизации безопасности.

properties.isEnabled

boolean

Указывает, включена ли автоматизация безопасности.

properties.scopes

AutomationScope[]

Коллекция областей, к которым применяется логика автоматизации безопасности. Поддерживаемые области — это сама подписка или группа ресурсов в этой подписке. Автоматизация будет применяться только к определенным областям.

properties.sources

AutomationSource[]

Коллекция типов исходных событий, которые оценивают набор правил автоматизации безопасности.

tags

object

Список пар значений ключей, описывающих ресурс.

type

string

Тип ресурса

AutomationActionEventHub

Целевой концентратор событий, в который будут экспортированы данные события. Дополнительные сведения о возможностях непрерывного экспорта в Microsoft Defender для облака см. в https://aka.ms/ASCExportLearnMore

Имя Тип Описание
actionType string:

EventHub

Тип действия, которое будет запускаться службой автоматизации

connectionString

string

Строка подключения целевого концентратора событий (она не будет включена в какой-либо ответ).

eventHubResourceId

string

Идентификатор ресурса целевого концентратора событий Azure.

isTrustedServiceEnabled

boolean

Указывает, включена ли надежная служба.

sasPolicyName

string

Имя политики SAS целевого концентратора событий.

AutomationActionLogicApp

Действие приложения логики, которое должно быть активировано. Дополнительные сведения о возможностях автоматизации рабочих процессов Microsoft Defender для Облака см. в https://aka.ms/ASCWorkflowAutomationLearnMore

Имя Тип Описание
actionType string:

LogicApp

Тип действия, которое будет запускаться службой автоматизации

logicAppResourceId

string

Активированный идентификатор ресурса приложения логики Azure. Это также может находиться в других подписках, учитывая, что у вас есть разрешения на активацию приложения логики

uri

string

Конечная точка URI триггера приложения логики (она не будет включена в ответ).

AutomationActionWorkspace

Рабочая область Log Analytics, в которую будут экспортироваться данные события. Данные оповещений системы безопасности будут находиться в таблице SecurityAlert, а данные оценки будут находиться в таблице SecurityRecommendation (в соответствии с решениями Security/SecurityCenterFree). Обратите внимание, что для просмотра данных в рабочей области необходимо включить бесплатное или стандартное решение Центра безопасности Log Analytics. Дополнительные сведения о возможностях непрерывного экспорта в Microsoft Defender для облака см. в https://aka.ms/ASCExportLearnMore

Имя Тип Описание
actionType string:

Workspace

Тип действия, которое будет запускаться службой автоматизации

workspaceResourceId

string

Полный идентификатор ресурса Azure рабочей области Log Analytics.

AutomationRuleSet

Набор правил, который оценивает все его правила при перехвате событий. Только если все включенные правила в наборе правил будут оцениваться как true, событие активирует определенные действия.

Имя Тип Описание
rules

AutomationTriggeringRule[]

Правило, которое вычисляется при перехвате событий. Правило настраивается путем сравнения определенного значения из модели событий с ожидаемым значением. Это сравнение выполняется с помощью одного из поддерживаемых наборов операторов.

AutomationScope

Одна область автоматизации.

Имя Тип Описание
description

string

Описание области ресурсов.

scopePath

string

Путь к области ресурсов. Может быть подпиской, в которой определена автоматизация или группа ресурсов в этой подписке (полные идентификаторы ресурсов Azure).

AutomationSource

Исходные типы событий, которые оценивают набор правил автоматизации безопасности. Например, оповещения системы безопасности и оценки безопасности. Дополнительные сведения о поддерживаемых схемах моделей данных о событиях безопасности см. в https://aka.ms/ASCAutomationSchemas.

Имя Тип Описание
eventSource

EventSource

Допустимый тип источника события.

ruleSets

AutomationRuleSet[]

Набор правил, которые оцениваются при перехвате событий. Логическая дисъюнкция применяется между определенными наборами правил (логическими или).

AutomationTriggeringRule

Правило, которое вычисляется при перехвате событий. Правило настраивается путем сравнения определенного значения из модели событий с ожидаемым значением. Это сравнение выполняется с помощью одного из поддерживаемых наборов операторов.

Имя Тип Описание
expectedValue

string

Ожидаемое значение.

operator

Operator

Допустимый оператор сравнения для использования. Для String PropertyType будет применено сравнение без учета регистра.

propertyJPath

string

JPath свойства модели сущности, которое следует проверить.

propertyType

PropertyType

Тип данных сравниваемых операндов (строка, целое число, число с плавающей запятой или логическое значение [true/false]]

AutomationUpdateModel

Модель обновления ресурса автоматизации безопасности.

Имя Тип Описание
properties.actions AutomationAction[]:

Коллекция действий, которые активируются, если все настроенные оценки правил в пределах по крайней мере одного набора правил имеют значение true.

properties.description

string

Описание службы автоматизации безопасности.

properties.isEnabled

boolean

Указывает, включена ли автоматизация безопасности.

properties.scopes

AutomationScope[]

Коллекция областей, к которым применяется логика автоматизации безопасности. Поддерживаемые области — это сама подписка или группа ресурсов в этой подписке. Автоматизация будет применяться только к определенным областям.

properties.sources

AutomationSource[]

Коллекция типов исходных событий, которые оценивают набор правил автоматизации безопасности.

tags

object

Список пар значений ключей, описывающих ресурс.

CloudError

Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).

Имя Тип Описание
error.additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

error.code

string

Код ошибки.

error.details

CloudErrorBody[]

Сведения об ошибке.

error.message

string

Сообщение об ошибке.

error.target

string

Целевой объект ошибки.

CloudErrorBody

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

CloudErrorBody[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

EventSource

Допустимый тип источника события.

Имя Тип Описание
Alerts

string

Assessments

string

AssessmentsSnapshot

string

AttackPaths

string

AttackPathsSnapshot

string

RegulatoryComplianceAssessment

string

RegulatoryComplianceAssessmentSnapshot

string

SecureScoreControls

string

SecureScoreControlsSnapshot

string

SecureScores

string

SecureScoresSnapshot

string

SubAssessments

string

SubAssessmentsSnapshot

string

Operator

Допустимый оператор сравнения для использования. Для String PropertyType будет применено сравнение без учета регистра.

Имя Тип Описание
Contains

string

Применяется только для не десятичных операндов

EndsWith

string

Применяется только для не десятичных операндов

Equals

string

Применяется для десятичных и не десятичных операндов

GreaterThan

string

Применяется только для десятичных операндов

GreaterThanOrEqualTo

string

Применяется только для десятичных операндов

LesserThan

string

Применяется только для десятичных операндов

LesserThanOrEqualTo

string

Применяется только для десятичных операндов

NotEquals

string

Применяется для десятичных и не десятичных операндов

StartsWith

string

Применяется только для не десятичных операндов

PropertyType

Тип данных сравниваемых операндов (строка, целое число, число с плавающей запятой или логическое значение [true/false]]

Имя Тип Описание
Boolean

string

Integer

string

Number

string

String

string