Starburst Enterprise API documentation

AuditLogs

listAccessLogs

List Starburst built-in access control access logs


/api/v1/biac/audit/accessLogs

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/audit/accessLogs?pageToken=&pageSize=&pageSort=&startDate=&endDate=&queryId="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.AuditLogsApi;

import java.io.File;
import java.util.*;

public class AuditLogsApiExample {

    public static void main(String[] args) {
        
        AuditLogsApi apiInstance = new AuditLogsApi();
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        Date startDate = 2013-10-20T19:20:30+01:00; // Date | Start of the log entry timestamp interval to match (inclusive)
        Date endDate = 2013-10-20T19:20:30+01:00; // Date | End of the log entry timestamp interval to match (exclusive)
        Date queryId = 2013-10-20T19:20:30+01:00; // Date | Query ID for which log entries should be matched
        try {
            PaginatedResultAccessLogResponse result = apiInstance.listAccessLogs(pageToken, pageSize, pageSort, startDate, endDate, queryId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling AuditLogsApi#listAccessLogs");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.AuditLogsApi;

public class AuditLogsApiExample {

    public static void main(String[] args) {
        AuditLogsApi apiInstance = new AuditLogsApi();
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        Date startDate = 2013-10-20T19:20:30+01:00; // Date | Start of the log entry timestamp interval to match (inclusive)
        Date endDate = 2013-10-20T19:20:30+01:00; // Date | End of the log entry timestamp interval to match (exclusive)
        Date queryId = 2013-10-20T19:20:30+01:00; // Date | Query ID for which log entries should be matched
        try {
            PaginatedResultAccessLogResponse result = apiInstance.listAccessLogs(pageToken, pageSize, pageSort, startDate, endDate, queryId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling AuditLogsApi#listAccessLogs");
            e.printStackTrace();
        }
    }
}
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)
Date *startDate = 2013-10-20T19:20:30+01:00; // Start of the log entry timestamp interval to match (inclusive) (optional)
Date *endDate = 2013-10-20T19:20:30+01:00; // End of the log entry timestamp interval to match (exclusive) (optional)
Date *queryId = 2013-10-20T19:20:30+01:00; // Query ID for which log entries should be matched (optional)

AuditLogsApi *apiInstance = [[AuditLogsApi alloc] init];

// List Starburst built-in access control access logs
[apiInstance listAccessLogsWith:pageToken
    pageSize:pageSize
    pageSort:pageSort
    startDate:startDate
    endDate:endDate
    queryId:queryId
              completionHandler: ^(PaginatedResultAccessLogResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.AuditLogsApi()
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example, // {{String}} Sorting order
  'startDate': 2013-10-20T19:20:30+01:00, // {{Date}} Start of the log entry timestamp interval to match (inclusive)
  'endDate': 2013-10-20T19:20:30+01:00, // {{Date}} End of the log entry timestamp interval to match (exclusive)
  'queryId': 2013-10-20T19:20:30+01:00 // {{Date}} Query ID for which log entries should be matched
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listAccessLogs(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listAccessLogsExample
    {
        public void main()
        {

            var apiInstance = new AuditLogsApi();
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)
            var startDate = 2013-10-20T19:20:30+01:00;  // Date | Start of the log entry timestamp interval to match (inclusive) (optional) 
            var endDate = 2013-10-20T19:20:30+01:00;  // Date | End of the log entry timestamp interval to match (exclusive) (optional) 
            var queryId = 2013-10-20T19:20:30+01:00;  // Date | Query ID for which log entries should be matched (optional) 

            try
            {
                // List Starburst built-in access control access logs
                PaginatedResultAccessLogResponse result = apiInstance.listAccessLogs(pageToken, pageSize, pageSort, startDate, endDate, queryId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AuditLogsApi.listAccessLogs: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiAuditLogsApi();
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order
$startDate = 2013-10-20T19:20:30+01:00; // Date | Start of the log entry timestamp interval to match (inclusive)
$endDate = 2013-10-20T19:20:30+01:00; // Date | End of the log entry timestamp interval to match (exclusive)
$queryId = 2013-10-20T19:20:30+01:00; // Date | Query ID for which log entries should be matched

try {
    $result = $api_instance->listAccessLogs($pageToken, $pageSize, $pageSort, $startDate, $endDate, $queryId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AuditLogsApi->listAccessLogs: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::AuditLogsApi;

my $api_instance = WWW::SwaggerClient::AuditLogsApi->new();
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order
my $startDate = 2013-10-20T19:20:30+01:00; # Date | Start of the log entry timestamp interval to match (inclusive)
my $endDate = 2013-10-20T19:20:30+01:00; # Date | End of the log entry timestamp interval to match (exclusive)
my $queryId = 2013-10-20T19:20:30+01:00; # Date | Query ID for which log entries should be matched

eval { 
    my $result = $api_instance->listAccessLogs(pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort, startDate => $startDate, endDate => $endDate, queryId => $queryId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling AuditLogsApi->listAccessLogs: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.AuditLogsApi()
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)
startDate = 2013-10-20T19:20:30+01:00 # Date | Start of the log entry timestamp interval to match (inclusive) (optional)
endDate = 2013-10-20T19:20:30+01:00 # Date | End of the log entry timestamp interval to match (exclusive) (optional)
queryId = 2013-10-20T19:20:30+01:00 # Date | Query ID for which log entries should be matched (optional)

try: 
    # List Starburst built-in access control access logs
    api_response = api_instance.list_access_logs(pageToken=pageToken, pageSize=pageSize, pageSort=pageSort, startDate=startDate, endDate=endDate, queryId=queryId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AuditLogsApi->listAccessLogs: %s\n" % e)

Parameters

Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order
startDate
Date (date-time)
Start of the log entry timestamp interval to match (inclusive)
endDate
Date (date-time)
End of the log entry timestamp interval to match (exclusive)
queryId
Date (date-time)
Query ID for which log entries should be matched

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{

Details information about a single entry in the access log

id:
integer (int64)
queryId:
string

ID of the query that generated this access log

action:
string

The action for which access was requested, or (ANY) if action was not specified

entityCategory:
string

Category of the entity to which access was requested

entity:
string

Entity to which access was requested

entitySpecified:
boolean

If true, access was requested to a specific entity, otherwise access was requested to all entities of a given category

grantOption:
boolean

If true, the requester has WITH GRANT OPTION grant for the given entity

accessResult:
string
Enum: ALLOW, DENY, ROW_FILTER, COLUMN_MASK
user:
string

Session User

enabledRoles:
[ (0..∞)

Roles enabled on the session

string

Roles enabled on the session

]
atTime:
string (date-time)

When access was requested

}
]
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

listChangeLogs

List Starburst built-in access control change logs


/api/v1/biac/audit/changeLogs

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/audit/changeLogs?pageToken=&pageSize=&pageSort=&startDate=&endDate=&queryId="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.AuditLogsApi;

import java.io.File;
import java.util.*;

public class AuditLogsApiExample {

    public static void main(String[] args) {
        
        AuditLogsApi apiInstance = new AuditLogsApi();
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        Date startDate = 2013-10-20T19:20:30+01:00; // Date | Start of the log entry timestamp interval to match (inclusive)
        Date endDate = 2013-10-20T19:20:30+01:00; // Date | End of the log entry timestamp interval to match (exclusive)
        Date queryId = 2013-10-20T19:20:30+01:00; // Date | Query ID for which log entries should be matched
        try {
            PaginatedResultChangeLogResponse result = apiInstance.listChangeLogs(pageToken, pageSize, pageSort, startDate, endDate, queryId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling AuditLogsApi#listChangeLogs");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.AuditLogsApi;

public class AuditLogsApiExample {

    public static void main(String[] args) {
        AuditLogsApi apiInstance = new AuditLogsApi();
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        Date startDate = 2013-10-20T19:20:30+01:00; // Date | Start of the log entry timestamp interval to match (inclusive)
        Date endDate = 2013-10-20T19:20:30+01:00; // Date | End of the log entry timestamp interval to match (exclusive)
        Date queryId = 2013-10-20T19:20:30+01:00; // Date | Query ID for which log entries should be matched
        try {
            PaginatedResultChangeLogResponse result = apiInstance.listChangeLogs(pageToken, pageSize, pageSort, startDate, endDate, queryId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling AuditLogsApi#listChangeLogs");
            e.printStackTrace();
        }
    }
}
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)
Date *startDate = 2013-10-20T19:20:30+01:00; // Start of the log entry timestamp interval to match (inclusive) (optional)
Date *endDate = 2013-10-20T19:20:30+01:00; // End of the log entry timestamp interval to match (exclusive) (optional)
Date *queryId = 2013-10-20T19:20:30+01:00; // Query ID for which log entries should be matched (optional)

AuditLogsApi *apiInstance = [[AuditLogsApi alloc] init];

// List Starburst built-in access control change logs
[apiInstance listChangeLogsWith:pageToken
    pageSize:pageSize
    pageSort:pageSort
    startDate:startDate
    endDate:endDate
    queryId:queryId
              completionHandler: ^(PaginatedResultChangeLogResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.AuditLogsApi()
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example, // {{String}} Sorting order
  'startDate': 2013-10-20T19:20:30+01:00, // {{Date}} Start of the log entry timestamp interval to match (inclusive)
  'endDate': 2013-10-20T19:20:30+01:00, // {{Date}} End of the log entry timestamp interval to match (exclusive)
  'queryId': 2013-10-20T19:20:30+01:00 // {{Date}} Query ID for which log entries should be matched
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listChangeLogs(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listChangeLogsExample
    {
        public void main()
        {

            var apiInstance = new AuditLogsApi();
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)
            var startDate = 2013-10-20T19:20:30+01:00;  // Date | Start of the log entry timestamp interval to match (inclusive) (optional) 
            var endDate = 2013-10-20T19:20:30+01:00;  // Date | End of the log entry timestamp interval to match (exclusive) (optional) 
            var queryId = 2013-10-20T19:20:30+01:00;  // Date | Query ID for which log entries should be matched (optional) 

            try
            {
                // List Starburst built-in access control change logs
                PaginatedResultChangeLogResponse result = apiInstance.listChangeLogs(pageToken, pageSize, pageSort, startDate, endDate, queryId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AuditLogsApi.listChangeLogs: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiAuditLogsApi();
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order
$startDate = 2013-10-20T19:20:30+01:00; // Date | Start of the log entry timestamp interval to match (inclusive)
$endDate = 2013-10-20T19:20:30+01:00; // Date | End of the log entry timestamp interval to match (exclusive)
$queryId = 2013-10-20T19:20:30+01:00; // Date | Query ID for which log entries should be matched

try {
    $result = $api_instance->listChangeLogs($pageToken, $pageSize, $pageSort, $startDate, $endDate, $queryId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AuditLogsApi->listChangeLogs: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::AuditLogsApi;

my $api_instance = WWW::SwaggerClient::AuditLogsApi->new();
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order
my $startDate = 2013-10-20T19:20:30+01:00; # Date | Start of the log entry timestamp interval to match (inclusive)
my $endDate = 2013-10-20T19:20:30+01:00; # Date | End of the log entry timestamp interval to match (exclusive)
my $queryId = 2013-10-20T19:20:30+01:00; # Date | Query ID for which log entries should be matched

eval { 
    my $result = $api_instance->listChangeLogs(pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort, startDate => $startDate, endDate => $endDate, queryId => $queryId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling AuditLogsApi->listChangeLogs: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.AuditLogsApi()
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)
startDate = 2013-10-20T19:20:30+01:00 # Date | Start of the log entry timestamp interval to match (inclusive) (optional)
endDate = 2013-10-20T19:20:30+01:00 # Date | End of the log entry timestamp interval to match (exclusive) (optional)
queryId = 2013-10-20T19:20:30+01:00 # Date | Query ID for which log entries should be matched (optional)

try: 
    # List Starburst built-in access control change logs
    api_response = api_instance.list_change_logs(pageToken=pageToken, pageSize=pageSize, pageSort=pageSort, startDate=startDate, endDate=endDate, queryId=queryId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AuditLogsApi->listChangeLogs: %s\n" % e)

Parameters

Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order
startDate
Date (date-time)
Start of the log entry timestamp interval to match (inclusive)
endDate
Date (date-time)
End of the log entry timestamp interval to match (exclusive)
queryId
Date (date-time)
Query ID for which log entries should be matched

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{

Details information about a single entry in the change log

id:
integer (int64)
queryId:
string

ID of the query that made the change

operation:
string

Type of the change

entityKind:
string

Kind of the entity that the change relates to

whatChanged:
string

Description of what has changed

entity:
string

Text representation of the entity that the change relates to

entitySpecified:
boolean

If true, the change applies to a specific entity, otherwise the change applies to all entities of the given kind

grantOption:
boolean

If true, GRANT OPTION applies to the affected role for the related entity

affectedRole:
string

Name of the role that was affected by this change

user:
string

Session user that has made this change

enabledRoles:
[ (0..∞)

Roles enabled on the session that has made this change

string

Roles enabled on the session that has made this change

]
atTime:
string (date-time)

When this change was made

}
]
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

ColumnMasks

addColumnMaskToRole

Add a column mask to a role to mask column values from subjects assigned to the role.


/api/v1/biac/roles/{roleId}/columnMasks

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/roles/{roleId}/columnMasks"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.ColumnMasksApi;

import java.io.File;
import java.util.*;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long roleId = 789; // Long | 
        ColumnMaskPayload body = ; // ColumnMaskPayload | 
        try {
            ColumnMaskResponse result = apiInstance.addColumnMaskToRole(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#addColumnMaskToRole");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.ColumnMasksApi;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long roleId = 789; // Long | 
        ColumnMaskPayload body = ; // ColumnMaskPayload | 
        try {
            ColumnMaskResponse result = apiInstance.addColumnMaskToRole(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#addColumnMaskToRole");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
ColumnMaskPayload *body = ; //  (optional)

ColumnMasksApi *apiInstance = [[ColumnMasksApi alloc] init];

// Add a column mask to a role to mask column values from subjects assigned to the role.
[apiInstance addColumnMaskToRoleWith:roleId
    body:body
              completionHandler: ^(ColumnMaskResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.ColumnMasksApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'body':  // {{ColumnMaskPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.addColumnMaskToRole(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class addColumnMaskToRoleExample
    {
        public void main()
        {

            var apiInstance = new ColumnMasksApi();
            var roleId = 789;  // Long | 
            var body = new ColumnMaskPayload(); // ColumnMaskPayload |  (optional) 

            try
            {
                // Add a column mask to a role to mask column values from subjects assigned to the role.
                ColumnMaskResponse result = apiInstance.addColumnMaskToRole(roleId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ColumnMasksApi.addColumnMaskToRole: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiColumnMasksApi();
$roleId = 789; // Long | 
$body = ; // ColumnMaskPayload | 

try {
    $result = $api_instance->addColumnMaskToRole($roleId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling ColumnMasksApi->addColumnMaskToRole: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::ColumnMasksApi;

my $api_instance = WWW::SwaggerClient::ColumnMasksApi->new();
my $roleId = 789; # Long | 
my $body = WWW::SwaggerClient::Object::ColumnMaskPayload->new(); # ColumnMaskPayload | 

eval { 
    my $result = $api_instance->addColumnMaskToRole(roleId => $roleId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling ColumnMasksApi->addColumnMaskToRole: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.ColumnMasksApi()
roleId = 789 # Long | 
body =  # ColumnMaskPayload |  (optional)

try: 
    # Add a column mask to a role to mask column values from subjects assigned to the role.
    api_response = api_instance.add_column_mask_to_role(roleId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ColumnMasksApi->addColumnMaskToRole: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Body parameters
Name Description
body
{

Data for a role column mask

Required: entity,expressionId
entity:
{

Data of a TABLES entity

}
all of:
expressionId:
integer (int64)

Id of the column mask expression to apply in the given entity

}

Responses

Status: 200 - Success

{

Detailed data for a column mask added to a role

id:
integer (int64)

Id of the column mask applied to a role.

entity:
{
category:
string

TABLES, SCHEMA_PROPERTIES, TABLE_PROPERTIES, SYSTEM_SESSION_PROPERTIES, CATALOG_SESSION_PROPERTIES, FUNCTIONS, PROCEDURES, QUERIES, SYSTEM_INFORMATION, ROLES, USERS, DATA_PRODUCTS, AUDIT_LOGS

allEntities:
boolean

Is the entity representing all entities of the given category

}
one of:
{

Data of a TABLES entity

}
all of:
{

Data of a USERS, ROLES or SYSTEM_SESSION_PROPERTIES entity

}
all of:
{

Data of a FUNCTIONS entity

}
all of:
{

Data of a PROCEDURES entity

}
all of:
{

Data of a CATALOG_SESSION_PROPERTIES entity

}
all of:
{

Data of a QUERIES or AUDIT_LOGS entity

}
all of:
{

Data of a DATA_PRODUCTS entity

}
all of:
{

Data of a TABLE_PROPERTIES or SCHEMA_PROPERTIES entity

}
all of:
expressionId:
integer (int64)

Id of the column mask expression.

forceNone:
boolean

If true, forces not masking column values for the given entity, even if the subject is assigned to other roles with column masks to the same entity.

}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

createColumnMaskExpression

Create an expression that can be applied to mask column values


/api/v1/biac/expressions/columnMask

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/expressions/columnMask"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.ColumnMasksApi;

import java.io.File;
import java.util.*;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        ExpressionPayload body = ; // ExpressionPayload | 
        try {
            ExpressionResponse result = apiInstance.createColumnMaskExpression(body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#createColumnMaskExpression");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.ColumnMasksApi;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        ExpressionPayload body = ; // ExpressionPayload | 
        try {
            ExpressionResponse result = apiInstance.createColumnMaskExpression(body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#createColumnMaskExpression");
            e.printStackTrace();
        }
    }
}
ExpressionPayload *body = ; //  (optional)

ColumnMasksApi *apiInstance = [[ColumnMasksApi alloc] init];

// Create an expression that can be applied to mask column values
[apiInstance createColumnMaskExpressionWith:body
              completionHandler: ^(ExpressionResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.ColumnMasksApi()
var opts = { 
  'body':  // {{ExpressionPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.createColumnMaskExpression(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class createColumnMaskExpressionExample
    {
        public void main()
        {

            var apiInstance = new ColumnMasksApi();
            var body = new ExpressionPayload(); // ExpressionPayload |  (optional) 

            try
            {
                // Create an expression that can be applied to mask column values
                ExpressionResponse result = apiInstance.createColumnMaskExpression(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ColumnMasksApi.createColumnMaskExpression: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiColumnMasksApi();
$body = ; // ExpressionPayload | 

try {
    $result = $api_instance->createColumnMaskExpression($body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling ColumnMasksApi->createColumnMaskExpression: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::ColumnMasksApi;

my $api_instance = WWW::SwaggerClient::ColumnMasksApi->new();
my $body = WWW::SwaggerClient::Object::ExpressionPayload->new(); # ExpressionPayload | 

eval { 
    my $result = $api_instance->createColumnMaskExpression(body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling ColumnMasksApi->createColumnMaskExpression: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.ColumnMasksApi()
body =  # ExpressionPayload |  (optional)

try: 
    # Create an expression that can be applied to mask column values
    api_response = api_instance.create_column_mask_expression(body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ColumnMasksApi->createColumnMaskExpression: %s\n" % e)

Parameters

Body parameters
Name Description
body
{
name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}

Responses

Status: 200 - Success

{
id:
integer (int64)

Expression id

name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

deleteColumnMaskExpression

Delete a column mask expression


/api/v1/biac/expressions/columnMask/{columnMaskExpressionId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: application/json"\
"//api/v1/biac/expressions/columnMask/{columnMaskExpressionId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.ColumnMasksApi;

import java.io.File;
import java.util.*;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long columnMaskExpressionId = 789; // Long | 
        try {
            apiInstance.deleteColumnMaskExpression(columnMaskExpressionId);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#deleteColumnMaskExpression");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.ColumnMasksApi;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long columnMaskExpressionId = 789; // Long | 
        try {
            apiInstance.deleteColumnMaskExpression(columnMaskExpressionId);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#deleteColumnMaskExpression");
            e.printStackTrace();
        }
    }
}
Long *columnMaskExpressionId = 789; // 

ColumnMasksApi *apiInstance = [[ColumnMasksApi alloc] init];

// Delete a column mask expression
[apiInstance deleteColumnMaskExpressionWith:columnMaskExpressionId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.ColumnMasksApi()
var columnMaskExpressionId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteColumnMaskExpression(columnMaskExpressionId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteColumnMaskExpressionExample
    {
        public void main()
        {

            var apiInstance = new ColumnMasksApi();
            var columnMaskExpressionId = 789;  // Long | 

            try
            {
                // Delete a column mask expression
                apiInstance.deleteColumnMaskExpression(columnMaskExpressionId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ColumnMasksApi.deleteColumnMaskExpression: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiColumnMasksApi();
$columnMaskExpressionId = 789; // Long | 

try {
    $api_instance->deleteColumnMaskExpression($columnMaskExpressionId);
} catch (Exception $e) {
    echo 'Exception when calling ColumnMasksApi->deleteColumnMaskExpression: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::ColumnMasksApi;

my $api_instance = WWW::SwaggerClient::ColumnMasksApi->new();
my $columnMaskExpressionId = 789; # Long | 

eval { 
    $api_instance->deleteColumnMaskExpression(columnMaskExpressionId => $columnMaskExpressionId);
};
if ($@) {
    warn "Exception when calling ColumnMasksApi->deleteColumnMaskExpression: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.ColumnMasksApi()
columnMaskExpressionId = 789 # Long | 

try: 
    # Delete a column mask expression
    api_instance.delete_column_mask_expression(columnMaskExpressionId)
except ApiException as e:
    print("Exception when calling ColumnMasksApi->deleteColumnMaskExpression: %s\n" % e)

Parameters

Path parameters
Name Description
columnMaskExpressionId*
Long (int64)
Required

Responses

Status: 204 - Success

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

deleteRoleColumnMask

Remove a column mask from a role.


/api/v1/biac/roles/{roleId}/columnMasks/{columnMaskId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: */*,application/json"\
"//api/v1/biac/roles/{roleId}/columnMasks/{columnMaskId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.ColumnMasksApi;

import java.io.File;
import java.util.*;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long roleId = 789; // Long | 
        Long columnMaskId = 789; // Long | 
        try {
            apiInstance.deleteRoleColumnMask(roleId, columnMaskId);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#deleteRoleColumnMask");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.ColumnMasksApi;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long roleId = 789; // Long | 
        Long columnMaskId = 789; // Long | 
        try {
            apiInstance.deleteRoleColumnMask(roleId, columnMaskId);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#deleteRoleColumnMask");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
Long *columnMaskId = 789; // 

ColumnMasksApi *apiInstance = [[ColumnMasksApi alloc] init];

// Remove a column mask from a role.
[apiInstance deleteRoleColumnMaskWith:roleId
    columnMaskId:columnMaskId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.ColumnMasksApi()
var roleId = 789; // {{Long}} 
var columnMaskId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteRoleColumnMask(roleId, columnMaskId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteRoleColumnMaskExample
    {
        public void main()
        {

            var apiInstance = new ColumnMasksApi();
            var roleId = 789;  // Long | 
            var columnMaskId = 789;  // Long | 

            try
            {
                // Remove a column mask from a role.
                apiInstance.deleteRoleColumnMask(roleId, columnMaskId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ColumnMasksApi.deleteRoleColumnMask: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiColumnMasksApi();
$roleId = 789; // Long | 
$columnMaskId = 789; // Long | 

try {
    $api_instance->deleteRoleColumnMask($roleId, $columnMaskId);
} catch (Exception $e) {
    echo 'Exception when calling ColumnMasksApi->deleteRoleColumnMask: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::ColumnMasksApi;

my $api_instance = WWW::SwaggerClient::ColumnMasksApi->new();
my $roleId = 789; # Long | 
my $columnMaskId = 789; # Long | 

eval { 
    $api_instance->deleteRoleColumnMask(roleId => $roleId, columnMaskId => $columnMaskId);
};
if ($@) {
    warn "Exception when calling ColumnMasksApi->deleteRoleColumnMask: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.ColumnMasksApi()
roleId = 789 # Long | 
columnMaskId = 789 # Long | 

try: 
    # Remove a column mask from a role.
    api_instance.delete_role_column_mask(roleId, columnMaskId)
except ApiException as e:
    print("Exception when calling ColumnMasksApi->deleteRoleColumnMask: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
columnMaskId*
Long (int64)
Required

Responses

Status: 204 - No Content

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

getColumnMask

Get a column mask of a given role.


/api/v1/biac/roles/{roleId}/columnMasks/{columnMaskId}

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/roles/{roleId}/columnMasks/{columnMaskId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.ColumnMasksApi;

import java.io.File;
import java.util.*;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long roleId = 789; // Long | 
        Long columnMaskId = 789; // Long | 
        try {
            ColumnMaskResponse result = apiInstance.getColumnMask(roleId, columnMaskId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#getColumnMask");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.ColumnMasksApi;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long roleId = 789; // Long | 
        Long columnMaskId = 789; // Long | 
        try {
            ColumnMaskResponse result = apiInstance.getColumnMask(roleId, columnMaskId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#getColumnMask");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
Long *columnMaskId = 789; // 

ColumnMasksApi *apiInstance = [[ColumnMasksApi alloc] init];

// Get a column mask of a given role.
[apiInstance getColumnMaskWith:roleId
    columnMaskId:columnMaskId
              completionHandler: ^(ColumnMaskResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.ColumnMasksApi()
var roleId = 789; // {{Long}} 
var columnMaskId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getColumnMask(roleId, columnMaskId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getColumnMaskExample
    {
        public void main()
        {

            var apiInstance = new ColumnMasksApi();
            var roleId = 789;  // Long | 
            var columnMaskId = 789;  // Long | 

            try
            {
                // Get a column mask of a given role.
                ColumnMaskResponse result = apiInstance.getColumnMask(roleId, columnMaskId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ColumnMasksApi.getColumnMask: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiColumnMasksApi();
$roleId = 789; // Long | 
$columnMaskId = 789; // Long | 

try {
    $result = $api_instance->getColumnMask($roleId, $columnMaskId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling ColumnMasksApi->getColumnMask: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::ColumnMasksApi;

my $api_instance = WWW::SwaggerClient::ColumnMasksApi->new();
my $roleId = 789; # Long | 
my $columnMaskId = 789; # Long | 

eval { 
    my $result = $api_instance->getColumnMask(roleId => $roleId, columnMaskId => $columnMaskId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling ColumnMasksApi->getColumnMask: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.ColumnMasksApi()
roleId = 789 # Long | 
columnMaskId = 789 # Long | 

try: 
    # Get a column mask of a given role.
    api_response = api_instance.get_column_mask(roleId, columnMaskId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ColumnMasksApi->getColumnMask: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
columnMaskId*
Long (int64)
Required

Responses

Status: 200 - Success

{

Detailed data for a column mask added to a role

id:
integer (int64)

Id of the column mask applied to a role.

entity:
{
category:
string

TABLES, SCHEMA_PROPERTIES, TABLE_PROPERTIES, SYSTEM_SESSION_PROPERTIES, CATALOG_SESSION_PROPERTIES, FUNCTIONS, PROCEDURES, QUERIES, SYSTEM_INFORMATION, ROLES, USERS, DATA_PRODUCTS, AUDIT_LOGS

allEntities:
boolean

Is the entity representing all entities of the given category

}
one of:
{

Data of a TABLES entity

}
all of:
{

Data of a USERS, ROLES or SYSTEM_SESSION_PROPERTIES entity

}
all of:
{

Data of a FUNCTIONS entity

}
all of:
{

Data of a PROCEDURES entity

}
all of:
{

Data of a CATALOG_SESSION_PROPERTIES entity

}
all of:
{

Data of a QUERIES or AUDIT_LOGS entity

}
all of:
{

Data of a DATA_PRODUCTS entity

}
all of:
{

Data of a TABLE_PROPERTIES or SCHEMA_PROPERTIES entity

}
all of:
expressionId:
integer (int64)

Id of the column mask expression.

forceNone:
boolean

If true, forces not masking column values for the given entity, even if the subject is assigned to other roles with column masks to the same entity.

}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

getColumnMaskExpression

Get an expression that can be used to mask column values


/api/v1/biac/expressions/columnMask/{columnMaskExpressionId}

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/expressions/columnMask/{columnMaskExpressionId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.ColumnMasksApi;

import java.io.File;
import java.util.*;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long columnMaskExpressionId = 789; // Long | 
        try {
            ExpressionResponse result = apiInstance.getColumnMaskExpression(columnMaskExpressionId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#getColumnMaskExpression");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.ColumnMasksApi;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long columnMaskExpressionId = 789; // Long | 
        try {
            ExpressionResponse result = apiInstance.getColumnMaskExpression(columnMaskExpressionId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#getColumnMaskExpression");
            e.printStackTrace();
        }
    }
}
Long *columnMaskExpressionId = 789; // 

ColumnMasksApi *apiInstance = [[ColumnMasksApi alloc] init];

// Get an expression that can be used to mask column values
[apiInstance getColumnMaskExpressionWith:columnMaskExpressionId
              completionHandler: ^(ExpressionResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.ColumnMasksApi()
var columnMaskExpressionId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getColumnMaskExpression(columnMaskExpressionId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getColumnMaskExpressionExample
    {
        public void main()
        {

            var apiInstance = new ColumnMasksApi();
            var columnMaskExpressionId = 789;  // Long | 

            try
            {
                // Get an expression that can be used to mask column values
                ExpressionResponse result = apiInstance.getColumnMaskExpression(columnMaskExpressionId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ColumnMasksApi.getColumnMaskExpression: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiColumnMasksApi();
$columnMaskExpressionId = 789; // Long | 

try {
    $result = $api_instance->getColumnMaskExpression($columnMaskExpressionId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling ColumnMasksApi->getColumnMaskExpression: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::ColumnMasksApi;

my $api_instance = WWW::SwaggerClient::ColumnMasksApi->new();
my $columnMaskExpressionId = 789; # Long | 

eval { 
    my $result = $api_instance->getColumnMaskExpression(columnMaskExpressionId => $columnMaskExpressionId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling ColumnMasksApi->getColumnMaskExpression: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.ColumnMasksApi()
columnMaskExpressionId = 789 # Long | 

try: 
    # Get an expression that can be used to mask column values
    api_response = api_instance.get_column_mask_expression(columnMaskExpressionId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ColumnMasksApi->getColumnMaskExpression: %s\n" % e)

Parameters

Path parameters
Name Description
columnMaskExpressionId*
Long (int64)
Required

Responses

Status: 200 - Success

{
id:
integer (int64)

Expression id

name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

listColumnMaskExpressions

List the expressions that can be used to mask column values


/api/v1/biac/expressions/columnMask

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/expressions/columnMask?pageToken=&pageSize=&pageSort="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.ColumnMasksApi;

import java.io.File;
import java.util.*;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultExpressionResponse result = apiInstance.listColumnMaskExpressions(pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#listColumnMaskExpressions");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.ColumnMasksApi;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultExpressionResponse result = apiInstance.listColumnMaskExpressions(pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#listColumnMaskExpressions");
            e.printStackTrace();
        }
    }
}
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)

ColumnMasksApi *apiInstance = [[ColumnMasksApi alloc] init];

// List the expressions that can be used to mask column values
[apiInstance listColumnMaskExpressionsWith:pageToken
    pageSize:pageSize
    pageSort:pageSort
              completionHandler: ^(PaginatedResultExpressionResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.ColumnMasksApi()
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example // {{String}} Sorting order
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listColumnMaskExpressions(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listColumnMaskExpressionsExample
    {
        public void main()
        {

            var apiInstance = new ColumnMasksApi();
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)

            try
            {
                // List the expressions that can be used to mask column values
                PaginatedResultExpressionResponse result = apiInstance.listColumnMaskExpressions(pageToken, pageSize, pageSort);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ColumnMasksApi.listColumnMaskExpressions: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiColumnMasksApi();
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order

try {
    $result = $api_instance->listColumnMaskExpressions($pageToken, $pageSize, $pageSort);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling ColumnMasksApi->listColumnMaskExpressions: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::ColumnMasksApi;

my $api_instance = WWW::SwaggerClient::ColumnMasksApi->new();
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order

eval { 
    my $result = $api_instance->listColumnMaskExpressions(pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling ColumnMasksApi->listColumnMaskExpressions: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.ColumnMasksApi()
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)

try: 
    # List the expressions that can be used to mask column values
    api_response = api_instance.list_column_mask_expressions(pageToken=pageToken, pageSize=pageSize, pageSort=pageSort)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ColumnMasksApi->listColumnMaskExpressions: %s\n" % e)

Parameters

Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{
id:
integer (int64)

Expression id

name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}
]
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

listRoleColumnMasks

List all the column masks of a role.


/api/v1/biac/roles/{roleId}/columnMasks

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/roles/{roleId}/columnMasks?pageToken=&pageSize=&pageSort="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.ColumnMasksApi;

import java.io.File;
import java.util.*;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultColumnMaskResponse result = apiInstance.listRoleColumnMasks(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#listRoleColumnMasks");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.ColumnMasksApi;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultColumnMaskResponse result = apiInstance.listRoleColumnMasks(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#listRoleColumnMasks");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)

ColumnMasksApi *apiInstance = [[ColumnMasksApi alloc] init];

// List all the column masks of a role.
[apiInstance listRoleColumnMasksWith:roleId
    pageToken:pageToken
    pageSize:pageSize
    pageSort:pageSort
              completionHandler: ^(PaginatedResultColumnMaskResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.ColumnMasksApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example // {{String}} Sorting order
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listRoleColumnMasks(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listRoleColumnMasksExample
    {
        public void main()
        {

            var apiInstance = new ColumnMasksApi();
            var roleId = 789;  // Long | 
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)

            try
            {
                // List all the column masks of a role.
                PaginatedResultColumnMaskResponse result = apiInstance.listRoleColumnMasks(roleId, pageToken, pageSize, pageSort);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ColumnMasksApi.listRoleColumnMasks: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiColumnMasksApi();
$roleId = 789; // Long | 
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order

try {
    $result = $api_instance->listRoleColumnMasks($roleId, $pageToken, $pageSize, $pageSort);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling ColumnMasksApi->listRoleColumnMasks: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::ColumnMasksApi;

my $api_instance = WWW::SwaggerClient::ColumnMasksApi->new();
my $roleId = 789; # Long | 
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order

eval { 
    my $result = $api_instance->listRoleColumnMasks(roleId => $roleId, pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling ColumnMasksApi->listRoleColumnMasks: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.ColumnMasksApi()
roleId = 789 # Long | 
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)

try: 
    # List all the column masks of a role.
    api_response = api_instance.list_role_column_masks(roleId, pageToken=pageToken, pageSize=pageSize, pageSort=pageSort)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ColumnMasksApi->listRoleColumnMasks: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{

Detailed data for a column mask added to a role

id:
integer (int64)

Id of the column mask applied to a role.

entity:
{
category:
string

TABLES, SCHEMA_PROPERTIES, TABLE_PROPERTIES, SYSTEM_SESSION_PROPERTIES, CATALOG_SESSION_PROPERTIES, FUNCTIONS, PROCEDURES, QUERIES, SYSTEM_INFORMATION, ROLES, USERS, DATA_PRODUCTS, AUDIT_LOGS

allEntities:
boolean

Is the entity representing all entities of the given category

}
one of:
{

Data of a TABLES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

table:
string

If empty it applies to all tables of the entity's schema

tableType:
string

If empty it applies to table, view and materialized view

Enum: TABLE, VIEW, MATERIALIZED_VIEW
columns:
[ (0..∞)

If empty it applies to all columns of the entity's table

string

If empty it applies to all columns of the entity's table

]
}
{

Data of a USERS, ROLES or SYSTEM_SESSION_PROPERTIES entity

}
all of:
{
entityKey:
string

If empty it applies to all entities of the given category

}
{

Data of a FUNCTIONS entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

function:
string

If empty it applies to all functions of the entity's schema

}
{

Data of a PROCEDURES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

procedure:
string

If empty it applies to all procedures of the entity's schema

}
{

Data of a CATALOG_SESSION_PROPERTIES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

entityKey:
string

If empty it applies to all entities of the given category in the entity's catalog

}
{

Data of a QUERIES or AUDIT_LOGS entity

}
all of:
{

Data of a DATA_PRODUCTS entity

}
all of:
{
domainName:
string

If empty it applies to all domains

dataProductName:
string

If empty it applies to all data products in the entity's domain

}
{

Data of a TABLE_PROPERTIES or SCHEMA_PROPERTIES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

table:
string

If empty it applies to all tables of the entity's schema

property:
string

If empty it applies to all properties of the entity's table or schema

value:
string

If empty it applies to all property values

}
expressionId:
integer (int64)

Id of the column mask expression.

forceNone:
boolean

If true, forces not masking column values for the given entity, even if the subject is assigned to other roles with column masks to the same entity.

}
]
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

updateColumnMaskExpression

Update a column mask expression


/api/v1/biac/expressions/columnMask/{columnMaskExpressionId}

Usage and SDK Samples

curl -X PUT\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/expressions/columnMask/{columnMaskExpressionId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.ColumnMasksApi;

import java.io.File;
import java.util.*;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long columnMaskExpressionId = 789; // Long | 
        ExpressionPayload body = ; // ExpressionPayload | 
        try {
            ExpressionResponse result = apiInstance.updateColumnMaskExpression(columnMaskExpressionId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#updateColumnMaskExpression");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.ColumnMasksApi;

public class ColumnMasksApiExample {

    public static void main(String[] args) {
        ColumnMasksApi apiInstance = new ColumnMasksApi();
        Long columnMaskExpressionId = 789; // Long | 
        ExpressionPayload body = ; // ExpressionPayload | 
        try {
            ExpressionResponse result = apiInstance.updateColumnMaskExpression(columnMaskExpressionId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ColumnMasksApi#updateColumnMaskExpression");
            e.printStackTrace();
        }
    }
}
Long *columnMaskExpressionId = 789; // 
ExpressionPayload *body = ; //  (optional)

ColumnMasksApi *apiInstance = [[ColumnMasksApi alloc] init];

// Update a column mask expression
[apiInstance updateColumnMaskExpressionWith:columnMaskExpressionId
    body:body
              completionHandler: ^(ExpressionResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.ColumnMasksApi()
var columnMaskExpressionId = 789; // {{Long}} 
var opts = { 
  'body':  // {{ExpressionPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.updateColumnMaskExpression(columnMaskExpressionId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class updateColumnMaskExpressionExample
    {
        public void main()
        {

            var apiInstance = new ColumnMasksApi();
            var columnMaskExpressionId = 789;  // Long | 
            var body = new ExpressionPayload(); // ExpressionPayload |  (optional) 

            try
            {
                // Update a column mask expression
                ExpressionResponse result = apiInstance.updateColumnMaskExpression(columnMaskExpressionId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ColumnMasksApi.updateColumnMaskExpression: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiColumnMasksApi();
$columnMaskExpressionId = 789; // Long | 
$body = ; // ExpressionPayload | 

try {
    $result = $api_instance->updateColumnMaskExpression($columnMaskExpressionId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling ColumnMasksApi->updateColumnMaskExpression: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::ColumnMasksApi;

my $api_instance = WWW::SwaggerClient::ColumnMasksApi->new();
my $columnMaskExpressionId = 789; # Long | 
my $body = WWW::SwaggerClient::Object::ExpressionPayload->new(); # ExpressionPayload | 

eval { 
    my $result = $api_instance->updateColumnMaskExpression(columnMaskExpressionId => $columnMaskExpressionId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling ColumnMasksApi->updateColumnMaskExpression: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.ColumnMasksApi()
columnMaskExpressionId = 789 # Long | 
body =  # ExpressionPayload |  (optional)

try: 
    # Update a column mask expression
    api_response = api_instance.update_column_mask_expression(columnMaskExpressionId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ColumnMasksApi->updateColumnMaskExpression: %s\n" % e)

Parameters

Path parameters
Name Description
columnMaskExpressionId*
Long (int64)
Required
Body parameters
Name Description
body
{
name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}

Responses

Status: 200 - Success

{
id:
integer (int64)

Expression id

name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

DataProducts

cloneDataProduct

Clone a data product

Clone an existing data product within the same domain. All datasets are cloned as well as tags and sample queries.


/api/v1/dataProduct/products/{dataProductId}/clone

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/dataProduct/products/{dataProductId}/clone"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        CloneDataProductPayload body = ; // CloneDataProductPayload | 
        try {
            Data product result = apiInstance.cloneDataProduct(dataProductId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#cloneDataProduct");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        CloneDataProductPayload body = ; // CloneDataProductPayload | 
        try {
            Data product result = apiInstance.cloneDataProduct(dataProductId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#cloneDataProduct");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
CloneDataProductPayload *body = ; //  (optional)

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Clone a data product
[apiInstance cloneDataProductWith:dataProductId
    body:body
              completionHandler: ^(Data product output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var opts = { 
  'body':  // {{CloneDataProductPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.cloneDataProduct(dataProductId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class cloneDataProductExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();
            var dataProductId = new UUID(); // UUID | 
            var body = new CloneDataProductPayload(); // CloneDataProductPayload |  (optional) 

            try
            {
                // Clone a data product
                Data product result = apiInstance.cloneDataProduct(dataProductId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.cloneDataProduct: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$body = ; // CloneDataProductPayload | 

try {
    $result = $api_instance->cloneDataProduct($dataProductId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->cloneDataProduct: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $body = WWW::SwaggerClient::Object::CloneDataProductPayload->new(); # CloneDataProductPayload | 

eval { 
    my $result = $api_instance->cloneDataProduct(dataProductId => $dataProductId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DataProductsApi->cloneDataProduct: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
body =  # CloneDataProductPayload |  (optional)

try: 
    # Clone a data product
    api_response = api_instance.clone_data_product(dataProductId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DataProductsApi->cloneDataProduct: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required
Body parameters
Name Description
body
{

Options for cloning a data product

Required: catalogName,newName
newName:
string

Name for the new (cloned) data product.

catalogName:
string

Catalog for the cloned data product

dataDomainId:
string (uuid)

Domain for the new data product. If not specified then the domain of the source data product will be used.

}

Responses

Status: 200 - Success

{

Detailed data for a data product

Required: userData
id:
string (uuid)

Data product UUID

name:
string minLength:1 maxLength:40

Data product name.

catalogName:
string minLength:1 maxLength:255

Catalog to store this data product.

schemaName:
string minLength:1 maxLength:255

Trino schema name that will be generated for this data product.

dataDomainId:
string (uuid)

UUID of the domain that this data product belongs to.

summary:
string maxLength:150

Summary description for this data product.

description:
string

Description for this data product.

createdBy:
string minLength:1 maxLength:255

User who created this data product.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
views:
[

View datasets for this data product.

{

Detailed data for a view dataset

Required: columns,createdAt,createdBy,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the view dataset.

description:
string

Description of the view dataset.

createdBy:
string

Name of the user who created the view dataset.

definitionQuery:
string

Definition query for the dataset.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions of the view dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this view dataset will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this view dataset was created.

updatedAt:
string (date-time)

Timestamp of when this view dataset was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the view dataset. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this view dataset was last published.

publishedBy:
string

Name of the user who last published the view dataset.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
materializedViews:
[

Materialized views for this data product.

{

Detailed data for a materialized view

Required: columns,createdAt,createdBy,definitionProperties,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the materialized view.

description:
string

Description of the materialized view.

createdBy:
string

Name of the user who created the materialized view.

definitionQuery:
string

Definition query for the materialized view.

definitionProperties:
{

Definition properties for the materialized view.

}
status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this materialized view will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this materialized view was created.

updatedAt:
string (date-time)

Timestamp of when this materialized view was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the materialized view. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this materialized view was last published.

publishedBy:
string

Name of the user who last published the materialized view.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
owners:
[
{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
relevantLinks:
[

Relevant links for this data product.

{

Relevant link for a data product

Required: label,url
label:
string maxLength:255

Label for the link.

example: Example Link
url:
string maxLength:255

URL of the link.

example: https://example.com
}
]
createdAt:
string (date-time)

Timestamp of when this data product was created.

updatedAt:
string (date-time)

Timestamp of when this data product was last updated. Will be initialized to createdAt timestamp.

updatedBy:
string minLength:1 maxLength:255

User who last updated this data product.

publishedAt:
string (date-time)

Timestamp of when this data product was last published.

publishedBy:
string minLength:1 maxLength:255

User who published this data product.

accessMetadata:
{

Access metadata for a data product

lastQueriedAt:
string (date-time)

Timestamp when this data product was last queried

lastQueriedBy:
string

User who last queried this data product

}
ratingsAverage:
number (float) minimum:1 maximum:5

Average user rating of this data product. If empty then this data product has not been rated yet.

ratingsCount:
integer (int32)

Number of user ratings of this data product.

userData:
{

Detailed data product data for the authorized user

Required: isBookmarked
isBookmarked:
boolean

True if the authorized user has bookmarked this data product.

rating:
integer (int32) minimum:1 maximum:5

Rating given to this data product by the authorized user.

}
matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

bookmarkCount:
integer (int32)

The number of bookmarks for this data product.

productOwners:
[

User-supplied list of owners. Used to indicate who is maintaining this data product.

{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
}

Status: 400 - Bad Request

Status: 403 - Forbidden

Status: 404 - Not found

Status: 409 - Conflict


createDataProduct

Create a data product

This request creates a data product in a DRAFT status. At this stage the data product's schema and datasets are not yet available to be queried in SEP. It is only available for querying after it gets published, as part of the publishing workflow.


/api/v1/dataProduct/products

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/dataProduct/products"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        DataProductPayload body = ; // DataProductPayload | 
        try {
            Data product result = apiInstance.createDataProduct(body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#createDataProduct");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        DataProductPayload body = ; // DataProductPayload | 
        try {
            Data product result = apiInstance.createDataProduct(body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#createDataProduct");
            e.printStackTrace();
        }
    }
}
DataProductPayload *body = ; //  (optional)

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Create a data product
[apiInstance createDataProductWith:body
              completionHandler: ^(Data product output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var opts = { 
  'body':  // {{DataProductPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.createDataProduct(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class createDataProductExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();
            var body = new DataProductPayload(); // DataProductPayload |  (optional) 

            try
            {
                // Create a data product
                Data product result = apiInstance.createDataProduct(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.createDataProduct: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();
$body = ; // DataProductPayload | 

try {
    $result = $api_instance->createDataProduct($body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->createDataProduct: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();
my $body = WWW::SwaggerClient::Object::DataProductPayload->new(); # DataProductPayload | 

eval { 
    my $result = $api_instance->createDataProduct(body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DataProductsApi->createDataProduct: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()
body =  # DataProductPayload |  (optional)

try: 
    # Create a data product
    api_response = api_instance.create_data_product(body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DataProductsApi->createDataProduct: %s\n" % e)

Parameters

Body parameters
Name Description
body
{

Data for creating or updating a data product

Required: catalogName,dataDomainId,name,summary
name:
string minLength:1 maxLength:40

Data product name.

example: Campaign performance
catalogName:
string minLength:1 maxLength:255

Catalog for this data product.

example: data_products
dataDomainId:
string (uuid)

UUID of the domain that this data product belongs to.

example: 00e29ec8-21f1-4239-afe3-05ee5a3ef57c
summary:
string maxLength:150

Summary description for this data product.

example: This data product provides details about the performance of the organization's marketing campaigns.
description:
string

Detailed description for this data product.

example: How the data is generated, how frequently it is updated, and any other relevant information for the users of the data product.
views:
[

List of view datasets

{

Data for creating or updating a view dataset

Required: name
name:
string maxLength:255

Name of the dataset. Must be a valid SQL name with lowercase letters.

example: campaign_performance_by_quarter
description:
string

Description of the dataset.

example: Campaign performance data per quarter.
definitionQuery:
string

Definition query for the dataset.

example: SELECT name AS region_name FROM tpch.sf1.region
columns:
[

List of column definitions for the dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

Whether this dataset is marked to be deleted in the next publishing workflow

}
]
materializedViews:
[

List of materialized view datasets

{

Data for creating or updating a materialized view

Required: name
name:
string maxLength:255

Name of the dataset. Must be a valid SQL name with lowercase letters.

example: campaign_performance_by_quarter
description:
string

Description of the dataset.

example: Campaign performance data per quarter.
definitionQuery:
string

Definition query for the materialized view.

example: SELECT name AS region_name FROM tpch.sf1.region
definitionProperties:
{

Map of definition properties for the materialized view. Valid keys are refresh_interval and incremental_column.

}
example: "refresh_interval" : "60m"
columns:
[

List of column definitions for the dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

Whether this dataset is marked to be deleted in the next publishing workflow

}
]
owners:
[

User-supplied list of owners. Used to indicate who is maintaining this data product.

{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
relevantLinks:
[

Relevant links for this data product.

{

Relevant link for a data product

Required: label,url
label:
string maxLength:255

Label for the link.

example: Example Link
url:
string maxLength:255

URL of the link.

example: https://example.com
}
]
}

Responses

Status: 200 - Success

{

Detailed data for a data product

Required: userData
id:
string (uuid)

Data product UUID

name:
string minLength:1 maxLength:40

Data product name.

catalogName:
string minLength:1 maxLength:255

Catalog to store this data product.

schemaName:
string minLength:1 maxLength:255

Trino schema name that will be generated for this data product.

dataDomainId:
string (uuid)

UUID of the domain that this data product belongs to.

summary:
string maxLength:150

Summary description for this data product.

description:
string

Description for this data product.

createdBy:
string minLength:1 maxLength:255

User who created this data product.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
views:
[

View datasets for this data product.

{

Detailed data for a view dataset

Required: columns,createdAt,createdBy,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the view dataset.

description:
string

Description of the view dataset.

createdBy:
string

Name of the user who created the view dataset.

definitionQuery:
string

Definition query for the dataset.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions of the view dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this view dataset will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this view dataset was created.

updatedAt:
string (date-time)

Timestamp of when this view dataset was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the view dataset. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this view dataset was last published.

publishedBy:
string

Name of the user who last published the view dataset.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
materializedViews:
[

Materialized views for this data product.

{

Detailed data for a materialized view

Required: columns,createdAt,createdBy,definitionProperties,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the materialized view.

description:
string

Description of the materialized view.

createdBy:
string

Name of the user who created the materialized view.

definitionQuery:
string

Definition query for the materialized view.

definitionProperties:
{

Definition properties for the materialized view.

}
status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this materialized view will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this materialized view was created.

updatedAt:
string (date-time)

Timestamp of when this materialized view was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the materialized view. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this materialized view was last published.

publishedBy:
string

Name of the user who last published the materialized view.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
owners:
[
{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
relevantLinks:
[

Relevant links for this data product.

{

Relevant link for a data product

Required: label,url
label:
string maxLength:255

Label for the link.

example: Example Link
url:
string maxLength:255

URL of the link.

example: https://example.com
}
]
createdAt:
string (date-time)

Timestamp of when this data product was created.

updatedAt:
string (date-time)

Timestamp of when this data product was last updated. Will be initialized to createdAt timestamp.

updatedBy:
string minLength:1 maxLength:255

User who last updated this data product.

publishedAt:
string (date-time)

Timestamp of when this data product was last published.

publishedBy:
string minLength:1 maxLength:255

User who published this data product.

accessMetadata:
{

Access metadata for a data product

lastQueriedAt:
string (date-time)

Timestamp when this data product was last queried

lastQueriedBy:
string

User who last queried this data product

}
ratingsAverage:
number (float) minimum:1 maximum:5

Average user rating of this data product. If empty then this data product has not been rated yet.

ratingsCount:
integer (int32)

Number of user ratings of this data product.

userData:
{

Detailed data product data for the authorized user

Required: isBookmarked
isBookmarked:
boolean

True if the authorized user has bookmarked this data product.

rating:
integer (int32) minimum:1 maximum:5

Rating given to this data product by the authorized user.

}
matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

bookmarkCount:
integer (int32)

The number of bookmarks for this data product.

productOwners:
[

User-supplied list of owners. Used to indicate who is maintaining this data product.

{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
}

Status: 400 - Bad Request

Status: 403 - Forbidden

Status: 409 - Conflict


getDataProduct

Get a data product by identifier


/api/v1/dataProduct/products/{dataProductId}

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/dataProduct/products/{dataProductId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            Data product result = apiInstance.getDataProduct(dataProductId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#getDataProduct");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            Data product result = apiInstance.getDataProduct(dataProductId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#getDataProduct");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Get a data product by identifier
[apiInstance getDataProductWith:dataProductId
              completionHandler: ^(Data product output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getDataProduct(dataProductId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getDataProductExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();
            var dataProductId = new UUID(); // UUID | 

            try
            {
                // Get a data product by identifier
                Data product result = apiInstance.getDataProduct(dataProductId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.getDataProduct: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 

try {
    $result = $api_instance->getDataProduct($dataProductId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->getDataProduct: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 

eval { 
    my $result = $api_instance->getDataProduct(dataProductId => $dataProductId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DataProductsApi->getDataProduct: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 

try: 
    # Get a data product by identifier
    api_response = api_instance.get_data_product(dataProductId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DataProductsApi->getDataProduct: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required

Responses

Status: 200 - Success

{

Detailed data for a data product

Required: userData
id:
string (uuid)

Data product UUID

name:
string minLength:1 maxLength:40

Data product name.

catalogName:
string minLength:1 maxLength:255

Catalog to store this data product.

schemaName:
string minLength:1 maxLength:255

Trino schema name that will be generated for this data product.

dataDomainId:
string (uuid)

UUID of the domain that this data product belongs to.

summary:
string maxLength:150

Summary description for this data product.

description:
string

Description for this data product.

createdBy:
string minLength:1 maxLength:255

User who created this data product.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
views:
[

View datasets for this data product.

{

Detailed data for a view dataset

Required: columns,createdAt,createdBy,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the view dataset.

description:
string

Description of the view dataset.

createdBy:
string

Name of the user who created the view dataset.

definitionQuery:
string

Definition query for the dataset.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions of the view dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this view dataset will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this view dataset was created.

updatedAt:
string (date-time)

Timestamp of when this view dataset was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the view dataset. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this view dataset was last published.

publishedBy:
string

Name of the user who last published the view dataset.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
materializedViews:
[

Materialized views for this data product.

{

Detailed data for a materialized view

Required: columns,createdAt,createdBy,definitionProperties,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the materialized view.

description:
string

Description of the materialized view.

createdBy:
string

Name of the user who created the materialized view.

definitionQuery:
string

Definition query for the materialized view.

definitionProperties:
{

Definition properties for the materialized view.

}
status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this materialized view will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this materialized view was created.

updatedAt:
string (date-time)

Timestamp of when this materialized view was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the materialized view. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this materialized view was last published.

publishedBy:
string

Name of the user who last published the materialized view.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
owners:
[
{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
relevantLinks:
[

Relevant links for this data product.

{

Relevant link for a data product

Required: label,url
label:
string maxLength:255

Label for the link.

example: Example Link
url:
string maxLength:255

URL of the link.

example: https://example.com
}
]
createdAt:
string (date-time)

Timestamp of when this data product was created.

updatedAt:
string (date-time)

Timestamp of when this data product was last updated. Will be initialized to createdAt timestamp.

updatedBy:
string minLength:1 maxLength:255

User who last updated this data product.

publishedAt:
string (date-time)

Timestamp of when this data product was last published.

publishedBy:
string minLength:1 maxLength:255

User who published this data product.

accessMetadata:
{

Access metadata for a data product

lastQueriedAt:
string (date-time)

Timestamp when this data product was last queried

lastQueriedBy:
string

User who last queried this data product

}
ratingsAverage:
number (float) minimum:1 maximum:5

Average user rating of this data product. If empty then this data product has not been rated yet.

ratingsCount:
integer (int32)

Number of user ratings of this data product.

userData:
{

Detailed data product data for the authorized user

Required: isBookmarked
isBookmarked:
boolean

True if the authorized user has bookmarked this data product.

rating:
integer (int32) minimum:1 maximum:5

Rating given to this data product by the authorized user.

}
matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

bookmarkCount:
integer (int32)

The number of bookmarks for this data product.

productOwners:
[

User-supplied list of owners. Used to indicate who is maintaining this data product.

{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
}

Status: 403 - Forbidden

Status: 404 - Not found


getMaterializedViewRefreshMetadata

Get refresh meta data about a materialized view that belongs to a data product


/api/v1/dataProduct/products/{dataProductId}/materializedViews/{viewName}/refreshMetadata

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/dataProduct/products/{dataProductId}/materializedViews/{viewName}/refreshMetadata"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        String viewName = viewName_example; // String | 
        try {
            Materialized view refresh metadata result = apiInstance.getMaterializedViewRefreshMetadata(dataProductId, viewName);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#getMaterializedViewRefreshMetadata");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        String viewName = viewName_example; // String | 
        try {
            Materialized view refresh metadata result = apiInstance.getMaterializedViewRefreshMetadata(dataProductId, viewName);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#getMaterializedViewRefreshMetadata");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
String *viewName = viewName_example; // 

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Get refresh meta data about a materialized view that belongs to a data product
[apiInstance getMaterializedViewRefreshMetadataWith:dataProductId
    viewName:viewName
              completionHandler: ^(Materialized view refresh metadata output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var viewName = viewName_example; // {{String}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getMaterializedViewRefreshMetadata(dataProductId, viewName, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getMaterializedViewRefreshMetadataExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();
            var dataProductId = new UUID(); // UUID | 
            var viewName = viewName_example;  // String | 

            try
            {
                // Get refresh meta data about a materialized view that belongs to a data product
                Materialized view refresh metadata result = apiInstance.getMaterializedViewRefreshMetadata(dataProductId, viewName);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.getMaterializedViewRefreshMetadata: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$viewName = viewName_example; // String | 

try {
    $result = $api_instance->getMaterializedViewRefreshMetadata($dataProductId, $viewName);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->getMaterializedViewRefreshMetadata: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $viewName = viewName_example; # String | 

eval { 
    my $result = $api_instance->getMaterializedViewRefreshMetadata(dataProductId => $dataProductId, viewName => $viewName);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DataProductsApi->getMaterializedViewRefreshMetadata: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
viewName = viewName_example # String | 

try: 
    # Get refresh meta data about a materialized view that belongs to a data product
    api_response = api_instance.get_materialized_view_refresh_metadata(dataProductId, viewName)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DataProductsApi->getMaterializedViewRefreshMetadata: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required
viewName*
String
Required

Responses

Status: 200 - Success

{

Materialized view refresh metadata, such as last import status, only available for Hive catalogs

lastImport:
{

Materialized View import metadata, such as scheduled time, only available for Hive catalogs

status:
string

Import status.

scheduledTime:
string (date-time)

Scheduled time of the import.

startTime:
string (date-time)

The start time of the import.

finishTime:
string (date-time)

The finish time of the import.

rowCount:
integer (int64)

Row count of the import.

error:
string

Error message of the import.

}
incrementalColumn:
string

Column used for incremental refresh to apply an incremental_column > max(incremental_column) filter when loading data incrementally from the source table. This facilitates loading only newer data from the source table instead of the entire table in each refresh iteration. If no column is specified, a full refresh is executed. The column need to be monotonically increasing with each new record. Typically types are dates or increasing integer values used as identifiers.

refreshInterval:
string

Refresh interval of the materialized view. Minimum duration is 60 minutes.

estimatedNextRefreshTime:
string (date-time)

Estimated time for the next refresh of the materialized view.

}

Status: 403 - Forbidden

Status: 404 - Not found


getOpenApi

Return the OpenAPI specification for the Data Product API. Use Accept header of 'application/yaml' to request a YAML response instead of JSON.


/api/v1/dataProduct/openApi

Usage and SDK Samples

curl -X GET\
-H "Accept: application/yaml"\
"//api/v1/dataProduct/openApi"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        try {
            apiInstance.getOpenApi();
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#getOpenApi");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        try {
            apiInstance.getOpenApi();
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#getOpenApi");
            e.printStackTrace();
        }
    }
}

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Return the OpenAPI specification for the Data Product API.  Use Accept header of 'application/yaml' to request a YAML response instead of JSON.
[apiInstance getOpenApiWithCompletionHandler: 
              ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.getOpenApi(callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getOpenApiExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();

            try
            {
                // Return the OpenAPI specification for the Data Product API.  Use Accept header of 'application/yaml' to request a YAML response instead of JSON.
                apiInstance.getOpenApi();
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.getOpenApi: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();

try {
    $api_instance->getOpenApi();
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->getOpenApi: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();

eval { 
    $api_instance->getOpenApi();
};
if ($@) {
    warn "Exception when calling DataProductsApi->getOpenApi: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()

try: 
    # Return the OpenAPI specification for the Data Product API.  Use Accept header of 'application/yaml' to request a YAML response instead of JSON.
    api_instance.get_open_api()
except ApiException as e:
    print("Exception when calling DataProductsApi->getOpenApi: %s\n" % e)

Parameters

Responses

Status: 200 - Success


getTargetCatalogs

Return all catalogs suitable to store data products


/api/v1/dataProduct/catalogs

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/dataProduct/catalogs"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        try {
            array[CatalogDetails] result = apiInstance.getTargetCatalogs();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#getTargetCatalogs");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        try {
            array[CatalogDetails] result = apiInstance.getTargetCatalogs();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#getTargetCatalogs");
            e.printStackTrace();
        }
    }
}

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Return all catalogs suitable to store data products
[apiInstance getTargetCatalogsWithCompletionHandler: 
              ^(array[CatalogDetails] output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getTargetCatalogs(callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getTargetCatalogsExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();

            try
            {
                // Return all catalogs suitable to store data products
                array[CatalogDetails] result = apiInstance.getTargetCatalogs();
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.getTargetCatalogs: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();

try {
    $result = $api_instance->getTargetCatalogs();
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->getTargetCatalogs: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();

eval { 
    my $result = $api_instance->getTargetCatalogs();
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DataProductsApi->getTargetCatalogs: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()

try: 
    # Return all catalogs suitable to store data products
    api_response = api_instance.get_target_catalogs()
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DataProductsApi->getTargetCatalogs: %s\n" % e)

Parameters

Responses

Status: 200 - Success

[
{

Detailed information for a catalog suitable to store data products.

Required: catalogName,connectorName,isMaterializedViewEnabled
catalogName:
string minLength:1 maxLength:255

Name of the catalog.

connectorName:
string minLength:1 maxLength:255

Name of the connector for this catalog.

isMaterializedViewEnabled:
boolean

Whether materialized views are enabled or not for this catalog.

}
]

listSampleQueries

Get the sample queries for a data product


/api/v1/dataProduct/products/{dataProductId}/sampleQueries

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/dataProduct/products/{dataProductId}/sampleQueries"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            array[SampleQuery] result = apiInstance.listSampleQueries(dataProductId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#listSampleQueries");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            array[SampleQuery] result = apiInstance.listSampleQueries(dataProductId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#listSampleQueries");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Get the sample queries for a data product
[apiInstance listSampleQueriesWith:dataProductId
              completionHandler: ^(array[SampleQuery] output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listSampleQueries(dataProductId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listSampleQueriesExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();
            var dataProductId = new UUID(); // UUID | 

            try
            {
                // Get the sample queries for a data product
                array[SampleQuery] result = apiInstance.listSampleQueries(dataProductId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.listSampleQueries: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 

try {
    $result = $api_instance->listSampleQueries($dataProductId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->listSampleQueries: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 

eval { 
    my $result = $api_instance->listSampleQueries(dataProductId => $dataProductId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DataProductsApi->listSampleQueries: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 

try: 
    # Get the sample queries for a data product
    api_response = api_instance.list_sample_queries(dataProductId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DataProductsApi->listSampleQueries: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required

Responses

Status: 200 - Success

[
{

Sample query for the data product

Required: name,query
name:
string minLength:1 maxLength:40

Name of the sample query

example: Select the name of all regions
description:
string minLength:1 maxLength:255

Description for the sample query

example: This query selects the name of all regions from the tpch.sf1 schema
query:
string

Text with the data product sample query

example: SELECT * FROM tpch.sf1.region
}
]

Status: 403 - Forbidden


reassignDomainForDataProducts

Reassign the domain for a list of data products


/api/v1/dataProduct/products/reassignDomain

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/dataProduct/products/reassignDomain"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        DomainReassignmentRequest body = ; // DomainReassignmentRequest | 
        try {
            apiInstance.reassignDomainForDataProducts(body);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#reassignDomainForDataProducts");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        DomainReassignmentRequest body = ; // DomainReassignmentRequest | 
        try {
            apiInstance.reassignDomainForDataProducts(body);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#reassignDomainForDataProducts");
            e.printStackTrace();
        }
    }
}
DomainReassignmentRequest *body = ; //  (optional)

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Reassign the domain for a list of data products
[apiInstance reassignDomainForDataProductsWith:body
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var opts = { 
  'body':  // {{DomainReassignmentRequest}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.reassignDomainForDataProducts(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class reassignDomainForDataProductsExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();
            var body = new DomainReassignmentRequest(); // DomainReassignmentRequest |  (optional) 

            try
            {
                // Reassign the domain for a list of data products
                apiInstance.reassignDomainForDataProducts(body);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.reassignDomainForDataProducts: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();
$body = ; // DomainReassignmentRequest | 

try {
    $api_instance->reassignDomainForDataProducts($body);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->reassignDomainForDataProducts: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();
my $body = WWW::SwaggerClient::Object::DomainReassignmentRequest->new(); # DomainReassignmentRequest | 

eval { 
    $api_instance->reassignDomainForDataProducts(body => $body);
};
if ($@) {
    warn "Exception when calling DataProductsApi->reassignDomainForDataProducts: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()
body =  # DomainReassignmentRequest |  (optional)

try: 
    # Reassign the domain for a list of data products
    api_instance.reassign_domain_for_data_products(body=body)
except ApiException as e:
    print("Exception when calling DataProductsApi->reassignDomainForDataProducts: %s\n" % e)

Parameters

Body parameters
Name Description
body
{

Request values for reassigning domains

Required: dataProductIds,newDomainId
dataProductIds:
[

List of Data Product IDs that will be reassigned

string (uuid)

List of Data Product IDs that will be reassigned

]
newDomainId:
string (uuid)

All Data Products specified in the ID list will be reassigned to this domain.

}

Responses

Status: 204 - Success

Status: 400 - Bad Request

Status: 403 - Forbidden

Status: 404 - Not found


searchDataProducts

Search for data products according to the searchOptions request parameter.

This endpoint returns the first 100 data products matching the given searchOptions parameter. The number of results can be configured in the limit attribute of the searchOptions, up to a maximum of 1000.


/api/v1/dataProduct/products

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/dataProduct/products?searchOptions="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        SearchOptionsParam searchOptions = ; // SearchOptionsParam | 
        try {
            array[Data product summary] result = apiInstance.searchDataProducts(searchOptions);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#searchDataProducts");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        SearchOptionsParam searchOptions = ; // SearchOptionsParam | 
        try {
            array[Data product summary] result = apiInstance.searchDataProducts(searchOptions);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#searchDataProducts");
            e.printStackTrace();
        }
    }
}
SearchOptionsParam *searchOptions = ; //  (optional)

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Search for data products according to the searchOptions request parameter.
[apiInstance searchDataProductsWith:searchOptions
              completionHandler: ^(array[Data product summary] output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var opts = { 
  'searchOptions':  // {{SearchOptionsParam}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.searchDataProducts(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class searchDataProductsExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();
            var searchOptions = new SearchOptionsParam(); // SearchOptionsParam |  (optional) 

            try
            {
                // Search for data products according to the searchOptions request parameter.
                array[Data product summary] result = apiInstance.searchDataProducts(searchOptions);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.searchDataProducts: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();
$searchOptions = ; // SearchOptionsParam | 

try {
    $result = $api_instance->searchDataProducts($searchOptions);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->searchDataProducts: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();
my $searchOptions = ; # SearchOptionsParam | 

eval { 
    my $result = $api_instance->searchDataProducts(searchOptions => $searchOptions);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DataProductsApi->searchDataProducts: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()
searchOptions =  # SearchOptionsParam |  (optional)

try: 
    # Search for data products according to the searchOptions request parameter.
    api_response = api_instance.search_data_products(searchOptions=searchOptions)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DataProductsApi->searchDataProducts: %s\n" % e)

Parameters

Query parameters
Name Description
searchOptions
SearchOptionsParam

Responses

Status: 200 - Success

[
{

Summary data for a list of data products

Required: userData
id:
string (uuid)

Data product ID

name:
string minLength:1 maxLength:40

Data product name.

catalogName:
string minLength:1 maxLength:255

Catalog for this data product.

schemaName:
string minLength:1 maxLength:255

Trino schema name that will be generated for this data product.

dataDomainId:
string (uuid)

ID of the domain that this data product belongs to.

summary:
string maxLength:150

Summary description for this data product.

description:
string

Description for this data product.

createdBy:
string minLength:1 maxLength:255

User who created this data product.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
createdAt:
string (date-time)

Timestamp of when this data product was created.

updatedAt:
string (date-time)

Timestamp of when this data product was last updated. Will be initialized to createdAt timestamp.

publishedAt:
string (date-time)

Timestamp of when this data product was last published.

publishedBy:
string minLength:1 maxLength:255

User who published this data product.

lastQueriedAt:
string (date-time)

Timestamp of when this data product was last queried.

lastQueriedBy:
string minLength:1 maxLength:255

Last user who used this data product.

ratingsAverage:
number (float) minimum:1 maximum:5

Average user rating of this data product. If empty then this data product has not been rated yet.

ratingsCount:
integer (int32)

Number of user ratings of this data product.

userData:
{

Detailed data product data for the authorized user

Required: isBookmarked
isBookmarked:
boolean

True if the authorized user has bookmarked this data product.

rating:
integer (int32) minimum:1 maximum:5

Rating given to this data product by the authorized user.

}
}
]

updateDataProduct

Update a data product


/api/v1/dataProduct/products/{dataProductId}

Usage and SDK Samples

curl -X PUT\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/dataProduct/products/{dataProductId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        DataProductPayload body = ; // DataProductPayload | 
        try {
            Data product result = apiInstance.updateDataProduct(dataProductId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#updateDataProduct");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        DataProductPayload body = ; // DataProductPayload | 
        try {
            Data product result = apiInstance.updateDataProduct(dataProductId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#updateDataProduct");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
DataProductPayload *body = ; //  (optional)

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Update a data product
[apiInstance updateDataProductWith:dataProductId
    body:body
              completionHandler: ^(Data product output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var opts = { 
  'body':  // {{DataProductPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.updateDataProduct(dataProductId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class updateDataProductExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();
            var dataProductId = new UUID(); // UUID | 
            var body = new DataProductPayload(); // DataProductPayload |  (optional) 

            try
            {
                // Update a data product
                Data product result = apiInstance.updateDataProduct(dataProductId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.updateDataProduct: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$body = ; // DataProductPayload | 

try {
    $result = $api_instance->updateDataProduct($dataProductId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->updateDataProduct: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $body = WWW::SwaggerClient::Object::DataProductPayload->new(); # DataProductPayload | 

eval { 
    my $result = $api_instance->updateDataProduct(dataProductId => $dataProductId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DataProductsApi->updateDataProduct: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
body =  # DataProductPayload |  (optional)

try: 
    # Update a data product
    api_response = api_instance.update_data_product(dataProductId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DataProductsApi->updateDataProduct: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required
Body parameters
Name Description
body
{

Data for creating or updating a data product

Required: catalogName,dataDomainId,name,summary
name:
string minLength:1 maxLength:40

Data product name.

example: Campaign performance
catalogName:
string minLength:1 maxLength:255

Catalog for this data product.

example: data_products
dataDomainId:
string (uuid)

UUID of the domain that this data product belongs to.

example: 00e29ec8-21f1-4239-afe3-05ee5a3ef57c
summary:
string maxLength:150

Summary description for this data product.

example: This data product provides details about the performance of the organization's marketing campaigns.
description:
string

Detailed description for this data product.

example: How the data is generated, how frequently it is updated, and any other relevant information for the users of the data product.
views:
[

List of view datasets

{

Data for creating or updating a view dataset

Required: name
name:
string maxLength:255

Name of the dataset. Must be a valid SQL name with lowercase letters.

example: campaign_performance_by_quarter
description:
string

Description of the dataset.

example: Campaign performance data per quarter.
definitionQuery:
string

Definition query for the dataset.

example: SELECT name AS region_name FROM tpch.sf1.region
columns:
[

List of column definitions for the dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

Whether this dataset is marked to be deleted in the next publishing workflow

}
]
materializedViews:
[

List of materialized view datasets

{

Data for creating or updating a materialized view

Required: name
name:
string maxLength:255

Name of the dataset. Must be a valid SQL name with lowercase letters.

example: campaign_performance_by_quarter
description:
string

Description of the dataset.

example: Campaign performance data per quarter.
definitionQuery:
string

Definition query for the materialized view.

example: SELECT name AS region_name FROM tpch.sf1.region
definitionProperties:
{

Map of definition properties for the materialized view. Valid keys are refresh_interval and incremental_column.

}
example: "refresh_interval" : "60m"
columns:
[

List of column definitions for the dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

Whether this dataset is marked to be deleted in the next publishing workflow

}
]
owners:
[

User-supplied list of owners. Used to indicate who is maintaining this data product.

{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
relevantLinks:
[

Relevant links for this data product.

{

Relevant link for a data product

Required: label,url
label:
string maxLength:255

Label for the link.

example: Example Link
url:
string maxLength:255

URL of the link.

example: https://example.com
}
]
}

Responses

Status: 200 - Success

{

Detailed data for a data product

Required: userData
id:
string (uuid)

Data product UUID

name:
string minLength:1 maxLength:40

Data product name.

catalogName:
string minLength:1 maxLength:255

Catalog to store this data product.

schemaName:
string minLength:1 maxLength:255

Trino schema name that will be generated for this data product.

dataDomainId:
string (uuid)

UUID of the domain that this data product belongs to.

summary:
string maxLength:150

Summary description for this data product.

description:
string

Description for this data product.

createdBy:
string minLength:1 maxLength:255

User who created this data product.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
views:
[

View datasets for this data product.

{

Detailed data for a view dataset

Required: columns,createdAt,createdBy,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the view dataset.

description:
string

Description of the view dataset.

createdBy:
string

Name of the user who created the view dataset.

definitionQuery:
string

Definition query for the dataset.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions of the view dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this view dataset will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this view dataset was created.

updatedAt:
string (date-time)

Timestamp of when this view dataset was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the view dataset. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this view dataset was last published.

publishedBy:
string

Name of the user who last published the view dataset.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
materializedViews:
[

Materialized views for this data product.

{

Detailed data for a materialized view

Required: columns,createdAt,createdBy,definitionProperties,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the materialized view.

description:
string

Description of the materialized view.

createdBy:
string

Name of the user who created the materialized view.

definitionQuery:
string

Definition query for the materialized view.

definitionProperties:
{

Definition properties for the materialized view.

}
status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this materialized view will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this materialized view was created.

updatedAt:
string (date-time)

Timestamp of when this materialized view was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the materialized view. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this materialized view was last published.

publishedBy:
string

Name of the user who last published the materialized view.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
owners:
[
{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
relevantLinks:
[

Relevant links for this data product.

{

Relevant link for a data product

Required: label,url
label:
string maxLength:255

Label for the link.

example: Example Link
url:
string maxLength:255

URL of the link.

example: https://example.com
}
]
createdAt:
string (date-time)

Timestamp of when this data product was created.

updatedAt:
string (date-time)

Timestamp of when this data product was last updated. Will be initialized to createdAt timestamp.

updatedBy:
string minLength:1 maxLength:255

User who last updated this data product.

publishedAt:
string (date-time)

Timestamp of when this data product was last published.

publishedBy:
string minLength:1 maxLength:255

User who published this data product.

accessMetadata:
{

Access metadata for a data product

lastQueriedAt:
string (date-time)

Timestamp when this data product was last queried

lastQueriedBy:
string

User who last queried this data product

}
ratingsAverage:
number (float) minimum:1 maximum:5

Average user rating of this data product. If empty then this data product has not been rated yet.

ratingsCount:
integer (int32)

Number of user ratings of this data product.

userData:
{

Detailed data product data for the authorized user

Required: isBookmarked
isBookmarked:
boolean

True if the authorized user has bookmarked this data product.

rating:
integer (int32) minimum:1 maximum:5

Rating given to this data product by the authorized user.

}
matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

bookmarkCount:
integer (int32)

The number of bookmarks for this data product.

productOwners:
[

User-supplied list of owners. Used to indicate who is maintaining this data product.

{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
}

Status: 400 - Bad Request

Status: 403 - Forbidden

Status: 404 - Not found

Status: 409 - Conflict


updateMaterializedViewInDataProduct

Create/Update a materialized view in data product


/api/v1/dataProduct/products/{dataProductId}/materializedViews

Usage and SDK Samples

curl -X PUT\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/dataProduct/products/{dataProductId}/materializedViews"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        MaterializedViewDatasetPayload body = ; // MaterializedViewDatasetPayload | 
        try {
            Data product result = apiInstance.updateMaterializedViewInDataProduct(dataProductId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#updateMaterializedViewInDataProduct");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        MaterializedViewDatasetPayload body = ; // MaterializedViewDatasetPayload | 
        try {
            Data product result = apiInstance.updateMaterializedViewInDataProduct(dataProductId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#updateMaterializedViewInDataProduct");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
MaterializedViewDatasetPayload *body = ; //  (optional)

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Create/Update a materialized view in data product
[apiInstance updateMaterializedViewInDataProductWith:dataProductId
    body:body
              completionHandler: ^(Data product output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var opts = { 
  'body':  // {{MaterializedViewDatasetPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.updateMaterializedViewInDataProduct(dataProductId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class updateMaterializedViewInDataProductExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();
            var dataProductId = new UUID(); // UUID | 
            var body = new MaterializedViewDatasetPayload(); // MaterializedViewDatasetPayload |  (optional) 

            try
            {
                // Create/Update a materialized view in data product
                Data product result = apiInstance.updateMaterializedViewInDataProduct(dataProductId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.updateMaterializedViewInDataProduct: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$body = ; // MaterializedViewDatasetPayload | 

try {
    $result = $api_instance->updateMaterializedViewInDataProduct($dataProductId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->updateMaterializedViewInDataProduct: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $body = WWW::SwaggerClient::Object::MaterializedViewDatasetPayload->new(); # MaterializedViewDatasetPayload | 

eval { 
    my $result = $api_instance->updateMaterializedViewInDataProduct(dataProductId => $dataProductId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DataProductsApi->updateMaterializedViewInDataProduct: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
body =  # MaterializedViewDatasetPayload |  (optional)

try: 
    # Create/Update a materialized view in data product
    api_response = api_instance.update_materialized_view_in_data_product(dataProductId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DataProductsApi->updateMaterializedViewInDataProduct: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required
Body parameters
Name Description
body
{

Data for creating or updating a materialized view

Required: name
name:
string maxLength:255

Name of the dataset. Must be a valid SQL name with lowercase letters.

example: campaign_performance_by_quarter
description:
string

Description of the dataset.

example: Campaign performance data per quarter.
definitionQuery:
string

Definition query for the materialized view.

example: SELECT name AS region_name FROM tpch.sf1.region
definitionProperties:
{

Map of definition properties for the materialized view. Valid keys are refresh_interval and incremental_column.

}
example: "refresh_interval" : "60m"
columns:
[

List of column definitions for the dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

Whether this dataset is marked to be deleted in the next publishing workflow

}

Responses

Status: 200 - Success

{

Detailed data for a data product

Required: userData
id:
string (uuid)

Data product UUID

name:
string minLength:1 maxLength:40

Data product name.

catalogName:
string minLength:1 maxLength:255

Catalog to store this data product.

schemaName:
string minLength:1 maxLength:255

Trino schema name that will be generated for this data product.

dataDomainId:
string (uuid)

UUID of the domain that this data product belongs to.

summary:
string maxLength:150

Summary description for this data product.

description:
string

Description for this data product.

createdBy:
string minLength:1 maxLength:255

User who created this data product.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
views:
[

View datasets for this data product.

{

Detailed data for a view dataset

Required: columns,createdAt,createdBy,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the view dataset.

description:
string

Description of the view dataset.

createdBy:
string

Name of the user who created the view dataset.

definitionQuery:
string

Definition query for the dataset.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions of the view dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this view dataset will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this view dataset was created.

updatedAt:
string (date-time)

Timestamp of when this view dataset was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the view dataset. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this view dataset was last published.

publishedBy:
string

Name of the user who last published the view dataset.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
materializedViews:
[

Materialized views for this data product.

{

Detailed data for a materialized view

Required: columns,createdAt,createdBy,definitionProperties,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the materialized view.

description:
string

Description of the materialized view.

createdBy:
string

Name of the user who created the materialized view.

definitionQuery:
string

Definition query for the materialized view.

definitionProperties:
{

Definition properties for the materialized view.

}
status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this materialized view will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this materialized view was created.

updatedAt:
string (date-time)

Timestamp of when this materialized view was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the materialized view. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this materialized view was last published.

publishedBy:
string

Name of the user who last published the materialized view.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
owners:
[
{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
relevantLinks:
[

Relevant links for this data product.

{

Relevant link for a data product

Required: label,url
label:
string maxLength:255

Label for the link.

example: Example Link
url:
string maxLength:255

URL of the link.

example: https://example.com
}
]
createdAt:
string (date-time)

Timestamp of when this data product was created.

updatedAt:
string (date-time)

Timestamp of when this data product was last updated. Will be initialized to createdAt timestamp.

updatedBy:
string minLength:1 maxLength:255

User who last updated this data product.

publishedAt:
string (date-time)

Timestamp of when this data product was last published.

publishedBy:
string minLength:1 maxLength:255

User who published this data product.

accessMetadata:
{

Access metadata for a data product

lastQueriedAt:
string (date-time)

Timestamp when this data product was last queried

lastQueriedBy:
string

User who last queried this data product

}
ratingsAverage:
number (float) minimum:1 maximum:5

Average user rating of this data product. If empty then this data product has not been rated yet.

ratingsCount:
integer (int32)

Number of user ratings of this data product.

userData:
{

Detailed data product data for the authorized user

Required: isBookmarked
isBookmarked:
boolean

True if the authorized user has bookmarked this data product.

rating:
integer (int32) minimum:1 maximum:5

Rating given to this data product by the authorized user.

}
matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

bookmarkCount:
integer (int32)

The number of bookmarks for this data product.

productOwners:
[

User-supplied list of owners. Used to indicate who is maintaining this data product.

{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
}

Status: 400 - Bad Request

Status: 403 - Forbidden

Status: 404 - Not found

Status: 409 - Conflict


updateSampleQueries

Update sample queries for a data product


/api/v1/dataProduct/products/{dataProductId}/sampleQueries

Usage and SDK Samples

curl -X PUT\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/dataProduct/products/{dataProductId}/sampleQueries"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        array[SampleQuery] body = ; // array[SampleQuery] | 
        try {
            apiInstance.updateSampleQueries(dataProductId, body);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#updateSampleQueries");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        array[SampleQuery] body = ; // array[SampleQuery] | 
        try {
            apiInstance.updateSampleQueries(dataProductId, body);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#updateSampleQueries");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
array[SampleQuery] *body = ; //  (optional)

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Update sample queries for a data product
[apiInstance updateSampleQueriesWith:dataProductId
    body:body
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var opts = { 
  'body':  // {{array[SampleQuery]}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.updateSampleQueries(dataProductId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class updateSampleQueriesExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();
            var dataProductId = new UUID(); // UUID | 
            var body = new array[SampleQuery](); // array[SampleQuery] |  (optional) 

            try
            {
                // Update sample queries for a data product
                apiInstance.updateSampleQueries(dataProductId, body);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.updateSampleQueries: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$body = ; // array[SampleQuery] | 

try {
    $api_instance->updateSampleQueries($dataProductId, $body);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->updateSampleQueries: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $body = [WWW::SwaggerClient::Object::array[SampleQuery]->new()]; # array[SampleQuery] | 

eval { 
    $api_instance->updateSampleQueries(dataProductId => $dataProductId, body => $body);
};
if ($@) {
    warn "Exception when calling DataProductsApi->updateSampleQueries: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
body =  # array[SampleQuery] |  (optional)

try: 
    # Update sample queries for a data product
    api_instance.update_sample_queries(dataProductId, body=body)
except ApiException as e:
    print("Exception when calling DataProductsApi->updateSampleQueries: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required
Body parameters
Name Description
body
[
{

Sample query for the data product

Required: name,query
name:
string minLength:1 maxLength:40

Name of the sample query

example: Select the name of all regions
description:
string minLength:1 maxLength:255

Description for the sample query

example: This query selects the name of all regions from the tpch.sf1 schema
query:
string

Text with the data product sample query

example: SELECT * FROM tpch.sf1.region
}
]

Responses

Status: 204 - Success

Status: 400 - Bad Request

Status: 403 - Forbidden

Status: 404 - Not found


updateViewInDataProduct

Create/Updates a view in a DataProducts


/api/v1/dataProduct/products/{dataProductId}/views

Usage and SDK Samples

curl -X PUT\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/dataProduct/products/{dataProductId}/views"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DataProductsApi;

import java.io.File;
import java.util.*;

public class DataProductsApiExample {

    public static void main(String[] args) {
        
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        ViewDatasetPayload body = ; // ViewDatasetPayload | 
        try {
            Data product result = apiInstance.updateViewInDataProduct(dataProductId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#updateViewInDataProduct");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DataProductsApi;

public class DataProductsApiExample {

    public static void main(String[] args) {
        DataProductsApi apiInstance = new DataProductsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        ViewDatasetPayload body = ; // ViewDatasetPayload | 
        try {
            Data product result = apiInstance.updateViewInDataProduct(dataProductId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DataProductsApi#updateViewInDataProduct");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
ViewDatasetPayload *body = ; //  (optional)

DataProductsApi *apiInstance = [[DataProductsApi alloc] init];

// Create/Updates a view in a DataProducts
[apiInstance updateViewInDataProductWith:dataProductId
    body:body
              completionHandler: ^(Data product output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DataProductsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var opts = { 
  'body':  // {{ViewDatasetPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.updateViewInDataProduct(dataProductId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class updateViewInDataProductExample
    {
        public void main()
        {

            var apiInstance = new DataProductsApi();
            var dataProductId = new UUID(); // UUID | 
            var body = new ViewDatasetPayload(); // ViewDatasetPayload |  (optional) 

            try
            {
                // Create/Updates a view in a DataProducts
                Data product result = apiInstance.updateViewInDataProduct(dataProductId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DataProductsApi.updateViewInDataProduct: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDataProductsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$body = ; // ViewDatasetPayload | 

try {
    $result = $api_instance->updateViewInDataProduct($dataProductId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DataProductsApi->updateViewInDataProduct: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DataProductsApi;

my $api_instance = WWW::SwaggerClient::DataProductsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $body = WWW::SwaggerClient::Object::ViewDatasetPayload->new(); # ViewDatasetPayload | 

eval { 
    my $result = $api_instance->updateViewInDataProduct(dataProductId => $dataProductId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DataProductsApi->updateViewInDataProduct: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DataProductsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
body =  # ViewDatasetPayload |  (optional)

try: 
    # Create/Updates a view in a DataProducts
    api_response = api_instance.update_view_in_data_product(dataProductId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DataProductsApi->updateViewInDataProduct: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required
Body parameters
Name Description
body
{

Data for creating or updating a view dataset

Required: name
name:
string maxLength:255

Name of the dataset. Must be a valid SQL name with lowercase letters.

example: campaign_performance_by_quarter
description:
string

Description of the dataset.

example: Campaign performance data per quarter.
definitionQuery:
string

Definition query for the dataset.

example: SELECT name AS region_name FROM tpch.sf1.region
columns:
[

List of column definitions for the dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

Whether this dataset is marked to be deleted in the next publishing workflow

}

Responses

Status: 200 - Success

{

Detailed data for a data product

Required: userData
id:
string (uuid)

Data product UUID

name:
string minLength:1 maxLength:40

Data product name.

catalogName:
string minLength:1 maxLength:255

Catalog to store this data product.

schemaName:
string minLength:1 maxLength:255

Trino schema name that will be generated for this data product.

dataDomainId:
string (uuid)

UUID of the domain that this data product belongs to.

summary:
string maxLength:150

Summary description for this data product.

description:
string

Description for this data product.

createdBy:
string minLength:1 maxLength:255

User who created this data product.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
views:
[

View datasets for this data product.

{

Detailed data for a view dataset

Required: columns,createdAt,createdBy,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the view dataset.

description:
string

Description of the view dataset.

createdBy:
string

Name of the user who created the view dataset.

definitionQuery:
string

Definition query for the dataset.

status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions of the view dataset.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this view dataset will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this view dataset was created.

updatedAt:
string (date-time)

Timestamp of when this view dataset was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the view dataset. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this view dataset was last published.

publishedBy:
string

Name of the user who last published the view dataset.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
materializedViews:
[

Materialized views for this data product.

{

Detailed data for a materialized view

Required: columns,createdAt,createdBy,definitionProperties,definitionQuery,description,markedForDeletion,name,publishedAt,publishedBy,status,updatedAt,updatedBy
name:
string maxLength:255

Name of the materialized view.

description:
string

Description of the materialized view.

createdBy:
string

Name of the user who created the materialized view.

definitionQuery:
string

Definition query for the materialized view.

definitionProperties:
{

Definition properties for the materialized view.

}
status:
string

Publishing status of data product or dataset.

Enum: DRAFT, PUBLISHED, PENDING_CHANGES
columns:
[

Column definitions.

{

Definition of a dataset column

Required: description,name,type
name:
string maxLength:255

Name of the column.

example: region_name
type:
string maxLength:255

Type of the column.

example: text
description:
string maxLength:255

Column description.

example: Name of the geographic region associated with this data.
}
]
markedForDeletion:
boolean

If true, then this materialized view will be removed as part of the next publish.

createdAt:
string (date-time)

Timestamp of when this materialized view was created.

updatedAt:
string (date-time)

Timestamp of when this materialized view was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated the materialized view. This is initialized to createdBy

publishedAt:
string (date-time)

Timestamp of when this materialized view was last published.

publishedBy:
string

Name of the user who last published the materialized view.

matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

}
]
owners:
[
{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
relevantLinks:
[

Relevant links for this data product.

{

Relevant link for a data product

Required: label,url
label:
string maxLength:255

Label for the link.

example: Example Link
url:
string maxLength:255

URL of the link.

example: https://example.com
}
]
createdAt:
string (date-time)

Timestamp of when this data product was created.

updatedAt:
string (date-time)

Timestamp of when this data product was last updated. Will be initialized to createdAt timestamp.

updatedBy:
string minLength:1 maxLength:255

User who last updated this data product.

publishedAt:
string (date-time)

Timestamp of when this data product was last published.

publishedBy:
string minLength:1 maxLength:255

User who published this data product.

accessMetadata:
{

Access metadata for a data product

lastQueriedAt:
string (date-time)

Timestamp when this data product was last queried

lastQueriedBy:
string

User who last queried this data product

}
ratingsAverage:
number (float) minimum:1 maximum:5

Average user rating of this data product. If empty then this data product has not been rated yet.

ratingsCount:
integer (int32)

Number of user ratings of this data product.

userData:
{

Detailed data product data for the authorized user

Required: isBookmarked
isBookmarked:
boolean

True if the authorized user has bookmarked this data product.

rating:
integer (int32) minimum:1 maximum:5

Rating given to this data product by the authorized user.

}
matchesTrinoDefinition:
boolean

If published, this value is true if data product is in sync with what's created in Trino for all its components. Only set if the logged user has the permissions to query the Trino definitions for all datasets (Data Product Catalog information_schema for Views, and system.metadata.materialized_views for Materialized Views

bookmarkCount:
integer (int32)

The number of bookmarks for this data product.

productOwners:
[

User-supplied list of owners. Used to indicate who is maintaining this data product.

{

Data for a data product owner.

Required: email,name
name:
string minLength:1 maxLength:40

Name of the owner.

example: Alice Smith
email:
string minLength:1 maxLength:255

Data product name.

example: alice.smith@example.com
}
]
}

Status: 400 - Bad Request

Status: 403 - Forbidden

Status: 404 - Not found

Status: 409 - Conflict


Domains

createDomain

Create a data product domain


/api/v1/dataProduct/domains

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/dataProduct/domains"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DomainsApi;

import java.io.File;
import java.util.*;

public class DomainsApiExample {

    public static void main(String[] args) {
        
        DomainsApi apiInstance = new DomainsApi();
        CreateDataDomainRequest body = ; // CreateDataDomainRequest | 
        try {
            Data domain result = apiInstance.createDomain(body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DomainsApi#createDomain");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DomainsApi;

public class DomainsApiExample {

    public static void main(String[] args) {
        DomainsApi apiInstance = new DomainsApi();
        CreateDataDomainRequest body = ; // CreateDataDomainRequest | 
        try {
            Data domain result = apiInstance.createDomain(body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DomainsApi#createDomain");
            e.printStackTrace();
        }
    }
}
CreateDataDomainRequest *body = ; //  (optional)

DomainsApi *apiInstance = [[DomainsApi alloc] init];

// Create a data product domain
[apiInstance createDomainWith:body
              completionHandler: ^(Data domain output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DomainsApi()
var opts = { 
  'body':  // {{CreateDataDomainRequest}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.createDomain(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class createDomainExample
    {
        public void main()
        {

            var apiInstance = new DomainsApi();
            var body = new CreateDataDomainRequest(); // CreateDataDomainRequest |  (optional) 

            try
            {
                // Create a data product domain
                Data domain result = apiInstance.createDomain(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DomainsApi.createDomain: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDomainsApi();
$body = ; // CreateDataDomainRequest | 

try {
    $result = $api_instance->createDomain($body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DomainsApi->createDomain: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DomainsApi;

my $api_instance = WWW::SwaggerClient::DomainsApi->new();
my $body = WWW::SwaggerClient::Object::CreateDataDomainRequest->new(); # CreateDataDomainRequest | 

eval { 
    my $result = $api_instance->createDomain(body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DomainsApi->createDomain: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DomainsApi()
body =  # CreateDataDomainRequest |  (optional)

try: 
    # Create a data product domain
    api_response = api_instance.create_domain(body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DomainsApi->createDomain: %s\n" % e)

Parameters

Body parameters
Name Description
body
{

Data for creating a data product domain

Required: name
name:
string maxLength:255

Name of the domain.

example: Marketing
description:
string

Domain description.

example: This domain holds data published by the marketing team.
schemaLocation:
string (uri) maxLength:255

URI describing the location where to create the schema for the data products of this domain. If left empty, the default schema location for the data product's target catalog is used.

example: s3://my-bucket/marketing/
}

Responses

Status: 200 - Success

{

Detailed data describing a data product domain

Required: assignedDataProducts,createdAt,createdBy,id,name,updatedAt,updatedBy
id:
string (uuid)

Domain UUID.

name:
string maxLength:255

Name of the domain.

description:
string

Domain description.

schemaLocation:
string (uri) maxLength:255

URI describing the location where to create the schema for the data products of this domain. If left empty, the default schema location for the data product's target catalog will be used.

assignedDataProducts:
[

List of the data products that are assigned to this domain.

{

List of the data products that are assigned to this domain.

id:
string (uuid)
name:
string
}
]
createdBy:
string

Name of the user who created this domain.

createdAt:
string (date-time)

Timestamp of when this domain was created.

updatedAt:
string (date-time)

Timestamp of when this domain was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated this domain. This is initialized to createdBy

}

Status: 400 - Bad Request

Status: 403 - Forbidden


deleteDomain

Delete a data product domain


/api/v1/dataProduct/domains/{dataDomainId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: application/json"\
"//api/v1/dataProduct/domains/{dataDomainId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DomainsApi;

import java.io.File;
import java.util.*;

public class DomainsApiExample {

    public static void main(String[] args) {
        
        DomainsApi apiInstance = new DomainsApi();
        UUID dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            apiInstance.deleteDomain(dataDomainId);
        } catch (ApiException e) {
            System.err.println("Exception when calling DomainsApi#deleteDomain");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DomainsApi;

public class DomainsApiExample {

    public static void main(String[] args) {
        DomainsApi apiInstance = new DomainsApi();
        UUID dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            apiInstance.deleteDomain(dataDomainId);
        } catch (ApiException e) {
            System.err.println("Exception when calling DomainsApi#deleteDomain");
            e.printStackTrace();
        }
    }
}
UUID *dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 

DomainsApi *apiInstance = [[DomainsApi alloc] init];

// Delete a data product domain
[apiInstance deleteDomainWith:dataDomainId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DomainsApi()
var dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteDomain(dataDomainId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteDomainExample
    {
        public void main()
        {

            var apiInstance = new DomainsApi();
            var dataDomainId = new UUID(); // UUID | 

            try
            {
                // Delete a data product domain
                apiInstance.deleteDomain(dataDomainId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DomainsApi.deleteDomain: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDomainsApi();
$dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 

try {
    $api_instance->deleteDomain($dataDomainId);
} catch (Exception $e) {
    echo 'Exception when calling DomainsApi->deleteDomain: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DomainsApi;

my $api_instance = WWW::SwaggerClient::DomainsApi->new();
my $dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 

eval { 
    $api_instance->deleteDomain(dataDomainId => $dataDomainId);
};
if ($@) {
    warn "Exception when calling DomainsApi->deleteDomain: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DomainsApi()
dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 

try: 
    # Delete a data product domain
    api_instance.delete_domain(dataDomainId)
except ApiException as e:
    print("Exception when calling DomainsApi->deleteDomain: %s\n" % e)

Parameters

Path parameters
Name Description
dataDomainId*
UUID (uuid)
Required

Responses

Status: 204 - Success

Status: 403 - Forbidden

Status: 404 - Not found


getDomain

Get a data product domain by identifier


/api/v1/dataProduct/domains/{dataDomainId}

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/dataProduct/domains/{dataDomainId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DomainsApi;

import java.io.File;
import java.util.*;

public class DomainsApiExample {

    public static void main(String[] args) {
        
        DomainsApi apiInstance = new DomainsApi();
        UUID dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            Data domain result = apiInstance.getDomain(dataDomainId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DomainsApi#getDomain");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DomainsApi;

public class DomainsApiExample {

    public static void main(String[] args) {
        DomainsApi apiInstance = new DomainsApi();
        UUID dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            Data domain result = apiInstance.getDomain(dataDomainId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DomainsApi#getDomain");
            e.printStackTrace();
        }
    }
}
UUID *dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 

DomainsApi *apiInstance = [[DomainsApi alloc] init];

// Get a data product domain by identifier
[apiInstance getDomainWith:dataDomainId
              completionHandler: ^(Data domain output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DomainsApi()
var dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getDomain(dataDomainId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getDomainExample
    {
        public void main()
        {

            var apiInstance = new DomainsApi();
            var dataDomainId = new UUID(); // UUID | 

            try
            {
                // Get a data product domain by identifier
                Data domain result = apiInstance.getDomain(dataDomainId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DomainsApi.getDomain: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDomainsApi();
$dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 

try {
    $result = $api_instance->getDomain($dataDomainId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DomainsApi->getDomain: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DomainsApi;

my $api_instance = WWW::SwaggerClient::DomainsApi->new();
my $dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 

eval { 
    my $result = $api_instance->getDomain(dataDomainId => $dataDomainId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DomainsApi->getDomain: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DomainsApi()
dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 

try: 
    # Get a data product domain by identifier
    api_response = api_instance.get_domain(dataDomainId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DomainsApi->getDomain: %s\n" % e)

Parameters

Path parameters
Name Description
dataDomainId*
UUID (uuid)
Required

Responses

Status: 200 - Success

{

Detailed data describing a data product domain

Required: assignedDataProducts,createdAt,createdBy,id,name,updatedAt,updatedBy
id:
string (uuid)

Domain UUID.

name:
string maxLength:255

Name of the domain.

description:
string

Domain description.

schemaLocation:
string (uri) maxLength:255

URI describing the location where to create the schema for the data products of this domain. If left empty, the default schema location for the data product's target catalog will be used.

assignedDataProducts:
[

List of the data products that are assigned to this domain.

{

List of the data products that are assigned to this domain.

id:
string (uuid)
name:
string
}
]
createdBy:
string

Name of the user who created this domain.

createdAt:
string (date-time)

Timestamp of when this domain was created.

updatedAt:
string (date-time)

Timestamp of when this domain was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated this domain. This is initialized to createdBy

}

Status: 403 - Forbidden

Status: 404 - Not found


listDomains

List all data product domains


/api/v1/dataProduct/domains

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/dataProduct/domains"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DomainsApi;

import java.io.File;
import java.util.*;

public class DomainsApiExample {

    public static void main(String[] args) {
        
        DomainsApi apiInstance = new DomainsApi();
        try {
            array[Data domain] result = apiInstance.listDomains();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DomainsApi#listDomains");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DomainsApi;

public class DomainsApiExample {

    public static void main(String[] args) {
        DomainsApi apiInstance = new DomainsApi();
        try {
            array[Data domain] result = apiInstance.listDomains();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DomainsApi#listDomains");
            e.printStackTrace();
        }
    }
}

DomainsApi *apiInstance = [[DomainsApi alloc] init];

// List all data product domains
[apiInstance listDomainsWithCompletionHandler: 
              ^(array[Data domain] output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DomainsApi()
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listDomains(callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listDomainsExample
    {
        public void main()
        {

            var apiInstance = new DomainsApi();

            try
            {
                // List all data product domains
                array[Data domain] result = apiInstance.listDomains();
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DomainsApi.listDomains: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDomainsApi();

try {
    $result = $api_instance->listDomains();
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DomainsApi->listDomains: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DomainsApi;

my $api_instance = WWW::SwaggerClient::DomainsApi->new();

eval { 
    my $result = $api_instance->listDomains();
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DomainsApi->listDomains: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DomainsApi()

try: 
    # List all data product domains
    api_response = api_instance.list_domains()
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DomainsApi->listDomains: %s\n" % e)

Parameters

Responses

Status: 200 - Success

[
{

Detailed data describing a data product domain

Required: assignedDataProducts,createdAt,createdBy,id,name,updatedAt,updatedBy
id:
string (uuid)

Domain UUID.

name:
string maxLength:255

Name of the domain.

description:
string

Domain description.

schemaLocation:
string (uri) maxLength:255

URI describing the location where to create the schema for the data products of this domain. If left empty, the default schema location for the data product's target catalog will be used.

assignedDataProducts:
[

List of the data products that are assigned to this domain.

{

List of the data products that are assigned to this domain.

id:
string (uuid)
name:
string
}
]
createdBy:
string

Name of the user who created this domain.

createdAt:
string (date-time)

Timestamp of when this domain was created.

updatedAt:
string (date-time)

Timestamp of when this domain was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated this domain. This is initialized to createdBy

}
]

updateDomain

Update a data product domain


/api/v1/dataProduct/domains/{dataDomainId}

Usage and SDK Samples

curl -X PUT\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/dataProduct/domains/{dataDomainId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DomainsApi;

import java.io.File;
import java.util.*;

public class DomainsApiExample {

    public static void main(String[] args) {
        
        DomainsApi apiInstance = new DomainsApi();
        UUID dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        UpdateDataDomainRequest body = ; // UpdateDataDomainRequest | 
        try {
            Data domain result = apiInstance.updateDomain(dataDomainId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DomainsApi#updateDomain");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DomainsApi;

public class DomainsApiExample {

    public static void main(String[] args) {
        DomainsApi apiInstance = new DomainsApi();
        UUID dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        UpdateDataDomainRequest body = ; // UpdateDataDomainRequest | 
        try {
            Data domain result = apiInstance.updateDomain(dataDomainId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DomainsApi#updateDomain");
            e.printStackTrace();
        }
    }
}
UUID *dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
UpdateDataDomainRequest *body = ; //  (optional)

DomainsApi *apiInstance = [[DomainsApi alloc] init];

// Update a data product domain
[apiInstance updateDomainWith:dataDomainId
    body:body
              completionHandler: ^(Data domain output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.DomainsApi()
var dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var opts = { 
  'body':  // {{UpdateDataDomainRequest}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.updateDomain(dataDomainId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class updateDomainExample
    {
        public void main()
        {

            var apiInstance = new DomainsApi();
            var dataDomainId = new UUID(); // UUID | 
            var body = new UpdateDataDomainRequest(); // UpdateDataDomainRequest |  (optional) 

            try
            {
                // Update a data product domain
                Data domain result = apiInstance.updateDomain(dataDomainId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DomainsApi.updateDomain: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiDomainsApi();
$dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$body = ; // UpdateDataDomainRequest | 

try {
    $result = $api_instance->updateDomain($dataDomainId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DomainsApi->updateDomain: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DomainsApi;

my $api_instance = WWW::SwaggerClient::DomainsApi->new();
my $dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $body = WWW::SwaggerClient::Object::UpdateDataDomainRequest->new(); # UpdateDataDomainRequest | 

eval { 
    my $result = $api_instance->updateDomain(dataDomainId => $dataDomainId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DomainsApi->updateDomain: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DomainsApi()
dataDomainId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
body =  # UpdateDataDomainRequest |  (optional)

try: 
    # Update a data product domain
    api_response = api_instance.update_domain(dataDomainId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DomainsApi->updateDomain: %s\n" % e)

Parameters

Path parameters
Name Description
dataDomainId*
UUID (uuid)
Required
Body parameters
Name Description
body
{

Data for updating a data product domain

description:
string

Domain description.

schemaLocation:
string (uri) maxLength:255

URI describing the location where to create the schema for the data products of this domain. If left empty, the default schema location for the data product's target catalog will be used.

}

Responses

Status: 200 - Success

{

Detailed data describing a data product domain

Required: assignedDataProducts,createdAt,createdBy,id,name,updatedAt,updatedBy
id:
string (uuid)

Domain UUID.

name:
string maxLength:255

Name of the domain.

description:
string

Domain description.

schemaLocation:
string (uri) maxLength:255

URI describing the location where to create the schema for the data products of this domain. If left empty, the default schema location for the data product's target catalog will be used.

assignedDataProducts:
[

List of the data products that are assigned to this domain.

{

List of the data products that are assigned to this domain.

id:
string (uuid)
name:
string
}
]
createdBy:
string

Name of the user who created this domain.

createdAt:
string (date-time)

Timestamp of when this domain was created.

updatedAt:
string (date-time)

Timestamp of when this domain was last updated. This is initialized to createdAt.

updatedBy:
string

Name of the user who last updated this domain. This is initialized to createdBy

}

Status: 400 - Bad Request

Status: 403 - Forbidden

Status: 404 - Not found


EntityCategories

listAvailableActions

List all actions that can be allowed or denied for an EntityCategory


/api/v1/biac/entityCategories/{entityCategory}/actions

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/entityCategories/{entityCategory}/actions"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.EntityCategoriesApi;

import java.io.File;
import java.util.*;

public class EntityCategoriesApiExample {

    public static void main(String[] args) {
        
        EntityCategoriesApi apiInstance = new EntityCategoriesApi();
        String entityCategory = entityCategory_example; // String | 
        try {
            PaginatedResultAction result = apiInstance.listAvailableActions(entityCategory);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling EntityCategoriesApi#listAvailableActions");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.EntityCategoriesApi;

public class EntityCategoriesApiExample {

    public static void main(String[] args) {
        EntityCategoriesApi apiInstance = new EntityCategoriesApi();
        String entityCategory = entityCategory_example; // String | 
        try {
            PaginatedResultAction result = apiInstance.listAvailableActions(entityCategory);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling EntityCategoriesApi#listAvailableActions");
            e.printStackTrace();
        }
    }
}
String *entityCategory = entityCategory_example; // 

EntityCategoriesApi *apiInstance = [[EntityCategoriesApi alloc] init];

// List all actions that can be allowed or denied for an EntityCategory
[apiInstance listAvailableActionsWith:entityCategory
              completionHandler: ^(PaginatedResultAction output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.EntityCategoriesApi()
var entityCategory = entityCategory_example; // {{String}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listAvailableActions(entityCategory, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listAvailableActionsExample
    {
        public void main()
        {

            var apiInstance = new EntityCategoriesApi();
            var entityCategory = entityCategory_example;  // String | 

            try
            {
                // List all actions that can be allowed or denied for an EntityCategory
                PaginatedResultAction result = apiInstance.listAvailableActions(entityCategory);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling EntityCategoriesApi.listAvailableActions: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiEntityCategoriesApi();
$entityCategory = entityCategory_example; // String | 

try {
    $result = $api_instance->listAvailableActions($entityCategory);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling EntityCategoriesApi->listAvailableActions: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::EntityCategoriesApi;

my $api_instance = WWW::SwaggerClient::EntityCategoriesApi->new();
my $entityCategory = entityCategory_example; # String | 

eval { 
    my $result = $api_instance->listAvailableActions(entityCategory => $entityCategory);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling EntityCategoriesApi->listAvailableActions: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.EntityCategoriesApi()
entityCategory = entityCategory_example # String | 

try: 
    # List all actions that can be allowed or denied for an EntityCategory
    api_response = api_instance.list_available_actions(entityCategory)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling EntityCategoriesApi->listAvailableActions: %s\n" % e)

Parameters

Path parameters
Name Description
entityCategory*
String
Required

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

string

Grant action (SHOW, DROP, etc.)

Enum: SHOW, CREATE, ALTER, DROP, EXECUTE, SELECT, INSERT, DELETE, UPDATE, REFRESH, IMPERSONATE, KILL, SET, PUBLISH, READ, WRITE
]
}

Status: 401 - Unauthorized


listEntityCategories

List all entity categories in which access control can be managed by Starburst built-in access control.


/api/v1/biac/entityCategories

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/entityCategories?pageToken=&pageSize=&pageSort="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.EntityCategoriesApi;

import java.io.File;
import java.util.*;

public class EntityCategoriesApiExample {

    public static void main(String[] args) {
        
        EntityCategoriesApi apiInstance = new EntityCategoriesApi();
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultEntityCategory result = apiInstance.listEntityCategories(pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling EntityCategoriesApi#listEntityCategories");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.EntityCategoriesApi;

public class EntityCategoriesApiExample {

    public static void main(String[] args) {
        EntityCategoriesApi apiInstance = new EntityCategoriesApi();
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultEntityCategory result = apiInstance.listEntityCategories(pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling EntityCategoriesApi#listEntityCategories");
            e.printStackTrace();
        }
    }
}
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)

EntityCategoriesApi *apiInstance = [[EntityCategoriesApi alloc] init];

// List all entity categories in which access control can be managed by Starburst built-in access control.
[apiInstance listEntityCategoriesWith:pageToken
    pageSize:pageSize
    pageSort:pageSort
              completionHandler: ^(PaginatedResultEntityCategory output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.EntityCategoriesApi()
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example // {{String}} Sorting order
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listEntityCategories(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listEntityCategoriesExample
    {
        public void main()
        {

            var apiInstance = new EntityCategoriesApi();
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)

            try
            {
                // List all entity categories in which access control can be managed by Starburst built-in access control.
                PaginatedResultEntityCategory result = apiInstance.listEntityCategories(pageToken, pageSize, pageSort);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling EntityCategoriesApi.listEntityCategories: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiEntityCategoriesApi();
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order

try {
    $result = $api_instance->listEntityCategories($pageToken, $pageSize, $pageSort);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling EntityCategoriesApi->listEntityCategories: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::EntityCategoriesApi;

my $api_instance = WWW::SwaggerClient::EntityCategoriesApi->new();
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order

eval { 
    my $result = $api_instance->listEntityCategories(pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling EntityCategoriesApi->listEntityCategories: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.EntityCategoriesApi()
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)

try: 
    # List all entity categories in which access control can be managed by Starburst built-in access control.
    api_response = api_instance.list_entity_categories(pageToken=pageToken, pageSize=pageSize, pageSort=pageSort)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling EntityCategoriesApi->listEntityCategories: %s\n" % e)

Parameters

Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

string

The current page of results.

Enum: TABLES, SCHEMA_PROPERTIES, TABLE_PROPERTIES, SYSTEM_SESSION_PROPERTIES, CATALOG_SESSION_PROPERTIES, FUNCTIONS, PROCEDURES, QUERIES, ROLES, USERS, DATA_PRODUCTS, AUDIT_LOGS, SYSTEM_INFORMATION
]
}

Status: 401 - Unauthorized


Grants

createGrant

Create a Starburst built-in access control grant for a role


/api/v1/biac/roles/{roleId}/grants

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/roles/{roleId}/grants"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.GrantsApi;

import java.io.File;
import java.util.*;

public class GrantsApiExample {

    public static void main(String[] args) {
        
        GrantsApi apiInstance = new GrantsApi();
        Long roleId = 789; // Long | 
        CreateGrantPayload body = ; // CreateGrantPayload | 
        try {
            GrantResponse result = apiInstance.createGrant(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GrantsApi#createGrant");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.GrantsApi;

public class GrantsApiExample {

    public static void main(String[] args) {
        GrantsApi apiInstance = new GrantsApi();
        Long roleId = 789; // Long | 
        CreateGrantPayload body = ; // CreateGrantPayload | 
        try {
            GrantResponse result = apiInstance.createGrant(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GrantsApi#createGrant");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
CreateGrantPayload *body = ; //  (optional)

GrantsApi *apiInstance = [[GrantsApi alloc] init];

// Create a Starburst built-in access control grant for a role
[apiInstance createGrantWith:roleId
    body:body
              completionHandler: ^(GrantResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.GrantsApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'body':  // {{CreateGrantPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.createGrant(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class createGrantExample
    {
        public void main()
        {

            var apiInstance = new GrantsApi();
            var roleId = 789;  // Long | 
            var body = new CreateGrantPayload(); // CreateGrantPayload |  (optional) 

            try
            {
                // Create a Starburst built-in access control grant for a role
                GrantResponse result = apiInstance.createGrant(roleId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling GrantsApi.createGrant: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiGrantsApi();
$roleId = 789; // Long | 
$body = ; // CreateGrantPayload | 

try {
    $result = $api_instance->createGrant($roleId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling GrantsApi->createGrant: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::GrantsApi;

my $api_instance = WWW::SwaggerClient::GrantsApi->new();
my $roleId = 789; # Long | 
my $body = WWW::SwaggerClient::Object::CreateGrantPayload->new(); # CreateGrantPayload | 

eval { 
    my $result = $api_instance->createGrant(roleId => $roleId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling GrantsApi->createGrant: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.GrantsApi()
roleId = 789 # Long | 
body =  # CreateGrantPayload |  (optional)

try: 
    # Create a Starburst built-in access control grant for a role
    api_response = api_instance.create_grant(roleId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling GrantsApi->createGrant: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Body parameters
Name Description
body
{

Data of a grant to be created

effect:
string

Grant effect (ALLOW, ALLOW_WITH_GRANT_OPTION, and DENY)

Enum: ALLOW, ALLOW_WITH_GRANT_OPTION, DENY
action:
string

Grant action (SHOW, DROP, etc.)

Enum: SHOW, CREATE, ALTER, DROP, EXECUTE, SELECT, INSERT, DELETE, UPDATE, REFRESH, IMPERSONATE, KILL, SET, PUBLISH, READ, WRITE
entity:
{
category:
allEntities:
}
}

Responses

Status: 200 - Success

{

Information about a grant

id:
integer (int64)

Grant ID

effect:
string

Grant effect (ALLOW, ALLOW_WITH_GRANT_OPTION, and DENY)

Enum: ALLOW, ALLOW_WITH_GRANT_OPTION, DENY
action:
string

Grant action (SHOW, DROP, etc.)

Enum: SHOW, CREATE, ALTER, DROP, EXECUTE, SELECT, INSERT, DELETE, UPDATE, REFRESH, IMPERSONATE, KILL, SET, PUBLISH, READ, WRITE
entity:
{
category:
string

TABLES, SCHEMA_PROPERTIES, TABLE_PROPERTIES, SYSTEM_SESSION_PROPERTIES, CATALOG_SESSION_PROPERTIES, FUNCTIONS, PROCEDURES, QUERIES, SYSTEM_INFORMATION, ROLES, USERS, DATA_PRODUCTS, AUDIT_LOGS

allEntities:
boolean

Is the entity representing all entities of the given category

}
one of:
{

Data of a TABLES entity

}
all of:
{

Data of a USERS, ROLES or SYSTEM_SESSION_PROPERTIES entity

}
all of:
{

Data of a FUNCTIONS entity

}
all of:
{

Data of a PROCEDURES entity

}
all of:
{

Data of a CATALOG_SESSION_PROPERTIES entity

}
all of:
{

Data of a QUERIES or AUDIT_LOGS entity

}
all of:
{

Data of a DATA_PRODUCTS entity

}
all of:
{

Data of a TABLE_PROPERTIES or SCHEMA_PROPERTIES entity

}
all of:
}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 409 - Conflict

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

deleteGrant

Delete a Starburst built-in access control grant of a role


/api/v1/biac/roles/{roleId}/grants/{grantId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: */*,application/json"\
"//api/v1/biac/roles/{roleId}/grants/{grantId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.GrantsApi;

import java.io.File;
import java.util.*;

public class GrantsApiExample {

    public static void main(String[] args) {
        
        GrantsApi apiInstance = new GrantsApi();
        Long roleId = 789; // Long | 
        Long grantId = 789; // Long | 
        try {
            apiInstance.deleteGrant(roleId, grantId);
        } catch (ApiException e) {
            System.err.println("Exception when calling GrantsApi#deleteGrant");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.GrantsApi;

public class GrantsApiExample {

    public static void main(String[] args) {
        GrantsApi apiInstance = new GrantsApi();
        Long roleId = 789; // Long | 
        Long grantId = 789; // Long | 
        try {
            apiInstance.deleteGrant(roleId, grantId);
        } catch (ApiException e) {
            System.err.println("Exception when calling GrantsApi#deleteGrant");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
Long *grantId = 789; // 

GrantsApi *apiInstance = [[GrantsApi alloc] init];

// Delete a Starburst built-in access control grant of a role
[apiInstance deleteGrantWith:roleId
    grantId:grantId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.GrantsApi()
var roleId = 789; // {{Long}} 
var grantId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteGrant(roleId, grantId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteGrantExample
    {
        public void main()
        {

            var apiInstance = new GrantsApi();
            var roleId = 789;  // Long | 
            var grantId = 789;  // Long | 

            try
            {
                // Delete a Starburst built-in access control grant of a role
                apiInstance.deleteGrant(roleId, grantId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling GrantsApi.deleteGrant: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiGrantsApi();
$roleId = 789; // Long | 
$grantId = 789; // Long | 

try {
    $api_instance->deleteGrant($roleId, $grantId);
} catch (Exception $e) {
    echo 'Exception when calling GrantsApi->deleteGrant: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::GrantsApi;

my $api_instance = WWW::SwaggerClient::GrantsApi->new();
my $roleId = 789; # Long | 
my $grantId = 789; # Long | 

eval { 
    $api_instance->deleteGrant(roleId => $roleId, grantId => $grantId);
};
if ($@) {
    warn "Exception when calling GrantsApi->deleteGrant: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.GrantsApi()
roleId = 789 # Long | 
grantId = 789 # Long | 

try: 
    # Delete a Starburst built-in access control grant of a role
    api_instance.delete_grant(roleId, grantId)
except ApiException as e:
    print("Exception when calling GrantsApi->deleteGrant: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
grantId*
Long (int64)
Required

Responses

Status: 204 - Success

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

getGrant

Get a Starburst built-in access control grant of a role


/api/v1/biac/roles/{roleId}/grants/{grantId}

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/roles/{roleId}/grants/{grantId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.GrantsApi;

import java.io.File;
import java.util.*;

public class GrantsApiExample {

    public static void main(String[] args) {
        
        GrantsApi apiInstance = new GrantsApi();
        Long roleId = 789; // Long | 
        Long grantId = 789; // Long | 
        try {
            GrantResponse result = apiInstance.getGrant(roleId, grantId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GrantsApi#getGrant");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.GrantsApi;

public class GrantsApiExample {

    public static void main(String[] args) {
        GrantsApi apiInstance = new GrantsApi();
        Long roleId = 789; // Long | 
        Long grantId = 789; // Long | 
        try {
            GrantResponse result = apiInstance.getGrant(roleId, grantId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GrantsApi#getGrant");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
Long *grantId = 789; // 

GrantsApi *apiInstance = [[GrantsApi alloc] init];

// Get a Starburst built-in access control grant of a role
[apiInstance getGrantWith:roleId
    grantId:grantId
              completionHandler: ^(GrantResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.GrantsApi()
var roleId = 789; // {{Long}} 
var grantId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getGrant(roleId, grantId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getGrantExample
    {
        public void main()
        {

            var apiInstance = new GrantsApi();
            var roleId = 789;  // Long | 
            var grantId = 789;  // Long | 

            try
            {
                // Get a Starburst built-in access control grant of a role
                GrantResponse result = apiInstance.getGrant(roleId, grantId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling GrantsApi.getGrant: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiGrantsApi();
$roleId = 789; // Long | 
$grantId = 789; // Long | 

try {
    $result = $api_instance->getGrant($roleId, $grantId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling GrantsApi->getGrant: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::GrantsApi;

my $api_instance = WWW::SwaggerClient::GrantsApi->new();
my $roleId = 789; # Long | 
my $grantId = 789; # Long | 

eval { 
    my $result = $api_instance->getGrant(roleId => $roleId, grantId => $grantId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling GrantsApi->getGrant: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.GrantsApi()
roleId = 789 # Long | 
grantId = 789 # Long | 

try: 
    # Get a Starburst built-in access control grant of a role
    api_response = api_instance.get_grant(roleId, grantId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling GrantsApi->getGrant: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
grantId*
Long (int64)
Required

Responses

Status: 200 - Success

{

Information about a grant

id:
integer (int64)

Grant ID

effect:
string

Grant effect (ALLOW, ALLOW_WITH_GRANT_OPTION, and DENY)

Enum: ALLOW, ALLOW_WITH_GRANT_OPTION, DENY
action:
string

Grant action (SHOW, DROP, etc.)

Enum: SHOW, CREATE, ALTER, DROP, EXECUTE, SELECT, INSERT, DELETE, UPDATE, REFRESH, IMPERSONATE, KILL, SET, PUBLISH, READ, WRITE
entity:
{
category:
string

TABLES, SCHEMA_PROPERTIES, TABLE_PROPERTIES, SYSTEM_SESSION_PROPERTIES, CATALOG_SESSION_PROPERTIES, FUNCTIONS, PROCEDURES, QUERIES, SYSTEM_INFORMATION, ROLES, USERS, DATA_PRODUCTS, AUDIT_LOGS

allEntities:
boolean

Is the entity representing all entities of the given category

}
one of:
{

Data of a TABLES entity

}
all of:
{

Data of a USERS, ROLES or SYSTEM_SESSION_PROPERTIES entity

}
all of:
{

Data of a FUNCTIONS entity

}
all of:
{

Data of a PROCEDURES entity

}
all of:
{

Data of a CATALOG_SESSION_PROPERTIES entity

}
all of:
{

Data of a QUERIES or AUDIT_LOGS entity

}
all of:
{

Data of a DATA_PRODUCTS entity

}
all of:
{

Data of a TABLE_PROPERTIES or SCHEMA_PROPERTIES entity

}
all of:
}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

listGrants

List Starburst built-in access control grants of a role


/api/v1/biac/roles/{roleId}/grants

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/roles/{roleId}/grants?pageToken=&pageSize=&pageSort="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.GrantsApi;

import java.io.File;
import java.util.*;

public class GrantsApiExample {

    public static void main(String[] args) {
        
        GrantsApi apiInstance = new GrantsApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultGrantResponse result = apiInstance.listGrants(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GrantsApi#listGrants");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.GrantsApi;

public class GrantsApiExample {

    public static void main(String[] args) {
        GrantsApi apiInstance = new GrantsApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultGrantResponse result = apiInstance.listGrants(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GrantsApi#listGrants");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)

GrantsApi *apiInstance = [[GrantsApi alloc] init];

// List Starburst built-in access control grants of a role
[apiInstance listGrantsWith:roleId
    pageToken:pageToken
    pageSize:pageSize
    pageSort:pageSort
              completionHandler: ^(PaginatedResultGrantResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.GrantsApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example // {{String}} Sorting order
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listGrants(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listGrantsExample
    {
        public void main()
        {

            var apiInstance = new GrantsApi();
            var roleId = 789;  // Long | 
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)

            try
            {
                // List Starburst built-in access control grants of a role
                PaginatedResultGrantResponse result = apiInstance.listGrants(roleId, pageToken, pageSize, pageSort);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling GrantsApi.listGrants: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiGrantsApi();
$roleId = 789; // Long | 
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order

try {
    $result = $api_instance->listGrants($roleId, $pageToken, $pageSize, $pageSort);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling GrantsApi->listGrants: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::GrantsApi;

my $api_instance = WWW::SwaggerClient::GrantsApi->new();
my $roleId = 789; # Long | 
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order

eval { 
    my $result = $api_instance->listGrants(roleId => $roleId, pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling GrantsApi->listGrants: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.GrantsApi()
roleId = 789 # Long | 
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)

try: 
    # List Starburst built-in access control grants of a role
    api_response = api_instance.list_grants(roleId, pageToken=pageToken, pageSize=pageSize, pageSort=pageSort)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling GrantsApi->listGrants: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{

Information about a grant

id:
integer (int64)

Grant ID

effect:
string

Grant effect (ALLOW, ALLOW_WITH_GRANT_OPTION, and DENY)

Enum: ALLOW, ALLOW_WITH_GRANT_OPTION, DENY
action:
string

Grant action (SHOW, DROP, etc.)

Enum: SHOW, CREATE, ALTER, DROP, EXECUTE, SELECT, INSERT, DELETE, UPDATE, REFRESH, IMPERSONATE, KILL, SET, PUBLISH, READ, WRITE
entity:
{
category:
string

TABLES, SCHEMA_PROPERTIES, TABLE_PROPERTIES, SYSTEM_SESSION_PROPERTIES, CATALOG_SESSION_PROPERTIES, FUNCTIONS, PROCEDURES, QUERIES, SYSTEM_INFORMATION, ROLES, USERS, DATA_PRODUCTS, AUDIT_LOGS

allEntities:
boolean

Is the entity representing all entities of the given category

}
one of:
{

Data of a TABLES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

table:
string

If empty it applies to all tables of the entity's schema

tableType:
string

If empty it applies to table, view and materialized view

Enum: TABLE, VIEW, MATERIALIZED_VIEW
columns:
[ (0..∞)

If empty it applies to all columns of the entity's table

string

If empty it applies to all columns of the entity's table

]
}
{

Data of a USERS, ROLES or SYSTEM_SESSION_PROPERTIES entity

}
all of:
{
entityKey:
string

If empty it applies to all entities of the given category

}
{

Data of a FUNCTIONS entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

function:
string

If empty it applies to all functions of the entity's schema

}
{

Data of a PROCEDURES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

procedure:
string

If empty it applies to all procedures of the entity's schema

}
{

Data of a CATALOG_SESSION_PROPERTIES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

entityKey:
string

If empty it applies to all entities of the given category in the entity's catalog

}
{

Data of a QUERIES or AUDIT_LOGS entity

}
all of:
{

Data of a DATA_PRODUCTS entity

}
all of:
{
domainName:
string

If empty it applies to all domains

dataProductName:
string

If empty it applies to all data products in the entity's domain

}
{

Data of a TABLE_PROPERTIES or SCHEMA_PROPERTIES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

table:
string

If empty it applies to all tables of the entity's schema

property:
string

If empty it applies to all properties of the entity's table or schema

value:
string

If empty it applies to all property values

}
}
]
}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

LocationGrants

addLocationGrant

Add a LocationGrant to a role to allow accessing that location by the given role.


/api/v1/biac/roles/{roleId}/locationGrants

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/roles/{roleId}/locationGrants"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.LocationGrantsApi;

import java.io.File;
import java.util.*;

public class LocationGrantsApiExample {

    public static void main(String[] args) {
        
        LocationGrantsApi apiInstance = new LocationGrantsApi();
        Long roleId = 789; // Long | 
        CreateLocationGrantPayload body = ; // CreateLocationGrantPayload | 
        try {
            LocationGrantResponse result = apiInstance.addLocationGrant(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling LocationGrantsApi#addLocationGrant");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.LocationGrantsApi;

public class LocationGrantsApiExample {

    public static void main(String[] args) {
        LocationGrantsApi apiInstance = new LocationGrantsApi();
        Long roleId = 789; // Long | 
        CreateLocationGrantPayload body = ; // CreateLocationGrantPayload | 
        try {
            LocationGrantResponse result = apiInstance.addLocationGrant(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling LocationGrantsApi#addLocationGrant");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
CreateLocationGrantPayload *body = ; //  (optional)

LocationGrantsApi *apiInstance = [[LocationGrantsApi alloc] init];

// Add a LocationGrant to a role to allow accessing that location by the given role.
[apiInstance addLocationGrantWith:roleId
    body:body
              completionHandler: ^(LocationGrantResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.LocationGrantsApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'body':  // {{CreateLocationGrantPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.addLocationGrant(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class addLocationGrantExample
    {
        public void main()
        {

            var apiInstance = new LocationGrantsApi();
            var roleId = 789;  // Long | 
            var body = new CreateLocationGrantPayload(); // CreateLocationGrantPayload |  (optional) 

            try
            {
                // Add a LocationGrant to a role to allow accessing that location by the given role.
                LocationGrantResponse result = apiInstance.addLocationGrant(roleId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling LocationGrantsApi.addLocationGrant: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiLocationGrantsApi();
$roleId = 789; // Long | 
$body = ; // CreateLocationGrantPayload | 

try {
    $result = $api_instance->addLocationGrant($roleId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling LocationGrantsApi->addLocationGrant: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::LocationGrantsApi;

my $api_instance = WWW::SwaggerClient::LocationGrantsApi->new();
my $roleId = 789; # Long | 
my $body = WWW::SwaggerClient::Object::CreateLocationGrantPayload->new(); # CreateLocationGrantPayload | 

eval { 
    my $result = $api_instance->addLocationGrant(roleId => $roleId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling LocationGrantsApi->addLocationGrant: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.LocationGrantsApi()
roleId = 789 # Long | 
body =  # CreateLocationGrantPayload |  (optional)

try: 
    # Add a LocationGrant to a role to allow accessing that location by the given role.
    api_response = api_instance.add_location_grant(roleId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling LocationGrantsApi->addLocationGrant: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Body parameters
Name Description
body
{

Data of a location grant to be created

location:
string
}

Responses

Status: 200 - Success

{

Detailed data for a location grant added to a role

id:
integer (int64)

Id of the location grant applied to a role.

location:
string
}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

deleteLocationGrant

Remove a LocationGrant from a role.


/api/v1/biac/roles/{roleId}/locationGrants/{locationGrantId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: */*,application/json"\
"//api/v1/biac/roles/{roleId}/locationGrants/{locationGrantId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.LocationGrantsApi;

import java.io.File;
import java.util.*;

public class LocationGrantsApiExample {

    public static void main(String[] args) {
        
        LocationGrantsApi apiInstance = new LocationGrantsApi();
        Long roleId = 789; // Long | 
        Long locationGrantId = 789; // Long | 
        try {
            apiInstance.deleteLocationGrant(roleId, locationGrantId);
        } catch (ApiException e) {
            System.err.println("Exception when calling LocationGrantsApi#deleteLocationGrant");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.LocationGrantsApi;

public class LocationGrantsApiExample {

    public static void main(String[] args) {
        LocationGrantsApi apiInstance = new LocationGrantsApi();
        Long roleId = 789; // Long | 
        Long locationGrantId = 789; // Long | 
        try {
            apiInstance.deleteLocationGrant(roleId, locationGrantId);
        } catch (ApiException e) {
            System.err.println("Exception when calling LocationGrantsApi#deleteLocationGrant");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
Long *locationGrantId = 789; // 

LocationGrantsApi *apiInstance = [[LocationGrantsApi alloc] init];

// Remove a LocationGrant from a role.
[apiInstance deleteLocationGrantWith:roleId
    locationGrantId:locationGrantId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.LocationGrantsApi()
var roleId = 789; // {{Long}} 
var locationGrantId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteLocationGrant(roleId, locationGrantId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteLocationGrantExample
    {
        public void main()
        {

            var apiInstance = new LocationGrantsApi();
            var roleId = 789;  // Long | 
            var locationGrantId = 789;  // Long | 

            try
            {
                // Remove a LocationGrant from a role.
                apiInstance.deleteLocationGrant(roleId, locationGrantId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling LocationGrantsApi.deleteLocationGrant: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiLocationGrantsApi();
$roleId = 789; // Long | 
$locationGrantId = 789; // Long | 

try {
    $api_instance->deleteLocationGrant($roleId, $locationGrantId);
} catch (Exception $e) {
    echo 'Exception when calling LocationGrantsApi->deleteLocationGrant: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::LocationGrantsApi;

my $api_instance = WWW::SwaggerClient::LocationGrantsApi->new();
my $roleId = 789; # Long | 
my $locationGrantId = 789; # Long | 

eval { 
    $api_instance->deleteLocationGrant(roleId => $roleId, locationGrantId => $locationGrantId);
};
if ($@) {
    warn "Exception when calling LocationGrantsApi->deleteLocationGrant: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.LocationGrantsApi()
roleId = 789 # Long | 
locationGrantId = 789 # Long | 

try: 
    # Remove a LocationGrant from a role.
    api_instance.delete_location_grant(roleId, locationGrantId)
except ApiException as e:
    print("Exception when calling LocationGrantsApi->deleteLocationGrant: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
locationGrantId*
Long (int64)
Required

Responses

Status: 204 - No Content

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

getLocationGrant

Get a Starburst built-in access control location grant of a role


/api/v1/biac/roles/{roleId}/locationGrants/{locationGrantId}

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/roles/{roleId}/locationGrants/{locationGrantId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.LocationGrantsApi;

import java.io.File;
import java.util.*;

public class LocationGrantsApiExample {

    public static void main(String[] args) {
        
        LocationGrantsApi apiInstance = new LocationGrantsApi();
        Long roleId = 789; // Long | 
        Long locationGrantId = 789; // Long | 
        try {
            LocationGrantResponse result = apiInstance.getLocationGrant(roleId, locationGrantId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling LocationGrantsApi#getLocationGrant");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.LocationGrantsApi;

public class LocationGrantsApiExample {

    public static void main(String[] args) {
        LocationGrantsApi apiInstance = new LocationGrantsApi();
        Long roleId = 789; // Long | 
        Long locationGrantId = 789; // Long | 
        try {
            LocationGrantResponse result = apiInstance.getLocationGrant(roleId, locationGrantId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling LocationGrantsApi#getLocationGrant");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
Long *locationGrantId = 789; // 

LocationGrantsApi *apiInstance = [[LocationGrantsApi alloc] init];

// Get a Starburst built-in access control location grant of a role
[apiInstance getLocationGrantWith:roleId
    locationGrantId:locationGrantId
              completionHandler: ^(LocationGrantResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.LocationGrantsApi()
var roleId = 789; // {{Long}} 
var locationGrantId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getLocationGrant(roleId, locationGrantId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getLocationGrantExample
    {
        public void main()
        {

            var apiInstance = new LocationGrantsApi();
            var roleId = 789;  // Long | 
            var locationGrantId = 789;  // Long | 

            try
            {
                // Get a Starburst built-in access control location grant of a role
                LocationGrantResponse result = apiInstance.getLocationGrant(roleId, locationGrantId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling LocationGrantsApi.getLocationGrant: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiLocationGrantsApi();
$roleId = 789; // Long | 
$locationGrantId = 789; // Long | 

try {
    $result = $api_instance->getLocationGrant($roleId, $locationGrantId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling LocationGrantsApi->getLocationGrant: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::LocationGrantsApi;

my $api_instance = WWW::SwaggerClient::LocationGrantsApi->new();
my $roleId = 789; # Long | 
my $locationGrantId = 789; # Long | 

eval { 
    my $result = $api_instance->getLocationGrant(roleId => $roleId, locationGrantId => $locationGrantId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling LocationGrantsApi->getLocationGrant: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.LocationGrantsApi()
roleId = 789 # Long | 
locationGrantId = 789 # Long | 

try: 
    # Get a Starburst built-in access control location grant of a role
    api_response = api_instance.get_location_grant(roleId, locationGrantId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling LocationGrantsApi->getLocationGrant: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
locationGrantId*
Long (int64)
Required

Responses

Status: 200 - Success

{

Detailed data for a location grant added to a role

id:
integer (int64)

Id of the location grant applied to a role.

location:
string
}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

listLocationGrants

List Starburst built-in access control location grants of a role


/api/v1/biac/roles/{roleId}/locationGrants

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/roles/{roleId}/locationGrants?pageToken=&pageSize=&pageSort="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.LocationGrantsApi;

import java.io.File;
import java.util.*;

public class LocationGrantsApiExample {

    public static void main(String[] args) {
        
        LocationGrantsApi apiInstance = new LocationGrantsApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultLocationGrantResponse result = apiInstance.listLocationGrants(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling LocationGrantsApi#listLocationGrants");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.LocationGrantsApi;

public class LocationGrantsApiExample {

    public static void main(String[] args) {
        LocationGrantsApi apiInstance = new LocationGrantsApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultLocationGrantResponse result = apiInstance.listLocationGrants(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling LocationGrantsApi#listLocationGrants");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)

LocationGrantsApi *apiInstance = [[LocationGrantsApi alloc] init];

// List Starburst built-in access control location grants of a role
[apiInstance listLocationGrantsWith:roleId
    pageToken:pageToken
    pageSize:pageSize
    pageSort:pageSort
              completionHandler: ^(PaginatedResultLocationGrantResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.LocationGrantsApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example // {{String}} Sorting order
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listLocationGrants(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listLocationGrantsExample
    {
        public void main()
        {

            var apiInstance = new LocationGrantsApi();
            var roleId = 789;  // Long | 
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)

            try
            {
                // List Starburst built-in access control location grants of a role
                PaginatedResultLocationGrantResponse result = apiInstance.listLocationGrants(roleId, pageToken, pageSize, pageSort);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling LocationGrantsApi.listLocationGrants: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiLocationGrantsApi();
$roleId = 789; // Long | 
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order

try {
    $result = $api_instance->listLocationGrants($roleId, $pageToken, $pageSize, $pageSort);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling LocationGrantsApi->listLocationGrants: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::LocationGrantsApi;

my $api_instance = WWW::SwaggerClient::LocationGrantsApi->new();
my $roleId = 789; # Long | 
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order

eval { 
    my $result = $api_instance->listLocationGrants(roleId => $roleId, pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling LocationGrantsApi->listLocationGrants: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.LocationGrantsApi()
roleId = 789 # Long | 
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)

try: 
    # List Starburst built-in access control location grants of a role
    api_response = api_instance.list_location_grants(roleId, pageToken=pageToken, pageSize=pageSize, pageSort=pageSort)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling LocationGrantsApi->listLocationGrants: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{

Detailed data for a location grant added to a role

id:
integer (int64)

Id of the location grant applied to a role.

location:
string
}
]
}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

RoleAssignments

listRoleAssignments

List assignments of a Starburst built-in access control role


/api/v1/biac/roles/{roleId}/assignments

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/roles/{roleId}/assignments?pageToken=&pageSize=&pageSort="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RoleAssignmentsApi;

import java.io.File;
import java.util.*;

public class RoleAssignmentsApiExample {

    public static void main(String[] args) {
        
        RoleAssignmentsApi apiInstance = new RoleAssignmentsApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            array[RoleAssignmentResponse] result = apiInstance.listRoleAssignments(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RoleAssignmentsApi#listRoleAssignments");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RoleAssignmentsApi;

public class RoleAssignmentsApiExample {

    public static void main(String[] args) {
        RoleAssignmentsApi apiInstance = new RoleAssignmentsApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            array[RoleAssignmentResponse] result = apiInstance.listRoleAssignments(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RoleAssignmentsApi#listRoleAssignments");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)

RoleAssignmentsApi *apiInstance = [[RoleAssignmentsApi alloc] init];

// List assignments of a Starburst built-in access control role
[apiInstance listRoleAssignmentsWith:roleId
    pageToken:pageToken
    pageSize:pageSize
    pageSort:pageSort
              completionHandler: ^(array[RoleAssignmentResponse] output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RoleAssignmentsApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example // {{String}} Sorting order
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listRoleAssignments(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listRoleAssignmentsExample
    {
        public void main()
        {

            var apiInstance = new RoleAssignmentsApi();
            var roleId = 789;  // Long | 
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)

            try
            {
                // List assignments of a Starburst built-in access control role
                array[RoleAssignmentResponse] result = apiInstance.listRoleAssignments(roleId, pageToken, pageSize, pageSort);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RoleAssignmentsApi.listRoleAssignments: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRoleAssignmentsApi();
$roleId = 789; // Long | 
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order

try {
    $result = $api_instance->listRoleAssignments($roleId, $pageToken, $pageSize, $pageSort);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RoleAssignmentsApi->listRoleAssignments: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RoleAssignmentsApi;

my $api_instance = WWW::SwaggerClient::RoleAssignmentsApi->new();
my $roleId = 789; # Long | 
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order

eval { 
    my $result = $api_instance->listRoleAssignments(roleId => $roleId, pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RoleAssignmentsApi->listRoleAssignments: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RoleAssignmentsApi()
roleId = 789 # Long | 
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)

try: 
    # List assignments of a Starburst built-in access control role
    api_response = api_instance.list_role_assignments(roleId, pageToken=pageToken, pageSize=pageSize, pageSort=pageSort)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RoleAssignmentsApi->listRoleAssignments: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order

Responses

Status: 200 - Success

[
{

Response from assigning roles

id:
integer (int64)

ID of the role assignment

subject:
{

Subject to which the role is assigned. If empty the role is assigned to all.

Required: type
type:
string

Subject type (USER, GROUP, and ROLE)

}
one of:
{

Data of a user subject

}
all of:
{
username:
string
}
{

Data of a group subject

}
all of:
{
groupName:
string
}
{

Data of a role subject

}
all of:
{
roleId:
integer (int64)
}
roleAdmin:
boolean

If true the subject has an admin option for the assigned role

}
]

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not Found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Roles

createRole

Create a Starburst built-in access control role


/api/v1/biac/roles

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/roles"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RolesApi;

import java.io.File;
import java.util.*;

public class RolesApiExample {

    public static void main(String[] args) {
        
        RolesApi apiInstance = new RolesApi();
        CreateRolePayload body = ; // CreateRolePayload | 
        try {
            RoleResponse result = apiInstance.createRole(body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RolesApi#createRole");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RolesApi;

public class RolesApiExample {

    public static void main(String[] args) {
        RolesApi apiInstance = new RolesApi();
        CreateRolePayload body = ; // CreateRolePayload | 
        try {
            RoleResponse result = apiInstance.createRole(body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RolesApi#createRole");
            e.printStackTrace();
        }
    }
}
CreateRolePayload *body = ; //  (optional)

RolesApi *apiInstance = [[RolesApi alloc] init];

// Create a Starburst built-in access control role
[apiInstance createRoleWith:body
              completionHandler: ^(RoleResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RolesApi()
var opts = { 
  'body':  // {{CreateRolePayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.createRole(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class createRoleExample
    {
        public void main()
        {

            var apiInstance = new RolesApi();
            var body = new CreateRolePayload(); // CreateRolePayload |  (optional) 

            try
            {
                // Create a Starburst built-in access control role
                RoleResponse result = apiInstance.createRole(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RolesApi.createRole: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRolesApi();
$body = ; // CreateRolePayload | 

try {
    $result = $api_instance->createRole($body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RolesApi->createRole: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RolesApi;

my $api_instance = WWW::SwaggerClient::RolesApi->new();
my $body = WWW::SwaggerClient::Object::CreateRolePayload->new(); # CreateRolePayload | 

eval { 
    my $result = $api_instance->createRole(body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RolesApi->createRole: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RolesApi()
body =  # CreateRolePayload |  (optional)

try: 
    # Create a Starburst built-in access control role
    api_response = api_instance.create_role(body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RolesApi->createRole: %s\n" % e)

Parameters

Body parameters
Name Description
body
{

Data of a role

name:
string

Role name

description:
string

Role description

}

Responses

Status: 200 - Success

{

Information about a role

id:
integer (int64)

Role ID

name:
string

Role name

description:
string

Role description

}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

deleteRole

Delete a Starburst built-in access control role


/api/v1/biac/roles/{roleId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: */*,application/json"\
"//api/v1/biac/roles/{roleId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RolesApi;

import java.io.File;
import java.util.*;

public class RolesApiExample {

    public static void main(String[] args) {
        
        RolesApi apiInstance = new RolesApi();
        Long roleId = 789; // Long | 
        try {
            apiInstance.deleteRole(roleId);
        } catch (ApiException e) {
            System.err.println("Exception when calling RolesApi#deleteRole");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RolesApi;

public class RolesApiExample {

    public static void main(String[] args) {
        RolesApi apiInstance = new RolesApi();
        Long roleId = 789; // Long | 
        try {
            apiInstance.deleteRole(roleId);
        } catch (ApiException e) {
            System.err.println("Exception when calling RolesApi#deleteRole");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 

RolesApi *apiInstance = [[RolesApi alloc] init];

// Delete a Starburst built-in access control role
[apiInstance deleteRoleWith:roleId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RolesApi()
var roleId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteRole(roleId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteRoleExample
    {
        public void main()
        {

            var apiInstance = new RolesApi();
            var roleId = 789;  // Long | 

            try
            {
                // Delete a Starburst built-in access control role
                apiInstance.deleteRole(roleId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RolesApi.deleteRole: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRolesApi();
$roleId = 789; // Long | 

try {
    $api_instance->deleteRole($roleId);
} catch (Exception $e) {
    echo 'Exception when calling RolesApi->deleteRole: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RolesApi;

my $api_instance = WWW::SwaggerClient::RolesApi->new();
my $roleId = 789; # Long | 

eval { 
    $api_instance->deleteRole(roleId => $roleId);
};
if ($@) {
    warn "Exception when calling RolesApi->deleteRole: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RolesApi()
roleId = 789 # Long | 

try: 
    # Delete a Starburst built-in access control role
    api_instance.delete_role(roleId)
except ApiException as e:
    print("Exception when calling RolesApi->deleteRole: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required

Responses

Status: 204 - Success

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

getRole

Get a Starburst built-in access control role


/api/v1/biac/roles/{roleId}

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/roles/{roleId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RolesApi;

import java.io.File;
import java.util.*;

public class RolesApiExample {

    public static void main(String[] args) {
        
        RolesApi apiInstance = new RolesApi();
        Long roleId = 789; // Long | 
        try {
            PaginatedResultRoleResponse result = apiInstance.getRole(roleId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RolesApi#getRole");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RolesApi;

public class RolesApiExample {

    public static void main(String[] args) {
        RolesApi apiInstance = new RolesApi();
        Long roleId = 789; // Long | 
        try {
            PaginatedResultRoleResponse result = apiInstance.getRole(roleId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RolesApi#getRole");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 

RolesApi *apiInstance = [[RolesApi alloc] init];

// Get a Starburst built-in access control role
[apiInstance getRoleWith:roleId
              completionHandler: ^(PaginatedResultRoleResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RolesApi()
var roleId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getRole(roleId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getRoleExample
    {
        public void main()
        {

            var apiInstance = new RolesApi();
            var roleId = 789;  // Long | 

            try
            {
                // Get a Starburst built-in access control role
                PaginatedResultRoleResponse result = apiInstance.getRole(roleId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RolesApi.getRole: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRolesApi();
$roleId = 789; // Long | 

try {
    $result = $api_instance->getRole($roleId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RolesApi->getRole: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RolesApi;

my $api_instance = WWW::SwaggerClient::RolesApi->new();
my $roleId = 789; # Long | 

eval { 
    my $result = $api_instance->getRole(roleId => $roleId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RolesApi->getRole: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RolesApi()
roleId = 789 # Long | 

try: 
    # Get a Starburst built-in access control role
    api_response = api_instance.get_role(roleId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RolesApi->getRole: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{

Information about a role

id:
integer (int64)

Role ID

name:
string

Role name

description:
string

Role description

}
]
}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

listRoles

List Starburst built-in access control roles


/api/v1/biac/roles

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/roles?pageToken=&pageSize=&pageSort="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RolesApi;

import java.io.File;
import java.util.*;

public class RolesApiExample {

    public static void main(String[] args) {
        
        RolesApi apiInstance = new RolesApi();
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultRoleResponse result = apiInstance.listRoles(pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RolesApi#listRoles");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RolesApi;

public class RolesApiExample {

    public static void main(String[] args) {
        RolesApi apiInstance = new RolesApi();
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultRoleResponse result = apiInstance.listRoles(pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RolesApi#listRoles");
            e.printStackTrace();
        }
    }
}
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)

RolesApi *apiInstance = [[RolesApi alloc] init];

// List Starburst built-in access control roles
[apiInstance listRolesWith:pageToken
    pageSize:pageSize
    pageSort:pageSort
              completionHandler: ^(PaginatedResultRoleResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RolesApi()
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example // {{String}} Sorting order
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listRoles(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listRolesExample
    {
        public void main()
        {

            var apiInstance = new RolesApi();
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)

            try
            {
                // List Starburst built-in access control roles
                PaginatedResultRoleResponse result = apiInstance.listRoles(pageToken, pageSize, pageSort);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RolesApi.listRoles: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRolesApi();
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order

try {
    $result = $api_instance->listRoles($pageToken, $pageSize, $pageSort);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RolesApi->listRoles: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RolesApi;

my $api_instance = WWW::SwaggerClient::RolesApi->new();
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order

eval { 
    my $result = $api_instance->listRoles(pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RolesApi->listRoles: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RolesApi()
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)

try: 
    # List Starburst built-in access control roles
    api_response = api_instance.list_roles(pageToken=pageToken, pageSize=pageSize, pageSort=pageSort)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RolesApi->listRoles: %s\n" % e)

Parameters

Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{

Information about a role

id:
integer (int64)

Role ID

name:
string

Role name

description:
string

Role description

}
]
}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

updateRole

Update a Starburst built-in access control role


/api/v1/biac/roles/{roleId}

Usage and SDK Samples

curl -X PUT\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/roles/{roleId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RolesApi;

import java.io.File;
import java.util.*;

public class RolesApiExample {

    public static void main(String[] args) {
        
        RolesApi apiInstance = new RolesApi();
        Long roleId = 789; // Long | 
        CreateRolePayload body = ; // CreateRolePayload | 
        try {
            RoleResponse result = apiInstance.updateRole(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RolesApi#updateRole");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RolesApi;

public class RolesApiExample {

    public static void main(String[] args) {
        RolesApi apiInstance = new RolesApi();
        Long roleId = 789; // Long | 
        CreateRolePayload body = ; // CreateRolePayload | 
        try {
            RoleResponse result = apiInstance.updateRole(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RolesApi#updateRole");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
CreateRolePayload *body = ; //  (optional)

RolesApi *apiInstance = [[RolesApi alloc] init];

// Update a Starburst built-in access control role
[apiInstance updateRoleWith:roleId
    body:body
              completionHandler: ^(RoleResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RolesApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'body':  // {{CreateRolePayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.updateRole(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class updateRoleExample
    {
        public void main()
        {

            var apiInstance = new RolesApi();
            var roleId = 789;  // Long | 
            var body = new CreateRolePayload(); // CreateRolePayload |  (optional) 

            try
            {
                // Update a Starburst built-in access control role
                RoleResponse result = apiInstance.updateRole(roleId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RolesApi.updateRole: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRolesApi();
$roleId = 789; // Long | 
$body = ; // CreateRolePayload | 

try {
    $result = $api_instance->updateRole($roleId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RolesApi->updateRole: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RolesApi;

my $api_instance = WWW::SwaggerClient::RolesApi->new();
my $roleId = 789; # Long | 
my $body = WWW::SwaggerClient::Object::CreateRolePayload->new(); # CreateRolePayload | 

eval { 
    my $result = $api_instance->updateRole(roleId => $roleId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RolesApi->updateRole: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RolesApi()
roleId = 789 # Long | 
body =  # CreateRolePayload |  (optional)

try: 
    # Update a Starburst built-in access control role
    api_response = api_instance.update_role(roleId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RolesApi->updateRole: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Body parameters
Name Description
body
{

Data of a role

name:
string

Role name

description:
string

Role description

}

Responses

Status: 200 - Success

{

Information about a role

id:
integer (int64)

Role ID

name:
string

Role name

description:
string

Role description

}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

RowFilters

addRowFilterToRole

Add a row filter to a role to filter out table rows from queries made by subjects assigned to the role.


/api/v1/biac/roles/{roleId}/rowFilters

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/roles/{roleId}/rowFilters"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RowFiltersApi;

import java.io.File;
import java.util.*;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long roleId = 789; // Long | 
        RowFilterPayload body = ; // RowFilterPayload | 
        try {
            RowFilterResponse result = apiInstance.addRowFilterToRole(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#addRowFilterToRole");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RowFiltersApi;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long roleId = 789; // Long | 
        RowFilterPayload body = ; // RowFilterPayload | 
        try {
            RowFilterResponse result = apiInstance.addRowFilterToRole(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#addRowFilterToRole");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
RowFilterPayload *body = ; //  (optional)

RowFiltersApi *apiInstance = [[RowFiltersApi alloc] init];

// Add a row filter to a role to filter out table rows from queries made by subjects assigned to the role.
[apiInstance addRowFilterToRoleWith:roleId
    body:body
              completionHandler: ^(RowFilterResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RowFiltersApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'body':  // {{RowFilterPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.addRowFilterToRole(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class addRowFilterToRoleExample
    {
        public void main()
        {

            var apiInstance = new RowFiltersApi();
            var roleId = 789;  // Long | 
            var body = new RowFilterPayload(); // RowFilterPayload |  (optional) 

            try
            {
                // Add a row filter to a role to filter out table rows from queries made by subjects assigned to the role.
                RowFilterResponse result = apiInstance.addRowFilterToRole(roleId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RowFiltersApi.addRowFilterToRole: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRowFiltersApi();
$roleId = 789; // Long | 
$body = ; // RowFilterPayload | 

try {
    $result = $api_instance->addRowFilterToRole($roleId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RowFiltersApi->addRowFilterToRole: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RowFiltersApi;

my $api_instance = WWW::SwaggerClient::RowFiltersApi->new();
my $roleId = 789; # Long | 
my $body = WWW::SwaggerClient::Object::RowFilterPayload->new(); # RowFilterPayload | 

eval { 
    my $result = $api_instance->addRowFilterToRole(roleId => $roleId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RowFiltersApi->addRowFilterToRole: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RowFiltersApi()
roleId = 789 # Long | 
body =  # RowFilterPayload |  (optional)

try: 
    # Add a row filter to a role to filter out table rows from queries made by subjects assigned to the role.
    api_response = api_instance.add_row_filter_to_role(roleId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RowFiltersApi->addRowFilterToRole: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Body parameters
Name Description
body
{

Data for a role row filter

Required: entity,expressionId
entity:
{

Data of a TABLES entity

}
all of:
expressionId:
integer (int64)

Id of the row filter expression to apply in the given entity

}

Responses

Status: 200 - Success

{

Detailed data for a row filter added to a role

id:
integer (int64)

Id of the row filter applied to a role.

entity:
{
category:
string

TABLES, SCHEMA_PROPERTIES, TABLE_PROPERTIES, SYSTEM_SESSION_PROPERTIES, CATALOG_SESSION_PROPERTIES, FUNCTIONS, PROCEDURES, QUERIES, SYSTEM_INFORMATION, ROLES, USERS, DATA_PRODUCTS, AUDIT_LOGS

allEntities:
boolean

Is the entity representing all entities of the given category

}
one of:
{

Data of a TABLES entity

}
all of:
{

Data of a USERS, ROLES or SYSTEM_SESSION_PROPERTIES entity

}
all of:
{

Data of a FUNCTIONS entity

}
all of:
{

Data of a PROCEDURES entity

}
all of:
{

Data of a CATALOG_SESSION_PROPERTIES entity

}
all of:
{

Data of a QUERIES or AUDIT_LOGS entity

}
all of:
{

Data of a DATA_PRODUCTS entity

}
all of:
{

Data of a TABLE_PROPERTIES or SCHEMA_PROPERTIES entity

}
all of:
expressionId:
integer (int64)

Id of the row filter expression.

forceNone:
boolean

If true, forces not filtering table rows for the given entity, even if the subject is assigned to other roles with row filters to the same entity.

}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

createRowFilterExpression

Create an expression that can be applied to filter table rows from query results


/api/v1/biac/expressions/rowFilter

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/expressions/rowFilter"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RowFiltersApi;

import java.io.File;
import java.util.*;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        
        RowFiltersApi apiInstance = new RowFiltersApi();
        ExpressionPayload body = ; // ExpressionPayload | 
        try {
            ExpressionResponse result = apiInstance.createRowFilterExpression(body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#createRowFilterExpression");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RowFiltersApi;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        RowFiltersApi apiInstance = new RowFiltersApi();
        ExpressionPayload body = ; // ExpressionPayload | 
        try {
            ExpressionResponse result = apiInstance.createRowFilterExpression(body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#createRowFilterExpression");
            e.printStackTrace();
        }
    }
}
ExpressionPayload *body = ; //  (optional)

RowFiltersApi *apiInstance = [[RowFiltersApi alloc] init];

// Create an expression that can be applied to filter table rows from query results
[apiInstance createRowFilterExpressionWith:body
              completionHandler: ^(ExpressionResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RowFiltersApi()
var opts = { 
  'body':  // {{ExpressionPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.createRowFilterExpression(opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class createRowFilterExpressionExample
    {
        public void main()
        {

            var apiInstance = new RowFiltersApi();
            var body = new ExpressionPayload(); // ExpressionPayload |  (optional) 

            try
            {
                // Create an expression that can be applied to filter table rows from query results
                ExpressionResponse result = apiInstance.createRowFilterExpression(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RowFiltersApi.createRowFilterExpression: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRowFiltersApi();
$body = ; // ExpressionPayload | 

try {
    $result = $api_instance->createRowFilterExpression($body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RowFiltersApi->createRowFilterExpression: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RowFiltersApi;

my $api_instance = WWW::SwaggerClient::RowFiltersApi->new();
my $body = WWW::SwaggerClient::Object::ExpressionPayload->new(); # ExpressionPayload | 

eval { 
    my $result = $api_instance->createRowFilterExpression(body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RowFiltersApi->createRowFilterExpression: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RowFiltersApi()
body =  # ExpressionPayload |  (optional)

try: 
    # Create an expression that can be applied to filter table rows from query results
    api_response = api_instance.create_row_filter_expression(body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RowFiltersApi->createRowFilterExpression: %s\n" % e)

Parameters

Body parameters
Name Description
body
{
name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}

Responses

Status: 200 - Success

{
id:
integer (int64)

Expression id

name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

deleteRoleRowFilter

Remove a row filter from a role.


/api/v1/biac/roles/{roleId}/rowFilters/{rowFilterId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: */*,application/json"\
"//api/v1/biac/roles/{roleId}/rowFilters/{rowFilterId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RowFiltersApi;

import java.io.File;
import java.util.*;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long roleId = 789; // Long | 
        Long rowFilterId = 789; // Long | 
        try {
            apiInstance.deleteRoleRowFilter(roleId, rowFilterId);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#deleteRoleRowFilter");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RowFiltersApi;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long roleId = 789; // Long | 
        Long rowFilterId = 789; // Long | 
        try {
            apiInstance.deleteRoleRowFilter(roleId, rowFilterId);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#deleteRoleRowFilter");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
Long *rowFilterId = 789; // 

RowFiltersApi *apiInstance = [[RowFiltersApi alloc] init];

// Remove a row filter from a role.
[apiInstance deleteRoleRowFilterWith:roleId
    rowFilterId:rowFilterId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RowFiltersApi()
var roleId = 789; // {{Long}} 
var rowFilterId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteRoleRowFilter(roleId, rowFilterId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteRoleRowFilterExample
    {
        public void main()
        {

            var apiInstance = new RowFiltersApi();
            var roleId = 789;  // Long | 
            var rowFilterId = 789;  // Long | 

            try
            {
                // Remove a row filter from a role.
                apiInstance.deleteRoleRowFilter(roleId, rowFilterId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RowFiltersApi.deleteRoleRowFilter: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRowFiltersApi();
$roleId = 789; // Long | 
$rowFilterId = 789; // Long | 

try {
    $api_instance->deleteRoleRowFilter($roleId, $rowFilterId);
} catch (Exception $e) {
    echo 'Exception when calling RowFiltersApi->deleteRoleRowFilter: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RowFiltersApi;

my $api_instance = WWW::SwaggerClient::RowFiltersApi->new();
my $roleId = 789; # Long | 
my $rowFilterId = 789; # Long | 

eval { 
    $api_instance->deleteRoleRowFilter(roleId => $roleId, rowFilterId => $rowFilterId);
};
if ($@) {
    warn "Exception when calling RowFiltersApi->deleteRoleRowFilter: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RowFiltersApi()
roleId = 789 # Long | 
rowFilterId = 789 # Long | 

try: 
    # Remove a row filter from a role.
    api_instance.delete_role_row_filter(roleId, rowFilterId)
except ApiException as e:
    print("Exception when calling RowFiltersApi->deleteRoleRowFilter: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
rowFilterId*
Long (int64)
Required

Responses

Status: 204 - No Content

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

deleteRowFilterExpression

Delete a row filter expression


/api/v1/biac/expressions/rowFilter/{rowFilterExpressionId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: application/json"\
"//api/v1/biac/expressions/rowFilter/{rowFilterExpressionId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RowFiltersApi;

import java.io.File;
import java.util.*;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long rowFilterExpressionId = 789; // Long | 
        try {
            apiInstance.deleteRowFilterExpression(rowFilterExpressionId);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#deleteRowFilterExpression");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RowFiltersApi;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long rowFilterExpressionId = 789; // Long | 
        try {
            apiInstance.deleteRowFilterExpression(rowFilterExpressionId);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#deleteRowFilterExpression");
            e.printStackTrace();
        }
    }
}
Long *rowFilterExpressionId = 789; // 

RowFiltersApi *apiInstance = [[RowFiltersApi alloc] init];

// Delete a row filter expression
[apiInstance deleteRowFilterExpressionWith:rowFilterExpressionId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RowFiltersApi()
var rowFilterExpressionId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteRowFilterExpression(rowFilterExpressionId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteRowFilterExpressionExample
    {
        public void main()
        {

            var apiInstance = new RowFiltersApi();
            var rowFilterExpressionId = 789;  // Long | 

            try
            {
                // Delete a row filter expression
                apiInstance.deleteRowFilterExpression(rowFilterExpressionId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RowFiltersApi.deleteRowFilterExpression: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRowFiltersApi();
$rowFilterExpressionId = 789; // Long | 

try {
    $api_instance->deleteRowFilterExpression($rowFilterExpressionId);
} catch (Exception $e) {
    echo 'Exception when calling RowFiltersApi->deleteRowFilterExpression: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RowFiltersApi;

my $api_instance = WWW::SwaggerClient::RowFiltersApi->new();
my $rowFilterExpressionId = 789; # Long | 

eval { 
    $api_instance->deleteRowFilterExpression(rowFilterExpressionId => $rowFilterExpressionId);
};
if ($@) {
    warn "Exception when calling RowFiltersApi->deleteRowFilterExpression: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RowFiltersApi()
rowFilterExpressionId = 789 # Long | 

try: 
    # Delete a row filter expression
    api_instance.delete_row_filter_expression(rowFilterExpressionId)
except ApiException as e:
    print("Exception when calling RowFiltersApi->deleteRowFilterExpression: %s\n" % e)

Parameters

Path parameters
Name Description
rowFilterExpressionId*
Long (int64)
Required

Responses

Status: 204 - Success

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

getRowFilter

Get a row filter of a given role.


/api/v1/biac/roles/{roleId}/rowFilters/{rowFilterId}

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/roles/{roleId}/rowFilters/{rowFilterId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RowFiltersApi;

import java.io.File;
import java.util.*;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long roleId = 789; // Long | 
        Long rowFilterId = 789; // Long | 
        try {
            RowFilterResponse result = apiInstance.getRowFilter(roleId, rowFilterId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#getRowFilter");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RowFiltersApi;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long roleId = 789; // Long | 
        Long rowFilterId = 789; // Long | 
        try {
            RowFilterResponse result = apiInstance.getRowFilter(roleId, rowFilterId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#getRowFilter");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
Long *rowFilterId = 789; // 

RowFiltersApi *apiInstance = [[RowFiltersApi alloc] init];

// Get a row filter of a given role.
[apiInstance getRowFilterWith:roleId
    rowFilterId:rowFilterId
              completionHandler: ^(RowFilterResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RowFiltersApi()
var roleId = 789; // {{Long}} 
var rowFilterId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getRowFilter(roleId, rowFilterId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getRowFilterExample
    {
        public void main()
        {

            var apiInstance = new RowFiltersApi();
            var roleId = 789;  // Long | 
            var rowFilterId = 789;  // Long | 

            try
            {
                // Get a row filter of a given role.
                RowFilterResponse result = apiInstance.getRowFilter(roleId, rowFilterId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RowFiltersApi.getRowFilter: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRowFiltersApi();
$roleId = 789; // Long | 
$rowFilterId = 789; // Long | 

try {
    $result = $api_instance->getRowFilter($roleId, $rowFilterId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RowFiltersApi->getRowFilter: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RowFiltersApi;

my $api_instance = WWW::SwaggerClient::RowFiltersApi->new();
my $roleId = 789; # Long | 
my $rowFilterId = 789; # Long | 

eval { 
    my $result = $api_instance->getRowFilter(roleId => $roleId, rowFilterId => $rowFilterId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RowFiltersApi->getRowFilter: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RowFiltersApi()
roleId = 789 # Long | 
rowFilterId = 789 # Long | 

try: 
    # Get a row filter of a given role.
    api_response = api_instance.get_row_filter(roleId, rowFilterId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RowFiltersApi->getRowFilter: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
rowFilterId*
Long (int64)
Required

Responses

Status: 200 - Success

{

Detailed data for a row filter added to a role

id:
integer (int64)

Id of the row filter applied to a role.

entity:
{
category:
string

TABLES, SCHEMA_PROPERTIES, TABLE_PROPERTIES, SYSTEM_SESSION_PROPERTIES, CATALOG_SESSION_PROPERTIES, FUNCTIONS, PROCEDURES, QUERIES, SYSTEM_INFORMATION, ROLES, USERS, DATA_PRODUCTS, AUDIT_LOGS

allEntities:
boolean

Is the entity representing all entities of the given category

}
one of:
{

Data of a TABLES entity

}
all of:
{

Data of a USERS, ROLES or SYSTEM_SESSION_PROPERTIES entity

}
all of:
{

Data of a FUNCTIONS entity

}
all of:
{

Data of a PROCEDURES entity

}
all of:
{

Data of a CATALOG_SESSION_PROPERTIES entity

}
all of:
{

Data of a QUERIES or AUDIT_LOGS entity

}
all of:
{

Data of a DATA_PRODUCTS entity

}
all of:
{

Data of a TABLE_PROPERTIES or SCHEMA_PROPERTIES entity

}
all of:
expressionId:
integer (int64)

Id of the row filter expression.

forceNone:
boolean

If true, forces not filtering table rows for the given entity, even if the subject is assigned to other roles with row filters to the same entity.

}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

getRowFilterExpression

Get an expression that can be applied to filter table rows from query results


/api/v1/biac/expressions/rowFilter/{rowFilterExpressionId}

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/expressions/rowFilter/{rowFilterExpressionId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RowFiltersApi;

import java.io.File;
import java.util.*;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long rowFilterExpressionId = 789; // Long | 
        try {
            ExpressionResponse result = apiInstance.getRowFilterExpression(rowFilterExpressionId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#getRowFilterExpression");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RowFiltersApi;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long rowFilterExpressionId = 789; // Long | 
        try {
            ExpressionResponse result = apiInstance.getRowFilterExpression(rowFilterExpressionId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#getRowFilterExpression");
            e.printStackTrace();
        }
    }
}
Long *rowFilterExpressionId = 789; // 

RowFiltersApi *apiInstance = [[RowFiltersApi alloc] init];

// Get an expression that can be applied to filter table rows from query results
[apiInstance getRowFilterExpressionWith:rowFilterExpressionId
              completionHandler: ^(ExpressionResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RowFiltersApi()
var rowFilterExpressionId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getRowFilterExpression(rowFilterExpressionId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getRowFilterExpressionExample
    {
        public void main()
        {

            var apiInstance = new RowFiltersApi();
            var rowFilterExpressionId = 789;  // Long | 

            try
            {
                // Get an expression that can be applied to filter table rows from query results
                ExpressionResponse result = apiInstance.getRowFilterExpression(rowFilterExpressionId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RowFiltersApi.getRowFilterExpression: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRowFiltersApi();
$rowFilterExpressionId = 789; // Long | 

try {
    $result = $api_instance->getRowFilterExpression($rowFilterExpressionId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RowFiltersApi->getRowFilterExpression: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RowFiltersApi;

my $api_instance = WWW::SwaggerClient::RowFiltersApi->new();
my $rowFilterExpressionId = 789; # Long | 

eval { 
    my $result = $api_instance->getRowFilterExpression(rowFilterExpressionId => $rowFilterExpressionId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RowFiltersApi->getRowFilterExpression: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RowFiltersApi()
rowFilterExpressionId = 789 # Long | 

try: 
    # Get an expression that can be applied to filter table rows from query results
    api_response = api_instance.get_row_filter_expression(rowFilterExpressionId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RowFiltersApi->getRowFilterExpression: %s\n" % e)

Parameters

Path parameters
Name Description
rowFilterExpressionId*
Long (int64)
Required

Responses

Status: 200 - Success

{
id:
integer (int64)

Expression id

name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

listRoleRowFilters

List all the rows filters of a role.


/api/v1/biac/roles/{roleId}/rowFilters

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/roles/{roleId}/rowFilters?pageToken=&pageSize=&pageSort="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RowFiltersApi;

import java.io.File;
import java.util.*;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultRowFilterResponse result = apiInstance.listRoleRowFilters(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#listRoleRowFilters");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RowFiltersApi;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultRowFilterResponse result = apiInstance.listRoleRowFilters(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#listRoleRowFilters");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)

RowFiltersApi *apiInstance = [[RowFiltersApi alloc] init];

// List all the rows filters of a role.
[apiInstance listRoleRowFiltersWith:roleId
    pageToken:pageToken
    pageSize:pageSize
    pageSort:pageSort
              completionHandler: ^(PaginatedResultRowFilterResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RowFiltersApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example // {{String}} Sorting order
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listRoleRowFilters(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listRoleRowFiltersExample
    {
        public void main()
        {

            var apiInstance = new RowFiltersApi();
            var roleId = 789;  // Long | 
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)

            try
            {
                // List all the rows filters of a role.
                PaginatedResultRowFilterResponse result = apiInstance.listRoleRowFilters(roleId, pageToken, pageSize, pageSort);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RowFiltersApi.listRoleRowFilters: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRowFiltersApi();
$roleId = 789; // Long | 
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order

try {
    $result = $api_instance->listRoleRowFilters($roleId, $pageToken, $pageSize, $pageSort);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RowFiltersApi->listRoleRowFilters: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RowFiltersApi;

my $api_instance = WWW::SwaggerClient::RowFiltersApi->new();
my $roleId = 789; # Long | 
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order

eval { 
    my $result = $api_instance->listRoleRowFilters(roleId => $roleId, pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RowFiltersApi->listRoleRowFilters: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RowFiltersApi()
roleId = 789 # Long | 
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)

try: 
    # List all the rows filters of a role.
    api_response = api_instance.list_role_row_filters(roleId, pageToken=pageToken, pageSize=pageSize, pageSort=pageSort)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RowFiltersApi->listRoleRowFilters: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{

Detailed data for a row filter added to a role

id:
integer (int64)

Id of the row filter applied to a role.

entity:
{
category:
string

TABLES, SCHEMA_PROPERTIES, TABLE_PROPERTIES, SYSTEM_SESSION_PROPERTIES, CATALOG_SESSION_PROPERTIES, FUNCTIONS, PROCEDURES, QUERIES, SYSTEM_INFORMATION, ROLES, USERS, DATA_PRODUCTS, AUDIT_LOGS

allEntities:
boolean

Is the entity representing all entities of the given category

}
one of:
{

Data of a TABLES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

table:
string

If empty it applies to all tables of the entity's schema

tableType:
string

If empty it applies to table, view and materialized view

Enum: TABLE, VIEW, MATERIALIZED_VIEW
columns:
[ (0..∞)

If empty it applies to all columns of the entity's table

string

If empty it applies to all columns of the entity's table

]
}
{

Data of a USERS, ROLES or SYSTEM_SESSION_PROPERTIES entity

}
all of:
{
entityKey:
string

If empty it applies to all entities of the given category

}
{

Data of a FUNCTIONS entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

function:
string

If empty it applies to all functions of the entity's schema

}
{

Data of a PROCEDURES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

procedure:
string

If empty it applies to all procedures of the entity's schema

}
{

Data of a CATALOG_SESSION_PROPERTIES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

entityKey:
string

If empty it applies to all entities of the given category in the entity's catalog

}
{

Data of a QUERIES or AUDIT_LOGS entity

}
all of:
{

Data of a DATA_PRODUCTS entity

}
all of:
{
domainName:
string

If empty it applies to all domains

dataProductName:
string

If empty it applies to all data products in the entity's domain

}
{

Data of a TABLE_PROPERTIES or SCHEMA_PROPERTIES entity

}
all of:
{
catalog:
string

If empty it applies to all catalogs

schema:
string

If empty it applies to all schemas of the entity's catalog

table:
string

If empty it applies to all tables of the entity's schema

property:
string

If empty it applies to all properties of the entity's table or schema

value:
string

If empty it applies to all property values

}
expressionId:
integer (int64)

Id of the row filter expression.

forceNone:
boolean

If true, forces not filtering table rows for the given entity, even if the subject is assigned to other roles with row filters to the same entity.

}
]
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

listRowFilterExpressions

List expressions that can be applied to filter table rows from query results


/api/v1/biac/expressions/rowFilter

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/expressions/rowFilter"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RowFiltersApi;

import java.io.File;
import java.util.*;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        
        RowFiltersApi apiInstance = new RowFiltersApi();
        try {
            PaginatedResultExpressionResponse result = apiInstance.listRowFilterExpressions();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#listRowFilterExpressions");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RowFiltersApi;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        RowFiltersApi apiInstance = new RowFiltersApi();
        try {
            PaginatedResultExpressionResponse result = apiInstance.listRowFilterExpressions();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#listRowFilterExpressions");
            e.printStackTrace();
        }
    }
}

RowFiltersApi *apiInstance = [[RowFiltersApi alloc] init];

// List expressions that can be applied to filter table rows from query results
[apiInstance listRowFilterExpressionsWithCompletionHandler: 
              ^(PaginatedResultExpressionResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RowFiltersApi()
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listRowFilterExpressions(callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listRowFilterExpressionsExample
    {
        public void main()
        {

            var apiInstance = new RowFiltersApi();

            try
            {
                // List expressions that can be applied to filter table rows from query results
                PaginatedResultExpressionResponse result = apiInstance.listRowFilterExpressions();
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RowFiltersApi.listRowFilterExpressions: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRowFiltersApi();

try {
    $result = $api_instance->listRowFilterExpressions();
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RowFiltersApi->listRowFilterExpressions: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RowFiltersApi;

my $api_instance = WWW::SwaggerClient::RowFiltersApi->new();

eval { 
    my $result = $api_instance->listRowFilterExpressions();
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RowFiltersApi->listRowFilterExpressions: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RowFiltersApi()

try: 
    # List expressions that can be applied to filter table rows from query results
    api_response = api_instance.list_row_filter_expressions()
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RowFiltersApi->listRowFilterExpressions: %s\n" % e)

Parameters

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{
id:
integer (int64)

Expression id

name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}
]
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

updateRowFilterExpression

Update a row filter expression


/api/v1/biac/expressions/rowFilter/{rowFilterExpressionId}

Usage and SDK Samples

curl -X PUT\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/expressions/rowFilter/{rowFilterExpressionId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RowFiltersApi;

import java.io.File;
import java.util.*;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long rowFilterExpressionId = 789; // Long | 
        ExpressionPayload body = ; // ExpressionPayload | 
        try {
            ExpressionResponse result = apiInstance.updateRowFilterExpression(rowFilterExpressionId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#updateRowFilterExpression");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.RowFiltersApi;

public class RowFiltersApiExample {

    public static void main(String[] args) {
        RowFiltersApi apiInstance = new RowFiltersApi();
        Long rowFilterExpressionId = 789; // Long | 
        ExpressionPayload body = ; // ExpressionPayload | 
        try {
            ExpressionResponse result = apiInstance.updateRowFilterExpression(rowFilterExpressionId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling RowFiltersApi#updateRowFilterExpression");
            e.printStackTrace();
        }
    }
}
Long *rowFilterExpressionId = 789; // 
ExpressionPayload *body = ; //  (optional)

RowFiltersApi *apiInstance = [[RowFiltersApi alloc] init];

// Update a row filter expression
[apiInstance updateRowFilterExpressionWith:rowFilterExpressionId
    body:body
              completionHandler: ^(ExpressionResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.RowFiltersApi()
var rowFilterExpressionId = 789; // {{Long}} 
var opts = { 
  'body':  // {{ExpressionPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.updateRowFilterExpression(rowFilterExpressionId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class updateRowFilterExpressionExample
    {
        public void main()
        {

            var apiInstance = new RowFiltersApi();
            var rowFilterExpressionId = 789;  // Long | 
            var body = new ExpressionPayload(); // ExpressionPayload |  (optional) 

            try
            {
                // Update a row filter expression
                ExpressionResponse result = apiInstance.updateRowFilterExpression(rowFilterExpressionId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RowFiltersApi.updateRowFilterExpression: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiRowFiltersApi();
$rowFilterExpressionId = 789; // Long | 
$body = ; // ExpressionPayload | 

try {
    $result = $api_instance->updateRowFilterExpression($rowFilterExpressionId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling RowFiltersApi->updateRowFilterExpression: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::RowFiltersApi;

my $api_instance = WWW::SwaggerClient::RowFiltersApi->new();
my $rowFilterExpressionId = 789; # Long | 
my $body = WWW::SwaggerClient::Object::ExpressionPayload->new(); # ExpressionPayload | 

eval { 
    my $result = $api_instance->updateRowFilterExpression(rowFilterExpressionId => $rowFilterExpressionId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling RowFiltersApi->updateRowFilterExpression: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.RowFiltersApi()
rowFilterExpressionId = 789 # Long | 
body =  # ExpressionPayload |  (optional)

try: 
    # Update a row filter expression
    api_response = api_instance.update_row_filter_expression(rowFilterExpressionId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RowFiltersApi->updateRowFilterExpression: %s\n" % e)

Parameters

Path parameters
Name Description
rowFilterExpressionId*
Long (int64)
Required
Body parameters
Name Description
body
{
name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}

Responses

Status: 200 - Success

{
id:
integer (int64)

Expression id

name:
string

Expression name

expression:
string

Expression definition in SQL

description:
string

Optional expression description

}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Subjects

createRoleAssignmentForGroup

Assign a Starburst built-in access control role to the given group


/api/v1/biac/subjects/groups/{groupName}/assignments

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/subjects/groups/{groupName}/assignments"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.SubjectsApi;

import java.io.File;
import java.util.*;

public class SubjectsApiExample {

    public static void main(String[] args) {
        
        SubjectsApi apiInstance = new SubjectsApi();
        String groupName = groupName_example; // String | 
        SubjectRoleAssignmentPayload body = ; // SubjectRoleAssignmentPayload | 
        try {
            SubjectRoleAssignmentResponse result = apiInstance.createRoleAssignmentForGroup(groupName, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#createRoleAssignmentForGroup");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.SubjectsApi;

public class SubjectsApiExample {

    public static void main(String[] args) {
        SubjectsApi apiInstance = new SubjectsApi();
        String groupName = groupName_example; // String | 
        SubjectRoleAssignmentPayload body = ; // SubjectRoleAssignmentPayload | 
        try {
            SubjectRoleAssignmentResponse result = apiInstance.createRoleAssignmentForGroup(groupName, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#createRoleAssignmentForGroup");
            e.printStackTrace();
        }
    }
}
String *groupName = groupName_example; // 
SubjectRoleAssignmentPayload *body = ; //  (optional)

SubjectsApi *apiInstance = [[SubjectsApi alloc] init];

// Assign a Starburst built-in access control role to the given group
[apiInstance createRoleAssignmentForGroupWith:groupName
    body:body
              completionHandler: ^(SubjectRoleAssignmentResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.SubjectsApi()
var groupName = groupName_example; // {{String}} 
var opts = { 
  'body':  // {{SubjectRoleAssignmentPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.createRoleAssignmentForGroup(groupName, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class createRoleAssignmentForGroupExample
    {
        public void main()
        {

            var apiInstance = new SubjectsApi();
            var groupName = groupName_example;  // String | 
            var body = new SubjectRoleAssignmentPayload(); // SubjectRoleAssignmentPayload |  (optional) 

            try
            {
                // Assign a Starburst built-in access control role to the given group
                SubjectRoleAssignmentResponse result = apiInstance.createRoleAssignmentForGroup(groupName, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SubjectsApi.createRoleAssignmentForGroup: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiSubjectsApi();
$groupName = groupName_example; // String | 
$body = ; // SubjectRoleAssignmentPayload | 

try {
    $result = $api_instance->createRoleAssignmentForGroup($groupName, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SubjectsApi->createRoleAssignmentForGroup: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::SubjectsApi;

my $api_instance = WWW::SwaggerClient::SubjectsApi->new();
my $groupName = groupName_example; # String | 
my $body = WWW::SwaggerClient::Object::SubjectRoleAssignmentPayload->new(); # SubjectRoleAssignmentPayload | 

eval { 
    my $result = $api_instance->createRoleAssignmentForGroup(groupName => $groupName, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling SubjectsApi->createRoleAssignmentForGroup: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.SubjectsApi()
groupName = groupName_example # String | 
body =  # SubjectRoleAssignmentPayload |  (optional)

try: 
    # Assign a Starburst built-in access control role to the given group
    api_response = api_instance.create_role_assignment_for_group(groupName, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SubjectsApi->createRoleAssignmentForGroup: %s\n" % e)

Parameters

Path parameters
Name Description
groupName*
String
Required
Body parameters
Name Description
body
{
Required: roleId
roleId:
integer (int64)

ID of the role to assign to the subject

roleAdmin:
boolean

If true the subject will have an admin option for the assigned role

}

Responses

Status: 200 - Success

{

The current page of results.

id:
integer (int64)

ID of the role assignment

roleId:
integer (int64)

ID of the role assigned to the subject

roleAdmin:
boolean

If true the subject has an admin option for the assigned role

}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

createRoleAssignmentForRole

Assign a Starburst built-in access control role to the given role


/api/v1/biac/subjects/roles/{roleId}/assignments

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/subjects/roles/{roleId}/assignments"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.SubjectsApi;

import java.io.File;
import java.util.*;

public class SubjectsApiExample {

    public static void main(String[] args) {
        
        SubjectsApi apiInstance = new SubjectsApi();
        Long roleId = 789; // Long | 
        SubjectRoleAssignmentPayload body = ; // SubjectRoleAssignmentPayload | 
        try {
            SubjectRoleAssignmentResponse result = apiInstance.createRoleAssignmentForRole(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#createRoleAssignmentForRole");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.SubjectsApi;

public class SubjectsApiExample {

    public static void main(String[] args) {
        SubjectsApi apiInstance = new SubjectsApi();
        Long roleId = 789; // Long | 
        SubjectRoleAssignmentPayload body = ; // SubjectRoleAssignmentPayload | 
        try {
            SubjectRoleAssignmentResponse result = apiInstance.createRoleAssignmentForRole(roleId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#createRoleAssignmentForRole");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
SubjectRoleAssignmentPayload *body = ; //  (optional)

SubjectsApi *apiInstance = [[SubjectsApi alloc] init];

// Assign a Starburst built-in access control role to the given role
[apiInstance createRoleAssignmentForRoleWith:roleId
    body:body
              completionHandler: ^(SubjectRoleAssignmentResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.SubjectsApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'body':  // {{SubjectRoleAssignmentPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.createRoleAssignmentForRole(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class createRoleAssignmentForRoleExample
    {
        public void main()
        {

            var apiInstance = new SubjectsApi();
            var roleId = 789;  // Long | 
            var body = new SubjectRoleAssignmentPayload(); // SubjectRoleAssignmentPayload |  (optional) 

            try
            {
                // Assign a Starburst built-in access control role to the given role
                SubjectRoleAssignmentResponse result = apiInstance.createRoleAssignmentForRole(roleId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SubjectsApi.createRoleAssignmentForRole: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiSubjectsApi();
$roleId = 789; // Long | 
$body = ; // SubjectRoleAssignmentPayload | 

try {
    $result = $api_instance->createRoleAssignmentForRole($roleId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SubjectsApi->createRoleAssignmentForRole: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::SubjectsApi;

my $api_instance = WWW::SwaggerClient::SubjectsApi->new();
my $roleId = 789; # Long | 
my $body = WWW::SwaggerClient::Object::SubjectRoleAssignmentPayload->new(); # SubjectRoleAssignmentPayload | 

eval { 
    my $result = $api_instance->createRoleAssignmentForRole(roleId => $roleId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling SubjectsApi->createRoleAssignmentForRole: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.SubjectsApi()
roleId = 789 # Long | 
body =  # SubjectRoleAssignmentPayload |  (optional)

try: 
    # Assign a Starburst built-in access control role to the given role
    api_response = api_instance.create_role_assignment_for_role(roleId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SubjectsApi->createRoleAssignmentForRole: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Body parameters
Name Description
body
{
Required: roleId
roleId:
integer (int64)

ID of the role to assign to the subject

roleAdmin:
boolean

If true the subject will have an admin option for the assigned role

}

Responses

Status: 200 - Success

{

The current page of results.

id:
integer (int64)

ID of the role assignment

roleId:
integer (int64)

ID of the role assigned to the subject

roleAdmin:
boolean

If true the subject has an admin option for the assigned role

}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

createRoleAssignmentForUser

Assign a Starburst built-in access control role to the given user


/api/v1/biac/subjects/users/{username}/assignments

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/biac/subjects/users/{username}/assignments"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.SubjectsApi;

import java.io.File;
import java.util.*;

public class SubjectsApiExample {

    public static void main(String[] args) {
        
        SubjectsApi apiInstance = new SubjectsApi();
        String username = username_example; // String | 
        SubjectRoleAssignmentPayload body = ; // SubjectRoleAssignmentPayload | 
        try {
            SubjectRoleAssignmentResponse result = apiInstance.createRoleAssignmentForUser(username, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#createRoleAssignmentForUser");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.SubjectsApi;

public class SubjectsApiExample {

    public static void main(String[] args) {
        SubjectsApi apiInstance = new SubjectsApi();
        String username = username_example; // String | 
        SubjectRoleAssignmentPayload body = ; // SubjectRoleAssignmentPayload | 
        try {
            SubjectRoleAssignmentResponse result = apiInstance.createRoleAssignmentForUser(username, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#createRoleAssignmentForUser");
            e.printStackTrace();
        }
    }
}
String *username = username_example; // 
SubjectRoleAssignmentPayload *body = ; //  (optional)

SubjectsApi *apiInstance = [[SubjectsApi alloc] init];

// Assign a Starburst built-in access control role to the given user
[apiInstance createRoleAssignmentForUserWith:username
    body:body
              completionHandler: ^(SubjectRoleAssignmentResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.SubjectsApi()
var username = username_example; // {{String}} 
var opts = { 
  'body':  // {{SubjectRoleAssignmentPayload}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.createRoleAssignmentForUser(username, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class createRoleAssignmentForUserExample
    {
        public void main()
        {

            var apiInstance = new SubjectsApi();
            var username = username_example;  // String | 
            var body = new SubjectRoleAssignmentPayload(); // SubjectRoleAssignmentPayload |  (optional) 

            try
            {
                // Assign a Starburst built-in access control role to the given user
                SubjectRoleAssignmentResponse result = apiInstance.createRoleAssignmentForUser(username, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SubjectsApi.createRoleAssignmentForUser: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiSubjectsApi();
$username = username_example; // String | 
$body = ; // SubjectRoleAssignmentPayload | 

try {
    $result = $api_instance->createRoleAssignmentForUser($username, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SubjectsApi->createRoleAssignmentForUser: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::SubjectsApi;

my $api_instance = WWW::SwaggerClient::SubjectsApi->new();
my $username = username_example; # String | 
my $body = WWW::SwaggerClient::Object::SubjectRoleAssignmentPayload->new(); # SubjectRoleAssignmentPayload | 

eval { 
    my $result = $api_instance->createRoleAssignmentForUser(username => $username, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling SubjectsApi->createRoleAssignmentForUser: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.SubjectsApi()
username = username_example # String | 
body =  # SubjectRoleAssignmentPayload |  (optional)

try: 
    # Assign a Starburst built-in access control role to the given user
    api_response = api_instance.create_role_assignment_for_user(username, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SubjectsApi->createRoleAssignmentForUser: %s\n" % e)

Parameters

Path parameters
Name Description
username*
String
Required
Body parameters
Name Description
body
{
Required: roleId
roleId:
integer (int64)

ID of the role to assign to the subject

roleAdmin:
boolean

If true the subject will have an admin option for the assigned role

}

Responses

Status: 200 - Success

{

The current page of results.

id:
integer (int64)

ID of the role assignment

roleId:
integer (int64)

ID of the role assigned to the subject

roleAdmin:
boolean

If true the subject has an admin option for the assigned role

}

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

deleteRoleAssignmentFromGroup

Delete an assignment to a Starburst built-in access control role from the given group


/api/v1/biac/subjects/groups/{groupName}/assignments/{assignmentId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: */*,application/json"\
"//api/v1/biac/subjects/groups/{groupName}/assignments/{assignmentId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.SubjectsApi;

import java.io.File;
import java.util.*;

public class SubjectsApiExample {

    public static void main(String[] args) {
        
        SubjectsApi apiInstance = new SubjectsApi();
        String groupName = groupName_example; // String | 
        Long assignmentId = 789; // Long | 
        try {
            apiInstance.deleteRoleAssignmentFromGroup(groupName, assignmentId);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#deleteRoleAssignmentFromGroup");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.SubjectsApi;

public class SubjectsApiExample {

    public static void main(String[] args) {
        SubjectsApi apiInstance = new SubjectsApi();
        String groupName = groupName_example; // String | 
        Long assignmentId = 789; // Long | 
        try {
            apiInstance.deleteRoleAssignmentFromGroup(groupName, assignmentId);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#deleteRoleAssignmentFromGroup");
            e.printStackTrace();
        }
    }
}
String *groupName = groupName_example; // 
Long *assignmentId = 789; // 

SubjectsApi *apiInstance = [[SubjectsApi alloc] init];

// Delete an assignment to a Starburst built-in access control role from the given group
[apiInstance deleteRoleAssignmentFromGroupWith:groupName
    assignmentId:assignmentId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.SubjectsApi()
var groupName = groupName_example; // {{String}} 
var assignmentId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteRoleAssignmentFromGroup(groupName, assignmentId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteRoleAssignmentFromGroupExample
    {
        public void main()
        {

            var apiInstance = new SubjectsApi();
            var groupName = groupName_example;  // String | 
            var assignmentId = 789;  // Long | 

            try
            {
                // Delete an assignment to a Starburst built-in access control role from the given group
                apiInstance.deleteRoleAssignmentFromGroup(groupName, assignmentId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SubjectsApi.deleteRoleAssignmentFromGroup: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiSubjectsApi();
$groupName = groupName_example; // String | 
$assignmentId = 789; // Long | 

try {
    $api_instance->deleteRoleAssignmentFromGroup($groupName, $assignmentId);
} catch (Exception $e) {
    echo 'Exception when calling SubjectsApi->deleteRoleAssignmentFromGroup: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::SubjectsApi;

my $api_instance = WWW::SwaggerClient::SubjectsApi->new();
my $groupName = groupName_example; # String | 
my $assignmentId = 789; # Long | 

eval { 
    $api_instance->deleteRoleAssignmentFromGroup(groupName => $groupName, assignmentId => $assignmentId);
};
if ($@) {
    warn "Exception when calling SubjectsApi->deleteRoleAssignmentFromGroup: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.SubjectsApi()
groupName = groupName_example # String | 
assignmentId = 789 # Long | 

try: 
    # Delete an assignment to a Starburst built-in access control role from the given group
    api_instance.delete_role_assignment_from_group(groupName, assignmentId)
except ApiException as e:
    print("Exception when calling SubjectsApi->deleteRoleAssignmentFromGroup: %s\n" % e)

Parameters

Path parameters
Name Description
groupName*
String
Required
assignmentId*
Long (int64)
Required

Responses

Status: 204 - Success

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

deleteRoleAssignmentFromRole

Delete an assignment to a Starburst built-in access control role from the given role


/api/v1/biac/subjects/roles/{roleId}/assignments/{assignmentId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: */*,application/json"\
"//api/v1/biac/subjects/roles/{roleId}/assignments/{assignmentId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.SubjectsApi;

import java.io.File;
import java.util.*;

public class SubjectsApiExample {

    public static void main(String[] args) {
        
        SubjectsApi apiInstance = new SubjectsApi();
        Long roleId = 789; // Long | 
        Long assignmentId = 789; // Long | 
        try {
            apiInstance.deleteRoleAssignmentFromRole(roleId, assignmentId);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#deleteRoleAssignmentFromRole");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.SubjectsApi;

public class SubjectsApiExample {

    public static void main(String[] args) {
        SubjectsApi apiInstance = new SubjectsApi();
        Long roleId = 789; // Long | 
        Long assignmentId = 789; // Long | 
        try {
            apiInstance.deleteRoleAssignmentFromRole(roleId, assignmentId);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#deleteRoleAssignmentFromRole");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
Long *assignmentId = 789; // 

SubjectsApi *apiInstance = [[SubjectsApi alloc] init];

// Delete an assignment to a Starburst built-in access control role from the given role
[apiInstance deleteRoleAssignmentFromRoleWith:roleId
    assignmentId:assignmentId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.SubjectsApi()
var roleId = 789; // {{Long}} 
var assignmentId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteRoleAssignmentFromRole(roleId, assignmentId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteRoleAssignmentFromRoleExample
    {
        public void main()
        {

            var apiInstance = new SubjectsApi();
            var roleId = 789;  // Long | 
            var assignmentId = 789;  // Long | 

            try
            {
                // Delete an assignment to a Starburst built-in access control role from the given role
                apiInstance.deleteRoleAssignmentFromRole(roleId, assignmentId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SubjectsApi.deleteRoleAssignmentFromRole: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiSubjectsApi();
$roleId = 789; // Long | 
$assignmentId = 789; // Long | 

try {
    $api_instance->deleteRoleAssignmentFromRole($roleId, $assignmentId);
} catch (Exception $e) {
    echo 'Exception when calling SubjectsApi->deleteRoleAssignmentFromRole: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::SubjectsApi;

my $api_instance = WWW::SwaggerClient::SubjectsApi->new();
my $roleId = 789; # Long | 
my $assignmentId = 789; # Long | 

eval { 
    $api_instance->deleteRoleAssignmentFromRole(roleId => $roleId, assignmentId => $assignmentId);
};
if ($@) {
    warn "Exception when calling SubjectsApi->deleteRoleAssignmentFromRole: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.SubjectsApi()
roleId = 789 # Long | 
assignmentId = 789 # Long | 

try: 
    # Delete an assignment to a Starburst built-in access control role from the given role
    api_instance.delete_role_assignment_from_role(roleId, assignmentId)
except ApiException as e:
    print("Exception when calling SubjectsApi->deleteRoleAssignmentFromRole: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
assignmentId*
Long (int64)
Required

Responses

Status: 204 - Success

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

deleteRoleAssignmentFromUser

Delete an assignment to a Starburst built-in access control role from the given user


/api/v1/biac/subjects/users/{username}/assignments/{assignmentId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: */*,application/json"\
"//api/v1/biac/subjects/users/{username}/assignments/{assignmentId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.SubjectsApi;

import java.io.File;
import java.util.*;

public class SubjectsApiExample {

    public static void main(String[] args) {
        
        SubjectsApi apiInstance = new SubjectsApi();
        String username = username_example; // String | 
        Long assignmentId = 789; // Long | 
        try {
            apiInstance.deleteRoleAssignmentFromUser(username, assignmentId);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#deleteRoleAssignmentFromUser");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.SubjectsApi;

public class SubjectsApiExample {

    public static void main(String[] args) {
        SubjectsApi apiInstance = new SubjectsApi();
        String username = username_example; // String | 
        Long assignmentId = 789; // Long | 
        try {
            apiInstance.deleteRoleAssignmentFromUser(username, assignmentId);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#deleteRoleAssignmentFromUser");
            e.printStackTrace();
        }
    }
}
String *username = username_example; // 
Long *assignmentId = 789; // 

SubjectsApi *apiInstance = [[SubjectsApi alloc] init];

// Delete an assignment to a Starburst built-in access control role from the given user
[apiInstance deleteRoleAssignmentFromUserWith:username
    assignmentId:assignmentId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.SubjectsApi()
var username = username_example; // {{String}} 
var assignmentId = 789; // {{Long}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteRoleAssignmentFromUser(username, assignmentId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteRoleAssignmentFromUserExample
    {
        public void main()
        {

            var apiInstance = new SubjectsApi();
            var username = username_example;  // String | 
            var assignmentId = 789;  // Long | 

            try
            {
                // Delete an assignment to a Starburst built-in access control role from the given user
                apiInstance.deleteRoleAssignmentFromUser(username, assignmentId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SubjectsApi.deleteRoleAssignmentFromUser: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiSubjectsApi();
$username = username_example; // String | 
$assignmentId = 789; // Long | 

try {
    $api_instance->deleteRoleAssignmentFromUser($username, $assignmentId);
} catch (Exception $e) {
    echo 'Exception when calling SubjectsApi->deleteRoleAssignmentFromUser: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::SubjectsApi;

my $api_instance = WWW::SwaggerClient::SubjectsApi->new();
my $username = username_example; # String | 
my $assignmentId = 789; # Long | 

eval { 
    $api_instance->deleteRoleAssignmentFromUser(username => $username, assignmentId => $assignmentId);
};
if ($@) {
    warn "Exception when calling SubjectsApi->deleteRoleAssignmentFromUser: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.SubjectsApi()
username = username_example # String | 
assignmentId = 789 # Long | 

try: 
    # Delete an assignment to a Starburst built-in access control role from the given user
    api_instance.delete_role_assignment_from_user(username, assignmentId)
except ApiException as e:
    print("Exception when calling SubjectsApi->deleteRoleAssignmentFromUser: %s\n" % e)

Parameters

Path parameters
Name Description
username*
String
Required
assignmentId*
Long (int64)
Required

Responses

Status: 204 - Success

Status: 400 - Bad Request

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

getRoleAssignmentsForGroup

Get all Starburst built-in access control roles assigned to the given group


/api/v1/biac/subjects/groups/{groupName}/assignments

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/subjects/groups/{groupName}/assignments?pageToken=&pageSize=&pageSort="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.SubjectsApi;

import java.io.File;
import java.util.*;

public class SubjectsApiExample {

    public static void main(String[] args) {
        
        SubjectsApi apiInstance = new SubjectsApi();
        String groupName = groupName_example; // String | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultSubjectRoleAssignmentResponse result = apiInstance.getRoleAssignmentsForGroup(groupName, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#getRoleAssignmentsForGroup");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.SubjectsApi;

public class SubjectsApiExample {

    public static void main(String[] args) {
        SubjectsApi apiInstance = new SubjectsApi();
        String groupName = groupName_example; // String | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultSubjectRoleAssignmentResponse result = apiInstance.getRoleAssignmentsForGroup(groupName, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#getRoleAssignmentsForGroup");
            e.printStackTrace();
        }
    }
}
String *groupName = groupName_example; // 
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)

SubjectsApi *apiInstance = [[SubjectsApi alloc] init];

// Get all Starburst built-in access control roles assigned to the given group
[apiInstance getRoleAssignmentsForGroupWith:groupName
    pageToken:pageToken
    pageSize:pageSize
    pageSort:pageSort
              completionHandler: ^(PaginatedResultSubjectRoleAssignmentResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.SubjectsApi()
var groupName = groupName_example; // {{String}} 
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example // {{String}} Sorting order
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getRoleAssignmentsForGroup(groupName, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getRoleAssignmentsForGroupExample
    {
        public void main()
        {

            var apiInstance = new SubjectsApi();
            var groupName = groupName_example;  // String | 
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)

            try
            {
                // Get all Starburst built-in access control roles assigned to the given group
                PaginatedResultSubjectRoleAssignmentResponse result = apiInstance.getRoleAssignmentsForGroup(groupName, pageToken, pageSize, pageSort);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SubjectsApi.getRoleAssignmentsForGroup: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiSubjectsApi();
$groupName = groupName_example; // String | 
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order

try {
    $result = $api_instance->getRoleAssignmentsForGroup($groupName, $pageToken, $pageSize, $pageSort);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SubjectsApi->getRoleAssignmentsForGroup: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::SubjectsApi;

my $api_instance = WWW::SwaggerClient::SubjectsApi->new();
my $groupName = groupName_example; # String | 
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order

eval { 
    my $result = $api_instance->getRoleAssignmentsForGroup(groupName => $groupName, pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling SubjectsApi->getRoleAssignmentsForGroup: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.SubjectsApi()
groupName = groupName_example # String | 
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)

try: 
    # Get all Starburst built-in access control roles assigned to the given group
    api_response = api_instance.get_role_assignments_for_group(groupName, pageToken=pageToken, pageSize=pageSize, pageSort=pageSort)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SubjectsApi->getRoleAssignmentsForGroup: %s\n" % e)

Parameters

Path parameters
Name Description
groupName*
String
Required
Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{

The current page of results.

id:
integer (int64)

ID of the role assignment

roleId:
integer (int64)

ID of the role assigned to the subject

roleAdmin:
boolean

If true the subject has an admin option for the assigned role

}
]
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

getRoleAssignmentsForRole

Get all Starburst built-in access control roles assigned to the given role


/api/v1/biac/subjects/roles/{roleId}/assignments

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/subjects/roles/{roleId}/assignments?pageToken=&pageSize=&pageSort="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.SubjectsApi;

import java.io.File;
import java.util.*;

public class SubjectsApiExample {

    public static void main(String[] args) {
        
        SubjectsApi apiInstance = new SubjectsApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultSubjectRoleAssignmentResponse result = apiInstance.getRoleAssignmentsForRole(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#getRoleAssignmentsForRole");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.SubjectsApi;

public class SubjectsApiExample {

    public static void main(String[] args) {
        SubjectsApi apiInstance = new SubjectsApi();
        Long roleId = 789; // Long | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultSubjectRoleAssignmentResponse result = apiInstance.getRoleAssignmentsForRole(roleId, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#getRoleAssignmentsForRole");
            e.printStackTrace();
        }
    }
}
Long *roleId = 789; // 
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)

SubjectsApi *apiInstance = [[SubjectsApi alloc] init];

// Get all Starburst built-in access control roles assigned to the given role
[apiInstance getRoleAssignmentsForRoleWith:roleId
    pageToken:pageToken
    pageSize:pageSize
    pageSort:pageSort
              completionHandler: ^(PaginatedResultSubjectRoleAssignmentResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.SubjectsApi()
var roleId = 789; // {{Long}} 
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example // {{String}} Sorting order
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getRoleAssignmentsForRole(roleId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getRoleAssignmentsForRoleExample
    {
        public void main()
        {

            var apiInstance = new SubjectsApi();
            var roleId = 789;  // Long | 
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)

            try
            {
                // Get all Starburst built-in access control roles assigned to the given role
                PaginatedResultSubjectRoleAssignmentResponse result = apiInstance.getRoleAssignmentsForRole(roleId, pageToken, pageSize, pageSort);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SubjectsApi.getRoleAssignmentsForRole: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiSubjectsApi();
$roleId = 789; // Long | 
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order

try {
    $result = $api_instance->getRoleAssignmentsForRole($roleId, $pageToken, $pageSize, $pageSort);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SubjectsApi->getRoleAssignmentsForRole: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::SubjectsApi;

my $api_instance = WWW::SwaggerClient::SubjectsApi->new();
my $roleId = 789; # Long | 
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order

eval { 
    my $result = $api_instance->getRoleAssignmentsForRole(roleId => $roleId, pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling SubjectsApi->getRoleAssignmentsForRole: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.SubjectsApi()
roleId = 789 # Long | 
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)

try: 
    # Get all Starburst built-in access control roles assigned to the given role
    api_response = api_instance.get_role_assignments_for_role(roleId, pageToken=pageToken, pageSize=pageSize, pageSort=pageSort)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SubjectsApi->getRoleAssignmentsForRole: %s\n" % e)

Parameters

Path parameters
Name Description
roleId*
Long (int64)
Required
Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{

The current page of results.

id:
integer (int64)

ID of the role assignment

roleId:
integer (int64)

ID of the role assigned to the subject

roleAdmin:
boolean

If true the subject has an admin option for the assigned role

}
]
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Status: 404 - Not found

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

getRoleAssignmentsForUser

Get all Starburst built-in access control roles assigned to the given user


/api/v1/biac/subjects/users/{username}/assignments

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/biac/subjects/users/{username}/assignments?pageToken=&pageSize=&pageSort="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.SubjectsApi;

import java.io.File;
import java.util.*;

public class SubjectsApiExample {

    public static void main(String[] args) {
        
        SubjectsApi apiInstance = new SubjectsApi();
        String username = username_example; // String | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultSubjectRoleAssignmentResponse result = apiInstance.getRoleAssignmentsForUser(username, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#getRoleAssignmentsForUser");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.SubjectsApi;

public class SubjectsApiExample {

    public static void main(String[] args) {
        SubjectsApi apiInstance = new SubjectsApi();
        String username = username_example; // String | 
        String pageToken = pageToken_example; // String | Page token
        String pageSize = pageSize_example; // String | Page size
        String pageSort = pageSort_example; // String | Sorting order
        try {
            PaginatedResultSubjectRoleAssignmentResponse result = apiInstance.getRoleAssignmentsForUser(username, pageToken, pageSize, pageSort);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SubjectsApi#getRoleAssignmentsForUser");
            e.printStackTrace();
        }
    }
}
String *username = username_example; // 
String *pageToken = pageToken_example; // Page token (optional)
String *pageSize = pageSize_example; // Page size (optional) (default to 100)
String *pageSort = pageSort_example; // Sorting order (optional) (default to desc)

SubjectsApi *apiInstance = [[SubjectsApi alloc] init];

// Get all Starburst built-in access control roles assigned to the given user
[apiInstance getRoleAssignmentsForUserWith:username
    pageToken:pageToken
    pageSize:pageSize
    pageSort:pageSort
              completionHandler: ^(PaginatedResultSubjectRoleAssignmentResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.SubjectsApi()
var username = username_example; // {{String}} 
var opts = { 
  'pageToken': pageToken_example, // {{String}} Page token
  'pageSize': pageSize_example, // {{String}} Page size
  'pageSort': pageSort_example // {{String}} Sorting order
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getRoleAssignmentsForUser(username, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getRoleAssignmentsForUserExample
    {
        public void main()
        {

            var apiInstance = new SubjectsApi();
            var username = username_example;  // String | 
            var pageToken = pageToken_example;  // String | Page token (optional) 
            var pageSize = pageSize_example;  // String | Page size (optional)  (default to 100)
            var pageSort = pageSort_example;  // String | Sorting order (optional)  (default to desc)

            try
            {
                // Get all Starburst built-in access control roles assigned to the given user
                PaginatedResultSubjectRoleAssignmentResponse result = apiInstance.getRoleAssignmentsForUser(username, pageToken, pageSize, pageSort);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SubjectsApi.getRoleAssignmentsForUser: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiSubjectsApi();
$username = username_example; // String | 
$pageToken = pageToken_example; // String | Page token
$pageSize = pageSize_example; // String | Page size
$pageSort = pageSort_example; // String | Sorting order

try {
    $result = $api_instance->getRoleAssignmentsForUser($username, $pageToken, $pageSize, $pageSort);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SubjectsApi->getRoleAssignmentsForUser: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::SubjectsApi;

my $api_instance = WWW::SwaggerClient::SubjectsApi->new();
my $username = username_example; # String | 
my $pageToken = pageToken_example; # String | Page token
my $pageSize = pageSize_example; # String | Page size
my $pageSort = pageSort_example; # String | Sorting order

eval { 
    my $result = $api_instance->getRoleAssignmentsForUser(username => $username, pageToken => $pageToken, pageSize => $pageSize, pageSort => $pageSort);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling SubjectsApi->getRoleAssignmentsForUser: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.SubjectsApi()
username = username_example # String | 
pageToken = pageToken_example # String | Page token (optional)
pageSize = pageSize_example # String | Page size (optional) (default to 100)
pageSort = pageSort_example # String | Sorting order (optional) (default to desc)

try: 
    # Get all Starburst built-in access control roles assigned to the given user
    api_response = api_instance.get_role_assignments_for_user(username, pageToken=pageToken, pageSize=pageSize, pageSort=pageSort)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SubjectsApi->getRoleAssignmentsForUser: %s\n" % e)

Parameters

Path parameters
Name Description
username*
String
Required
Query parameters
Name Description
pageToken
String
Page token
pageSize
String
Page size
pageSort
String
Sorting order

Responses

Status: 200 - Success

{

Container for paginated results

nextPageToken:
string

If there are more pages to the result, this contains the token used to retrieve the next page.

result:
[

The current page of results.

{

The current page of results.

id:
integer (int64)

ID of the role assignment

roleId:
integer (int64)

ID of the role assigned to the subject

roleAdmin:
boolean

If true the subject has an admin option for the assigned role

}
]
}

Status: 401 - Unauthorized

Status: 403 - Forbidden

{
errorCode:
string
Enum: INVALID_ARGUMENT, NOT_SUPPORTED, SQL_SYNTAX_ERROR, PERMISSION_DENIED, NOT_FOUND, ENTITY_NOT_FOUND, ALREADY_EXISTS, INTERNAL_ERROR
message:
string
detailsType:
string
details:
{
type:
string
}
}

Tags

deleteAllUnusedTags

Delete all unused tags


/api/v1/dataProduct/tags/unused

Usage and SDK Samples

curl -X DELETE\
-H "Accept: application/json"\
"//api/v1/dataProduct/tags/unused"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.TagsApi;

import java.io.File;
import java.util.*;

public class TagsApiExample {

    public static void main(String[] args) {
        
        TagsApi apiInstance = new TagsApi();
        try {
            apiInstance.deleteAllUnusedTags();
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#deleteAllUnusedTags");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.TagsApi;

public class TagsApiExample {

    public static void main(String[] args) {
        TagsApi apiInstance = new TagsApi();
        try {
            apiInstance.deleteAllUnusedTags();
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#deleteAllUnusedTags");
            e.printStackTrace();
        }
    }
}

TagsApi *apiInstance = [[TagsApi alloc] init];

// Delete all unused tags
[apiInstance deleteAllUnusedTagsWithCompletionHandler: 
              ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.TagsApi()
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteAllUnusedTags(callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteAllUnusedTagsExample
    {
        public void main()
        {

            var apiInstance = new TagsApi();

            try
            {
                // Delete all unused tags
                apiInstance.deleteAllUnusedTags();
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling TagsApi.deleteAllUnusedTags: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiTagsApi();

try {
    $api_instance->deleteAllUnusedTags();
} catch (Exception $e) {
    echo 'Exception when calling TagsApi->deleteAllUnusedTags: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::TagsApi;

my $api_instance = WWW::SwaggerClient::TagsApi->new();

eval { 
    $api_instance->deleteAllUnusedTags();
};
if ($@) {
    warn "Exception when calling TagsApi->deleteAllUnusedTags: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.TagsApi()

try: 
    # Delete all unused tags
    api_instance.delete_all_unused_tags()
except ApiException as e:
    print("Exception when calling TagsApi->deleteAllUnusedTags: %s\n" % e)

Parameters

Responses

Status: 204 - Success


deleteDataProductTag

Delete a tag from a specific data product


/api/v1/dataProduct/tags/{tagId}/products/{dataProductId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: application/json,*/*"\
"//api/v1/dataProduct/tags/{tagId}/products/{dataProductId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.TagsApi;

import java.io.File;
import java.util.*;

public class TagsApiExample {

    public static void main(String[] args) {
        
        TagsApi apiInstance = new TagsApi();
        UUID tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            apiInstance.deleteDataProductTag(tagId, dataProductId);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#deleteDataProductTag");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.TagsApi;

public class TagsApiExample {

    public static void main(String[] args) {
        TagsApi apiInstance = new TagsApi();
        UUID tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            apiInstance.deleteDataProductTag(tagId, dataProductId);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#deleteDataProductTag");
            e.printStackTrace();
        }
    }
}
UUID *tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 

TagsApi *apiInstance = [[TagsApi alloc] init];

// Delete a tag from a specific data product
[apiInstance deleteDataProductTagWith:tagId
    dataProductId:dataProductId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.TagsApi()
var tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteDataProductTag(tagId, dataProductId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteDataProductTagExample
    {
        public void main()
        {

            var apiInstance = new TagsApi();
            var tagId = new UUID(); // UUID | 
            var dataProductId = new UUID(); // UUID | 

            try
            {
                // Delete a tag from a specific data product
                apiInstance.deleteDataProductTag(tagId, dataProductId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling TagsApi.deleteDataProductTag: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiTagsApi();
$tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 

try {
    $api_instance->deleteDataProductTag($tagId, $dataProductId);
} catch (Exception $e) {
    echo 'Exception when calling TagsApi->deleteDataProductTag: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::TagsApi;

my $api_instance = WWW::SwaggerClient::TagsApi->new();
my $tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 

eval { 
    $api_instance->deleteDataProductTag(tagId => $tagId, dataProductId => $dataProductId);
};
if ($@) {
    warn "Exception when calling TagsApi->deleteDataProductTag: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.TagsApi()
tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 

try: 
    # Delete a tag from a specific data product
    api_instance.delete_data_product_tag(tagId, dataProductId)
except ApiException as e:
    print("Exception when calling TagsApi->deleteDataProductTag: %s\n" % e)

Parameters

Path parameters
Name Description
tagId*
UUID (uuid)
Required
dataProductId*
UUID (uuid)
Required

Responses

Status: 200 - Success

Status: 403 - Forbidden

Status: 404 - Not found


deleteTag

Delete an unused tag with a specific identifier


/api/v1/dataProduct/tags/{tagId}

Usage and SDK Samples

curl -X DELETE\
-H "Accept: application/json,*/*"\
"//api/v1/dataProduct/tags/{tagId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.TagsApi;

import java.io.File;
import java.util.*;

public class TagsApiExample {

    public static void main(String[] args) {
        
        TagsApi apiInstance = new TagsApi();
        UUID tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            apiInstance.deleteTag(tagId);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#deleteTag");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.TagsApi;

public class TagsApiExample {

    public static void main(String[] args) {
        TagsApi apiInstance = new TagsApi();
        UUID tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            apiInstance.deleteTag(tagId);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#deleteTag");
            e.printStackTrace();
        }
    }
}
UUID *tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 

TagsApi *apiInstance = [[TagsApi alloc] init];

// Delete an unused tag with a specific identifier
[apiInstance deleteTagWith:tagId
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.TagsApi()
var tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteTag(tagId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteTagExample
    {
        public void main()
        {

            var apiInstance = new TagsApi();
            var tagId = new UUID(); // UUID | 

            try
            {
                // Delete an unused tag with a specific identifier
                apiInstance.deleteTag(tagId);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling TagsApi.deleteTag: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiTagsApi();
$tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 

try {
    $api_instance->deleteTag($tagId);
} catch (Exception $e) {
    echo 'Exception when calling TagsApi->deleteTag: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::TagsApi;

my $api_instance = WWW::SwaggerClient::TagsApi->new();
my $tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 

eval { 
    $api_instance->deleteTag(tagId => $tagId);
};
if ($@) {
    warn "Exception when calling TagsApi->deleteTag: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.TagsApi()
tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 

try: 
    # Delete an unused tag with a specific identifier
    api_instance.delete_tag(tagId)
except ApiException as e:
    print("Exception when calling TagsApi->deleteTag: %s\n" % e)

Parameters

Path parameters
Name Description
tagId*
UUID (uuid)
Required

Responses

Status: 204 - Success

Status: 403 - Forbidden

Status: 404 - Not found


getDataProductTags

List all tags associated with a specific data product


/api/v1/dataProduct/tags/products/{dataProductId}

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/dataProduct/tags/products/{dataProductId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.TagsApi;

import java.io.File;
import java.util.*;

public class TagsApiExample {

    public static void main(String[] args) {
        
        TagsApi apiInstance = new TagsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            array[DataProductTag] result = apiInstance.getDataProductTags(dataProductId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#getDataProductTags");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.TagsApi;

public class TagsApiExample {

    public static void main(String[] args) {
        TagsApi apiInstance = new TagsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            array[DataProductTag] result = apiInstance.getDataProductTags(dataProductId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#getDataProductTags");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 

TagsApi *apiInstance = [[TagsApi alloc] init];

// List all tags associated with a specific data product
[apiInstance getDataProductTagsWith:dataProductId
              completionHandler: ^(array[DataProductTag] output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.TagsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getDataProductTags(dataProductId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getDataProductTagsExample
    {
        public void main()
        {

            var apiInstance = new TagsApi();
            var dataProductId = new UUID(); // UUID | 

            try
            {
                // List all tags associated with a specific data product
                array[DataProductTag] result = apiInstance.getDataProductTags(dataProductId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling TagsApi.getDataProductTags: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiTagsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 

try {
    $result = $api_instance->getDataProductTags($dataProductId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling TagsApi->getDataProductTags: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::TagsApi;

my $api_instance = WWW::SwaggerClient::TagsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 

eval { 
    my $result = $api_instance->getDataProductTags(dataProductId => $dataProductId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling TagsApi->getDataProductTags: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.TagsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 

try: 
    # List all tags associated with a specific data product
    api_response = api_instance.get_data_product_tags(dataProductId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling TagsApi->getDataProductTags: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required

Responses

Status: 200 - Success

[
{

Detailed data for a data product tag

Required: id,value
id:
string (uuid)

Tag ID.

value:
string maxLength:255

Tag value.

}
]

Status: 403 - Forbidden

Status: 404 - Not found


listTags

List all available tags for all data products


/api/v1/dataProduct/tags

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/dataProduct/tags"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.TagsApi;

import java.io.File;
import java.util.*;

public class TagsApiExample {

    public static void main(String[] args) {
        
        TagsApi apiInstance = new TagsApi();
        try {
            array[DataProductTag] result = apiInstance.listTags();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#listTags");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.TagsApi;

public class TagsApiExample {

    public static void main(String[] args) {
        TagsApi apiInstance = new TagsApi();
        try {
            array[DataProductTag] result = apiInstance.listTags();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#listTags");
            e.printStackTrace();
        }
    }
}

TagsApi *apiInstance = [[TagsApi alloc] init];

// List all available tags for all data products
[apiInstance listTagsWithCompletionHandler: 
              ^(array[DataProductTag] output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.TagsApi()
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.listTags(callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class listTagsExample
    {
        public void main()
        {

            var apiInstance = new TagsApi();

            try
            {
                // List all available tags for all data products
                array[DataProductTag] result = apiInstance.listTags();
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling TagsApi.listTags: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiTagsApi();

try {
    $result = $api_instance->listTags();
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling TagsApi->listTags: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::TagsApi;

my $api_instance = WWW::SwaggerClient::TagsApi->new();

eval { 
    my $result = $api_instance->listTags();
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling TagsApi->listTags: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.TagsApi()

try: 
    # List all available tags for all data products
    api_response = api_instance.list_tags()
    pprint(api_response)
except ApiException as e:
    print("Exception when calling TagsApi->listTags: %s\n" % e)

Parameters

Responses

Status: 200 - Success

[
{

Detailed data for a data product tag

Required: id,value
id:
string (uuid)

Tag ID.

value:
string maxLength:255

Tag value.

}
]

updateDataProductTags

Replace all tags for a specific data product with the supplied list of new tags


/api/v1/dataProduct/tags/products/{dataProductId}

Usage and SDK Samples

curl -X PUT\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
"//api/v1/dataProduct/tags/products/{dataProductId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.TagsApi;

import java.io.File;
import java.util.*;

public class TagsApiExample {

    public static void main(String[] args) {
        
        TagsApi apiInstance = new TagsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        array[DataProductTagValue] body = ; // array[DataProductTagValue] | 
        try {
            array[DataProductTag] result = apiInstance.updateDataProductTags(dataProductId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#updateDataProductTags");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.TagsApi;

public class TagsApiExample {

    public static void main(String[] args) {
        TagsApi apiInstance = new TagsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        array[DataProductTagValue] body = ; // array[DataProductTagValue] | 
        try {
            array[DataProductTag] result = apiInstance.updateDataProductTags(dataProductId, body);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#updateDataProductTags");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
array[DataProductTagValue] *body = ; //  (optional)

TagsApi *apiInstance = [[TagsApi alloc] init];

// Replace all tags for a specific data product with the supplied list of new tags
[apiInstance updateDataProductTagsWith:dataProductId
    body:body
              completionHandler: ^(array[DataProductTag] output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.TagsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var opts = { 
  'body':  // {{array[DataProductTagValue]}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.updateDataProductTags(dataProductId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class updateDataProductTagsExample
    {
        public void main()
        {

            var apiInstance = new TagsApi();
            var dataProductId = new UUID(); // UUID | 
            var body = new array[DataProductTagValue](); // array[DataProductTagValue] |  (optional) 

            try
            {
                // Replace all tags for a specific data product with the supplied list of new tags
                array[DataProductTag] result = apiInstance.updateDataProductTags(dataProductId, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling TagsApi.updateDataProductTags: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiTagsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$body = ; // array[DataProductTagValue] | 

try {
    $result = $api_instance->updateDataProductTags($dataProductId, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling TagsApi->updateDataProductTags: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::TagsApi;

my $api_instance = WWW::SwaggerClient::TagsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $body = [WWW::SwaggerClient::Object::array[DataProductTagValue]->new()]; # array[DataProductTagValue] | 

eval { 
    my $result = $api_instance->updateDataProductTags(dataProductId => $dataProductId, body => $body);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling TagsApi->updateDataProductTags: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.TagsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
body =  # array[DataProductTagValue] |  (optional)

try: 
    # Replace all tags for a specific data product with the supplied list of new tags
    api_response = api_instance.update_data_product_tags(dataProductId, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling TagsApi->updateDataProductTags: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required
Body parameters
Name Description
body
[
{

Request object for changing a data product tag value

Required: value
value:
string maxLength:255

Tag value.

example: marketing
}
]

Responses

Status: 204 - Success

[
{

Detailed data for a data product tag

Required: id,value
id:
string (uuid)

Tag ID.

value:
string maxLength:255

Tag value.

}
]

Status: 400 - Bad Request

Status: 403 - Forbidden

Status: 404 - Not found


updateTag

Update a specific tag


/api/v1/dataProduct/tags/{tagId}

Usage and SDK Samples

curl -X PUT\
-H "Accept: application/json,*/*"\
-H "Content-Type: application/json"\
"//api/v1/dataProduct/tags/{tagId}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.TagsApi;

import java.io.File;
import java.util.*;

public class TagsApiExample {

    public static void main(String[] args) {
        
        TagsApi apiInstance = new TagsApi();
        UUID tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        DataProductTagValue body = ; // DataProductTagValue | 
        try {
            apiInstance.updateTag(tagId, body);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#updateTag");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.TagsApi;

public class TagsApiExample {

    public static void main(String[] args) {
        TagsApi apiInstance = new TagsApi();
        UUID tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        DataProductTagValue body = ; // DataProductTagValue | 
        try {
            apiInstance.updateTag(tagId, body);
        } catch (ApiException e) {
            System.err.println("Exception when calling TagsApi#updateTag");
            e.printStackTrace();
        }
    }
}
UUID *tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
DataProductTagValue *body = ; //  (optional)

TagsApi *apiInstance = [[TagsApi alloc] init];

// Update a specific tag
[apiInstance updateTagWith:tagId
    body:body
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.TagsApi()
var tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var opts = { 
  'body':  // {{DataProductTagValue}} 
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.updateTag(tagId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class updateTagExample
    {
        public void main()
        {

            var apiInstance = new TagsApi();
            var tagId = new UUID(); // UUID | 
            var body = new DataProductTagValue(); // DataProductTagValue |  (optional) 

            try
            {
                // Update a specific tag
                apiInstance.updateTag(tagId, body);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling TagsApi.updateTag: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiTagsApi();
$tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$body = ; // DataProductTagValue | 

try {
    $api_instance->updateTag($tagId, $body);
} catch (Exception $e) {
    echo 'Exception when calling TagsApi->updateTag: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::TagsApi;

my $api_instance = WWW::SwaggerClient::TagsApi->new();
my $tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $body = WWW::SwaggerClient::Object::DataProductTagValue->new(); # DataProductTagValue | 

eval { 
    $api_instance->updateTag(tagId => $tagId, body => $body);
};
if ($@) {
    warn "Exception when calling TagsApi->updateTag: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.TagsApi()
tagId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
body =  # DataProductTagValue |  (optional)

try: 
    # Update a specific tag
    api_instance.update_tag(tagId, body=body)
except ApiException as e:
    print("Exception when calling TagsApi->updateTag: %s\n" % e)

Parameters

Path parameters
Name Description
tagId*
UUID (uuid)
Required
Body parameters
Name Description
body
{

Request object for changing a data product tag value

Required: value
value:
string maxLength:255

Tag value.

example: marketing
}

Responses

Status: 204 - Success

Status: 400 - Bad Request

Status: 403 - Forbidden

Status: 404 - Not found


Workflows

deleteDataProduct

Initiate an asynchronous task to delete the data product.

This workflow attempts to delete the data product's schema and its views, or materialized views, from the underlying storage system. If the deletion succeeds the data product metadata is also deleted. This endpoint returns a success response if the async task is accepted by the server. Clients must poll the endpoint returned in the location header in order to follow the status of the async operation.


/api/v1/dataProduct/products/{dataProductId}/workflows/delete

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json,*/*"\
"//api/v1/dataProduct/products/{dataProductId}/workflows/delete?skipTrinoDelete="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.WorkflowsApi;

import java.io.File;
import java.util.*;

public class WorkflowsApiExample {

    public static void main(String[] args) {
        
        WorkflowsApi apiInstance = new WorkflowsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        Boolean skipTrinoDelete = true; // Boolean | If true, just delete from the data product DB, don't delete any tables or schemas from Trino
        try {
            apiInstance.deleteDataProduct(dataProductId, skipTrinoDelete);
        } catch (ApiException e) {
            System.err.println("Exception when calling WorkflowsApi#deleteDataProduct");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.WorkflowsApi;

public class WorkflowsApiExample {

    public static void main(String[] args) {
        WorkflowsApi apiInstance = new WorkflowsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        Boolean skipTrinoDelete = true; // Boolean | If true, just delete from the data product DB, don't delete any tables or schemas from Trino
        try {
            apiInstance.deleteDataProduct(dataProductId, skipTrinoDelete);
        } catch (ApiException e) {
            System.err.println("Exception when calling WorkflowsApi#deleteDataProduct");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
Boolean *skipTrinoDelete = true; // If true, just delete from the data product DB, don't delete any tables or schemas from Trino (optional)

WorkflowsApi *apiInstance = [[WorkflowsApi alloc] init];

// Initiate an asynchronous task to delete the data product.
[apiInstance deleteDataProductWith:dataProductId
    skipTrinoDelete:skipTrinoDelete
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.WorkflowsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var opts = { 
  'skipTrinoDelete': true // {{Boolean}} If true, just delete from the data product DB, don't delete any tables or schemas from Trino
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteDataProduct(dataProductId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class deleteDataProductExample
    {
        public void main()
        {

            var apiInstance = new WorkflowsApi();
            var dataProductId = new UUID(); // UUID | 
            var skipTrinoDelete = true;  // Boolean | If true, just delete from the data product DB, don't delete any tables or schemas from Trino (optional) 

            try
            {
                // Initiate an asynchronous task to delete the data product.
                apiInstance.deleteDataProduct(dataProductId, skipTrinoDelete);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling WorkflowsApi.deleteDataProduct: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiWorkflowsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$skipTrinoDelete = true; // Boolean | If true, just delete from the data product DB, don't delete any tables or schemas from Trino

try {
    $api_instance->deleteDataProduct($dataProductId, $skipTrinoDelete);
} catch (Exception $e) {
    echo 'Exception when calling WorkflowsApi->deleteDataProduct: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::WorkflowsApi;

my $api_instance = WWW::SwaggerClient::WorkflowsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $skipTrinoDelete = true; # Boolean | If true, just delete from the data product DB, don't delete any tables or schemas from Trino

eval { 
    $api_instance->deleteDataProduct(dataProductId => $dataProductId, skipTrinoDelete => $skipTrinoDelete);
};
if ($@) {
    warn "Exception when calling WorkflowsApi->deleteDataProduct: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.WorkflowsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
skipTrinoDelete = true # Boolean | If true, just delete from the data product DB, don't delete any tables or schemas from Trino (optional)

try: 
    # Initiate an asynchronous task to delete the data product.
    api_instance.delete_data_product(dataProductId, skipTrinoDelete=skipTrinoDelete)
except ApiException as e:
    print("Exception when calling WorkflowsApi->deleteDataProduct: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required
Query parameters
Name Description
skipTrinoDelete
Boolean
If true, just delete from the data product DB, don't delete any tables or schemas from Trino

Responses

Status: 202 - Accepted

Name Type Format Description
Location String URL The endpoint to poll in order to GET the status of the operation.

Status: 403 - Forbidden

Status: 404 - Not found


getDeleteDataProductStatus

Get the status of the async task to delete a data product.

Clients must poll this endpoint until the attribute isFinalStatus in the response body is true.


/api/v1/dataProduct/products/{dataProductId}/workflows/delete

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/dataProduct/products/{dataProductId}/workflows/delete"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.WorkflowsApi;

import java.io.File;
import java.util.*;

public class WorkflowsApiExample {

    public static void main(String[] args) {
        
        WorkflowsApi apiInstance = new WorkflowsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            DataProductWorkflowState result = apiInstance.getDeleteDataProductStatus(dataProductId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling WorkflowsApi#getDeleteDataProductStatus");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.WorkflowsApi;

public class WorkflowsApiExample {

    public static void main(String[] args) {
        WorkflowsApi apiInstance = new WorkflowsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            DataProductWorkflowState result = apiInstance.getDeleteDataProductStatus(dataProductId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling WorkflowsApi#getDeleteDataProductStatus");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 

WorkflowsApi *apiInstance = [[WorkflowsApi alloc] init];

// Get the status of the async task to delete a data product.
[apiInstance getDeleteDataProductStatusWith:dataProductId
              completionHandler: ^(DataProductWorkflowState output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.WorkflowsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getDeleteDataProductStatus(dataProductId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getDeleteDataProductStatusExample
    {
        public void main()
        {

            var apiInstance = new WorkflowsApi();
            var dataProductId = new UUID(); // UUID | 

            try
            {
                // Get the status of the async task to delete a data product.
                DataProductWorkflowState result = apiInstance.getDeleteDataProductStatus(dataProductId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling WorkflowsApi.getDeleteDataProductStatus: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiWorkflowsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 

try {
    $result = $api_instance->getDeleteDataProductStatus($dataProductId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling WorkflowsApi->getDeleteDataProductStatus: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::WorkflowsApi;

my $api_instance = WWW::SwaggerClient::WorkflowsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 

eval { 
    my $result = $api_instance->getDeleteDataProductStatus(dataProductId => $dataProductId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling WorkflowsApi->getDeleteDataProductStatus: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.WorkflowsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 

try: 
    # Get the status of the async task to delete a data product.
    api_response = api_instance.get_delete_data_product_status(dataProductId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling WorkflowsApi->getDeleteDataProductStatus: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required

Responses

Status: 200 - Success

{

State of a data product async workflow task execution

workflowType:
string

Type of the workflow being checked

Enum: DELETE, PUBLISH, REFRESH_MATERIALIZED_VIEW
status:
string

Current status of the workflow execution

Enum: SCHEDULED, IN_PROGRESS, COMPLETED, ERROR
errors:
[

List of errors, if any, related to the workflow execution

{

List of errors, if any, related to the workflow execution

entityType:
string

Entity type that produced the error

Enum: SCHEMA, DATASET, METADATA
entityName:
string

Name of the entity that produced the error

message:
string

Message with details about the error

}
]
isFinalStatus:
boolean

Whether the workflow task reached a final status or not

}
Name Type Format Description
Location String URL The endpoint to poll in order to GET the status of the operation

Status: 403 - Forbidden

Status: 404 - No delete tasks are being processed for the data product


getPublishDataProductStatus

Get the status of the async task that publishes a data product.

Clients must poll this endpoint until the attribute isFinalStatus in the response body is true.


/api/v1/dataProduct/products/{dataProductId}/workflows/publish

Usage and SDK Samples

curl -X GET\
-H "Accept: application/json"\
"//api/v1/dataProduct/products/{dataProductId}/workflows/publish"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.WorkflowsApi;

import java.io.File;
import java.util.*;

public class WorkflowsApiExample {

    public static void main(String[] args) {
        
        WorkflowsApi apiInstance = new WorkflowsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            DataProductWorkflowState result = apiInstance.getPublishDataProductStatus(dataProductId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling WorkflowsApi#getPublishDataProductStatus");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.WorkflowsApi;

public class WorkflowsApiExample {

    public static void main(String[] args) {
        WorkflowsApi apiInstance = new WorkflowsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        try {
            DataProductWorkflowState result = apiInstance.getPublishDataProductStatus(dataProductId);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling WorkflowsApi#getPublishDataProductStatus");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 

WorkflowsApi *apiInstance = [[WorkflowsApi alloc] init];

// Get the status of the async task that publishes a data product.
[apiInstance getPublishDataProductStatusWith:dataProductId
              completionHandler: ^(DataProductWorkflowState output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.WorkflowsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getPublishDataProductStatus(dataProductId, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class getPublishDataProductStatusExample
    {
        public void main()
        {

            var apiInstance = new WorkflowsApi();
            var dataProductId = new UUID(); // UUID | 

            try
            {
                // Get the status of the async task that publishes a data product.
                DataProductWorkflowState result = apiInstance.getPublishDataProductStatus(dataProductId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling WorkflowsApi.getPublishDataProductStatus: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiWorkflowsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 

try {
    $result = $api_instance->getPublishDataProductStatus($dataProductId);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling WorkflowsApi->getPublishDataProductStatus: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::WorkflowsApi;

my $api_instance = WWW::SwaggerClient::WorkflowsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 

eval { 
    my $result = $api_instance->getPublishDataProductStatus(dataProductId => $dataProductId);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling WorkflowsApi->getPublishDataProductStatus: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.WorkflowsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 

try: 
    # Get the status of the async task that publishes a data product.
    api_response = api_instance.get_publish_data_product_status(dataProductId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling WorkflowsApi->getPublishDataProductStatus: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required

Responses

Status: 200 - Success

{

State of a data product async workflow task execution

workflowType:
string

Type of the workflow being checked

Enum: DELETE, PUBLISH, REFRESH_MATERIALIZED_VIEW
status:
string

Current status of the workflow execution

Enum: SCHEDULED, IN_PROGRESS, COMPLETED, ERROR
errors:
[

List of errors, if any, related to the workflow execution

{

List of errors, if any, related to the workflow execution

entityType:
string

Entity type that produced the error

Enum: SCHEMA, DATASET, METADATA
entityName:
string

Name of the entity that produced the error

message:
string

Message with details about the error

}
]
isFinalStatus:
boolean

Whether the workflow task reached a final status or not

}
Name Type Format Description
Location String URL The endpoint to poll in order to GET the status of the operation. If task is finished, this will return endpoint for getting the data product.

Status: 403 - Forbidden

Status: 404 - No publish tasks are being processed for the data product


publishDataProduct

Publish the data product by initiating an asynchronous task to populate the views, or materialized views, in the schema.

The publish workflow creates the data product as a schema in the data product's catalog using the domain schema location if provided, or the catalog's default schema location. The datasets are created as views or materialized views in that schema, according to their types. If completed successfully, the data product status transitions to PUBLISHED. This endpoint returns a success response if the async task is accepted by the server. Clients must poll the endpoint returned in the location header in order to follow the status of the async operation.


/api/v1/dataProduct/products/{dataProductId}/workflows/publish

Usage and SDK Samples

curl -X POST\
-H "Accept: application/json,*/*"\
"//api/v1/dataProduct/products/{dataProductId}/workflows/publish?force="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.WorkflowsApi;

import java.io.File;
import java.util.*;

public class WorkflowsApiExample {

    public static void main(String[] args) {
        
        WorkflowsApi apiInstance = new WorkflowsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        Boolean force = true; // Boolean | If true the data product will be republished, even if it is already published, and all its datasets will be recreated
        try {
            apiInstance.publishDataProduct(dataProductId, force);
        } catch (ApiException e) {
            System.err.println("Exception when calling WorkflowsApi#publishDataProduct");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.WorkflowsApi;

public class WorkflowsApiExample {

    public static void main(String[] args) {
        WorkflowsApi apiInstance = new WorkflowsApi();
        UUID dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
        Boolean force = true; // Boolean | If true the data product will be republished, even if it is already published, and all its datasets will be recreated
        try {
            apiInstance.publishDataProduct(dataProductId, force);
        } catch (ApiException e) {
            System.err.println("Exception when calling WorkflowsApi#publishDataProduct");
            e.printStackTrace();
        }
    }
}
UUID *dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // 
Boolean *force = true; // If true the data product will be republished, even if it is already published, and all its datasets will be recreated (optional)

WorkflowsApi *apiInstance = [[WorkflowsApi alloc] init];

// Publish the data product by initiating an asynchronous task to populate the views, or materialized views, in the schema.
[apiInstance publishDataProductWith:dataProductId
    force:force
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StarburstEnterpriseApiDocumentation = require('starburst_enterprise_api_documentation');

var api = new StarburstEnterpriseApiDocumentation.WorkflowsApi()
var dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // {{UUID}} 
var opts = { 
  'force': true // {{Boolean}} If true the data product will be republished, even if it is already published, and all its datasets will be recreated
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.publishDataProduct(dataProductId, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class publishDataProductExample
    {
        public void main()
        {

            var apiInstance = new WorkflowsApi();
            var dataProductId = new UUID(); // UUID | 
            var force = true;  // Boolean | If true the data product will be republished, even if it is already published, and all its datasets will be recreated (optional) 

            try
            {
                // Publish the data product by initiating an asynchronous task to populate the views, or materialized views, in the schema.
                apiInstance.publishDataProduct(dataProductId, force);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling WorkflowsApi.publishDataProduct: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\ApiWorkflowsApi();
$dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // UUID | 
$force = true; // Boolean | If true the data product will be republished, even if it is already published, and all its datasets will be recreated

try {
    $api_instance->publishDataProduct($dataProductId, $force);
} catch (Exception $e) {
    echo 'Exception when calling WorkflowsApi->publishDataProduct: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::WorkflowsApi;

my $api_instance = WWW::SwaggerClient::WorkflowsApi->new();
my $dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; # UUID | 
my $force = true; # Boolean | If true the data product will be republished, even if it is already published, and all its datasets will be recreated

eval { 
    $api_instance->publishDataProduct(dataProductId => $dataProductId, force => $force);
};
if ($@) {
    warn "Exception when calling WorkflowsApi->publishDataProduct: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.WorkflowsApi()
dataProductId = 38400000-8cf0-11bd-b23e-10b96e4ef00d # UUID | 
force = true # Boolean | If true the data product will be republished, even if it is already published, and all its datasets will be recreated (optional)

try: 
    # Publish the data product by initiating an asynchronous task to populate the views, or materialized views, in the schema.
    api_instance.publish_data_product(dataProductId, force=force)
except ApiException as e:
    print("Exception when calling WorkflowsApi->publishDataProduct: %s\n" % e)

Parameters

Path parameters
Name Description
dataProductId*
UUID (uuid)
Required
Query parameters
Name Description
force
Boolean
If true the data product will be republished, even if it is already published, and all its datasets will be recreated

Responses

Status: 202 - Accepted

Name Type Format Description
Location String URL The endpoint to poll in order to GET the status of the operation.

Status: 403 - Forbidden

Status: 404 - Not found