tiIndicator：updateTiIndicators

项目
08/14/2024

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

更新多个威胁情报 (TI 在一个请求中) 指示器，而不是多个请求。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	❌	❌	❌

权限

为此 API 选择标记为最低特权的权限。只有在应用需要它时，才使用更高的特权权限。有关委派权限和应用程序权限的详细信息，请参阅权限类型。要了解有关这些权限的详细信息，请参阅权限参考。

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	ThreatIndicators.ReadWrite.OwnedBy	不可用。
委派（个人 Microsoft 帐户）	不支持。	不支持。
应用程序	ThreatIndicators.ReadWrite.OwnedBy	不可用。

HTTP 请求

POST /security/tiIndicators/updateTiIndicators

请求标头

名称	说明
Authorization	持有者 {token}。必填。详细了解身份验证和授权。

请求正文

在请求正文中，提供具有以下参数的 JSON 对象。有关可更新的属性的详细信息，请参阅 update tiIndicator。每个 tiIndicator 的必填字段为： id、 expirationDateTime、 targetProduct。

参数	类型	说明
值	tiIndicator 集合	要更新的 tiIndicator 的集合。每个实体必须具有 ID 和其他要更新的可编辑属性。

响应

如果成功，此方法在响应正文中返回响应 200 OK 代码和 tiIndicator 对象的集合。如果出现错误，此方法将 206 Partial Content 返回响应代码。有关详细信息，请参阅错误。

示例

以下示例演示如何调用此 API。

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/beta/security/tiIndicators/updateTiIndicators
Content-type: application/json

