security iam task list

You can use iam task list command to fetch all enforcement tasks in the system, whenever IAM policies are attached/detached with specified identities.

Syntax

CLI
IMPORTANT
Resource task information is displayed only for Identity (IAM) Policies with Status - Enforcing, Enforced, Disarming, Disarmed. Resource Task with Stale Information such as any previous enforcement tasks associated with an IAM policy, transitioning to Status - Untagged, Tagged, Untracked is regularly deleted from database tables.
maprcli security iam task list [ -cluster <Cluster Name> | -policy <Policy Name> | -status <Task Status> ]

Parameters

Parameter Description
type (Optional) The resource type. Allowed values are cluster, policy or status.

Examples

Json

CLI

maprcli security iam task list -json
Example:
maprcli security iam task list -json
{
        "timestamp":1726151803004,
        "timeofday":"2024-09-12 07:36:43.004 GMT-0700 AM",
        "status":"OK",
        "total":6,
        "data":[
                {
                        "Id":"2.0.0",
                        "Resource":"urn:default:secondary:volume:vol-1",
                        "Status":"Success"
                },
                {
                        "Id":"2.1.0",
                        "Resource":"urn:default:primary:volume:vol-2",
                        "Status":"NotStarted"
                },
                {
                        "Id":"1.0.0",
                        "Resource":"urn:default:primary:volume:vol-1",
                        "Status":"Success"
                },
                {
                        "Id":"1.1.0",
                        "Resource":"urn:default:secondary:volume:vol-2",
                        "Status":"Success"
                },
                {
                        "Id":"2.2.0",
                        "Resource":"urn:default:primary:volume:vol-3",
                        "Status":"InProgress"
                },
                {
                        "Id":"1.2.0",
                        "Resource":"urn:default:secondary:volume:vol-3",
                        "Status":"Aborted"
                }
        ]
}

Filtering the Tasks

You can filter from all resource tasks associated with a cluster. For example:

  • Filter by Cluster

    CLI

    maprcli security iam task list -cluster <Cluster Name>
    Example:
    maprcli security iam task list -cluster primary -json
{
   "timestamp":1726152058255,
   "timeofday":"2024-09-12 07:40:58.255 GMT-0700 AM",
   "status":"OK",
   "total":3,
   "data":[
      {
         "Id":"2.1.0",
         "Resource":"urn:default:primary:volume:vol-2",
         "Status":"NotStarted"
      },
      {
         "Id":"1.0.0",
         "Resource":"urn:default:primary:volume:vol-1",
         "Status":"Success"
      },
      {
         "Id":"2.2.0",
         "Resource":"urn:default:primary:volume:vol-3",
         "Status":"InProgress"
      }
   ]
}
  • Filter by Policy

    CLI

    maprcli security iam task list -policy <Policy Name>
    Example:
    sudo maprcli security iam task list -policy policy1 -json
{
        "timestamp":1738060289052,
        "timeofday":"2025-01-28 02:31:29.052 GMT-0800 AM",
        "status":"OK",
        "total":1,
        "data":[
                {
                        "Id":"1.0.0",
                        "Update":"False",
                        "Resource":"urn:default:cluster1:volume:a5",
                        "Status":"NotStarted"
                }
        ]
}
  • Filter by Task Status

    CLI

    IMPORTANT
    Supported values for Task Status are - NotStarted, InProgress, Success, Error, Aborted.
    maprcli security iam task list -status <Task Status>
    Example:
    maprcli security iam task list -status Success -json
{
   "timestamp":1726151803004,
   "timeofday":"2024-09-12 07:36:43.004 GMT-0700 AM",
   "status":"OK",
   "total":6,
   "data":[
      {
         "Id":"2.0.0",
         "Resource":"urn:default:secondary:volume:vol-1",
         "Status":"Success"
      },
      {
         "Id":"1.0.0",
         "Resource":"urn:default:primary:volume:vol-1",
         "Status":"Success"
      },
      {
         "Id":"1.1.0",
         "Resource":"urn:default:secondary:volume:vol-2",
         "Status":"Success"
      }
   ]
}