You can view logical templates mapped to a cloud template. You can also use the APIs to manage these logical templates in the existing logical template list.

Retrieves a paginated list of logical template versions from Application Services.

All of the Application Services roles can access this API.

GET

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version?page=Page&page-size=PageSize

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version?page=0&page-size=1
{
  "errors": false,
  "messageList": [],
  "count": 16,
  "results": [
    {
      "id": "306",
      "lockVersion": 1,
      "name": "CentOS 32bit with MySQL",
      "description": "CentOS 6.3 32bit with MySQL Server 5.0",
      "lastUpdated": 1322020758327,
      "lastUpdateUser": "SYSTEM",
      "created": 1322020758327,
      "createUser": "SYSTEM",
      "version": {
        "major": "1",
        "minor": "0",
        "micro": "0",
        "qualifier": ""
      },	
      "osVersionRef": {
        "uri": "/darwin/api/2.0/operating-system-version/115",
        "id": "115",
        "name": "CentOS32 v6.3.0"
      },
      "tags": [
        {
          "id": "9",
          "lockVersion": 1,
          "name": "Database Servers",
          "description": "Database servers",
          "lastUpdated": 1378763302507,
          "lastUpdateUser": "SYSTEM",
          "created": 1378763302507,
          "createUser": "SYSTEM",
          "type": "Server Type"
        },
        {
          "id": "20",
          "lockVersion": 1,
          "name": "OS Templates",
          "description": "OS Templates",
          "lastUpdated": 1378763302509,
          "lastUpdateUser": "SYSTEM",
          "created": 1378763302509,
          "createUser": "SYSTEM",
          "type": "Server Type"
        }
      ],
      "serviceVersions": [
        {
          "id": "215",
          "lockVersion": 1,
          "name": "Preinstalled MySQL Server for CentOS",
          "description": "MySQL Server 5.0 preinstalled in CentOS 6.3 32bit",
          "version": {
            "major": "5",
            "minor": "0",
            "micro": "0",
            "qualifier": ""
          },
          "properties": [],
          "scripts": [
            {
              "id": "50",
              "lockVersion": 1,
              "lifecycleStage": "CONFIGURE",
              "scriptType": "Bash Script",
              "script": "#!/bin/bash\n […] ",
              "rebootAfter": false
            }
          ],
          "groupMembership": {
            "id": "413",
            "lockVersion": 1,
            "ownerGroupRef": {
              "uri": null,
              "id": "1",
              "name": "Default"
            }
          }
        }
      ],
      "groupMembership": {
        "id": "306",
        "lockVersion": 1,
        "ownerGroupRef": {
          "uri": null,
          "id": "1",
          "name": "Default"
        }
      }
    }
  ]
}

Retrieves a list of cloud templates mapped to a logical template in Application Services when you specify the cloud provider identification.

All of the Application Services roles can access this API.

GET

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/LogicalTemplateVersionID/mapped-physical-template/cloud-provider/CloudProviderID

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/313/mapped-physical-template/cloud-provider/1
{
  "errors": false,
  "messageList": [],
  "count": 1,
  "results": [
    {
      "id": "2",
      "lockVersion": 1,
      "name": "w2k8r2sp1_changesid_v5",
      "description": "Windows 2008 R2 Enterprise SP1 with ChangeSID enabled, bootstrap 5.0 and JRE 1.6.0_31.",
      "lastUpdated": 1378765277632,
      "lastUpdateUser": "admin",
      "created": 1378765277630,
      "createUser": "admin",
      "cloudTemplateExtref": {
        "id": "https://192.0.2.255/api/vAppTemplate/vappTemplate-f57b63cd-20c0-4158-836f-13f7d9c39206",
        "name": "w2k8r2sp1_changesid_v5"
      },
      "cloudProviderRef": {
        "uri": "/darwin/api/2.0/cloud-provider/1",
        "id": "1",
        "name": "Cloud"
      },
      "osName": "windows7Server64Guest",
      "properties": []
    }
  ]
}

Retrieves the specific logical template version based on the logical template version identification.

All of the Application Services roles can access this API.

GET

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/LogicalTemplateVersionID

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/313
{
  "errors": false,
  "messageList": [],
  "result": {
    "id": "313",
    "lockVersion": 2,
    "name": "W2K8 R2 Enterprise SP1",
    "description": "Windows Server 2008 R2 Enterprise SP1 VM",
    "lastUpdated": 1378765310743,
    "lastUpdateUser": "admin",
    "created": 1331830800000,
    "createUser": "SYSTEM",
    "version": {
      "major": "1",
      "minor": "0",
      "micro": "0",
      "qualifier": ""
    },
    "osVersionRef": {
      "uri": "/darwin/api/2.0/operating-system-version/111",
      "id": "111",
      "name": "WIN64 v6.1.7601"
    },
    "tags": [
      {
        "id": "20",
        "lockVersion": 1,
        "name": "OS Templates",
        "description": "OS Templates",
        "lastUpdated": 1378763302509,
        "lastUpdateUser": "SYSTEM",
        "created": 1378763302509,
        "createUser": "SYSTEM",
        "type": "Server Type"
      }
    ],
    "serviceVersions": [],
    "groupMembership": {
      "id": "313",
      "lockVersion": 1,
      "ownerGroupRef": {
        "uri": null,
        "id": "1",
        "name": "Default"
      }
    }
  }
}

