Compartir a través de


Automations - Update

Actualiza una automatización de seguridad

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
automationName
path True

string

Nombre de la automatización de seguridad.

resourceGroupName
path True

string

Nombre del grupo de recursos dentro de la suscripción del usuario. El nombre no distingue mayúsculas de minúsculas.

Patrón de Regex: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Identificador de suscripción de Azure

Patrón de Regex: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

Versión de API para la operación

Cuerpo de la solicitud

Nombre Tipo Description
properties.actions AutomationAction[]:

Una colección de las acciones que se desencadenan si todas las evaluaciones de reglas configuradas, dentro de al menos un conjunto de reglas, son true.

properties.description

string

Descripción de la automatización de seguridad.

properties.isEnabled

boolean

Indica si la automatización de seguridad está habilitada.

properties.scopes

AutomationScope[]

Colección de ámbitos en los que se aplica la lógica de automatización de seguridad. Los ámbitos admitidos son la propia suscripción o un grupo de recursos en esa suscripción. La automatización solo se aplicará en ámbitos definidos.

properties.sources

AutomationSource[]

Colección de los tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad.

tags

object

Lista de pares clave-valor que describen el recurso.

Respuestas

Nombre Tipo Description
200 OK

Automation

De acuerdo

Other Status Codes

CloudError

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

Update a security automation

Solicitud de ejemplo

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"
      }
    ]
  }
}

Respuesta de muestra

{
  "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"
      }
    ]
  }
}

Definiciones

Nombre Description
Automation

Recurso de automatización de seguridad.

AutomationActionEventHub

Centro de eventos de destino al que se exportarán los datos del evento. Para obtener más información sobre las funcionalidades de exportación continua de Microsoft Defender for Cloud, visite https://aka.ms/ASCExportLearnMore

AutomationActionLogicApp

Acción de aplicación lógica que se debe desencadenar. Para obtener más información sobre las funcionalidades de Automatización de flujos de trabajo de Microsoft Defender for Cloud, visite https://aka.ms/ASCWorkflowAutomationLearnMore

AutomationActionWorkspace

Área de trabajo de Log Analytics a la que se exportarán los datos de eventos. Los datos de alertas de seguridad residirán en la tabla "SecurityAlert" y los datos de evaluaciones residirán en la tabla "SecurityRecommendation" (en las soluciones "Security"/"SecurityCenterFree"). Tenga en cuenta que, para ver los datos del área de trabajo, la solución gratuita o estándar de Log Analytics de Security Center debe estar habilitada en esa área de trabajo. Para obtener más información sobre las funcionalidades de exportación continua de Microsoft Defender for Cloud, visite https://aka.ms/ASCExportLearnMore

AutomationRuleSet

Conjunto de reglas que evalúa todas sus reglas en una interceptación de eventos. Solo cuando todas las reglas incluidas del conjunto de reglas se evalúen como "true", el evento desencadenará las acciones definidas.

AutomationScope

Un único ámbito de automatización.

AutomationSource

Tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad. Por ejemplo, alertas de seguridad y evaluaciones de seguridad. Para más información sobre los esquemas de modelos de datos de eventos de seguridad admitidos, visite https://aka.ms/ASCAutomationSchemas.

AutomationTriggeringRule

Regla que se evalúa tras la interceptación de eventos. La regla se configura comparando un valor específico del modelo de eventos con un valor esperado. Esta comparación se realiza mediante uno de los operadores admitidos establecidos.

AutomationUpdateModel

Modelo de actualización del recurso de automatización de seguridad.

CloudError

Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

CloudErrorBody

Detalle del error.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

EventSource

Tipo de origen de evento válido.

Operator

Operador de comparador válido que se va a usar. Se aplicará una comparación que no distingue mayúsculas de minúsculas para String PropertyType.

PropertyType

Tipo de datos de los operandos comparados (cadena, entero, número de punto flotante o booleano [true/false]]

Automation

Recurso de automatización de seguridad.

Nombre Tipo Description
etag

string

La etiqueta de entidad se usa para comparar dos o más entidades del mismo recurso solicitado.

id

string

Identificador de recurso

kind

string

Tipo de recurso

location

string

Ubicación donde se almacena el recurso

name

string

Nombre del recurso

properties.actions AutomationAction[]:

Una colección de las acciones que se desencadenan si todas las evaluaciones de reglas configuradas, dentro de al menos un conjunto de reglas, son true.

properties.description

string

Descripción de la automatización de seguridad.

properties.isEnabled

boolean

Indica si la automatización de seguridad está habilitada.

properties.scopes

AutomationScope[]

Colección de ámbitos en los que se aplica la lógica de automatización de seguridad. Los ámbitos admitidos son la propia suscripción o un grupo de recursos en esa suscripción. La automatización solo se aplicará en ámbitos definidos.

properties.sources

AutomationSource[]

Colección de los tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad.

tags

object

Lista de pares clave-valor que describen el recurso.

type

string

Tipo de recurso

AutomationActionEventHub

Centro de eventos de destino al que se exportarán los datos del evento. Para obtener más información sobre las funcionalidades de exportación continua de Microsoft Defender for Cloud, visite https://aka.ms/ASCExportLearnMore

Nombre Tipo Description
actionType string:

EventHub

Tipo de la acción que desencadenará Automation.

connectionString

string

Cadena de conexión del centro de eventos de destino (no se incluirá en ninguna respuesta).

eventHubResourceId

string

Identificador de recurso de Azure del centro de eventos de destino.

isTrustedServiceEnabled

boolean

Indica si el servicio de confianza está habilitado o no.

sasPolicyName

string

Nombre de la directiva SAS de Centro de eventos de destino.

