security iam task list

Lists all enforcement tasks in the system.

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> ]

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 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:
    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

    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"
                }
        ]
}