Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Обновление нескольких индикаторов аналитики угроз (TI) в одном запросе вместо нескольких запросов.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба |
Правительство США L4 |
Правительство США L5 (DOD) |
Китай управляется 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения |
Разрешения с наименьшими привилегиями |
Более высокие привилегированные разрешения |
| Делегированные (рабочая или учебная учетная запись) |
ThreatIndicators.ReadWrite.OwnedBy |
Недоступно. |
| Делегированные (личная учетная запись Майкрософт) |
Не поддерживается. |
Не поддерживается. |
| Приложение |
ThreatIndicators.ReadWrite.OwnedBy |
Недоступно. |
HTTP-запрос
POST /security/tiIndicators/updateTiIndicators
Текст запроса
В тексте запроса предоставьте JSON-объект с указанными ниже параметрами. Дополнительные сведения о свойствах, которые можно обновить, см. в разделе update tiIndicator. Обязательные поля для каждого tiIndicator: id, expirationDateTime, targetProduct.
| Параметр |
Тип |
Описание |
| значение |
коллекция tiIndicator |
Коллекция tiIndicators для обновления. Каждая сущность должна иметь идентификатор и другие редактируемые свойства для обновления. |
Отклик
В случае успешного 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);
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"\
}\
]\
}\
\
'
// 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)
// 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);
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);
<?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();
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
# 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)
Отклик
Ниже показан пример отклика.
Примечание.
Объект ответа, показанный здесь, может быть сокращен для удобочитаемости.
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.",
}
]
}