REredis
Roles

Create a new Redis Software role

Changed on

Create a new role with the provided configuration.

post/v1/roles

Request

  • Base URL
    https://localhost:9443
  • URL
    https://localhost:9443/v1/roles
  • Auth
    API key in header r-auth-user

Query parameters

dry_runboolean

Validate the request without persisting changes.

Request body

account_idinteger

Account ID. Only applicable to account-scoped roles.

management'none' | 'db_viewer' | 'cluster_viewer' | 'db_member' | 'cluster_member' | 'user_manager' | 'admin'

Name of the management role.

namestring

Role's name.

uidinteger

Optional uid to assign to the role.

Example request

{
  "management": "cluster_viewer",
  "name": "Support Engineer"
}

Response

Role created successfully.

account_idinteger

Account ID. Only applicable to account-scoped roles.

management'none' | 'db_viewer' | 'cluster_viewer' | 'db_member' | 'cluster_member' | 'user_manager' | 'admin' required

Name of the management role.

namestring required

Role's name.

uidinteger required

Role's unique uid.

Example response

{
  "management": "cluster_member",
  "name": "DBA",
  "uid": 1
}

Changes

  • 75fcb952f0c6Revision changes
    • warning

      removed the request property ////

    • warning

      removed the optional property //// from the response with the status

  • a19324f2815bRevision changes
    • breaking

      removed the enum value bdb of the request property //////

    • warning

      added the new db enum value to the ////// response property for the response status

    • info

      added the new db enum value to the request property //////

    • info

      removed the bdb enum value from the ////// response property for the response status