GET /acdb/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 /acdb/spacct/v2/users/resource/<resource>

Examples

This example was generated 2021-07-26 2pm
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/v2/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=Pete Riley",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=Pete Riley"
                ],
                "city": "San Diego",
                "country": "United States",
                "email": "pete@predsci.com",
                "firstName": "Pete",
                "inactiveDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/OU=People/CN=Pete Riley",
                    "/C=US/O=Pittsburgh Supercomputing Center/OU=PSC Kerberos Certification Authority/CN=priley/UID=priley/emailAddress=priley@PSC.EDU",
                    "/C=US/O=Pittsburgh Supercomputing Center/OU=PSC Kerberos Certification Authority/CN=priley/UID=priley/Email=priley@PSC.EDU",
                    "/C=US/O=Pittsburgh Supercomputing Center/OU=PSC Kerberos Certification Authority/CN=priley/UID=priley/EMAIL=priley@PSC.EDU",
                    "/C=US/O=Pittsburgh Supercomputing Center/OU=PSC Kerberos Certification Authority/CN=priley/UID=priley/E=priley@PSC.EDU",
                    "/C=US/O=Pittsburgh Supercomputing Center/OU=PSC Kerberos Certification Authority/CN=priley/USERID=priley/Email=priley@PSC.EDU",
                    "/C=US/O=Pittsburgh Supercomputing Center/OU=PSC Kerberos Certification Authority/CN=priley/USERID=priley/EMAIL=priley@PSC.EDU",
                    "/DC=EDU/DC=TENNESSEE/DC=NICS/O=National Institute for Computational Sciences/CN=Pete Riley",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=UT-AUSTIN/O=TACC Classic CA/CN=Pete Riley",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=UT-AUSTIN/O=TACC MICS CA/CN=Pete Riley"
                ],
                "lastName": "Riley",
                "personId": 1131,
                "phone": "858-217-5868",
                "portalLogin": "priley",
                "sitePersonIds": [
                    "15394"
                ],
                "state": "California",
                "status": "active",
                "statusTime": "2015-10-08T16:48:36.567+00:00",
                "street1": "9990 Mesa Rim Road",
                "street2": "Suite 170",
                "street3": null,
                "usernames": [
                    "ux451672"
                ],
                "zipcode": "92121"
            },
            {
                "activeDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/CN=account train184",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=account train184",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=MYPROXY/CN=train184"
                ],
                "city": "Champaign",
                "country": "United States",
                "email": "train184@ncsa.uiuc.edu",
                "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 Classic CA/CN=account train184",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=UT-AUSTIN/O=TACC MICS CA/CN=account train184"
                ],
                "lastName": "train184",
                "personId": 43356,
                 "phone": null,
                "portalLogin": "train184",
                "sitePersonIds": [
                    "93214"
                ],
                "state": "Illinois",
                "status": "inactive",
                "statusTime": "2021-01-18T02:02:09.000+00:00",
                "street1": "152 CAB  MC-476",
                "street2": "605 E. Springfield Ave.",
                "street3": null,
                "usernames": [
                    "xdtr184"
                ],
                "zipcode": "61820"
            },
            {
                "activeDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/CN=Kaze Wong",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=Kaze Wong",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=MYPROXY/CN=tg866800"
                ],
                "city": "Baltimore",
                "country": "United States",
                "email": "kazewong@jhu.edu",
                "firstName": "Kaze",
                "inactiveDNs": [],
                "lastName": "Wong",
                "personId": 91131,
                "phone": "4435092894",
                "portalLogin": "kazewong",
                "sitePersonIds": [
                    "123097"
                ],
                "state": "Maryland",
                "status": "inactive",
                "statusTime": "2021-01-02T06:30:01.944+00:00",
                "street1": "3701 San Martin Drive",
                "street2": "Bloomberg 366",
                "street3": null,
                "usernames": [
                    "kazewong"
                ],
                "zipcode": "21218"
            },
            {
                "activeDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/CN=Neal Stephen McKenney",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=Neal Stephen McKenney"
                ],
                "city": "Marietta",
                "country": "United States",
                "email": "mckenneyns@gmail.com",
                "firstName": "Neal",
                "inactiveDNs": [],
                "lastName": "McKenney",
                "personId": 70440,
                "phone": "319-270-5232",
                "portalLogin": "nmckenne",
                "sitePersonIds": [
                    "108837"
                ],
                "state": "Georgia",
                "status": "inactive",
                "statusTime": "2020-10-02T05:30:01.832+00:00",
                "street1": "2721 Zachary Lake Dr. SW",
                "street2": "",
                "street3": null,
                "usernames": [
                    "nmckenne"
                ],
                "zipcode": "30064"
            },
            {
                "activeDNs": [],
                "city": "Ann Arbor",
                "country": "United States",
                "email": "zhng@umich.edu",
                "firstName": "zhanglab",
                "inactiveDNs": [],
                "lastName": "Community User",
                "personId": 46294,
                "phone": "734-647-1549",
                "portalLogin": "zhanglab",
                "sitePersonIds": [
                    "95139"
                ],
                "state": null,
                "status": "inactive",
                "statusTime": "2020-11-30T02:02:15.952+00:00",
                "street1": "100 Washtenaw Avenue ",
                "street2": "Ann Arbor, MI 48109-2218",
                "street3": null,
                "usernames": [
                    "zhanglab"
                ],
                "zipcode": null
            },
            {
                "activeDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/CN=Buddhadev Maiti",
                    "/C=US/O=National Center for Supercomputing Applications/CN=Buddhadev Maiti 1",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=Buddhadev Maiti",
                    "/C=US/O=Pittsburgh Supercomputing Center/CN=Buddhadev Maiti 1",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=MYPROXY/CN=tg866565"
                ],
                "city": "Atlanta",
                "country": "United States",
                "email": "bmaiti@gsu.edu",
                "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,
                "phone": "401-413-5529",
                "portalLogin": "bmaiti",
                "sitePersonIds": [
                    "122417",
                    "78708"
                ],
                "state": "Georgia",
                "status": "active",
                "statusTime": "2020-04-10T20:58:53.140+00:00",
                "street1": "P.O. Box 4098",
                "street2": null,
                "street3": null,
                "usernames": [
                    "bmaiti20"
                ],
                "zipcode": "30302-4098"
            },
            {
                "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"
                ],
                "city": "Pasadena",
                "country": "United States",
                "email": "wlandry@caltech.edu",
                "firstName": "Walter",
                "inactiveDNs": [
                    "/C=US/O=National Center for Supercomputing Applications/OU=People/CN=Walter Landry",
                    "/C=US/O=Pittsburgh Supercomputing Center/OU=PSC Kerberos Certification Authority/CN=wlandry/UID=wlandry/emailAddress=wlandry@PSC.EDU",
                    "/C=US/O=Pittsburgh Supercomputing Center/OU=PSC Kerberos Certification Authority/CN=wlandry/UID=wlandry/E=wlandry@PSC.EDU",
                    "/C=US/O=Pittsburgh Supercomputing Center/OU=PSC Kerberos Certification Authority/CN=wlandry/USERID=wlandry/Email=wlandry@PSC.EDU",
                    "/DC=EDU/DC=TENNESSEE/DC=NICS/O=National Institute for Computational Sciences/CN=Walter Landry",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=UT-AUSTIN/O=TACC Classic CA/CN=Walter Landry",
                    "/DC=EDU/DC=UTEXAS/DC=TACC/O=UT-AUSTIN/O=TACC MICS CA/CN=Walter Landry"
                ],
                "lastName": "Landry",
                "personId": 5552,
                "phone": "626-395-6554",
                "portalLogin": "wlandry",
                "sitePersonIds": [
                    "6769"
                ],
                "state": "California",
                "status": "active",
                "statusTime": "2019-06-14T18:06:09.378+00:00",
                "street1": "Caltech MC 452-48",
                "street2": "1200 E. California Blvd",
                "street3": null,
                "usernames": [
                    "wlandry",
                    "ux450362"
                ],
                "zipcode": "91125"
            }
        ]
    }
}

