Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Actualice varios indicadores de inteligencia sobre amenazas (TI) en una solicitud en lugar de varias solicitudes.
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso
Permisos con privilegios mínimos
Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)
ThreatIndicators.ReadWrite.OwnedBy
No disponible.
Delegado (cuenta personal de Microsoft)
No admitida.
No admitida.
Aplicación
ThreatIndicators.ReadWrite.OwnedBy
No disponible.
Solicitud HTTP
POST /security/tiIndicators/updateTiIndicators
Encabezados de solicitud
Nombre
Descripción
Autorización
Portador {code}
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros. Para obtener más información sobre las propiedades que se pueden actualizar, consulte update tiIndicator. Los campos necesarios para cada tiIndicator son: id, expirationDateTime, targetProduct.
Parámetro
Tipo
Descripción
value
colección tiIndicator
Colección de tiIndicators que se van a actualizar. Cada entidad debe tener id . y otras propiedades modificables que se van a actualizar.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y una colección de objetos tiIndicator en el cuerpo de la respuesta. Si se produce un error, este método devuelve un código de 206 Partial Content respuesta. Consulte Errores para obtener más información.
Ejemplos
En el siguiente ejemplo se muestra cómo llamar a esta API.
// 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);
Importante
Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
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"\
}\
]\
}\
\
'
Importante
Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.
Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.
// 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);
Importante
Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.
Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\UpdateTiIndicatorsPostRequestBody;
use Microsoft\Graph\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();
Importante
Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.
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
Importante
Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.
from msgraph import GraphServiceClient
from msgraph.generated.models.update_ti_indicators_post_request_body import UpdateTiIndicatorsPostRequestBody
from msgraph.generated.models.ti_indicator import TiIndicator
graph_client = GraphServiceClient(credentials, scopes)
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)
Importante
Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.
El objeto de respuesta que se muestra aquí puede estar acortado para mejorar la legibilidad.
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.",
}
]
}
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.