cm_client.MgmtRolesResourceApi

All URIs are relative to https://localhost/api/v54

Method	HTTP request	Description
create_roles	POST /cm/service/roles	Create new roles in the Cloudera Management Services.
delete_role	DELETE /cm/service/roles/{roleName}	Delete a role from the Cloudera Management Services.
enter_maintenance_mode	POST /cm/service/roles/{roleName}/commands/enterMaintenanceMode	Put the Cloudera Management Service role into maintenance mode.
exit_maintenance_mode	POST /cm/service/roles/{roleName}/commands/exitMaintenanceMode	Take the Cloudera Management Service role out of maintenance mode.
get_full_log	GET /cm/service/roles/{roleName}/logs/full	Retrieves the log file for the role's main process.
get_stacks_log	GET /cm/service/roles/{roleName}/logs/stacks	Retrieves the stacks log file, if any, for the role's main process.
get_stacks_logs_bundle	GET /cm/service/roles/{roleName}/logs/stacksBundle	Download a zip-compressed archive of role stacks logs.
get_standard_error	GET /cm/service/roles/{roleName}/logs/stderr	Retrieves the role's standard error output.
get_standard_output	GET /cm/service/roles/{roleName}/logs/stdout	Retrieves the role's standard output.
list_active_commands	GET /cm/service/roles/{roleName}/commands	List active role commands.
read_role	GET /cm/service/roles/{roleName}	Retrieve detailed information about a Cloudera Management Services role.
read_role_config	GET /cm/service/roles/{roleName}/config	Retrieve the configuration of a specific Cloudera Management Services role.
read_roles	GET /cm/service/roles	List all roles of the Cloudera Management Services.
update_role_config	PUT /cm/service/roles/{roleName}/config	Update the configuration of a Cloudera Management Services role.

create_roles

ApiRoleList create_roles(body=body)

Create new roles in the Cloudera Management Services.

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
body = cm_client.ApiRoleList() # ApiRoleList | Roles to create. (optional)

