udclient [global-args...] [global-flags...] <command> [args...]
udclient -weburl http://ucdserver.example.com:8080
-username admin
-password admin
getResources
udclient -weburl http://ucdserver.example.com:8080
-username admin
-password admin
getResources
-parent "/My Agents"
{
"description": "Description",
"enforceCompleteSnapshots": "Specify true to require
an explicit version for each component",
"name": "Application name or ID",
"notificationScheme": "Notification scheme"
}
udclient -weburl http://ucdserver.example.com:8080
-username admin
-password admin
createApplication
-t
{
"description": "My new application",
"enforceCompleteSnapshots": "false",
"name": "My Application",
"notificationScheme": "Default Notification Scheme"
}
To pass this JSON string, save the string to a file and
pass the file to the command. For example, if you save the string
to a file that is named newApplication.json,
the command looks like the following example:udclient -weburl http://ucdserver.example.com:8080
-username admin
-password admin
createApplication
newApplication.json
The following table lists the global parameters for the commands. These global parameters are listed as [global-args...] in code examples.
Argument | Description |
---|---|
-authtoken, --authtoken | Optional. Can be set with the DS_AUTH_TOKEN environment variable. An authentication token (authtoken) that is generated by the server. Either an authtoken or a user name and password are required. |
-password, --password | Optional. Can be set with the DS_PASSWORD environment variable. A password to authenticate with the server. Either an authtoken or a user name and password are required. |
-proxyHost, --proxyHost | Optional. Can be set with the proxyHost environment variable. The host name of a proxy (for example, an agent relay) to use instead of a direct connection to the server. |
-proxyPassword, --proxyPassword | Optional. Can be set with the proxyPassword environment variable. A password to use to authenticate with the proxy. |
-proxyPort, --proxyPort | Optional. Can be set with the proxyPort environment variable. The proxy port to use if a proxy host name is specified. |
-proxyUser, --proxyUser | Optional. Can be set with the proxyUser environment variable. A user name to use to authenticate with the proxy. |
-username, --username | Optional. Can be set with the DS_USERNAME environment variable. A user name to authenticate with the server. Either an authtoken or a user name and password are required. |
-weburl, --weburl | Required. Can be set with the DS_WEB_URL environment variable. The base URL of the IBM UrbanCode Deploy server. For example, http://ds.example.com:8585. |
The following table shows the global flags. These global flags are listed as [global-flags...] in code examples.
Flag | Description |
---|---|
-t, --getTemplate | Show the JSON template for the command instead of running the command. If a file argument is provided, the template is output to the specified file. |
-h, --help | Print the full description and help of the command instead of running the command. |
-v, --verbose | Print extra information. |
When you specify objects such as applications, components, agents, and resources on the command line, you can use the name of the object or the object ID. The ID of an object is part of the URL that is displayed when you inspect the object in IBM UrbanCode Deploy. For example, if you browse to a specific component and the URL is https://ucdeploy.example.com:8443/#component/2f153e93-00c3-44ef-a7fd-87e544e698d4, then the ID of the component is 2f153e93-00c3-44ef-a7fd-87e544e698d4.
udclient -weburl http://localhost:8080 -username admin -password admin getResources