Systems - Report Action Status

Serviço:

Sentinel

Versão da API:

2025-04-01-preview

Informe o status da ação.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/businessApplicationAgents/{agentResourceName}/systems/{systemResourceName}/reportActionStatus?api-version=2025-04-01-preview

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
agentResourceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9,-]*$	Nome do agente de aplicativo de negócios
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
systemResourceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9,-]*$	O nome do sistema.
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	O nome do espaço de trabalho.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Tipo	Description
actionId	string	O ID da ação a ser executada
actionStatus	string	O status da ação que foi executada pelo agente
failureReason	string	O motivo do insucesso da ação. Vazio se a ação for bem-sucedida.

Respostas

Name	Tipo	Description
204 No Content		Sem conteúdo
Other Status Codes	CloudError	Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

ReportActionStatus

Pedido de amostra

HTTP

POST https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/businessApplicationAgents/247b377a-7137-4b3c-bf15-df1d3260ef1b/systems/3d69632b-0b60-4af3-8720-77f01a25d34a/reportActionStatus?api-version=2025-04-01-preview

Resposta da amostra

Código de estado:

204

Definições

Name	Description
CloudError	Estrutura de resposta a erros.
CloudErrorBody	Detalhes do erro.
ReportActionStatusPayload	Relatar o status de uma ação executada pelo agente

CloudError

Object

Estrutura de resposta a erros.

Name	Tipo	Description
error	CloudErrorBody	Dados de erro

CloudErrorBody

Object

Detalhes do erro.

Name	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
message	string	Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.

ReportActionStatusPayload

Object

Relatar o status de uma ação executada pelo agente

Name	Tipo	Description
actionId	string	O ID da ação a ser executada
actionStatus	string	O status da ação que foi executada pelo agente
failureReason	string	O motivo do insucesso da ação. Vazio se a ação for bem-sucedida.