Reorder directory mappings

This method modifies the order of all mappings that belong to a certain directory.

Modifying the order of the mappings changes their priority.

To run this Web service, you must be a member of the Vault Admins group and have the following permissions:

  • Audit users
  • Add/Update users
  • Manage Directory mappings

URL

  • Make sure there are no spaces in the URL.

  • The following characters are not supported in URL values: + & %

  • If the URL includes a dot (.), add a forward slash (/) at the end of the URL. For example: api/Safes/MySafe/Members/user@cyber.com/

 

 
https://<IIS_Server_Ip>/PasswordVault/API/Configuration/LDAP/Directories/{DirectoryName}/Mappings/Reorder/

The following mandatory value is required in the URL:

Parameter

Description

DirectoryName

The name of the directory you want to reorder.

Type: string

Resource information

HTTP method

POST

Content type

application/json

Header parameter

Parameter

Description

Authorization

The token that identifies the session, encoded in BASE 64. See Authentication.

Type: String

Mandatory: Yes

Default value: None

Body parameters

 
{
"MappingsOrder": [<mapping id 1>, <mapping id 2>, ..., <mapping id n> ]
}

 

Parameter

Description

mappingsOrder

(Mandatory) The new order of the mappings, sorted by importance.

Must include all mappings.

Each ID can only appear once.

Type: Array of IDs

Result

None

Return codes

For a complete list of return codes, see Return Codes.