Integration Guides › Web Service API Reference Guide › Valid Web API Objects › template Object › lock Method (template Object)

lock Method (template Object)

Description

Lock an application template

Syntax

/api/v1/template/lock?template=template&pwd=password&vdc=controller-name 

Arguments

template

Name of the application template

pwd

Password

vdc

Name of the target virtual data center

Transaction Type

synchronous

Request Type

GET

Examples

Lock application template VDS_CentOS51_r15.

GET http://192.168.123.200/api/v1/template/lock?template=VDS_CentOS51_r15&pwd=password&vdc=mygrid 

Sample Output

XML:

<opt></opt>

JSON:

{} 

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 (template). - Argument template=template missing in the request.

400.4

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

403.1

Permission Denied for ‘lock’ access on object ‘application’ with name ‘VDS_CentOS55_r5’.

404.1

Entity not found – Permission Denied – application VDS_CentOS_r1 does not exist.

Note: The password that is used to lock a template application is required to unlock the application. When a template application is locked, no volumes belonging to the application may be managed and the application may not be modified in any way.