GET /spacct/auth_test

Examples

If the authorization information provided in the HTTP request headers is valid,
the response will be:

  200 OK
  {
    "message": null,
    "result": null
  }

otherwise it will be:

  401 Unauthorized
  {
    "message": null,
    "result": null
  }

GET /spacct/v1/users/resource/<resource>

Examples

This example was generated 2021-02-20 11:45am
This lists all active users ("status": "active") and inactive users ("status": "inactive") where the inactivation happened less than 365 days ago
NB: grace=0 will only show active users
NB: grace defaults to the MyProxy single-signon inactive grace period.
NB: the result is truncated. It originally had about 5000 users
NB: it is possible for a user to have multiple usernames (see personId 5552)
NB: it is possible for a user to have multiple sitePersonIds (see personId 14506)
NB: is is possible for a user to have no active DNs (see Community User personId 46294)

GET /spacct/v1/users/resource/comet.sdsc.xsede?grace=365
{
    "message": null,
    "result": {
        "resource": "comet.sdsc.xsede",
        "site": "SDSC",
        "users": [
            {
                "activeDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/CN=Neal Stephen McKenney",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=Neal Stephen McKenney"
                ],
                "firstName": "Neal",
                "inactiveDNs": [],
                "lastName": "McKenney",
                "personId": 70440,
                "portalLogin": "nmckenne",
                "sitePersonIds": [
		   "108837"
		],
                "status": "active",
                "statusTime": "2018-10-08T13:29:05.495+00:00",
                "usernames": [
                    "nmckenne"
                ]
            },
            {
                "activeDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/CN=Jessica Reilly",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=Jessica Reilly"
                ],
                "firstName": "Jessica",
                "inactiveDNs": [],
                "lastName": "Reilly",
                "personId": 85506,
                "portalLogin": "reillyj",
                "sitePersonIds": [
		   "118217"
		],
                "status": "inactive",
                "statusTime": "2020-03-18T01:01:29.659+00:00",
                "usernames": [
                    "reillyj"
                ]
            },
            {
                "activeDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/CN=Pete Riley",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=Pete Riley"
                ],
                "firstName": "Pete",
                "inactiveDNs": [
                    "/C=US/O=Pittsburgh Supercomputing Center/OU=PSC Kerberos Certification Authority/CN=priley/UID=priley/emailAddress=priley@PSC.EDU",
                    "/C=US/O=National Center for Supercomputing Applications/OU=People/CN=Pete Riley",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=UT-AUSTIN/O=TACC Classic CA/CN=Pete Riley",
                    "/DC=EDU/DC=TENNESSEE/DC=NICS/O=National Institute for Computational Sciences/CN=Pete Riley"
                ],
                "lastName": "Riley",
                "personId": 1131,
                "portalLogin": "priley",
                "sitePersonIds": [
		   "15394"
		],
                "status": "active",
                "statusTime": "2015-10-08T16:48:36.567+00:00",
                "usernames": [
                    "ux451672"
                ]
            },
            {
                "activeDNs": [
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=MYPROXY/CN=train184",
                    "/C=US/O=National Center for Supercomputing Applications/CN=account train184",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=account train184"
                ],
                "firstName": "account",
                "inactiveDNs": [
                    "/DC=EDU/DC=TENNESSEE/DC=NICS/O=National Institute for Computational Sciences/CN=account train184",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=UT-AUSTIN/O=TACC MICS CA/CN=account train184",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=UT-AUSTIN/O=TACC Classic CA/CN=account train184"
                ],
                "lastName": "train184",
                "personId": 43356,
                "portalLogin": "train184",
                "sitePersonIds": [
		   "93214"
		],
                "status": "active",
                "statusTime": "2017-07-19T20:23:34.210+00:00",
                "usernames": [
                    "xdtr184"
                ]
            },
            {
                "activeDNs": [],
                "firstName": "zhanglab",
                "inactiveDNs": [],
                "lastName": "Community User",
                "personId": 46294,
                "portalLogin": "zhanglab",
                "sitePersonIds": [
		   "95139"
		],
                "status": "active",
                "statusTime": "2016-11-18T15:43:26.390+00:00",
                "usernames": [
                    "zhanglab"
                ]
            },
	    {
                "activeDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/CN=Walter Landry",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=Walter Landry",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=MYPROXY/CN=tg458568"
                ],
                "firstName": "Walter",
                "inactiveDNs": [
                    "/C=US/O=Pittsburgh Supercomputing Center/OU=PSC Kerberos Certification Authority/CN=wlandry/UID=wlandry/emailAddress=wlandry@PSC.EDU",
                    "/C=US/O=National Center for Supercomputing Applications/OU=People/CN=Walter Landry",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=UT-AUSTIN/O=TACC MICS CA/CN=Walter Landry",
                    "/DC=EDU/DC=TENNESSEE/DC=NICS/O=National Institute for Computational Sciences/CN=Walter Landry"
                ],
                "lastName": "Landry",
                "personId": 5552,
                "portalLogin": "wlandry",
                "sitePersonIds": [
		   "6769"
		],
                "status": "active",
                "statusTime": "2019-06-14T18:06:09.378+00:00",
                "usernames": [
                    "wlandry",
                    "ux450362"
                ]
            },
            {
                "activeDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/CN=Buddhadev Maiti 1",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=Buddhadev Maiti 1",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=MYPROXY/CN=tg866565",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=Buddhadev Maiti",
                    "/C=US/O=National Center for Supercomputing Applications/CN=Buddhadev Maiti"
                ],
                "firstName": "Buddhadev",
                "inactiveDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/OU=People/CN=Buddhadev Maiti",
                    "/DC=EDU/DC=TENNESSEE/DC=NICS/O=National Institute for Computational Sciences/CN=Buddhadev Maiti"
                ],
                "lastName": "Maiti",
                "personId": 14506,
                "portalLogin": "bmaiti",
                "sitePersonIds": [
                    "122417",
                    "78708"
                ],
                "status": "active",
                "statusTime": "2020-04-10T13:58:53.140-07:00",
                "usernames": [
                    "bmaiti20"
                ]
            },
        ]
    }
}

