Note

This documentation is for a prior release of Kinetica. For the latest documentation, click here.

/create/role

URL: https://<aws.fqdn>/<aws.cluster.name>/gpudb-0/create/role

Creates a new role.

NOTE: This endpoint should be used for on-premise deployments only.

Input Parameter Description

NameTypeDescription
namestringName 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.
optionsmap of string to strings

Optional parameters. The default value is an empty map ( {} ).

Supported Parameters (keys)Parameter Description
resource_groupName of an existing resource group to associate with this user

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:

NameTypeDescription
statusString'OK' or 'ERROR'
messageStringEmpty if success or an error message
data_typeString'create_role_response' or 'none' in case of an error
dataStringEmpty string
data_strJSON or String

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

NameTypeDescription
namestringValue of input parameter name.
infomap of string to stringsAdditional information.

Empty string in case of an error.