创建 securityAction
本文内容
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
创建新的 securityAction 对象。
此 API 可用于以下国家级云部署 。
全局服务
美国政府 L4
美国政府 L5 (DOD)
由世纪互联运营的中国
✅
❌
❌
❌
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时 ,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型 。 要了解有关这些权限的详细信息,请参阅 权限参考 。
权限类型
最低特权权限
更高特权权限
委派(工作或学校帐户)
不支持。
不支持。
委派(个人 Microsoft 帐户)
不支持。
不支持。
应用程序
SecurityActions.ReadWrite.All
不可用。
HTTP 请求
POST /security/securityActions
名称
说明
Authorization
Bearer {code}
请求正文
在请求正文中,提供 securityAction 对象的 JSON 表示形式。
响应
如果成功,此方法在 201 Created
响应正文中返回响应代码和 securityAction 对象。
示例
请求
以下示例显示了一个请求。
POST https://graph.microsoft.com/beta/security/securityActions
Content-type: application/json
{
"name": "BlockIp",
"actionReason": "Test",
"parameters": [
{
"name": "IP",
"value": "1.2.3.4"
}
],
"vendorInformation": {
"provider": "Windows Defender ATP",
"vendor": "Microsoft"
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new SecurityAction
{
Name = "BlockIp",
ActionReason = "Test",
Parameters = new List<KeyValuePair>
{
new KeyValuePair
{
Name = "IP",
Value = "1.2.3.4",
},
},
VendorInformation = new SecurityVendorInformation
{
Provider = "Windows Defender ATP",
Vendor = "Microsoft",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Security.SecurityActions.PostAsync(requestBody);
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta security security-actions create --body '{\
"name": "BlockIp",\
"actionReason": "Test",\
"parameters": [\
{\
"name": "IP",\
"value": "1.2.3.4"\
}\
],\
"vendorInformation": {\
"provider": "Windows Defender ATP",\
"vendor": "Microsoft"\
}\
}\
'
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
requestBody := graphmodels.NewSecurityAction()
name := "BlockIp"
requestBody.SetName(&name)
actionReason := "Test"
requestBody.SetActionReason(&actionReason)
keyValuePair := graphmodels.NewKeyValuePair()
name := "IP"
keyValuePair.SetName(&name)
value := "1.2.3.4"
keyValuePair.SetValue(&value)
parameters := []graphmodels.KeyValuePairable {
keyValuePair,
}
requestBody.SetParameters(parameters)
vendorInformation := graphmodels.NewSecurityVendorInformation()
provider := "Windows Defender ATP"
vendorInformation.SetProvider(&provider)
vendor := "Microsoft"
vendorInformation.SetVendor(&vendor)
requestBody.SetVendorInformation(vendorInformation)
securityActions, err := graphClient.Security().SecurityActions().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
SecurityAction securityAction = new SecurityAction();
securityAction.setName("BlockIp");
securityAction.setActionReason("Test");
LinkedList<KeyValuePair> parameters = new LinkedList<KeyValuePair>();
KeyValuePair keyValuePair = new KeyValuePair();
keyValuePair.setName("IP");
keyValuePair.setValue("1.2.3.4");
parameters.add(keyValuePair);
securityAction.setParameters(parameters);
SecurityVendorInformation vendorInformation = new SecurityVendorInformation();
vendorInformation.setProvider("Windows Defender ATP");
vendorInformation.setVendor("Microsoft");
securityAction.setVendorInformation(vendorInformation);
SecurityAction result = graphClient.security().securityActions().post(securityAction);
const options = {
authProvider,
};
const client = Client.init(options);
const securityAction = {
name: 'BlockIp',
actionReason: 'Test',
parameters: [
{
name: 'IP',
value: '1.2.3.4'
}
],
vendorInformation: {
provider: 'Windows Defender ATP',
vendor: 'Microsoft'
}
};
await client.api('/security/securityActions')
.version('beta')
.post(securityAction);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\SecurityAction;
use Microsoft\Graph\Generated\Models\KeyValuePair;
use Microsoft\Graph\Generated\Models\SecurityVendorInformation;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new SecurityAction();
$requestBody->setName('BlockIp');
$requestBody->setActionReason('Test');
$parametersKeyValuePair1 = new KeyValuePair();
$parametersKeyValuePair1->setName('IP');
$parametersKeyValuePair1->setValue('1.2.3.4');
$parametersArray []= $parametersKeyValuePair1;
$requestBody->setParameters($parametersArray);
$vendorInformation = new SecurityVendorInformation();
$vendorInformation->setProvider('Windows Defender ATP');
$vendorInformation->setVendor('Microsoft');
$requestBody->setVendorInformation($vendorInformation);
$result = $graphServiceClient->security()->securityActions()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Security
$params = @{
name = "BlockIp"
actionReason = "Test"
parameters = @(
@{
name = "IP"
value = "1.2.3.4"
}
)
vendorInformation = @{
provider = "Windows Defender ATP"
vendor = "Microsoft"
}
}
New-MgBetaSecurityAction -BodyParameter $params
from msgraph import GraphServiceClient
from msgraph.generated.models.security_action import SecurityAction
from msgraph.generated.models.key_value_pair import KeyValuePair
from msgraph.generated.models.security_vendor_information import SecurityVendorInformation
graph_client = GraphServiceClient(credentials, scopes)
request_body = SecurityAction(
name = "BlockIp",
action_reason = "Test",
parameters = [
KeyValuePair(
name = "IP",
value = "1.2.3.4",
),
],
vendor_information = SecurityVendorInformation(
provider = "Windows Defender ATP",
vendor = "Microsoft",
),
)
result = await graph_client.security.security_actions.post(request_body)
响应
以下示例显示了相应的响应。
注意: 为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 201 Created
Content-type: application/json
{
"id" : "1234567890",
"status" : "notStarted",
"createdDateTime": "2019-01-10 12:23:23.33333",
"lastActionDateTime": "2019-01-10 12:23:23.33333",
"name": "blockIp",
"actionReason": "Test",
"errorInfo": null,
"vendorInformation": {
"provider": "Windows Defender ATP",
"providerVersion": null,
"subProvider": null,
"vendor": "Microsoft"
},
"parameters": [
{
"name": "IP",
"value": "1.2.3.4"
}
]
}