Creates a logical template version.

The application catalog administrator can access this API.

POST

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version
{
    "id": "0",
    "lockVersion": 0,
    "name": "CentOS 32bit with MySQL 2",
    "description": "CentOS 6.3 32bit with MySQL Server 5.0",
    "version": {
        "major": "1",
        "minor": "0",
        "micro": "0",
        "qualifier": ""
    },
    "osVersionRef": {
        "id": "115",
        "name": "CentOS32 v6.3.0"
    },
    "tags": [
        {
            "id": "9",
            "name": "Database Servers",
            "description": "Database servers",
            "type": "Server Type"
        },
        {
            "id": "20",
            "name": "OS Templates",
            "description": "OS Templates",
            "type": "Server Type"
        }
    ],
    "serviceVersions": [],
    "groupMembership": {
        "id": "",
        "lockVersion": 0,
        "ownerGroupRef": {
            "uri": null,
            "id": "4",
            "name": "Development"
        },
        "global": false
    }
}
{
  "errors": false,
  "messageList": [
    {
      "messageType": "INFO",
      "message": "Logical VM template version saved successfully.",
      "messageKey": "vmTemplateVersion.save.msg",
      "property": null
    }
  ],
  "result": {
    "id": "60088",
    "lockVersion": 1,
    "name": "CentOS 32bit with MySQL 2",
    "description": "CentOS 6.3 32bit with MySQL Server 5.0",
    "lastUpdated": 1378949002080,
    "lastUpdateUser": "admin",
    "created": 1378949002080,
    "createUser": "admin",
    "version": {
      "major": "1",
      "minor": "0",
      "micro": "0",
      "qualifier": ""
    },
    "osVersionRef": {
      "uri": "/darwin/api/2.0/operating-system-version/115",
      "id": "115",
      "name": "CentOS32 v6.3.0"
    },
    "tags": [
      {
        "id": "9",
        "lockVersion": 1,
        "name": "Database Servers",
        "description": "Database servers",
        "lastUpdated": 1378763302507,
        "lastUpdateUser": "SYSTEM",
        "created": 1378763302507,
        "createUser": "SYSTEM",
        "type": "Server Type"
      },
      {
        "id": "20",
        "lockVersion": 1,
        "name": "OS Templates",
        "description": "OS Templates",
        "lastUpdated": 1378763302509,
        "lastUpdateUser": "SYSTEM",
        "created": 1378763302509,
        "createUser": "SYSTEM",
        "type": "Server Type"
      }
    ],
    "serviceVersions": [],
    "groupMembership": {
      "id": "437091",
      "lockVersion": 0,
      "ownerGroupRef": {
        "uri": null,
        "id": "1",
        "name": "Default"
      }
    }
  }
}

Retrieves the mapped cloud templates to a Application Services logical template.

All of the Application Services roles can access this API.

