Previous Topic: rename Method (app Object)Next Topic: lock Method (app Object)


config_boundary Method (app Object)

Note: This method has been deprecated and is included here for compatibility with existing user scripts. New users should use the config command with the option flag &boundary.

Description

Retrieve application boundary

Syntax
/api/v1/app/config_boundary?app=application&vdc=controller-name 
Arguments
app

Name of the application

vdc

Name of the target virtual data center

Transaction Type

synchronous

Request Type

GET

Examples

Retrieve boundary for application test.

GET http://192.168.123.200/api/v1/app/config_boundary?app=test&vdc=mygrid 
Sample Output
XML:
<boundary> 
   <name>main</name> 
   <property dns1> 
      <mandatory>1</mandatory> 
      <type>string</type> 
   </property dns1> 
   <property dns2> 
      <dflt></dflt> 
      <type>string</type> 
   </property dns2> 
   .
   . 
   . 
   <resource bw> 
      <dflt>1000K</dflt> 
      <max>2G</max> 
      <min>1000K</min> 
   </resource bw> 
   . 
   . 
</boundary>
JSON:
{ 
   "property dns1" : { 
      "type" : "string", 
      "mandatory" : 1 
   }, 
   "property hostname" : { 
      "type" : "string", 
      "mandatory" : 1 
   }, 
   . 
   . 
   . 
   "resource mem" : { 
      "min" : "128M", 
      "max" : "32G", 
      "dflt" : "256M" 
   }, 
   . 
   . 
} 
HTTP Error Codes
404

Entity vdc mygrid not found - A VDC name was specified that is not configured in the WS_API application.

400.4

Missing required arguments (app). - Argument app=app missing in the request.

404.1

Entity not found – Permission denied – application ‘test’ does not exist.

start Method (app Object)
Description

Start an application

Syntax
/api/v1/app/start?app=application&vdc=controller-name 
Arguments
app

Name of the application to be started

vdc

Name of the target virtual data center

Options

See Application Control in the Command Line Shell Reference for descriptions of the options available for this command.

Transaction Type

asynchronous

Request Type

GET

Examples

Start an application named test.

GET http://192.168.123.200/api/v1/app/start?app=test&vdc=mygrid 
Sample Output
XML:
<job>be805915-76b2-48c8-b8a0-b881cca66da6</job>
JSON:
{
   "job" : "be805915-76b2-48c8-b8a0-b881cca66da6"
} 
HTTP Error Codes
404

Entity vdc mygrid not found - A VDC name was specified that is not configured in the WS_API application.

400.4

Missing required arguments (app). - Argument app=app missing in the request.

Note: To get the status of job, issue a /api/v1/job/info? request with the job_id returned above as the argument. For more information about how to obtain the job status, refer to the job object.

stop Method (app Object)
Description

Stop an application

Syntax
/api/v1/app/stop?app=application&vdc=controller-name 
Arguments
app

Name of the application to be stopped

vdc

Name of the target virtual data center

Transaction Type

asynchronous

Request Type

GET

Examples

Stop an application named test.

GET http://192.168.123.200/api/v1/app/stop?app=test&vdc=mygrid 
Sample Output
XML:
<job>be805915-76b2-48c8-b8a0-b881cca66da6</job>
JSON:
{
   "job" : "be805915-76b2-48c8-b8a0-b881cca66da6"
} 
HTTP Error Codes
404

Entity vdc mygrid not found - A VDC name was specified that is not configured in the WS_API application.

400.4

Missing required arguments (app). - Argument app=app missing in the request.

Note: To get the status of job, issue a /api/v1/job/info? request with the job_id returned above as the argument. For more information about how to obtain the job status, refer to the job object.

stop_all Method (app Object)

Note: This method has been deprecated and is included here for compatibility with existing user scripts. New users should use the stop command with the option flag &all.

Description

Stop all applications

Syntax
/api/v1/app/stop_all?vdc=controller-name 
Arguments
vdc

Name of the target virtual data center

