Difference between revisions of "AppSuite:Resource management"

 
Line 15: Line 15:
 
|-
 
|-
 
|    --nonl
 
|    --nonl
|Remove all newlines (\n) from output
+
|Removes all newlines (\n) from output
 +
|-
 +
| --responsetimeout <integer>
 +
|response timeout in seconds for reading response from the backend (default 0s; infinite) '''Available with v7.8.0'''
 
|-
 
|-
 
| -c, --contextid <string>
 
| -c, --contextid <string>
Line 88: Line 91:
 
|-
 
|-
 
|    --nonl
 
|    --nonl
|Remove all newlines (\n) from output
+
|Removes all newlines (\n) from output
 +
|-
 +
| --responsetimeout <integer>
 +
|response timeout in seconds for reading response from the backend (default 0s; infinite) '''Available with v7.8.0'''
 
|-
 
|-
 
| -c, --contextid <integer>
 
| -c, --contextid <integer>
Line 152: Line 158:
 
|-
 
|-
 
|    --nonl
 
|    --nonl
|Remove all newlines (\n) from output
+
|Removes all newlines (\n) from output
 +
|-
 +
| --responsetimeout <integer>
 +
|response timeout in seconds for reading response from the backend (default 0s; infinite) '''Available with v7.8.0'''
 
|-
 
|-
 
| -c, --contextid <integer>
 
| -c, --contextid <integer>
Line 247: Line 256:
 
|-
 
|-
 
|    --nonl
 
|    --nonl
|Remove all newlines (\n) from output
+
|Removes all newlines (\n) from output
 +
|-
 +
| --responsetimeout <integer>
 +
|response timeout in seconds for reading response from the backend (default 0s; infinite) '''Available with v7.8.0'''
 
|-
 
|-
 
| -c, --contextid <integer>
 
| -c, --contextid <integer>

Latest revision as of 13:49, 23 April 2015

createresource

The createresource tool allows to create a new resource within a given context.

Parameters

-h, --help Prints a help text
--environment Show info about commandline environment
--nonl Removes all newlines (\n) from output
--responsetimeout <integer> response timeout in seconds for reading response from the backend (default 0s; infinite) Available with v7.8.0
-c, --contextid <string> The id of the context
-n, --name <string> The resource name
-d, --displayname <string> The resource display name
-a, --available <true/false> Toggle resource availability
-D, --description <string> Description of this resource
-e, --email <string> E-Mail of this resource

Extra parameters when authentication is enabled

-A, --adminuser <string> Context Admin user name
-P, --adminpass <string> Context Admin password

Return value

0 on success

>0 on failure

Mandatory parameters

contextid {adminuser adminpass} name displayname email

Command output

On success:

resource <resourceid> in context <contextid> created

On failure:

resource in context <contextid> could not be created: <reason from server>

Example

root@oxhe~# /opt/open-xchange/sbin/createresource -c 123 -n "laptop" -d "Super laptop" -D "laptop for rent" -e "laptop@example.com"

resource 6 in context 123 created

deleteresource

The deleteresource tool allows to delete a resource within a given context.

Parameters

-h, --help Prints a help text
--environment Show info about commandline environment
--nonl Removes all newlines (\n) from output
--responsetimeout <integer> response timeout in seconds for reading response from the backend (default 0s; infinite) Available with v7.8.0
-c, --contextid <integer> The id of the context
-i, --resourceid <integer> Id of this resource
-n, --name <string> The resource name

Extra parameters when authentication is enabled

-A, --adminuser <string> Context Admin user name
-P, --adminpass <string> Context Admin password

Return value

0 on success

>0 on failure

Mandatory parameters

contextid {adminuser adminpass} (name or resourceid)

Command output

On success:

resource <resourceid> in context <contextid> deleted

On failure:

resource <resourceid> in context <contextid> could not be deleted: <reason from server>

Example

root@oxhe~# /opt/open-xchange/sbin/deleteresource -c 123 -i 6

resource 6 in context 123 deleted

listresource

The listresource tool allows to list and search for resources within a given context.

Parameters

-h, --help Prints a help text
--environment Show info about commandline environment
--nonl Removes all newlines (\n) from output
--responsetimeout <integer> response timeout in seconds for reading response from the backend (default 0s; infinite) Available with v7.8.0
-c, --contextid <integer> The id of the context
--csv Format output as csv
-s, --searchpattern <string> The search pattern which is used for listing

Extra parameters when authentication is enabled

-A, --adminuser <string> Context Admin user name
-P, --adminpass <string> Context Admin password

Return value

0 on success

>0 on failure

Mandatory parameters

contextid {adminuser adminpass}

Command output

Standard output:

id name displayname description email available
6 laptop "Super Laptop" "laptop for rent" laptop@example.com true

csv output:

id, name, displayname, email, available

Example

root@oxhe~# /opt/open-xchange/sbin/listresource -c 123

id name displayname description email available
6 laptop "Super Laptop" "laptop for rent" laptop@example.com true

changeresource

The changeresource tool allows to change a resource within a given context.

Parameters

-h, --help Prints a help text
--environment Show info about commandline environment
--nonl Removes all newlines (\n) from output
--responsetimeout <integer> response timeout in seconds for reading response from the backend (default 0s; infinite) Available with v7.8.0
-c, --contextid <integer> The id of the context
-i, --resourceid <integer> Id of this resource
-n, --name <string> The resource name
-d, --displayname <string> The resource display name
-a, --available <true/false> Toggle resource availability
-D, --description <string> Description of this resource
-e, --email <string> Email of this resource

Extra parameters when authentication is enabled

-A, --adminuser <string> Context Admin user name
-P, --adminpass <string> Context Admin password

Return value

0 on success

>0 on failure

Mandatory parameters

contextid {adminuser adminpass} (resourceid or name ) and at least one attribute to change

Command output

On success:

resource <resourceid> in context <contextid> changed

On failure:

resource <resourceid> in context <contextid> could not be changed: <reason from server>

Example

root@oxhe~# /opt/open-xchange/sbin/changeresource -c 123 -i 6 -D "old Laptop"

resource 6 in context 123 changed