securityAction 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
利用 Microsoft Graph 安全性 securityAction 实体立即采取行动来抵御威胁。 当安全分析师发现新的指示器（如恶意文件、URL、域或 IP 地址）时，可立即在你的 Microsoft 安全解决方案中启用保护。 针对特定提供商采取操作，查看所采取的全部操作，还可在需要时取消操作。 尝试使用 Windows Defender for Endpoint 执行安全操作，以使用警报中看到或在调查期间识别的属性来阻止 Windows 终结点上的恶意活动。
注意：安全操作当前仅支持应用程序权限。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 获取安全操作 | securityAction | 读取 securityAction 对象的属性和关系。 |
| 创建安全操作 | securityAction | 通过发布到 securityActions 集合来创建新的 securityAction。 |
| 列出安全操作 | securityAction 集合 | 获取 securityAction 对象集合。 |
| 取消安全操作 | None | 取消安全操作。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| actionReason | String | 调用此操作的原因。 |
| appId | String | ) 操作提交 (POST 的调用应用程序的应用程序 ID。 appId 应从身份验证令牌中提取，而不是由调用应用程序手动输入。 |
| azureTenantId | 字符串 | 实体的 Azure 租户 ID，用于确定实体属于哪个租户， (多租户支持) 。 azureTenantId 应从身份验证令牌中提取，而不是由调用应用程序手动输入。 |
| clientContext | String | 唯一的客户端上下文字符串。 最多可以包含 256 个字符。 |
| completedDateTime | DateTimeOffset | 操作完成时的时间戳。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| createdDateTime | DateTimeOffset | 创建操作时的时间戳。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| errorInfo | resultInfo | 操作失败时的错误信息。 |
| id | String | 引入操作时由系统创建。 生成的 GUID/唯一标识符。 此为只读属性。 |
| lastActionDateTime | DateTimeOffset | 上次更新此操作时的时间戳。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| name | String | 操作名称。 |
| parameters | keyValuePair 集合 | 参数集合 (键值对) 调用操作所必需的，例如，url 或 fileHash to block.) 。 必需。 |
| 国家 | securityActionState 集合 | 用于保留操作历史记录的 securityActionState 集合。 |
| 状态 | string | 操作的状态。 可能的值是：NotStarted、Running、Completed、Failed。 |
| 用户 | String | ) 操作提交 (POST 的已登录用户的用户主体名称。 用户应从身份验证令牌中提取，而不是由调用应用程序手动输入。 |
| vendorInformation | securityVendorInformation | 复杂类型，包含有关安全产品/服务供应商、提供商和子提供程序的详细信息， (例如 vendor=Microsoft;provider=Windows Defender ATP;sub-provider=AppLocker) 。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"actionReason": "String",
"appId": "String",
"azureTenantId": "String",
"clientContext": "String",
"completedDateTime": "String (timestamp)",
"createdDateTime": "String (timestamp)",
"errorInfo": {"@odata.type": "microsoft.graph.resultInfo"},
"id": "String (identifier)",
"lastActionDateTime": "String (timestamp)",
"name": "String",
"parameters": [{"@odata.type": "microsoft.graph.keyValuePair"}],
"states": [{"@odata.type": "microsoft.graph.securityActionState"}],
"status": "string",
"user": "String",
"vendorInformation": {"@odata.type": "microsoft.graph.securityVendorInformation"}
}