Transaction Type

asynchronous

Request Type

GET

Examples

Stop all applications.

GET http://192.168.123.200/api/v1/app/stop_all?vdc=mygrid 
Sample Output
XML:
<job>be805915-76b2-48c8-b8a0-b881cca66da6</job>
JSON:
{
   "job" : "be805915-76b2-48c8-b8a0-b881cca66da6"
} 
HTTP Error Codes
404

Entity vdc mygrid not found - A VDC name was specified that is not configured in the WS_API application.

Note: To get the status of job, issue a /api/v1/job/info? request with the job_id returned above as the argument. For more information about how to obtain the job status, refer to the job object.

copy Method (app Object)
Description

Copy an application

Syntax
/api/v1/app/copy?app=application&new_name=new-application&vdc=controller-name 
Arguments
app

Name of the application to be copied

new_name

Name of the new application

vdc

Name of the target virtual data center

Transaction Type

asynchronous

Request Type

GET

Examples

Copy an application named test to test2.

GET http://192.168.123.200/api/v1/app/copy?app=test&new_name=test2&vdc=mygrid 
Sample Output
XML:
<job>be805915-76b2-48c8-b8a0-b881cca66da6</job>
JSON:
{
   "job" : "be805915-76b2-48c8-b8a0-b881cca66da6"
} 
HTTP Error Codes
404

Entity vdc mygrid not found - A VDC name was specified that is not configured in the WS_API application.

400.4

Missing required arguments (app). - Argument app=app missing in the request.

400.4

Missing required arguments (new_name). - Argument new=new-name missing in the request.

Note: To get the status of job, issue a /api/v1/job/info? request with the job_id returned above as the argument. For more information about how to obtain the job status, refer to the job object.

restart Method (app Object)
Description

Restart an application

Syntax
/api/v1/app/restart?app=application&vdc=controller-name 
Arguments
app

Name of the application to be restarted

vdc

Name of the target virtual data center

Transaction Type

asynchronous

Request Type

GET

Examples

Restart an application named test.

GET http://192.168.123.200/api/v1/app/restart?app=test&vdc=mygrid 
Sample Output
XML:
<job>be805915-76b2-48c8-b8a0-b881cca66da6</job>
JSON:
{
   "job" : "be805915-76b2-48c8-b8a0-b881cca66da6"
} 
HTTP Error Codes
404

Entity vdc mygrid not found - A VDC name was specified that is not configured in the WS_API application.

400.4

Missing required arguments (app). - Argument app=app missing in the request.

Note: To get the status of job, issue a /api/v1/job/info? request with the job_id returned above as the argument. For more information about how to obtain the job status, refer to the job object.

migrate Method (app Object)
Description

Migrate an application from a remote grid

Syntax
/api/v1/app/migrate?grid=remote-grid&app=application&vdc=controller-name 
Arguments
grid

Controller IP or FQDN of a remote grid

app

Name of the application to be migrated

vdc

Name of the target virtual data center

Options

See Application Control in the Command Line Shell Reference for descriptions of the options available for this command.

Note: The migrate method does not support SSH agent forwarding.

Transaction Type

asynchronous

Request Type

GET

Examples

Migrate an application named test from remote-grid.mygrid.net.

GET http://192.168.123.200/api/v1/app/migrate?grid=remote-grid.mygrid.net&app=test&vdc=mygrid 
Sample Output
XML:
<job>be805915-76b2-48c8-b8a0-b881cca66da6</job>
JSON:
{
   "job" : "be805915-76b2-48c8-b8a0-b881cca66da6"
} 
HTTP Error Codes
404

Entity vdc mygrid not found - A VDC name was specified that is not configured in the WS_API application.

400.4

Missing required arguments (app). - Argument app=app missing in the request.

400.4

Missing required arguments (grid). - Argument grid=remote-grid missing in the request.

Note: To get the status of job, issue a /api/v1/job/info? request with the job_id returned above as the argument. For more information about how to obtain the job status, refer to the job object.