PATCH User Groups Provider Domain Name

PATCH User Groups Provider Domain Name

Replace existing roles of user group with the provided roles.

Request
URI
PATCH
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 provider, the 'name' parameter must also include the domain. Example '.../user-groups/vidm/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


Request Body
user.groups.post.get.patch.response of type(s) application/json
Optional
{
    "userGroup": {
        "provider": "ad",
        "domain": "vmware.com",
        "name": "directoryGroupName",
        "roleIds": [
            "a03f0db0-fc0b-4001-9c64-3cf0c7201741"
        ]
    }
}
Authentication
This operation uses the following authentication methods.
Responses
200

Successfully replaced user group roles.

Operation doesn't return any data structure

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 exist.

Operation doesn't return any data structure

422

Workspace ONE Access or Active Directory configuration is not enabled

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 -X PATCH -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]'