Version:

/create/role

URL: http://GPUDB_IP_ADDRESS:GPUDB_PORT/create/role

Creates a new role.

Input Parameter Description

Name Type Description
name string Name of the role to be created. Must contain only lowercase letters, digits, and underscores, and cannot begin with a digit. Must not be the same name as an existing user or role.
options map of string to strings Optional parameters. The default value is an empty map ( {} ).

Output Parameter Description

The GPUdb server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query. Here is a description of the various fields of the wrapper:

Name Type Description
status String 'OK' or 'ERROR'
message String Empty if success or an error message
data_type String 'create_role_request' or 'none' in case of an error
data String Empty string
data_str JSON or String

This embedded JSON represents the result of the /create/role endpoint:

Name Type Description
name string Value of input parameter name.

Empty string in case of an error.