Download DLC client and configure authentication to manage data and jobs in Platform for AI (PAI).
Usage notes
If a certificate error occurs, run sudo apt-get update && sudo apt-get install ca-certificates to resolve it.
Download DLC client
Download DLC client for your operating system:
No installation required. Grant execute permission by running chmod +x dlc.
Auto-completion
-
Feature description
DLC auto-completion works like kubectl and Arena commands. Type partial commands or arguments, then press Tab twice to complete them.
-
Syntax
./dlc completion <shelltype> -
Parameter description
<shelltype> specifies command type for auto-completion. Valid values: bash, fish, powershell, and zsh.
-
Examples
Enable auto-completion for bash commands:
-
Install bash-completion package if not already installed, then enable it with
sourcecommand. Skip this step if bash-completion is installed.# Run the following command to install the bash-completion package in macOS: brew install bash-completion && source /usr/local/etc/bash_completion # Run the following command to install the bash-completion package in Linux: yum install bash-completion && source /etc/profile.d/bash_completion.sh -
Enable auto-completion feature. Auto-completion depends on bash-completion package. If an error occurs during execution, install bash-completion first.
source <(./dlc completion bash) -
Enter
./dlcand press Tab twice to view available DLC commands../dlcAvailable DLC commands:
completion config create delete get help logs stop submit
NoteFor auto-completion instructions on other shell types, run
dlc completion <zsh | fish | powershell> --help. -
Identity authentication
-
Feature description
First-time DLC client usage requires authentication using your Alibaba Cloud AccessKey pair. After initial authentication, subsequent client sessions run without re-authentication.
-
Syntax
./dlc config --protocol https --access_id <yourAccessKeyID> --access_key <yourAccessKeySecret> [--endpoint <yourEndpoint>] [--region <yourRegion>] -
Parameter description
Parameter
Required
Description
Type
<yourAccessKeyId>
Yes
AccessKey ID of your Alibaba Cloud account.
STRING
<yourAccessKeySecret>
Yes
AccessKey secret of your Alibaba Cloud account.
STRING
<yourEndpoint>
Yes
Endpoint of the region where DLC service resides. Example: pai-dlc.cn-shanghai.aliyuncs.com.
STRING
<yourRegion>
Yes
Region where DLC service resides. For example, China (Shanghai) is cn-shanghai.
STRING
-
Examples
After completing authentication, system saves configuration to .dlc/config file in current directory by default. Example authentication command:
./dlc config --protocol https \ --access_id <AccessKeyId> \ --access_key <AccessKeySecret> \ --endpoint 'pai-dlc.cn-shanghai.aliyuncs.com' \ --region cn-shanghaiExpected output:
[OK] Configuration saved to: ~/.dlc/config
References
-
After completing authentication, refer to supported commands list for available operations. For more information, see Command list.
-
DLC jobs can also be submitted in PAI console. For more information, see Submit jobs by using the console.