try:
    # Create new roles in the Cloudera Management Services.
    api_response = api_instance.create_roles(body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->create_roles: %s\n" % e)

Parameters

Name	Type	Description	Notes
body	ApiRoleList	Roles to create.	[optional]

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

delete_role

ApiRole delete_role(role_name)

Delete a role from the Cloudera Management Services.

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role name.

try:
    # Delete a role from the Cloudera Management Services.
    api_response = api_instance.delete_role(role_name)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->delete_role: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role name.

HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

enter_maintenance_mode

ApiCommand enter_maintenance_mode(role_name)

Put the Cloudera Management Service role into maintenance mode.

Put the Cloudera Management Service role into maintenance mode.This is a synchronous command. The result is known immediately upon return.

Available since API v18.

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role name.

try:
    # Put the Cloudera Management Service role into maintenance mode.
    api_response = api_instance.enter_maintenance_mode(role_name)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->enter_maintenance_mode: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role name.

HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

exit_maintenance_mode

ApiCommand exit_maintenance_mode(role_name)

Take the Cloudera Management Service role out of maintenance mode.

Take the Cloudera Management Service role out of maintenance mode. This is a synchronous command. The result is known immediately upon return.

Available since API v18.

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role name.

try:
    # Take the Cloudera Management Service role out of maintenance mode.
    api_response = api_instance.exit_maintenance_mode(role_name)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->exit_maintenance_mode: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role name.

HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_full_log

str get_full_log(role_name)

Retrieves the log file for the role's main process.

If the role is not started, this will be the log file associated with the last time the role was run.

Log files are returned as plain text (type "text/plain").

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role to fetch logs from.

try:
    # Retrieves the log file for the role's main process.
    api_response = api_instance.get_full_log(role_name)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->get_full_log: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role to fetch logs from.

HTTP request headers

Content-Type: Not defined
Accept: text/plain

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_stacks_log

str get_stacks_log(role_name)

Retrieves the stacks log file, if any, for the role's main process.

Retrieves the stacks log file, if any, for the role's main process. Note that not all roles support periodic stacks collection. The log files are returned as plain text (type "text/plain").

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role to fetch stacks logs from.

try:
    # Retrieves the stacks log file, if any, for the role's main process.
    api_response = api_instance.get_stacks_log(role_name)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->get_stacks_log: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role to fetch stacks logs from.

HTTP request headers

Content-Type: Not defined
Accept: text/plain

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_stacks_logs_bundle

file get_stacks_logs_bundle(role_name)

Download a zip-compressed archive of role stacks logs.

Download a zip-compressed archive of role stacks logs. Note that not all roles support periodic stacks collection.

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role to fetch the stacks logs bundle from.

try:
    # Download a zip-compressed archive of role stacks logs.
    api_response = api_instance.get_stacks_logs_bundle(role_name)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->get_stacks_logs_bundle: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role to fetch the stacks logs bundle from.

HTTP request headers

Content-Type: Not defined
Accept: application/octet-stream

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_standard_error

str get_standard_error(role_name)

Retrieves the role's standard error output.

If the role is not started, this will be the output associated with the last time the role was run.

Log files are returned as plain text (type "text/plain").

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role to fetch stderr from.

try:
    # Retrieves the role's standard error output.
    api_response = api_instance.get_standard_error(role_name)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->get_standard_error: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role to fetch stderr from.

HTTP request headers

Content-Type: Not defined
Accept: text/plain

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_standard_output

str get_standard_output(role_name)

Retrieves the role's standard output.

If the role is not started, this will be the output associated with the last time the role was run.

Log files are returned as plain text (type "text/plain").

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role to fetch stdout from.

try:
    # Retrieves the role's standard output.
    api_response = api_instance.get_standard_output(role_name)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->get_standard_output: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role to fetch stdout from.

HTTP request headers

Content-Type: Not defined
Accept: text/plain

[Back to top] [Back to API list] [Back to Model list] [Back to README]

list_active_commands

ApiCommandList list_active_commands(role_name, view=view)

List active role commands.

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role name.
view = 'summary' # str | The view of the data to materialize, either \"summary\" or \"full\". (optional) (default to summary)

try:
    # List active role commands.
    api_response = api_instance.list_active_commands(role_name, view=view)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->list_active_commands: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role name.
view	str	The view of the data to materialize, either "summary" or "full".	[optional] [default to summary]

HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

read_role

ApiRole read_role(role_name)

Retrieve detailed information about a Cloudera Management Services role.

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role name.

try:
    # Retrieve detailed information about a Cloudera Management Services role.
    api_response = api_instance.read_role(role_name)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->read_role: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role name.

HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

read_role_config

ApiConfigList read_role_config(role_name, view=view)

Retrieve the configuration of a specific Cloudera Management Services role.

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role to look up.
view = 'summary' # str | The view of the data to materialize, either \"summary\" or \"full\". (optional) (default to summary)

try:
    # Retrieve the configuration of a specific Cloudera Management Services role.
    api_response = api_instance.read_role_config(role_name, view=view)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->read_role_config: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role to look up.
view	str	The view of the data to materialize, either "summary" or "full".	[optional] [default to summary]

HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

read_roles

ApiRoleList read_roles()

List all roles of the Cloudera Management Services.

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))

try:
    # List all roles of the Cloudera Management Services.
    api_response = api_instance.read_roles()
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->read_roles: %s\n" % e)

Parameters

This endpoint does not need any parameter.

HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

update_role_config

ApiConfigList update_role_config(role_name, message=message, body=body)

Update the configuration of a Cloudera Management Services role.

If a value is set in the given configuration, it will be added to the role's configuration, replacing any existing entries. If a value is unset (its value is null), the existing configuration for the attribute will be erased, if any.

Attributes that are not listed in the input will maintain their current values in the configuration.

Example

from __future__ import print_function
import time
import cm_client
from cm_client.rest import ApiException
from pprint import pprint

# Configure HTTP basic authorization: basic
configuration = cm_client.Configuration()
configuration.username = 'YOUR_USERNAME'
configuration.password = 'YOUR_PASSWORD'

# create an instance of the API class
api_instance = cm_client.MgmtRolesResourceApi(cm_client.ApiClient(configuration))
role_name = 'role_name_example' # str | The role to modify.
message = 'message_example' # str | Optional message describing the changes. (optional)
body = cm_client.ApiConfigList() # ApiConfigList | Configuration changes. (optional)

try:
    # Update the configuration of a Cloudera Management Services role.
    api_response = api_instance.update_role_config(role_name, message=message, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling MgmtRolesResourceApi->update_role_config: %s\n" % e)

Parameters

Name	Type	Description	Notes
role_name	str	The role to modify.
message	str	Optional message describing the changes.	[optional]
body	ApiConfigList	Configuration changes.	[optional]

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]