security iam task list

Lists all enforcement tasks in the system.

Syntax

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

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> ]
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
    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 Cluster
    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
    maprcli security iam task list -policy <Policy Name>
    Example:
    maprcli security iam task list -policy AllowVol -json
{
        "timestamp":1726152145788,
        "timeofday":"2024-09-12 07:42:25.788 GMT-0700 AM",
        "status":"OK",
        "total":3,
        "data":[
                {
                        "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":"1.2.0",
                        "Resource":"urn:default:secondary:volume:vol-3",
                        "Status":"Aborted"
                }
        ]
}
  • Filter by Task Status
    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"
                }
        ]
}