{
  "value": [
    {
      "id": "c6fb948b-89c5-3bba-a2cd-a9d9a1e430e4",
      "additionalInformation": "mytest"
    },
    {
      "id": "e58c072b-c9bb-a5c4-34ce-eb69af44fb1e",
      "additionalInformation": "test again"
    }
  ]
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Security.TiIndicators.UpdateTiIndicators;
using Microsoft.Graph.Beta.Models;

var requestBody = new UpdateTiIndicatorsPostRequestBody
{
	Value = new List<TiIndicator>
	{
		new TiIndicator
		{
			Id = "c6fb948b-89c5-3bba-a2cd-a9d9a1e430e4",
			AdditionalInformation = "mytest",
		},
		new TiIndicator
		{
			Id = "e58c072b-c9bb-a5c4-34ce-eb69af44fb1e",
			AdditionalInformation = "test again",
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Security.TiIndicators.UpdateTiIndicators.PostAsUpdateTiIndicatorsPostResponseAsync(requestBody);

重要

Microsoft Graph SDK 默认使用 v1.0 版本的 API，并且不支持 beta 版本中提供的所有类型、属性和 API。有关使用 SDK 访问 beta API 的详细信息，请参阅将 Microsoft Graph SDK 与 beta API 配合使用。

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。



mgc-beta security ti-indicators update-ti-indicators post --body '{\
  "value": [\
    {\
      "id": "c6fb948b-89c5-3bba-a2cd-a9d9a1e430e4",\
      "additionalInformation": "mytest"\
    },\
    {\
      "id": "e58c072b-c9bb-a5c4-34ce-eb69af44fb1e",\
      "additionalInformation": "test again"\
    }\
  ]\
}\
\
'

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphsecurity "github.com/microsoftgraph/msgraph-beta-sdk-go/security"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphsecurity.NewUpdateTiIndicatorsPostRequestBody()


tiIndicator := graphmodels.NewTiIndicator()
id := "c6fb948b-89c5-3bba-a2cd-a9d9a1e430e4"
tiIndicator.SetId(&id) 
additionalInformation := "mytest"
tiIndicator.SetAdditionalInformation(&additionalInformation) 
tiIndicator1 := graphmodels.NewTiIndicator()
id := "e58c072b-c9bb-a5c4-34ce-eb69af44fb1e"
tiIndicator1.SetId(&id) 
additionalInformation := "test again"
tiIndicator1.SetAdditionalInformation(&additionalInformation) 

value := []graphmodels.TiIndicatorable {
	tiIndicator,
	tiIndicator1,
}
requestBody.SetValue(value)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
updateTiIndicators, err := graphClient.Security().TiIndicators().UpdateTiIndicators().PostAsUpdateTiIndicatorsPostResponse(context.Background(), requestBody, nil)

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.beta.security.tiindicators.updatetiindicators.UpdateTiIndicatorsPostRequestBody updateTiIndicatorsPostRequestBody = new com.microsoft.graph.beta.security.tiindicators.updatetiindicators.UpdateTiIndicatorsPostRequestBody();
LinkedList<TiIndicator> value = new LinkedList<TiIndicator>();
TiIndicator tiIndicator = new TiIndicator();
tiIndicator.setId("c6fb948b-89c5-3bba-a2cd-a9d9a1e430e4");
tiIndicator.setAdditionalInformation("mytest");
value.add(tiIndicator);
TiIndicator tiIndicator1 = new TiIndicator();
tiIndicator1.setId("e58c072b-c9bb-a5c4-34ce-eb69af44fb1e");
tiIndicator1.setAdditionalInformation("test again");
value.add(tiIndicator1);
updateTiIndicatorsPostRequestBody.setValue(value);
var result = graphClient.security().tiIndicators().updateTiIndicators().post(updateTiIndicatorsPostRequestBody);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


const options = {
	authProvider,
};

const client = Client.init(options);

const tiIndicator = {
  value: [
    {
      id: 'c6fb948b-89c5-3bba-a2cd-a9d9a1e430e4',
      additionalInformation: 'mytest'
    },
    {
      id: 'e58c072b-c9bb-a5c4-34ce-eb69af44fb1e',
      additionalInformation: 'test again'
    }
  ]
};

await client.api('/security/tiIndicators/updateTiIndicators')
	.version('beta')
	.post(tiIndicator);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Security\TiIndicators\UpdateTiIndicators\UpdateTiIndicatorsPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\TiIndicator;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new UpdateTiIndicatorsPostRequestBody();
$valueTiIndicator1 = new TiIndicator();
$valueTiIndicator1->setId('c6fb948b-89c5-3bba-a2cd-a9d9a1e430e4');
$valueTiIndicator1->setAdditionalInformation('mytest');
$valueArray []= $valueTiIndicator1;
$valueTiIndicator2 = new TiIndicator();
$valueTiIndicator2->setId('e58c072b-c9bb-a5c4-34ce-eb69af44fb1e');
$valueTiIndicator2->setAdditionalInformation('test again');
$valueArray []= $valueTiIndicator2;
$requestBody->setValue($valueArray);


$result = $graphServiceClient->security()->tiIndicators()->updateTiIndicators()->post($requestBody)->wait();

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


Import-Module Microsoft.Graph.Beta.Security

$params = @{
	value = @(
		@{
			id = "c6fb948b-89c5-3bba-a2cd-a9d9a1e430e4"
			additionalInformation = "mytest"
		}
		@{
			id = "e58c072b-c9bb-a5c4-34ce-eb69af44fb1e"
			additionalInformation = "test again"
		}
	)
}

Update-MgBetaSecurityTiIndicatorMultiple -BodyParameter $params

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.security.tiindicators.update_ti_indicators.update_ti_indicators_post_request_body import UpdateTiIndicatorsPostRequestBody
from msgraph_beta.generated.models.ti_indicator import TiIndicator
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = UpdateTiIndicatorsPostRequestBody(
	value = [
		TiIndicator(
			id = "c6fb948b-89c5-3bba-a2cd-a9d9a1e430e4",
			additional_information = "mytest",
		),
		TiIndicator(
			id = "e58c072b-c9bb-a5c4-34ce-eb69af44fb1e",
			additional_information = "test again",
		),
	],
)

result = await graph_client.security.ti_indicators.update_ti_indicators.post(request_body)

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

以下示例显示了相应的响应。

注意

为了提高可读性，可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.tiIndicator",
      "id": "c6fb948b-89c5-3bba-a2cd-a9d9a1e430e4",
      "azureTenantId": "XXXXXXXXXXXXXXXXXX",
      "action": null,
      "additionalInformation": "mytest",
      "activityGroupNames": [],
      "confidence": 0,
      "description": "This is a test indicator for demo purpose. Take no action on any observables set in this indicator.",
    }
  ]
}

通过

tiIndicator：updateTiIndicators

权限

HTTP 请求

请求标头

请求正文

响应

示例

请求

响应

反馈

其他资源