Params

Param name Description
grace
optional

grace period in days

Validations:

  • Must be a Integer


GET /spacct/v1/projects/resource/<resource>?active_only

Examples

GET /spacct/v1/projects/resource/osn.osn.xsede.org?active_only
{
    "message": null,
    "result": {
        "projects": [
            {
                "chargeNumber": "TG-BIO210048",
                "projectState": "active",
                "proposalNumber": "BIO210048",
                "roles": [
                    {
                        "firstName": "Aaron",
                        "lastName": "Turkewitz",
                        "portalLogin": "apturkew",
                        "role": "pi",
                        "sitePersonId": "2a1e33df-21e0-47e2-98ea-733fd1d5e949",
                        "userNames": [
                            "apturkew@xsede.org"
                        ]
                    },
                    {
                        "firstName": "Lev",
                        "lastName": "Tsypin",
                        "portalLogin": "ltsypin",
                        "role": "co_pi",
                        "sitePersonId": "6a7ae711-bf5d-4747-8581-2a655beb9cf1",
                        "userNames": [
                            "ltsypin@xsede.org"
                        ]
                    }
                ],
                "siteProjectId": "BIO210048_Aaron_Turkewitz"
            },
            {
                "chargeNumber": "TG-CHM210003",
                "projectState": "active",
                "proposalNumber": "CHM210003",
                "roles": [
                    {
                        "firstName": "Guy",
                        "lastName": "Mongelli",
                        "portalLogin": "gfm12",
                        "role": "pi",
                        "sitePersonId": "f082811a-a027-4777-8268-f587be3c374c",
                        "userNames": [
                            "gfm12@xsede.org"
                        ]
                    }
                ],
                "siteProjectId": "CHM210003_Guy_Mongelli"
            },
            {
                "chargeNumber": "TG-CIS210058",
                "projectState": "active",
                "proposalNumber": "CIS210058",
                "roles": [
                    {
                        "firstName": "James",
                        "lastName": "Culbert",
                        "portalLogin": "culbertj",
                        "role": "pi",
                        "sitePersonId": "b5c3fa42-43a7-4026-9309-ff543d2aeb52",
                        "userNames": [
                            "culbertj@xsede.org"
                        ]
                    },
                    {
                        "firstName": "Julie",
                        "lastName": "Ma",
                        "portalLogin": "julietma",
                        "role": "allocation_manager",
                        "sitePersonId": "e093e227-f3cd-4bfb-bd02-265af7f2d052",
                        "userNames": [
                            "julietma@xsede.org"
                        ]
                    }
                ],
                "siteProjectId": "CIS210058_James_Culbert"
            },
            {
                "chargeNumber": "TG-PHY170051",
                "projectState": "active",
                "proposalNumber": "PHY170051",
                "roles": [
                    {
                        "firstName": "Luca",
                        "lastName": "Grandi",
                        "portalLogin": "lgrandi",
                        "role": "pi",
                        "sitePersonId": "e7b68d1b-4b39-4a8d-9df6-f4dbbc1ef0d7",
                        "userNames": [
                            "lgrandi@xsede.org"
                        ]
                    },
                    {
                        "firstName": "Open Science Grid",
                        "lastName": "Community User",
                        "portalLogin": "osg",
                        "role": "community_user",
                        "sitePersonId": "0576b669-ad95-45fe-85ae-0ac83d6ca064",
                        "userNames": [
                            "osg@xsede.org"
                        ]
                    },
                    {
                        "firstName": "Evan",
                        "lastName": "Shockley",
                        "portalLogin": "shockley",
                        "role": "co_pi",
                        "sitePersonId": "a7e92fe5-4185-4e34-a10b-7e08692ba392",
                        "userNames": [
                            "shockley@xsede.org"
                        ]
                    }
                ],
                "siteProjectId": "PHY170051_Luca_Grandi"
            },
            {
                "chargeNumber": "TG-PHY150040",
                "projectState": "active",
                "proposalNumber": "PHY150040",
                "roles": [
                    {
                        "firstName": "Francis",
                        "lastName": "Halzen",
                        "portalLogin": "fhalzen",
                        "role": "pi",
                        "sitePersonId": "9ffe269d-cf6e-433a-9ed3-079dd75158a0",
                        "userNames": [
                            "fhalzen@xsede.org"
                        ]
                    }
                ],
                "siteProjectId": "PHY150040_Francis_Halzen"
            },
            {
                "chargeNumber": "TG-INI210004",
                "projectState": "active",
                "proposalNumber": "INI210004",
                "roles": [
                    {
                        "firstName": "Tom",
                        "lastName": "Morrell",
                        "portalLogin": "tmorrell",
                        "role": "pi",
                        "sitePersonId": "1636abcb-dcee-473c-9a39-ee83b3f3feca",
                        "userNames": [
                            "tmorrell@xsede.org"
                        ]
                    }
                ],
                "siteProjectId": "INI210004_Tom_Morrell"
            },
            {
                "chargeNumber": "TG-BIO210083",
                "projectState": "active",
                "proposalNumber": "BIO210083",
                "roles": [
                    {
                        "firstName": "Yifan",
                        "lastName": "Liu",
                        "portalLogin": "yifantet",
                        "role": "pi",
                        "sitePersonId": "27d91768-3429-495a-8648-1f3b9fbc6fd8",
                        "userNames": [
                            "yifantet@xsede.org"
                        ]
                    },
                    {
                        "firstName": "Wentao",
                        "lastName": "Yang",
                        "portalLogin": "wentao1990",
                        "role": "allocation_manager",
                        "sitePersonId": "e9b0c4f6-c411-4992-8c09-e66d8154b2c5",
                        "userNames": [
                            "wentao1990@xsede.org"
                        ]
                    }
                ],
                "siteProjectId": "BIO210083_Yifan_Liu"
            },
            {
                "chargeNumber": "TG-BIO210089",
                "projectState": "active",
                "proposalNumber": "BIO210089",
                "roles": [
                    {
                        "firstName": "Karthickeyan",
                        "lastName": "Chella Krishnan",
                        "portalLogin": "chellakn",
                        "role": "pi",
                        "sitePersonId": "462c18dd-eb4a-480f-a7e2-da6c5077776a",
                        "userNames": [
                            "chellakn@xsede.org"
                        ]
                    }
                ],
                "siteProjectId": "BIO210089_Karthickeyan_Chella Krishnan"
            },
            {
                "chargeNumber": "TG-PHY200093",
                "projectState": "active",
                "proposalNumber": "PHY200093",
                "roles": [
                    {
                        "firstName": "Peter",
                        "lastName": "Jacobs",
                        "portalLogin": "pmjacobs",
                        "role": "pi",
                        "sitePersonId": "263011e2-128e-4146-9c27-ff864211e84c",
                        "userNames": [
                            "pmjacobs@xsede.org"
                        ]
                    },
                    {
                        "firstName": "Yi",
                        "lastName": "Chen",
                        "portalLogin": "chenyi",
                        "role": "allocation_manager",
                        "sitePersonId": "e0f13695-8b97-406e-9ae8-d5987399d782",
                        "userNames": [
                            "chenyi@xsede.org"
                        ]
                    },
                    {
                        "firstName": "Abhijit",
                        "lastName": "Majumder",
                        "portalLogin": "majumder",
                        "role": "allocation_manager",
                        "sitePersonId": "03413fd0-61ac-4978-86a6-2ffbac3b4d3e",
                        "userNames": [
                            "majumder@xsede.org"
                        ]
                    },
                    {
                        "firstName": "Jean-Francois",
                        "lastName": "Paquet",
                        "portalLogin": "jfpaquet",
                        "role": "allocation_manager",
                        "sitePersonId": "fdd8f55f-aa1e-41fa-b337-b3864485ce45",
                        "userNames": [
                            "jfpaquet@xsede.org"
                        ]
                    },
                    {
                        "firstName": "Amit",
                        "lastName": "Kumar",
                        "portalLogin": "amit24",
                        "role": "allocation_manager",
                        "sitePersonId": "87b65eda-90a0-480a-8fd0-5761f4066a5b",
                        "userNames": [
                            "amit24@xsede.org"
                        ]
                    },
                    {
                        "firstName": "James",
                        "lastName": "Mulligan",
                        "portalLogin": "jdmul",
                        "role": "allocation_manager",
                        "sitePersonId": "484b9344-23f9-42fe-941f-7758dcb83678",
                        "userNames": [
                            "jdmul@xsede.org"
                        ]
                    },
                    {
                        "firstName": "Raymond",
                        "lastName": "Ehlers",
                        "portalLogin": "rehlersi",
                        "role": "allocation_manager",
                        "sitePersonId": "b43a56da-7614-4cb6-b835-4bf79f244ea1",
                        "userNames": [
                            "rehlersi@xsede.org"
                        ]
                    },
                    {
                        "firstName": "Chun",
                        "lastName": "Shen",
                        "portalLogin": "chunshen",
                        "role": "allocation_manager",
                        "sitePersonId": "77b2cd64-99e7-40c9-aa67-1b024d4723a3",
                        "userNames": [
                            "chunshen@xsede.org"
                        ]
                    }
                ],
                "siteProjectId": "PHY200093_Peter_Jacobs"
            }
        ],
        "resource": "osn.osn.xsede.org",
        "site": "OSN"
    }
}