Note

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

/alter/environment

URL: https://<aws.fqdn>/<aws.cluster.name>/gpudb-0/alter/environment

Alters an existing environment which can be referenced by a user-defined function (UDF).

Input Parameter Description

NameTypeDescription
environment_namestringName of the environment to be altered.
actionstring

Modification operation to be applied

Supported ValuesDescription
install_packageInstall a python package from PyPI, an external data source or KiFS
install_requirementsInstall packages from a requirements file
uninstall_packageUninstall a python package.
uninstall_requirementsUninstall packages from a requirements file
resetUninstalls all packages in the environment and resets it to the original state at time of creation
rebuildRecreates the environment and re-installs all packages, upgrades the packages if necessary based on dependencies
valuestringThe value of the modification, depending on input parameter action. For example, if input parameter action is install_package, this would be the python package name. If input parameter action is install_requirements, this would be the path of a requirements file from which to install packages. If an external data source is specified in datasource_name, this can be the path to a wheel file or source archive. Alternatively, if installing from a file (wheel or source archive), the value may be a reference to a file in KiFS.
optionsmap of string to strings

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

Supported Parameters (keys)Parameter Description
datasource_nameName of an existing external data source from which packages specified in input parameter value can be loaded

Output Parameter Description

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

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

This embedded JSON represents the result of the /alter/environment endpoint:

NameTypeDescription
environment_namestringValue of input parameter environment_name.
infomap of string to stringsAdditional information.

Empty string in case of an error.