Incidents - Run Playbook

Hizmet:

Sentinel

API Sürümü:

2024-03-01

Belirli bir olayda playbook'u tetikler

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
incidentIdentifier	path	True	string	Olay Kimliği
resourceGroupName	path	True	string	Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir.
subscriptionId	path	True	string uuid	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
workspaceName	path	True	string	Çalışma alanının adı. Normal ifade deseni: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version	query	True	string	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
requestBody	ManualTriggerRequestBody	Bir olayda playbook'u tetikleme isteği gövdesini açıklar.

Yanıtlar

Name	Tür	Description
204 No Content		Başarılı
Other Status Codes	CloudError	İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Incidents_RunPlaybook

Örnek isteği

HTTP

POST https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/incidents/73e01a99-5cd7-4139-a149-9f2736ff2ar4/runPlaybook?api-version=2024-03-01

Örnek yanıt

Durum kodu:

204

Tanımlar

Name	Description
CloudError	Hata yanıtı yapısı.
CloudErrorBody	Hata ayrıntıları.
ManualTriggerRequestBody	Bir olayda playbook'u tetikleme isteği gövdesini açıklar.

CloudError

Hata yanıtı yapısı.

Name	Tür	Description
error	CloudErrorBody	Hata verileri

CloudErrorBody

Hata ayrıntıları.

Name	Tür	Description
code	string	Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message	string	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.

ManualTriggerRequestBody

Bir olayda playbook'u tetikleme isteği gövdesini açıklar.

Name	Tür	Description
logicAppsResourceId	string	Playbook kaynağının kaynak kimliği.
tenantId	string	Playbook kaynağının kiracı kimliği.