GET User Groups Provider Domain Name

GET User Groups Provider Domain Name

Retrieves the user group information.

Request
URI
GET
https://{api_host}/api/v2/user-groups/{provider}/{domain}/{name}
COPY
Path Parameters
string
name
Required

Group name in the authentication source. For the VIDM or VIDB provider, the 'name' parameter must also include the domain. Example '.../user-groups/vidm/vmware.com/[email protected]', '.../user-groups/vidb/vmware.com/[email protected]' or '.../user-groups/ad/vmware.com/users

string
domain
Required

Authentication group domain.

string
provider
Required

Authentication provider. Should be ad or vidm


Authentication
This operation uses the following authentication methods.
Responses
200

Successfully retrieved user group information.

Returns user.groups.post.get.patch.response of type(s) application/json
{
    "userGroup": {
        "provider": "ad",
        "domain": "vmware.com",
        "name": "directoryGroupName",
        "roleIds": [
            "a03f0db0-fc0b-4001-9c64-3cf0c7201741"
        ]
    }
}

400

Authentication group provider should have one of following values - 'ad','vidm'

Operation doesn't return any data structure

401
Operation doesn't return any data structure

404

Specified user group does not exists.

Operation doesn't return any data structure

440
Operation doesn't return any data structure

500

Internal error while processing the client request

Returns error of type(s) application/json
{
    "errorMessage": "The operation failed due to an internal error."
}
string
errorMessage
Required

A message describing the error.

string
errorCode
Optional

A code representing the type of error.

Possible values are : LIMIT_ERROR, FIELD_ERROR, TEST_ERROR, JSON_FORMAT_ERROR, LICENSE_ERROR, VSPHERE_INTEGRATION_ERROR, VROPS_INTEGRATION_ERROR, UPGRADE_ERROR, SEARCH_ERROR, AGENT_ERROR, RBAC_COMMON_ERROR, RBAC_USERS_ERROR, RBAC_GROUPS_ERROR, RBAC_ADGROUPS_ERROR, RBAC_DATASETS_ERROR, RBAC_VIDM_GROUPS_ERROR, RBAC_VIDB_GROUPS_ERROR, SECURITY_ERROR, DEPLOYMENT_ERROR, SUPPORT_BUNDLE_ERROR, LOAD_BALANCER_ERROR, VIDM_ERROR, VIDB_ERROR, QUERY_ERROR, SSL_CERTIFICATE_ERROR, PROXY_ERROR,
object
errorDetails
Optional

Dynamic error details, where the field name can vary depending on the request field and error code.


Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/api/v2/user-groups/{provider}/{domain}/{name}