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.

Get Logical Templates

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

All of the Application Services roles can access this API.

HTTP Method

GET

URI Syntax

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

Response

{
  "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"
        }
      }
    }
  ]
}

Get Logical Template Version Mapping

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.

HTTP Method

GET

URI Syntax

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

Response

{
  "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": []
    }
  ]
}

Get Logical Template Version Details

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

All of the Application Services roles can access this API.

HTTP Method

GET

URI Syntax

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

Response

{
  "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"
      }
    }
  }
}

Create Logical Template Version

Creates a logical template version.

The application catalog administrator can access this API.

HTTP Method

POST

URI Syntax

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

Request

{
    "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
    }
}

Response

{
  "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"
      }
    }
  }
}

Get Mapped Cloud Templates to a Logical Template

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

All of the Application Services roles can access this API.

HTTP Method

GET

URI Syntax

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

Response

{
    "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
                }
            ]
        }
    ]
}

Add Logical Template Mapping

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

The application catalog administrator can access this API.

HTTP Method

POST

URI Syntax

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

Request

{
  "list": [
    {
        "id": "3"
    }
  ]
}

Response

{
  "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": []
    }
  ]
}

Replace Logical Template Mapping

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

The application catalog administrator can access this API.

HTTP Method

PUT

URI Syntax

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

Request

{
  "list": [
    {
        "id": "3"
    }
  ]
}

Response

{
  "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": []
    }
  ]
}

Update the Preinstalled Services

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

The application catalog administrator can access this API.

HTTP Method

POST

URI Syntax

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

Request

{
  "list": [
    {
        "id": "215"
    }
  ]
}

Response

{
  "errors": false,
  "messageList": [
    {
      "messageType": "INFO",
      "message": "Logical VM template version saved successfully.",
      "messageKey": "vmTemplateVersion.save.msg",
      "property": null
    }
  ],
  "result": null
}

Delete the Logical Template Version

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

The application catalog administrator can access this API.

HTTP Method

DELETE

URI Syntax

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

Response

{
  "errors": false,
  "messageList": [
    {
      "messageType": "INFO",
      "message": "Successfully deleted Logical template version.",
      "messageKey": "delete.msg",
      "property": null
    }
  ]
}
}