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/v1/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
{
    "roleIds": [
        "a03f0db0-fc0b-4001-9c64-3cf0c7201741",
        "00000000-0000-0000-0000-000000000001"
    ]
}
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

The request was refused because it lacks valid authentication credentials. This can happen if the Authorization header was missing, or if it contained an invalid session ID.

Obtain a new session ID and retry the request, or make an unauthenticated request without the Authorization header.

"Invalid session ID"

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

The request was refused because the session ID has expired. Obtain a new session ID from /api/v1/sessions.

"Login Timeout"

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 '{}'
On This Page
User Groups Operations
GET
GET User Groups
POST
POST User Groups
GET
GET User Groups Provider
GET
GET User Groups Provider Domain Name
DELETE
DELETE User Groups Provider Domain Name
PATCH
PATCH User Groups Provider Domain Name