beautypg.com

Ezcommand response codes, Ezcommand example, Ezcommand reference – Google Message Security Batch Reference Guide User Manual

Page 23: Ezcommand response codes ezcommand example

background image

24

EZCommand Response Codes

The HTTP response will contain a two-part return value: <

status

> <

message

>

status: 1 for success or 0 for failure

message: contains additional details

EZCommand Example

For example, to add the user, [email protected] using the privileged
account [email protected], at host name ac-s8.postini.com.

Submit:

https://ac-s8 .postini.com/exec/

remotecmd?auth=3X2dLdwfb9BLKtmr%2F5f4hOn82rsRLWGadministrator%40ju

mboinc.com&cmd=adduser%20agoodman%40jumboinc.com

Upon successful completion, the following response would be returned:

1 Created new user [email protected] in organization Jumbo Org 1

WARNING:

Do not use

ac-s8.postini.com

unless that is your appropriate host

name, as described in the “Calling EZCommand” section above. For example,
your host name may be

ac-s5.postini.com

. Using the wrong hostname will

guarantee your EZCommand processing will fail.

EZCommand Reference

For detailed information on the commands and fields discussed below, go to each
EZCommand-enabled command and field reference page in this Guide, or, online,
log in to the Administration Console. Go to the Orgs & Users > Batch, and review
the Batch Command and User fields pages in The Message Security Batch
Reference Guide
linked on that page.

This interface is applicable to the Google Message Security, Google Message
Discovery, and Google Message Filtering products only.

Note:

All EZCommand-enabled commands must be URL-escaped in order to be

properly submitted. For example, URL-escaping the command:

adduser [email protected]

changes it to:

adduser%20agoodman%40jumboinc.com

Since EZCommand is an HTTP interface, all non-alphanumeric characters
appearing in the command must be URL-escaped or the system will not recognize
them. An example of the full URL string: