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 vCloud Application Director.

All of the vCloud Application Director predefined user accounts and associated roles can access this API.

GET

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP: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 vCloud Application Director when you specify the cloud provider identification.

All of the vCloud Application Director predefined user accounts and associated roles can access this API.

GET

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP: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 vCloud Application Director predefined user accounts and associated roles can access this API.

GET

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP: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 user account with the ROLE_CATALOG_ADMIN catalog administrator role can access this API.

POST

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP: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": []
}
}
{
  "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 vCloud Application Director logical template..

The user account with the ROLE_CATALOG_ADMIN catalog administrator role can access this API.

GET

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP: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 user account with the ROLE_CATALOG_ADMIN catalog administrator role can access this API.

POST

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP: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 user account with the ROLE_CATALOG_ADMIN catalog administrator role can access this API.

PUT

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP: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 user account with the ROLE_CATALOG_ADMIN catalog administrator role can access this API.

POST

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP: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 user account with the ROLE_CATALOG_ADMIN catalog administrator role can access this API.

DELETE

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP: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
    }
  ]
}
}