Incidents - Create Team

Référence

Service:: Sentinel

Version d'API:: 2024-01-01-preview

Crée une équipe Microsoft pour examiner l’incident en partageant des informations et des insights entre les participants.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/incidents/{incidentId}/createTeam?api-version=2024-01-01-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
incidentId	path	True	string	ID de l'incident
resourceGroupName	path	True	string	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string	ID de l’abonnement cible.
workspaceName	path	True	string	Nom de l’espace de travail. Modèle d’expression régulière: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	TeamInformation	Ok
Other Status Codes	CloudError	Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

Incidents_CreateTeam

POST https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/incidents/69a30280-6a4c-4aa7-9af0-5d63f335d600/createTeam?api-version=2024-01-01-preview

{
  "teamName": "Team name",
  "teamDescription": "Team description",
  "groupIds": null,
  "memberIds": null
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.SecurityInsights.Models;
using Azure.ResourceManager.SecurityInsights;

// Generated from example definition: specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2024-01-01-preview/examples/incidents/IncidentTeam/Incidents_CreateTeam.json
// this example is just showing the usage of "Incidents_CreateTeam" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SecurityInsightsIncidentResource created on azure
// for more information of creating SecurityInsightsIncidentResource, please refer to the document of SecurityInsightsIncidentResource
string subscriptionId = "d0cfe6b2-9ac0-4464-9919-dccaee2e48c0";
string resourceGroupName = "myRg";
string workspaceName = "myWorkspace";
string incidentId = "69a30280-6a4c-4aa7-9af0-5d63f335d600";
ResourceIdentifier securityInsightsIncidentResourceId = SecurityInsightsIncidentResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, workspaceName, incidentId);
SecurityInsightsIncidentResource securityInsightsIncident = client.GetSecurityInsightsIncidentResource(securityInsightsIncidentResourceId);

// invoke the operation
TeamInformation teamProperties = new TeamInformation();
TeamInformation result = await securityInsightsIncident.CreateTeamAsync(teamProperties);

Console.WriteLine($"Succeeded: {result}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exemple de réponse

Code d’état:: 200

{
  "teamId": "99978838-9bda-4ad4-8f93-4cf7ebc50ca5",
  "primaryChannelUrl": "https://teams.microsoft.com/l/team/19:80bf3b25485b4067b7d2dc4eec9e1578%40thread.tacv2/conversations?groupId=99978838-9bda-4ad4-8f93-4cf7ebc50ca5&tenantId=5b5a146c-eba8-46af-96f8-e31b50d15a3f",
  "teamCreationTimeUtc": "2021-03-15T17:08:21.995Z",
  "name": "Team name",
  "description": "Team description"
}

Définitions

Nom	Description
CloudError	Structure de réponse d’erreur.
CloudErrorBody	Détails de l’erreur.
TeamInformation	Décrit les informations de l’équipe

CloudError

Structure de réponse d’erreur.

Nom	Type	Description
error	CloudErrorBody	Données d’erreur

CloudErrorBody

Détails de l’erreur.

Nom	Type	Description
code	string	Identificateur de l'erreur. Les codes sont invariants et sont destinés à être consommés par programmation.
message	string	Message décrivant l’erreur, destiné à être affiché dans une interface utilisateur.

TeamInformation

Décrit les informations de l’équipe

Nom	Type	Description
description	string	Description de l’équipe
name	string	Nom de l’équipe
primaryChannelUrl	string	URL du canal principal de l’équipe
teamCreationTimeUtc	string	Heure à laquelle l’équipe a été créée
teamId	string	ID de l’équipe

Partager via