Ejecuciones de lista
Espacio de nombres: microsoft.graph
Obtenga una lista de las ejecuciones de automatización de simulación de ataques para un inquilino.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
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) | AttackSimulation.Read.All | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | AttackSimulation.Read.All | No disponible. |
Solicitud HTTP
GET /security/attackSimulation/simulationAutomations/{simulationAutomationId}/runs
Parámetros de consulta opcionales
Este método admite los $countparámetros de consulta , $skipToken, $topy $select OData para ayudar a personalizar la respuesta.
Si el conjunto de resultados abarca varias páginas, el cuerpo de la respuesta contiene un @odata.nextLink que puede usar para paginar a través del conjunto de resultados.
A continuación se muestran ejemplos de su uso:
GET /security/attackSimulation/simulationAutomations/{simulationAutomationId}/runs?$count=true
GET /security/attackSimulation/simulationAutomations/{simulationAutomationId}/runs?$skipToken={skipToken}
GET /security/attackSimulation/simulationAutomations/{simulationAutomationId}/runs?$top=1
GET /security/attackSimulation/simulationAutomations/{simulationAutomationId}/runs?$select={property}
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y una colección de objetos simulationAutomationRun en el cuerpo de la respuesta.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/v1.0/security/attackSimulation/simulationAutomations/fbad62b0-b32d-b6ac-9f48-d84bbea08f96/runs
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
{
"value": [
{
"@odata.type": "#microsoft.graph.simulationAutomationRun",
"id": "ac4936a5-3865-a0ec-7254-67a22f6121e2",
"status": "succeeded",
"startDateTime": "2021-01-01T02:01:01.01Z",
"endDateTime": "2021-01-01T02:01:01.01Z",
"simulationId": "bc4936a5-3865-a0ec-7254-67a22f6121e2"
}
]
}