You can view cloud template information from the cloud environment. Register multiple cloud templates to Application Services.

Get Template Category

Retrieves the cloud template category from the cloud environment.

Log in to Application Services as an application cloud administrator.

HTTP Method

GET

URI Syntax

https://ApplicationServicesServerIP:8443/darwin/api/2.0/cloud-provider/CloudProviderID/physical-template-category

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/cloud-provider/1/physical-template-category

Response

{
  "errors": false,
  "messageList": [],
  "count": 22,
  "results": [
    {
      "id": "0",
      "lockVersion": 0,
      "name": "QE-catalog",
      "description": null,
      "cloudTemplateCategoryExtref": {
        "id": "https://192.0.2.255/api/catalog/967ab959-5fcb-4c7d-bb3e-3a476048ee59",
        "name": "QE-catalog"
      }
    }
  ]
}

Find Template Information

Searches for a specific cloud template in the cloud environment.

Log in to Application Services as an application cloud administrator.

HTTP Method

POST

URI Syntax

https://ApplicationServicesServerIP:8443/darwin/api/2.0/cloud-provider/CloudProviderID/physical-template-finder

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/cloud-provider/1/physical-template-finder

Request

{
  "id": "https://192.0.2.255/api/catalog/967ab959-5fcb-4c7d-bb3e-3a476048ee59",
}

Response

{
  "errors": false,
  "messageList": [],
  "count": 1,
  "results": [
    {
      "id": "0",
      "lockVersion": 0,
      "name": "Centos58-32bit-base",
      "description": "",
      "lastUpdated": null,
      "lastUpdateUser": null,
      "created": null,
      "createUser": null,
      "cloudTemplateExtref": {
        "id": "https://192.0.2.255/api/vAppTemplate/vappTemplate-df51ec56-3b3c-4f5d-8482-90fe212bffff",
        "name": "Centos58-32bit-base"
      },
      "cloudProviderRef": {
        "uri": "/darwin/api/2.0/cloud-provider/1",
        "id": "1",
        "name": "Cloud"
      },
      "osName": "centosGuest",
      "properties": [
        {
          "propertyDefinition": {
            "id": null,
            "lockVersion": 0,
            "name": null,
            "description": null,
            "key": "disksize",
            "type": null,
            "secure": false,
            "required": false
          },
          "value": "66560",
          "overrideable": false
        },
        {
          "propertyDefinition": {
            "id": null,
            "lockVersion": 0,
            "name": null,
            "description": null,
            "key": "goldMaster",
            "type": null,
            "secure": false,
            "required": false
          },
          "value": "false",
          "overrideable": false
        }
      ]
    }
  ]
}

Register a Template

Registers multiple cloud templates to Application Services. Provides a paginated list of all the registered templates.

Log in to Application Services as an application cloud administrator.

HTTP Method

POST

URI Syntax

https://ApplicationServicesServerIP:8443/darwin/api/2.0/cloud-provider/CloudProviderID/registered-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/cloud-provider/3/registered-physical-template

Request

{
  "list": [
    {
      "cloudTemplateExtref": {
        "id": "https://192.0.2.255/api/vAppTemplate/vappTemplate-df51ec56-3b3c-4f5d-8482-90fe212bffff",
        "name": "Centos58-32bit-base"
      }
    }
  ]
}

Response

{
  "errors": false,
  "messageList": [],
  "count": 1,
  "results": [
    {
      "id": "4",
      "lockVersion": 2,
      "name": "Centos58-32bit-base",
      "description": "",
      "lastUpdated": 1378946109490,
      "lastUpdateUser": "admin",
      "created": 1378946096470,
      "createUser": "admin",
      "cloudTemplateExtref": {
        "id": "https://192.0.2.255/api/vAppTemplate/vappTemplate-df51ec56-3b3c-4f5d-8482-90fe212bffff",
        "name": "Centos58-32bit-base"
      },
      "cloudProviderRef": {
        "uri": "/darwin/api/2.0/cloud-provider/3",
        "id": "3",
        "name": "New Cloud"
      },
      "osName": "centosGuest",
      "properties": []
    }
  ]
}

Get Registered Templates

Retrieves registered cloud templates in Application Services from the cloud environment based on the cloud provider ID.

All of the Application Services roles can access this API.

HTTP Method

GET

URI Syntax

https://ApplicationServicesServerIP:8443/darwin/api/2.0/cloud-provider/CloudProviderID/registered-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/cloud-provider/1/registered-physical-template

Response

{
  "errors": false,
  "messageList": [],
  "count": 2,
  "results": [
    {
      "id": "1",
      "lockVersion": 2,
      "name": "C56x32_v9",
      "description": "",
      "lastUpdated": 1378765277631,
      "lastUpdateUser": "admin",
      "created": 1378765191716,
      "createUser": "admin",
      "cloudTemplateExtref": {
        "id": "https://192.0.2.255/api/vAppTemplate/vappTemplate-61ba1dd9-8759-48a5-bf6f-0e858bfc3744",
        "name": "C56x32_v9"
      },
      "cloudProviderRef": {
        "uri": "/darwin/api/2.0/cloud-provider/1",
        "id": "1",
        "name": "Cloud"
      },
      "osName": "centosGuest",
      "properties": []
    },
    {
      "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 Registered Template Using ID

Retrieves the registered cloud template in Application Services from the cloud environment based on the provided ID.

All of the Application Services roles can access this API.

HTTP Method

GET

URI Syntax

https://ApplicationServicesServerIP:8443/darwin/api/2.0/registered-physical-template/RegisteredPhysicalTemplateID

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/registered-physical-template/2

Response

{
  "errors": false,
  "messageList": [],
  "result": {
    "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": []
  }
}

Replace a Template

Replaces multiple cloud templates in the cloud environment.

Log in to Application Services as an application cloud administrator.

HTTP Method

PUT

URI Syntax

https://ApplicationServicesServerIP:8443/darwin/api/2.0/cloud-provider/CloudProviderID/registered-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/cloud-provider/3/registered-physical-template

Request

{
  "list": [
    {
      "cloudTemplateExtref": {
        "id": "https://192.0.2.255/api/vAppTemplate/vappTemplate-df51ec56-3b3c-4f5d-8482-90fe212bffff",
        "name": "Centos58-32bit-base"
      }
    }
  ]
}

Response

{
  "errors": false,
  "messageList": [],
  "count": 1,
  "results": [
    {
      "id": "4",
      "lockVersion": 2,
      "name": "Centos58-32bit-base",
      "description": "",
      "lastUpdated": 1378946109490,
      "lastUpdateUser": "admin",
      "created": 1378946096470,
      "createUser": "admin",
      "cloudTemplateExtref": {
        "id": "https://192.0.2.255/api/vAppTemplate/vappTemplate-df51ec56-3b3c-4f5d-8482-90fe212bffff",
        "name": "Centos58-32bit-base"
      },
      "cloudProviderRef": {
        "uri": "/darwin/api/2.0/cloud-provider/3",
        "id": "3",
        "name": "New Cloud"
      },
      "osName": "centosGuest",
      "properties": []
    }
  ]
}