AutomationActionLogicApp

Acción de aplicación lógica que se debe desencadenar. Para obtener más información sobre las funcionalidades de Automatización de flujos de trabajo de Microsoft Defender for Cloud, visite https://aka.ms/ASCWorkflowAutomationLearnMore

Nombre Tipo Description
actionType string:

LogicApp

Tipo de la acción que desencadenará Automation.

logicAppResourceId

string

Identificador de recurso de Azure de aplicación lógica desencadenada. Esto también puede residir en otras suscripciones, dado que tiene permisos para desencadenar la aplicación lógica.

uri

string

El punto de conexión del URI del desencadenador de aplicación lógica (no se incluirá en ninguna respuesta).

AutomationActionWorkspace

Área de trabajo de Log Analytics a la que se exportarán los datos de eventos. Los datos de alertas de seguridad residirán en la tabla "SecurityAlert" y los datos de evaluaciones residirán en la tabla "SecurityRecommendation" (en las soluciones "Security"/"SecurityCenterFree"). Tenga en cuenta que, para ver los datos del área de trabajo, la solución gratuita o estándar de Log Analytics de Security Center debe estar habilitada en esa área de trabajo. Para obtener más información sobre las funcionalidades de exportación continua de Microsoft Defender for Cloud, visite https://aka.ms/ASCExportLearnMore

Nombre Tipo Description
actionType string:

Workspace

Tipo de la acción que desencadenará Automation.

workspaceResourceId

string

Identificador de recurso de Azure del área de trabajo de Log Analytics completa.

AutomationRuleSet

Conjunto de reglas que evalúa todas sus reglas en una interceptación de eventos. Solo cuando todas las reglas incluidas del conjunto de reglas se evalúen como "true", el evento desencadenará las acciones definidas.

Nombre Tipo Description
rules

AutomationTriggeringRule[]

Regla que se evalúa tras la interceptación de eventos. La regla se configura comparando un valor específico del modelo de eventos con un valor esperado. Esta comparación se realiza mediante uno de los operadores admitidos establecidos.

AutomationScope

Un único ámbito de automatización.

Nombre Tipo Description
description

string

Descripción del ámbito de los recursos.

scopePath

string

Ruta de acceso del ámbito de recursos. Puede ser la suscripción en la que se define la automatización o un grupo de recursos en esa suscripción (identificadores de recursos de Azure completos).

AutomationSource

Tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad. Por ejemplo, alertas de seguridad y evaluaciones de seguridad. Para más información sobre los esquemas de modelos de datos de eventos de seguridad admitidos, visite https://aka.ms/ASCAutomationSchemas.

Nombre Tipo Description
eventSource

EventSource

Tipo de origen de evento válido.

ruleSets

AutomationRuleSet[]

Conjunto de reglas que se evalúan tras la interceptación de eventos. Se aplica una disjunción lógica entre conjuntos de reglas definidos (lógicos "o").

AutomationTriggeringRule

Regla que se evalúa tras la interceptación de eventos. La regla se configura comparando un valor específico del modelo de eventos con un valor esperado. Esta comparación se realiza mediante uno de los operadores admitidos establecidos.

Nombre Tipo Description
expectedValue

string

Valor esperado.

operator

Operator

Operador de comparador válido que se va a usar. Se aplicará una comparación que no distingue mayúsculas de minúsculas para String PropertyType.

propertyJPath

string

JPath de la propiedad del modelo de entidad que se debe comprobar.

propertyType

PropertyType

Tipo de datos de los operandos comparados (cadena, entero, número de punto flotante o booleano [true/false]]

AutomationUpdateModel

Modelo de actualización del recurso de automatización de seguridad.

Nombre Tipo Description
properties.actions AutomationAction[]:

Una colección de las acciones que se desencadenan si todas las evaluaciones de reglas configuradas, dentro de al menos un conjunto de reglas, son true.

properties.description

string

Descripción de la automatización de seguridad.

properties.isEnabled

boolean

Indica si la automatización de seguridad está habilitada.

properties.scopes

AutomationScope[]

Colección de ámbitos en los que se aplica la lógica de automatización de seguridad. Los ámbitos admitidos son la propia suscripción o un grupo de recursos en esa suscripción. La automatización solo se aplicará en ámbitos definidos.

properties.sources

AutomationSource[]

Colección de los tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad.

tags

object

Lista de pares clave-valor que describen el recurso.

CloudError

Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

Nombre Tipo Description
error.additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

error.code

string

Código de error.

error.details

CloudErrorBody[]

Detalles del error.

error.message

string

Mensaje de error.

error.target

string

Destino del error.

CloudErrorBody

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

CloudErrorBody[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

EventSource

Tipo de origen de evento válido.

Nombre Tipo Description
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

Operador de comparador válido que se va a usar. Se aplicará una comparación que no distingue mayúsculas de minúsculas para String PropertyType.

Nombre Tipo Description
Contains

string

Solo se aplica a operandos no decimales.

EndsWith

string

Solo se aplica a operandos no decimales.

Equals

string

Se aplica a operandos decimales y no decimales

GreaterThan

string

Solo se aplica a operandos decimales.

GreaterThanOrEqualTo

string

Solo se aplica a operandos decimales.

LesserThan

string

Solo se aplica a operandos decimales.

LesserThanOrEqualTo

string

Solo se aplica a operandos decimales.

NotEquals

string

Se aplica a operandos decimales y no decimales

StartsWith

string

Solo se aplica a operandos no decimales.

PropertyType

Tipo de datos de los operandos comparados (cadena, entero, número de punto flotante o booleano [true/false]]

Nombre Tipo Description
Boolean

string

Integer

string

Number

string

String

string