View vCloud VS Guest Customization

To view VS guest customization, use the following request:

1
2
GET /virtual_machines/:id/guest_customization.xml
GET /virtual_machines/:id/guest_customization.json

XML Request Example

1
curl -i -X GET -u user:userpass --url http://onapp.test/virtual_machines/20/guest_customization.xml  -H 'Accept: application/xml' -H 'Content-type: application/xml'

JSON Request Example

1
curl -i -X GET -u user:userpass --url http://onapp.test/virtual_machines/20/guest_customization.json  -H 'Accept: application/json' -H 'Content-type: application/json'

XML Output Example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
<vcloud_guest_customization>
  <admin_auto_logon_count type="integer">0</admin_auto_logon_count>
  <admin_auto_logon_enabled type="boolean">false</admin_auto_logon_enabled>
  <admin_password nil="true"/>
  <admin_password_auto type="boolean">true</admin_password_auto>
  <admin_password_enabled type="boolean">false</admin_password_enabled>
  <change_sid type="boolean">false</change_sid>
  <computer_name>Centos66-001</computer_name>
  <created_at type="datetime">2016-02-06T16:53:52+02:00</created_at>
  <domain_name nil="true"/>
  <domain_user_name nil="true"/>
  <domain_user_password nil="true"/>
  <enabled type="boolean">true</enabled>
  <id type="integer">20</id>
  <join_domain_enabled type="boolean">false</join_domain_enabled>
  <machine_object_ou nil="true"/>
  <reset_password_required type="boolean">false</reset_password_required>
  <script nil="true"/>
  <updated_at type="datetime">2016-02-06T16:53:52+02:00</updated_at>
  <use_org_settings type="boolean">false</use_org_settings>
  <virtual_machine_id type="integer">20</virtual_machine_id>
</vcloud_guest_customization>

Where:

admin_auto_logon_count - the number of times administrator can log in automatically

admin_auto_logon_enabled - true if administrator can log in automatically; otherwise, false

admin_password_auto - true if admin password is generated automatically; otherwise, false

admin_password_enabled - true if admin password is required; otherwise, false

change_sid - this parameter is applicable for Windows VSs only and will run Sysprep to change Windows SID. On Windows NT, VCD uses Sidgen. Running sysprep is a prerequisite for completing domain join

computer_name - VS’s computer name

created_at - the date in the [YYYY][MM][DD]T[hh][mm][ss]Z format

enabled - true if guest customization is enabled in VMware Cloud Director; otherwise, false

id - ID of the VS guest customization

join_domain_enabled - true if the VS is enabled to join a domain; otherwise, false

reset_password_required - true if a password reset is required; otherwise, false

updated_at - the date in the [YYYY][MM][DD]T[hh][mm][ss]Z format

use_org_settings - true if user org settings are enabled; otherwise, false

virtual_machine_id - ID of the VS, which guest customization is viewed