Import external users

Description

Import users from your active directory/LDAP into CloudShell.

HTTP method

POST

Request

URL

http://{Admin API IP}:{port#}/api/v1/integrations/IdentityManagement/users

Request body

Parameter	Description/Comments
UserName	External user name. Can be retrieved via Get users from an external group or Get users from an external group.
GroupName	External group name. Can be retrieved via Get all external groups. Tip: You should import by group name for larger organizations containing hundreds of users as importing all users may fail due to active directory/LDAP limitations.

By group name:

{
  "GroupName": "Azure_DevOps_Cloud_Admins"
}

Response

Response example

{
    "Users": [
        {
            "Id": 11,
            "Sid": "750ad20a-ccf7-4185-a1d9-9202bd108f71",
            "Username": "automationuser",
            "Email": null,
            "IsActive": true,
            "IsAdmin": false,
            "GroupIds": [
                1
            ],
            "TimeZoneInfoId": null,
            "MaxReservationDuration": 1440,
            "MaxConcurrentReservations": 10,
            "MaxScheduledSandboxes": 10,
            "MaxOwnedBlueprints": 10,
            "MaxSavedSandboxes": null,
            "DomainRoles": [],
            "DomainName": "QUALISYSTEMS",
            "ImportedSid": "S-1-5-21-1487810946-2753822684-3978873285-7293"
        }
    ],
    "Errors": []
}