Params

Param name Description
grace
optional

grace period in days

Validations:

  • Must be a Integer


GET /acdb/spacct/v2/user/by_portal_login/<portal_login>

Examples

GET /spacct/v2/user/by_portal_login/mshapiro
{
    "message": null,
    "result": {
        "personId": 150,
        "firstName": "Michael",
        "lastName": "Shapiro",
        "portalLogin": "mshapiro",
        "street1": "MC 257 - 1008 NCSA",
        "street2": "1205 W. Clark St.",
        "street3": null,
        "city": "Urbana",
        "zipcode": "61801",
        "state": "Illinois",
        "country": "United States",
        "email": "shapiro2@illinois.edu",
        "phone": "217-244-1514",
        "isSuspended": false
    }
}

GET /acdb/spacct/v2/projects/resource/<resource>?active_only

Examples

GET /spacct/v2/projects/resource/anton2.psc.xsede?active_only
{
    "message": null,
    "result": {
        "projects": [
            {
                "grantNumber": "MCB200150",
                "projectState": "active",
                "roles": [
                    {
                        "firstName": "Giulia",
                        "lastName": "Palermo",
                        "portalLogin": "gpalermo",
                        "role": "pi",
                        "sitePersonId": "PALERMOAP",
                        "userNames": [
                            "palermo"
                        ]
                    }
                ],
                "siteProjectId": "MCB200046P"
            },
            {
                "grantNumber": "MCB200169",
                "projectState": "active",
                "roles": [
                    {
                        "firstName": "Gregory",
                        "lastName": "Voth",
                        "portalLogin": "voth",
                        "role": "pi",
                        "sitePersonId": "VOTHGREGP",
                        "userNames": [
                            "voth",
			    "gvoth"
                        ]
                    },
                    {
                        "firstName": "Viviana",
                        "lastName": "Monje",
                        "portalLogin": "vmonje",
                        "role": "allocation_manager",
                        "sitePersonId": "MONJE-GAP",
                        "userNames": [
                            "vmonje"
                        ]
                    }
                ],
                "siteProjectId": "MCB200056P"
            }
        ],
        "resource": "anton2.psc.xsede",
        "site": "PSC"
    }
}