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

Retrieves the cloud template category from the cloud environment.

Verify that your user account has the ROLE_CLOUD_ADMIN cloud administrator role assigned to it.

GET

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP:8443/darwin/api/2.0/cloud-provider/1/physical-template-category
{
  "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"
      }
    }
  ]
}

Searches for a specific cloud template in the cloud environment.

Verify that your user account has the ROLE_CLOUD_ADMIN cloud administrator role assigned to it.

POST

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP:8443/darwin/api/2.0/cloud-provider/1/physical-template-finder
{
  "id": "https://192.0.2.255/api/catalog/967ab959-5fcb-4c7d-bb3e-3a476048ee59",
}
{
  "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
        }
      ]
    }
  ]
}

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

Verify that your user account has the ROLE_CLOUD_ADMIN cloud administrator role assigned to it.

POST

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP:8443/darwin/api/2.0/cloud-provider/3/registered-physical-template
{
  "list": [
    {
      "cloudTemplateExtref": {
        "id": "https://192.0.2.255/api/vAppTemplate/vappTemplate-df51ec56-3b3c-4f5d-8482-90fe212bffff",
        "name": "Centos58-32bit-base"
      }
    }
  ]
}
{
  "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": []
    }
  ]
}

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

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

GET

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP:8443/darwin/api/2.0/cloud-provider/1/registered-physical-template
{
  "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": []
    }
  ]
}

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

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

GET

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP:8443/darwin/api/2.0/registered-physical-template/2
{
  "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": []
  }
}

Replaces multiple cloud templates in the cloud environment.

Verify that your user account has the ROLE_CLOUD_ADMIN cloud administrator role assigned to it.

PUT

https://ApplicationDirectorServerIP: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://ApplicationDirectorServerIP:8443/darwin/api/2.0/cloud-provider/3/registered-physical-template
{
  "list": [
    {
      "cloudTemplateExtref": {
        "id": "https://192.0.2.255/api/vAppTemplate/vappTemplate-df51ec56-3b3c-4f5d-8482-90fe212bffff",
        "name": "Centos58-32bit-base"
      }
    }
  ]
}
{
  "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": []
    }
  ]
}