lifecycle_workflows_deleted_items_workflows
Creates, updates, deletes, gets or lists a lifecycle_workflows_deleted_items_workflows resource.
Overview
| Name | lifecycle_workflows_deleted_items_workflows |
| Type | Resource |
| Id | entra_id.identity_governance.lifecycle_workflows_deleted_items_workflows |
Fields
The following fields are returned by SELECT queries:
- get
- list
Retrieved navigation property
| Name | Datatype | Description |
|---|---|---|
id | string | Identifier used for individually addressing a specific workflow.Supports $filter(eq, ne) and $orderby. |
administrationScopeTargets | array | The administrative units in the scope of the workflow. Optional. Supports $expand. |
category | string | (joiner, leaver, unknownFutureValue, mover) (title: lifecycleWorkflowCategory) |
createdBy | object | The user who created the workflow. (title: entity) |
createdDateTime | string (date-time) | When a workflow was created. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$) |
deletedDateTime | string (date-time) | When the workflow was deleted.Supports $filter(lt, le, gt, ge, eq, ne) and $orderby. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$) |
description | string | A string that describes the purpose of the workflow. |
displayName | string | A string to identify the workflow. |
executionConditions | object | Defines when and for who the workflow will run. (title: workflowExecutionConditions) |
executionScope | array | The list of users that meet the workflowExecutionConditions of a workflow. |
isEnabled | boolean | Whether the workflow is enabled or disabled. If this setting is true, the workflow can be run on demand or on schedule when isSchedulingEnabled is true. |
isSchedulingEnabled | boolean | If true, the Lifecycle Workflow engine executes the workflow based on the schedule defined by tenant settings. Can't be true for a disabled workflow (where isEnabled is false). |
lastModifiedBy | object | The unique identifier of the Microsoft Entra identity that last modified the workflow. (title: entity) |
lastModifiedDateTime | string (date-time) | When the workflow was last modified. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$) |
nextScheduleRunDateTime | string (date-time) | The date time when the workflow is expected to run next based on the schedule interval, if there are any users matching the execution conditions. Supports $filter(lt,gt) and $orderby. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$) |
runs | array | Workflow runs. |
taskReports | array | Represents the aggregation of task execution data for tasks within a workflow object. |
tasks | array | The tasks in the workflow. |
userProcessingResults | array | Per-user workflow execution results. |
version | number (int32) | The current version number of the workflow. Value is 1 when the workflow is first created.Supports $filter(lt, le, gt, ge, eq, ne) and $orderby. |
versions | array | The workflow versions that are available. |
Retrieved collection
| Name | Datatype | Description |
|---|---|---|
id | string | Identifier used for individually addressing a specific workflow.Supports $filter(eq, ne) and $orderby. |
administrationScopeTargets | array | The administrative units in the scope of the workflow. Optional. Supports $expand. |
category | string | (joiner, leaver, unknownFutureValue, mover) (title: lifecycleWorkflowCategory) |
createdBy | object | The user who created the workflow. (title: entity) |
createdDateTime | string (date-time) | When a workflow was created. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$) |
deletedDateTime | string (date-time) | When the workflow was deleted.Supports $filter(lt, le, gt, ge, eq, ne) and $orderby. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$) |
description | string | A string that describes the purpose of the workflow. |
displayName | string | A string to identify the workflow. |
executionConditions | object | Defines when and for who the workflow will run. (title: workflowExecutionConditions) |
executionScope | array | The list of users that meet the workflowExecutionConditions of a workflow. |
isEnabled | boolean | Whether the workflow is enabled or disabled. If this setting is true, the workflow can be run on demand or on schedule when isSchedulingEnabled is true. |
isSchedulingEnabled | boolean | If true, the Lifecycle Workflow engine executes the workflow based on the schedule defined by tenant settings. Can't be true for a disabled workflow (where isEnabled is false). |
lastModifiedBy | object | The unique identifier of the Microsoft Entra identity that last modified the workflow. (title: entity) |
lastModifiedDateTime | string (date-time) | When the workflow was last modified. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$) |
nextScheduleRunDateTime | string (date-time) | The date time when the workflow is expected to run next based on the schedule interval, if there are any users matching the execution conditions. Supports $filter(lt,gt) and $orderby. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$) |
runs | array | Workflow runs. |
taskReports | array | Represents the aggregation of task execution data for tasks within a workflow object. |
tasks | array | The tasks in the workflow. |
userProcessingResults | array | Per-user workflow execution results. |
version | number (int32) | The current version number of the workflow. Value is 1 when the workflow is first created.Supports $filter(lt, le, gt, ge, eq, ne) and $orderby. |
versions | array | The workflow versions that are available. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | workflow_id | Retrieve a deleted workflow object. | |
list | select | Get a list of the deleted workflow objects and their properties. | ||
delete | delete | workflow_id | If-Match | Delete a workflow object. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
workflow_id | string | The unique identifier of workflow |
If-Match | string | ETag |
SELECT examples
- get
- list
Retrieve a deleted workflow object.
SELECT
id,
administrationScopeTargets,
category,
createdBy,
createdDateTime,
deletedDateTime,
description,
displayName,
executionConditions,
executionScope,
isEnabled,
isSchedulingEnabled,
lastModifiedBy,
lastModifiedDateTime,
nextScheduleRunDateTime,
runs,
taskReports,
tasks,
userProcessingResults,
version,
versions
FROM entra_id.identity_governance.lifecycle_workflows_deleted_items_workflows
WHERE workflow_id = '{{ workflow_id }}' -- required
;
Get a list of the deleted workflow objects and their properties.
SELECT
id,
administrationScopeTargets,
category,
createdBy,
createdDateTime,
deletedDateTime,
description,
displayName,
executionConditions,
executionScope,
isEnabled,
isSchedulingEnabled,
lastModifiedBy,
lastModifiedDateTime,
nextScheduleRunDateTime,
runs,
taskReports,
tasks,
userProcessingResults,
version,
versions
FROM entra_id.identity_governance.lifecycle_workflows_deleted_items_workflows
;
DELETE examples
- delete
Delete a workflow object.
DELETE FROM entra_id.identity_governance.lifecycle_workflows_deleted_items_workflows
WHERE workflow_id = '{{ workflow_id }}' --required
AND If-Match = '{{ If-Match }}'
;