Enumeración de objetos trainingCampaign

Espacio de nombres: microsoft.graph

Obtenga una lista de los objetos trainingCampaign y sus propiedades.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

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.

Solicitud HTTP

GET /security/attackSimulation/trainingCampaigns

Parámetros de consulta opcionales

Este método admite los $countparámetros de consulta , $filter, $orderby, $skipToken, $topy $select OData para ayudar a personalizar la respuesta. Puede usar los $filter parámetros y $orderby de consulta en las propiedades campaignSchedule/completionDateTime, displayName, campaignSchedule/launchDateTime y campaignSchedule/status .

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.

En la lista siguiente se muestran algunos ejemplos de solicitudes que usan los parámetros de consulta de OData admitidos:

GET /security/attackSimulation/trainingCampaigns?$count=true
GET /security/attackSimulation/trainingCampaigns?$filter={property} eq '{property-value}'
GET /security/attackSimulation/trainingCampaigns?$filter={property} eq '{property-value}'&$top=5
GET /security/attackSimulation/trainingCampaigns?$orderby={property}
GET /security/attackSimulation/trainingCampaigns?$skipToken={skipToken}
GET /security/attackSimulation/trainingCampaigns?$top=1
GET /security/attackSimulation/trainingCampaigns?$select={property}

Encabezados de solicitud

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 trainingCampaign en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns

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

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

// 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"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
trainingCampaigns, err := graphClient.Security().AttackSimulation().TrainingCampaigns().Get(context.Background(), nil)

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

TrainingCampaignCollectionResponse result = graphClient.security().attackSimulation().trainingCampaigns().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let trainingCampaigns = await client.api('/security/attackSimulation/trainingCampaigns')
	.version('beta')
	.get();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


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


$result = $graphServiceClient->security()->attackSimulation()->trainingCampaigns()->get()->wait();

Import-Module Microsoft.Graph.Beta.Security

Get-MgBetaSecurityAttackSimulationTrainingCampaign

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.security.attack_simulation.training_campaigns.get()

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.etag": "W/\"dub9zfj4Rk68MmY/KYwXKgADRgyGsw==\"",
            "id": "81c59451-2929-5b39-86f0-5a2b15f1314f",
            "displayName": "Sample Training Campaign",
            "description": "Sample Training Campaign Description",
            "createdDateTime": "2024-02-18T08:36:07.6534871Z",
            "lastModifiedDateTime": "2024-02-19T08:00:01.9417887Z",
            "endUserNotificationSetting": null,
            "includedAccountTarget": null,
            "excludedAccountTarget": null,
            "trainingSetting": null,
            "campaignSchedule": {
                "launchDateTime": "2024-02-18T08:37:44Z",
                "completionDateTime": "2024-02-19T07:59:44Z",
                "status": "completed"
            },
            "createdBy": {
              "id": "99af58b9-ef1a-412b-a581-cb42fe8c8e21",
              "displayName": "Reed Flores",
              "email": "reed@contoso.com"
            },
            "lastModifiedBy": {
              "id": "99af58b9-ef1a-412b-a581-cb42fe8c8e21",
              "displayName": "Reed Flores",
              "email": "reed@contoso.com"
            },
        }
    ]
}