Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Cree un comentario para un incidente existente en función de la propiedad de identificador de incidente especificada.
Permissions
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) | SecurityIncident.ReadWrite.All | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | SecurityIncident.ReadWrite.All | No disponible. |
Solicitud HTTP
POST /security/incidents/{incidentId}/comments
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Content-Type | application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, use @odata.type para especificar el tipo de parámetro alertComment y proporcione un objeto JSON para el parámetro . comment Consulte un ejemplo.
| Parámetro | Tipo | Descripción |
|---|---|---|
| comment | Cadena | Comentario que se va a agregar. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y una lista actualizada de todos los recursos alertComment del incidente.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/v1.0/security/incidents/3962396/comments
Content-Type: application/json
{
"@odata.type": "microsoft.graph.security.alertComment",
"comment": "Demo for docs"
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#security/alerts_v2('da637865765418431569_-773071023')/comments",
"value": [
{
"comment": "test",
"createdByDisplayName": "secAdmin@contoso.com",
"createdDateTime": "2022-10-13T07:08:45.4626766Z"
},
{
"comment": "Demo for docs",
"createdByDisplayName": "secAdmin@contoso.com",
"createdDateTime": "2022-10-13T07:08:50.5821324Z"
}
]
}