Skip to content

client.remediations

Access remediation tasks and their machine references.

Property

client.remediations

Methods

  • get_all(query: RemediationQuery | None = None) -> RemediationResults: list remediation tasks.
  • get(id: str) -> RemediationResults: fetch one remediation task by ID.
  • machinereferences(id: str) -> MachineReferencesResults: fetch machine references for a remediation task.

Notes

  • The relationship method is currently named machinereferences in lowercase.

API

RemediationQuery

Query parameters for the /api/remediationtasks endpoint.

RemediationResults

RemediationResults(
    endpoint: BaseEndpoint,
    params: dict[str, str],
    *,
    path: str | None = None,
    single: bool = False,
    files: bool = False,
    method: str = "GET",
    request_kwargs: dict[str, Any] | None = None,
    use_concurrent_skip_pagination: bool | None = None,
    skip_page_size: int | None = None,
    skip_max_concurrent: int | None = None,
)

Results from the /api/remediationtasks endpoint.

RemediationEndpoint

RemediationEndpoint(http: Client, auth: MSALAuth)

Endpoint for /api/remediationtasks.

get_all

get_all(
    query: RemediationQuery | None = None,
) -> RemediationResults

Get remediation tasks

Docs: https://learn.microsoft.com/en-us/defender-endpoint/api/get-remediation-tasks

get

get(id: str) -> RemediationResults

Get remediation task by ID

Docs: https://learn.microsoft.com/en-us/defender-endpoint/api/get-remediation-task

machinereferences

machinereferences(id: str) -> MachineReferencesResults

Get machine references for a remediation task

Docs: https://learn.microsoft.com/en-us/defender-endpoint/api/get-machinereferences-remediationtask