GET

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/LogicalTemplateVersionID/mapped-physical-template

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/60597/mapped-physical-template
{
    "errors": false,
    "messageList": [],
    "count": 2,
    "results": [
        {
            "id": "1",
            "lockVersion": 1,
            "name": "centos63x32",
            "description": "",
            "lastUpdated": 1383952048669,
            "lastUpdateUser": "admin",
            "created": 1383952048664,
            "createUser": "admin",
            "cloudTemplateExtref": {
                "id": "vcac://pg/ab9d048f-0ba7-414c-9676-c2ea0646823b/bp/4b125c3c-f6a3-4d19-93f9-3b99cd74d567",
                "name": "centos63x32"
            },
            "cloudProviderRef": {
                "uri": "/darwin/api/2.0/cloud-provider/1",
                "id": "1",
                "name": "vCAC-6.0-CP"
            },
            "osName": "",
            "properties": [
                {
                    "propertyDefinition": {
                        "id": "2004",
                        "lockVersion": 0,
                        "name": "reservation_policy_id",
                        "description": null,
                        "key": "reservation_policy_id",
                        "type": "STRING",
                        "secure": false,
                        "required": true
                    },
                    "value": "",
                    "overrideable": true
                },
                {
                    "propertyDefinition": {
                        "id": "2005",
                        "lockVersion": 0,
                        "name": "provisioning_group_id",
                        "description": null,
                        "key": "provisioning_group_id",
                        "type": "STRING",
                        "secure": false,
                        "required": true
                    },
                    "value": "ab9d048f-0ba7-414c-9676-c2ea0646823b",
                    "overrideable": false
                }
            ]
        },
        {
            "id": "11",
            "lockVersion": 1,
            "name": "RHEL61x64",
            "description": "",
            "lastUpdated": 1383956550555,
            "lastUpdateUser": "admin",
            "created": 1383956550542,
            "createUser": "admin",
            "cloudTemplateExtref": {
                "id": "vcac://pg/56283f48-764a-43c3-bcf8-8905ca5b7e07/bp/2a6f4868-0dd8-430b-bceb-2b8a72690998",
                "name": "RHEL61x64"
            },
            "cloudProviderRef": {
                "uri": "/darwin/api/2.0/cloud-provider/3",
                "id": "3",
                "name": "ADAutomationCP-vCAC-prme"
            },
            "osName": null,
            "properties": [
                {
                    "propertyDefinition": {
                        "id": "2004",
                        "lockVersion": 0,
                        "name": "reservation_policy_id",
                        "description": null,
                        "key": "reservation_policy_id",
                        "type": "STRING",
                        "secure": false,
                        "required": true
                    },
                    "value": "3f98e478-f941-4aeb-ae4a-3cc77df908d3",
                    "overrideable": false
                },
                {
                    "propertyDefinition": {
                        "id": "2005",
                        "lockVersion": 0,
                        "name": "provisioning_group_id",
                        "description": null,
                        "key": "provisioning_group_id",
                        "type": "STRING",
                        "secure": false,
                        "required": true
                    },
                    "value": "56283f48-764a-43c3-bcf8-8905ca5b7e07",
                    "overrideable": false
                }
            ]
        }
    ]
}

Adds the mapped logical template to the existing logical template list.

The application catalog administrator can access this API.

POST

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/LogicalTemplateVersionID/mapped-physical-template

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/3/mapped-physical-template
{
  "list": [
    {
        "id": "3"
    }
  ]
}
{
  "errors": false,
  "messageList": [],
  "count": 1,
  "results": [
    {
      "id": "3",
      "lockVersion": 4,
      "name": "C63x32_v9",
      "description": "",
      "lastUpdated": 1378945924330,
      "lastUpdateUser": "admin",
      "created": 1378849355048,
      "createUser": "admin",
      "cloudTemplateExtref": {
        "id": "https://192.0.2.255/api/vAppTemplate/vappTemplate-893d12f0-2c46-4ea9-a88b-d8269f605643",
        "name": "C63x32_v9"
      },
      "cloudProviderRef": {
        "uri": "/darwin/api/2.0/cloud-provider/1",
        "id": "1",
        "name": "Cloud"
      },
      "osName": "centosGuest",
      "properties": []
    }
  ]
}

Replaces all of the mapped logical templates from the existing logical template list.

The application catalog administrator can access this API.

PUT

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/LogicalTemplateVersionID/mapped-physical-template

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/3/mapped-physical-template
{
  "list": [
    {
        "id": "3"
    }
  ]
}
{
  "errors": false,
  "messageList": [],
  "count": 1,
  "results": [
    {
      "id": "3",
      "lockVersion": 4,
      "name": "C63x32_v9",
      "description": "",
      "lastUpdated": 1378945924330,
      "lastUpdateUser": "admin",
      "created": 1378849355048,
      "createUser": "admin",
      "cloudTemplateExtref": {
        "id": "https://192.0.2.255/api/vAppTemplate/vappTemplate-893d12f0-2c46-4ea9-a88b-d8269f605643",
        "name": "C63x32_v9"
      },
      "cloudProviderRef": {
        "uri": "/darwin/api/2.0/cloud-provider/1",
        "id": "1",
        "name": "Cloud"
      },
      "osName": "centosGuest",
      "properties": []
    }
  ]
}

Updates the available preinstalled services when you specify the logical template version identification.

The application catalog administrator can access this API.

POST

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/LogicalTemplateVersionID/preinstalled-services

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/215/preinstalled-services
{
  "list": [
    {
        "id": "215"
    }
  ]
}
{
  "errors": false,
  "messageList": [
    {
      "messageType": "INFO",
      "message": "Logical VM template version saved successfully.",
      "messageKey": "vmTemplateVersion.save.msg",
      "property": null
    }
  ],
  "result": null
}

Deletes a logical template version from the existing logical template list.

The application catalog administrator can access this API.

DELETE

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/LogicalTemplateVersionID

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/logical-template-version/320
{
  "errors": false,
  "messageList": [
    {
      "messageType": "INFO",
      "message": "Successfully deleted Logical template version.",
      "messageKey": "delete.msg",
      "property": null
    }
  ]
}
}