Assign Traversal Spec To User Group Using PUT

Traversal specifications assigned through this API will add the specified traversal specification to a role permission for the ReadOnly role. It will also update the user's existing role permissions with this traversal specification. This API is replaced by the assignRolePermissionToUser and unassignRolePermissionFromUser APIs which are PUT and DELETE operations respectively at the /auth/usergroups/{groupId}/permissions endpoint.Note: mixing current and deprecated APIs is not recommended and may result in undefined behavior.

Request

URI

PUT

https://{api_host}/api/auth/usergroups/{groupId}/traversalspecs

COPY

Path Parameters

string

groupId

Required

Identifier of the user group to which the traversal spec needs to be assigned

Request Body

The traversal specification to assign to the user group

traversal-spec-instance of type(s) application/json

Required

Show optional properties

{
    "adapterKind": "string",
    "name": "string"
}

{
    "adapterKind": "string",
    "includedAdapterKinds": [
        "string"
    ],
    "name": "string",
    "resourceKind": "string",
    "resourceSelection": [
        {
            "resourceId": [
                "string"
            ],
            "type": "string"
        }
    ],
    "selectAllResources": false
}

string

adapterKind

Required

The root Adapter kind of the Traversal Specification. Together with resourceKind and name these values uniquely identify the traversal specification used by this instance.

array of string

includedAdapterKinds

Optional

The adapter kinds that apply to this traversal specification instance. Only applicable for traversal specification templates with a filter type of ADAPTER_ASSOCIATION. If this is present, then all adapter instances of this kind are selected as part of the hierarchy.

string

name

Required

The name of the Traversal Specification. Together with adapterKind and resourceKind these values uniquely identify a traversal specification used by this instance.

string

resourceKind

Optional

The root Resource kind of the Traversal Specification. Together with adapterKind and name these values uniquely identify a traversal specification used by this instance.

array of ResourceSelection

resourceSelection

Optional

List of root resource id selections

boolean

selectAllResources

Optional

When flag is true system will ignore resource selections and include all resources in the tree defined by the traversal specification templat.

Authentication

This operation uses the following authentication methods.

vRealizeOpsToken

Responses